Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.

10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
10 роки тому
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739
  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.8"/>
  7. <title>SdFat: Sd2Card Class 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="doxygen.css" rel="stylesheet" type="text/css" />
  12. </head>
  13. <body>
  14. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  15. <div id="titlearea">
  16. <table cellspacing="0" cellpadding="0">
  17. <tbody>
  18. <tr style="height: 56px;">
  19. <td style="padding-left: 0.5em;">
  20. <div id="projectname">SdFat
  21. </div>
  22. </td>
  23. </tr>
  24. </tbody>
  25. </table>
  26. </div>
  27. <!-- end header part -->
  28. <!-- Generated by Doxygen 1.8.8 -->
  29. <div id="navrow1" class="tabs">
  30. <ul class="tablist">
  31. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  32. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  33. <li><a href="files.html"><span>Files</span></a></li>
  34. </ul>
  35. </div>
  36. <div id="navrow2" class="tabs2">
  37. <ul class="tablist">
  38. <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  39. <li><a href="inherits.html"><span>Class&#160;Hierarchy</span></a></li>
  40. <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  41. </ul>
  42. </div>
  43. </div><!-- top -->
  44. <div class="header">
  45. <div class="summary">
  46. <a href="#pub-methods">Public Member Functions</a> &#124;
  47. <a href="class_sd2_card-members.html">List of all members</a> </div>
  48. <div class="headertitle">
  49. <div class="title">Sd2Card Class Reference</div> </div>
  50. </div><!--header-->
  51. <div class="contents">
  52. <p>Raw access to SD and SDHC flash memory cards.
  53. <a href="class_sd2_card.html#details">More...</a></p>
  54. <p><code>#include &lt;Sd2Card.h&gt;</code></p>
  55. <table class="memberdecls">
  56. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  57. Public Member Functions</h2></td></tr>
  58. <tr class="memitem:a4e55e83403be452b10b0564ca63896f1"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a4e55e83403be452b10b0564ca63896f1">begin</a> (uint8_t chipSelectPin=<a class="el" href="_sd_spi_8h.html#ae6b17538c14ba6c91ccb513db2c4c29c">SD_CHIP_SELECT_PIN</a>, uint8_t <a class="el" href="class_sd2_card.html#a6bcfd1bf665bf4ff88a46c07741fac43">sckDivisor</a>=SPI_FULL_SPEED)</td></tr>
  59. <tr class="separator:a4e55e83403be452b10b0564ca63896f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  60. <tr class="memitem:a21ef1c5321041d4d73107b84e2db5189"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a21ef1c5321041d4d73107b84e2db5189">cardSize</a> ()</td></tr>
  61. <tr class="separator:a21ef1c5321041d4d73107b84e2db5189"><td class="memSeparator" colspan="2">&#160;</td></tr>
  62. <tr class="memitem:a2d73473118c5692e0f7d13db7da3570f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a2d73473118c5692e0f7d13db7da3570f">erase</a> (uint32_t firstBlock, uint32_t lastBlock)</td></tr>
  63. <tr class="separator:a2d73473118c5692e0f7d13db7da3570f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  64. <tr class="memitem:aceacbe30077e41ab84a34e629a03bb33"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#aceacbe30077e41ab84a34e629a03bb33">eraseSingleBlockEnable</a> ()</td></tr>
  65. <tr class="separator:aceacbe30077e41ab84a34e629a03bb33"><td class="memSeparator" colspan="2">&#160;</td></tr>
  66. <tr class="memitem:af03e574590524f93a61641604e02f79f"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#af03e574590524f93a61641604e02f79f">error</a> (uint8_t code)</td></tr>
  67. <tr class="separator:af03e574590524f93a61641604e02f79f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  68. <tr class="memitem:a3549d1878c0134171e399fd2d60b96f7"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a3549d1878c0134171e399fd2d60b96f7">errorCode</a> () const </td></tr>
  69. <tr class="separator:a3549d1878c0134171e399fd2d60b96f7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  70. <tr class="memitem:a1736acdbf194c6a2fd923c0a5049c016"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a1736acdbf194c6a2fd923c0a5049c016">errorData</a> () const </td></tr>
  71. <tr class="separator:a1736acdbf194c6a2fd923c0a5049c016"><td class="memSeparator" colspan="2">&#160;</td></tr>
  72. <tr class="memitem:a71523097165fce957c7f65b033471fc7"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a71523097165fce957c7f65b033471fc7">init</a> (uint8_t <a class="el" href="class_sd2_card.html#a6bcfd1bf665bf4ff88a46c07741fac43">sckDivisor</a>=SPI_FULL_SPEED, uint8_t chipSelectPin=<a class="el" href="_sd_spi_8h.html#ae6b17538c14ba6c91ccb513db2c4c29c">SD_CHIP_SELECT_PIN</a>)</td></tr>
  73. <tr class="separator:a71523097165fce957c7f65b033471fc7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  74. <tr class="memitem:a28eafda720598dcb2923955776199e19"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a28eafda720598dcb2923955776199e19">isBusy</a> ()</td></tr>
  75. <tr class="separator:a28eafda720598dcb2923955776199e19"><td class="memSeparator" colspan="2">&#160;</td></tr>
  76. <tr class="memitem:a6b015ee1c94004b8b16639910e5a3466"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a6b015ee1c94004b8b16639910e5a3466">readBlock</a> (uint32_t block, uint8_t *dst)</td></tr>
  77. <tr class="separator:a6b015ee1c94004b8b16639910e5a3466"><td class="memSeparator" colspan="2">&#160;</td></tr>
  78. <tr class="memitem:abaf488d56f653efa8e3349bf803ce2b0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#abaf488d56f653efa8e3349bf803ce2b0">readCID</a> (cid_t *cid)</td></tr>
  79. <tr class="separator:abaf488d56f653efa8e3349bf803ce2b0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  80. <tr class="memitem:a1b0c68df7f508f876d56fc1270536c87"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a1b0c68df7f508f876d56fc1270536c87">readCSD</a> (csd_t *csd)</td></tr>
  81. <tr class="separator:a1b0c68df7f508f876d56fc1270536c87"><td class="memSeparator" colspan="2">&#160;</td></tr>
  82. <tr class="memitem:a7d6e8a504f8525afd6d36a22ee5b8cc0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a7d6e8a504f8525afd6d36a22ee5b8cc0">readData</a> (uint8_t *dst)</td></tr>
  83. <tr class="separator:a7d6e8a504f8525afd6d36a22ee5b8cc0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  84. <tr class="memitem:a9198517574578064a48f8f2b1874aae5"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a9198517574578064a48f8f2b1874aae5">readOCR</a> (uint32_t *ocr)</td></tr>
  85. <tr class="separator:a9198517574578064a48f8f2b1874aae5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  86. <tr class="memitem:a3259be9721e14a2edf8b549e4aeb2e40"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a3259be9721e14a2edf8b549e4aeb2e40">readStart</a> (uint32_t blockNumber)</td></tr>
  87. <tr class="separator:a3259be9721e14a2edf8b549e4aeb2e40"><td class="memSeparator" colspan="2">&#160;</td></tr>
  88. <tr class="memitem:ae133ad5a80c2652a964afd2320cc7c94"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#ae133ad5a80c2652a964afd2320cc7c94">readStop</a> ()</td></tr>
  89. <tr class="separator:ae133ad5a80c2652a964afd2320cc7c94"><td class="memSeparator" colspan="2">&#160;</td></tr>
  90. <tr class="memitem:a6bcfd1bf665bf4ff88a46c07741fac43"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a6bcfd1bf665bf4ff88a46c07741fac43">sckDivisor</a> ()</td></tr>
  91. <tr class="separator:a6bcfd1bf665bf4ff88a46c07741fac43"><td class="memSeparator" colspan="2">&#160;</td></tr>
  92. <tr class="memitem:a17c8713ae610106567679a8685696375"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a17c8713ae610106567679a8685696375">Sd2Card</a> ()</td></tr>
  93. <tr class="separator:a17c8713ae610106567679a8685696375"><td class="memSeparator" colspan="2">&#160;</td></tr>
  94. <tr class="memitem:adcee026d613619414e2b6d3eca2c6537"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#adcee026d613619414e2b6d3eca2c6537">type</a> () const </td></tr>
  95. <tr class="separator:adcee026d613619414e2b6d3eca2c6537"><td class="memSeparator" colspan="2">&#160;</td></tr>
  96. <tr class="memitem:ad5eecc3e1e68b9e5a43edfb8e4205469"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#ad5eecc3e1e68b9e5a43edfb8e4205469">writeBlock</a> (uint32_t blockNumber, const uint8_t *src)</td></tr>
  97. <tr class="separator:ad5eecc3e1e68b9e5a43edfb8e4205469"><td class="memSeparator" colspan="2">&#160;</td></tr>
  98. <tr class="memitem:afb96025babf92878213dd691263d93ef"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#afb96025babf92878213dd691263d93ef">writeData</a> (const uint8_t *src)</td></tr>
  99. <tr class="separator:afb96025babf92878213dd691263d93ef"><td class="memSeparator" colspan="2">&#160;</td></tr>
  100. <tr class="memitem:a1039df4f6620213a98b317d11da2014e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a1039df4f6620213a98b317d11da2014e">writeStart</a> (uint32_t blockNumber, uint32_t eraseCount)</td></tr>
  101. <tr class="separator:a1039df4f6620213a98b317d11da2014e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  102. <tr class="memitem:a7e1ec48b0a83d13415841da870290f64"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_sd2_card.html#a7e1ec48b0a83d13415841da870290f64">writeStop</a> ()</td></tr>
  103. <tr class="separator:a7e1ec48b0a83d13415841da870290f64"><td class="memSeparator" colspan="2">&#160;</td></tr>
  104. </table>
  105. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  106. <div class="textblock"><p>Raw access to SD and SDHC flash memory cards. </p>
  107. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  108. <a class="anchor" id="a17c8713ae610106567679a8685696375"></a>
  109. <div class="memitem">
  110. <div class="memproto">
  111. <table class="mlabels">
  112. <tr>
  113. <td class="mlabels-left">
  114. <table class="memname">
  115. <tr>
  116. <td class="memname">Sd2Card::Sd2Card </td>
  117. <td>(</td>
  118. <td class="paramname"></td><td>)</td>
  119. <td></td>
  120. </tr>
  121. </table>
  122. </td>
  123. <td class="mlabels-right">
  124. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  125. </tr>
  126. </table>
  127. </div><div class="memdoc">
  128. <p>Construct an instance of <a class="el" href="class_sd2_card.html" title="Raw access to SD and SDHC flash memory cards. ">Sd2Card</a>. </p>
  129. </div>
  130. </div>
  131. <h2 class="groupheader">Member Function Documentation</h2>
  132. <a class="anchor" id="a4e55e83403be452b10b0564ca63896f1"></a>
  133. <div class="memitem">
  134. <div class="memproto">
  135. <table class="memname">
  136. <tr>
  137. <td class="memname">bool Sd2Card::begin </td>
  138. <td>(</td>
  139. <td class="paramtype">uint8_t&#160;</td>
  140. <td class="paramname"><em>chipSelectPin</em> = <code><a class="el" href="_sd_spi_8h.html#ae6b17538c14ba6c91ccb513db2c4c29c">SD_CHIP_SELECT_PIN</a></code>, </td>
  141. </tr>
  142. <tr>
  143. <td class="paramkey"></td>
  144. <td></td>
  145. <td class="paramtype">uint8_t&#160;</td>
  146. <td class="paramname"><em>sckDivisor</em> = <code>SPI_FULL_SPEED</code>&#160;</td>
  147. </tr>
  148. <tr>
  149. <td></td>
  150. <td>)</td>
  151. <td></td><td></td>
  152. </tr>
  153. </table>
  154. </div><div class="memdoc">
  155. <p>Initialize an SD flash memory card.</p>
  156. <dl class="params"><dt>Parameters</dt><dd>
  157. <table class="params">
  158. <tr><td class="paramdir">[in]</td><td class="paramname">chipSelectPin</td><td>SD chip select pin number. </td></tr>
  159. <tr><td class="paramdir">[in]</td><td class="paramname">sckDivisor</td><td>SPI SCK clock rate divisor.</td></tr>
  160. </table>
  161. </dd>
  162. </dl>
  163. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. The reason for failure can be determined by calling <a class="el" href="class_sd2_card.html#a3549d1878c0134171e399fd2d60b96f7">errorCode()</a> and <a class="el" href="class_sd2_card.html#a1736acdbf194c6a2fd923c0a5049c016">errorData()</a>. </dd></dl>
  164. </div>
  165. </div>
  166. <a class="anchor" id="a21ef1c5321041d4d73107b84e2db5189"></a>
  167. <div class="memitem">
  168. <div class="memproto">
  169. <table class="memname">
  170. <tr>
  171. <td class="memname">uint32_t Sd2Card::cardSize </td>
  172. <td>(</td>
  173. <td class="paramname"></td><td>)</td>
  174. <td></td>
  175. </tr>
  176. </table>
  177. </div><div class="memdoc">
  178. <p>Determine the size of an SD flash memory card.</p>
  179. <dl class="section return"><dt>Returns</dt><dd>The number of 512 byte data blocks in the card or zero if an error occurs. </dd></dl>
  180. </div>
  181. </div>
  182. <a class="anchor" id="a2d73473118c5692e0f7d13db7da3570f"></a>
  183. <div class="memitem">
  184. <div class="memproto">
  185. <table class="memname">
  186. <tr>
  187. <td class="memname">bool Sd2Card::erase </td>
  188. <td>(</td>
  189. <td class="paramtype">uint32_t&#160;</td>
  190. <td class="paramname"><em>firstBlock</em>, </td>
  191. </tr>
  192. <tr>
  193. <td class="paramkey"></td>
  194. <td></td>
  195. <td class="paramtype">uint32_t&#160;</td>
  196. <td class="paramname"><em>lastBlock</em>&#160;</td>
  197. </tr>
  198. <tr>
  199. <td></td>
  200. <td>)</td>
  201. <td></td><td></td>
  202. </tr>
  203. </table>
  204. </div><div class="memdoc">
  205. <p>Erase a range of blocks.</p>
  206. <dl class="params"><dt>Parameters</dt><dd>
  207. <table class="params">
  208. <tr><td class="paramdir">[in]</td><td class="paramname">firstBlock</td><td>The address of the first block in the range. </td></tr>
  209. <tr><td class="paramdir">[in]</td><td class="paramname">lastBlock</td><td>The address of the last block in the range.</td></tr>
  210. </table>
  211. </dd>
  212. </dl>
  213. <dl class="section note"><dt>Note</dt><dd>This function requests the SD card to do a flash erase for a range of blocks. The data on the card after an erase operation is either 0 or 1, depends on the card vendor. The card must support single block erase.</dd></dl>
  214. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  215. </div>
  216. </div>
  217. <a class="anchor" id="aceacbe30077e41ab84a34e629a03bb33"></a>
  218. <div class="memitem">
  219. <div class="memproto">
  220. <table class="memname">
  221. <tr>
  222. <td class="memname">bool Sd2Card::eraseSingleBlockEnable </td>
  223. <td>(</td>
  224. <td class="paramname"></td><td>)</td>
  225. <td></td>
  226. </tr>
  227. </table>
  228. </div><div class="memdoc">
  229. <p>Determine if card supports single block erase.</p>
  230. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned if single block erase is supported. The value zero, false, is returned if single block erase is not supported. </dd></dl>
  231. </div>
  232. </div>
  233. <a class="anchor" id="af03e574590524f93a61641604e02f79f"></a>
  234. <div class="memitem">
  235. <div class="memproto">
  236. <table class="mlabels">
  237. <tr>
  238. <td class="mlabels-left">
  239. <table class="memname">
  240. <tr>
  241. <td class="memname">void Sd2Card::error </td>
  242. <td>(</td>
  243. <td class="paramtype">uint8_t&#160;</td>
  244. <td class="paramname"><em>code</em></td><td>)</td>
  245. <td></td>
  246. </tr>
  247. </table>
  248. </td>
  249. <td class="mlabels-right">
  250. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  251. </tr>
  252. </table>
  253. </div><div class="memdoc">
  254. <p>Set SD error code. </p><dl class="params"><dt>Parameters</dt><dd>
  255. <table class="params">
  256. <tr><td class="paramdir">[in]</td><td class="paramname">code</td><td>value for error code. </td></tr>
  257. </table>
  258. </dd>
  259. </dl>
  260. </div>
  261. </div>
  262. <a class="anchor" id="a3549d1878c0134171e399fd2d60b96f7"></a>
  263. <div class="memitem">
  264. <div class="memproto">
  265. <table class="mlabels">
  266. <tr>
  267. <td class="mlabels-left">
  268. <table class="memname">
  269. <tr>
  270. <td class="memname">int Sd2Card::errorCode </td>
  271. <td>(</td>
  272. <td class="paramname"></td><td>)</td>
  273. <td> const</td>
  274. </tr>
  275. </table>
  276. </td>
  277. <td class="mlabels-right">
  278. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  279. </tr>
  280. </table>
  281. </div><div class="memdoc">
  282. <dl class="section return"><dt>Returns</dt><dd>error code for last error. See <a class="el" href="_sd2_card_8h.html" title="Sd2Card class for V2 SD/SDHC cards. ">Sd2Card.h</a> for a list of error codes. </dd></dl>
  283. </div>
  284. </div>
  285. <a class="anchor" id="a1736acdbf194c6a2fd923c0a5049c016"></a>
  286. <div class="memitem">
  287. <div class="memproto">
  288. <table class="mlabels">
  289. <tr>
  290. <td class="mlabels-left">
  291. <table class="memname">
  292. <tr>
  293. <td class="memname">int Sd2Card::errorData </td>
  294. <td>(</td>
  295. <td class="paramname"></td><td>)</td>
  296. <td> const</td>
  297. </tr>
  298. </table>
  299. </td>
  300. <td class="mlabels-right">
  301. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  302. </tr>
  303. </table>
  304. </div><div class="memdoc">
  305. <dl class="section return"><dt>Returns</dt><dd>error data for last error. </dd></dl>
  306. </div>
  307. </div>
  308. <a class="anchor" id="a71523097165fce957c7f65b033471fc7"></a>
  309. <div class="memitem">
  310. <div class="memproto">
  311. <table class="mlabels">
  312. <tr>
  313. <td class="mlabels-left">
  314. <table class="memname">
  315. <tr>
  316. <td class="memname">bool Sd2Card::init </td>
  317. <td>(</td>
  318. <td class="paramtype">uint8_t&#160;</td>
  319. <td class="paramname"><em>sckDivisor</em> = <code>SPI_FULL_SPEED</code>, </td>
  320. </tr>
  321. <tr>
  322. <td class="paramkey"></td>
  323. <td></td>
  324. <td class="paramtype">uint8_t&#160;</td>
  325. <td class="paramname"><em>chipSelectPin</em> = <code><a class="el" href="_sd_spi_8h.html#ae6b17538c14ba6c91ccb513db2c4c29c">SD_CHIP_SELECT_PIN</a></code>&#160;</td>
  326. </tr>
  327. <tr>
  328. <td></td>
  329. <td>)</td>
  330. <td></td><td></td>
  331. </tr>
  332. </table>
  333. </td>
  334. <td class="mlabels-right">
  335. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  336. </tr>
  337. </table>
  338. </div><div class="memdoc">
  339. <p>Initialize an SD flash memory card.</p>
  340. <dl class="params"><dt>Parameters</dt><dd>
  341. <table class="params">
  342. <tr><td class="paramdir">[in]</td><td class="paramname">chipSelectPin</td><td>SD chip select pin number. </td></tr>
  343. <tr><td class="paramdir">[in]</td><td class="paramname">sckDivisor</td><td>SPI SCK clock rate divisor.</td></tr>
  344. </table>
  345. </dd>
  346. </dl>
  347. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. The reason for failure can be determined by calling <a class="el" href="class_sd2_card.html#a3549d1878c0134171e399fd2d60b96f7">errorCode()</a> and <a class="el" href="class_sd2_card.html#a1736acdbf194c6a2fd923c0a5049c016">errorData()</a>. </dd></dl>
  348. </div>
  349. </div>
  350. <a class="anchor" id="a28eafda720598dcb2923955776199e19"></a>
  351. <div class="memitem">
  352. <div class="memproto">
  353. <table class="memname">
  354. <tr>
  355. <td class="memname">bool Sd2Card::isBusy </td>
  356. <td>(</td>
  357. <td class="paramname"></td><td>)</td>
  358. <td></td>
  359. </tr>
  360. </table>
  361. </div><div class="memdoc">
  362. <p>Check for busy. MISO low indicates the card is busy.</p>
  363. <dl class="section return"><dt>Returns</dt><dd>true if busy else false. </dd></dl>
  364. </div>
  365. </div>
  366. <a class="anchor" id="a6b015ee1c94004b8b16639910e5a3466"></a>
  367. <div class="memitem">
  368. <div class="memproto">
  369. <table class="memname">
  370. <tr>
  371. <td class="memname">bool Sd2Card::readBlock </td>
  372. <td>(</td>
  373. <td class="paramtype">uint32_t&#160;</td>
  374. <td class="paramname"><em>blockNumber</em>, </td>
  375. </tr>
  376. <tr>
  377. <td class="paramkey"></td>
  378. <td></td>
  379. <td class="paramtype">uint8_t *&#160;</td>
  380. <td class="paramname"><em>dst</em>&#160;</td>
  381. </tr>
  382. <tr>
  383. <td></td>
  384. <td>)</td>
  385. <td></td><td></td>
  386. </tr>
  387. </table>
  388. </div><div class="memdoc">
  389. <p>Read a 512 byte block from an SD card.</p>
  390. <dl class="params"><dt>Parameters</dt><dd>
  391. <table class="params">
  392. <tr><td class="paramdir">[in]</td><td class="paramname">blockNumber</td><td>Logical block to be read. </td></tr>
  393. <tr><td class="paramdir">[out]</td><td class="paramname">dst</td><td>Pointer to the location that will receive the data.</td></tr>
  394. </table>
  395. </dd>
  396. </dl>
  397. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  398. </div>
  399. </div>
  400. <a class="anchor" id="abaf488d56f653efa8e3349bf803ce2b0"></a>
  401. <div class="memitem">
  402. <div class="memproto">
  403. <table class="mlabels">
  404. <tr>
  405. <td class="mlabels-left">
  406. <table class="memname">
  407. <tr>
  408. <td class="memname">bool Sd2Card::readCID </td>
  409. <td>(</td>
  410. <td class="paramtype">cid_t *&#160;</td>
  411. <td class="paramname"><em>cid</em></td><td>)</td>
  412. <td></td>
  413. </tr>
  414. </table>
  415. </td>
  416. <td class="mlabels-right">
  417. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  418. </tr>
  419. </table>
  420. </div><div class="memdoc">
  421. <p>Read a card's CID register. The CID contains card identification information such as Manufacturer ID, Product name, Product serial number and Manufacturing date.</p>
  422. <dl class="params"><dt>Parameters</dt><dd>
  423. <table class="params">
  424. <tr><td class="paramdir">[out]</td><td class="paramname">cid</td><td>pointer to area for returned data.</td></tr>
  425. </table>
  426. </dd>
  427. </dl>
  428. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  429. </div>
  430. </div>
  431. <a class="anchor" id="a1b0c68df7f508f876d56fc1270536c87"></a>
  432. <div class="memitem">
  433. <div class="memproto">
  434. <table class="mlabels">
  435. <tr>
  436. <td class="mlabels-left">
  437. <table class="memname">
  438. <tr>
  439. <td class="memname">bool Sd2Card::readCSD </td>
  440. <td>(</td>
  441. <td class="paramtype">csd_t *&#160;</td>
  442. <td class="paramname"><em>csd</em></td><td>)</td>
  443. <td></td>
  444. </tr>
  445. </table>
  446. </td>
  447. <td class="mlabels-right">
  448. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  449. </tr>
  450. </table>
  451. </div><div class="memdoc">
  452. <p>Read a card's CSD register. The CSD contains Card-Specific Data that provides information regarding access to the card's contents.</p>
  453. <dl class="params"><dt>Parameters</dt><dd>
  454. <table class="params">
  455. <tr><td class="paramdir">[out]</td><td class="paramname">csd</td><td>pointer to area for returned data.</td></tr>
  456. </table>
  457. </dd>
  458. </dl>
  459. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  460. </div>
  461. </div>
  462. <a class="anchor" id="a7d6e8a504f8525afd6d36a22ee5b8cc0"></a>
  463. <div class="memitem">
  464. <div class="memproto">
  465. <table class="memname">
  466. <tr>
  467. <td class="memname">bool Sd2Card::readData </td>
  468. <td>(</td>
  469. <td class="paramtype">uint8_t *&#160;</td>
  470. <td class="paramname"><em>dst</em></td><td>)</td>
  471. <td></td>
  472. </tr>
  473. </table>
  474. </div><div class="memdoc">
  475. <p>Read one data block in a multiple block read sequence</p>
  476. <dl class="params"><dt>Parameters</dt><dd>
  477. <table class="params">
  478. <tr><td class="paramdir">[in]</td><td class="paramname">dst</td><td>Pointer to the location for the data to be read.</td></tr>
  479. </table>
  480. </dd>
  481. </dl>
  482. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  483. </div>
  484. </div>
  485. <a class="anchor" id="a9198517574578064a48f8f2b1874aae5"></a>
  486. <div class="memitem">
  487. <div class="memproto">
  488. <table class="memname">
  489. <tr>
  490. <td class="memname">bool Sd2Card::readOCR </td>
  491. <td>(</td>
  492. <td class="paramtype">uint32_t *&#160;</td>
  493. <td class="paramname"><em>ocr</em></td><td>)</td>
  494. <td></td>
  495. </tr>
  496. </table>
  497. </div><div class="memdoc">
  498. <p>Read OCR register.</p>
  499. <dl class="params"><dt>Parameters</dt><dd>
  500. <table class="params">
  501. <tr><td class="paramdir">[out]</td><td class="paramname">ocr</td><td>Value of OCR register. </td></tr>
  502. </table>
  503. </dd>
  504. </dl>
  505. <dl class="section return"><dt>Returns</dt><dd>true for success else false. </dd></dl>
  506. </div>
  507. </div>
  508. <a class="anchor" id="a3259be9721e14a2edf8b549e4aeb2e40"></a>
  509. <div class="memitem">
  510. <div class="memproto">
  511. <table class="memname">
  512. <tr>
  513. <td class="memname">bool Sd2Card::readStart </td>
  514. <td>(</td>
  515. <td class="paramtype">uint32_t&#160;</td>
  516. <td class="paramname"><em>blockNumber</em></td><td>)</td>
  517. <td></td>
  518. </tr>
  519. </table>
  520. </div><div class="memdoc">
  521. <p>Start a read multiple blocks sequence.</p>
  522. <dl class="params"><dt>Parameters</dt><dd>
  523. <table class="params">
  524. <tr><td class="paramdir">[in]</td><td class="paramname">blockNumber</td><td>Address of first block in sequence.</td></tr>
  525. </table>
  526. </dd>
  527. </dl>
  528. <dl class="section note"><dt>Note</dt><dd>This function is used with <a class="el" href="class_sd2_card.html#a7d6e8a504f8525afd6d36a22ee5b8cc0">readData()</a> and <a class="el" href="class_sd2_card.html#ae133ad5a80c2652a964afd2320cc7c94">readStop()</a> for optimized multiple block reads. SPI chipSelect must be low for the entire sequence.</dd></dl>
  529. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  530. </div>
  531. </div>
  532. <a class="anchor" id="ae133ad5a80c2652a964afd2320cc7c94"></a>
  533. <div class="memitem">
  534. <div class="memproto">
  535. <table class="memname">
  536. <tr>
  537. <td class="memname">bool Sd2Card::readStop </td>
  538. <td>(</td>
  539. <td class="paramname"></td><td>)</td>
  540. <td></td>
  541. </tr>
  542. </table>
  543. </div><div class="memdoc">
  544. <p>End a read multiple blocks sequence.</p>
  545. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  546. </div>
  547. </div>
  548. <a class="anchor" id="a6bcfd1bf665bf4ff88a46c07741fac43"></a>
  549. <div class="memitem">
  550. <div class="memproto">
  551. <table class="mlabels">
  552. <tr>
  553. <td class="mlabels-left">
  554. <table class="memname">
  555. <tr>
  556. <td class="memname">uint8_t Sd2Card::sckDivisor </td>
  557. <td>(</td>
  558. <td class="paramname"></td><td>)</td>
  559. <td></td>
  560. </tr>
  561. </table>
  562. </td>
  563. <td class="mlabels-right">
  564. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  565. </tr>
  566. </table>
  567. </div><div class="memdoc">
  568. <p>Return SCK divisor.</p>
  569. <dl class="section return"><dt>Returns</dt><dd>Requested SCK divisor. </dd></dl>
  570. </div>
  571. </div>
  572. <a class="anchor" id="adcee026d613619414e2b6d3eca2c6537"></a>
  573. <div class="memitem">
  574. <div class="memproto">
  575. <table class="mlabels">
  576. <tr>
  577. <td class="mlabels-left">
  578. <table class="memname">
  579. <tr>
  580. <td class="memname">int Sd2Card::type </td>
  581. <td>(</td>
  582. <td class="paramname"></td><td>)</td>
  583. <td> const</td>
  584. </tr>
  585. </table>
  586. </td>
  587. <td class="mlabels-right">
  588. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  589. </tr>
  590. </table>
  591. </div><div class="memdoc">
  592. <p>Return the card type: SD V1, SD V2 or SDHC </p><dl class="section return"><dt>Returns</dt><dd>0 - SD V1, 1 - SD V2, or 3 - SDHC. </dd></dl>
  593. </div>
  594. </div>
  595. <a class="anchor" id="ad5eecc3e1e68b9e5a43edfb8e4205469"></a>
  596. <div class="memitem">
  597. <div class="memproto">
  598. <table class="memname">
  599. <tr>
  600. <td class="memname">bool Sd2Card::writeBlock </td>
  601. <td>(</td>
  602. <td class="paramtype">uint32_t&#160;</td>
  603. <td class="paramname"><em>blockNumber</em>, </td>
  604. </tr>
  605. <tr>
  606. <td class="paramkey"></td>
  607. <td></td>
  608. <td class="paramtype">const uint8_t *&#160;</td>
  609. <td class="paramname"><em>src</em>&#160;</td>
  610. </tr>
  611. <tr>
  612. <td></td>
  613. <td>)</td>
  614. <td></td><td></td>
  615. </tr>
  616. </table>
  617. </div><div class="memdoc">
  618. <p>Writes a 512 byte block to an SD card.</p>
  619. <dl class="params"><dt>Parameters</dt><dd>
  620. <table class="params">
  621. <tr><td class="paramdir">[in]</td><td class="paramname">blockNumber</td><td>Logical block to be written. </td></tr>
  622. <tr><td class="paramdir">[in]</td><td class="paramname">src</td><td>Pointer to the location of the data to be written. </td></tr>
  623. </table>
  624. </dd>
  625. </dl>
  626. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  627. </div>
  628. </div>
  629. <a class="anchor" id="afb96025babf92878213dd691263d93ef"></a>
  630. <div class="memitem">
  631. <div class="memproto">
  632. <table class="memname">
  633. <tr>
  634. <td class="memname">bool Sd2Card::writeData </td>
  635. <td>(</td>
  636. <td class="paramtype">const uint8_t *&#160;</td>
  637. <td class="paramname"><em>src</em></td><td>)</td>
  638. <td></td>
  639. </tr>
  640. </table>
  641. </div><div class="memdoc">
  642. <p>Write one data block in a multiple block write sequence </p><dl class="params"><dt>Parameters</dt><dd>
  643. <table class="params">
  644. <tr><td class="paramdir">[in]</td><td class="paramname">src</td><td>Pointer to the location of the data to be written. </td></tr>
  645. </table>
  646. </dd>
  647. </dl>
  648. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  649. </div>
  650. </div>
  651. <a class="anchor" id="a1039df4f6620213a98b317d11da2014e"></a>
  652. <div class="memitem">
  653. <div class="memproto">
  654. <table class="memname">
  655. <tr>
  656. <td class="memname">bool Sd2Card::writeStart </td>
  657. <td>(</td>
  658. <td class="paramtype">uint32_t&#160;</td>
  659. <td class="paramname"><em>blockNumber</em>, </td>
  660. </tr>
  661. <tr>
  662. <td class="paramkey"></td>
  663. <td></td>
  664. <td class="paramtype">uint32_t&#160;</td>
  665. <td class="paramname"><em>eraseCount</em>&#160;</td>
  666. </tr>
  667. <tr>
  668. <td></td>
  669. <td>)</td>
  670. <td></td><td></td>
  671. </tr>
  672. </table>
  673. </div><div class="memdoc">
  674. <p>Start a write multiple blocks sequence.</p>
  675. <dl class="params"><dt>Parameters</dt><dd>
  676. <table class="params">
  677. <tr><td class="paramdir">[in]</td><td class="paramname">blockNumber</td><td>Address of first block in sequence. </td></tr>
  678. <tr><td class="paramdir">[in]</td><td class="paramname">eraseCount</td><td>The number of blocks to be pre-erased.</td></tr>
  679. </table>
  680. </dd>
  681. </dl>
  682. <dl class="section note"><dt>Note</dt><dd>This function is used with <a class="el" href="class_sd2_card.html#afb96025babf92878213dd691263d93ef">writeData()</a> and <a class="el" href="class_sd2_card.html#a7e1ec48b0a83d13415841da870290f64">writeStop()</a> for optimized multiple block writes.</dd></dl>
  683. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  684. </div>
  685. </div>
  686. <a class="anchor" id="a7e1ec48b0a83d13415841da870290f64"></a>
  687. <div class="memitem">
  688. <div class="memproto">
  689. <table class="memname">
  690. <tr>
  691. <td class="memname">bool Sd2Card::writeStop </td>
  692. <td>(</td>
  693. <td class="paramname"></td><td>)</td>
  694. <td></td>
  695. </tr>
  696. </table>
  697. </div><div class="memdoc">
  698. <p>End a write multiple blocks sequence.</p>
  699. <dl class="section return"><dt>Returns</dt><dd>The value one, true, is returned for success and the value zero, false, is returned for failure. </dd></dl>
  700. </div>
  701. </div>
  702. <hr/>The documentation for this class was generated from the following files:<ul>
  703. <li>Arduino/libraries/SdFat/<a class="el" href="_sd2_card_8h.html">Sd2Card.h</a></li>
  704. <li>Arduino/libraries/SdFat/Sd2Card.cpp</li>
  705. </ul>
  706. </div><!-- contents -->
  707. <!-- start footer part -->
  708. <hr class="footer"/><address class="footer"><small>
  709. Generated on Sat Oct 25 2014 07:56:22 for SdFat by &#160;<a href="http://www.doxygen.org/index.html">
  710. <img class="footer" src="doxygen.png" alt="doxygen"/>
  711. </a> 1.8.8
  712. </small></address>
  713. </body>
  714. </html>