STM32F1 Standard Peripheral bibliotheek  1.0
ST Microelectronics bibliotheek documentatie voor de STM32F1 Standard Peripheral Library
 All Data Structures Files Functions Variables Enumerations Groups
stm32f10x_sdio.h
Go to the documentation of this file.
1 
22 /* Define to prevent recursive inclusion -------------------------------------*/
23 #ifndef __STM32F10x_SDIO_H
24 #define __STM32F10x_SDIO_H
25 
26 #ifdef __cplusplus
27  extern "C" {
28 #endif
29 
30 /* Includes ------------------------------------------------------------------*/
31 #include "stm32f10x.h"
32 
45 typedef struct
46 {
47  uint32_t SDIO_ClockEdge;
50  uint32_t SDIO_ClockBypass;
54  uint32_t SDIO_ClockPowerSave;
58  uint32_t SDIO_BusWide;
61  uint32_t SDIO_HardwareFlowControl;
64  uint8_t SDIO_ClockDiv;
67 } SDIO_InitTypeDef;
68 
69 typedef struct
70 {
71  uint32_t SDIO_Argument;
76  uint32_t SDIO_CmdIndex;
78  uint32_t SDIO_Response;
81  uint32_t SDIO_Wait;
84  uint32_t SDIO_CPSM;
87 } SDIO_CmdInitTypeDef;
88 
89 typedef struct
90 {
91  uint32_t SDIO_DataTimeOut;
93  uint32_t SDIO_DataLength;
95  uint32_t SDIO_DataBlockSize;
98  uint32_t SDIO_TransferDir;
102  uint32_t SDIO_TransferMode;
105  uint32_t SDIO_DPSM;
108 } SDIO_DataInitTypeDef;
109 
122 #define SDIO_ClockEdge_Rising ((uint32_t)0x00000000)
123 #define SDIO_ClockEdge_Falling ((uint32_t)0x00002000)
124 #define IS_SDIO_CLOCK_EDGE(EDGE) (((EDGE) == SDIO_ClockEdge_Rising) || \
125  ((EDGE) == SDIO_ClockEdge_Falling))
126 
134 #define SDIO_ClockBypass_Disable ((uint32_t)0x00000000)
135 #define SDIO_ClockBypass_Enable ((uint32_t)0x00000400)
136 #define IS_SDIO_CLOCK_BYPASS(BYPASS) (((BYPASS) == SDIO_ClockBypass_Disable) || \
137  ((BYPASS) == SDIO_ClockBypass_Enable))
138 
146 #define SDIO_ClockPowerSave_Disable ((uint32_t)0x00000000)
147 #define SDIO_ClockPowerSave_Enable ((uint32_t)0x00000200)
148 #define IS_SDIO_CLOCK_POWER_SAVE(SAVE) (((SAVE) == SDIO_ClockPowerSave_Disable) || \
149  ((SAVE) == SDIO_ClockPowerSave_Enable))
150 
158 #define SDIO_BusWide_1b ((uint32_t)0x00000000)
159 #define SDIO_BusWide_4b ((uint32_t)0x00000800)
160 #define SDIO_BusWide_8b ((uint32_t)0x00001000)
161 #define IS_SDIO_BUS_WIDE(WIDE) (((WIDE) == SDIO_BusWide_1b) || ((WIDE) == SDIO_BusWide_4b) || \
162  ((WIDE) == SDIO_BusWide_8b))
163 
172 #define SDIO_HardwareFlowControl_Disable ((uint32_t)0x00000000)
173 #define SDIO_HardwareFlowControl_Enable ((uint32_t)0x00004000)
174 #define IS_SDIO_HARDWARE_FLOW_CONTROL(CONTROL) (((CONTROL) == SDIO_HardwareFlowControl_Disable) || \
175  ((CONTROL) == SDIO_HardwareFlowControl_Enable))
176 
184 #define SDIO_PowerState_OFF ((uint32_t)0x00000000)
185 #define SDIO_PowerState_ON ((uint32_t)0x00000003)
186 #define IS_SDIO_POWER_STATE(STATE) (((STATE) == SDIO_PowerState_OFF) || ((STATE) == SDIO_PowerState_ON))
187 
196 #define SDIO_IT_CCRCFAIL ((uint32_t)0x00000001)
197 #define SDIO_IT_DCRCFAIL ((uint32_t)0x00000002)
198 #define SDIO_IT_CTIMEOUT ((uint32_t)0x00000004)
199 #define SDIO_IT_DTIMEOUT ((uint32_t)0x00000008)
200 #define SDIO_IT_TXUNDERR ((uint32_t)0x00000010)
201 #define SDIO_IT_RXOVERR ((uint32_t)0x00000020)
202 #define SDIO_IT_CMDREND ((uint32_t)0x00000040)
203 #define SDIO_IT_CMDSENT ((uint32_t)0x00000080)
204 #define SDIO_IT_DATAEND ((uint32_t)0x00000100)
205 #define SDIO_IT_STBITERR ((uint32_t)0x00000200)
206 #define SDIO_IT_DBCKEND ((uint32_t)0x00000400)
207 #define SDIO_IT_CMDACT ((uint32_t)0x00000800)
208 #define SDIO_IT_TXACT ((uint32_t)0x00001000)
209 #define SDIO_IT_RXACT ((uint32_t)0x00002000)
210 #define SDIO_IT_TXFIFOHE ((uint32_t)0x00004000)
211 #define SDIO_IT_RXFIFOHF ((uint32_t)0x00008000)
212 #define SDIO_IT_TXFIFOF ((uint32_t)0x00010000)
213 #define SDIO_IT_RXFIFOF ((uint32_t)0x00020000)
214 #define SDIO_IT_TXFIFOE ((uint32_t)0x00040000)
215 #define SDIO_IT_RXFIFOE ((uint32_t)0x00080000)
216 #define SDIO_IT_TXDAVL ((uint32_t)0x00100000)
217 #define SDIO_IT_RXDAVL ((uint32_t)0x00200000)
218 #define SDIO_IT_SDIOIT ((uint32_t)0x00400000)
219 #define SDIO_IT_CEATAEND ((uint32_t)0x00800000)
220 #define IS_SDIO_IT(IT) ((((IT) & (uint32_t)0xFF000000) == 0x00) && ((IT) != (uint32_t)0x00))
221 
229 #define IS_SDIO_CMD_INDEX(INDEX) ((INDEX) < 0x40)
230 
238 #define SDIO_Response_No ((uint32_t)0x00000000)
239 #define SDIO_Response_Short ((uint32_t)0x00000040)
240 #define SDIO_Response_Long ((uint32_t)0x000000C0)
241 #define IS_SDIO_RESPONSE(RESPONSE) (((RESPONSE) == SDIO_Response_No) || \
242  ((RESPONSE) == SDIO_Response_Short) || \
243  ((RESPONSE) == SDIO_Response_Long))
244 
252 #define SDIO_Wait_No ((uint32_t)0x00000000)
253 #define SDIO_Wait_IT ((uint32_t)0x00000100)
254 #define SDIO_Wait_Pend ((uint32_t)0x00000200)
255 #define IS_SDIO_WAIT(WAIT) (((WAIT) == SDIO_Wait_No) || ((WAIT) == SDIO_Wait_IT) || \
256  ((WAIT) == SDIO_Wait_Pend))
257 
265 #define SDIO_CPSM_Disable ((uint32_t)0x00000000)
266 #define SDIO_CPSM_Enable ((uint32_t)0x00000400)
267 #define IS_SDIO_CPSM(CPSM) (((CPSM) == SDIO_CPSM_Enable) || ((CPSM) == SDIO_CPSM_Disable))
268 
276 #define SDIO_RESP1 ((uint32_t)0x00000000)
277 #define SDIO_RESP2 ((uint32_t)0x00000004)
278 #define SDIO_RESP3 ((uint32_t)0x00000008)
279 #define SDIO_RESP4 ((uint32_t)0x0000000C)
280 #define IS_SDIO_RESP(RESP) (((RESP) == SDIO_RESP1) || ((RESP) == SDIO_RESP2) || \
281  ((RESP) == SDIO_RESP3) || ((RESP) == SDIO_RESP4))
282 
290 #define IS_SDIO_DATA_LENGTH(LENGTH) ((LENGTH) <= 0x01FFFFFF)
291 
299 #define SDIO_DataBlockSize_1b ((uint32_t)0x00000000)
300 #define SDIO_DataBlockSize_2b ((uint32_t)0x00000010)
301 #define SDIO_DataBlockSize_4b ((uint32_t)0x00000020)
302 #define SDIO_DataBlockSize_8b ((uint32_t)0x00000030)
303 #define SDIO_DataBlockSize_16b ((uint32_t)0x00000040)
304 #define SDIO_DataBlockSize_32b ((uint32_t)0x00000050)
305 #define SDIO_DataBlockSize_64b ((uint32_t)0x00000060)
306 #define SDIO_DataBlockSize_128b ((uint32_t)0x00000070)
307 #define SDIO_DataBlockSize_256b ((uint32_t)0x00000080)
308 #define SDIO_DataBlockSize_512b ((uint32_t)0x00000090)
309 #define SDIO_DataBlockSize_1024b ((uint32_t)0x000000A0)
310 #define SDIO_DataBlockSize_2048b ((uint32_t)0x000000B0)
311 #define SDIO_DataBlockSize_4096b ((uint32_t)0x000000C0)
312 #define SDIO_DataBlockSize_8192b ((uint32_t)0x000000D0)
313 #define SDIO_DataBlockSize_16384b ((uint32_t)0x000000E0)
314 #define IS_SDIO_BLOCK_SIZE(SIZE) (((SIZE) == SDIO_DataBlockSize_1b) || \
315  ((SIZE) == SDIO_DataBlockSize_2b) || \
316  ((SIZE) == SDIO_DataBlockSize_4b) || \
317  ((SIZE) == SDIO_DataBlockSize_8b) || \
318  ((SIZE) == SDIO_DataBlockSize_16b) || \
319  ((SIZE) == SDIO_DataBlockSize_32b) || \
320  ((SIZE) == SDIO_DataBlockSize_64b) || \
321  ((SIZE) == SDIO_DataBlockSize_128b) || \
322  ((SIZE) == SDIO_DataBlockSize_256b) || \
323  ((SIZE) == SDIO_DataBlockSize_512b) || \
324  ((SIZE) == SDIO_DataBlockSize_1024b) || \
325  ((SIZE) == SDIO_DataBlockSize_2048b) || \
326  ((SIZE) == SDIO_DataBlockSize_4096b) || \
327  ((SIZE) == SDIO_DataBlockSize_8192b) || \
328  ((SIZE) == SDIO_DataBlockSize_16384b))
329 
337 #define SDIO_TransferDir_ToCard ((uint32_t)0x00000000)
338 #define SDIO_TransferDir_ToSDIO ((uint32_t)0x00000002)
339 #define IS_SDIO_TRANSFER_DIR(DIR) (((DIR) == SDIO_TransferDir_ToCard) || \
340  ((DIR) == SDIO_TransferDir_ToSDIO))
341 
349 #define SDIO_TransferMode_Block ((uint32_t)0x00000000)
350 #define SDIO_TransferMode_Stream ((uint32_t)0x00000004)
351 #define IS_SDIO_TRANSFER_MODE(MODE) (((MODE) == SDIO_TransferMode_Stream) || \
352  ((MODE) == SDIO_TransferMode_Block))
353 
361 #define SDIO_DPSM_Disable ((uint32_t)0x00000000)
362 #define SDIO_DPSM_Enable ((uint32_t)0x00000001)
363 #define IS_SDIO_DPSM(DPSM) (((DPSM) == SDIO_DPSM_Enable) || ((DPSM) == SDIO_DPSM_Disable))
364 
372 #define SDIO_FLAG_CCRCFAIL ((uint32_t)0x00000001)
373 #define SDIO_FLAG_DCRCFAIL ((uint32_t)0x00000002)
374 #define SDIO_FLAG_CTIMEOUT ((uint32_t)0x00000004)
375 #define SDIO_FLAG_DTIMEOUT ((uint32_t)0x00000008)
376 #define SDIO_FLAG_TXUNDERR ((uint32_t)0x00000010)
377 #define SDIO_FLAG_RXOVERR ((uint32_t)0x00000020)
378 #define SDIO_FLAG_CMDREND ((uint32_t)0x00000040)
379 #define SDIO_FLAG_CMDSENT ((uint32_t)0x00000080)
380 #define SDIO_FLAG_DATAEND ((uint32_t)0x00000100)
381 #define SDIO_FLAG_STBITERR ((uint32_t)0x00000200)
382 #define SDIO_FLAG_DBCKEND ((uint32_t)0x00000400)
383 #define SDIO_FLAG_CMDACT ((uint32_t)0x00000800)
384 #define SDIO_FLAG_TXACT ((uint32_t)0x00001000)
385 #define SDIO_FLAG_RXACT ((uint32_t)0x00002000)
386 #define SDIO_FLAG_TXFIFOHE ((uint32_t)0x00004000)
387 #define SDIO_FLAG_RXFIFOHF ((uint32_t)0x00008000)
388 #define SDIO_FLAG_TXFIFOF ((uint32_t)0x00010000)
389 #define SDIO_FLAG_RXFIFOF ((uint32_t)0x00020000)
390 #define SDIO_FLAG_TXFIFOE ((uint32_t)0x00040000)
391 #define SDIO_FLAG_RXFIFOE ((uint32_t)0x00080000)
392 #define SDIO_FLAG_TXDAVL ((uint32_t)0x00100000)
393 #define SDIO_FLAG_RXDAVL ((uint32_t)0x00200000)
394 #define SDIO_FLAG_SDIOIT ((uint32_t)0x00400000)
395 #define SDIO_FLAG_CEATAEND ((uint32_t)0x00800000)
396 #define IS_SDIO_FLAG(FLAG) (((FLAG) == SDIO_FLAG_CCRCFAIL) || \
397  ((FLAG) == SDIO_FLAG_DCRCFAIL) || \
398  ((FLAG) == SDIO_FLAG_CTIMEOUT) || \
399  ((FLAG) == SDIO_FLAG_DTIMEOUT) || \
400  ((FLAG) == SDIO_FLAG_TXUNDERR) || \
401  ((FLAG) == SDIO_FLAG_RXOVERR) || \
402  ((FLAG) == SDIO_FLAG_CMDREND) || \
403  ((FLAG) == SDIO_FLAG_CMDSENT) || \
404  ((FLAG) == SDIO_FLAG_DATAEND) || \
405  ((FLAG) == SDIO_FLAG_STBITERR) || \
406  ((FLAG) == SDIO_FLAG_DBCKEND) || \
407  ((FLAG) == SDIO_FLAG_CMDACT) || \
408  ((FLAG) == SDIO_FLAG_TXACT) || \
409  ((FLAG) == SDIO_FLAG_RXACT) || \
410  ((FLAG) == SDIO_FLAG_TXFIFOHE) || \
411  ((FLAG) == SDIO_FLAG_RXFIFOHF) || \
412  ((FLAG) == SDIO_FLAG_TXFIFOF) || \
413  ((FLAG) == SDIO_FLAG_RXFIFOF) || \
414  ((FLAG) == SDIO_FLAG_TXFIFOE) || \
415  ((FLAG) == SDIO_FLAG_RXFIFOE) || \
416  ((FLAG) == SDIO_FLAG_TXDAVL) || \
417  ((FLAG) == SDIO_FLAG_RXDAVL) || \
418  ((FLAG) == SDIO_FLAG_SDIOIT) || \
419  ((FLAG) == SDIO_FLAG_CEATAEND))
420 
421 #define IS_SDIO_CLEAR_FLAG(FLAG) ((((FLAG) & (uint32_t)0xFF3FF800) == 0x00) && ((FLAG) != (uint32_t)0x00))
422 
423 #define IS_SDIO_GET_IT(IT) (((IT) == SDIO_IT_CCRCFAIL) || \
424  ((IT) == SDIO_IT_DCRCFAIL) || \
425  ((IT) == SDIO_IT_CTIMEOUT) || \
426  ((IT) == SDIO_IT_DTIMEOUT) || \
427  ((IT) == SDIO_IT_TXUNDERR) || \
428  ((IT) == SDIO_IT_RXOVERR) || \
429  ((IT) == SDIO_IT_CMDREND) || \
430  ((IT) == SDIO_IT_CMDSENT) || \
431  ((IT) == SDIO_IT_DATAEND) || \
432  ((IT) == SDIO_IT_STBITERR) || \
433  ((IT) == SDIO_IT_DBCKEND) || \
434  ((IT) == SDIO_IT_CMDACT) || \
435  ((IT) == SDIO_IT_TXACT) || \
436  ((IT) == SDIO_IT_RXACT) || \
437  ((IT) == SDIO_IT_TXFIFOHE) || \
438  ((IT) == SDIO_IT_RXFIFOHF) || \
439  ((IT) == SDIO_IT_TXFIFOF) || \
440  ((IT) == SDIO_IT_RXFIFOF) || \
441  ((IT) == SDIO_IT_TXFIFOE) || \
442  ((IT) == SDIO_IT_RXFIFOE) || \
443  ((IT) == SDIO_IT_TXDAVL) || \
444  ((IT) == SDIO_IT_RXDAVL) || \
445  ((IT) == SDIO_IT_SDIOIT) || \
446  ((IT) == SDIO_IT_CEATAEND))
447 
448 #define IS_SDIO_CLEAR_IT(IT) ((((IT) & (uint32_t)0xFF3FF800) == 0x00) && ((IT) != (uint32_t)0x00))
449 
458 #define SDIO_ReadWaitMode_CLK ((uint32_t)0x00000001)
459 #define SDIO_ReadWaitMode_DATA2 ((uint32_t)0x00000000)
460 #define IS_SDIO_READWAIT_MODE(MODE) (((MODE) == SDIO_ReadWaitMode_CLK) || \
461  ((MODE) == SDIO_ReadWaitMode_DATA2))
462 
482 void SDIO_DeInit(void);
483 void SDIO_Init(SDIO_InitTypeDef* SDIO_InitStruct);
484 void SDIO_StructInit(SDIO_InitTypeDef* SDIO_InitStruct);
485 void SDIO_ClockCmd(FunctionalState NewState);
486 void SDIO_SetPowerState(uint32_t SDIO_PowerState);
487 uint32_t SDIO_GetPowerState(void);
488 void SDIO_ITConfig(uint32_t SDIO_IT, FunctionalState NewState);
489 void SDIO_DMACmd(FunctionalState NewState);
490 void SDIO_SendCommand(SDIO_CmdInitTypeDef *SDIO_CmdInitStruct);
491 void SDIO_CmdStructInit(SDIO_CmdInitTypeDef* SDIO_CmdInitStruct);
492 uint8_t SDIO_GetCommandResponse(void);
493 uint32_t SDIO_GetResponse(uint32_t SDIO_RESP);
494 void SDIO_DataConfig(SDIO_DataInitTypeDef* SDIO_DataInitStruct);
495 void SDIO_DataStructInit(SDIO_DataInitTypeDef* SDIO_DataInitStruct);
496 uint32_t SDIO_GetDataCounter(void);
497 uint32_t SDIO_ReadData(void);
498 void SDIO_WriteData(uint32_t Data);
499 uint32_t SDIO_GetFIFOCount(void);
500 void SDIO_StartSDIOReadWait(FunctionalState NewState);
501 void SDIO_StopSDIOReadWait(FunctionalState NewState);
502 void SDIO_SetSDIOReadWaitMode(uint32_t SDIO_ReadWaitMode);
503 void SDIO_SetSDIOOperation(FunctionalState NewState);
504 void SDIO_SendSDIOSuspendCmd(FunctionalState NewState);
505 void SDIO_CommandCompletionCmd(FunctionalState NewState);
506 void SDIO_CEATAITCmd(FunctionalState NewState);
507 void SDIO_SendCEATACmd(FunctionalState NewState);
508 FlagStatus SDIO_GetFlagStatus(uint32_t SDIO_FLAG);
509 void SDIO_ClearFlag(uint32_t SDIO_FLAG);
510 ITStatus SDIO_GetITStatus(uint32_t SDIO_IT);
511 void SDIO_ClearITPendingBit(uint32_t SDIO_IT);
512 
513 #ifdef __cplusplus
514 }
515 #endif
516 
517 #endif /* __STM32F10x_SDIO_H */
518 
530 /******************* (C) COPYRIGHT 2010 STMicroelectronics *****END OF FILE****/