source: thomson/code/C/HxCHost/pff/pff.h@ ee447bf

main
Last change on this file since ee447bf was ee447bf, checked in by Adrien Destugues <pulkomandy@…>, 12 years ago

More work on write support :

  • Avoid using the same buffer over and over again for everything, when writing this creates some problems.
  • Editing the configuration now works.

git-svn-id: ​svn://localhost/thomson@19 85ae3b6b-dc8f-4344-a89d-598714f2e4e5
  • Property mode set to 100644
File size: 6.5 KB
Line 
1/*---------------------------------------------------------------------------/
2/ Petit FatFs - FAT file system module include file R0.02a (C)ChaN, 2010
3/----------------------------------------------------------------------------/
4/ Petit FatFs module is an open source software to implement FAT file system to
5/ small embedded systems. This is a free software and is opened for education,
6/ research and commercial developments under license policy of following trems.
7/
8/ Copyright (C) 2010, ChaN, all right reserved.
9/
10/ * The Petit FatFs module is a free software and there is NO WARRANTY.
11/ * No restriction on use. You can use, modify and redistribute it for
12/ personal, non-profit or commercial use UNDER YOUR RESPONSIBILITY.
13/ * Redistributions of source code must retain the above copyright notice.
14/
15/----------------------------------------------------------------------------*/
16
17#include "integer.h"
18
19/*---------------------------------------------------------------------------/
20/ Petit FatFs Configuration Options
21/
22/ CAUTION! Do not forget to make clean the project after any changes to
23/ the configuration options.
24/
25/----------------------------------------------------------------------------*/
26#ifndef _FATFS
27#define _FATFS
28
29#define _USE_READ 1 /* 1:Enable pf_read() */
30
31#define _USE_DIR 1 /* 1:Enable pf_opendir() and pf_readdir() */
32
33#define _USE_LSEEK 1 /* 1:Enable pf_lseek() */
34
35#define _USE_WRITE 1 /* 1:Enable pf_write() */
36
37#define _FS_FAT12 0 /* 1:Enable FAT12 support */
38#define _FS_FAT32 1 /* 1:Enable FAT32 support */
39
40
41#define _CODE_PAGE 1
42/* Defines which code page is used for path name. Supported code pages are:
43/ 932, 936, 949, 950, 437, 720, 737, 775, 850, 852, 855, 857, 858, 862, 866,
44/ 874, 1250, 1251, 1252, 1253, 1254, 1255, 1257, 1258 and 1 (ASCII only).
45/ SBCS code pages except for 1 requiers a case conversion table. This
46/ might occupy 128 bytes on the RAM on some platforms, e.g. avr-gcc. */
47
48
49#define _WORD_ACCESS 0
50/* The _WORD_ACCESS option defines which access method is used to the word
51/ data in the FAT structure.
52/
53/ 0: Byte-by-byte access. Always compatible with all platforms.
54/ 1: Word access. Do not choose this unless following condition is met.
55/
56/ When the byte order on the memory is big-endian or address miss-aligned
57/ word access results incorrect behavior, the _WORD_ACCESS must be set to 0.
58/ If it is not the case, the value can also be set to 1 to improve the
59/ performance and code efficiency. */
60
61
62/* End of configuration options. Do not change followings without care. */
63/*--------------------------------------------------------------------------*/
64
65
66
67#if _FS_FAT32
68#define CLUST DWORD
69#else
70#define CLUST WORD
71#endif
72
73
74/* File system object structure */
75
76typedef struct {
77 BYTE fs_type; /* FAT sub type */
78 BYTE flag; /* File status flags */
79 BYTE csize; /* Number of sectors per cluster */
80 BYTE pad1;
81 WORD n_rootdir; /* Number of root directory entries (0 on FAT32) */
82 CLUST n_fatent; /* Number of FAT entries (= number of clusters + 2) */
83 DWORD fatbase; /* FAT start sector */
84 DWORD dirbase; /* Root directory start sector (Cluster# on FAT32) */
85 DWORD database; /* Data start sector */
86 DWORD fptr; /* File R/W pointer */
87 DWORD fsize; /* File size */
88 CLUST org_clust; /* File start cluster */
89 CLUST curr_clust; /* File current cluster */
90 DWORD dsect; /* File current data sector */
91} FATFS;
92
93
94
95/* Directory object structure */
96
97typedef struct {
98 WORD index; /* Current read/write index number */
99 BYTE* fn; /* Pointer to the SFN (in/out) {file[8],ext[3],status[1]} */
100 CLUST sclust; /* Table start cluster (0:Static table) */
101 CLUST clust; /* Current cluster */
102 DWORD sect; /* Current sector */
103} DIR;
104
105
106
107/* File status structure */
108
109typedef struct {
110 DWORD fsize; /* File size */
111 WORD fdate; /* Last modified date */
112 WORD ftime; /* Last modified time */
113 BYTE fattrib; /* Attribute */
114 char fname[13]; /* File name */
115} FILINFO;
116
117
118
119/* File function return code (FRESULT) */
120
121typedef enum {
122 FR_OK = 0, /* 0 */
123 FR_DISK_ERR, /* 1 */
124 FR_NOT_READY, /* 2 */
125 FR_NO_FILE, /* 3 */
126 FR_NO_PATH, /* 4 */
127 FR_NOT_OPENED, /* 5 */
128 FR_NOT_ENABLED, /* 6 */
129 FR_NO_FILESYSTEM /* 7 */
130} FRESULT;
131
132
133
134/*--------------------------------------------------------------*/
135/* Petit FatFs module application interface */
136
137FRESULT pf_mount (FATFS*); /* Mount/Unmount a logical drive */
138FRESULT pf_open (const char*); /* Open a file */
139FRESULT pf_read (void*, WORD, WORD*); /* Read data from the open file */
140FRESULT pf_write (const void*, WORD, WORD*); /* Write data to the open file */
141FRESULT pf_lseek (DWORD); /* Move file pointer of the open file */
142FRESULT pf_opendir (DIR*, const char*); /* Open a directory */
143FRESULT pf_readdir (DIR*, FILINFO*); /* Read a directory item from the open directory */
144
145
146
147/*--------------------------------------------------------------*/
148/* Flags and offset address */
149
150/* File status flag (FATFS.flag) */
151
152#define FA_OPENED 0x01
153#define FA_WPRT 0x02
154#define FA__WIP 0x40
155
156
157/* FAT sub type (FATFS.fs_type) */
158
159#define FS_FAT12 1
160#define FS_FAT16 2
161#define FS_FAT32 3
162
163
164/* File attribute bits for directory entry */
165
166#define AM_RDO 0x01 /* Read only */
167#define AM_HID 0x02 /* Hidden */
168#define AM_SYS 0x04 /* System */
169#define AM_VOL 0x08 /* Volume label */
170#define AM_LFN 0x0F /* LFN entry */
171#define AM_DIR 0x10 /* Directory */
172#define AM_ARC 0x20 /* Archive */
173#define AM_MASK 0x3F /* Mask of defined bits */
174
175
176/*--------------------------------*/
177/* Multi-byte word access macros */
178
179#if _WORD_ACCESS == 1 /* Enable word access to the FAT structure */
180#define LD_WORD(ptr) (WORD)(*(WORD*)(BYTE*)(ptr))
181#define LD_DWORD(ptr) (DWORD)(*(DWORD*)(BYTE*)(ptr))
182#define ST_WORD(ptr,val) *(WORD*)(BYTE*)(ptr)=(WORD)(val)
183#define ST_DWORD(ptr,val) *(DWORD*)(BYTE*)(ptr)=(DWORD)(val)
184#else /* Use byte-by-byte access to the FAT structure */
185#define LD_WORD(ptr) (WORD)(((WORD)*((BYTE*)(ptr)+1)<<8)|(WORD)*(BYTE*)(ptr))
186#define LD_DWORD(ptr) (DWORD)(((DWORD)*((BYTE*)(ptr)+3)<<24)|((DWORD)*((BYTE*)(ptr)+2)<<16)|((WORD)*((BYTE*)(ptr)+1)<<8)|*(BYTE*)(ptr))
187#define ST_WORD(ptr,val) *(BYTE*)(ptr)=(BYTE)(val); *((BYTE*)(ptr)+1)=(BYTE)((WORD)(val)>>8)
188#define ST_DWORD(ptr,val) *(BYTE*)(ptr)=(BYTE)(val); *((BYTE*)(ptr)+1)=(BYTE)((WORD)(val)>>8); *((BYTE*)(ptr)+2)=(BYTE)((DWORD)(val)>>16); *((BYTE*)(ptr)+3)=(BYTE)((DWORD)(val)>>24)
189#endif
190
191
192#endif /* _FATFS */
Note: See TracBrowser for help on using the repository browser.