/****************************************Copyright (c)**************************************************
**                               Guangzhou ZLG-MCU Development Co.,LTD.
**                                      graduate school
**                                 http://www.zlgmcu.com
**
**--------------File Info-------------------------------------------------------------------------------
** File name:			sddriver.c
** Last modified Date:	2005-1-6
** Last Version:		V1.0
** Descriptions:		sd 卡驅(qū)動(dòng)軟件包: SD卡物理層 ---- SD卡SPI模式支持的命令 
**						Soft Packet of SD Card Driver: commands that sd card supported in spi mode
**
**------------------------------------------------------------------------------------------------------
** 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: 
**
********************************************************************************************************/

#include "config.h"
#include "sdconfig.h"
#include "sdhal.h"
#include "sdcrc.h"
#include "sdcmd.h"
#include "sddriver.h"

/********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_SendCmd()						Name:	  INT8U SD_SendCmd()
** 功能描述: 向卡發(fā)送命令,并取得響應(yīng)				Function: send command to the card,and get a response
** 輸　  入: INT8U cmd	    : 命令字				Input:	  INT8U cmd	    : command byte	
			 INT8U *param	: 命令參數(shù),長度為4字節(jié)			  INT8U *param	: command parameter,length is 4 bytes  
			 INT8U resptype : 響應(yīng)類型						  INT8U resptype: response type
			 INT8U *resp	: 響應(yīng),長度為1-5字節(jié)			  INT8U *resp	: response,length is 1-5 bytes
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
********************************************************************************************************************/
INT8U SD_SendCmd(INT8U cmd, INT8U *param, INT8U resptype, INT8U *resp)
{
	INT32 i,rlen;
	INT8U tmp;
    
	SPI_CS_Assert();
   
    SPI_SendByte((cmd & 0x3F) | 0x40);				 /* 發(fā)送命令頭和命令字 send command header and word */
    
    for (i = 3; i >= 0; i--)
        SPI_SendByte(param[i]);						 /* 發(fā)送參數(shù) send parameters */

#if SD_CRC_EN
	tmp = SD_GetCmdByte6((cmd & 0x3F) | 0x40, param);
	SPI_SendByte(tmp);
#else
    SPI_SendByte(0x95);							 	 /* CRC校驗(yàn)碼,只用于第1個(gè)命令 CRC,only used for the first command */
#endif 
    
    rlen = 0;
    switch (resptype)								 /* 根據(jù)不同的命令,得到不同的響應(yīng)長度 */
    {												 /* according various command,get the various response length */
  		case R1:
   	 	case R1B: rlen = 1;  break;
       		 
    	case R2:  rlen = 2;	 break;
       		 
   		case R3:  rlen = 5;	 break;
       		 
    	default:  SPI_SendByte(0xFF);	
      		      SPI_CS_Deassert();						 
        	      return SD_ERR_CMD_RESPTYPE;		 /* 返回命令響應(yīng)類型錯(cuò)誤 return error of command response type */
    		      break;
    }
    
    i = 0;				
    do 												 /* 等待響應(yīng),響應(yīng)的開始位為0 */
    {												 /* Wait for a response,a response is a start bit(zero) */ 
        tmp = SPI_RecByte();
        i++;
    }while (((tmp & 0x80) != 0) && (i < SD_CMD_TIMEOUT));
    
    if (i >= SD_CMD_TIMEOUT)
    {												 
        SPI_CS_Deassert();
        return SD_ERR_CMD_TIMEOUT;					 /* 返回命令超時(shí) return response timeout of command */
    }
    
    for (i = rlen - 1; i >= 0; i--)
    {
        resp[i] = tmp;
        tmp = SPI_RecByte();					 	 /* 循環(huán)的最后發(fā)送8clock  at the last recycle,clock out 8 clock */
    }
      
    SPI_CS_Deassert();
    return SD_NO_ERR;								 /* 返回執(zhí)行成功 return perform sucessfully */
}

/********************************************************************************************************************
** 函數(shù)名稱: void SD_PackParam()					Name:	  void SD_PackParam()
** 功能描述: 將32位的參數(shù)轉(zhuǎn)為字節(jié)形式				Function: change 32bit parameter to bytes form 
** 輸　  入: INT8U *parameter: 字節(jié)參數(shù)緩沖區(qū)		Input:	  INT8U *parameter: the buffer of bytes parameter
			 INT32U value    : 32位參數(shù)						  INT32U value    : 32bit parameter
** 輸 　 出: 無										Output:	  NULL
*********************************************************************************************************************/
void SD_PackParam(INT8U *parameter, INT32U value)
{
    parameter[3] = (INT8U)(value >> 24);
    parameter[2] = (INT8U)(value >> 16);
    parameter[1] = (INT8U)(value >> 8);
    parameter[0] = (INT8U)(value);
}

/********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_BlockCommand()				Name:	  INT8U SD_BlockCommand()
** 功能描述: 塊命令									Function: command about block operation
** 輸　  入: INT8U cmd	     : 命令字				Input:	  INT8U cmd	      : command byte 
			 INT8U resptype  : 響應(yīng)類型						  INT8U resptype  : response type
			 INT32U parameter: 塊操作參數(shù)			 		  INT32U parameter: parameter of block operation
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
*********************************************************************************************************************/
INT8U SD_BlockCommand(INT8U cmd, INT8U resptype, INT32U parameter)
{
	INT8U param[4],resp,ret;
	
	parameter <<= SD_BLOCKSIZE_NBITS;					 /* 調(diào)整地址:左移9位 adjust address: move 9 bits left */

	SD_PackParam(param, parameter);						 /* 將參數(shù)轉(zhuǎn)化為字節(jié)形式 change the parameter to bytes form */	

	ret = SD_SendCmd(cmd, param, resptype, &resp);
	if (ret != SD_NO_ERR)
	   	 return ret;							 		 /* 結(jié)束數(shù)據(jù)傳輸失敗 stop transmission operation fail */
	
	if (resp != 0)
		 return SD_ERR_CMD_RESP;		 				 /* 響應(yīng)錯(cuò)誤 response is error */
		 
	return SD_NO_ERR;
}

	/*
	************************************************
	
	 	下面為SD卡SPI命令

	************************************************
	*/
	
