xref: /rk3399_rockchip-uboot/include/fat.h (revision 71f9511803de65a3b98d2f592d418da1d1539f13)
1*71f95118Swdenk /*
2*71f95118Swdenk  * R/O (V)FAT 12/16/32 filesystem implementation by Marcus Sundberg
3*71f95118Swdenk  *
4*71f95118Swdenk  * 2002-07-28 - rjones@nexus-tech.net - ported to ppcboot v1.1.6
5*71f95118Swdenk  * 2003-03-10 - kharris@nexus-tech.net - ported to u-boot
6*71f95118Swdenk  *
7*71f95118Swdenk  * See file CREDITS for list of people who contributed to this
8*71f95118Swdenk  * project.
9*71f95118Swdenk  *
10*71f95118Swdenk  * This program is free software; you can redistribute it and/or
11*71f95118Swdenk  * modify it under the terms of the GNU General Public License as
12*71f95118Swdenk  * published by the Free Software Foundation; either version 2 of
13*71f95118Swdenk  * the License, or (at your option) any later version.
14*71f95118Swdenk  *
15*71f95118Swdenk  * This program is distributed in the hope that it will be useful,
16*71f95118Swdenk  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17*71f95118Swdenk  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18*71f95118Swdenk  * GNU General Public License for more details.
19*71f95118Swdenk  *
20*71f95118Swdenk  * You should have received a copy of the GNU General Public License
21*71f95118Swdenk  * along with this program; if not, write to the Free Software
22*71f95118Swdenk  * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
23*71f95118Swdenk  * MA 02111-1307 USA
24*71f95118Swdenk  *
25*71f95118Swdenk  */
26*71f95118Swdenk 
27*71f95118Swdenk #ifndef _FAT_H_
28*71f95118Swdenk #define _FAT_H_
29*71f95118Swdenk 
30*71f95118Swdenk #define CONFIG_SUPPORT_VFAT
31*71f95118Swdenk 
32*71f95118Swdenk #define SECTOR_SIZE FS_BLOCK_SIZE
33*71f95118Swdenk 
34*71f95118Swdenk #define FS_BLOCK_SIZE 512
35*71f95118Swdenk 
36*71f95118Swdenk #if FS_BLOCK_SIZE != SECTOR_SIZE
37*71f95118Swdenk #error FS_BLOCK_SIZE != SECTOR_SIZE - This code needs to be fixed!
38*71f95118Swdenk #endif
39*71f95118Swdenk 
40*71f95118Swdenk #define MAX_CLUSTSIZE	65536
41*71f95118Swdenk #define DIRENTSPERBLOCK	(FS_BLOCK_SIZE/sizeof(dir_entry))
42*71f95118Swdenk #define DIRENTSPERCLUST	((mydata->clust_size*SECTOR_SIZE)/sizeof(dir_entry))
43*71f95118Swdenk 
44*71f95118Swdenk #define FATBUFBLOCKS	6
45*71f95118Swdenk #define FATBUFSIZE	(FS_BLOCK_SIZE*FATBUFBLOCKS)
46*71f95118Swdenk #define FAT12BUFSIZE	((FATBUFSIZE*3)/2)
47*71f95118Swdenk #define FAT16BUFSIZE	(FATBUFSIZE/2)
48*71f95118Swdenk #define FAT32BUFSIZE	(FATBUFSIZE/4)
49*71f95118Swdenk 
50*71f95118Swdenk 
51*71f95118Swdenk /* Filesystem identifiers */
52*71f95118Swdenk #define FAT12_SIGN	"FAT12   "
53*71f95118Swdenk #define FAT16_SIGN	"FAT16   "
54*71f95118Swdenk #define FAT32_SIGN	"FAT32   "
55*71f95118Swdenk #define SIGNLEN		8
56*71f95118Swdenk 
57*71f95118Swdenk /* File attributes */
58*71f95118Swdenk #define ATTR_RO      1
59*71f95118Swdenk #define ATTR_HIDDEN  2
60*71f95118Swdenk #define ATTR_SYS     4
61*71f95118Swdenk #define ATTR_VOLUME  8
62*71f95118Swdenk #define ATTR_DIR     16
63*71f95118Swdenk #define ATTR_ARCH    32
64*71f95118Swdenk 
65*71f95118Swdenk #define ATTR_VFAT     (ATTR_RO | ATTR_HIDDEN | ATTR_SYS | ATTR_VOLUME)
66*71f95118Swdenk 
67*71f95118Swdenk #define DELETED_FLAG	((char)0xe5) /* Marks deleted files when in name[0] */
68*71f95118Swdenk #define aRING		0x05	     /* Used to represent '�' in name[0] */
69*71f95118Swdenk 
70*71f95118Swdenk 
71*71f95118Swdenk /* Flags telling whether we should read a file or list a directory */
72*71f95118Swdenk #define LS_NO	0
73*71f95118Swdenk #define LS_YES	1
74*71f95118Swdenk #define LS_DIR	1
75*71f95118Swdenk #define LS_ROOT	2
76*71f95118Swdenk 
77*71f95118Swdenk #ifdef DEBUG
78*71f95118Swdenk #define FAT_DPRINT(args...)	printf(args)
79*71f95118Swdenk #else
80*71f95118Swdenk #define FAT_DPRINT(args...)
81*71f95118Swdenk #endif
82*71f95118Swdenk #define FAT_ERROR(arg)		printf(arg)
83*71f95118Swdenk 
84*71f95118Swdenk #define ISDIRDELIM(c)   ((c) == '/' || (c) == '\\')
85*71f95118Swdenk 
86*71f95118Swdenk #define FSTYPE_NONE	(-1)
87*71f95118Swdenk 
88*71f95118Swdenk #if defined(__linux__) && defined(__KERNEL__)
89*71f95118Swdenk #define FAT2CPU16	le16_to_cpu
90*71f95118Swdenk #define FAT2CPU32	le32_to_cpu
91*71f95118Swdenk #else
92*71f95118Swdenk #if 1
93*71f95118Swdenk #define FAT2CPU16(x)	(x)
94*71f95118Swdenk #define FAT2CPU32(x)	(x)
95*71f95118Swdenk #else
96*71f95118Swdenk #define FAT2CPU16(x)	((((x) & 0x00ff) << 8) | (((x) & 0xff00) >> 8))
97*71f95118Swdenk #define FAT2CPU32(x)	((((x) & 0x000000ff) << 24)  |	\
98*71f95118Swdenk 	 		 (((x) & 0x0000ff00) << 8)  |	\
99*71f95118Swdenk 			 (((x) & 0x00ff0000) >> 8)  |	\
100*71f95118Swdenk 			 (((x) & 0xff000000) >> 24))
101*71f95118Swdenk #endif
102*71f95118Swdenk #endif
103*71f95118Swdenk 
104*71f95118Swdenk #define TOLOWER(c)	if((c) >= 'A' && (c) <= 'Z'){(c)+=('a' - 'A');}
105*71f95118Swdenk #define START(dent)	(FAT2CPU16((dent)->start) \
106*71f95118Swdenk 			+ (mydata->fatsize != 32 ? 0 : \
107*71f95118Swdenk 			  (FAT2CPU16((dent)->starthi) << 16)))
108*71f95118Swdenk 
109*71f95118Swdenk 
110*71f95118Swdenk typedef struct boot_sector {
111*71f95118Swdenk 	__u8	ignored[3];	/* Bootstrap code */
112*71f95118Swdenk 	char	system_id[8];	/* Name of fs */
113*71f95118Swdenk 	__u8	sector_size[2];	/* Bytes/sector */
114*71f95118Swdenk 	__u8	cluster_size;	/* Sectors/cluster */
115*71f95118Swdenk 	__u16	reserved;	/* Number of reserved sectors */
116*71f95118Swdenk 	__u8	fats;		/* Number of FATs */
117*71f95118Swdenk 	__u8	dir_entries[2];	/* Number of root directory entries */
118*71f95118Swdenk 	__u8	sectors[2];	/* Number of sectors */
119*71f95118Swdenk 	__u8	media;		/* Media code */
120*71f95118Swdenk 	__u16	fat_length;	/* Sectors/FAT */
121*71f95118Swdenk 	__u16	secs_track;	/* Sectors/track */
122*71f95118Swdenk 	__u16	heads;		/* Number of heads */
123*71f95118Swdenk 	__u32	hidden;		/* Number of hidden sectors */
124*71f95118Swdenk 	__u32	total_sect;	/* Number of sectors (if sectors == 0) */
125*71f95118Swdenk 
126*71f95118Swdenk 	/* FAT32 only */
127*71f95118Swdenk 	__u32	fat32_length;	/* Sectors/FAT */
128*71f95118Swdenk 	__u16	flags;		/* Bit 8: fat mirroring, low 4: active fat */
129*71f95118Swdenk 	__u8	version[2];	/* Filesystem version */
130*71f95118Swdenk 	__u32	root_cluster;	/* First cluster in root directory */
131*71f95118Swdenk 	__u16	info_sector;	/* Filesystem info sector */
132*71f95118Swdenk 	__u16	backup_boot;	/* Backup boot sector */
133*71f95118Swdenk 	__u16	reserved2[6];	/* Unused */
134*71f95118Swdenk } boot_sector;
135*71f95118Swdenk 
136*71f95118Swdenk typedef struct volume_info
137*71f95118Swdenk {
138*71f95118Swdenk 	__u8 drive_number;	/* BIOS drive number */
139*71f95118Swdenk 	__u8 reserved;		/* Unused */
140*71f95118Swdenk 	__u8 ext_boot_sign;	/* 0x29 if fields below exist (DOS 3.3+) */
141*71f95118Swdenk 	__u8 volume_id[4];	/* Volume ID number */
142*71f95118Swdenk 	char volume_label[11];	/* Volume label */
143*71f95118Swdenk 	char fs_type[8];	/* Typically FAT12, FAT16, or FAT32 */
144*71f95118Swdenk 	/* Boot code comes next, all but 2 bytes to fill up sector */
145*71f95118Swdenk 	/* Boot sign comes last, 2 bytes */
146*71f95118Swdenk } volume_info;
147*71f95118Swdenk 
148*71f95118Swdenk typedef struct dir_entry {
149*71f95118Swdenk 	char	name[8],ext[3];	/* Name and extension */
150*71f95118Swdenk 	__u8	attr;		/* Attribute bits */
151*71f95118Swdenk 	__u8	lcase;		/* Case for base and extension */
152*71f95118Swdenk 	__u8	ctime_ms;	/* Creation time, milliseconds */
153*71f95118Swdenk 	__u16	ctime;		/* Creation time */
154*71f95118Swdenk 	__u16	cdate;		/* Creation date */
155*71f95118Swdenk 	__u16	adate;		/* Last access date */
156*71f95118Swdenk 	__u16	starthi;	/* High 16 bits of cluster in FAT32 */
157*71f95118Swdenk 	__u16	time,date,start;/* Time, date and first cluster */
158*71f95118Swdenk 	__u32	size;		/* File size in bytes */
159*71f95118Swdenk } dir_entry;
160*71f95118Swdenk 
161*71f95118Swdenk typedef struct dir_slot {
162*71f95118Swdenk 	__u8    id;		/* Sequence number for slot */
163*71f95118Swdenk 	__u8    name0_4[10];	/* First 5 characters in name */
164*71f95118Swdenk 	__u8    attr;		/* Attribute byte */
165*71f95118Swdenk 	__u8    reserved;	/* Unused */
166*71f95118Swdenk 	__u8    alias_checksum;/* Checksum for 8.3 alias */
167*71f95118Swdenk 	__u8    name5_10[12];	/* 6 more characters in name */
168*71f95118Swdenk 	__u16   start;		/* Unused */
169*71f95118Swdenk 	__u8    name11_12[4];	/* Last 2 characters in name */
170*71f95118Swdenk } dir_slot;
171*71f95118Swdenk 
172*71f95118Swdenk /* Private filesystem parameters */
173*71f95118Swdenk typedef struct {
174*71f95118Swdenk 	int	fatsize;	/* Size of FAT in bits */
175*71f95118Swdenk 	__u16	fatlength;	/* Length of FAT in sectors */
176*71f95118Swdenk 	__u16	fat_sect;	/* Starting sector of the FAT */
177*71f95118Swdenk 	__u16	rootdir_sect;	/* Start sector of root directory */
178*71f95118Swdenk 	__u16	clust_size;	/* Size of clusters in sectors */
179*71f95118Swdenk 	__u16	data_begin;	/* The sector of the first cluster */
180*71f95118Swdenk 	__u8	fatbuf[FATBUFSIZE]; /* Current FAT buffer */
181*71f95118Swdenk 	int	fatbufnum;	/* Used by get_fatent, init to -1 */
182*71f95118Swdenk } fsdata;
183*71f95118Swdenk 
184*71f95118Swdenk typedef int	(file_detectfs_func)(void);
185*71f95118Swdenk typedef int	(file_ls_func)(const char *dir);
186*71f95118Swdenk typedef long	(file_read_func)(const char *filename, void *buffer,
187*71f95118Swdenk 				 unsigned long maxsize);
188*71f95118Swdenk 
189*71f95118Swdenk struct filesystem {
190*71f95118Swdenk 	file_detectfs_func *detect;
191*71f95118Swdenk 	file_ls_func	   *ls;
192*71f95118Swdenk 	file_read_func	   *read;
193*71f95118Swdenk 	const char	    name[12];
194*71f95118Swdenk };
195*71f95118Swdenk 
196*71f95118Swdenk /* FAT tables */
197*71f95118Swdenk file_detectfs_func	file_fat_detectfs;
198*71f95118Swdenk file_ls_func		file_fat_ls;
199*71f95118Swdenk file_read_func		file_fat_read;
200*71f95118Swdenk 
201*71f95118Swdenk /* Currently this doesn't check if the dir exists or is valid... */
202*71f95118Swdenk int file_cd(const char *path);
203*71f95118Swdenk int file_fat_detectfs(void);
204*71f95118Swdenk int file_fat_ls(const char *dir);
205*71f95118Swdenk long file_fat_read(const char *filename, void *buffer, unsigned long maxsize);
206*71f95118Swdenk const char *file_getfsname(int idx);
207*71f95118Swdenk 
208*71f95118Swdenk #endif /* _FAT_H_ */
209