sdhal.h

SD卡驱动程序。周立功单片机公司开发板提供的标准例程。

/****************************************Copyright (c)**************************************************
**                               Guangzhou ZLG-MCU Development Co.,LTD.
**                                      graduate school
**                                 http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name:			sdhal.h
** Last modified Date:	2005-3-11
** Last Version:		V2.0
** Descriptions:		SD/MMC卡读写模块 ---- 硬件抽象层文件头文件
**
**
**------------------------------------------------------------------------------------------------------
** Created by:			Ming Yuan Zheng
** Created date:		2005-1-6
** Version:				V1.0
** Descriptions:		The original version
**
**------------------------------------------------------------------------------------------------------
** Modified by:			
** Modified date:		
** Version:				
** Descriptions:		
**
**------------------------------------------------------------------------------------------------------
** Modified by: 
** Modified date:
** Version:	
** Descriptions: 
**
********************************************************************************************************/

#ifndef __SDHAL_H__
#define __SDHAL_H__


/*
****************************
   SD 总线模式
****************************
*/

#if SDBUS_MODE_EN

/* SD/MMC Command list, per MMC spec. SD Memory Card Spec. Simplified version */
#define GO_IDLE_STATE		0		/* GO_IDLE_STATE(MMC) or RESET(SD) */
#define SEND_OP_COND		1		/* SEND_OP_COND(MMC) or ACMD41(SD) */
#define ALL_SEND_CID		2		/* ALL SEND_CID */
#define SET_RELATIVE_ADDR	3		/* SET_RELATE_ADDR */
#define SET_ACMD_BUS_WIDTH	6
#define SELECT_CARD			7		/* SELECT/DESELECT_CARD */
#define SEND_CSD			9		/* SEND_CSD */
#define STOP_TRANSMISSION	12		/* Stop either READ or WRITE operation */
#define SEND_STATUS			13		/* SEND_STATUS */
#define SET_BLOCK_LEN		16		/* SET_BLOCK_LEN */
#define READ_SINGLE_BLOCK	17		/* READ_SINGLE_BLOCK */
#define WRITE_BLOCK			24		/* WRITE_BLOCK */
#define SEND_APP_OP_COND	41		/* ACMD41 for SD card */		
#define APP_CMD				55		/* APP_CMD, the following will a ACMD */


#define EXPECT_NO_RESP		0
#define EXPECT_SHORT_RESP	1
#define EXPECT_LONG_RESP	2


#define MCLKDIV_SLOW		0x3B
#define MCLKDIV_NORMAL		0x09


#define BLOCK_NUM			0x80		
#define FIFO_SIZE			16

/* MCI Status register bit information */
#define MCI_CMD_CRC_FAIL	1 << 0
#define MCI_DATA_CRC_FAIL	1 << 1
#define MCI_CMD_TIMEOUT		1 << 2
#define MCI_DATA_TIMEOUT	1 << 3
#define MCI_TX_UNDERRUN		1 << 4
#define MCI_RX_OVERRUN		1 << 5
#define MCI_CMD_RESP_END	1 << 6
#define MCI_CMD_SENT		1 << 7
#define MCI_DATA_END		1 << 8
#define MCI_START_BIT_ERR	1 << 9
#define MCI_DATA_BLK_END	1 << 10
#define MCI_CMD_ACTIVE		1 << 11
#define MCI_TX_ACTIVE		1 << 12
#define MCI_RX_ACTIVE		1 << 13
#define MCI_TX_HALF_EMPTY	1 << 14
#define MCI_RX_HALF_FULL	1 << 15
#define MCI_TX_FIFO_FULL	1 << 16
#define MCI_RX_FIFO_FULL	1 << 17
#define MCI_TX_FIFO_EMPTY	1 << 18
#define MCI_RX_FIFO_EMPTY	1 << 19
#define MCI_TX_DATA_AVAIL	1 << 20
#define MCI_RX_DATA_AVAIL	1 << 21

