stm32f10x_sdio.c

stm32f10xx的中文译文例程

  SDIO->POWER |= SDIO_PowerState;
}

/*******************************************************************************
* 函数名称: SDIO_GetPowerState
* 功能描述: Gets the power status of the controller[取得控制器的电源状态].
* 输入参数: 无
* 输出参数: 无
* 返回参数: Power status of the controller[控制器的电源状态]. The returned value can
*                  be one of the following:[返回值可以是下面的值之一]
*                       - 0x00: Power OFF
*                       - 0x02: Power UP
*                       - 0x03: Power ON 
*******************************************************************************/
u32 SDIO_GetPowerState(void)
{
  return (SDIO->POWER & (~PWR_PWRCTRL_MASK));
}

/*******************************************************************************
* 函数名称: SDIO_ITConfig
* 功能描述: Enables or disables the SDIO interrupts.[使能或禁止SDIO中断]
* 输入参数: (1) SDIO_IT: specifies the SDIO interrupt sources to be
*                    enabled or disabled.[使能或禁止指定的SDIO中断源]
*                    This parameter can be one or a combination of the following
*                    values:[这个参数可以使用下述值的一个或者几个值的组合]
*                      - SDIO_IT_CCRCFAIL: Command response received (CRC check
*                                          failed) interrupt[命令响应接收(CRC校验失败)中断]    
*                      - SDIO_IT_DCRCFAIL: Data block sent/received (CRC check 
*                                          failed) interrupt[数据块发送/接收(CRC校验失败)中断]    
*                      - SDIO_IT_CTIMEOUT: Command response timeout interrupt[命令响应超时中断]     
*                      - SDIO_IT_DTIMEOUT: Data timeout interrupt[数据超时中断]     
*                      - SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt[发送FIFO空栈读出错中断]    
*                      - SDIO_IT_RXOVERR:  Received FIFO overrun error interrupt[接收FIFO超速出错中断]      
*                      - SDIO_IT_CMDREND:  Command response received (CRC check 
*                                          passed) interrupt[命令响应接收(CRC校验通过)中断]     
*                      - SDIO_IT_CMDSENT:  Command sent (no response required) 
*                                          interrupt[命令发送(缺少必要的响应)中断]     
*                      - SDIO_IT_DATAEND:  Data end (data counter, SDIDCOUNT, is 
*                                          zero) interrupt [数据结束(数据计数器，SDIO计数器等于零)中断]    
*                      - SDIO_IT_STBITERR: Start bit not detected on all data [在宽总线模式中从所有的数据信号中找不到开始位中断]
*                                          signals in wide bus mode interrupt    
*                      - SDIO_IT_DBCKEND:  Data block sent/received (CRC check 
*                                          passed) interrupt[数据块发送/接收(CRC校验通过)中断]    
*                      - SDIO_IT_CMDACT:   Command transfer in progress interrupt[命令发送过程 中断]     
*                      - SDIO_IT_TXACT:    Data transmit in progress interrupt[数据发送过程 中断]       
*                      - SDIO_IT_RXACT:    Data receive in progress interrupt[数据接收过程 中断]      
*                      - SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt[发送FIFO半空 中断]    
*                      - SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt[接收FIFO半满 中断]   
*                      - SDIO_IT_TXFIFOF:  Transmit FIFO full interrupt[发送FIFO满 中断]     
*                      - SDIO_IT_RXFIFOF:  Receive FIFO full interrupt[接收FIFO满 中断]     
*                      - SDIO_IT_TXFIFOE:  Transmit FIFO empty interrupt[发送FIFO空 中断]      
*                      - SDIO_IT_RXFIFOE:  Receive FIFO empty interrupt[接收FIFO空 中断]     
*                      - SDIO_IT_TXDAVL:   Data available in transmit FIFO interrupt[发送FIFO中数据可用 中断]      
*                      - SDIO_IT_RXDAVL:   Data available in receive FIFO interrupt[接收FIFO中数据可用 中断]      
*                      - SDIO_IT_SDIOIT:   SD I/O interrupt received interrupt[SD I/O中断 接收中断]      
*                      - SDIO_IT_CEATAEND: CE-ATA command completion signal[CMD61的CE-ATA命令完成信号接收中断] 
*                                          received for CMD61 interrupt
*           (2) NewState: new state of the specified SDIO interrupts.[指定的SDIO中断的新状态]
*                  This parameter can be: ENABLE or DISABLE.[这个参数可以是：ENABLE or DISABLE]  
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void SDIO_ITConfig(u32 SDIO_IT, FunctionalState NewState)
{
  /* Check the parameters [检查参数]*/
  assert_param(IS_SDIO_IT(SDIO_IT));
  assert_param(IS_FUNCTIONAL_STATE(NewState));
  
  if (NewState != DISABLE)
  {
    /* Enable the SDIO interrupts [使能SDIO中断]*/
    SDIO->MASK |= SDIO_IT;
  }
  else
  {
    /* Disable the SDIO interrupts [禁止SDIO中断]*/
    SDIO->MASK &= ~SDIO_IT;
  } 
}

