stm32f1xx_hal_sd.c 104 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458
  1. /**
  2. ******************************************************************************
  3. * @file stm32f1xx_hal_sd.c
  4. * @author MCD Application Team
  5. * @version V1.0.4
  6. * @date 29-April-2016
  7. * @brief SD card HAL module driver.
  8. * This file provides firmware functions to manage the following
  9. * functionalities of the Secure Digital (SD) peripheral:
  10. * + Initialization and de-initialization functions
  11. * + IO operation functions
  12. * + Peripheral Control functions
  13. * + Peripheral State functions
  14. *
  15. @verbatim
  16. ==============================================================================
  17. ##### How to use this driver #####
  18. ==============================================================================
  19. [..]
  20. This driver implements a high level communication layer for read and write from/to
  21. this memory. The needed STM32 hardware resources (SDIO and GPIO) are performed by
  22. the user in HAL_SD_MspInit() function (MSP layer).
  23. Basically, the MSP layer configuration should be the same as we provide in the
  24. examples.
  25. You can easily tailor this configuration according to hardware resources.
  26. [..]
  27. This driver is a generic layered driver for SDIO memories which uses the HAL
  28. SDIO driver functions to interface with SD and uSD cards devices.
  29. It is used as follows:
  30. (#)Initialize the SDIO low level resources by implement the HAL_SD_MspInit() API:
  31. (##) Enable the SDIO interface clock using __HAL_RCC_SDIO_CLK_ENABLE();
  32. (##) SDIO pins configuration for SD card
  33. (+++) Enable the clock for the SDIO GPIOs using the functions __HAL_RCC_GPIOx_CLK_ENABLE();
  34. (+++) Configure these SDIO pins as alternate function pull-up using HAL_GPIO_Init()
  35. and according to your pin assignment;
  36. (##) DMA Configuration if you need to use DMA process (HAL_SD_ReadBlocks_DMA()
  37. and HAL_SD_WriteBlocks_DMA() APIs).
  38. (+++) Enable the DMAx interface clock using __HAL_RCC_DMAx_CLK_ENABLE();
  39. (+++) Configure the DMA using the function HAL_DMA_Init() with predeclared and filled.
  40. (##) NVIC configuration if you need to use interrupt process when using DMA transfer.
  41. (+++) Configure the SDIO and DMA interrupt priorities using functions
  42. HAL_NVIC_SetPriority(); DMA priority is superior to SDIO's priority
  43. (+++) Enable the NVIC DMA and SDIO IRQs using function HAL_NVIC_EnableIRQ()
  44. (+++) SDIO interrupts are managed using the macros __HAL_SD_SDIO_ENABLE_IT()
  45. and __HAL_SD_SDIO_DISABLE_IT() inside the communication process.
  46. (+++) SDIO interrupts pending bits are managed using the macros __HAL_SD_SDIO_GET_IT()
  47. and __HAL_SD_SDIO_CLEAR_IT()
  48. (#) At this stage, you can perform SD read/write/erase operations after SD card initialization
  49. *** SD Card Initialization and configuration ***
  50. ================================================
  51. [..]
  52. To initialize the SD Card, use the HAL_SD_Init() function. It Initializes
  53. the SD Card and put it into StandBy State (Ready for data transfer).
  54. This function provide the following operations:
  55. (#) Apply the SD Card initialization process at 400KHz and check the SD Card
  56. type (Standard Capacity or High Capacity). You can change or adapt this
  57. frequency by adjusting the "ClockDiv" field.
  58. The SD Card frequency (SDIO_CK) is computed as follows:
  59. SDIO_CK = SDIOCLK / (ClockDiv + 2)
  60. In initialization mode and according to the SD Card standard,
  61. make sure that the SDIO_CK frequency doesn't exceed 400KHz.
  62. (#) Get the SD CID and CSD data. All these information are managed by the SDCardInfo
  63. structure. This structure provide also ready computed SD Card capacity
  64. and Block size.
  65. -@- These information are stored in SD handle structure in case of future use.
  66. (#) Configure the SD Card Data transfer frequency. The card transfer
  67. frequency is set to SDIOCLK / (SDIO_TRANSFER_CLK_DIV + 2). You can change or adapt this frequency by adjusting
  68. the "ClockDiv" field.
  69. The SD Card frequency (SDIO_CK) is computed as follows:
  70. SDIO_CK = SDIOCLK / (ClockDiv + 2)
  71. In transfer mode and according to the SD Card standard, make sure that the
  72. SDIO_CK frequency doesn't exceed 25MHz and 50MHz in High-speed mode switch.
  73. (#) Select the corresponding SD Card according to the address read with the step 2.
  74. (#) Configure the SD Card in wide bus mode: 4-bits data.
  75. *** SD Card Read operation ***
  76. ==============================
  77. [..]
  78. (+) You can read from SD card in polling mode by using function HAL_SD_ReadBlocks().
  79. This function support only 512-bytes block length (the block size should be
  80. chosen as 512 bytes).
  81. You can choose either one block read operation or multiple block read operation
  82. by adjusting the "NumberOfBlocks" parameter.
  83. (+) You can read from SD card in DMA mode by using function HAL_SD_ReadBlocks_DMA().
  84. This function support only 512-bytes block length (the block size should be
  85. chosen as 512 bytes).
  86. You can choose either one block read operation or multiple block read operation
  87. by adjusting the "NumberOfBlocks" parameter.
  88. After this, you have to call the function HAL_SD_CheckReadOperation(), to insure
  89. that the read transfer is done correctly in both DMA and SD sides.
  90. *** SD Card Write operation ***
  91. ===============================
  92. [..]
  93. (+) You can write to SD card in polling mode by using function HAL_SD_WriteBlocks().
  94. This function support only 512-bytes block length (the block size should be
  95. chosen as 512 bytes).
  96. You can choose either one block read operation or multiple block read operation
  97. by adjusting the "NumberOfBlocks" parameter.
  98. (+) You can write to SD card in DMA mode by using function HAL_SD_WriteBlocks_DMA().
  99. This function support only 512-bytes block length (the block size should be
  100. chosen as 512 byte).
  101. You can choose either one block read operation or multiple block read operation
  102. by adjusting the "NumberOfBlocks" parameter.
  103. After this, you have to call the function HAL_SD_CheckWriteOperation(), to insure
  104. that the write transfer is done correctly in both DMA and SD sides.
  105. *** SD card status ***
  106. ======================
  107. [..]
  108. (+) At any time, you can check the SD Card status and get the SD card state
  109. by using the HAL_SD_GetStatus() function. This function checks first if the
  110. SD card is still connected and then get the internal SD Card transfer state.
  111. (+) You can also get the SD card SD Status register by using the HAL_SD_SendSDStatus()
  112. function.
  113. *** SD HAL driver macros list ***
  114. ==================================
  115. [..]
  116. Below the list of most used macros in SD HAL driver.
  117. (+) __HAL_SD_SDIO_ENABLE : Enable the SD device
  118. (+) __HAL_SD_SDIO_DISABLE : Disable the SD device
  119. (+) __HAL_SD_SDIO_DMA_ENABLE: Enable the SDIO DMA transfer
  120. (+) __HAL_SD_SDIO_DMA_DISABLE: Disable the SDIO DMA transfer
  121. (+) __HAL_SD_SDIO_ENABLE_IT: Enable the SD device interrupt
  122. (+) __HAL_SD_SDIO_DISABLE_IT: Disable the SD device interrupt
  123. (+) __HAL_SD_SDIO_GET_FLAG:Check whether the specified SD flag is set or not
  124. (+) __HAL_SD_SDIO_CLEAR_FLAG: Clear the SD's pending flags
  125. -@- You can refer to the SD HAL driver header file for more useful macros
  126. @endverbatim
  127. ******************************************************************************
  128. * @attention
  129. *
  130. * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
  131. *
  132. * Redistribution and use in source and binary forms, with or without modification,
  133. * are permitted provided that the following conditions are met:
  134. * 1. Redistributions of source code must retain the above copyright notice,
  135. * this list of conditions and the following disclaimer.
  136. * 2. Redistributions in binary form must reproduce the above copyright notice,
  137. * this list of conditions and the following disclaimer in the documentation
  138. * and/or other materials provided with the distribution.
  139. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  140. * may be used to endorse or promote products derived from this software
  141. * without specific prior written permission.
  142. *
  143. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  144. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  145. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  146. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  147. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  148. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  149. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  150. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  151. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  152. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  153. *
  154. ******************************************************************************
  155. */
  156. /* Includes ------------------------------------------------------------------*/
  157. #include "stm32f1xx_hal.h"
  158. #ifdef HAL_SD_MODULE_ENABLED
  159. #if defined(STM32F103xE) || defined(STM32F103xG)
  160. /** @addtogroup STM32F1xx_HAL_Driver
  161. * @{
  162. */
  163. /** @defgroup SD SD
  164. * @brief SD HAL module driver
  165. * @{
  166. */
  167. /* Private typedef -----------------------------------------------------------*/
  168. /* Private define ------------------------------------------------------------*/
  169. /** @defgroup SD_Private_Define SD Private Constant
  170. * @{
  171. */
  172. /**
  173. * @brief SDIO Data block size
  174. */
  175. #define DATA_BLOCK_SIZE ((uint32_t)(9 << 4))
  176. /**
  177. * @brief SDIO Static flags, TimeOut, FIFO Address
  178. */
  179. #define SDIO_STATIC_FLAGS ((uint32_t)(SDIO_FLAG_CCRCFAIL | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_CTIMEOUT |\
  180. SDIO_FLAG_DTIMEOUT | SDIO_FLAG_TXUNDERR | SDIO_FLAG_RXOVERR |\
  181. SDIO_FLAG_CMDREND | SDIO_FLAG_CMDSENT | SDIO_FLAG_DATAEND |\
  182. SDIO_FLAG_DBCKEND))
  183. #define SDIO_CMD0TIMEOUT ((uint32_t)0x00010000)
  184. /**
  185. * @brief Mask for errors Card Status R1 (OCR Register)
  186. */
  187. #define SD_OCR_ADDR_OUT_OF_RANGE ((uint32_t)0x80000000)
  188. #define SD_OCR_ADDR_MISALIGNED ((uint32_t)0x40000000)
  189. #define SD_OCR_BLOCK_LEN_ERR ((uint32_t)0x20000000)
  190. #define SD_OCR_ERASE_SEQ_ERR ((uint32_t)0x10000000)
  191. #define SD_OCR_BAD_ERASE_PARAM ((uint32_t)0x08000000)
  192. #define SD_OCR_WRITE_PROT_VIOLATION ((uint32_t)0x04000000)
  193. #define SD_OCR_LOCK_UNLOCK_FAILED ((uint32_t)0x01000000)
  194. #define SD_OCR_COM_CRC_FAILED ((uint32_t)0x00800000)
  195. #define SD_OCR_ILLEGAL_CMD ((uint32_t)0x00400000)
  196. #define SD_OCR_CARD_ECC_FAILED ((uint32_t)0x00200000)
  197. #define SD_OCR_CC_ERROR ((uint32_t)0x00100000)
  198. #define SD_OCR_GENERAL_UNKNOWN_ERROR ((uint32_t)0x00080000)
  199. #define SD_OCR_STREAM_READ_UNDERRUN ((uint32_t)0x00040000)
  200. #define SD_OCR_STREAM_WRITE_OVERRUN ((uint32_t)0x00020000)
  201. #define SD_OCR_CID_CSD_OVERWRITE ((uint32_t)0x00010000)
  202. #define SD_OCR_WP_ERASE_SKIP ((uint32_t)0x00008000)
  203. #define SD_OCR_CARD_ECC_DISABLED ((uint32_t)0x00004000)
  204. #define SD_OCR_ERASE_RESET ((uint32_t)0x00002000)
  205. #define SD_OCR_AKE_SEQ_ERROR ((uint32_t)0x00000008)
  206. #define SD_OCR_ERRORBITS ((uint32_t)0xFDFFE008)
  207. /**
  208. * @brief Masks for R6 Response
  209. */
  210. #define SD_R6_GENERAL_UNKNOWN_ERROR ((uint32_t)0x00002000)
  211. #define SD_R6_ILLEGAL_CMD ((uint32_t)0x00004000)
  212. #define SD_R6_COM_CRC_FAILED ((uint32_t)0x00008000)
  213. #define SD_VOLTAGE_WINDOW_SD ((uint32_t)0x80100000)
  214. #define SD_HIGH_CAPACITY ((uint32_t)0x40000000)
  215. #define SD_STD_CAPACITY ((uint32_t)0x00000000)
  216. #define SD_CHECK_PATTERN ((uint32_t)0x000001AA)
  217. #define SD_MAX_VOLT_TRIAL ((uint32_t)0x0000FFFF)
  218. #define SD_ALLZERO ((uint32_t)0x00000000)
  219. #define SD_WIDE_BUS_SUPPORT ((uint32_t)0x00040000)
  220. #define SD_SINGLE_BUS_SUPPORT ((uint32_t)0x00010000)
  221. #define SD_CARD_LOCKED ((uint32_t)0x02000000)
  222. #define SD_DATATIMEOUT ((uint32_t)0xFFFFFFFF)
  223. #define SD_0TO7BITS ((uint32_t)0x000000FF)
  224. #define SD_8TO15BITS ((uint32_t)0x0000FF00)
  225. #define SD_16TO23BITS ((uint32_t)0x00FF0000)
  226. #define SD_24TO31BITS ((uint32_t)0xFF000000)
  227. #define SD_MAX_DATA_LENGTH ((uint32_t)0x01FFFFFF)
  228. #define SD_HALFFIFO ((uint32_t)0x00000008)
  229. #define SD_HALFFIFOBYTES ((uint32_t)0x00000020)
  230. /**
  231. * @brief Command Class Supported
  232. */
  233. #define SD_CCCC_LOCK_UNLOCK ((uint32_t)0x00000080)
  234. #define SD_CCCC_WRITE_PROT ((uint32_t)0x00000040)
  235. #define SD_CCCC_ERASE ((uint32_t)0x00000020)
  236. /**
  237. * @brief Following commands are SD Card Specific commands.
  238. * SDIO_APP_CMD should be sent before sending these commands.
  239. */
  240. #define SD_SDIO_SEND_IF_COND ((uint32_t)SD_CMD_HS_SEND_EXT_CSD)
  241. /**
  242. * @}
  243. */
  244. /* Private macro -------------------------------------------------------------*/
  245. /* Private variables ---------------------------------------------------------*/
  246. /* Private function prototypes -----------------------------------------------*/
  247. /* Private functions ---------------------------------------------------------*/
  248. /** @defgroup SD_Private_Functions SD Private Functions
  249. * @{
  250. */
  251. static HAL_SD_ErrorTypedef SD_Initialize_Cards(SD_HandleTypeDef *hsd);
  252. static HAL_SD_ErrorTypedef SD_Select_Deselect(SD_HandleTypeDef *hsd, uint64_t Addr);
  253. static HAL_SD_ErrorTypedef SD_PowerON(SD_HandleTypeDef *hsd);
  254. static HAL_SD_ErrorTypedef SD_PowerOFF(SD_HandleTypeDef *hsd);
  255. static HAL_SD_ErrorTypedef SD_SendStatus(SD_HandleTypeDef *hsd, uint32_t *pCardStatus);
  256. static HAL_SD_CardStateTypedef SD_GetState(SD_HandleTypeDef *hsd);
  257. static HAL_SD_ErrorTypedef SD_IsCardProgramming(SD_HandleTypeDef *hsd, uint8_t *pStatus);
  258. static HAL_SD_ErrorTypedef SD_CmdError(SD_HandleTypeDef *hsd);
  259. static HAL_SD_ErrorTypedef SD_CmdResp1Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD);
  260. static HAL_SD_ErrorTypedef SD_CmdResp7Error(SD_HandleTypeDef *hsd);
  261. static HAL_SD_ErrorTypedef SD_CmdResp3Error(SD_HandleTypeDef *hsd);
  262. static HAL_SD_ErrorTypedef SD_CmdResp2Error(SD_HandleTypeDef *hsd);
  263. static HAL_SD_ErrorTypedef SD_CmdResp6Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD, uint16_t *pRCA);
  264. static HAL_SD_ErrorTypedef SD_WideBus_Enable(SD_HandleTypeDef *hsd);
  265. static HAL_SD_ErrorTypedef SD_WideBus_Disable(SD_HandleTypeDef *hsd);
  266. static HAL_SD_ErrorTypedef SD_FindSCR(SD_HandleTypeDef *hsd, uint32_t *pSCR);
  267. static void SD_DMA_RxCplt(DMA_HandleTypeDef *hdma);
  268. static void SD_DMA_RxError(DMA_HandleTypeDef *hdma);
  269. static void SD_DMA_TxCplt(DMA_HandleTypeDef *hdma);
  270. static void SD_DMA_TxError(DMA_HandleTypeDef *hdma);
  271. /**
  272. * @}
  273. */
  274. /** @defgroup SD_Exported_Functions SD Exported Functions
  275. * @{
  276. */
  277. /** @defgroup SD_Exported_Functions_Group1 Initialization and de-initialization functions
  278. * @brief Initialization and Configuration functions
  279. *
  280. @verbatim
  281. ===============================================================================
  282. ##### Initialization and de-initialization functions #####
  283. ===============================================================================
  284. [..]
  285. This section provides functions allowing to initialize/de-initialize the SD
  286. card device to be ready for use.
  287. @endverbatim
  288. * @{
  289. */
  290. /**
  291. * @brief Initializes the SD card according to the specified parameters in the
  292. SD_HandleTypeDef and create the associated handle.
  293. * @param hsd: SD handle
  294. * @param SDCardInfo: HAL_SD_CardInfoTypedef structure for SD card information
  295. * @retval HAL SD error state
  296. */
  297. HAL_SD_ErrorTypedef HAL_SD_Init(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypedef *SDCardInfo)
  298. {
  299. __IO HAL_SD_ErrorTypedef errorstate = SD_OK;
  300. SD_InitTypeDef tmpinit = {0};
  301. /* Initialize the low level hardware (MSP) */
  302. HAL_SD_MspInit(hsd);
  303. /* Default SDIO peripheral configuration for SD card initialization */
  304. tmpinit.ClockEdge = SDIO_CLOCK_EDGE_RISING;
  305. tmpinit.ClockBypass = SDIO_CLOCK_BYPASS_DISABLE;
  306. tmpinit.ClockPowerSave = SDIO_CLOCK_POWER_SAVE_DISABLE;
  307. tmpinit.BusWide = SDIO_BUS_WIDE_1B;
  308. tmpinit.HardwareFlowControl = SDIO_HARDWARE_FLOW_CONTROL_DISABLE;
  309. tmpinit.ClockDiv = SDIO_INIT_CLK_DIV;
  310. /* Initialize SDIO peripheral interface with default configuration */
  311. SDIO_Init(hsd->Instance, tmpinit);
  312. /* Identify card operating voltage */
  313. errorstate = SD_PowerON(hsd);
  314. if(errorstate != SD_OK)
  315. {
  316. return errorstate;
  317. }
  318. /* Initialize the present SDIO card(s) and put them in idle state */
  319. errorstate = SD_Initialize_Cards(hsd);
  320. if (errorstate != SD_OK)
  321. {
  322. return errorstate;
  323. }
  324. /* Read CSD/CID MSD registers */
  325. errorstate = HAL_SD_Get_CardInfo(hsd, SDCardInfo);
  326. if (errorstate == SD_OK)
  327. {
  328. /* Select the Card */
  329. errorstate = SD_Select_Deselect(hsd, (uint32_t)(((uint32_t)SDCardInfo->RCA) << 16));
  330. }
  331. /* Configure SDIO peripheral interface */
  332. SDIO_Init(hsd->Instance, hsd->Init);
  333. return errorstate;
  334. }
  335. /**
  336. * @brief De-Initializes the SD card.
  337. * @param hsd: SD handle
  338. * @retval HAL status
  339. */
  340. HAL_StatusTypeDef HAL_SD_DeInit(SD_HandleTypeDef *hsd)
  341. {
  342. /* Set SD power state to off */
  343. SD_PowerOFF(hsd);
  344. /* De-Initialize the MSP layer */
  345. HAL_SD_MspDeInit(hsd);
  346. return HAL_OK;
  347. }
  348. /**
  349. * @brief Initializes the SD MSP.
  350. * @param hsd: SD handle
  351. * @retval None
  352. */
  353. __weak void HAL_SD_MspInit(SD_HandleTypeDef *hsd)
  354. {
  355. /* Prevent unused argument(s) compilation warning */
  356. UNUSED(hsd);
  357. /* NOTE : This function Should not be modified, when the callback is needed,
  358. the HAL_SD_MspInit could be implemented in the user file
  359. */
  360. }
  361. /**
  362. * @brief De-Initialize SD MSP.
  363. * @param hsd: SD handle
  364. * @retval None
  365. */
  366. __weak void HAL_SD_MspDeInit(SD_HandleTypeDef *hsd)
  367. {
  368. /* Prevent unused argument(s) compilation warning */
  369. UNUSED(hsd);
  370. /* NOTE : This function Should not be modified, when the callback is needed,
  371. the HAL_SD_MspDeInit could be implemented in the user file
  372. */
  373. }
  374. /**
  375. * @}
  376. */
  377. /** @defgroup SD_Exported_Functions_Group2 IO operation functions
  378. * @brief Data transfer functions
  379. *
  380. @verbatim
  381. ===============================================================================
  382. ##### IO operation functions #####
  383. ===============================================================================
  384. [..]
  385. This subsection provides a set of functions allowing to manage the data
  386. transfer from/to SD card.
  387. @endverbatim
  388. * @{
  389. */
  390. /**
  391. * @brief Reads block(s) from a specified address in a card. The Data transfer
  392. * is managed by polling mode.
  393. * @param hsd: SD handle
  394. * @param pReadBuffer: pointer to the buffer that will contain the received data
  395. * @param ReadAddr: Address from where data is to be read
  396. * @param BlockSize: SD card Data block size (in bytes)
  397. * This parameter should be 512
  398. * @param NumberOfBlocks: Number of SD blocks to read
  399. * @retval SD Card error state
  400. */
  401. HAL_SD_ErrorTypedef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint32_t *pReadBuffer, uint64_t ReadAddr, uint32_t BlockSize, uint32_t NumberOfBlocks)
  402. {
  403. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  404. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  405. HAL_SD_ErrorTypedef errorstate = SD_OK;
  406. uint32_t count = 0, *tempbuff = (uint32_t *)pReadBuffer;
  407. /* Initialize data control register */
  408. hsd->Instance->DCTRL = 0;
  409. if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  410. {
  411. BlockSize = 512;
  412. ReadAddr /= 512;
  413. }
  414. /* Set Block Size for Card */
  415. sdio_cmdinitstructure.Argument = (uint32_t) BlockSize;
  416. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  417. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  418. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  419. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  420. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  421. /* Check for error conditions */
  422. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  423. if (errorstate != SD_OK)
  424. {
  425. return errorstate;
  426. }
  427. /* Configure the SD DPSM (Data Path State Machine) */
  428. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  429. sdio_datainitstructure.DataLength = NumberOfBlocks * BlockSize;
  430. sdio_datainitstructure.DataBlockSize = DATA_BLOCK_SIZE;
  431. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
  432. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  433. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  434. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  435. if(NumberOfBlocks > 1)
  436. {
  437. /* Send CMD18 READ_MULT_BLOCK with argument data address */
  438. sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_MULT_BLOCK;
  439. }
  440. else
  441. {
  442. /* Send CMD17 READ_SINGLE_BLOCK */
  443. sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_SINGLE_BLOCK;
  444. }
  445. sdio_cmdinitstructure.Argument = (uint32_t)ReadAddr;
  446. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  447. /* Read block(s) in polling mode */
  448. if(NumberOfBlocks > 1)
  449. {
  450. /* Check for error conditions */
  451. errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_MULT_BLOCK);
  452. if (errorstate != SD_OK)
  453. {
  454. return errorstate;
  455. }
  456. /* Poll on SDIO flags */
  457. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DATAEND | SDIO_FLAG_STBITERR))
  458. {
  459. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))
  460. {
  461. /* Read data from SDIO Rx FIFO */
  462. for (count = 0; count < 8; count++)
  463. {
  464. *(tempbuff + count) = SDIO_ReadFIFO(hsd->Instance);
  465. }
  466. tempbuff += 8;
  467. }
  468. }
  469. }
  470. else
  471. {
  472. /* Check for error conditions */
  473. errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_SINGLE_BLOCK);
  474. if (errorstate != SD_OK)
  475. {
  476. return errorstate;
  477. }
  478. /* In case of single block transfer, no need of stop transfer at all */
  479. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))
  480. {
  481. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))
  482. {
  483. /* Read data from SDIO Rx FIFO */
  484. for (count = 0; count < 8; count++)
  485. {
  486. *(tempbuff + count) = SDIO_ReadFIFO(hsd->Instance);
  487. }
  488. tempbuff += 8;
  489. }
  490. }
  491. }
  492. /* Send stop transmission command in case of multiblock read */
  493. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1))
  494. {
  495. if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) ||\
  496. (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\
  497. (hsd->CardType == HIGH_CAPACITY_SD_CARD))
  498. {
  499. /* Send stop transmission command */
  500. errorstate = HAL_SD_StopTransfer(hsd);
  501. }
  502. }
  503. /* Get error state */
  504. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))
  505. {
  506. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  507. errorstate = SD_DATA_TIMEOUT;
  508. return errorstate;
  509. }
  510. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))
  511. {
  512. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  513. errorstate = SD_DATA_CRC_FAIL;
  514. return errorstate;
  515. }
  516. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR))
  517. {
  518. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);
  519. errorstate = SD_RX_OVERRUN;
  520. return errorstate;
  521. }
  522. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))
  523. {
  524. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  525. errorstate = SD_START_BIT_ERR;
  526. return errorstate;
  527. }
  528. else
  529. {
  530. /* No error flag set */
  531. }
  532. count = SD_DATATIMEOUT;
  533. /* Empty FIFO if there is still any data */
  534. while ((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXDAVL)) && (count > 0))
  535. {
  536. *tempbuff = SDIO_ReadFIFO(hsd->Instance);
  537. tempbuff++;
  538. count--;
  539. }
  540. /* Clear all the static flags */
  541. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  542. return errorstate;
  543. }
  544. /**
  545. * @brief Allows to write block(s) to a specified address in a card. The Data
  546. * transfer is managed by polling mode.
  547. * @param hsd: SD handle
  548. * @param pWriteBuffer: pointer to the buffer that will contain the data to transmit
  549. * @param WriteAddr: Address from where data is to be written
  550. * @param BlockSize: SD card Data block size (in bytes)
  551. * This parameter should be 512.
  552. * @param NumberOfBlocks: Number of SD blocks to write
  553. * @retval SD Card error state
  554. */
  555. HAL_SD_ErrorTypedef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd, uint32_t *pWriteBuffer, uint64_t WriteAddr, uint32_t BlockSize, uint32_t NumberOfBlocks)
  556. {
  557. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  558. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  559. HAL_SD_ErrorTypedef errorstate = SD_OK;
  560. uint32_t totalnumberofbytes = 0, bytestransferred = 0, count = 0, restwords = 0;
  561. uint32_t *tempbuff = (uint32_t *)pWriteBuffer;
  562. uint8_t cardstate = 0;
  563. /* Initialize data control register */
  564. hsd->Instance->DCTRL = 0;
  565. if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  566. {
  567. BlockSize = 512;
  568. WriteAddr /= 512;
  569. }
  570. /* Set Block Size for Card */
  571. sdio_cmdinitstructure.Argument = (uint32_t)BlockSize;
  572. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  573. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  574. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  575. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  576. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  577. /* Check for error conditions */
  578. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  579. if (errorstate != SD_OK)
  580. {
  581. return errorstate;
  582. }
  583. if(NumberOfBlocks > 1)
  584. {
  585. /* Send CMD25 WRITE_MULT_BLOCK with argument data address */
  586. sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_MULT_BLOCK;
  587. }
  588. else
  589. {
  590. /* Send CMD24 WRITE_SINGLE_BLOCK */
  591. sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_SINGLE_BLOCK;
  592. }
  593. sdio_cmdinitstructure.Argument = (uint32_t)WriteAddr;
  594. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  595. /* Check for error conditions */
  596. if(NumberOfBlocks > 1)
  597. {
  598. errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_MULT_BLOCK);
  599. }
  600. else
  601. {
  602. errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_SINGLE_BLOCK);
  603. }
  604. if (errorstate != SD_OK)
  605. {
  606. return errorstate;
  607. }
  608. /* Set total number of bytes to write */
  609. totalnumberofbytes = NumberOfBlocks * BlockSize;
  610. /* Configure the SD DPSM (Data Path State Machine) */
  611. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  612. sdio_datainitstructure.DataLength = NumberOfBlocks * BlockSize;
  613. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
  614. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;
  615. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  616. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  617. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  618. /* Write block(s) in polling mode */
  619. if(NumberOfBlocks > 1)
  620. {
  621. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DATAEND | SDIO_FLAG_STBITERR))
  622. {
  623. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXFIFOHE))
  624. {
  625. if ((totalnumberofbytes - bytestransferred) < 32)
  626. {
  627. restwords = ((totalnumberofbytes - bytestransferred) % 4 == 0) ? ((totalnumberofbytes - bytestransferred) / 4) : (( totalnumberofbytes - bytestransferred) / 4 + 1);
  628. /* Write data to SDIO Tx FIFO */
  629. for (count = 0; count < restwords; count++)
  630. {
  631. SDIO_WriteFIFO(hsd->Instance, tempbuff);
  632. tempbuff++;
  633. bytestransferred += 4;
  634. }
  635. }
  636. else
  637. {
  638. /* Write data to SDIO Tx FIFO */
  639. for (count = 0; count < 8; count++)
  640. {
  641. SDIO_WriteFIFO(hsd->Instance, (tempbuff + count));
  642. }
  643. tempbuff += 8;
  644. bytestransferred += 32;
  645. }
  646. }
  647. }
  648. }
  649. else
  650. {
  651. /* In case of single data block transfer no need of stop command at all */
  652. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))
  653. {
  654. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXFIFOHE))
  655. {
  656. if ((totalnumberofbytes - bytestransferred) < 32)
  657. {
  658. restwords = ((totalnumberofbytes - bytestransferred) % 4 == 0) ? ((totalnumberofbytes - bytestransferred) / 4) : (( totalnumberofbytes - bytestransferred) / 4 + 1);
  659. /* Write data to SDIO Tx FIFO */
  660. for (count = 0; count < restwords; count++)
  661. {
  662. SDIO_WriteFIFO(hsd->Instance, tempbuff);
  663. tempbuff++;
  664. bytestransferred += 4;
  665. }
  666. }
  667. else
  668. {
  669. /* Write data to SDIO Tx FIFO */
  670. for (count = 0; count < 8; count++)
  671. {
  672. SDIO_WriteFIFO(hsd->Instance, (tempbuff + count));
  673. }
  674. tempbuff += 8;
  675. bytestransferred += 32;
  676. }
  677. }
  678. }
  679. }
  680. /* Send stop transmission command in case of multiblock write */
  681. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DATAEND) && (NumberOfBlocks > 1))
  682. {
  683. if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\
  684. (hsd->CardType == HIGH_CAPACITY_SD_CARD))
  685. {
  686. /* Send stop transmission command */
  687. errorstate = HAL_SD_StopTransfer(hsd);
  688. }
  689. }
  690. /* Get error state */
  691. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))
  692. {
  693. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  694. errorstate = SD_DATA_TIMEOUT;
  695. return errorstate;
  696. }
  697. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))
  698. {
  699. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  700. errorstate = SD_DATA_CRC_FAIL;
  701. return errorstate;
  702. }
  703. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXUNDERR))
  704. {
  705. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_TXUNDERR);
  706. errorstate = SD_TX_UNDERRUN;
  707. return errorstate;
  708. }
  709. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))
  710. {
  711. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  712. errorstate = SD_START_BIT_ERR;
  713. return errorstate;
  714. }
  715. else
  716. {
  717. /* No error flag set */
  718. }
  719. /* Clear all the static flags */
  720. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  721. /* Wait till the card is in programming state */
  722. errorstate = SD_IsCardProgramming(hsd, &cardstate);
  723. while ((errorstate == SD_OK) && ((cardstate == SD_CARD_PROGRAMMING) || (cardstate == SD_CARD_RECEIVING)))
  724. {
  725. errorstate = SD_IsCardProgramming(hsd, &cardstate);
  726. }
  727. return errorstate;
  728. }
  729. /**
  730. * @brief Reads block(s) from a specified address in a card. The Data transfer
  731. * is managed by DMA mode.
  732. * @note This API should be followed by the function HAL_SD_CheckReadOperation()
  733. * to check the completion of the read process
  734. * @param hsd: SD handle
  735. * @param pReadBuffer: Pointer to the buffer that will contain the received data
  736. * @param ReadAddr: Address from where data is to be read
  737. * @param BlockSize: SD card Data block size
  738. * @note BlockSize must be 512 bytes.
  739. * @param NumberOfBlocks: Number of blocks to read.
  740. * @retval SD Card error state
  741. */
  742. HAL_SD_ErrorTypedef HAL_SD_ReadBlocks_DMA(SD_HandleTypeDef *hsd, uint32_t *pReadBuffer, uint64_t ReadAddr, uint32_t BlockSize, uint32_t NumberOfBlocks)
  743. {
  744. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  745. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  746. HAL_SD_ErrorTypedef errorstate = SD_OK;
  747. /* Initialize data control register */
  748. hsd->Instance->DCTRL = 0;
  749. /* Initialize handle flags */
  750. hsd->SdTransferCplt = 0;
  751. hsd->DmaTransferCplt = 0;
  752. hsd->SdTransferErr = SD_OK;
  753. /* Initialize SD Read operation */
  754. if(NumberOfBlocks > 1)
  755. {
  756. hsd->SdOperation = SD_READ_MULTIPLE_BLOCK;
  757. }
  758. else
  759. {
  760. hsd->SdOperation = SD_READ_SINGLE_BLOCK;
  761. }
  762. /* Enable transfer interrupts */
  763. __HAL_SD_SDIO_ENABLE_IT(hsd, (SDIO_IT_DCRCFAIL |\
  764. SDIO_IT_DTIMEOUT |\
  765. SDIO_IT_DATAEND |\
  766. SDIO_IT_RXOVERR |\
  767. SDIO_IT_STBITERR));
  768. /* Enable SDIO DMA transfer */
  769. __HAL_SD_SDIO_DMA_ENABLE(hsd);
  770. /* Configure DMA user callbacks */
  771. hsd->hdmarx->XferCpltCallback = SD_DMA_RxCplt;
  772. hsd->hdmarx->XferErrorCallback = SD_DMA_RxError;
  773. /* Enable the DMA Channel */
  774. HAL_DMA_Start_IT(hsd->hdmarx, (uint32_t)&hsd->Instance->FIFO, (uint32_t)pReadBuffer, (uint32_t)(BlockSize * NumberOfBlocks)/4);
  775. if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  776. {
  777. BlockSize = 512;
  778. ReadAddr /= 512;
  779. }
  780. /* Set Block Size for Card */
  781. sdio_cmdinitstructure.Argument = (uint32_t)BlockSize;
  782. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  783. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  784. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  785. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  786. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  787. /* Check for error conditions */
  788. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  789. if (errorstate != SD_OK)
  790. {
  791. return errorstate;
  792. }
  793. /* Configure the SD DPSM (Data Path State Machine) */
  794. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  795. sdio_datainitstructure.DataLength = BlockSize * NumberOfBlocks;
  796. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
  797. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
  798. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  799. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  800. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  801. /* Check number of blocks command */
  802. if(NumberOfBlocks > 1)
  803. {
  804. /* Send CMD18 READ_MULT_BLOCK with argument data address */
  805. sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_MULT_BLOCK;
  806. }
  807. else
  808. {
  809. /* Send CMD17 READ_SINGLE_BLOCK */
  810. sdio_cmdinitstructure.CmdIndex = SD_CMD_READ_SINGLE_BLOCK;
  811. }
  812. sdio_cmdinitstructure.Argument = (uint32_t)ReadAddr;
  813. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  814. /* Check for error conditions */
  815. if(NumberOfBlocks > 1)
  816. {
  817. errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_MULT_BLOCK);
  818. }
  819. else
  820. {
  821. errorstate = SD_CmdResp1Error(hsd, SD_CMD_READ_SINGLE_BLOCK);
  822. }
  823. /* Update the SD transfer error in SD handle */
  824. hsd->SdTransferErr = errorstate;
  825. return errorstate;
  826. }
  827. /**
  828. * @brief Writes block(s) to a specified address in a card. The Data transfer
  829. * is managed by DMA mode.
  830. * @note This API should be followed by the function HAL_SD_CheckWriteOperation()
  831. * to check the completion of the write process (by SD current status polling).
  832. * @param hsd: SD handle
  833. * @param pWriteBuffer: pointer to the buffer that will contain the data to transmit
  834. * @param WriteAddr: Address from where data is to be read
  835. * @param BlockSize: the SD card Data block size
  836. * @note BlockSize must be 512 bytes.
  837. * @param NumberOfBlocks: Number of blocks to write
  838. * @retval SD Card error state
  839. */
  840. HAL_SD_ErrorTypedef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd, uint32_t *pWriteBuffer, uint64_t WriteAddr, uint32_t BlockSize, uint32_t NumberOfBlocks)
  841. {
  842. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  843. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  844. HAL_SD_ErrorTypedef errorstate = SD_OK;
  845. /* Initialize data control register */
  846. hsd->Instance->DCTRL = 0;
  847. /* Initialize handle flags */
  848. hsd->SdTransferCplt = 0;
  849. hsd->DmaTransferCplt = 0;
  850. hsd->SdTransferErr = SD_OK;
  851. /* Initialize SD Write operation */
  852. if(NumberOfBlocks > 1)
  853. {
  854. hsd->SdOperation = SD_WRITE_MULTIPLE_BLOCK;
  855. }
  856. else
  857. {
  858. hsd->SdOperation = SD_WRITE_SINGLE_BLOCK;
  859. }
  860. /* Enable transfer interrupts */
  861. __HAL_SD_SDIO_ENABLE_IT(hsd, (SDIO_IT_DCRCFAIL |\
  862. SDIO_IT_DTIMEOUT |\
  863. SDIO_IT_DATAEND |\
  864. SDIO_IT_TXUNDERR |\
  865. SDIO_IT_STBITERR));
  866. /* Configure DMA user callbacks */
  867. hsd->hdmatx->XferCpltCallback = SD_DMA_TxCplt;
  868. hsd->hdmatx->XferErrorCallback = SD_DMA_TxError;
  869. /* Enable the DMA Channel */
  870. HAL_DMA_Start_IT(hsd->hdmatx, (uint32_t)pWriteBuffer, (uint32_t)&hsd->Instance->FIFO, (uint32_t)(BlockSize * NumberOfBlocks)/4);
  871. /* Enable SDIO DMA transfer */
  872. __HAL_SD_SDIO_DMA_ENABLE(hsd);
  873. if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  874. {
  875. BlockSize = 512;
  876. WriteAddr /= 512;
  877. }
  878. /* Set Block Size for Card */
  879. sdio_cmdinitstructure.Argument = (uint32_t)BlockSize;
  880. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  881. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  882. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  883. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  884. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  885. /* Check for error conditions */
  886. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  887. if (errorstate != SD_OK)
  888. {
  889. return errorstate;
  890. }
  891. /* Check number of blocks command */
  892. if(NumberOfBlocks <= 1)
  893. {
  894. /* Send CMD24 WRITE_SINGLE_BLOCK */
  895. sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_SINGLE_BLOCK;
  896. }
  897. else
  898. {
  899. /* Send CMD25 WRITE_MULT_BLOCK with argument data address */
  900. sdio_cmdinitstructure.CmdIndex = SD_CMD_WRITE_MULT_BLOCK;
  901. }
  902. sdio_cmdinitstructure.Argument = (uint32_t)WriteAddr;
  903. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  904. /* Check for error conditions */
  905. if(NumberOfBlocks > 1)
  906. {
  907. errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_MULT_BLOCK);
  908. }
  909. else
  910. {
  911. errorstate = SD_CmdResp1Error(hsd, SD_CMD_WRITE_SINGLE_BLOCK);
  912. }
  913. if (errorstate != SD_OK)
  914. {
  915. return errorstate;
  916. }
  917. /* Configure the SD DPSM (Data Path State Machine) */
  918. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  919. sdio_datainitstructure.DataLength = BlockSize * NumberOfBlocks;
  920. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_512B;
  921. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_CARD;
  922. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  923. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  924. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  925. hsd->SdTransferErr = errorstate;
  926. return errorstate;
  927. }
  928. /**
  929. * @brief This function waits until the SD DMA data read transfer is finished.
  930. * This API should be called after HAL_SD_ReadBlocks_DMA() function
  931. * to insure that all data sent by the card is already transferred by the
  932. * DMA controller.
  933. * @param hsd: SD handle
  934. * @param Timeout: Timeout duration
  935. * @retval SD Card error state
  936. */
  937. HAL_SD_ErrorTypedef HAL_SD_CheckReadOperation(SD_HandleTypeDef *hsd, uint32_t Timeout)
  938. {
  939. HAL_SD_ErrorTypedef errorstate = SD_OK;
  940. uint32_t timeout = Timeout;
  941. uint32_t tmp1, tmp2;
  942. HAL_SD_ErrorTypedef tmp3;
  943. /* Wait for DMA/SD transfer end or SD error variables to be in SD handle */
  944. tmp1 = hsd->DmaTransferCplt;
  945. tmp2 = hsd->SdTransferCplt;
  946. tmp3 = (HAL_SD_ErrorTypedef)hsd->SdTransferErr;
  947. while (((tmp1 & tmp2) == 0) && (tmp3 == SD_OK) && (timeout > 0))
  948. {
  949. tmp1 = hsd->DmaTransferCplt;
  950. tmp2 = hsd->SdTransferCplt;
  951. tmp3 = (HAL_SD_ErrorTypedef)hsd->SdTransferErr;
  952. timeout--;
  953. }
  954. timeout = Timeout;
  955. /* Wait until the Rx transfer is no longer active */
  956. while((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXACT)) && (timeout > 0))
  957. {
  958. timeout--;
  959. }
  960. /* Send stop command in multiblock read */
  961. if (hsd->SdOperation == SD_READ_MULTIPLE_BLOCK)
  962. {
  963. errorstate = HAL_SD_StopTransfer(hsd);
  964. }
  965. if ((timeout == 0) && (errorstate == SD_OK))
  966. {
  967. errorstate = SD_DATA_TIMEOUT;
  968. }
  969. /* Clear all the static flags */
  970. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  971. /* Return error state */
  972. if (hsd->SdTransferErr != SD_OK)
  973. {
  974. return (HAL_SD_ErrorTypedef)(hsd->SdTransferErr);
  975. }
  976. return errorstate;
  977. }
  978. /**
  979. * @brief This function waits until the SD DMA data write transfer is finished.
  980. * This API should be called after HAL_SD_WriteBlocks_DMA() function
  981. * to insure that all data sent by the card is already transferred by the
  982. * DMA controller.
  983. * @param hsd: SD handle
  984. * @param Timeout: Timeout duration
  985. * @retval SD Card error state
  986. */
  987. HAL_SD_ErrorTypedef HAL_SD_CheckWriteOperation(SD_HandleTypeDef *hsd, uint32_t Timeout)
  988. {
  989. HAL_SD_ErrorTypedef errorstate = SD_OK;
  990. uint32_t timeout = Timeout;
  991. uint32_t tmp1, tmp2;
  992. HAL_SD_ErrorTypedef tmp3;
  993. /* Wait for DMA/SD transfer end or SD error variables to be in SD handle */
  994. tmp1 = hsd->DmaTransferCplt;
  995. tmp2 = hsd->SdTransferCplt;
  996. tmp3 = (HAL_SD_ErrorTypedef)hsd->SdTransferErr;
  997. while (((tmp1 & tmp2) == 0) && (tmp3 == SD_OK) && (timeout > 0))
  998. {
  999. tmp1 = hsd->DmaTransferCplt;
  1000. tmp2 = hsd->SdTransferCplt;
  1001. tmp3 = (HAL_SD_ErrorTypedef)hsd->SdTransferErr;
  1002. timeout--;
  1003. }
  1004. timeout = Timeout;
  1005. /* Wait until the Tx transfer is no longer active */
  1006. while((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_TXACT)) && (timeout > 0))
  1007. {
  1008. timeout--;
  1009. }
  1010. /* Send stop command in multiblock write */
  1011. if (hsd->SdOperation == SD_WRITE_MULTIPLE_BLOCK)
  1012. {
  1013. errorstate = HAL_SD_StopTransfer(hsd);
  1014. }
  1015. if ((timeout == 0) && (errorstate == SD_OK))
  1016. {
  1017. errorstate = SD_DATA_TIMEOUT;
  1018. }
  1019. /* Clear all the static flags */
  1020. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  1021. /* Return error state */
  1022. if (hsd->SdTransferErr != SD_OK)
  1023. {
  1024. return (HAL_SD_ErrorTypedef)(hsd->SdTransferErr);
  1025. }
  1026. /* Wait until write is complete */
  1027. while(HAL_SD_GetStatus(hsd) != SD_TRANSFER_OK)
  1028. {
  1029. }
  1030. return errorstate;
  1031. }
  1032. /**
  1033. * @brief Erases the specified memory area of the given SD card.
  1034. * @param hsd: SD handle
  1035. * @param Startaddr: Start byte address
  1036. * @param Endaddr: End byte address
  1037. * @retval SD Card error state
  1038. */
  1039. HAL_SD_ErrorTypedef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint64_t Startaddr, uint64_t Endaddr)
  1040. {
  1041. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1042. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  1043. uint32_t delay = 0;
  1044. __IO uint32_t maxdelay = 0;
  1045. uint8_t cardstate = 0;
  1046. /* Check if the card command class supports erase command */
  1047. if (((hsd->CSD[1] >> 20) & SD_CCCC_ERASE) == 0)
  1048. {
  1049. errorstate = SD_REQUEST_NOT_APPLICABLE;
  1050. return errorstate;
  1051. }
  1052. /* Get max delay value */
  1053. maxdelay = 120000 / (((hsd->Instance->CLKCR) & 0xFF) + 2);
  1054. if((SDIO_GetResponse(hsd->Instance, SDIO_RESP1) & SD_CARD_LOCKED) == SD_CARD_LOCKED)
  1055. {
  1056. errorstate = SD_LOCK_UNLOCK_FAILED;
  1057. return errorstate;
  1058. }
  1059. /* Get start and end block for high capacity cards */
  1060. if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  1061. {
  1062. Startaddr /= 512;
  1063. Endaddr /= 512;
  1064. }
  1065. /* According to sd-card spec 1.0 ERASE_GROUP_START (CMD32) and erase_group_end(CMD33) */
  1066. if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\
  1067. (hsd->CardType == HIGH_CAPACITY_SD_CARD))
  1068. {
  1069. /* Send CMD32 SD_ERASE_GRP_START with argument as addr */
  1070. sdio_cmdinitstructure.Argument =(uint32_t)Startaddr;
  1071. sdio_cmdinitstructure.CmdIndex = SD_CMD_SD_ERASE_GRP_START;
  1072. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  1073. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  1074. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  1075. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1076. /* Check for error conditions */
  1077. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SD_ERASE_GRP_START);
  1078. if (errorstate != SD_OK)
  1079. {
  1080. return errorstate;
  1081. }
  1082. /* Send CMD33 SD_ERASE_GRP_END with argument as addr */
  1083. sdio_cmdinitstructure.Argument = (uint32_t)Endaddr;
  1084. sdio_cmdinitstructure.CmdIndex = SD_CMD_SD_ERASE_GRP_END;
  1085. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1086. /* Check for error conditions */
  1087. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SD_ERASE_GRP_END);
  1088. if (errorstate != SD_OK)
  1089. {
  1090. return errorstate;
  1091. }
  1092. }
  1093. /* Send CMD38 ERASE */
  1094. sdio_cmdinitstructure.Argument = 0;
  1095. sdio_cmdinitstructure.CmdIndex = SD_CMD_ERASE;
  1096. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1097. /* Check for error conditions */
  1098. errorstate = SD_CmdResp1Error(hsd, SD_CMD_ERASE);
  1099. if (errorstate != SD_OK)
  1100. {
  1101. return errorstate;
  1102. }
  1103. for (; delay < maxdelay; delay++)
  1104. {
  1105. }
  1106. /* Wait untill the card is in programming state */
  1107. errorstate = SD_IsCardProgramming(hsd, &cardstate);
  1108. delay = SD_DATATIMEOUT;
  1109. while ((delay > 0) && (errorstate == SD_OK) && ((cardstate == SD_CARD_PROGRAMMING) || (cardstate == SD_CARD_RECEIVING)))
  1110. {
  1111. errorstate = SD_IsCardProgramming(hsd, &cardstate);
  1112. delay--;
  1113. }
  1114. return errorstate;
  1115. }
  1116. /**
  1117. * @brief This function handles SD card interrupt request.
  1118. * @param hsd: SD handle
  1119. * @retval None
  1120. */
  1121. void HAL_SD_IRQHandler(SD_HandleTypeDef *hsd)
  1122. {
  1123. /* Check for SDIO interrupt flags */
  1124. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_DATAEND))
  1125. {
  1126. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_IT_DATAEND);
  1127. /* SD transfer is complete */
  1128. hsd->SdTransferCplt = 1;
  1129. /* No transfer error */
  1130. hsd->SdTransferErr = SD_OK;
  1131. HAL_SD_XferCpltCallback(hsd);
  1132. }
  1133. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_DCRCFAIL))
  1134. {
  1135. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  1136. hsd->SdTransferErr = SD_DATA_CRC_FAIL;
  1137. HAL_SD_XferErrorCallback(hsd);
  1138. }
  1139. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_DTIMEOUT))
  1140. {
  1141. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  1142. hsd->SdTransferErr = SD_DATA_TIMEOUT;
  1143. HAL_SD_XferErrorCallback(hsd);
  1144. }
  1145. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_RXOVERR))
  1146. {
  1147. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);
  1148. hsd->SdTransferErr = SD_RX_OVERRUN;
  1149. HAL_SD_XferErrorCallback(hsd);
  1150. }
  1151. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_TXUNDERR))
  1152. {
  1153. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_TXUNDERR);
  1154. hsd->SdTransferErr = SD_TX_UNDERRUN;
  1155. HAL_SD_XferErrorCallback(hsd);
  1156. }
  1157. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_IT_STBITERR))
  1158. {
  1159. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  1160. hsd->SdTransferErr = SD_START_BIT_ERR;
  1161. HAL_SD_XferErrorCallback(hsd);
  1162. }
  1163. else
  1164. {
  1165. /* No error flag set */
  1166. }
  1167. /* Disable all SDIO peripheral interrupt sources */
  1168. __HAL_SD_SDIO_DISABLE_IT(hsd, SDIO_IT_DCRCFAIL | SDIO_IT_DTIMEOUT | SDIO_IT_DATAEND |\
  1169. SDIO_IT_TXFIFOHE | SDIO_IT_RXFIFOHF | SDIO_IT_TXUNDERR |\
  1170. SDIO_IT_RXOVERR | SDIO_IT_STBITERR);
  1171. }
  1172. /**
  1173. * @brief SD end of transfer callback.
  1174. * @param hsd: SD handle
  1175. * @retval None
  1176. */
  1177. __weak void HAL_SD_XferCpltCallback(SD_HandleTypeDef *hsd)
  1178. {
  1179. /* Prevent unused argument(s) compilation warning */
  1180. UNUSED(hsd);
  1181. /* NOTE : This function Should not be modified, when the callback is needed,
  1182. the HAL_SD_XferCpltCallback could be implemented in the user file
  1183. */
  1184. }
  1185. /**
  1186. * @brief SD Transfer Error callback.
  1187. * @param hsd: SD handle
  1188. * @retval None
  1189. */
  1190. __weak void HAL_SD_XferErrorCallback(SD_HandleTypeDef *hsd)
  1191. {
  1192. /* Prevent unused argument(s) compilation warning */
  1193. UNUSED(hsd);
  1194. /* NOTE : This function Should not be modified, when the callback is needed,
  1195. the HAL_SD_XferErrorCallback could be implemented in the user file
  1196. */
  1197. }
  1198. /**
  1199. * @brief SD Transfer complete Rx callback in non blocking mode.
  1200. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1201. * the configuration information for the specified DMA module.
  1202. * @retval None
  1203. */
  1204. __weak void HAL_SD_DMA_RxCpltCallback(DMA_HandleTypeDef *hdma)
  1205. {
  1206. /* Prevent unused argument(s) compilation warning */
  1207. UNUSED(hdma);
  1208. /* NOTE : This function Should not be modified, when the callback is needed,
  1209. the HAL_SD_DMA_RxCpltCallback could be implemented in the user file
  1210. */
  1211. }
  1212. /**
  1213. * @brief SD DMA transfer complete Rx error callback.
  1214. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1215. * the configuration information for the specified DMA module.
  1216. * @retval None
  1217. */
  1218. __weak void HAL_SD_DMA_RxErrorCallback(DMA_HandleTypeDef *hdma)
  1219. {
  1220. /* Prevent unused argument(s) compilation warning */
  1221. UNUSED(hdma);
  1222. /* NOTE : This function Should not be modified, when the callback is needed,
  1223. the HAL_SD_DMA_RxErrorCallback could be implemented in the user file
  1224. */
  1225. }
  1226. /**
  1227. * @brief SD Transfer complete Tx callback in non blocking mode.
  1228. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1229. * the configuration information for the specified DMA module.
  1230. * @retval None
  1231. */
  1232. __weak void HAL_SD_DMA_TxCpltCallback(DMA_HandleTypeDef *hdma)
  1233. {
  1234. /* Prevent unused argument(s) compilation warning */
  1235. UNUSED(hdma);
  1236. /* NOTE : This function Should not be modified, when the callback is needed,
  1237. the HAL_SD_DMA_TxCpltCallback could be implemented in the user file
  1238. */
  1239. }
  1240. /**
  1241. * @brief SD DMA transfer complete error Tx callback.
  1242. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1243. * the configuration information for the specified DMA module.
  1244. * @retval None
  1245. */
  1246. __weak void HAL_SD_DMA_TxErrorCallback(DMA_HandleTypeDef *hdma)
  1247. {
  1248. /* Prevent unused argument(s) compilation warning */
  1249. UNUSED(hdma);
  1250. /* NOTE : This function Should not be modified, when the callback is needed,
  1251. the HAL_SD_DMA_TxErrorCallback could be implemented in the user file
  1252. */
  1253. }
  1254. /**
  1255. * @}
  1256. */
  1257. /** @defgroup SD_Exported_Functions_Group3 Peripheral Control functions
  1258. * @brief management functions
  1259. *
  1260. @verbatim
  1261. ==============================================================================
  1262. ##### Peripheral Control functions #####
  1263. ==============================================================================
  1264. [..]
  1265. This subsection provides a set of functions allowing to control the SD card
  1266. operations.
  1267. @endverbatim
  1268. * @{
  1269. */
  1270. /**
  1271. * @brief Returns information about specific card.
  1272. * @param hsd: SD handle
  1273. * @param pCardInfo: Pointer to a HAL_SD_CardInfoTypedef structure that
  1274. * contains all SD cardinformation
  1275. * @retval SD Card error state
  1276. */
  1277. HAL_SD_ErrorTypedef HAL_SD_Get_CardInfo(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypedef *pCardInfo)
  1278. {
  1279. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1280. uint32_t tmp = 0;
  1281. pCardInfo->CardType = (uint8_t)(hsd->CardType);
  1282. pCardInfo->RCA = (uint16_t)(hsd->RCA);
  1283. /* Byte 0 */
  1284. tmp = (hsd->CSD[0] & 0xFF000000) >> 24;
  1285. pCardInfo->SD_csd.CSDStruct = (uint8_t)((tmp & 0xC0) >> 6);
  1286. pCardInfo->SD_csd.SysSpecVersion = (uint8_t)((tmp & 0x3C) >> 2);
  1287. pCardInfo->SD_csd.Reserved1 = tmp & 0x03;
  1288. /* Byte 1 */
  1289. tmp = (hsd->CSD[0] & 0x00FF0000) >> 16;
  1290. pCardInfo->SD_csd.TAAC = (uint8_t)tmp;
  1291. /* Byte 2 */
  1292. tmp = (hsd->CSD[0] & 0x0000FF00) >> 8;
  1293. pCardInfo->SD_csd.NSAC = (uint8_t)tmp;
  1294. /* Byte 3 */
  1295. tmp = hsd->CSD[0] & 0x000000FF;
  1296. pCardInfo->SD_csd.MaxBusClkFrec = (uint8_t)tmp;
  1297. /* Byte 4 */
  1298. tmp = (hsd->CSD[1] & 0xFF000000) >> 24;
  1299. pCardInfo->SD_csd.CardComdClasses = (uint16_t)(tmp << 4);
  1300. /* Byte 5 */
  1301. tmp = (hsd->CSD[1] & 0x00FF0000) >> 16;
  1302. pCardInfo->SD_csd.CardComdClasses |= (uint16_t)((tmp & 0xF0) >> 4);
  1303. pCardInfo->SD_csd.RdBlockLen = (uint8_t)(tmp & 0x0F);
  1304. /* Byte 6 */
  1305. tmp = (hsd->CSD[1] & 0x0000FF00) >> 8;
  1306. pCardInfo->SD_csd.PartBlockRead = (uint8_t)((tmp & 0x80) >> 7);
  1307. pCardInfo->SD_csd.WrBlockMisalign = (uint8_t)((tmp & 0x40) >> 6);
  1308. pCardInfo->SD_csd.RdBlockMisalign = (uint8_t)((tmp & 0x20) >> 5);
  1309. pCardInfo->SD_csd.DSRImpl = (uint8_t)((tmp & 0x10) >> 4);
  1310. pCardInfo->SD_csd.Reserved2 = 0; /*!< Reserved */
  1311. if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0))
  1312. {
  1313. pCardInfo->SD_csd.DeviceSize = (tmp & 0x03) << 10;
  1314. /* Byte 7 */
  1315. tmp = (uint8_t)(hsd->CSD[1] & 0x000000FF);
  1316. pCardInfo->SD_csd.DeviceSize |= (tmp) << 2;
  1317. /* Byte 8 */
  1318. tmp = (uint8_t)((hsd->CSD[2] & 0xFF000000) >> 24);
  1319. pCardInfo->SD_csd.DeviceSize |= (tmp & 0xC0) >> 6;
  1320. pCardInfo->SD_csd.MaxRdCurrentVDDMin = (tmp & 0x38) >> 3;
  1321. pCardInfo->SD_csd.MaxRdCurrentVDDMax = (tmp & 0x07);
  1322. /* Byte 9 */
  1323. tmp = (uint8_t)((hsd->CSD[2] & 0x00FF0000) >> 16);
  1324. pCardInfo->SD_csd.MaxWrCurrentVDDMin = (tmp & 0xE0) >> 5;
  1325. pCardInfo->SD_csd.MaxWrCurrentVDDMax = (tmp & 0x1C) >> 2;
  1326. pCardInfo->SD_csd.DeviceSizeMul = (tmp & 0x03) << 1;
  1327. /* Byte 10 */
  1328. tmp = (uint8_t)((hsd->CSD[2] & 0x0000FF00) >> 8);
  1329. pCardInfo->SD_csd.DeviceSizeMul |= (tmp & 0x80) >> 7;
  1330. pCardInfo->CardCapacity = (pCardInfo->SD_csd.DeviceSize + 1) ;
  1331. pCardInfo->CardCapacity *= (1 << (pCardInfo->SD_csd.DeviceSizeMul + 2));
  1332. pCardInfo->CardBlockSize = 1 << (pCardInfo->SD_csd.RdBlockLen);
  1333. pCardInfo->CardCapacity *= pCardInfo->CardBlockSize;
  1334. }
  1335. else if (hsd->CardType == HIGH_CAPACITY_SD_CARD)
  1336. {
  1337. /* Byte 7 */
  1338. tmp = (uint8_t)(hsd->CSD[1] & 0x000000FF);
  1339. pCardInfo->SD_csd.DeviceSize = (tmp & 0x3F) << 16;
  1340. /* Byte 8 */
  1341. tmp = (uint8_t)((hsd->CSD[2] & 0xFF000000) >> 24);
  1342. pCardInfo->SD_csd.DeviceSize |= (tmp << 8);
  1343. /* Byte 9 */
  1344. tmp = (uint8_t)((hsd->CSD[2] & 0x00FF0000) >> 16);
  1345. pCardInfo->SD_csd.DeviceSize |= (tmp);
  1346. /* Byte 10 */
  1347. tmp = (uint8_t)((hsd->CSD[2] & 0x0000FF00) >> 8);
  1348. pCardInfo->CardCapacity = (uint64_t)(((uint64_t)pCardInfo->SD_csd.DeviceSize + 1) * 512 * 1024);
  1349. pCardInfo->CardBlockSize = 512;
  1350. }
  1351. else
  1352. {
  1353. /* Not supported card type */
  1354. errorstate = SD_ERROR;
  1355. }
  1356. pCardInfo->SD_csd.EraseGrSize = (tmp & 0x40) >> 6;
  1357. pCardInfo->SD_csd.EraseGrMul = (tmp & 0x3F) << 1;
  1358. /* Byte 11 */
  1359. tmp = (uint8_t)(hsd->CSD[2] & 0x000000FF);
  1360. pCardInfo->SD_csd.EraseGrMul |= (tmp & 0x80) >> 7;
  1361. pCardInfo->SD_csd.WrProtectGrSize = (tmp & 0x7F);
  1362. /* Byte 12 */
  1363. tmp = (uint8_t)((hsd->CSD[3] & 0xFF000000) >> 24);
  1364. pCardInfo->SD_csd.WrProtectGrEnable = (tmp & 0x80) >> 7;
  1365. pCardInfo->SD_csd.ManDeflECC = (tmp & 0x60) >> 5;
  1366. pCardInfo->SD_csd.WrSpeedFact = (tmp & 0x1C) >> 2;
  1367. pCardInfo->SD_csd.MaxWrBlockLen = (tmp & 0x03) << 2;
  1368. /* Byte 13 */
  1369. tmp = (uint8_t)((hsd->CSD[3] & 0x00FF0000) >> 16);
  1370. pCardInfo->SD_csd.MaxWrBlockLen |= (tmp & 0xC0) >> 6;
  1371. pCardInfo->SD_csd.WriteBlockPaPartial = (tmp & 0x20) >> 5;
  1372. pCardInfo->SD_csd.Reserved3 = 0;
  1373. pCardInfo->SD_csd.ContentProtectAppli = (tmp & 0x01);
  1374. /* Byte 14 */
  1375. tmp = (uint8_t)((hsd->CSD[3] & 0x0000FF00) >> 8);
  1376. pCardInfo->SD_csd.FileFormatGrouop = (tmp & 0x80) >> 7;
  1377. pCardInfo->SD_csd.CopyFlag = (tmp & 0x40) >> 6;
  1378. pCardInfo->SD_csd.PermWrProtect = (tmp & 0x20) >> 5;
  1379. pCardInfo->SD_csd.TempWrProtect = (tmp & 0x10) >> 4;
  1380. pCardInfo->SD_csd.FileFormat = (tmp & 0x0C) >> 2;
  1381. pCardInfo->SD_csd.ECC = (tmp & 0x03);
  1382. /* Byte 15 */
  1383. tmp = (uint8_t)(hsd->CSD[3] & 0x000000FF);
  1384. pCardInfo->SD_csd.CSD_CRC = (tmp & 0xFE) >> 1;
  1385. pCardInfo->SD_csd.Reserved4 = 1;
  1386. /* Byte 0 */
  1387. tmp = (uint8_t)((hsd->CID[0] & 0xFF000000) >> 24);
  1388. pCardInfo->SD_cid.ManufacturerID = tmp;
  1389. /* Byte 1 */
  1390. tmp = (uint8_t)((hsd->CID[0] & 0x00FF0000) >> 16);
  1391. pCardInfo->SD_cid.OEM_AppliID = tmp << 8;
  1392. /* Byte 2 */
  1393. tmp = (uint8_t)((hsd->CID[0] & 0x000000FF00) >> 8);
  1394. pCardInfo->SD_cid.OEM_AppliID |= tmp;
  1395. /* Byte 3 */
  1396. tmp = (uint8_t)(hsd->CID[0] & 0x000000FF);
  1397. pCardInfo->SD_cid.ProdName1 = tmp << 24;
  1398. /* Byte 4 */
  1399. tmp = (uint8_t)((hsd->CID[1] & 0xFF000000) >> 24);
  1400. pCardInfo->SD_cid.ProdName1 |= tmp << 16;
  1401. /* Byte 5 */
  1402. tmp = (uint8_t)((hsd->CID[1] & 0x00FF0000) >> 16);
  1403. pCardInfo->SD_cid.ProdName1 |= tmp << 8;
  1404. /* Byte 6 */
  1405. tmp = (uint8_t)((hsd->CID[1] & 0x0000FF00) >> 8);
  1406. pCardInfo->SD_cid.ProdName1 |= tmp;
  1407. /* Byte 7 */
  1408. tmp = (uint8_t)(hsd->CID[1] & 0x000000FF);
  1409. pCardInfo->SD_cid.ProdName2 = tmp;
  1410. /* Byte 8 */
  1411. tmp = (uint8_t)((hsd->CID[2] & 0xFF000000) >> 24);
  1412. pCardInfo->SD_cid.ProdRev = tmp;
  1413. /* Byte 9 */
  1414. tmp = (uint8_t)((hsd->CID[2] & 0x00FF0000) >> 16);
  1415. pCardInfo->SD_cid.ProdSN = tmp << 24;
  1416. /* Byte 10 */
  1417. tmp = (uint8_t)((hsd->CID[2] & 0x0000FF00) >> 8);
  1418. pCardInfo->SD_cid.ProdSN |= tmp << 16;
  1419. /* Byte 11 */
  1420. tmp = (uint8_t)(hsd->CID[2] & 0x000000FF);
  1421. pCardInfo->SD_cid.ProdSN |= tmp << 8;
  1422. /* Byte 12 */
  1423. tmp = (uint8_t)((hsd->CID[3] & 0xFF000000) >> 24);
  1424. pCardInfo->SD_cid.ProdSN |= tmp;
  1425. /* Byte 13 */
  1426. tmp = (uint8_t)((hsd->CID[3] & 0x00FF0000) >> 16);
  1427. pCardInfo->SD_cid.Reserved1 |= (tmp & 0xF0) >> 4;
  1428. pCardInfo->SD_cid.ManufactDate = (tmp & 0x0F) << 8;
  1429. /* Byte 14 */
  1430. tmp = (uint8_t)((hsd->CID[3] & 0x0000FF00) >> 8);
  1431. pCardInfo->SD_cid.ManufactDate |= tmp;
  1432. /* Byte 15 */
  1433. tmp = (uint8_t)(hsd->CID[3] & 0x000000FF);
  1434. pCardInfo->SD_cid.CID_CRC = (tmp & 0xFE) >> 1;
  1435. pCardInfo->SD_cid.Reserved2 = 1;
  1436. return errorstate;
  1437. }
  1438. /**
  1439. * @brief Enables wide bus operation for the requested card if supported by
  1440. * card.
  1441. * @param hsd: SD handle
  1442. * @param WideMode: Specifies the SD card wide bus mode
  1443. * This parameter can be one of the following values:
  1444. * @arg SDIO_BUS_WIDE_8B: 8-bit data transfer (Only for MMC)
  1445. * @arg SDIO_BUS_WIDE_4B: 4-bit data transfer
  1446. * @arg SDIO_BUS_WIDE_1B: 1-bit data transfer
  1447. * @retval SD Card error state
  1448. */
  1449. HAL_SD_ErrorTypedef HAL_SD_WideBusOperation_Config(SD_HandleTypeDef *hsd, uint32_t WideMode)
  1450. {
  1451. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1452. SDIO_InitTypeDef init = {0};
  1453. /* MMC Card does not support this feature */
  1454. if (hsd->CardType == MULTIMEDIA_CARD)
  1455. {
  1456. errorstate = SD_UNSUPPORTED_FEATURE;
  1457. }
  1458. else if ((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\
  1459. (hsd->CardType == HIGH_CAPACITY_SD_CARD))
  1460. {
  1461. if (WideMode == SDIO_BUS_WIDE_8B)
  1462. {
  1463. errorstate = SD_UNSUPPORTED_FEATURE;
  1464. }
  1465. else if (WideMode == SDIO_BUS_WIDE_4B)
  1466. {
  1467. errorstate = SD_WideBus_Enable(hsd);
  1468. }
  1469. else if (WideMode == SDIO_BUS_WIDE_1B)
  1470. {
  1471. errorstate = SD_WideBus_Disable(hsd);
  1472. }
  1473. else
  1474. {
  1475. /* WideMode is not a valid argument*/
  1476. errorstate = SD_INVALID_PARAMETER;
  1477. }
  1478. if (errorstate == SD_OK)
  1479. {
  1480. /* Configure the SDIO peripheral */
  1481. init.ClockEdge = hsd->Init.ClockEdge;
  1482. init.ClockBypass = hsd->Init.ClockBypass;
  1483. init.ClockPowerSave = hsd->Init.ClockPowerSave;
  1484. init.BusWide = WideMode;
  1485. init.HardwareFlowControl = hsd->Init.HardwareFlowControl;
  1486. init.ClockDiv = hsd->Init.ClockDiv;
  1487. /* Configure SDIO peripheral interface */
  1488. SDIO_Init(hsd->Instance, init);
  1489. }
  1490. else
  1491. {
  1492. /* An error occured while enabling/disabling the wide bus*/
  1493. }
  1494. }
  1495. else
  1496. {
  1497. /* Not supported card type */
  1498. errorstate = SD_ERROR;
  1499. }
  1500. return errorstate;
  1501. }
  1502. /**
  1503. * @brief Aborts an ongoing data transfer.
  1504. * @param hsd: SD handle
  1505. * @retval SD Card error state
  1506. */
  1507. HAL_SD_ErrorTypedef HAL_SD_StopTransfer(SD_HandleTypeDef *hsd)
  1508. {
  1509. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  1510. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1511. /* Send CMD12 STOP_TRANSMISSION */
  1512. sdio_cmdinitstructure.Argument = 0;
  1513. sdio_cmdinitstructure.CmdIndex = SD_CMD_STOP_TRANSMISSION;
  1514. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  1515. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  1516. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  1517. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1518. /* Check for error conditions */
  1519. errorstate = SD_CmdResp1Error(hsd, SD_CMD_STOP_TRANSMISSION);
  1520. return errorstate;
  1521. }
  1522. /**
  1523. * @brief Switches the SD card to High Speed mode.
  1524. * This API must be used after "Transfer State"
  1525. * @note This operation should be followed by the configuration
  1526. * of PLL to have SDIOCK clock between 67 and 75 MHz
  1527. * @param hsd: SD handle
  1528. * @retval SD Card error state
  1529. */
  1530. HAL_SD_ErrorTypedef HAL_SD_HighSpeed (SD_HandleTypeDef *hsd)
  1531. {
  1532. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1533. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  1534. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  1535. uint8_t SD_hs[64] = {0};
  1536. uint32_t SD_scr[2] = {0, 0};
  1537. uint32_t SD_SPEC = 0 ;
  1538. uint32_t count = 0, *tempbuff = (uint32_t *)SD_hs;
  1539. /* Initialize the Data control register */
  1540. hsd->Instance->DCTRL = 0;
  1541. /* Get SCR Register */
  1542. errorstate = SD_FindSCR(hsd, SD_scr);
  1543. if (errorstate != SD_OK)
  1544. {
  1545. return errorstate;
  1546. }
  1547. /* Test the Version supported by the card*/
  1548. SD_SPEC = (SD_scr[1] & 0x01000000) | (SD_scr[1] & 0x02000000);
  1549. if (SD_SPEC != SD_ALLZERO)
  1550. {
  1551. /* Set Block Size for Card */
  1552. sdio_cmdinitstructure.Argument = (uint32_t)64;
  1553. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  1554. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  1555. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  1556. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  1557. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1558. /* Check for error conditions */
  1559. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  1560. if (errorstate != SD_OK)
  1561. {
  1562. return errorstate;
  1563. }
  1564. /* Configure the SD DPSM (Data Path State Machine) */
  1565. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  1566. sdio_datainitstructure.DataLength = 64;
  1567. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_64B ;
  1568. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
  1569. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  1570. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  1571. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  1572. /* Send CMD6 switch mode */
  1573. sdio_cmdinitstructure.Argument = 0x80FFFF01;
  1574. sdio_cmdinitstructure.CmdIndex = SD_CMD_HS_SWITCH;
  1575. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1576. /* Check for error conditions */
  1577. errorstate = SD_CmdResp1Error(hsd, SD_CMD_HS_SWITCH);
  1578. if (errorstate != SD_OK)
  1579. {
  1580. return errorstate;
  1581. }
  1582. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))
  1583. {
  1584. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))
  1585. {
  1586. for (count = 0; count < 8; count++)
  1587. {
  1588. *(tempbuff + count) = SDIO_ReadFIFO(hsd->Instance);
  1589. }
  1590. tempbuff += 8;
  1591. }
  1592. }
  1593. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))
  1594. {
  1595. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  1596. errorstate = SD_DATA_TIMEOUT;
  1597. return errorstate;
  1598. }
  1599. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))
  1600. {
  1601. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  1602. errorstate = SD_DATA_CRC_FAIL;
  1603. return errorstate;
  1604. }
  1605. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR))
  1606. {
  1607. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);
  1608. errorstate = SD_RX_OVERRUN;
  1609. return errorstate;
  1610. }
  1611. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))
  1612. {
  1613. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  1614. errorstate = SD_START_BIT_ERR;
  1615. return errorstate;
  1616. }
  1617. else
  1618. {
  1619. /* No error flag set */
  1620. }
  1621. count = SD_DATATIMEOUT;
  1622. while ((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXDAVL)) && (count > 0))
  1623. {
  1624. *tempbuff = SDIO_ReadFIFO(hsd->Instance);
  1625. tempbuff++;
  1626. count--;
  1627. }
  1628. /* Clear all the static flags */
  1629. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  1630. /* Test if the switch mode HS is ok */
  1631. if ((SD_hs[13]& 2) != 2)
  1632. {
  1633. errorstate = SD_UNSUPPORTED_FEATURE;
  1634. }
  1635. }
  1636. return errorstate;
  1637. }
  1638. /**
  1639. * @}
  1640. */
  1641. /** @defgroup SD_Exported_Functions_Group4 Peripheral State functions
  1642. * @brief Peripheral State functions
  1643. *
  1644. @verbatim
  1645. ==============================================================================
  1646. ##### Peripheral State functions #####
  1647. ==============================================================================
  1648. [..]
  1649. This subsection permits to get in runtime the status of the peripheral
  1650. and the data flow.
  1651. @endverbatim
  1652. * @{
  1653. */
  1654. /**
  1655. * @brief Returns the current SD card's status.
  1656. * @param hsd: SD handle
  1657. * @param pSDstatus: Pointer to the buffer that will contain the SD card status
  1658. * SD Status register)
  1659. * @retval SD Card error state
  1660. */
  1661. HAL_SD_ErrorTypedef HAL_SD_SendSDStatus(SD_HandleTypeDef *hsd, uint32_t *pSDstatus)
  1662. {
  1663. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  1664. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  1665. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1666. uint32_t count = 0;
  1667. /* Check SD response */
  1668. if ((SDIO_GetResponse(hsd->Instance, SDIO_RESP1) & SD_CARD_LOCKED) == SD_CARD_LOCKED)
  1669. {
  1670. errorstate = SD_LOCK_UNLOCK_FAILED;
  1671. return errorstate;
  1672. }
  1673. /* Set block size for card if it is not equal to current block size for card */
  1674. sdio_cmdinitstructure.Argument = 64;
  1675. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  1676. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  1677. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  1678. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  1679. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1680. /* Check for error conditions */
  1681. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  1682. if (errorstate != SD_OK)
  1683. {
  1684. return errorstate;
  1685. }
  1686. /* Send CMD55 */
  1687. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  1688. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  1689. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1690. /* Check for error conditions */
  1691. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  1692. if (errorstate != SD_OK)
  1693. {
  1694. return errorstate;
  1695. }
  1696. /* Configure the SD DPSM (Data Path State Machine) */
  1697. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  1698. sdio_datainitstructure.DataLength = 64;
  1699. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_64B;
  1700. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
  1701. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  1702. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  1703. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  1704. /* Send ACMD13 (SD_APP_STAUS) with argument as card's RCA */
  1705. sdio_cmdinitstructure.Argument = 0;
  1706. sdio_cmdinitstructure.CmdIndex = SD_CMD_SD_APP_STATUS;
  1707. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1708. /* Check for error conditions */
  1709. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SD_APP_STATUS);
  1710. if (errorstate != SD_OK)
  1711. {
  1712. return errorstate;
  1713. }
  1714. /* Get status data */
  1715. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))
  1716. {
  1717. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXFIFOHF))
  1718. {
  1719. for (count = 0; count < 8; count++)
  1720. {
  1721. *(pSDstatus + count) = SDIO_ReadFIFO(hsd->Instance);
  1722. }
  1723. pSDstatus += 8;
  1724. }
  1725. }
  1726. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))
  1727. {
  1728. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  1729. errorstate = SD_DATA_TIMEOUT;
  1730. return errorstate;
  1731. }
  1732. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))
  1733. {
  1734. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  1735. errorstate = SD_DATA_CRC_FAIL;
  1736. return errorstate;
  1737. }
  1738. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR))
  1739. {
  1740. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);
  1741. errorstate = SD_RX_OVERRUN;
  1742. return errorstate;
  1743. }
  1744. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))
  1745. {
  1746. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  1747. errorstate = SD_START_BIT_ERR;
  1748. return errorstate;
  1749. }
  1750. else
  1751. {
  1752. /* No error flag set */
  1753. }
  1754. count = SD_DATATIMEOUT;
  1755. while ((__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXDAVL)) && (count > 0))
  1756. {
  1757. *pSDstatus = SDIO_ReadFIFO(hsd->Instance);
  1758. pSDstatus++;
  1759. count--;
  1760. }
  1761. /* Clear all the static status flags*/
  1762. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  1763. return errorstate;
  1764. }
  1765. /**
  1766. * @brief Gets the current sd card data status.
  1767. * @param hsd: SD handle
  1768. * @retval Data Transfer state
  1769. */
  1770. HAL_SD_TransferStateTypedef HAL_SD_GetStatus(SD_HandleTypeDef *hsd)
  1771. {
  1772. HAL_SD_CardStateTypedef cardstate = SD_CARD_TRANSFER;
  1773. /* Get SD card state */
  1774. cardstate = SD_GetState(hsd);
  1775. /* Find SD status according to card state*/
  1776. if (cardstate == SD_CARD_TRANSFER)
  1777. {
  1778. return SD_TRANSFER_OK;
  1779. }
  1780. else if(cardstate == SD_CARD_ERROR)
  1781. {
  1782. return SD_TRANSFER_ERROR;
  1783. }
  1784. else
  1785. {
  1786. return SD_TRANSFER_BUSY;
  1787. }
  1788. }
  1789. /**
  1790. * @brief Gets the SD card status.
  1791. * @param hsd: SD handle
  1792. * @param pCardStatus: Pointer to the HAL_SD_CardStatusTypedef structure that
  1793. * will contain the SD card status information
  1794. * @retval SD Card error state
  1795. */
  1796. HAL_SD_ErrorTypedef HAL_SD_GetCardStatus(SD_HandleTypeDef *hsd, HAL_SD_CardStatusTypedef *pCardStatus)
  1797. {
  1798. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1799. uint32_t tmp = 0;
  1800. uint32_t sd_status[16];
  1801. errorstate = HAL_SD_SendSDStatus(hsd, sd_status);
  1802. if (errorstate != SD_OK)
  1803. {
  1804. return errorstate;
  1805. }
  1806. /* Byte 0 */
  1807. tmp = (sd_status[0] & 0xC0) >> 6;
  1808. pCardStatus->DAT_BUS_WIDTH = (uint8_t)tmp;
  1809. /* Byte 0 */
  1810. tmp = (sd_status[0] & 0x20) >> 5;
  1811. pCardStatus->SECURED_MODE = (uint8_t)tmp;
  1812. /* Byte 2 */
  1813. tmp = (sd_status[2] & 0xFF);
  1814. pCardStatus->SD_CARD_TYPE = (uint8_t)(tmp << 8);
  1815. /* Byte 3 */
  1816. tmp = (sd_status[3] & 0xFF);
  1817. pCardStatus->SD_CARD_TYPE |= (uint8_t)tmp;
  1818. /* Byte 4 */
  1819. tmp = (sd_status[4] & 0xFF);
  1820. pCardStatus->SIZE_OF_PROTECTED_AREA = (uint8_t)(tmp << 24);
  1821. /* Byte 5 */
  1822. tmp = (sd_status[5] & 0xFF);
  1823. pCardStatus->SIZE_OF_PROTECTED_AREA |= (uint8_t)(tmp << 16);
  1824. /* Byte 6 */
  1825. tmp = (sd_status[6] & 0xFF);
  1826. pCardStatus->SIZE_OF_PROTECTED_AREA |= (uint8_t)(tmp << 8);
  1827. /* Byte 7 */
  1828. tmp = (sd_status[7] & 0xFF);
  1829. pCardStatus->SIZE_OF_PROTECTED_AREA |= (uint8_t)tmp;
  1830. /* Byte 8 */
  1831. tmp = (sd_status[8] & 0xFF);
  1832. pCardStatus->SPEED_CLASS = (uint8_t)tmp;
  1833. /* Byte 9 */
  1834. tmp = (sd_status[9] & 0xFF);
  1835. pCardStatus->PERFORMANCE_MOVE = (uint8_t)tmp;
  1836. /* Byte 10 */
  1837. tmp = (sd_status[10] & 0xF0) >> 4;
  1838. pCardStatus->AU_SIZE = (uint8_t)tmp;
  1839. /* Byte 11 */
  1840. tmp = (sd_status[11] & 0xFF);
  1841. pCardStatus->ERASE_SIZE = (uint8_t)(tmp << 8);
  1842. /* Byte 12 */
  1843. tmp = (sd_status[12] & 0xFF);
  1844. pCardStatus->ERASE_SIZE |= (uint8_t)tmp;
  1845. /* Byte 13 */
  1846. tmp = (sd_status[13] & 0xFC) >> 2;
  1847. pCardStatus->ERASE_TIMEOUT = (uint8_t)tmp;
  1848. /* Byte 13 */
  1849. tmp = (sd_status[13] & 0x3);
  1850. pCardStatus->ERASE_OFFSET = (uint8_t)tmp;
  1851. return errorstate;
  1852. }
  1853. /**
  1854. * @}
  1855. */
  1856. /**
  1857. * @}
  1858. */
  1859. /** @addtogroup SD_Private_Functions
  1860. * @{
  1861. */
  1862. /**
  1863. * @brief SD DMA transfer complete Rx callback.
  1864. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1865. * the configuration information for the specified DMA module.
  1866. * @retval None
  1867. */
  1868. static void SD_DMA_RxCplt(DMA_HandleTypeDef *hdma)
  1869. {
  1870. SD_HandleTypeDef *hsd = (SD_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
  1871. /* DMA transfer is complete */
  1872. hsd->DmaTransferCplt = 1;
  1873. /* Wait until SD transfer is complete */
  1874. while(hsd->SdTransferCplt == 0)
  1875. {
  1876. }
  1877. /* Transfer complete user callback */
  1878. HAL_SD_DMA_RxCpltCallback(hsd->hdmarx);
  1879. }
  1880. /**
  1881. * @brief SD DMA transfer Error Rx callback.
  1882. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1883. * the configuration information for the specified DMA module.
  1884. * @retval None
  1885. */
  1886. static void SD_DMA_RxError(DMA_HandleTypeDef *hdma)
  1887. {
  1888. SD_HandleTypeDef *hsd = (SD_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
  1889. /* Transfer complete user callback */
  1890. HAL_SD_DMA_RxErrorCallback(hsd->hdmarx);
  1891. }
  1892. /**
  1893. * @brief SD DMA transfer complete Tx callback.
  1894. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1895. * the configuration information for the specified DMA module.
  1896. * @retval None
  1897. */
  1898. static void SD_DMA_TxCplt(DMA_HandleTypeDef *hdma)
  1899. {
  1900. SD_HandleTypeDef *hsd = (SD_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
  1901. /* DMA transfer is complete */
  1902. hsd->DmaTransferCplt = 1;
  1903. /* Wait until SD transfer is complete */
  1904. while(hsd->SdTransferCplt == 0)
  1905. {
  1906. }
  1907. /* Transfer complete user callback */
  1908. HAL_SD_DMA_TxCpltCallback(hsd->hdmatx);
  1909. }
  1910. /**
  1911. * @brief SD DMA transfer Error Tx callback.
  1912. * @param hdma: pointer to a DMA_HandleTypeDef structure that contains
  1913. * the configuration information for the specified DMA module.
  1914. * @retval None
  1915. */
  1916. static void SD_DMA_TxError(DMA_HandleTypeDef *hdma)
  1917. {
  1918. SD_HandleTypeDef *hsd = ( SD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
  1919. /* Transfer complete user callback */
  1920. HAL_SD_DMA_TxErrorCallback(hsd->hdmatx);
  1921. }
  1922. /**
  1923. * @brief Returns the SD current state.
  1924. * @param hsd: SD handle
  1925. * @retval SD card current state
  1926. */
  1927. static HAL_SD_CardStateTypedef SD_GetState(SD_HandleTypeDef *hsd)
  1928. {
  1929. uint32_t resp1 = 0;
  1930. if (SD_SendStatus(hsd, &resp1) != SD_OK)
  1931. {
  1932. return SD_CARD_ERROR;
  1933. }
  1934. else
  1935. {
  1936. return (HAL_SD_CardStateTypedef)((resp1 >> 9) & 0x0F);
  1937. }
  1938. }
  1939. /**
  1940. * @brief Initializes all cards or single card as the case may be Card(s) come
  1941. * into standby state.
  1942. * @param hsd: SD handle
  1943. * @retval SD Card error state
  1944. */
  1945. static HAL_SD_ErrorTypedef SD_Initialize_Cards(SD_HandleTypeDef *hsd)
  1946. {
  1947. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  1948. HAL_SD_ErrorTypedef errorstate = SD_OK;
  1949. uint16_t sd_rca = 1;
  1950. if(SDIO_GetPowerState(hsd->Instance) == 0) /* Power off */
  1951. {
  1952. errorstate = SD_REQUEST_NOT_APPLICABLE;
  1953. return errorstate;
  1954. }
  1955. if(hsd->CardType != SECURE_DIGITAL_IO_CARD)
  1956. {
  1957. /* Send CMD2 ALL_SEND_CID */
  1958. sdio_cmdinitstructure.Argument = 0;
  1959. sdio_cmdinitstructure.CmdIndex = SD_CMD_ALL_SEND_CID;
  1960. sdio_cmdinitstructure.Response = SDIO_RESPONSE_LONG;
  1961. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  1962. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  1963. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1964. /* Check for error conditions */
  1965. errorstate = SD_CmdResp2Error(hsd);
  1966. if(errorstate != SD_OK)
  1967. {
  1968. return errorstate;
  1969. }
  1970. /* Get Card identification number data */
  1971. hsd->CID[0] = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  1972. hsd->CID[1] = SDIO_GetResponse(hsd->Instance, SDIO_RESP2);
  1973. hsd->CID[2] = SDIO_GetResponse(hsd->Instance, SDIO_RESP3);
  1974. hsd->CID[3] = SDIO_GetResponse(hsd->Instance, SDIO_RESP4);
  1975. }
  1976. if((hsd->CardType == STD_CAPACITY_SD_CARD_V1_1) || (hsd->CardType == STD_CAPACITY_SD_CARD_V2_0) ||\
  1977. (hsd->CardType == SECURE_DIGITAL_IO_COMBO_CARD) || (hsd->CardType == HIGH_CAPACITY_SD_CARD))
  1978. {
  1979. /* Send CMD3 SET_REL_ADDR with argument 0 */
  1980. /* SD Card publishes its RCA. */
  1981. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_REL_ADDR;
  1982. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  1983. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  1984. /* Check for error conditions */
  1985. errorstate = SD_CmdResp6Error(hsd, SD_CMD_SET_REL_ADDR, &sd_rca);
  1986. if(errorstate != SD_OK)
  1987. {
  1988. return errorstate;
  1989. }
  1990. }
  1991. if (hsd->CardType != SECURE_DIGITAL_IO_CARD)
  1992. {
  1993. /* Get the SD card RCA */
  1994. hsd->RCA = sd_rca;
  1995. /* Send CMD9 SEND_CSD with argument as card's RCA */
  1996. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  1997. sdio_cmdinitstructure.CmdIndex = SD_CMD_SEND_CSD;
  1998. sdio_cmdinitstructure.Response = SDIO_RESPONSE_LONG;
  1999. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2000. /* Check for error conditions */
  2001. errorstate = SD_CmdResp2Error(hsd);
  2002. if(errorstate != SD_OK)
  2003. {
  2004. return errorstate;
  2005. }
  2006. /* Get Card Specific Data */
  2007. hsd->CSD[0] = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2008. hsd->CSD[1] = SDIO_GetResponse(hsd->Instance, SDIO_RESP2);
  2009. hsd->CSD[2] = SDIO_GetResponse(hsd->Instance, SDIO_RESP3);
  2010. hsd->CSD[3] = SDIO_GetResponse(hsd->Instance, SDIO_RESP4);
  2011. }
  2012. /* All cards are initialized */
  2013. return errorstate;
  2014. }
  2015. /**
  2016. * @brief Selects od Deselects the corresponding card.
  2017. * @param hsd: SD handle
  2018. * @param Addr: Address of the card to be selected
  2019. * @retval SD Card error state
  2020. */
  2021. static HAL_SD_ErrorTypedef SD_Select_Deselect(SD_HandleTypeDef *hsd, uint64_t Addr)
  2022. {
  2023. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2024. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2025. /* Send CMD7 SDIO_SEL_DESEL_CARD */
  2026. sdio_cmdinitstructure.Argument = (uint32_t)Addr;
  2027. sdio_cmdinitstructure.CmdIndex = SD_CMD_SEL_DESEL_CARD;
  2028. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2029. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2030. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2031. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2032. /* Check for error conditions */
  2033. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SEL_DESEL_CARD);
  2034. return errorstate;
  2035. }
  2036. /**
  2037. * @brief Enquires cards about their operating voltage and configures clock
  2038. * controls and stores SD information that will be needed in future
  2039. * in the SD handle.
  2040. * @param hsd: SD handle
  2041. * @retval SD Card error state
  2042. */
  2043. static HAL_SD_ErrorTypedef SD_PowerON(SD_HandleTypeDef *hsd)
  2044. {
  2045. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2046. __IO HAL_SD_ErrorTypedef errorstate = SD_OK;
  2047. uint32_t response = 0, count = 0, validvoltage = 0;
  2048. uint32_t sdtype = SD_STD_CAPACITY;
  2049. /* Power ON Sequence -------------------------------------------------------*/
  2050. /* Disable SDIO Clock */
  2051. __HAL_SD_SDIO_DISABLE(hsd);
  2052. /* Set Power State to ON */
  2053. SDIO_PowerState_ON(hsd->Instance);
  2054. /* 1ms: required power up waiting time before starting the SD initialization
  2055. sequence */
  2056. HAL_Delay(1);
  2057. /* Enable SDIO Clock */
  2058. __HAL_SD_SDIO_ENABLE(hsd);
  2059. /* CMD0: GO_IDLE_STATE -----------------------------------------------------*/
  2060. /* No CMD response required */
  2061. sdio_cmdinitstructure.Argument = 0;
  2062. sdio_cmdinitstructure.CmdIndex = SD_CMD_GO_IDLE_STATE;
  2063. sdio_cmdinitstructure.Response = SDIO_RESPONSE_NO;
  2064. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2065. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2066. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2067. /* Check for error conditions */
  2068. errorstate = SD_CmdError(hsd);
  2069. if(errorstate != SD_OK)
  2070. {
  2071. /* CMD Response TimeOut (wait for CMDSENT flag) */
  2072. return errorstate;
  2073. }
  2074. /* CMD8: SEND_IF_COND ------------------------------------------------------*/
  2075. /* Send CMD8 to verify SD card interface operating condition */
  2076. /* Argument: - [31:12]: Reserved (shall be set to '0')
  2077. - [11:8]: Supply Voltage (VHS) 0x1 (Range: 2.7-3.6 V)
  2078. - [7:0]: Check Pattern (recommended 0xAA) */
  2079. /* CMD Response: R7 */
  2080. sdio_cmdinitstructure.Argument = SD_CHECK_PATTERN;
  2081. sdio_cmdinitstructure.CmdIndex = SD_SDIO_SEND_IF_COND;
  2082. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2083. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2084. /* Check for error conditions */
  2085. errorstate = SD_CmdResp7Error(hsd);
  2086. if (errorstate == SD_OK)
  2087. {
  2088. /* SD Card 2.0 */
  2089. hsd->CardType = STD_CAPACITY_SD_CARD_V2_0;
  2090. sdtype = SD_HIGH_CAPACITY;
  2091. }
  2092. /* Send CMD55 */
  2093. sdio_cmdinitstructure.Argument = 0;
  2094. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  2095. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2096. /* Check for error conditions */
  2097. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  2098. /* If errorstate is Command TimeOut, it is a MMC card */
  2099. /* If errorstate is SD_OK it is a SD card: SD card 2.0 (voltage range mismatch)
  2100. or SD card 1.x */
  2101. if(errorstate == SD_OK)
  2102. {
  2103. /* SD CARD */
  2104. /* Send ACMD41 SD_APP_OP_COND with Argument 0x80100000 */
  2105. while((!validvoltage) && (count < SD_MAX_VOLT_TRIAL))
  2106. {
  2107. /* SEND CMD55 APP_CMD with RCA as 0 */
  2108. sdio_cmdinitstructure.Argument = 0;
  2109. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  2110. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2111. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2112. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2113. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2114. /* Check for error conditions */
  2115. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  2116. if(errorstate != SD_OK)
  2117. {
  2118. return errorstate;
  2119. }
  2120. /* Send CMD41 */
  2121. sdio_cmdinitstructure.Argument = SD_VOLTAGE_WINDOW_SD | sdtype;
  2122. sdio_cmdinitstructure.CmdIndex = SD_CMD_SD_APP_OP_COND;
  2123. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2124. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2125. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2126. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2127. /* Check for error conditions */
  2128. errorstate = SD_CmdResp3Error(hsd);
  2129. if(errorstate != SD_OK)
  2130. {
  2131. return errorstate;
  2132. }
  2133. /* Get command response */
  2134. response = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2135. /* Get operating voltage*/
  2136. validvoltage = (((response >> 31) == 1) ? 1 : 0);
  2137. count++;
  2138. }
  2139. if(count >= SD_MAX_VOLT_TRIAL)
  2140. {
  2141. errorstate = SD_INVALID_VOLTRANGE;
  2142. return errorstate;
  2143. }
  2144. if((response & SD_HIGH_CAPACITY) == SD_HIGH_CAPACITY) /* (response &= SD_HIGH_CAPACITY) */
  2145. {
  2146. hsd->CardType = HIGH_CAPACITY_SD_CARD;
  2147. }
  2148. } /* else MMC Card */
  2149. return errorstate;
  2150. }
  2151. /**
  2152. * @brief Turns the SDIO output signals off.
  2153. * @param hsd: SD handle
  2154. * @retval SD Card error state
  2155. */
  2156. static HAL_SD_ErrorTypedef SD_PowerOFF(SD_HandleTypeDef *hsd)
  2157. {
  2158. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2159. /* Set Power State to OFF */
  2160. SDIO_PowerState_OFF(hsd->Instance);
  2161. return errorstate;
  2162. }
  2163. /**
  2164. * @brief Returns the current card's status.
  2165. * @param hsd: SD handle
  2166. * @param pCardStatus: pointer to the buffer that will contain the SD card
  2167. * status (Card Status register)
  2168. * @retval SD Card error state
  2169. */
  2170. static HAL_SD_ErrorTypedef SD_SendStatus(SD_HandleTypeDef *hsd, uint32_t *pCardStatus)
  2171. {
  2172. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2173. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2174. if(pCardStatus == NULL)
  2175. {
  2176. errorstate = SD_INVALID_PARAMETER;
  2177. return errorstate;
  2178. }
  2179. /* Send Status command */
  2180. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  2181. sdio_cmdinitstructure.CmdIndex = SD_CMD_SEND_STATUS;
  2182. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2183. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2184. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2185. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2186. /* Check for error conditions */
  2187. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SEND_STATUS);
  2188. if(errorstate != SD_OK)
  2189. {
  2190. return errorstate;
  2191. }
  2192. /* Get SD card status */
  2193. *pCardStatus = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2194. return errorstate;
  2195. }
  2196. /**
  2197. * @brief Checks for error conditions for CMD0.
  2198. * @param hsd: SD handle
  2199. * @retval SD Card error state
  2200. */
  2201. static HAL_SD_ErrorTypedef SD_CmdError(SD_HandleTypeDef *hsd)
  2202. {
  2203. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2204. uint32_t timeout = SDIO_CMD0TIMEOUT, tmp;
  2205. tmp = __HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CMDSENT);
  2206. while((timeout > 0) && (!tmp))
  2207. {
  2208. tmp = __HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CMDSENT);
  2209. timeout--;
  2210. }
  2211. if(timeout == 0)
  2212. {
  2213. errorstate = SD_CMD_RSP_TIMEOUT;
  2214. return errorstate;
  2215. }
  2216. /* Clear all the static flags */
  2217. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2218. return errorstate;
  2219. }
  2220. /**
  2221. * @brief Checks for error conditions for R7 response.
  2222. * @param hsd: SD handle
  2223. * @retval SD Card error state
  2224. */
  2225. static HAL_SD_ErrorTypedef SD_CmdResp7Error(SD_HandleTypeDef *hsd)
  2226. {
  2227. HAL_SD_ErrorTypedef errorstate = SD_ERROR;
  2228. uint32_t timeout = SDIO_CMD0TIMEOUT, tmp;
  2229. tmp = __HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT);
  2230. while((!tmp) && (timeout > 0))
  2231. {
  2232. tmp = __HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT);
  2233. timeout--;
  2234. }
  2235. tmp = __HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2236. if((timeout == 0) || tmp)
  2237. {
  2238. /* Card is not V2.0 compliant or card does not support the set voltage range */
  2239. errorstate = SD_CMD_RSP_TIMEOUT;
  2240. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2241. return errorstate;
  2242. }
  2243. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CMDREND))
  2244. {
  2245. /* Card is SD V2.0 compliant */
  2246. errorstate = SD_OK;
  2247. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CMDREND);
  2248. return errorstate;
  2249. }
  2250. return errorstate;
  2251. }
  2252. /**
  2253. * @brief Checks for error conditions for R1 response.
  2254. * @param hsd: SD handle
  2255. * @param SD_CMD: The sent command index
  2256. * @retval SD Card error state
  2257. */
  2258. static HAL_SD_ErrorTypedef SD_CmdResp1Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD)
  2259. {
  2260. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2261. uint32_t response_r1 = 0;
  2262. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT))
  2263. {
  2264. }
  2265. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT))
  2266. {
  2267. errorstate = SD_CMD_RSP_TIMEOUT;
  2268. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2269. return errorstate;
  2270. }
  2271. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL))
  2272. {
  2273. errorstate = SD_CMD_CRC_FAIL;
  2274. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CCRCFAIL);
  2275. return errorstate;
  2276. }
  2277. else
  2278. {
  2279. /* No error flag set */
  2280. }
  2281. /* Check response received is of desired command */
  2282. if(SDIO_GetCommandResponse(hsd->Instance) != SD_CMD)
  2283. {
  2284. errorstate = SD_ILLEGAL_CMD;
  2285. return errorstate;
  2286. }
  2287. /* Clear all the static flags */
  2288. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2289. /* We have received response, retrieve it for analysis */
  2290. response_r1 = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2291. if((response_r1 & SD_OCR_ERRORBITS) == SD_ALLZERO)
  2292. {
  2293. return errorstate;
  2294. }
  2295. if((response_r1 & SD_OCR_ADDR_OUT_OF_RANGE) == SD_OCR_ADDR_OUT_OF_RANGE)
  2296. {
  2297. return(SD_ADDR_OUT_OF_RANGE);
  2298. }
  2299. if((response_r1 & SD_OCR_ADDR_MISALIGNED) == SD_OCR_ADDR_MISALIGNED)
  2300. {
  2301. return(SD_ADDR_MISALIGNED);
  2302. }
  2303. if((response_r1 & SD_OCR_BLOCK_LEN_ERR) == SD_OCR_BLOCK_LEN_ERR)
  2304. {
  2305. return(SD_BLOCK_LEN_ERR);
  2306. }
  2307. if((response_r1 & SD_OCR_ERASE_SEQ_ERR) == SD_OCR_ERASE_SEQ_ERR)
  2308. {
  2309. return(SD_ERASE_SEQ_ERR);
  2310. }
  2311. if((response_r1 & SD_OCR_BAD_ERASE_PARAM) == SD_OCR_BAD_ERASE_PARAM)
  2312. {
  2313. return(SD_BAD_ERASE_PARAM);
  2314. }
  2315. if((response_r1 & SD_OCR_WRITE_PROT_VIOLATION) == SD_OCR_WRITE_PROT_VIOLATION)
  2316. {
  2317. return(SD_WRITE_PROT_VIOLATION);
  2318. }
  2319. if((response_r1 & SD_OCR_LOCK_UNLOCK_FAILED) == SD_OCR_LOCK_UNLOCK_FAILED)
  2320. {
  2321. return(SD_LOCK_UNLOCK_FAILED);
  2322. }
  2323. if((response_r1 & SD_OCR_COM_CRC_FAILED) == SD_OCR_COM_CRC_FAILED)
  2324. {
  2325. return(SD_COM_CRC_FAILED);
  2326. }
  2327. if((response_r1 & SD_OCR_ILLEGAL_CMD) == SD_OCR_ILLEGAL_CMD)
  2328. {
  2329. return(SD_ILLEGAL_CMD);
  2330. }
  2331. if((response_r1 & SD_OCR_CARD_ECC_FAILED) == SD_OCR_CARD_ECC_FAILED)
  2332. {
  2333. return(SD_CARD_ECC_FAILED);
  2334. }
  2335. if((response_r1 & SD_OCR_CC_ERROR) == SD_OCR_CC_ERROR)
  2336. {
  2337. return(SD_CC_ERROR);
  2338. }
  2339. if((response_r1 & SD_OCR_GENERAL_UNKNOWN_ERROR) == SD_OCR_GENERAL_UNKNOWN_ERROR)
  2340. {
  2341. return(SD_GENERAL_UNKNOWN_ERROR);
  2342. }
  2343. if((response_r1 & SD_OCR_STREAM_READ_UNDERRUN) == SD_OCR_STREAM_READ_UNDERRUN)
  2344. {
  2345. return(SD_STREAM_READ_UNDERRUN);
  2346. }
  2347. if((response_r1 & SD_OCR_STREAM_WRITE_OVERRUN) == SD_OCR_STREAM_WRITE_OVERRUN)
  2348. {
  2349. return(SD_STREAM_WRITE_OVERRUN);
  2350. }
  2351. if((response_r1 & SD_OCR_CID_CSD_OVERWRITE) == SD_OCR_CID_CSD_OVERWRITE)
  2352. {
  2353. return(SD_CID_CSD_OVERWRITE);
  2354. }
  2355. if((response_r1 & SD_OCR_WP_ERASE_SKIP) == SD_OCR_WP_ERASE_SKIP)
  2356. {
  2357. return(SD_WP_ERASE_SKIP);
  2358. }
  2359. if((response_r1 & SD_OCR_CARD_ECC_DISABLED) == SD_OCR_CARD_ECC_DISABLED)
  2360. {
  2361. return(SD_CARD_ECC_DISABLED);
  2362. }
  2363. if((response_r1 & SD_OCR_ERASE_RESET) == SD_OCR_ERASE_RESET)
  2364. {
  2365. return(SD_ERASE_RESET);
  2366. }
  2367. if((response_r1 & SD_OCR_AKE_SEQ_ERROR) == SD_OCR_AKE_SEQ_ERROR)
  2368. {
  2369. return(SD_AKE_SEQ_ERROR);
  2370. }
  2371. return errorstate;
  2372. }
  2373. /**
  2374. * @brief Checks for error conditions for R3 (OCR) response.
  2375. * @param hsd: SD handle
  2376. * @retval SD Card error state
  2377. */
  2378. static HAL_SD_ErrorTypedef SD_CmdResp3Error(SD_HandleTypeDef *hsd)
  2379. {
  2380. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2381. while (!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT))
  2382. {
  2383. }
  2384. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT))
  2385. {
  2386. errorstate = SD_CMD_RSP_TIMEOUT;
  2387. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2388. return errorstate;
  2389. }
  2390. /* Clear all the static flags */
  2391. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2392. return errorstate;
  2393. }
  2394. /**
  2395. * @brief Checks for error conditions for R2 (CID or CSD) response.
  2396. * @param hsd: SD handle
  2397. * @retval SD Card error state
  2398. */
  2399. static HAL_SD_ErrorTypedef SD_CmdResp2Error(SD_HandleTypeDef *hsd)
  2400. {
  2401. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2402. while (!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT))
  2403. {
  2404. }
  2405. if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT))
  2406. {
  2407. errorstate = SD_CMD_RSP_TIMEOUT;
  2408. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2409. return errorstate;
  2410. }
  2411. else if (__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL))
  2412. {
  2413. errorstate = SD_CMD_CRC_FAIL;
  2414. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CCRCFAIL);
  2415. return errorstate;
  2416. }
  2417. else
  2418. {
  2419. /* No error flag set */
  2420. }
  2421. /* Clear all the static flags */
  2422. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2423. return errorstate;
  2424. }
  2425. /**
  2426. * @brief Checks for error conditions for R6 (RCA) response.
  2427. * @param hsd: SD handle
  2428. * @param SD_CMD: The sent command index
  2429. * @param pRCA: Pointer to the variable that will contain the SD card relative
  2430. * address RCA
  2431. * @retval SD Card error state
  2432. */
  2433. static HAL_SD_ErrorTypedef SD_CmdResp6Error(SD_HandleTypeDef *hsd, uint8_t SD_CMD, uint16_t *pRCA)
  2434. {
  2435. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2436. uint32_t response_r1 = 0;
  2437. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT))
  2438. {
  2439. }
  2440. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT))
  2441. {
  2442. errorstate = SD_CMD_RSP_TIMEOUT;
  2443. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2444. return errorstate;
  2445. }
  2446. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL))
  2447. {
  2448. errorstate = SD_CMD_CRC_FAIL;
  2449. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CCRCFAIL);
  2450. return errorstate;
  2451. }
  2452. else
  2453. {
  2454. /* No error flag set */
  2455. }
  2456. /* Check response received is of desired command */
  2457. if(SDIO_GetCommandResponse(hsd->Instance) != SD_CMD)
  2458. {
  2459. errorstate = SD_ILLEGAL_CMD;
  2460. return errorstate;
  2461. }
  2462. /* Clear all the static flags */
  2463. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2464. /* We have received response, retrieve it. */
  2465. response_r1 = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2466. if((response_r1 & (SD_R6_GENERAL_UNKNOWN_ERROR | SD_R6_ILLEGAL_CMD | SD_R6_COM_CRC_FAILED)) == SD_ALLZERO)
  2467. {
  2468. *pRCA = (uint16_t) (response_r1 >> 16);
  2469. return errorstate;
  2470. }
  2471. if((response_r1 & SD_R6_GENERAL_UNKNOWN_ERROR) == SD_R6_GENERAL_UNKNOWN_ERROR)
  2472. {
  2473. return(SD_GENERAL_UNKNOWN_ERROR);
  2474. }
  2475. if((response_r1 & SD_R6_ILLEGAL_CMD) == SD_R6_ILLEGAL_CMD)
  2476. {
  2477. return(SD_ILLEGAL_CMD);
  2478. }
  2479. if((response_r1 & SD_R6_COM_CRC_FAILED) == SD_R6_COM_CRC_FAILED)
  2480. {
  2481. return(SD_COM_CRC_FAILED);
  2482. }
  2483. return errorstate;
  2484. }
  2485. /**
  2486. * @brief Enables the SDIO wide bus mode.
  2487. * @param hsd: SD handle
  2488. * @retval SD Card error state
  2489. */
  2490. static HAL_SD_ErrorTypedef SD_WideBus_Enable(SD_HandleTypeDef *hsd)
  2491. {
  2492. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2493. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2494. uint32_t scr[2] = {0, 0};
  2495. if((SDIO_GetResponse(hsd->Instance, SDIO_RESP1) & SD_CARD_LOCKED) == SD_CARD_LOCKED)
  2496. {
  2497. errorstate = SD_LOCK_UNLOCK_FAILED;
  2498. return errorstate;
  2499. }
  2500. /* Get SCR Register */
  2501. errorstate = SD_FindSCR(hsd, scr);
  2502. if(errorstate != SD_OK)
  2503. {
  2504. return errorstate;
  2505. }
  2506. /* If requested card supports wide bus operation */
  2507. if((scr[1] & SD_WIDE_BUS_SUPPORT) != SD_ALLZERO)
  2508. {
  2509. /* Send CMD55 APP_CMD with argument as card's RCA.*/
  2510. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  2511. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  2512. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2513. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2514. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2515. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2516. /* Check for error conditions */
  2517. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  2518. if(errorstate != SD_OK)
  2519. {
  2520. return errorstate;
  2521. }
  2522. /* Send ACMD6 APP_CMD with argument as 2 for wide bus mode */
  2523. sdio_cmdinitstructure.Argument = 2;
  2524. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_SD_SET_BUSWIDTH;
  2525. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2526. /* Check for error conditions */
  2527. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_SD_SET_BUSWIDTH);
  2528. if(errorstate != SD_OK)
  2529. {
  2530. return errorstate;
  2531. }
  2532. return errorstate;
  2533. }
  2534. else
  2535. {
  2536. errorstate = SD_REQUEST_NOT_APPLICABLE;
  2537. return errorstate;
  2538. }
  2539. }
  2540. /**
  2541. * @brief Disables the SDIO wide bus mode.
  2542. * @param hsd: SD handle
  2543. * @retval SD Card error state
  2544. */
  2545. static HAL_SD_ErrorTypedef SD_WideBus_Disable(SD_HandleTypeDef *hsd)
  2546. {
  2547. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2548. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2549. uint32_t scr[2] = {0, 0};
  2550. if((SDIO_GetResponse(hsd->Instance, SDIO_RESP1) & SD_CARD_LOCKED) == SD_CARD_LOCKED)
  2551. {
  2552. errorstate = SD_LOCK_UNLOCK_FAILED;
  2553. return errorstate;
  2554. }
  2555. /* Get SCR Register */
  2556. errorstate = SD_FindSCR(hsd, scr);
  2557. if(errorstate != SD_OK)
  2558. {
  2559. return errorstate;
  2560. }
  2561. /* If requested card supports 1 bit mode operation */
  2562. if((scr[1] & SD_SINGLE_BUS_SUPPORT) != SD_ALLZERO)
  2563. {
  2564. /* Send CMD55 APP_CMD with argument as card's RCA */
  2565. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  2566. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  2567. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2568. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2569. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2570. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2571. /* Check for error conditions */
  2572. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  2573. if(errorstate != SD_OK)
  2574. {
  2575. return errorstate;
  2576. }
  2577. /* Send ACMD6 APP_CMD with argument as 0 for single bus mode */
  2578. sdio_cmdinitstructure.Argument = 0;
  2579. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_SD_SET_BUSWIDTH;
  2580. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2581. /* Check for error conditions */
  2582. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_SD_SET_BUSWIDTH);
  2583. if(errorstate != SD_OK)
  2584. {
  2585. return errorstate;
  2586. }
  2587. return errorstate;
  2588. }
  2589. else
  2590. {
  2591. errorstate = SD_REQUEST_NOT_APPLICABLE;
  2592. return errorstate;
  2593. }
  2594. }
  2595. /**
  2596. * @brief Finds the SD card SCR register value.
  2597. * @param hsd: SD handle
  2598. * @param pSCR: pointer to the buffer that will contain the SCR value
  2599. * @retval SD Card error state
  2600. */
  2601. static HAL_SD_ErrorTypedef SD_FindSCR(SD_HandleTypeDef *hsd, uint32_t *pSCR)
  2602. {
  2603. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2604. SDIO_DataInitTypeDef sdio_datainitstructure = {0};
  2605. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2606. uint32_t index = 0;
  2607. uint32_t tempscr[2] = {0, 0};
  2608. /* Set Block Size To 8 Bytes */
  2609. /* Send CMD55 APP_CMD with argument as card's RCA */
  2610. sdio_cmdinitstructure.Argument = (uint32_t)8;
  2611. sdio_cmdinitstructure.CmdIndex = SD_CMD_SET_BLOCKLEN;
  2612. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2613. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2614. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2615. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2616. /* Check for error conditions */
  2617. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SET_BLOCKLEN);
  2618. if(errorstate != SD_OK)
  2619. {
  2620. return errorstate;
  2621. }
  2622. /* Send CMD55 APP_CMD with argument as card's RCA */
  2623. sdio_cmdinitstructure.Argument = (uint32_t)((hsd->RCA) << 16);
  2624. sdio_cmdinitstructure.CmdIndex = SD_CMD_APP_CMD;
  2625. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2626. /* Check for error conditions */
  2627. errorstate = SD_CmdResp1Error(hsd, SD_CMD_APP_CMD);
  2628. if(errorstate != SD_OK)
  2629. {
  2630. return errorstate;
  2631. }
  2632. sdio_datainitstructure.DataTimeOut = SD_DATATIMEOUT;
  2633. sdio_datainitstructure.DataLength = 8;
  2634. sdio_datainitstructure.DataBlockSize = SDIO_DATABLOCK_SIZE_8B;
  2635. sdio_datainitstructure.TransferDir = SDIO_TRANSFER_DIR_TO_SDIO;
  2636. sdio_datainitstructure.TransferMode = SDIO_TRANSFER_MODE_BLOCK;
  2637. sdio_datainitstructure.DPSM = SDIO_DPSM_ENABLE;
  2638. SDIO_DataConfig(hsd->Instance, &sdio_datainitstructure);
  2639. /* Send ACMD51 SD_APP_SEND_SCR with argument as 0 */
  2640. sdio_cmdinitstructure.Argument = 0;
  2641. sdio_cmdinitstructure.CmdIndex = SD_CMD_SD_APP_SEND_SCR;
  2642. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2643. /* Check for error conditions */
  2644. errorstate = SD_CmdResp1Error(hsd, SD_CMD_SD_APP_SEND_SCR);
  2645. if(errorstate != SD_OK)
  2646. {
  2647. return errorstate;
  2648. }
  2649. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR | SDIO_FLAG_DCRCFAIL | SDIO_FLAG_DTIMEOUT | SDIO_FLAG_DBCKEND | SDIO_FLAG_STBITERR))
  2650. {
  2651. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXDAVL))
  2652. {
  2653. *(tempscr + index) = SDIO_ReadFIFO(hsd->Instance);
  2654. index++;
  2655. }
  2656. }
  2657. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DTIMEOUT))
  2658. {
  2659. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DTIMEOUT);
  2660. errorstate = SD_DATA_TIMEOUT;
  2661. return errorstate;
  2662. }
  2663. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_DCRCFAIL))
  2664. {
  2665. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_DCRCFAIL);
  2666. errorstate = SD_DATA_CRC_FAIL;
  2667. return errorstate;
  2668. }
  2669. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_RXOVERR))
  2670. {
  2671. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_RXOVERR);
  2672. errorstate = SD_RX_OVERRUN;
  2673. return errorstate;
  2674. }
  2675. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_STBITERR))
  2676. {
  2677. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_STBITERR);
  2678. errorstate = SD_START_BIT_ERR;
  2679. return errorstate;
  2680. }
  2681. else
  2682. {
  2683. /* No error flag set */
  2684. }
  2685. /* Clear all the static flags */
  2686. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2687. *(pSCR + 1) = ((tempscr[0] & SD_0TO7BITS) << 24) | ((tempscr[0] & SD_8TO15BITS) << 8) |\
  2688. ((tempscr[0] & SD_16TO23BITS) >> 8) | ((tempscr[0] & SD_24TO31BITS) >> 24);
  2689. *(pSCR) = ((tempscr[1] & SD_0TO7BITS) << 24) | ((tempscr[1] & SD_8TO15BITS) << 8) |\
  2690. ((tempscr[1] & SD_16TO23BITS) >> 8) | ((tempscr[1] & SD_24TO31BITS) >> 24);
  2691. return errorstate;
  2692. }
  2693. /**
  2694. * @brief Checks if the SD card is in programming state.
  2695. * @param hsd: SD handle
  2696. * @param pStatus: pointer to the variable that will contain the SD card state
  2697. * @retval SD Card error state
  2698. */
  2699. static HAL_SD_ErrorTypedef SD_IsCardProgramming(SD_HandleTypeDef *hsd, uint8_t *pStatus)
  2700. {
  2701. SDIO_CmdInitTypeDef sdio_cmdinitstructure = {0};
  2702. HAL_SD_ErrorTypedef errorstate = SD_OK;
  2703. __IO uint32_t responseR1 = 0;
  2704. sdio_cmdinitstructure.Argument = (uint32_t)(hsd->RCA << 16);
  2705. sdio_cmdinitstructure.CmdIndex = SD_CMD_SEND_STATUS;
  2706. sdio_cmdinitstructure.Response = SDIO_RESPONSE_SHORT;
  2707. sdio_cmdinitstructure.WaitForInterrupt = SDIO_WAIT_NO;
  2708. sdio_cmdinitstructure.CPSM = SDIO_CPSM_ENABLE;
  2709. SDIO_SendCommand(hsd->Instance, &sdio_cmdinitstructure);
  2710. while(!__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL | SDIO_FLAG_CMDREND | SDIO_FLAG_CTIMEOUT))
  2711. {
  2712. }
  2713. if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CTIMEOUT))
  2714. {
  2715. errorstate = SD_CMD_RSP_TIMEOUT;
  2716. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CTIMEOUT);
  2717. return errorstate;
  2718. }
  2719. else if(__HAL_SD_SDIO_GET_FLAG(hsd, SDIO_FLAG_CCRCFAIL))
  2720. {
  2721. errorstate = SD_CMD_CRC_FAIL;
  2722. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_FLAG_CCRCFAIL);
  2723. return errorstate;
  2724. }
  2725. else
  2726. {
  2727. /* No error flag set */
  2728. }
  2729. /* Check response received is of desired command */
  2730. if((uint32_t)SDIO_GetCommandResponse(hsd->Instance) != SD_CMD_SEND_STATUS)
  2731. {
  2732. errorstate = SD_ILLEGAL_CMD;
  2733. return errorstate;
  2734. }
  2735. /* Clear all the static flags */
  2736. __HAL_SD_SDIO_CLEAR_FLAG(hsd, SDIO_STATIC_FLAGS);
  2737. /* We have received response, retrieve it for analysis */
  2738. responseR1 = SDIO_GetResponse(hsd->Instance, SDIO_RESP1);
  2739. /* Find out card status */
  2740. *pStatus = (uint8_t)((responseR1 >> 9) & 0x0000000F);
  2741. if((responseR1 & SD_OCR_ERRORBITS) == SD_ALLZERO)
  2742. {
  2743. return errorstate;
  2744. }
  2745. if((responseR1 & SD_OCR_ADDR_OUT_OF_RANGE) == SD_OCR_ADDR_OUT_OF_RANGE)
  2746. {
  2747. return(SD_ADDR_OUT_OF_RANGE);
  2748. }
  2749. if((responseR1 & SD_OCR_ADDR_MISALIGNED) == SD_OCR_ADDR_MISALIGNED)
  2750. {
  2751. return(SD_ADDR_MISALIGNED);
  2752. }
  2753. if((responseR1 & SD_OCR_BLOCK_LEN_ERR) == SD_OCR_BLOCK_LEN_ERR)
  2754. {
  2755. return(SD_BLOCK_LEN_ERR);
  2756. }
  2757. if((responseR1 & SD_OCR_ERASE_SEQ_ERR) == SD_OCR_ERASE_SEQ_ERR)
  2758. {
  2759. return(SD_ERASE_SEQ_ERR);
  2760. }
  2761. if((responseR1 & SD_OCR_BAD_ERASE_PARAM) == SD_OCR_BAD_ERASE_PARAM)
  2762. {
  2763. return(SD_BAD_ERASE_PARAM);
  2764. }
  2765. if((responseR1 & SD_OCR_WRITE_PROT_VIOLATION) == SD_OCR_WRITE_PROT_VIOLATION)
  2766. {
  2767. return(SD_WRITE_PROT_VIOLATION);
  2768. }
  2769. if((responseR1 & SD_OCR_LOCK_UNLOCK_FAILED) == SD_OCR_LOCK_UNLOCK_FAILED)
  2770. {
  2771. return(SD_LOCK_UNLOCK_FAILED);
  2772. }
  2773. if((responseR1 & SD_OCR_COM_CRC_FAILED) == SD_OCR_COM_CRC_FAILED)
  2774. {
  2775. return(SD_COM_CRC_FAILED);
  2776. }
  2777. if((responseR1 & SD_OCR_ILLEGAL_CMD) == SD_OCR_ILLEGAL_CMD)
  2778. {
  2779. return(SD_ILLEGAL_CMD);
  2780. }
  2781. if((responseR1 & SD_OCR_CARD_ECC_FAILED) == SD_OCR_CARD_ECC_FAILED)
  2782. {
  2783. return(SD_CARD_ECC_FAILED);
  2784. }
  2785. if((responseR1 & SD_OCR_CC_ERROR) == SD_OCR_CC_ERROR)
  2786. {
  2787. return(SD_CC_ERROR);
  2788. }
  2789. if((responseR1 & SD_OCR_GENERAL_UNKNOWN_ERROR) == SD_OCR_GENERAL_UNKNOWN_ERROR)
  2790. {
  2791. return(SD_GENERAL_UNKNOWN_ERROR);
  2792. }
  2793. if((responseR1 & SD_OCR_STREAM_READ_UNDERRUN) == SD_OCR_STREAM_READ_UNDERRUN)
  2794. {
  2795. return(SD_STREAM_READ_UNDERRUN);
  2796. }
  2797. if((responseR1 & SD_OCR_STREAM_WRITE_OVERRUN) == SD_OCR_STREAM_WRITE_OVERRUN)
  2798. {
  2799. return(SD_STREAM_WRITE_OVERRUN);
  2800. }
  2801. if((responseR1 & SD_OCR_CID_CSD_OVERWRITE) == SD_OCR_CID_CSD_OVERWRITE)
  2802. {
  2803. return(SD_CID_CSD_OVERWRITE);
  2804. }
  2805. if((responseR1 & SD_OCR_WP_ERASE_SKIP) == SD_OCR_WP_ERASE_SKIP)
  2806. {
  2807. return(SD_WP_ERASE_SKIP);
  2808. }
  2809. if((responseR1 & SD_OCR_CARD_ECC_DISABLED) == SD_OCR_CARD_ECC_DISABLED)
  2810. {
  2811. return(SD_CARD_ECC_DISABLED);
  2812. }
  2813. if((responseR1 & SD_OCR_ERASE_RESET) == SD_OCR_ERASE_RESET)
  2814. {
  2815. return(SD_ERASE_RESET);
  2816. }
  2817. if((responseR1 & SD_OCR_AKE_SEQ_ERROR) == SD_OCR_AKE_SEQ_ERROR)
  2818. {
  2819. return(SD_AKE_SEQ_ERROR);
  2820. }
  2821. return errorstate;
  2822. }
  2823. /**
  2824. * @}
  2825. */
  2826. #endif /* STM32F103xE || STM32F103xG */
  2827. #endif /* HAL_SD_MODULE_ENABLED */
  2828. /**
  2829. * @}
  2830. */
  2831. /**
  2832. * @}
  2833. */
  2834. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/