#define CMD_INT_MASK		(MCI_CMD_CRC_FAIL | MCI_CMD_TIMEOUT | MCI_CMD_RESP_END \
                             | MCI_CMD_SENT | MCI_CMD_ACTIVE)
                             
#define DATA_ERR_INT_MASK	(MCI_DATA_CRC_FAIL | MCI_DATA_TIMEOUT | MCI_TX_UNDERRUN \
			                 | MCI_RX_OVERRUN | MCI_START_BIT_ERR)
			
#define DATA_INT_MASK		(MCI_DATA_END | MCI_DATA_BLK_END | MCI_TX_ACTIVE \
			                 | MCI_RX_ACTIVE)
			                 
#define FIFO_INT_MASK		(MCI_TX_HALF_EMPTY | MCI_RX_HALF_FULL | MCI_TX_FIFO_FULL \
			               | MCI_RX_FIFO_FULL | MCI_TX_FIFO_EMPTY | MCI_RX_DATA_AVAIL \
			               | MCI_TX_DATA_AVAIL | MCI_RX_FIFO_EMPTY)
			               
#define DATA_TX_INT_MASK	MCI_DATA_CRC_FAIL | MCI_DATA_TIMEOUT | MCI_TX_UNDERRUN \
			| MCI_START_BIT_ERR | MCI_DATA_END | MCI_DATA_BLK_END | MCI_TX_ACTIVE
			
#define DATA_RX_INT_MASK	MCI_DATA_CRC_FAIL | MCI_DATA_TIMEOUT | MCI_RX_OVERRUN \
			| MCI_START_BIT_ERR | MCI_DATA_END | MCI_DATA_BLK_END | MCI_RX_ACTIVE



extern void SdHal_EnableMCIBusWidth(sd_struct *sds, INT32U bWidth);
extern INT8U SdHal_Initialize(sd_struct *sds);
extern void SdHal_OpenDrainCmd(sd_struct *sds, INT8U bOpenDrain);


extern void SdHal_SetMCIClock(sd_struct *sds, INT32U ClockRate);
extern INT8U SdHal_SendCmd(sd_struct *sds, INT8U cmd, INT32U argument, INT8U resptype, INT32U *resp, INT8U resplen);
extern INT8U SdHal_CheckCard(sd_struct *sds);
extern INT8U SdHal_CheckCardWP(sd_struct *sds);

extern INT8U SdHal_BeforeReadBlock(sd_struct *sds);
extern INT8U SdHal_ReadBlock(sd_struct *sds, INT8U *recbuf);

extern INT8U SdHal_BeforeWriteBlock(sd_struct *sds);
extern INT8U SdHal_WriteBlock(sd_struct *sds, INT8U *sendbuf);
extern INT8U SdHal_WaitReadyforData(sd_struct *sds);
extern INT8U SdHal_WaitBusy(sd_struct *sds);

extern void SdHal_EnableMCIBusWidth(sd_struct *sds, INT32U bWidth);
extern  __irq __arm void MCI_Handler(void);
#endif



/*
****************************
   SPI 总线模式
****************************
*/

#if !SDBUS_MODE_EN

/* 检测卡是否完全插入  check weather card is insert entirely */
extern INT8U SD_ChkCard(void);

/* 检测卡是否写保护  check weather card is write protect */
extern INT8U SD_ChkCardWP(void);

/* 初始化访问SD卡的硬件初始化 initialize the hardware that access sd card */
extern void SD_HardWareInit(void);

/* 设置SPI的时钟小于400kHZ set the clock of SPI less than 400kHZ */
extern void SPI_Clk400k(void);

/* 设置SPI的clock到最大值 set the clock of SPI to maximum */
extern void SPI_ClkToMax(void);

/* 通过SPI接口发送一个字节 send a byte by SPI interface */
extern void SPI_SendByte(INT8U byte);

/* 从SPI接口接收一个字节 receive a byte from SPI interface */
extern INT8U SPI_RecByte(void);

/* 片选SPI从机 select the SPI slave */
extern void SPI_CS_Assert(void);

/* 不片选SPI从机 not select the SPI slave */
extern void SPI_CS_Deassert(void);

#endif


#endif