/********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_ResetSD()						Name:	  INT8U SD_ResetSD()
** 功能描述: 復(fù)位SD卡								Function: reset sd card
** 輸　  入: 無										Input:	  NULL
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
*********************************************************************************************************************/
INT8U SD_ResetSD(void)
{
	INT8U param[4] = {0,0,0,0},resp;
	
    return (SD_SendCmd(CMD0, param, CMD0_R, &resp));	/* 復(fù)位命令 command that reset sd card */
}

/********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_ReadCSD()						Name:	  INT8U SD_ReadCSD()
** 功能描述: 讀SD卡的CSD寄存器						Function: read CSD register of sd card 
** 輸　  入: INT8U csdlen  : 寄存器長度(固定為16)			  INT8U csdlen  : len of register (fixed,is 16)
			 INT8U *recbuf : 接收緩沖區(qū)					      INT8U *recbuf : recbuffer	
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
*********************************************************************************************************************/
INT8U SD_ReadCSD(INT8U csdlen, INT8U *recbuf)
{
    INT8U param[4] = {0,0,0,0},resp,ret;
  
    ret = SD_SendCmd(CMD9, param, CMD9_R, &resp);		/* 讀CSD寄存器命令 command that read CSD register */
    if (ret != SD_NO_ERR) 									
        return ret;									
  
    if (resp != 0)
        return SD_ERR_CMD_RESP;							/* 響應(yīng)錯(cuò)誤 response is error */
    
	return (SD_ReadRegister(csdlen, recbuf));
}

/*******************************************************************************************************************
** 函數(shù)名稱: INT8U SD_ReadCID()						Name:	  INT8U SD_ReadCID()
** 功能描述: 讀SD卡的CID寄存器						Function: read CID register of sd card
** 輸　  入: INT8U cidlen  : 寄存器長度(固定為16)			  INT8U cidlen  : len of register (fixed,is 16)
			 INT8U *recbuf : 接收緩沖區(qū)					      INT8U *recbuf : recbuffer	
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
********************************************************************************************************************/
#if SD_ReadCID_EN
INT8U SD_ReadCID(INT8U cidlen, INT8U *recbuf)
{
    INT8U param[4] = {0,0,0,0},resp,ret;
 
    ret = SD_SendCmd(CMD10, param, CMD10_R, &resp);		/* 讀CID寄存器命令 command that read CID register */
    if ( ret != SD_NO_ERR)
   		return ret;			  									
   
    if (resp != 0)
        return SD_ERR_CMD_RESP;							/* 響應(yīng)錯(cuò)誤 response is error */
      
  	return (SD_ReadRegister(cidlen, recbuf));
}
#endif

/********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_StopTransmission()			Name:	  INT8U SD_StopTransmission()
** 功能描述: 停止數(shù)據(jù)傳輸							Function: stop data transmission 
** 輸　  入: 無								 		Input:    NULL
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
*********************************************************************************************************************/
INT8U SD_StopTransmission(void)
{
	INT8U param[4] = {0,0,0,0},resp;
	
 	return (SD_SendCmd(CMD12, param, CMD12_R, &resp));	/* 結(jié)束數(shù)據(jù)傳輸命令失敗 stop transmission command fail */
}

/*********************************************************************************************************************
** 函數(shù)名稱: INT8U SD_ReadCard_Status()				Name:	  INT8U SD_ReadCard_Status()
** 功能描述: 讀SD卡的 Card Status 寄存器			Function: read Card Status register of sd card 
** 輸　  入: INT8U len: 	 寄存器長度(固定為2)			  INT8U len:      len of register (fixed,is 2)
			 INT8U *recbuf : 接收緩沖區(qū)					      INT8U *recbuf : recbuffer
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
**********************************************************************************************************************/
INT8U SD_ReadCard_Status(INT8U len, INT8U *buffer)
{
    INT8U param[4] = {0,0,0,0};

    return (SD_SendCmd(CMD13, param, CMD13_R, buffer)); /* 讀 Card Status 寄存器 */
    									 	 			/* read register of Card Status */
}


/********************************************************************************************************************
** 函數(shù)名稱: INT8U Sd_SetBlockLen()					Name:	  INT8U Sd_SetBlockLen()
** 功能描述: 設(shè)置一個(gè)塊的長度						Function: set a block len of sd card 
** 輸　  入: INT32U length	: 塊的長度值			Input:	  INT32U length	: the length of a block
** 輸 　 出: 0:   正確    >0:   錯(cuò)誤碼		  		Output:	  0:  right		>0:  error code
*********************************************************************************************************************/
INT8U SD_SetBlockLen(INT32U length)
{
	INT8U param[4],resp,ret;
  
    SD_PackParam(param, length);					/* 將參數(shù)轉(zhuǎn)化為字節(jié)形式 change the parameter to bytes form */
          												
    ret = SD_SendCmd(CMD16, param, CMD16_R, &resp);
    if (ret != SD_NO_ERR)
 		return ret;									/* 設(shè)置塊的長度為length失敗 set the length of block to length fail */
	
	if (resp != 0)
    	return SD_ERR_CMD_RESP;			   			/* 響應(yīng)錯(cuò)誤 response is error */
    
    return SD_NO_ERR; 								/* 返回執(zhí)行成功 return perform sucessfully */			
}