sd_drive.h

Atmega64单片机程序（完整工程）

/*--------------File Info-------------------------------------------------------
** 文   件   名:    SD_Driver.h
** 最后修改日期:    2008.3.28
** 版        本:    V1.0
** 描        述:    sd 卡驱动软件包: 用户API函数			
**------------------------------------------------------------------------------
** Created   by:    		
** Created date:			
*******************************************************************************/

#ifndef __SD_Drive_h
#define __SD_Drive_h

#include "SYS_Config.h" 
#include "SD_Config.h"

// SD卡信息结构体定义 
typedef struct SD_STRUCT 
{
    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函数及错误码
**************************************************************/

// 错误码 
// 函数执行成功
// SD卡没有完全插入到卡座中
// 用户使用API函数时，入口参数有错误
// 卡中参数有错误（与本模块不兼容）
// 卡不支持3.3V供电
// 操作超出卡容量范围
#define SD_NO_ERR             0x00
#define SD_ERR_NO_CARD        0x01
#define SD_ERR_USER_PARAM     0x02
#define SD_ERR_CARD_PARAM     0x03
#define SD_ERR_VOL_NOTSUSP    0x04
#define SD_ERR_OVER_CARDRANGE 0x05 

    // SD命令可能返回的错误码
// 命令类型错误
// SD命令响应超时
// SD命令响应错误
#define SD_ERR_CMD_RESPTYPE   0x10
#define SD_ERR_CMD_TIMEOUT    0x11
#define SD_ERR_CMD_RESP       0x12 

// 数据流错误码 
// 数据流CRC16校验不通过
// 读单块或多块时，数据开始令牌不正确
// 写单块或多块时，SD卡数据响应令牌不正确
#define SD_ERR_DATA_CRC16     0x20
#define SD_ERR_DATA_START_TOK 0x21
#define SD_ERR_DATA_RESP      0x22 

// 等待错误码 
// 写或擦操作时，发生超时错误
// 读操作超时错误
// 写操作超时错误
// 擦除操作超时错误
// 初始化SD卡时，等待SD卡进入空闲状态超时错误
#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 


/**************************************************************
下面为软件包用到的与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卡退出空闲状态的重试次数 */
#define SD_IDLE_WAIT_MAX         1000 

/* SD卡命令超时时间(单位 8clock)*/
#define SD_CMD_TIMEOUT           255 

/* 100ms 相当的SPI时钟数(单位 unit: 8 clocks) */
#define READ_TIMEOUT_100MS       100*SPI_CLOCK/1000/8 

/* 250ms 相当的SPI时钟数(单位 unit: 8 clocks) */
#define WRITE_TIMEOUT_250MS      250*SPI_CLOCK/1000/8 


// CSD中一些域的字节位置(高字节在前)
//TACC
//NSAC
#define TAAC_POS          1
#define NSAC_POS          2 

//READ_BL_LEN
#define READ_BL_LEN_POS   5 

//C_SIZE upper  2-bit
//C_SIZE middle 8-bit
//C_SIZE lower	2-bit
#define C_SIZE_POS1       6
#define C_SIZE_POS2       7
#define C_SIZE_POS3       8 

//C_SIZE_MULT upper 2-bit
//C_SIZE_MULT lower 1-bit	
#define C_SIZE_MULT_POS1  9
#define C_SIZE_MULT_POS2  10 

//SECTOR_SIZE upper 5-bit
//SECTOR_SIZE lower 2-bit
#define SECTOR_SIZE_POS1  10
#define SECTOR_SIZE_POS2  11 

//R2WFACTOR_POS
#define R2WFACTOR_POS     12 

//CSD中一些域的掩码
//TACC 域掩码
//NSAC 域掩码
#define TAAC_MSK         0x07
#define NSAC_MSK         0x78 

//READ_BL_LEN 的掩码
#define READ_BL_LEN_MSK  0x0F 

//C_SIZE 高2位掩码
//C_SIZE 低2位掩码
#define C_SIZE_MSK1      0x03
#define C_SIZE_MSK3      0xC0 

//C_SIZE_MULT 的高2位掩码
//C_SIZE_MULT 的低2位掩码
#define C_SIZE_MULT_MSK1 0x03
#define C_SIZE_MULT_MSK2 0x80 

//R2WFACTOR 掩码
#define R2WFACTOR_MSK    0x1C 

//SECTOR_SIZE 的高5位
//SECTOR_SIZE 的低2位
#define SECTOR_SIZE_MSK1 0x3F
#define SECTOR_SIZE_MSK2 0x80 



/* 初始化SD卡 initialize sd card */
extern INT8U SD_Initialize(void);

/* 从SD卡中读一个块  */
extern INT8U  SD_ReadBlock(INT32U blockaddr,INT8U *recbuf);

/* 从SD卡中读一个块偏移为offset 的整形数据  */
extern INT16U SD_Read_Word(INT32U blockaddr,INT16U offset);

/* 从SD卡中读一个块偏移为offset 的长整形数据  */
extern INT32U SD_Read_Dword(INT32U blockaddr,INT16U offset);

/* 从SD卡中读多个块*/
extern INT8U SD_ReadMultiBlock(INT32U blockaddr,INT32U blocknum,INT8U *recbuf);

/* 向SD卡中写入一个块  */
extern INT8U SD_WriteBlock(INT32U blockaddr,INT8U *recbuf);

/* 向SD卡中写入多个块*/
extern INT8U SD_WriteMultiBlock(INT32U blockaddr,INT32U blocknum,INT8U *recbuf);

/* 擦除SD卡中的块  */
extern INT8U SD_EraseBlock(INT32U startaddr,INT32U blocknum);

/* 得到SD卡信息  */
extern INT8U SD_GetCardInfo(void);

/* 由CSD寄存器计算超时时间  */
extern void SD_CalTimeout(INT8U *csdbuf);

/* 激活SD卡内部进行初始化处理  */
extern INT8U SD_ActiveInit(void);

/* 得到SD的版本号 */	
extern INT16U SD_GetSDVer(void);

#endif