| Line No. | Rev | Author | Line |
|---|---|---|---|
| 1 | 6 | kaklik | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 2 | <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> |
||
| 3 | <title>Procyon AVRlib: fat.h Source File</title> |
||
| 4 | <link href="dox.css" rel="stylesheet" type="text/css"> |
||
| 5 | </head><body> |
||
| 6 | <!-- Generated by Doxygen 1.4.2 --> |
||
| 7 | <div class="qindex"><a class="qindex" href="main.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> |
||
| 8 | <h1>fat.h</h1><a href="fat_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="comment">/*! \file fat.h \brief FAT16/32 file system driver. */</span> |
||
| 9 | 00002 <span class="comment">//*****************************************************************************</span> |
||
| 10 | 00003 <span class="comment">//</span> |
||
| 11 | 00004 <span class="comment">// File Name : 'fat.h'</span> |
||
| 12 | 00005 <span class="comment">// Title : FAT16/32 file system driver</span> |
||
| 13 | 00006 <span class="comment">// Author : Pascal Stang</span> |
||
| 14 | 00007 <span class="comment">// Date : 11/07/2000</span> |
||
| 15 | 00008 <span class="comment">// Revised : 12/12/2000</span> |
||
| 16 | 00009 <span class="comment">// Version : 0.3</span> |
||
| 17 | 00010 <span class="comment">// Target MCU : ATmega103 (should work for Atmel AVR Series)</span> |
||
| 18 | 00011 <span class="comment">// Editor Tabs : 4</span> |
||
| 19 | 00012 <span class="comment">//</span> |
||
| 20 | 00013 <span class="comment">// NOTE: This code is currently below version 1.0, and therefore is considered</span> |
||
| 21 | 00014 <span class="comment">// to be lacking in some functionality or documentation, or may not be fully</span> |
||
| 22 | 00015 <span class="comment">// tested. Nonetheless, you can expect most functions to work.</span> |
||
| 23 | 00016 <span class="comment">//</span><span class="comment"></span> |
||
| 24 | 00017 <span class="comment">/// \ingroup general</span> |
||
| 25 | 00018 <span class="comment">/// \defgroup fat FAT16/32 File System Interface (fat.c)</span> |
||
| 26 | 00019 <span class="comment">/// \code #include "fat.h" \endcode</span> |
||
| 27 | 00020 <span class="comment">/// \par Overview</span> |
||
| 28 | 00021 <span class="comment">/// This FAT16/32 interface allows you to detect and mount FAT16/32</span> |
||
| 29 | 00022 <span class="comment">/// partitions, browse directories and files, and read file data.</span> |
||
| 30 | 00023 <span class="comment">/// The interface is designed to operate with the avrlib IDE/ATA driver.</span> |
||
| 31 | 00024 <span class="comment">/// Reading FAT efficiently requires at least 512+ bytes of RAM so this</span> |
||
| 32 | 00025 <span class="comment">/// interface may not be suitable for processors with less than 1K of RAM.</span> |
||
| 33 | 00026 <span class="comment">/// This interface will properly follow a file's cluster chain so files</span> |
||
| 34 | 00027 <span class="comment">/// need not be defragmented.</span> |
||
| 35 | 00028 <span class="comment">///</span> |
||
| 36 | 00029 <span class="comment">/// \note This code is based in part on work done by Jesper Hansen for his</span> |
||
| 37 | 00030 <span class="comment">/// excellent YAMPP MP3 player project.</span> |
||
| 38 | 00031 <span class="comment"></span><span class="comment">//</span> |
||
| 39 | 00032 <span class="comment">// This code is distributed under the GNU Public License</span> |
||
| 40 | 00033 <span class="comment">// which can be found at http://www.gnu.org/licenses/gpl.txt</span> |
||
| 41 | 00034 <span class="comment">//</span> |
||
| 42 | 00035 <span class="comment">//*****************************************************************************</span> |
||
| 43 | 00036 |
||
| 44 | 00037 <span class="preprocessor">#ifndef FAT_H</span> |
||
| 45 | 00038 <span class="preprocessor"></span><span class="preprocessor">#define FAT_H</span> |
||
| 46 | 00039 <span class="preprocessor"></span> |
||
| 47 | 00040 <span class="preprocessor">#include "<a class="code" href="global_8h.html">global.h</a>"</span> |
||
| 48 | 00041 |
||
| 49 | 00042 |
||
| 50 | 00043 <span class="comment">// Some useful cluster numbers</span> |
||
| 51 | 00044 <span class="preprocessor">#define MSDOSFSROOT 0 // cluster 0 means the root dir</span> |
||
| 52 | 00045 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_FREE 0 // cluster 0 also means a free cluster</span> |
||
| 53 | 00046 <span class="preprocessor"></span><span class="preprocessor">#define MSDOSFSFREE CLUST_FREE</span> |
||
| 54 | 00047 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_FIRST 2 // first legal cluster number</span> |
||
| 55 | 00048 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_RSRVD 0xfffffff6 // reserved cluster range</span> |
||
| 56 | 00049 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_BAD 0xfffffff7 // a cluster with a defect</span> |
||
| 57 | 00050 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_EOFS 0xfffffff8 // start of eof cluster range</span> |
||
| 58 | 00051 <span class="preprocessor"></span><span class="preprocessor">#define CLUST_EOFE 0xffffffff // end of eof cluster range</span> |
||
| 59 | 00052 <span class="preprocessor"></span> |
||
| 60 | 00053 <span class="preprocessor">#define FAT12_MASK 0x00000fff // mask for 12 bit cluster numbers</span> |
||
| 61 | 00054 <span class="preprocessor"></span><span class="preprocessor">#define FAT16_MASK 0x0000ffff // mask for 16 bit cluster numbers</span> |
||
| 62 | 00055 <span class="preprocessor"></span><span class="preprocessor">#define FAT32_MASK 0x0fffffff // mask for FAT32 cluster numbers</span> |
||
| 63 | 00056 <span class="preprocessor"></span> |
||
| 64 | 00057 |
||
| 65 | 00058 <span class="comment">// Partition Type used in the partition record</span> |
||
| 66 | 00059 <span class="preprocessor">#define PART_TYPE_UNKNOWN 0x00</span> |
||
| 67 | 00060 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_FAT12 0x01</span> |
||
| 68 | 00061 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_XENIX 0x02</span> |
||
| 69 | 00062 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_DOSFAT16 0x04</span> |
||
| 70 | 00063 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_EXTDOS 0x05</span> |
||
| 71 | 00064 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_FAT16 0x06</span> |
||
| 72 | 00065 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_NTFS 0x07</span> |
||
| 73 | 00066 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_FAT32 0x0B</span> |
||
| 74 | 00067 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_FAT32LBA 0x0C</span> |
||
| 75 | 00068 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_FAT16LBA 0x0E</span> |
||
| 76 | 00069 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_EXTDOSLBA 0x0F</span> |
||
| 77 | 00070 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_ONTRACK 0x33</span> |
||
| 78 | 00071 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_NOVELL 0x40</span> |
||
| 79 | 00072 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_PCIX 0x4B</span> |
||
| 80 | 00073 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_PHOENIXSAVE 0xA0</span> |
||
| 81 | 00074 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_CPM 0xDB</span> |
||
| 82 | 00075 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_DBFS 0xE0</span> |
||
| 83 | 00076 <span class="preprocessor"></span><span class="preprocessor">#define PART_TYPE_BBT 0xFF</span> |
||
| 84 | 00077 <span class="preprocessor"></span> |
||
| 85 | 00078 <span class="keyword">struct </span>partrecord <span class="comment">// length 16 bytes</span> |
||
| 86 | 00079 { |
||
| 87 | 00080 BYTE prIsActive; <span class="comment">// 0x80 indicates active partition</span> |
||
| 88 | 00081 BYTE prStartHead; <span class="comment">// starting head for partition</span> |
||
| 89 | 00082 WORD prStartCylSect; <span class="comment">// starting cylinder and sector</span> |
||
| 90 | 00083 BYTE prPartType; <span class="comment">// partition type (see above)</span> |
||
| 91 | 00084 BYTE prEndHead; <span class="comment">// ending head for this partition</span> |
||
| 92 | 00085 WORD prEndCylSect; <span class="comment">// ending cylinder and sector</span> |
||
| 93 | 00086 DWORD prStartLBA; <span class="comment">// first LBA sector for this partition</span> |
||
| 94 | 00087 DWORD prSize; <span class="comment">// size of this partition (bytes or sectors ?)</span> |
||
| 95 | 00088 }; |
||
| 96 | 00089 |
||
| 97 | 00090 |
||
| 98 | 00091 <span class="keyword">struct </span>partsector |
||
| 99 | 00092 { |
||
| 100 | 00093 CHAR psPartCode[512-64-2]; <span class="comment">// pad so struct is 512b</span> |
||
| 101 | 00094 BYTE psPart[64]; <span class="comment">// four partition records (64 bytes)</span> |
||
| 102 | 00095 BYTE psBootSectSig0; <span class="comment">// two signature bytes (2 bytes)</span> |
||
| 103 | 00096 BYTE psBootSectSig1; |
||
| 104 | 00097 <span class="preprocessor">#define BOOTSIG0 0x55</span> |
||
| 105 | 00098 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG1 0xaa</span> |
||
| 106 | 00099 <span class="preprocessor"></span>}; |
||
| 107 | 00100 |
||
| 108 | 00101 |
||
| 109 | 00102 |
||
| 110 | 00103 <span class="comment">// Format of a boot sector. This is the first sector on a DOS floppy disk</span> |
||
| 111 | 00104 <span class="comment">// or the first sector of a partition on a hard disk. But, it is not the</span> |
||
| 112 | 00105 <span class="comment">// first sector of a partitioned hard disk.</span> |
||
| 113 | 00106 <span class="keyword">struct </span>bootsector33 { |
||
| 114 | 00107 BYTE bsJump[3]; <span class="comment">// jump inst E9xxxx or EBxx90</span> |
||
| 115 | 00108 CHAR bsOemName[8]; <span class="comment">// OEM name and version</span> |
||
| 116 | 00109 CHAR bsBPB[19]; <span class="comment">// BIOS parameter block</span> |
||
| 117 | 00110 CHAR bsDriveNumber; <span class="comment">// drive number (0x80)</span> |
||
| 118 | 00111 CHAR bsBootCode[479]; <span class="comment">// pad so struct is 512b</span> |
||
| 119 | 00112 BYTE bsBootSectSig0; <span class="comment">// boot sector signature byte 0x55</span> |
||
| 120 | 00113 BYTE bsBootSectSig1; <span class="comment">// boot sector signature byte 0xAA</span> |
||
| 121 | 00114 <span class="preprocessor">#define BOOTSIG0 0x55</span> |
||
| 122 | 00115 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG1 0xaa</span> |
||
| 123 | 00116 <span class="preprocessor"></span>}; |
||
| 124 | 00117 |
||
| 125 | 00118 <span class="keyword">struct </span>extboot { |
||
| 126 | 00119 CHAR exDriveNumber; <span class="comment">// drive number (0x80)</span> |
||
| 127 | 00120 CHAR exReserved1; <span class="comment">// reserved</span> |
||
| 128 | 00121 CHAR exBootSignature; <span class="comment">// ext. boot signature (0x29)</span> |
||
| 129 | 00122 <span class="preprocessor">#define EXBOOTSIG 0x29</span> |
||
| 130 | 00123 <span class="preprocessor"></span> CHAR exVolumeID[4]; <span class="comment">// volume ID number</span> |
||
| 131 | 00124 CHAR exVolumeLabel[11]; <span class="comment">// volume label</span> |
||
| 132 | 00125 CHAR exFileSysType[8]; <span class="comment">// fs type (FAT12 or FAT16)</span> |
||
| 133 | 00126 }; |
||
| 134 | 00127 |
||
| 135 | 00128 <span class="keyword">struct </span>bootsector50 { |
||
| 136 | 00129 BYTE bsJump[3]; <span class="comment">// jump inst E9xxxx or EBxx90</span> |
||
| 137 | 00130 CHAR bsOemName[8]; <span class="comment">// OEM name and version</span> |
||
| 138 | 00131 CHAR bsBPB[25]; <span class="comment">// BIOS parameter block</span> |
||
| 139 | 00132 CHAR bsExt[26]; <span class="comment">// Bootsector Extension</span> |
||
| 140 | 00133 CHAR bsBootCode[448]; <span class="comment">// pad so structure is 512b</span> |
||
| 141 | 00134 BYTE bsBootSectSig0; <span class="comment">// boot sector signature byte 0x55 </span> |
||
| 142 | 00135 BYTE bsBootSectSig1; <span class="comment">// boot sector signature byte 0xAA</span> |
||
| 143 | 00136 <span class="preprocessor">#define BOOTSIG0 0x55</span> |
||
| 144 | 00137 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG1 0xaa</span> |
||
| 145 | 00138 <span class="preprocessor"></span>}; |
||
| 146 | 00139 |
||
| 147 | 00140 <span class="keyword">struct </span>bootsector710 { |
||
| 148 | 00141 BYTE bsJump[3]; <span class="comment">// jump inst E9xxxx or EBxx90</span> |
||
| 149 | 00142 CHAR bsOEMName[8]; <span class="comment">// OEM name and version</span> |
||
| 150 | 00143 CHAR bsBPB[53]; <span class="comment">// BIOS parameter block</span> |
||
| 151 | 00144 CHAR bsExt[26]; <span class="comment">// Bootsector Extension</span> |
||
| 152 | 00145 CHAR bsBootCode[418]; <span class="comment">// pad so structure is 512b</span> |
||
| 153 | 00146 BYTE bsBootSectSig2; <span class="comment">// 2 & 3 are only defined for FAT32?</span> |
||
| 154 | 00147 BYTE bsBootSectSig3; |
||
| 155 | 00148 BYTE bsBootSectSig0; <span class="comment">// boot sector signature byte 0x55</span> |
||
| 156 | 00149 BYTE bsBootSectSig1; <span class="comment">// boot sector signature byte 0xAA</span> |
||
| 157 | 00150 <span class="preprocessor">#define BOOTSIG0 0x55</span> |
||
| 158 | 00151 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG1 0xaa</span> |
||
| 159 | 00152 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG2 0</span> |
||
| 160 | 00153 <span class="preprocessor"></span><span class="preprocessor">#define BOOTSIG3 0</span> |
||
| 161 | 00154 <span class="preprocessor"></span>}; |
||
| 162 | 00155 |
||
| 163 | 00156 |
||
| 164 | 00157 <span class="comment">/***************************************************************/</span> |
||
| 165 | 00158 <span class="comment">/***************************************************************/</span> |
||
| 166 | 00159 |
||
| 167 | 00160 <span class="comment">// BIOS Parameter Block (BPB) for DOS 3.3</span> |
||
| 168 | 00161 <span class="keyword">struct </span>bpb33 { |
||
| 169 | 00162 WORD bpbBytesPerSec; <span class="comment">// bytes per sector</span> |
||
| 170 | 00163 BYTE bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 171 | 00164 WORD bpbResSectors; <span class="comment">// number of reserved sectors</span> |
||
| 172 | 00165 BYTE bpbFATs; <span class="comment">// number of FATs</span> |
||
| 173 | 00166 WORD bpbRootDirEnts; <span class="comment">// number of root directory entries</span> |
||
| 174 | 00167 WORD bpbSectors; <span class="comment">// total number of sectors</span> |
||
| 175 | 00168 BYTE bpbMedia; <span class="comment">// media descriptor</span> |
||
| 176 | 00169 WORD bpbFATsecs; <span class="comment">// number of sectors per FAT</span> |
||
| 177 | 00170 WORD bpbSecPerTrack; <span class="comment">// sectors per track</span> |
||
| 178 | 00171 WORD bpbHeads; <span class="comment">// number of heads</span> |
||
| 179 | 00172 WORD bpbHiddenSecs; <span class="comment">// number of hidden sectors</span> |
||
| 180 | 00173 }; |
||
| 181 | 00174 |
||
| 182 | 00175 <span class="comment">// BPB for DOS 5.0</span> |
||
| 183 | 00176 <span class="comment">// The difference is bpbHiddenSecs is a short for DOS 3.3,</span> |
||
| 184 | 00177 <span class="comment">// and bpbHugeSectors is not present in the DOS 3.3 bpb.</span> |
||
| 185 | 00178 <span class="keyword">struct </span>bpb50 { |
||
| 186 | 00179 WORD bpbBytesPerSec; <span class="comment">// bytes per sector</span> |
||
| 187 | 00180 BYTE bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 188 | 00181 WORD bpbResSectors; <span class="comment">// number of reserved sectors</span> |
||
| 189 | 00182 BYTE bpbFATs; <span class="comment">// number of FATs</span> |
||
| 190 | 00183 WORD bpbRootDirEnts; <span class="comment">// number of root directory entries</span> |
||
| 191 | 00184 WORD bpbSectors; <span class="comment">// total number of sectors</span> |
||
| 192 | 00185 BYTE bpbMedia; <span class="comment">// media descriptor</span> |
||
| 193 | 00186 WORD bpbFATsecs; <span class="comment">// number of sectors per FAT</span> |
||
| 194 | 00187 WORD bpbSecPerTrack; <span class="comment">// sectors per track</span> |
||
| 195 | 00188 WORD bpbHeads; <span class="comment">// number of heads</span> |
||
| 196 | 00189 DWORD bpbHiddenSecs; <span class="comment">// # of hidden sectors</span> |
||
| 197 | 00190 <span class="comment">// 3.3 compat ends here</span> |
||
| 198 | 00191 DWORD bpbHugeSectors; <span class="comment">// # of sectors if bpbSectors == 0</span> |
||
| 199 | 00192 }; |
||
| 200 | 00193 |
||
| 201 | 00194 <span class="comment">// BPB for DOS 7.10 (FAT32)</span> |
||
| 202 | 00195 <span class="comment">// This one has a few extensions to bpb50.</span> |
||
| 203 | 00196 <span class="keyword">struct </span>bpb710 { |
||
| 204 | 00197 WORD bpbBytesPerSec; <span class="comment">// bytes per sector</span> |
||
| 205 | 00198 BYTE bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 206 | 00199 WORD bpbResSectors; <span class="comment">// number of reserved sectors</span> |
||
| 207 | 00200 BYTE bpbFATs; <span class="comment">// number of FATs</span> |
||
| 208 | 00201 WORD bpbRootDirEnts; <span class="comment">// number of root directory entries</span> |
||
| 209 | 00202 WORD bpbSectors; <span class="comment">// total number of sectors</span> |
||
| 210 | 00203 BYTE bpbMedia; <span class="comment">// media descriptor</span> |
||
| 211 | 00204 WORD bpbFATsecs; <span class="comment">// number of sectors per FAT</span> |
||
| 212 | 00205 WORD bpbSecPerTrack; <span class="comment">// sectors per track</span> |
||
| 213 | 00206 WORD bpbHeads; <span class="comment">// number of heads</span> |
||
| 214 | 00207 DWORD bpbHiddenSecs; <span class="comment">// # of hidden sectors</span> |
||
| 215 | 00208 <span class="comment">// 3.3 compat ends here</span> |
||
| 216 | 00209 DWORD bpbHugeSectors; <span class="comment">// # of sectors if bpbSectors == 0</span> |
||
| 217 | 00210 <span class="comment">// 5.0 compat ends here</span> |
||
| 218 | 00211 DWORD bpbBigFATsecs;<span class="comment">// like bpbFATsecs for FAT32</span> |
||
| 219 | 00212 WORD bpbExtFlags; <span class="comment">// extended flags:</span> |
||
| 220 | 00213 <span class="preprocessor">#define FATNUM 0xf // mask for numbering active FAT</span> |
||
| 221 | 00214 <span class="preprocessor"></span><span class="preprocessor">#define FATMIRROR 0x80 // FAT is mirrored (like it always was)</span> |
||
| 222 | 00215 <span class="preprocessor"></span> WORD bpbFSVers; <span class="comment">// filesystem version</span> |
||
| 223 | 00216 <span class="preprocessor">#define FSVERS 0 // currently only 0 is understood</span> |
||
| 224 | 00217 <span class="preprocessor"></span> DWORD bpbRootClust; <span class="comment">// start cluster for root directory</span> |
||
| 225 | 00218 WORD bpbFSInfo; <span class="comment">// filesystem info structure sector</span> |
||
| 226 | 00219 WORD bpbBackup; <span class="comment">// backup boot sector</span> |
||
| 227 | 00220 <span class="comment">// There is a 12 byte filler here, but we ignore it</span> |
||
| 228 | 00221 }; |
||
| 229 | 00222 |
||
| 230 | 00223 |
||
| 231 | 00224 |
||
| 232 | 00225 |
||
| 233 | 00226 <span class="comment">// ***************************************************************</span> |
||
| 234 | 00227 <span class="comment">// * byte versions of the above structs *</span> |
||
| 235 | 00228 <span class="comment">// ***************************************************************</span> |
||
| 236 | 00229 |
||
| 237 | 00230 |
||
| 238 | 00231 <span class="comment">// BIOS Parameter Block (BPB) for DOS 3.3</span> |
||
| 239 | 00232 <span class="keyword">struct </span>byte_bpb33 { |
||
| 240 | 00233 CHAR bpbBytesPerSec[2]; <span class="comment">// bytes per sector</span> |
||
| 241 | 00234 CHAR bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 242 | 00235 CHAR bpbResSectors[2]; <span class="comment">// number of reserved sectors</span> |
||
| 243 | 00236 CHAR bpbFATs; <span class="comment">// number of FATs</span> |
||
| 244 | 00237 CHAR bpbRootDirEnts[2]; <span class="comment">// number of root directory entries</span> |
||
| 245 | 00238 CHAR bpbSectors[2]; <span class="comment">// total number of sectors</span> |
||
| 246 | 00239 CHAR bpbMedia; <span class="comment">// media descriptor</span> |
||
| 247 | 00240 CHAR bpbFATsecs[2]; <span class="comment">// number of sectors per FAT</span> |
||
| 248 | 00241 CHAR bpbSecPerTrack[2]; <span class="comment">// sectors per track</span> |
||
| 249 | 00242 CHAR bpbHeads[2]; <span class="comment">// number of heads</span> |
||
| 250 | 00243 CHAR bpbHiddenSecs[2]; <span class="comment">// number of hidden sectors</span> |
||
| 251 | 00244 }; |
||
| 252 | 00245 |
||
| 253 | 00246 <span class="comment">// BPB for DOS 5.0</span> |
||
| 254 | 00247 <span class="comment">// The difference is bpbHiddenSecs is a short for DOS 3.3,</span> |
||
| 255 | 00248 <span class="comment">// and bpbHugeSectors is not in the 3.3 bpb.</span> |
||
| 256 | 00249 <span class="keyword">struct </span>byte_bpb50 { |
||
| 257 | 00250 CHAR bpbBytesPerSec[2]; <span class="comment">// bytes per sector</span> |
||
| 258 | 00251 CHAR bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 259 | 00252 CHAR bpbResSectors[2]; <span class="comment">// number of reserved sectors</span> |
||
| 260 | 00253 CHAR bpbFATs; <span class="comment">// number of FATs</span> |
||
| 261 | 00254 CHAR bpbRootDirEnts[2]; <span class="comment">// number of root directory entries</span> |
||
| 262 | 00255 CHAR bpbSectors[2]; <span class="comment">// total number of sectors</span> |
||
| 263 | 00256 CHAR bpbMedia; <span class="comment">// media descriptor</span> |
||
| 264 | 00257 CHAR bpbFATsecs[2]; <span class="comment">// number of sectors per FAT</span> |
||
| 265 | 00258 CHAR bpbSecPerTrack[2]; <span class="comment">// sectors per track</span> |
||
| 266 | 00259 CHAR bpbHeads[2]; <span class="comment">// number of heads</span> |
||
| 267 | 00260 CHAR bpbHiddenSecs[4]; <span class="comment">// number of hidden sectors</span> |
||
| 268 | 00261 CHAR bpbHugeSectors[4]; <span class="comment">// # of sectors if bpbSectors == 0</span> |
||
| 269 | 00262 }; |
||
| 270 | 00263 |
||
| 271 | 00264 <span class="comment">// BPB for DOS 7.10 (FAT32).</span> |
||
| 272 | 00265 <span class="comment">// This one has a few extensions to bpb50.</span> |
||
| 273 | 00266 <span class="keyword">struct </span>byte_bpb710 { |
||
| 274 | 00267 BYTE bpbBytesPerSec[2]; <span class="comment">// bytes per sector</span> |
||
| 275 | 00268 BYTE bpbSecPerClust; <span class="comment">// sectors per cluster</span> |
||
| 276 | 00269 BYTE bpbResSectors[2]; <span class="comment">// number of reserved sectors</span> |
||
| 277 | 00270 BYTE bpbFATs; <span class="comment">// number of FATs</span> |
||
| 278 | 00271 BYTE bpbRootDirEnts[2]; <span class="comment">// number of root directory entries</span> |
||
| 279 | 00272 BYTE bpbSectors[2]; <span class="comment">// total number of sectors</span> |
||
| 280 | 00273 BYTE bpbMedia; <span class="comment">// media descriptor</span> |
||
| 281 | 00274 BYTE bpbFATsecs[2]; <span class="comment">// number of sectors per FAT</span> |
||
| 282 | 00275 BYTE bpbSecPerTrack[2]; <span class="comment">// sectors per track</span> |
||
| 283 | 00276 BYTE bpbHeads[2]; <span class="comment">// number of heads</span> |
||
| 284 | 00277 BYTE bpbHiddenSecs[4]; <span class="comment">// # of hidden sectors</span> |
||
| 285 | 00278 BYTE bpbHugeSectors[4]; <span class="comment">// # of sectors if bpbSectors == 0</span> |
||
| 286 | 00279 BYTE bpbBigFATsecs[4]; <span class="comment">// like bpbFATsecs for FAT32</span> |
||
| 287 | 00280 BYTE bpbExtFlags[2]; <span class="comment">// extended flags:</span> |
||
| 288 | 00281 BYTE bpbFSVers[2]; <span class="comment">// filesystem version</span> |
||
| 289 | 00282 BYTE bpbRootClust[4]; <span class="comment">// start cluster for root directory</span> |
||
| 290 | 00283 BYTE bpbFSInfo[2]; <span class="comment">// filesystem info structure sector</span> |
||
| 291 | 00284 BYTE bpbBackup[2]; <span class="comment">// backup boot sector</span> |
||
| 292 | 00285 <span class="comment">// There is a 12 byte filler here, but we ignore it</span> |
||
| 293 | 00286 }; |
||
| 294 | 00287 |
||
| 295 | 00288 <span class="comment">// FAT32 FSInfo block.</span> |
||
| 296 | 00289 <span class="keyword">struct </span>fsinfo { |
||
| 297 | 00290 BYTE fsisig1[4]; |
||
| 298 | 00291 BYTE fsifill1[480]; |
||
| 299 | 00292 BYTE fsisig2[4]; |
||
| 300 | 00293 BYTE fsinfree[4]; |
||
| 301 | 00294 BYTE fsinxtfree[4]; |
||
| 302 | 00295 BYTE fsifill2[12]; |
||
| 303 | 00296 BYTE fsisig3[4]; |
||
| 304 | 00297 BYTE fsifill3[508]; |
||
| 305 | 00298 BYTE fsisig4[4]; |
||
| 306 | 00299 }; |
||
| 307 | 00300 |
||
| 308 | 00301 |
||
| 309 | 00302 <span class="comment">/***************************************************************/</span> |
||
| 310 | 00303 <span class="comment">/***************************************************************/</span> |
||
| 311 | 00304 |
||
| 312 | 00305 |
||
| 313 | 00306 <span class="comment">// Structure of a dos directory entry.</span> |
||
| 314 | 00307 <span class="keyword">struct </span>direntry { |
||
| 315 | 00308 BYTE deName[8]; <span class="comment">// filename, blank filled</span> |
||
| 316 | 00309 <span class="preprocessor">#define SLOT_EMPTY 0x00 // slot has never been used</span> |
||
| 317 | 00310 <span class="preprocessor"></span><span class="preprocessor">#define SLOT_E5 0x05 // the real value is 0xE5</span> |
||
| 318 | 00311 <span class="preprocessor"></span><span class="preprocessor">#define SLOT_DELETED 0xE5 // file in this slot deleted</span> |
||
| 319 | 00312 <span class="preprocessor"></span> BYTE deExtension[3]; <span class="comment">// extension, blank filled</span> |
||
| 320 | 00313 BYTE deAttributes; <span class="comment">// file attributes</span> |
||
| 321 | 00314 <span class="preprocessor">#define ATTR_NORMAL 0x00 // normal file</span> |
||
| 322 | 00315 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_READONLY 0x01 // file is readonly</span> |
||
| 323 | 00316 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_HIDDEN 0x02 // file is hidden</span> |
||
| 324 | 00317 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_SYSTEM 0x04 // file is a system file</span> |
||
| 325 | 00318 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_VOLUME 0x08 // entry is a volume label</span> |
||
| 326 | 00319 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_LONG_FILENAME 0x0F // this is a long filename entry </span> |
||
| 327 | 00320 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_DIRECTORY 0x10 // entry is a directory name</span> |
||
| 328 | 00321 <span class="preprocessor"></span><span class="preprocessor">#define ATTR_ARCHIVE 0x20 // file is new or modified</span> |
||
| 329 | 00322 <span class="preprocessor"></span> BYTE deLowerCase; <span class="comment">// NT VFAT lower case flags (set to zero)</span> |
||
| 330 | 00323 <span class="preprocessor">#define LCASE_BASE 0x08 // filename base in lower case</span> |
||
| 331 | 00324 <span class="preprocessor"></span><span class="preprocessor">#define LCASE_EXT 0x10 // filename extension in lower case</span> |
||
| 332 | 00325 <span class="preprocessor"></span> BYTE deCHundredth; <span class="comment">// hundredth of seconds in CTime</span> |
||
| 333 | 00326 BYTE deCTime[2]; <span class="comment">// create time</span> |
||
| 334 | 00327 BYTE deCDate[2]; <span class="comment">// create date</span> |
||
| 335 | 00328 BYTE deADate[2]; <span class="comment">// access date</span> |
||
| 336 | 00329 WORD deHighClust; <span class="comment">// high bytes of cluster number</span> |
||
| 337 | 00330 BYTE deMTime[2]; <span class="comment">// last update time</span> |
||
| 338 | 00331 BYTE deMDate[2]; <span class="comment">// last update date</span> |
||
| 339 | 00332 WORD deStartCluster; <span class="comment">// starting cluster of file</span> |
||
| 340 | 00333 DWORD deFileSize; <span class="comment">// size of file in bytes</span> |
||
| 341 | 00334 }; |
||
| 342 | 00335 |
||
| 343 | 00336 <span class="comment">// number of directory entries in one sector</span> |
||
| 344 | 00337 <span class="preprocessor">#define DIRENTRIES_PER_SECTOR 0x10</span> |
||
| 345 | 00338 <span class="preprocessor"></span> |
||
| 346 | 00339 <span class="comment">// Structure of a Win95 long name directory entry</span> |
||
| 347 | 00340 <span class="keyword">struct </span>winentry { |
||
| 348 | 00341 BYTE weCnt; <span class="comment">// </span> |
||
| 349 | 00342 <span class="preprocessor">#define WIN_LAST 0x40</span> |
||
| 350 | 00343 <span class="preprocessor"></span><span class="preprocessor">#define WIN_CNT 0x3f</span> |
||
| 351 | 00344 <span class="preprocessor"></span> BYTE wePart1[10]; |
||
| 352 | 00345 BYTE weAttributes; |
||
| 353 | 00346 <span class="preprocessor">#define ATTR_WIN95 0x0f</span> |
||
| 354 | 00347 <span class="preprocessor"></span> BYTE weReserved1; |
||
| 355 | 00348 BYTE weChksum; |
||
| 356 | 00349 BYTE wePart2[12]; |
||
| 357 | 00350 WORD weReserved2; |
||
| 358 | 00351 BYTE wePart3[4]; |
||
| 359 | 00352 }; |
||
| 360 | 00353 |
||
| 361 | 00354 <span class="preprocessor">#define WIN_ENTRY_CHARS 13 // Number of chars per winentry</span> |
||
| 362 | 00355 <span class="preprocessor"></span> |
||
| 363 | 00356 <span class="comment">// Maximum filename length in Win95</span> |
||
| 364 | 00357 <span class="comment">// Note: Must be < sizeof(dirent.d_name)</span> |
||
| 365 | 00358 <span class="preprocessor">#define WIN_MAXLEN 255</span> |
||
| 366 | 00359 <span class="preprocessor"></span> |
||
| 367 | 00360 <span class="comment">// This is the format of the contents of the deTime field in the direntry</span> |
||
| 368 | 00361 <span class="comment">// structure.</span> |
||
| 369 | 00362 <span class="comment">// We don't use bitfields because we don't know how compilers for</span> |
||
| 370 | 00363 <span class="comment">// arbitrary machines will lay them out.</span> |
||
| 371 | 00364 <span class="preprocessor">#define DT_2SECONDS_MASK 0x1F // seconds divided by 2</span> |
||
| 372 | 00365 <span class="preprocessor"></span><span class="preprocessor">#define DT_2SECONDS_SHIFT 0</span> |
||
| 373 | 00366 <span class="preprocessor"></span><span class="preprocessor">#define DT_MINUTES_MASK 0x7E0 // minutes</span> |
||
| 374 | 00367 <span class="preprocessor"></span><span class="preprocessor">#define DT_MINUTES_SHIFT 5</span> |
||
| 375 | 00368 <span class="preprocessor"></span><span class="preprocessor">#define DT_HOURS_MASK 0xF800 // hours</span> |
||
| 376 | 00369 <span class="preprocessor"></span><span class="preprocessor">#define DT_HOURS_SHIFT 11</span> |
||
| 377 | 00370 <span class="preprocessor"></span> |
||
| 378 | 00371 <span class="comment">// This is the format of the contents of the deDate field in the direntry</span> |
||
| 379 | 00372 <span class="comment">// structure.</span> |
||
| 380 | 00373 <span class="preprocessor">#define DD_DAY_MASK 0x1F // day of month</span> |
||
| 381 | 00374 <span class="preprocessor"></span><span class="preprocessor">#define DD_DAY_SHIFT 0</span> |
||
| 382 | 00375 <span class="preprocessor"></span><span class="preprocessor">#define DD_MONTH_MASK 0x1E0 // month</span> |
||
| 383 | 00376 <span class="preprocessor"></span><span class="preprocessor">#define DD_MONTH_SHIFT 5</span> |
||
| 384 | 00377 <span class="preprocessor"></span><span class="preprocessor">#define DD_YEAR_MASK 0xFE00 // year - 1980</span> |
||
| 385 | 00378 <span class="preprocessor"></span><span class="preprocessor">#define DD_YEAR_SHIFT 9</span> |
||
| 386 | 00379 <span class="preprocessor"></span> |
||
| 387 | 00380 <span class="comment">// Stuctures</span> |
||
| 388 | 00381 <span class="keyword">struct </span>FileInfoStruct |
||
| 389 | 00382 { |
||
| 390 | 00383 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> StartCluster; <span class="comment">//< file starting cluster for last file accessed</span> |
||
| 391 | 00384 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> Size; <span class="comment">//< file size for last file accessed</span> |
||
| 392 | 00385 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> Attr; <span class="comment">//< file attr for last file accessed</span> |
||
| 393 | 00386 <span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> CreateTime; <span class="comment">//< file creation time for last file accessed</span> |
||
| 394 | 00387 <span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> CreateDate; <span class="comment">//< file creation date for last file accessed</span> |
||
| 395 | 00388 }; |
||
| 396 | 00389 |
||
| 397 | 00390 <span class="comment">// Prototypes</span> |
||
| 398 | 00391 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> fatInit( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> device); |
||
| 399 | 00392 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fatClusterSize(<span class="keywordtype">void</span>); |
||
| 400 | 00393 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> fatGetDirEntry(<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> entry); |
||
| 401 | 00394 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> fatChangeDirectory(<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> entry); |
||
| 402 | 00395 <span class="keywordtype">void</span> fatPrintDirEntry(<span class="keywordtype">void</span>); |
||
| 403 | 00396 <span class="keywordtype">void</span> fatDumpDirSlot(<span class="keywordtype">unsigned</span> <span class="keywordtype">short</span> entry); |
||
| 404 | 00397 <span class="keyword">struct </span>FileInfoStruct* fatGetFileInfo(<span class="keywordtype">void</span>); |
||
| 405 | 00398 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> fatGetFilesize(<span class="keywordtype">void</span>); |
||
| 406 | 00399 <span class="keywordtype">char</span>* fatGetFilename(<span class="keywordtype">void</span>); |
||
| 407 | 00400 <span class="keywordtype">char</span>* fatGetDirname(<span class="keywordtype">void</span>); |
||
| 408 | 00401 <span class="keywordtype">void</span> fatLoadCluster(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> cluster, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buffer); |
||
| 409 | 00402 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> fatNextCluster(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> cluster); |
||
| 410 | 00403 |
||
| 411 | 00404 <span class="preprocessor">#endif</span> |
||
| 412 | </pre></div><hr size="1"><address style="align: right;"><small>Generated on Sun Oct 29 03:41:06 2006 for Procyon AVRlib by |
||
| 413 | <a href="http://www.doxygen.org/index.html"> |
||
| 414 | <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.2 </small></address> |
||
| 415 | </body> |
||
| 416 | </html> |
Powered by WebSVN v2.8.3