24#ifndef __DOSFS_FAT_H__
25#define __DOSFS_FAT_H__
61#define CF_LE_W(v) le16toh(v)
62#define CF_LE_L(v) le32toh(v)
63#define CT_LE_W(v) htole16(v)
64#define CT_LE_L(v) htole32(v)
66#define FAT_HASH_SIZE 2
67#define FAT_HASH_MODULE FAT_HASH_SIZE
70#define FAT_SECTOR512_SIZE 512
71#define FAT_SECTOR512_BITS 9
74#define FAT_FAT12_MAX_CLN 4085
77#define FAT_FAT16_MAX_CLN 65525
83#define FAT_UNDEFINED_VALUE (uint32_t)0xFFFFFFFF
85#define FAT_FAT12_EOC 0x0FF8
86#define FAT_FAT16_EOC 0xFFF8
87#define FAT_FAT32_EOC (uint32_t)0x0FFFFFF8
89#define FAT_FAT12_FREE 0x0000
90#define FAT_FAT16_FREE 0x0000
91#define FAT_FAT32_FREE 0x00000000
93#define FAT_GENFAT_EOC (uint32_t)0xFFFFFFFF
94#define FAT_GENFAT_FREE (uint32_t)0x00000000
96#define FAT_FAT12_SHIFT 0x04
98#define FAT_FAT12_MASK 0x00000FFF
99#define FAT_FAT16_MASK 0x0000FFFF
100#define FAT_FAT32_MASK (uint32_t)0x0FFFFFFF
102#define FAT_MAX_BPB_SIZE 90
103#define FAT_TOTAL_MBR_SIZE 512
106#define FAT_USEFUL_INFO_SIZE 12
108#define FAT_GET_ADDR(x, ofs) ((uint8_t *)(x) + (ofs))
110#define FAT_GET_VAL8(x, ofs) (uint8_t)(*((uint8_t *)(x) + (ofs)))
112#define FAT_GET_VAL16(x, ofs) \
113 (uint16_t)( (*((uint8_t *)(x) + (ofs))) | \
114 ((*((uint8_t *)(x) + (ofs) + 1)) << 8) )
116#define FAT_GET_VAL32(x, ofs) \
117 (uint32_t)( (uint32_t)(*((uint8_t *)(x) + (ofs))) | \
118 ((uint32_t)(*((uint8_t *)(x) + (ofs) + 1)) << 8) | \
119 ((uint32_t)(*((uint8_t *)(x) + (ofs) + 2)) << 16) | \
120 ((uint32_t)(*((uint8_t *)(x) + (ofs) + 3)) << 24) )
122#define FAT_SET_VAL8(x, ofs,val) \
123 (*((uint8_t *)(x)+(ofs))=(uint8_t)(val))
125#define FAT_SET_VAL16(x, ofs,val) do { \
126 FAT_SET_VAL8((x),(ofs),(val)); \
127 FAT_SET_VAL8((x),(ofs)+1,(val)>>8);\
130#define FAT_SET_VAL32(x, ofs,val) do { \
131 uint32_t val1 = val; \
132 FAT_SET_VAL16((x),(ofs),(val1)&0xffff);\
133 FAT_SET_VAL16((x),(ofs)+2,(val1)>>16);\
137#define FAT_GET_BR_JMPBOOT(x) FAT_GET_VAL8( x, 0)
138#define FAT_SET_BR_JMPBOOT(x,val) FAT_SET_VAL8( x, 0,val)
140#define FAT_GET_ADDR_BR_OEMNAME(x) FAT_GET_ADDR( x, 3)
141#define FAT_BR_OEMNAME_SIZE (8)
143#define FAT_GET_BR_BYTES_PER_SECTOR(x) FAT_GET_VAL16(x, 11)
144#define FAT_SET_BR_BYTES_PER_SECTOR(x,val) FAT_SET_VAL16(x, 11,val)
146#define FAT_GET_BR_SECTORS_PER_CLUSTER(x) FAT_GET_VAL8( x, 13)
147#define FAT_SET_BR_SECTORS_PER_CLUSTER(x,val)FAT_SET_VAL8( x, 13,val)
149#define FAT_GET_BR_RESERVED_SECTORS_NUM(x) FAT_GET_VAL16(x, 14)
150#define FAT_SET_BR_RESERVED_SECTORS_NUM(x,val) FAT_SET_VAL16(x, 14,val)
152#define FAT_GET_BR_FAT_NUM(x) FAT_GET_VAL8( x, 16)
153#define FAT_SET_BR_FAT_NUM(x,val) FAT_SET_VAL8( x, 16,val)
155#define FAT_GET_BR_FILES_PER_ROOT_DIR(x) FAT_GET_VAL16(x, 17)
156#define FAT_SET_BR_FILES_PER_ROOT_DIR(x,val) FAT_SET_VAL16(x, 17,val)
158#define FAT_GET_BR_TOTAL_SECTORS_NUM16(x) FAT_GET_VAL16(x, 19)
159#define FAT_SET_BR_TOTAL_SECTORS_NUM16(x,val)FAT_SET_VAL16(x, 19,val)
161#define FAT_GET_BR_MEDIA(x) FAT_GET_VAL8( x, 21)
162#define FAT_SET_BR_MEDIA(x,val) FAT_SET_VAL8( x, 21,val)
164#define FAT_GET_BR_SECTORS_PER_FAT(x) FAT_GET_VAL16(x, 22)
165#define FAT_SET_BR_SECTORS_PER_FAT(x,val) FAT_SET_VAL16(x, 22,val)
167#define FAT_GET_BR_SECTORS_PER_TRACK(x) FAT_GET_VAL16(x, 24)
168#define FAT_SET_BR_SECTORS_PER_TRACK(x,val) FAT_SET_VAL16(x, 24,val)
170#define FAT_GET_BR_NUMBER_OF_HEADS(x) FAT_GET_VAL16(x, 26)
171#define FAT_SET_BR_NUMBER_OF_HEADS(x,val) FAT_SET_VAL16(x, 26,val)
173#define FAT_GET_BR_HIDDEN_SECTORS(x) FAT_GET_VAL32(x, 28)
174#define FAT_SET_BR_HIDDEN_SECTORS(x,val) FAT_SET_VAL32(x, 28,val)
176#define FAT_GET_BR_TOTAL_SECTORS_NUM32(x) FAT_GET_VAL32(x, 32)
177#define FAT_SET_BR_TOTAL_SECTORS_NUM32(x,val) FAT_SET_VAL32(x, 32,val)
179#define FAT_GET_BR_DRVNUM(x) FAT_GET_VAL8( x, 36)
180#define FAT_SET_BR_DRVNUM(x,val) FAT_SET_VAL8( x, 36,val)
182#define FAT_GET_BR_RSVD1(x) FAT_GET_VAL8( x, 37)
183#define FAT_SET_BR_RSVD1(x,val) FAT_SET_VAL8( x, 37,val)
185#define FAT_GET_BR_BOOTSIG(x) FAT_GET_VAL8( x, 38)
186#define FAT_SET_BR_BOOTSIG(x,val) FAT_SET_VAL8( x, 38,val)
187#define FAT_BR_BOOTSIG_VAL (0x29)
189#define FAT_GET_BR_VOLID(x) FAT_GET_VAL32(x, 39)
190#define FAT_SET_BR_VOLID(x,val) FAT_SET_VAL32(x, 39,val)
192#define FAT_GET_ADDR_BR_VOLLAB(x) FAT_GET_ADDR (x, 43)
193#define FAT_BR_VOLLAB_SIZE (11)
195#define FAT_GET_ADDR_BR_FILSYSTYPE(x) FAT_GET_ADDR (x, 54)
196#define FAT_BR_FILSYSTYPE_SIZE (8)
199#define FAT_GET_BR_SECTORS_PER_FAT32(x) FAT_GET_VAL32(x, 36)
200#define FAT_SET_BR_SECTORS_PER_FAT32(x,val) FAT_SET_VAL32(x, 36,val)
202#define FAT_GET_BR_EXT_FLAGS(x) FAT_GET_VAL16(x, 40)
203#define FAT_SET_BR_EXT_FLAGS(x,val) FAT_SET_VAL16(x, 40,val)
205#define FAT_GET_BR_FSVER(x) FAT_GET_VAL16(x, 42)
206#define FAT_SET_BR_FSVER(x,val) FAT_SET_VAL16(x, 42,val)
208#define FAT_GET_BR_FAT32_ROOT_CLUSTER(x) FAT_GET_VAL32(x, 44)
209#define FAT_SET_BR_FAT32_ROOT_CLUSTER(x,val) FAT_SET_VAL32(x, 44,val)
211#define FAT_GET_BR_FAT32_FS_INFO_SECTOR(x) FAT_GET_VAL16(x, 48)
212#define FAT_SET_BR_FAT32_FS_INFO_SECTOR(x,val) FAT_SET_VAL16(x, 48,val)
214#define FAT_GET_BR_FAT32_BK_BOOT_SECTOR(x) FAT_GET_VAL16(x, 50)
215#define FAT_SET_BR_FAT32_BK_BOOT_SECTOR(x,val) FAT_SET_VAL16(x, 50,val)
217#define FAT_GET_ADDR_BR_FAT32_RESERVED(x) FAT_GET_ADDR (x, 52)
218#define FAT_BR_FAT32_RESERVED_SIZE (12)
220#define FAT_GET_BR_FAT32_DRVNUM(x) FAT_GET_VAL8( x, 64)
221#define FAT_SET_BR_FAT32_DRVNUM(x,val) FAT_SET_VAL8( x, 64,val)
223#define FAT_GET_BR_FAT32_RSVD1(x) FAT_GET_VAL8( x, 65)
224#define FAT_SET_BR_FAT32_RSVD1(x,val) FAT_SET_VAL8( x, 65,val)
226#define FAT_GET_BR_FAT32_BOOTSIG(x) FAT_GET_VAL8( x, 66)
227#define FAT_SET_BR_FAT32_BOOTSIG(x,val) FAT_SET_VAL8( x, 66,val)
228#define FAT_BR_FAT32_BOOTSIG_VAL (0x29)
230#define FAT_GET_BR_FAT32_VOLID(x) FAT_GET_VAL32(x, 67)
231#define FAT_SET_BR_FAT32_VOLID(x,val) FAT_SET_VAL32(x, 67,val)
233#define FAT_GET_ADDR_BR_FAT32_VOLLAB(x) FAT_GET_ADDR (x, 71)
234#define FAT_BR_FAT32_VOLLAB_SIZE (11)
236#define FAT_GET_ADDR_BR_FAT32_FILSYSTYPE(x) FAT_GET_ADDR (x, 82)
237#define FAT_BR_FAT32_FILSYSTYPE_SIZE (8)
240#define FAT_GET_BR_SIGNATURE(x) FAT_GET_VAL16(x,510)
241#define FAT_SET_BR_SIGNATURE(x,val) FAT_SET_VAL16(x,510,val)
242#define FAT_BR_SIGNATURE_VAL (0xAA55)
247#define FAT_GET_FSINFO_LEAD_SIGNATURE(x) FAT_GET_VAL32(x, 0)
248#define FAT_SET_FSINFO_LEAD_SIGNATURE(x,val) FAT_SET_VAL32(x, 0,val)
249#define FAT_FSINFO_LEAD_SIGNATURE_VALUE (0x41615252)
251#define FAT_GET_FSINFO_STRUC_SIGNATURE(x) FAT_GET_VAL32(x,484)
252#define FAT_SET_FSINFO_STRUC_SIGNATURE(x,val) FAT_SET_VAL32(x,484,val)
253#define FAT_FSINFO_STRUC_SIGNATURE_VALUE (0x61417272)
255#define FAT_GET_FSINFO_TRAIL_SIGNATURE(x) FAT_GET_VAL32(x,508)
256#define FAT_SET_FSINFO_TRAIL_SIGNATURE(x,val) FAT_SET_VAL32(x,508,val)
257#define FAT_FSINFO_TRAIL_SIGNATURE_VALUE (0xAA550000)
262#define FAT_GET_FSINFO_FREE_CLUSTER_COUNT(x) FAT_GET_VAL32(x, 4)
263#define FAT_SET_FSINFO_FREE_CLUSTER_COUNT(x,val) FAT_SET_VAL32(x, 4,val)
264#define FAT_GET_FSINFO_NEXT_FREE_CLUSTER(x) FAT_GET_VAL32(x, 8)
265#define FAT_SET_FSINFO_NEXT_FREE_CLUSTER(x,val) FAT_SET_VAL32(x, 8,val)
267#define FAT_FSI_INFO 484
268#define FAT_FSINFO_STRUCT_OFFSET 488
269#define FAT_FSINFO_FREE_CLUSTER_COUNT_OFFSET (FAT_FSINFO_STRUCT_OFFSET+0)
271#define FAT_FSINFO_NEXT_FREE_CLUSTER_OFFSET (FAT_FSINFO_STRUCT_OFFSET+4)
273#define FAT_RSRVD_CLN 0x02
275#define FAT_FSI_LEADSIG_SIZE 0x04
277#define FAT_TOTAL_FSINFO_SIZE 512
279#define MS_BYTES_PER_CLUSTER_LIMIT 0x10000
280#define MS_BYTES_PER_CLUSTER_LIMIT_FAT12 0x1000
282#define FAT_BR_EXT_FLAGS_MIRROR 0x0080
284#define FAT_BR_EXT_FLAGS_FAT_NUM 0x000F
286#define FAT_BR_MEDIA_FIXED 0xf8
288#define FAT_DIRENTRY_SIZE 32
290#define FAT_DIRENTRIES_PER_SEC512 16
307 uint8_t sectors_per_block;
308 uint32_t bytes_per_block;
309 uint8_t bytes_per_block_log2;
326 uint32_t free_cls_in_fs_info;
329 uint32_t next_cl_in_fs_info;
360 uint32_t uino_pool_size;
391#define FAT_FILE_SHORT_NAME (0xffffffff)
393#define FAT_FAT_OFFSET(fat_type, cln) \
394 ((fat_type) & FAT_FAT12 ? ((cln) + ((cln) >> 1)) : \
395 (fat_type) & FAT_FAT16 ? ((cln) << 1) : \
398#define FAT_CLUSTER_IS_ODD(n) ((n) & 0x0001)
400#define FAT12_SHIFT 0x4
403#define FAT_UINO_POOL_INIT_SIZE 0x100
406#define FAT_CACHE_EMPTY 0x0
407#define FAT_CACHE_ACTUAL 0x1
409#define FAT_OP_TYPE_READ 0x1
410#define FAT_OP_TYPE_GET 0x2
417 dir_pos->sname.cln = 0;
418 dir_pos->sname.ofs = 0;
419 dir_pos->lname.cln = FAT_FILE_SHORT_NAME;
420 dir_pos->lname.ofs = FAT_FILE_SHORT_NAME;
423static inline uint32_t
424fat_cluster_num_to_sector_num(
429 if ( (cln == 0) && (fs_info->vol.type & (FAT_FAT12 | FAT_FAT16)) )
430 return fs_info->vol.rdir_loc;
432 return (((cln - FAT_RSRVD_CLN) << fs_info->vol.spc_log2) +
433 fs_info->vol.data_fsec);
436static inline uint32_t
437fat_cluster_num_to_sector512_num(
445 return (fat_cluster_num_to_sector_num(fs_info, cln) <<
446 fs_info->vol.sec_mul);
449static inline uint32_t
451 const uint32_t block_number)
453 return block_number >> (fs_info->vol.bpc_log2 - fs_info->vol.bytes_per_block_log2);
456static inline uint32_t
458 const uint32_t block_number)
460 return block_number << (fs_info->vol.bytes_per_block_log2 - fs_info->vol.sec_log2);
463static inline uint32_t
465 const uint32_t sector_number)
467 return sector_number >> (fs_info->vol.bytes_per_block_log2 - fs_info->vol.sec_log2);
470static inline uint32_t
471 fat_sector_offset_to_block_offset (
const fat_fs_info_t *fs_info,
472 const uint32_t sector,
473 const uint32_t sector_offset)
475 return sector_offset +
477 fat_block_num_to_sector_num (fs_info,
478 fat_sector_num_to_block_num (fs_info, sector)))
479 << fs_info->vol.sec_log2);
485 fs_info->c.modified =
true;
507 const uint32_t blk_cnt);
532fat_init_volume_info(
fat_fs_info_t *fs_info,
const char *device);
Block Device Buffer Management.
This header file defines macros to set errno and return minus one.
Description of a disk device (logical and physical disks).
Definition: diskdevs.h:177
This header file provides interfaces of the system endianness support.
This union represents a chain control block.
Definition: chain.h:96