/*******************************************************************************
* 函数名称: SDIO_DMACmd
* 功能描述: Enables or disables the SDIO DMA request.[使能或禁止SDIO DMA请求]
* 输入参数: NewState: new state of the selected SDIO DMA request.[指定SDIO DMA 请求的新状态]
*                  This parameter can be: ENABLE or DISABLE.[这个参数可以是：ENABLE or DISABLE]
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void SDIO_DMACmd(FunctionalState NewState)
{
  /* Check the parameters [检查参数]*/
  assert_param(IS_FUNCTIONAL_STATE(NewState));
  
  *(vu32 *) DCTRL_DMAEN_BB = (u32)NewState;
}

/*******************************************************************************
* 函数名称: SDIO_SendCommand
* 功能描述: Initializes the SDIO Command according to the specified[依照SDIO_CmdInitStruct和发送命令中指定的参数初始化SDIO命令]
*                  parameters in the SDIO_CmdInitStruct and send the command.
* 输入参数: SDIO_CmdInitStruct : pointer to a SDIO_CmdInitTypeDef
*                  structure that contains the configuration information 
*                  for the SDIO command.[指向包含着SDIO命令配置信息的结构体SDIO_CmdInitTypeDef的指针]
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void SDIO_SendCommand(SDIO_CmdInitTypeDef *SDIO_CmdInitStruct)
{
  u32 tmpreg = 0;
  
  /* Check the parameters [检查参数]*/
  assert_param(IS_SDIO_CMD_INDEX(SDIO_CmdInitStruct->SDIO_CmdIndex));
  assert_param(IS_SDIO_RESPONSE(SDIO_CmdInitStruct->SDIO_Response));
  assert_param(IS_SDIO_WAIT(SDIO_CmdInitStruct->SDIO_Wait));
  assert_param(IS_SDIO_CPSM(SDIO_CmdInitStruct->SDIO_CPSM));
  
/*---------------------------- SDIO ARG Configuration ------------------------*/
  /* Set the SDIO Argument value [设置SDIO参数值]*/
  SDIO->ARG = SDIO_CmdInitStruct->SDIO_Argument;
  
/*---------------------------- SDIO CMD Configuration ------------------------*/  
  /* Get the SDIO CMD value [取得SDIO CMD值]*/
  tmpreg = SDIO->CMD;

  /* Clear CMDINDEX, WAITRESP, WAITINT, WAITPEND, CPSMEN bits [清CMDINDEX, WAITRESP, WAITINT, WAITPEND, CPSMEN位]*/
  tmpreg &= CMD_CLEAR_MASK;
  /* Set CMDINDEX bits according to SDIO_CmdIndex value [依照SDIO_CmdIndex的值设置CMDINDEX位]*/
  /* Set WAITRESP bits according to SDIO_Response value [依照SDIO_Response的值设置WAITRESP位]*/
  /* Set WAITINT and WAITPEND bits according to SDIO_Wait value [依照SDIO_Wait的值设置WAITINT和WAITPEND位]*/
  /* Set CPSMEN bits according to SDIO_CPSM value [依照SDIO_CPSM的值设置CPSMEN位]*/
  tmpreg |= (u32)SDIO_CmdInitStruct->SDIO_CmdIndex | SDIO_CmdInitStruct->SDIO_Response
           | SDIO_CmdInitStruct->SDIO_Wait | SDIO_CmdInitStruct->SDIO_CPSM;
  
  /* Write to SDIO CMD [写SDIO CMD]*/
  SDIO->CMD = tmpreg;
}

