sdcmd.c

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

*******************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Send_Status()				
**
** 功能描述: CMD13, 读取卡当前状态, 当卡进入数据传输模式后(即从识别模式进入该模式后), 就可以使用本函数		
**
** 输　  入: sd_struct *sds  : SD/MMC卡信息结构体
**	
** 输 　 出: INT32U *status  : 卡状态
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
**
** 注	 意: 该命令需要 sds->RCA 作为命令参数
********************************************************************************************************************/
INT8U SdCmd_Send_Status(sd_struct *sds, INT32U *status)
{
	INT32U resp;
	INT8U ret;
	
	ret = SdHal_SendCmd(sds, CMD13, sds->RCA, CMD13_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	*status = resp;
	return SD_NO_ERR;
}

		
/*********************************************
    CMD 15: 使卡进入非活动状态
*********************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Go_Inactive_State()				
**
** 功能描述: CMD15, 使卡进入非活动状态	
**
** 输　  入: sd_struct *sds  : SD/MMC卡信息结构体
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
**
** 注	 意: 该命令需要 sds->RCA 作为命令参数
********************************************************************************************************************/
INT8U SdCmd_Go_Inactive_State(sd_struct *sds)
{
	INT32U resp;
	INT8U ret;

	ret = SdHal_SendCmd(sds, CMD15, sds->RCA, CMD15_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	return SD_NO_ERR;	
}


/*********************************************
    CMD 16: 设置块长度, 必须发送CMD7后发送
*********************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Set_BlockLen()				
**
** 功能描述: CMD16, 设置卡的块长度	
**
** 输　  入: sd_struct *sds  : SD/MMC卡信息结构体
**           INT32U blockLen : 卡块的长度
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Set_BlockLen(sd_struct *sds, INT32U blockLen)
{
	INT32U resp;
	INT8U ret;

	ret = SdHal_SendCmd(sds, CMD16, blockLen, CMD16_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
		
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;	
}


/**************************************
	ACMD6: 设置总线宽度, 只适合于SD卡
***************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Set_Bus_Width()				
**
** 功能描述: ACMD6, 设置卡传输数据的总线宽度(对于SD卡, 可以为1bit, 也可以为4bits)
**			 对于MMC卡, 本命令无效			
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT8U bWideBus:  是否使能宽总线(4bit data bus).
**							  1:  使能       0: 禁止
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Set_Bus_Width(sd_struct *sds, INT8U bWideBus)
{
	INT32U argument;
	INT32U resp;
	INT8U ret;
	
	if (bWideBus > 0)
		argument = 0x02;		// '02' = 4bits data bus
	else
		argument = 0x0;			// '00'	= 1bit data bus

    ret = SdCmd_Send_ACMD(sds);
	if (ret != SD_NO_ERR)
		return ret;

	ret = SdHal_SendCmd(sds, ACMD6, argument, ACMD6_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;		
}


/***********************************
  CMD17: 发送读单块命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Read_Single_Block()				
**
** 功能描述: CMD17, 发送读单块命令
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址. 0 ~ 511字节取值为1. 512 ~ 1023字节取值为2
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Read_Single_Block(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
				
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;
	
	ret = SdHal_SendCmd(sds, CMD17, blockadddr, CMD17_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;
}


/***********************************
  CMD18: 发送读多块命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Read_Multiple_Block()				
**
** 功能描述: CMD18, 发送读多块命令
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Read_Multiple_Block(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
	
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;       
		
	ret = SdHal_SendCmd(sds, CMD18, blockadddr, CMD18_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;
}


/***********************************
  CMD24: 发送写单块命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Write_Single_Block()				
**
** 功能描述: CMD24, 发送写单块命令
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Write_Single_Block(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
	
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;
	
	ret = SdHal_SendCmd(sds, CMD24, blockadddr, CMD24_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
	
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;		
}


/***********************************
  CMD25: 发送写多块命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Write_Multiple_Block()				
**
** 功能描述: CMD25, 发送写多块命令
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Write_Multiple_Block(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
		
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;
	
	ret = SdHal_SendCmd(sds, CMD25, blockadddr, CMD25_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
		
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;		
}



/***********************************
  CMD32: 设置擦卡起始地址
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Erase_Wr_Blk_Start()				
**
** 功能描述: CMD32, 设置第一个写模块地址来擦除
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Erase_Wr_Blk_Start(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
		
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;

    if (sds->card_type == CARDTYPE_SD)
    	ret = SdHal_SendCmd(sds, CMD32, blockadddr, CMD32_R, &resp, 1);
	else
	    ret = SdHal_SendCmd(sds, CMD35, blockadddr, CMD35_R, &resp, 1);
	
    if (ret != SD_NO_ERR)
        return ret;
		
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;		
}


/***********************************
  CMD33: 发送写多块命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Erase_Wr_Blk_End()				
**
** 功能描述: CMD32, 设置第一个写模块地址来擦除
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**           INT32U blockadddr:  块地址
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Erase_Wr_Blk_End(sd_struct *sds, INT32U blockadddr)
{
	INT8U ret;
	INT32U resp;
		
	blockadddr = blockadddr << SD_BLOCKSIZE_NBITS;
	
	if (sds->card_type == CARDTYPE_SD)
	    ret = SdHal_SendCmd(sds, CMD33, blockadddr, CMD33_R, &resp, 1);
	else
	    ret = SdHal_SendCmd(sds, CMD36, blockadddr, CMD36_R, &resp, 1);     
	    	    
	if (ret != SD_NO_ERR)
		return ret;
		
	/* bit 9 through 12 should be in transfer state now. bit 8 is ready. */
	if ((resp & CARD_STATUS_CURRENT_STATE) != CARD_STATUS_TRAN)	 
	    return SD_ERR_CURRENT_STATE;
	 
	if (!(resp & CARD_STATUS_RDY_DATA))	     
	    return SD_ERR_READY_FOR_DATA;
	
	return SD_NO_ERR;		
}


/***********************************
  CMD38: 发送擦卡命令
************************************/
/*******************************************************************************************************************
** 函数名称: SdCmd_Erase()				
**
** 功能描述: CMD38, 擦除CMD32和CMD33指定的块
**
** 输　  入: sd_struct *sds:  SD/MMC卡信息结构体
**
**	
** 输 　 出: 无
**
** 返 回 值: 0:   正确    >0:   错误码, 见 sddriver.h 文件
********************************************************************************************************************/
INT8U SdCmd_Erase(sd_struct *sds)
{
	INT8U ret;
	INT32U resp;
		
	ret = SdHal_SendCmd(sds, CMD38, 0, CMD38_R, &resp, 1);
	if (ret != SD_NO_ERR)
		return ret;
		
    ret = SdHal_WaitBusy(sds);                          /* 等待卡编程结束 */
	return ret;		
}


// 将32位字转换为字节函数
static void word_to_byte(INT32U value, INT8U *pdst)
{
    pdst[0] = (INT8U)(value >> 24);
    pdst[1] = (INT8U)(value >> 16);
    pdst[2] = (INT8U)(value >> 8);
    pdst[3] = (INT8U)(value);
}