1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
/*
* $Id: mpio.h,v 1.21 2003/04/27 12:08:20 germeier Exp $
*
* libmpio - a library for accessing Digit@lways MPIO players
* Copyright (C) 2002, 2003 Markus Germeier
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc.,g 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
/*
* uses code from mpio_stat.c by
* Yuji Touya (salmoon@users.sourceforge.net)
*/
#ifndef _MPIO_H_
#define _MPIO_H_
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <errno.h>
#include <string.h>
#include "defs.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
*init and shutdown
*/
mpio_t *mpio_init(mpio_callback_init_t);
void mpio_close(mpio_t *);
/*
* request information
*/
/* get version */
void mpio_get_info(mpio_t *, mpio_info_t *);
/* get model */
mpio_model_t mpio_get_model(mpio_t *);
/* retrieves free memory in bytes */
int mpio_memory_free(mpio_t *, mpio_mem_t, int *free);
/*
* charset for filename encoding/converting
*/
BYTE *mpio_charset_get(mpio_t *);
BYTE mpio_charset_set(mpio_t *, BYTE *);
/*
* directory operations
*/
/* context, memory bank */
BYTE* mpio_directory_open(mpio_t *, mpio_mem_t);
/* context, memory bank, directory name */
int mpio_directory_make(mpio_t *, mpio_mem_t, BYTE *);
/* context, memory bank, directory name */
int mpio_directory_cd(mpio_t *, mpio_mem_t, BYTE *);
/* context, memory bank, directory name buffer space */
void mpio_directory_pwd(mpio_t *, mpio_mem_t, BYTE pwd[INFO_LINE]);
/* context, dir context */
BYTE* mpio_dentry_next(mpio_t *, mpio_mem_t, BYTE *);
/* context, dir context */
int mpio_dentry_get(mpio_t *, mpio_mem_t, BYTE *, BYTE *, int,WORD *,
BYTE *, BYTE *, BYTE *, BYTE *, DWORD *, BYTE *);
/*
* reading/writing/deleting of files
*/
int mpio_file_get_as(mpio_t *, mpio_mem_t, mpio_filename_t,
mpio_filename_t,mpio_callback_t);
/* context, memory bank, filename, callback */
int mpio_file_get(mpio_t *, mpio_mem_t, mpio_filename_t, mpio_callback_t);
/* context, memory bank, filename, filetype, callback */
int mpio_file_put(mpio_t *, mpio_mem_t, mpio_filename_t, mpio_filetype_t,
mpio_callback_t);
/* context, memory bank, filename, as, filetype, callback */
int mpio_file_put_as(mpio_t *, mpio_mem_t, mpio_filename_t,
mpio_filename_t, mpio_filetype_t,
mpio_callback_t);
/* context, memory bank, filename, callback */
int mpio_file_del(mpio_t *, mpio_mem_t, mpio_filename_t, mpio_callback_t);
/*
* reading/writing files into memory (used for config+font files)
*/
/* context, memory bank, filename, callback, pointer to memory */
/* the needed memory is allocated and the memory pointer is return */
/* via the "BYTE **" */
int mpio_file_get_to_memory(mpio_t *, mpio_mem_t, mpio_filename_t,
mpio_callback_t, BYTE **);
/* context, memory bank, filename, filetype, callback ... */
/* ... memory pointer, size of file */
int mpio_file_put_from_memory(mpio_t *, mpio_mem_t, mpio_filename_t,
mpio_filetype_t, mpio_callback_t,
BYTE *, int);
/*
* rename a file on the MPIO
*/
/* context, memory bank, filename, filename */
int mpio_file_rename(mpio_t *, mpio_mem_t,
mpio_filename_t, mpio_filename_t);
/*
* switch position of two files
*/
/* context, memory bank, filename, filename */
int mpio_file_switch(mpio_t *, mpio_mem_t,
mpio_filename_t, mpio_filename_t);
/* Move a named file after a given file. If after==NULL move it
to the top of the list,
*/
int mpio_file_move(mpio_t *,mpio_mem_t m,mpio_filename_t,mpio_filename_t);
/*
* formating a memory (internal mem or external SmartMedia card)
*/
/* context, memory bank, callback */
int mpio_memory_format(mpio_t *, mpio_mem_t, mpio_callback_t);
/* mpio_sync has to be called after every set of mpio_file_{del,put}
* operations to write the current state of FAT and (root) directory.
* This is done explicitly to avoid writing these informations to often
* and thereby exhausting the SmartMedia chips
*/
/* context, memory bank */
int mpio_sync(mpio_t *, mpio_mem_t);
/*
* ID3 rewriting support
*/
/* enable disable ID3 rewriting support */
BYTE mpio_id3_set(mpio_t *, BYTE);
/* query ID3 rewriting support */
BYTE mpio_id3_get(mpio_t *);
/* set format string for rewriting*/
void mpio_id3_format_set(mpio_t *, BYTE *);
/* get format string for rewriting*/
void mpio_id3_format_get(mpio_t *, BYTE *);
/*
* "special" functions
*/
/* returns health status of selected memory */
int mpio_health(mpio_t *, mpio_mem_t, mpio_health_t *);
/*
* error handling
*/
/* returns error code of last error */
int mpio_errno(void);
/* returns the description of the error <errno> */
char * mpio_strerror(int err);
/* prints the error message of the last error*/
void mpio_perror(char *prefix);
/*
* debugging
*/
/* context, memory bank */
int mpio_memory_dump(mpio_t *, mpio_mem_t);
/*
* timeline:
* ---------
* 2004: some functions to change the order of files
* 2005: read mp3 tags of the files
*/
#ifdef __cplusplus
}
#endif
#endif /* _MPIO_H_ */
|