/*******************************************************************************
* 函数名称: SDIO_CmdStructInit
* 功能描述: Fills each SDIO_CmdInitStruct member with its default value.[用默认值填充SDIO_CmdInitStruct的每一个成员]
* 输入参数: SDIO_CmdInitStruct: pointer to an SDIO_CmdInitTypeDef
*                  structure which will be initialized.[指向将要被初始化的结构体SDIO_CmdInitTypeDef的指针]
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void SDIO_CmdStructInit(SDIO_CmdInitTypeDef* SDIO_CmdInitStruct)
{
  /* SDIO_CmdInitStruct members default value [SDIO_CmdInitStruct成员的默认值]*/
  SDIO_CmdInitStruct->SDIO_Argument = 0x00;
  SDIO_CmdInitStruct->SDIO_CmdIndex = 0x00;
  SDIO_CmdInitStruct->SDIO_Response = SDIO_Response_No;
  SDIO_CmdInitStruct->SDIO_Wait = SDIO_Wait_No;
  SDIO_CmdInitStruct->SDIO_CPSM = SDIO_CPSM_Disable;
}

/*******************************************************************************
* 函数名称: SDIO_GetCommandResponse
* 功能描述: Returns command index of last command for which response
*                  received.[返回最新接收响应命令的命令序号]
* 输入参数: 无
* 输出参数: 无
* 返回参数: Returns the command index of the last command response received.[返回最新接收响应命令的命令序号]
*******************************************************************************/
u8 SDIO_GetCommandResponse(void)
{
  return (u8)(SDIO->RESPCMD);
}

/*******************************************************************************
* 函数名称: SDIO_GetResponse
* 功能描述: Returns response received from the card for the last command.[返回最新命令卡的接收响应]
* 输入参数: - SDIO_RESP: Specifies the SDIO response register.[指定的SDIO响应寄存器]
*                     这个参数可以是下面的值之一:
*                       - SDIO_RESP1: Response Register 1[响应寄存器1]
*                       - SDIO_RESP2: Response Register 2[响应寄存器2]
*                       - SDIO_RESP3: Response Register 3[响应寄存器3]
*                       - SDIO_RESP4: Response Register 4[响应寄存器4]                       
* 输出参数: 无
* 返回参数: The Corresponding response register value.[相应的响应寄存器值]
*******************************************************************************/
u32 SDIO_GetResponse(u32 SDIO_RESP)
{
  /* Check the parameters [检查参数]*/
  assert_param(IS_SDIO_RESP(SDIO_RESP));
  
  return (*(vu32 *)(SDIO_RESP_ADDR + SDIO_RESP)); 
}

/*******************************************************************************
* 函数名称: SDIO_DataConfig
* 功能描述: Initializes the SDIO data path according to the specified
*                  parameters in the SDIO_DataInitStruct.[依照SDIO_DataInitStruct中指定的参数初始化SDIO数据路径]
* 输入参数: SDIO_DataInitStruct : pointer to a SDIO_DataInitTypeDef
*                  structure that contains the configuration information 
*                  for the SDIO command.[指向包含着SDIO命令配置信息的结构体SDIO_DataInitTypeDef的指针]
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void SDIO_DataConfig(SDIO_DataInitTypeDef* SDIO_DataInitStruct)
{
  u32 tmpreg = 0;
  
  /* Check the parameters [检查参数]*/
  assert_param(IS_SDIO_DATA_LENGTH(SDIO_DataInitStruct->SDIO_DataLength));
  assert_param(IS_SDIO_BLOCK_SIZE(SDIO_DataInitStruct->SDIO_DataBlockSize));
  assert_param(IS_SDIO_TRANSFER_DIR(SDIO_DataInitStruct->SDIO_TransferDir));
  assert_param(IS_SDIO_TRANSFER_MODE(SDIO_DataInitStruct->SDIO_TransferMode));