开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > 微处理器开发 > 查看源码
sddriver.h
资源名称：SD卡读写模块.rar　[点击查看]
上传用户：pudewen666
上传日期：2007-06-08
资源大小：75k
文件大小：7k
源码类别：

微处理器开发

开发平台：

Windows_Unix

sddriver.h：源码内容
  1. /****************************************Copyright (c)**************************************************
  2. **                               Guangzhou ZLG-MCU Development Co.,LTD.
  3. **                                      graduate school
  4. **                                 http://www.zlgmcu.com
  5. **
  6. **--------------File Info-------------------------------------------------------------------------------
  7. ** File name: sddriver.h
  8. ** Last modified Date: 2005-1-6
  9. ** Last Version: V1.0
  10. ** Descriptions: sd 卡驱动软件包: 用户API函数(头文件)
  11. ** Soft Packet of SD Card Driver: user API funciton(header file)
  12. **
  13. **------------------------------------------------------------------------------------------------------
  14. ** Created by: Ming Yuan Zheng
  15. ** Created date: 2005-1-6
  16. ** Version: V1.0
  17. ** Descriptions: The original version
  18. **
  19. **------------------------------------------------------------------------------------------------------
  20. ** Modified by:
  21. ** Modified date:
  22. ** Version:
  23. ** Descriptions:
  24. **
  25. **------------------------------------------------------------------------------------------------------
  26. ** Modified by: 
  27. ** Modified date:
  28. ** Version:
  29. ** Descriptions: 
  30. **
  31. ********************************************************************************************************/
  33. /* SD卡信息结构体定义 */ 
  34. /* the information structure variable of SD Card*/
  35. typedef struct SD_STRUCT
  36. {
  37. INT32U block_num; /* 卡中块的数量 */
  38. INT32U block_len; /* 卡的块长度(单位:字节) */
  39. INT32U erase_unit; /* 一次可擦除的块个数 */
  41. INT32U timeout_read; /* 读块超时时间(单位: 8 SPI clock) */
  42. INT32U timeout_write; /* 写块超时时间(单位: 8 SPI clock) */
  43. INT32U timeout_erase; /* 擦块超时时间(单位: 8 SPI clock) */
  45. }sd_struct;
  47. extern sd_struct sds; /* SD卡信息结构体变量 */ 
  49. /*
  50. *************************************************************
  52. 用户API函数: 读, 写, 擦 SD卡  API函数及错误码
  53.  
  54. *************************************************************
  55. */
  57. /* 错误码 error code */
  58. #define   SD_NO_ERR       0x00 // 函数执行成功
  59. #define   SD_ERR_NO_CARD   0x01 // SD卡没有完全插入到卡座中
  60. #define   SD_ERR_USER_PARAM       0x02 // 用户使用API函数时，入口参数有错误
  61. #define   SD_ERR_CARD_PARAM   0x03 // 卡中参数有错误（与本模块不兼容）
  62. #define   SD_ERR_VOL_NOTSUSP        0x04 // 卡不支持3.3V供电
  63. #define   SD_ERR_OVER_CARDRANGE 0x05 // 操作超出卡容量范围
  65. /* SD命令可能返回的错误码 */
  66. #define   SD_ERR_CMD_RESPTYPE   0x10 // 命令类型错误
  67. #define   SD_ERR_CMD_TIMEOUT      0x11 // SD命令响应超时
  68. #define   SD_ERR_CMD_RESP   0x12 // SD命令响应错误
  70. /* 数据流错误码 */
  71. #define   SD_ERR_DATA_CRC16       0x20 // 数据流CRC16校验不通过
  72. #define   SD_ERR_DATA_START_TOK 0x21 // 读单块或多块时，数据开始令牌不正确
  73. #define   SD_ERR_DATA_RESP   0x22 // 写单块或多块时，SD卡数据响应令牌不正确
  75. /* 等待错误码 */
  76. #define   SD_ERR_TIMEOUT_WAIT     0x30 // 写或擦操作时，发生超时错误
  77. #define   SD_ERR_TIMEOUT_READ     0x31 // 读操作超时错误
  78. #define   SD_ERR_TIMEOUT_WRITE   0x32 // 写操作超时错误
  79. #define   SD_ERR_TIMEOUT_ERASE    0x33 // 擦除操作超时错误
  80. #define   SD_ERR_TIMEOUT_WAITIDLE  0x34 // 初始化SD卡时，等待SD卡进入空闲状态超时错误
  82. /* 写操作可能返回的错误码 */
  83. #define   SD_ERR_WRITE_BLK 0x40 // 写块数据错误
  84. #define   SD_ERR_WRITE_BLKNUMS      0x41 // 写多块时，想要写入的块与正确写入的块数不一致
  85. #define   SD_ERR_WRITE_PROTECT 0x42 // 卡外壳的写保护开关打在写保护位置
  88. /* 初始化SD卡 initialize sd card */
  89. extern INT8U SD_Initialize(void);
  91. /* 从SD卡中读一个块 read a single block from sd card */
  92. extern INT8U SD_ReadBlock(INT32U blockaddr, INT8U *recbuf);  
  94. /* 从SD卡中读多个块 read multi blocks from sd card */
  95. extern INT8U SD_ReadMultiBlock(INT32U blockaddr, INT32U blocknum, INT8U *recbuf); 
  96.  
  97. /* 向SD卡中写入一个块 write a block to sd card */               
  98. extern INT8U SD_WriteBlock(INT32U blockaddr, INT8U *recbuf);  
  100. /* 向SD卡中写入多个块 write multi blocks to sd card */  
  101. extern INT8U SD_WriteMultiBlock(INT32U blockaddr, INT32U blocknum, INT8U *recbuf); 
  103. /* 擦除SD卡中的块 Erase the block of sd card */
  104. extern INT8U SD_EraseBlock(INT32U startaddr, INT32U blocknum); 
  106. /* 得到SD卡信息 get information of sd card */
  107. extern INT8U SD_GetCardInfo(void);
  109. /* 由CSD寄存器计算超时时间 calculate timeout from CSD register */
  110. void SD_CalTimeout(INT8U *csdbuf);
  112. /* 激活SD卡内部进行初始化处理 active sd to initialize process */
  113. INT8U SD_ActiveInit(void);
  115.     /*
  116.     *************************************************************
  117.     
  118.       下面为软件包用到的与SD卡相关的宏定义
  119.      
  120.     *************************************************************
  121.     */
  122.               
  123. /* Mask off the bits in the OCR corresponding to voltage range 3.2V to
  124.  * 3.4V, OCR bits 20 and 21 */
  125. #define MSK_OCR_33   0xC0
  127. /* 定义在初始化阶段,等待SD卡退出空闲状态的重试次数 */
  128. /* Number of tries to wait for the card to go idle during initialization */
  129. #define SD_IDLE_WAIT_MAX      1000
  131. /* SD卡命令超时时间(单位 8clock)*/
  132. /* timeout of command */
  133. #define SD_CMD_TIMEOUT      100
  135. /* 100ms 相当的SPI时钟数(单位 unit: 8 clocks) */
  136. /* 100ms correspond to SPI clock(unit: 8 clocks)*/
  137. #define READ_TIMEOUT_100MS      100 * SPI_CLOCK / 1000 / 8
  139. /* 250ms 相当的SPI时钟数(单位 unit: 8 clocks) */
  140. /* 250ms correspond to SPI clock(unit: 8 clocks)*/
  141. #define WRITE_TIMEOUT_250MS 250 * SPI_CLOCK / 1000 / 8    
  144. /* CSD中一些域的字节位置(高字节在前) */
  145. #define TAAC_POS  1 //TACC
  146. #define NSAC_POS 2 //NSAC
  148. #define READ_BL_LEN_POS 5 //READ_BL_LEN
  150. #define C_SIZE_POS1 6 //C_SIZE upper  2-bit
  151. #define C_SIZE_POS2 7 //C_SIZE middle 8-bit
  152. #define C_SIZE_POS3 8 //C_SIZE lower 2-bit
  154. #define C_SIZE_MULT_POS1 9 //C_SIZE_MULT upper 2-bit
  155. #define C_SIZE_MULT_POS2 10 //C_SIZE_MULT lower 1-bit
  157. #define SECTOR_SIZE_POS1 10 //SECTOR_SIZE upper 5-bit
  158. #define SECTOR_SIZE_POS2 11 //SECTOR_SIZE lower 2-bit
  160. #define R2WFACTOR_POS  12 //R2WFACTOR_POS
  163. //CSD中一些域的掩码
  164. #define TAAC_MSK 0x07 //TACC 域掩码
  165. #define NSAC_MSK 0x78 //NSAC 域掩码
  167. #define READ_BL_LEN_MSK 0x0F //READ_BL_LEN 的掩码
  169. #define C_SIZE_MSK1 0x03 //C_SIZE 高2位掩码
  170. #define C_SIZE_MSK3 0xC0 //C_SIZE 低2位掩码
  172. #define C_SIZE_MULT_MSK1  0x03 //C_SIZE_MULT 的高2位掩码
  173. #define C_SIZE_MULT_MSK2  0x80 //C_SIZE_MULT 的低2位掩码
  175. #define R2WFACTOR_MSK 0x1C //R2WFACTOR 掩码
  177. #define SECTOR_SIZE_MSK1 0x3F //SECTOR_SIZE 的高5位
  178. #define SECTOR_SIZE_MSK2 0x80 //SECTOR_SIZE 的低2位
  181.