You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

308 lines
15KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.8.10"/>
  7. <title>SdFat: directoryEntry Struct Reference</title>
  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  9. <script type="text/javascript" src="jquery.js"></script>
  10. <script type="text/javascript" src="dynsections.js"></script>
  11. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  12. <script type="text/javascript" src="search/searchdata.js"></script>
  13. <script type="text/javascript" src="search/search.js"></script>
  14. <script type="text/javascript">
  15. $(document).ready(function() { init_search(); });
  16. </script>
  17. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  18. </head>
  19. <body>
  20. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  21. <div id="titlearea">
  22. <table cellspacing="0" cellpadding="0">
  23. <tbody>
  24. <tr style="height: 56px;">
  25. <td id="projectalign" style="padding-left: 0.5em;">
  26. <div id="projectname">SdFat
  27. </div>
  28. </td>
  29. </tr>
  30. </tbody>
  31. </table>
  32. </div>
  33. <!-- end header part -->
  34. <!-- Generated by Doxygen 1.8.10 -->
  35. <script type="text/javascript">
  36. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  37. </script>
  38. <div id="navrow1" class="tabs">
  39. <ul class="tablist">
  40. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  41. <li><a href="modules.html"><span>Modules</span></a></li>
  42. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  43. <li><a href="files.html"><span>Files</span></a></li>
  44. <li>
  45. <div id="MSearchBox" class="MSearchBoxInactive">
  46. <span class="left">
  47. <img id="MSearchSelect" src="search/mag_sel.png"
  48. onmouseover="return searchBox.OnSearchSelectShow()"
  49. onmouseout="return searchBox.OnSearchSelectHide()"
  50. alt=""/>
  51. <input type="text" id="MSearchField" value="Search" accesskey="S"
  52. onfocus="searchBox.OnSearchFieldFocus(true)"
  53. onblur="searchBox.OnSearchFieldFocus(false)"
  54. onkeyup="searchBox.OnSearchFieldChange(event)"/>
  55. </span><span class="right">
  56. <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
  57. </span>
  58. </div>
  59. </li>
  60. </ul>
  61. </div>
  62. <div id="navrow2" class="tabs2">
  63. <ul class="tablist">
  64. <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  65. <li><a href="inherits.html"><span>Class&#160;Hierarchy</span></a></li>
  66. <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  67. </ul>
  68. </div>
  69. <!-- window showing the filter options -->
  70. <div id="MSearchSelectWindow"
  71. onmouseover="return searchBox.OnSearchSelectShow()"
  72. onmouseout="return searchBox.OnSearchSelectHide()"
  73. onkeydown="return searchBox.OnSearchSelectKey(event)">
  74. </div>
  75. <!-- iframe showing the search results (closed by default) -->
  76. <div id="MSearchResultsWindow">
  77. <iframe src="javascript:void(0)" frameborder="0"
  78. name="MSearchResults" id="MSearchResults">
  79. </iframe>
  80. </div>
  81. </div><!-- top -->
  82. <div class="header">
  83. <div class="summary">
  84. <a href="#pub-attribs">Public Attributes</a> &#124;
  85. <a href="structdirectory_entry-members.html">List of all members</a> </div>
  86. <div class="headertitle">
  87. <div class="title">directoryEntry Struct Reference</div> </div>
  88. </div><!--header-->
  89. <div class="contents">
  90. <p>FAT short directory entry.
  91. <a href="structdirectory_entry.html#details">More...</a></p>
  92. <p><code>#include &lt;FatStructs.h&gt;</code></p>
  93. <table class="memberdecls">
  94. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
  95. Public Attributes</h2></td></tr>
  96. <tr class="memitem:a16c6cde55c8175c90935c386f1cfb21a"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a16c6cde55c8175c90935c386f1cfb21a">attributes</a></td></tr>
  97. <tr class="separator:a16c6cde55c8175c90935c386f1cfb21a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  98. <tr class="memitem:a7b43372794655fe6604d3c17c02302fe"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a7b43372794655fe6604d3c17c02302fe">creationDate</a></td></tr>
  99. <tr class="separator:a7b43372794655fe6604d3c17c02302fe"><td class="memSeparator" colspan="2">&#160;</td></tr>
  100. <tr class="memitem:a622bfa70c2cd9006108d7473d737a953"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a622bfa70c2cd9006108d7473d737a953">creationTime</a></td></tr>
  101. <tr class="separator:a622bfa70c2cd9006108d7473d737a953"><td class="memSeparator" colspan="2">&#160;</td></tr>
  102. <tr class="memitem:aa5e1ce5b411b88f005b28a3e7c7c5af6"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#aa5e1ce5b411b88f005b28a3e7c7c5af6">creationTimeTenths</a></td></tr>
  103. <tr class="separator:aa5e1ce5b411b88f005b28a3e7c7c5af6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  104. <tr class="memitem:ac2445d99b50f925f662952e0ccd26a02"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#ac2445d99b50f925f662952e0ccd26a02">fileSize</a></td></tr>
  105. <tr class="separator:ac2445d99b50f925f662952e0ccd26a02"><td class="memSeparator" colspan="2">&#160;</td></tr>
  106. <tr class="memitem:a3b492598b2b05e8425d2a500443613bd"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a3b492598b2b05e8425d2a500443613bd">firstClusterHigh</a></td></tr>
  107. <tr class="separator:a3b492598b2b05e8425d2a500443613bd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  108. <tr class="memitem:a74bd660417a9c3501eae353326c14bb9"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a74bd660417a9c3501eae353326c14bb9">firstClusterLow</a></td></tr>
  109. <tr class="separator:a74bd660417a9c3501eae353326c14bb9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  110. <tr class="memitem:abca70dc5c5fcbe199fd78df010111331"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#abca70dc5c5fcbe199fd78df010111331">lastAccessDate</a></td></tr>
  111. <tr class="separator:abca70dc5c5fcbe199fd78df010111331"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <tr class="memitem:a12b2e7cf87482a942a0b5d3df6c51468"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a12b2e7cf87482a942a0b5d3df6c51468">lastWriteDate</a></td></tr>
  113. <tr class="separator:a12b2e7cf87482a942a0b5d3df6c51468"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <tr class="memitem:a7bab435322d1928f66fbce53ee1f402d"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a7bab435322d1928f66fbce53ee1f402d">lastWriteTime</a></td></tr>
  115. <tr class="separator:a7bab435322d1928f66fbce53ee1f402d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:a05dc993ea55a1a742de5970541a31ecb"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#a05dc993ea55a1a742de5970541a31ecb">name</a> [11]</td></tr>
  117. <tr class="separator:a05dc993ea55a1a742de5970541a31ecb"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:afe7d00be85f3b78549b21610050da52b"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structdirectory_entry.html#afe7d00be85f3b78549b21610050da52b">reservedNT</a></td></tr>
  119. <tr class="separator:afe7d00be85f3b78549b21610050da52b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. </table>
  121. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  122. <div class="textblock"><p>FAT short directory entry. </p>
  123. <p>Short means short 8.3 name, not the entry size.</p>
  124. <p>Date Format. A FAT directory entry date stamp is a 16-bit field that is basically a date relative to the MS-DOS epoch of 01/01/1980. Here is the format (bit 0 is the LSB of the 16-bit word, bit 15 is the MSB of the 16-bit word):</p>
  125. <p>Bits 9-15: Count of years from 1980, valid value range 0-127 inclusive (1980-2107).</p>
  126. <p>Bits 5-8: Month of year, 1 = January, valid value range 1-12 inclusive.</p>
  127. <p>Bits 0-4: Day of month, valid value range 1-31 inclusive.</p>
  128. <p>Time Format. A FAT directory entry time stamp is a 16-bit field that has a granularity of 2 seconds. Here is the format (bit 0 is the LSB of the 16-bit word, bit 15 is the MSB of the 16-bit word).</p>
  129. <p>Bits 11-15: Hours, valid value range 0-23 inclusive.</p>
  130. <p>Bits 5-10: Minutes, valid value range 0-59 inclusive.</p>
  131. <p>Bits 0-4: 2-second count, valid value range 0-29 inclusive (0 - 58 seconds).</p>
  132. <p>The valid time range is from Midnight 00:00:00 to 23:59:58. </p>
  133. </div><h2 class="groupheader">Member Data Documentation</h2>
  134. <a class="anchor" id="a16c6cde55c8175c90935c386f1cfb21a"></a>
  135. <div class="memitem">
  136. <div class="memproto">
  137. <table class="memname">
  138. <tr>
  139. <td class="memname">uint8_t directoryEntry::attributes</td>
  140. </tr>
  141. </table>
  142. </div><div class="memdoc">
  143. <p>Entry attributes.</p>
  144. <p>The upper two bits of the attribute byte are reserved and should always be set to 0 when a file is created and never modified or looked at after that. See defines that begin with DIR_ATT_. </p>
  145. </div>
  146. </div>
  147. <a class="anchor" id="a7b43372794655fe6604d3c17c02302fe"></a>
  148. <div class="memitem">
  149. <div class="memproto">
  150. <table class="memname">
  151. <tr>
  152. <td class="memname">uint16_t directoryEntry::creationDate</td>
  153. </tr>
  154. </table>
  155. </div><div class="memdoc">
  156. <p>Date file was created. </p>
  157. </div>
  158. </div>
  159. <a class="anchor" id="a622bfa70c2cd9006108d7473d737a953"></a>
  160. <div class="memitem">
  161. <div class="memproto">
  162. <table class="memname">
  163. <tr>
  164. <td class="memname">uint16_t directoryEntry::creationTime</td>
  165. </tr>
  166. </table>
  167. </div><div class="memdoc">
  168. <p>Time file was created. </p>
  169. </div>
  170. </div>
  171. <a class="anchor" id="aa5e1ce5b411b88f005b28a3e7c7c5af6"></a>
  172. <div class="memitem">
  173. <div class="memproto">
  174. <table class="memname">
  175. <tr>
  176. <td class="memname">uint8_t directoryEntry::creationTimeTenths</td>
  177. </tr>
  178. </table>
  179. </div><div class="memdoc">
  180. <p>The granularity of the seconds part of creationTime is 2 seconds so this field is a count of tenths of a second and its valid value range is 0-199 inclusive. (WHG note - seems to be hundredths) </p>
  181. </div>
  182. </div>
  183. <a class="anchor" id="ac2445d99b50f925f662952e0ccd26a02"></a>
  184. <div class="memitem">
  185. <div class="memproto">
  186. <table class="memname">
  187. <tr>
  188. <td class="memname">uint32_t directoryEntry::fileSize</td>
  189. </tr>
  190. </table>
  191. </div><div class="memdoc">
  192. <p>32-bit unsigned holding this file's size in bytes. </p>
  193. </div>
  194. </div>
  195. <a class="anchor" id="a3b492598b2b05e8425d2a500443613bd"></a>
  196. <div class="memitem">
  197. <div class="memproto">
  198. <table class="memname">
  199. <tr>
  200. <td class="memname">uint16_t directoryEntry::firstClusterHigh</td>
  201. </tr>
  202. </table>
  203. </div><div class="memdoc">
  204. <p>High word of this entry's first cluster number (always 0 for a FAT12 or FAT16 volume). </p>
  205. </div>
  206. </div>
  207. <a class="anchor" id="a74bd660417a9c3501eae353326c14bb9"></a>
  208. <div class="memitem">
  209. <div class="memproto">
  210. <table class="memname">
  211. <tr>
  212. <td class="memname">uint16_t directoryEntry::firstClusterLow</td>
  213. </tr>
  214. </table>
  215. </div><div class="memdoc">
  216. <p>Low word of this entry's first cluster number. </p>
  217. </div>
  218. </div>
  219. <a class="anchor" id="abca70dc5c5fcbe199fd78df010111331"></a>
  220. <div class="memitem">
  221. <div class="memproto">
  222. <table class="memname">
  223. <tr>
  224. <td class="memname">uint16_t directoryEntry::lastAccessDate</td>
  225. </tr>
  226. </table>
  227. </div><div class="memdoc">
  228. <p>Last access date. Note that there is no last access time, only a date. This is the date of last read or write. In the case of a write, this should be set to the same date as lastWriteDate. </p>
  229. </div>
  230. </div>
  231. <a class="anchor" id="a12b2e7cf87482a942a0b5d3df6c51468"></a>
  232. <div class="memitem">
  233. <div class="memproto">
  234. <table class="memname">
  235. <tr>
  236. <td class="memname">uint16_t directoryEntry::lastWriteDate</td>
  237. </tr>
  238. </table>
  239. </div><div class="memdoc">
  240. <p>Date of last write. <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> creation is considered a write. </p>
  241. </div>
  242. </div>
  243. <a class="anchor" id="a7bab435322d1928f66fbce53ee1f402d"></a>
  244. <div class="memitem">
  245. <div class="memproto">
  246. <table class="memname">
  247. <tr>
  248. <td class="memname">uint16_t directoryEntry::lastWriteTime</td>
  249. </tr>
  250. </table>
  251. </div><div class="memdoc">
  252. <p>Time of last write. <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> creation is considered a write. </p>
  253. </div>
  254. </div>
  255. <a class="anchor" id="a05dc993ea55a1a742de5970541a31ecb"></a>
  256. <div class="memitem">
  257. <div class="memproto">
  258. <table class="memname">
  259. <tr>
  260. <td class="memname">uint8_t directoryEntry::name[11]</td>
  261. </tr>
  262. </table>
  263. </div><div class="memdoc">
  264. <p>Short 8.3 name.</p>
  265. <p>The first eight bytes contain the file name with blank fill. The last three bytes contain the file extension with blank fill. </p>
  266. </div>
  267. </div>
  268. <a class="anchor" id="afe7d00be85f3b78549b21610050da52b"></a>
  269. <div class="memitem">
  270. <div class="memproto">
  271. <table class="memname">
  272. <tr>
  273. <td class="memname">uint8_t directoryEntry::reservedNT</td>
  274. </tr>
  275. </table>
  276. </div><div class="memdoc">
  277. <p>Reserved for use by Windows NT. Set value to 0 when a file is created and never modify or look at it after that. </p>
  278. </div>
  279. </div>
  280. <hr/>The documentation for this struct was generated from the following file:<ul>
  281. <li>Arduino/libraries/SdFat/src/FatLib/<a class="el" href="_fat_structs_8h.html">FatStructs.h</a></li>
  282. </ul>
  283. </div><!-- contents -->
  284. <!-- start footer part -->
  285. <hr class="footer"/><address class="footer"><small>
  286. Generated on Fri Feb 12 2016 13:43:49 for SdFat by &#160;<a href="http://www.doxygen.org/index.html">
  287. <img class="footer" src="doxygen.png" alt="doxygen"/>
  288. </a> 1.8.10
  289. </small></address>
  290. </body>
  291. </html>