?? sddriver.h
字號:
/****************************************Copyright (c)**************************************************
** Guangzhou ZLG-MCU Development Co.,LTD.
** graduate school
** http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name: sddriver.c
** Last modified Date: 2005-3-10
** Last Version: V2.0
** Descriptions: SD/MMC卡讀寫模塊: 物理層 用戶API函數(頭文件)
** Soft Packet of SD Card: user API funciton (header file)
**
**------------------------------------------------------------------------------------------------------
** Created by: Ming Yuan Zheng
** Created date: 2005-1-6
** Version: V1.0
** Descriptions: The original version
**
**------------------------------------------------------------------------------------------------------
** Modified by: Ming Yuan Zheng
** Modified date: 2005-3-10
** Version: V2.0
** Descriptions: 增加了對MMC卡的支持,增加了對UCOS-II的支持,使該模塊不僅能運行于前后臺系統,還可運行
** 于UCOS-II上
**------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
** Version:
** Descriptions:
**
********************************************************************************************************/
/* SD卡信息結構體定義 */
/* the information structure variable of SD Card*/
typedef struct SD_STRUCT
{
INT8U card_type;
INT32U block_num; /* 卡中塊的數量 */
INT32U block_len; /* 卡的塊長度(單位:字節) */
INT32U erase_unit; /* 一次可擦除的塊個數 */
INT32U timeout_read; /* 讀塊超時時間(單位: 8 SPI clock) */
INT32U timeout_write; /* 寫塊超時時間(單位: 8 SPI clock) */
INT32U timeout_erase; /* 擦塊超時時間(單位: 8 SPI clock) */
}sd_struct;
extern sd_struct sds; /* SD卡信息結構體變量 */
/*
*************************************************************
用戶API函數: 讀, 寫, 擦 SD卡 API函數及錯誤碼
*************************************************************
*/
/* 錯誤碼 error code */
#define SD_NO_ERR 0x00 // 函數執行成功
#define SD_ERR_NO_CARD 0x01 // 卡沒有完全插入到卡座中
#define SD_ERR_USER_PARAM 0x02 // 用戶使用API函數時，入口參數有錯誤
#define SD_ERR_CARD_PARAM 0x03 // 卡中參數有錯誤（與本模塊不兼容）
#define SD_ERR_VOL_NOTSUSP 0x04 // 卡不支持3.3V供電
#define SD_ERR_OVER_CARDRANGE 0x05 // 操作超出卡容量范圍
#define SD_ERR_UNKNOWN_CARD 0x06 // 無法識別卡型
/* SD命令可能返回的錯誤碼 */
#define SD_ERR_CMD_RESPTYPE 0x10 // 命令類型錯誤
#define SD_ERR_CMD_TIMEOUT 0x11 // 卡命令響應超時
#define SD_ERR_CMD_RESP 0x12 // 卡命令響應錯誤
/* 數據流錯誤碼 */
#define SD_ERR_DATA_CRC16 0x20 // 數據流CRC16校驗不通過
#define SD_ERR_DATA_START_TOK 0x21 // 讀單塊或多塊時，數據開始令牌不正確
#define SD_ERR_DATA_RESP 0x22 // 寫單塊或多塊時，卡數據響應令牌不正確
/* 等待錯誤碼 */
#define SD_ERR_TIMEOUT_WAIT 0x30 // 寫或擦操作時，發生超時錯誤
#define SD_ERR_TIMEOUT_READ 0x31 // 讀操作超時錯誤
#define SD_ERR_TIMEOUT_WRITE 0x32 // 寫操作超時錯誤
#define SD_ERR_TIMEOUT_ERASE 0x33 // 擦除操作超時錯誤
#define SD_ERR_TIMEOUT_WAITIDLE 0x34 // 初始化卡時，等待卡退出空閑狀態超時錯誤
/* 寫操作可能返回的錯誤碼 */
#define SD_ERR_WRITE_BLK 0x40 // 寫塊數據錯誤
#define SD_ERR_WRITE_BLKNUMS 0x41 // 寫多塊時，想要寫入的塊與正確寫入的塊數不一致
#define SD_ERR_WRITE_PROTECT 0x42 // 卡外殼的寫保護開關打在寫保護位置
/* 使用UCOS-II時可能出現的錯誤 */
#define SD_ERR_CREATE_SEMSD 0xA0 // 創建SD/MMC卡訪問信號量失敗
/**************************************************
其它宏定義
***************************************************/
#define CARDTYPE_SD 0x00 // 卡型為SD 卡
#define CARDTYPE_MMC 0x01 // 卡型為MMC 卡
#define SD_UCOSII_SMALLWAIT 256 // 運行于UCOS-II時的小等待時間
#define SD_READREG_TIMEOUT 8 // 讀寄存器的超時時間
/* 初始化SD卡 initialize sd card */
extern INT8U SD_Initialize(void);
/* 從SD卡中讀一個塊 read a single block from sd card */
extern INT8U SD_ReadBlock(INT32U blockaddr, INT8U *recbuf);
/* 從SD卡中讀多個塊 read multi blocks from sd card */
extern INT8U SD_ReadMultiBlock(INT32U blockaddr, INT32U blocknum, INT8U *recbuf);
/* 向SD卡中寫入一個塊 write a block to sd card */
extern INT8U SD_WriteBlock(INT32U blockaddr, INT8U *recbuf);
/* 向SD卡中寫入多個塊 write multi blocks to sd card */
extern INT8U SD_WriteMultiBlock(INT32U blockaddr, INT32U blocknum, INT8U *recbuf);
/* 擦除SD卡中的塊 Erase the block of sd card */
extern INT8U SD_EraseBlock(INT32U startaddr, INT32U blocknum);
/* 得到SD卡信息 get information of sd card */
extern INT8U SD_GetCardInfo(void);
/* 由CSD寄存器計算超時時間 calculate timeout from CSD register */
extern INT8U SD_CalTimeout(INT8U *csdbuf);
/* 激活SD卡內部進行初始化處理 active sd to initialize process */
extern INT8U SD_ActiveInit(void);
/* 向OS申請訪問卡的信號量 request semaphore accessed card to OS */
extern void SD_StartSD(void);
/* 將訪問卡的信號量還給OS return semaphore accessed card to OS */
extern void SD_EndSD(void);
/*
*************************************************************
下面為軟件包用到的與SD卡相關的宏定義
*************************************************************
*/
/* Mask off the bits in the OCR corresponding to voltage range 3.2V to
* 3.4V, OCR bits 20 and 21 */
#define MSK_OCR_33 0xC0
/* 定義在初始化階段,等待SD卡退出空閑狀態的重試次數 */
/* Number of tries to wait for the card to go idle during initialization */
#define SD_IDLE_WAIT_MAX 1000
/* SD卡命令超時時間(單位 8clock)*/
/* timeout of command */
#define SD_CMD_TIMEOUT 100
/* 100ms 相當的SPI時鐘數(單位 unit: 8 clocks) */
/* 100ms correspond to SPI clock(unit: 8 clocks)*/
#define READ_TIMEOUT_100MS 100 * SPI_CLOCK / 1000 / 8
/* 250ms 相當的SPI時鐘數(單位 unit: 8 clocks) */
/* 250ms correspond to SPI clock(unit: 8 clocks)*/
#define WRITE_TIMEOUT_250MS 250 * SPI_CLOCK / 1000 / 8
/* CSD中一些域的字節位置(高字節在前) */
#define TAAC_POS 1 //TACC
#define NSAC_POS 2 //NSAC
#define READ_BL_LEN_POS 5 //READ_BL_LEN
#define C_SIZE_POS1 6 //C_SIZE upper 2-bit
#define C_SIZE_POS2 7 //C_SIZE middle 8-bit
#define C_SIZE_POS3 8 //C_SIZE lower 2-bit
#define C_SIZE_MULT_POS1 9 //C_SIZE_MULT upper 2-bit
#define C_SIZE_MULT_POS2 10 //C_SIZE_MULT lower 1-bit
#define SECTOR_SIZE_POS1 10 //SECTOR_SIZE upper 5-bit
#define SECTOR_SIZE_POS2 11 //SECTOR_SIZE lower 2-bit
#define R2WFACTOR_POS 12 //R2WFACTOR_POS
/**/
#define ERASE_GRP_SIZE_POS 10 //MMC卡 ERASE_GRP_SIZE 5-bit
#define ERASE_GRP_MULTI_POS1 10 //MMC卡 ERASE_GRP_MULTI 2-bit
#define ERASE_GRP_MULTI_POS2 11 //MMC卡 ERASE_GRP_MULTI 3-bit
//CSD中一些域的掩碼
#define TAAC_MSK 0x07 //TACC 域掩碼
#define NSAC_MSK 0x78 //NSAC 域掩碼
#define READ_BL_LEN_MSK 0x0F //READ_BL_LEN 的掩碼
#define C_SIZE_MSK1 0x03 //C_SIZE 高2位掩碼
#define C_SIZE_MSK3 0xC0 //C_SIZE 低2位掩碼
#define C_SIZE_MULT_MSK1 0x03 //C_SIZE_MULT 的高2位掩碼
#define C_SIZE_MULT_MSK2 0x80 //C_SIZE_MULT 的低2位掩碼
#define R2WFACTOR_MSK 0x1C //R2WFACTOR 掩碼
#define SECTOR_SIZE_MSK1 0x3F //SECTOR_SIZE 的高5位
#define SECTOR_SIZE_MSK2 0x80 //SECTOR_SIZE 的低2位
#define ERASE_GRP_SIZE_MSK 0x7C //MMC卡 ERASE_GRP_SIZE 掩碼
#define ERASE_GRP_MULTI_MSK1 0x03 //MMC卡 ERASE_GRP_MULTI 高2位掩碼
#define ERASE_GRP_MULTI_MSK2 0xE0 //MMC卡 ERASE_GRP_NULTI 低3位掩碼
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -