text: /*!
      \file    gd32f4xx_sdio.c
      \brief   SDIO driver
  
      \version 2016-08-15, V1.0.0, firmware for GD32F4xx
      \version 2018-12-12, V2.0.1, firmware for GD32F4xx
      \version 2020-09-30, V2.1.0, firmware for GD32F4xx
  */
  
  /*
      Copyright (c) 2020, GigaDevice Semiconductor Inc.
  
      Redistribution and use in source and binary forms, with or without modification,
  are permitted provided that the following conditions are met:
  
      1. Redistributions of source code must retain the above copyright notice, this
         list of conditions and the following disclaimer.
      2. Redistributions in binary form must reproduce the above copyright notice,
         this list of conditions and the following disclaimer in the documentation
         and/or other materials provided with the distribution.
      3. Neither the name of the copyright holder nor the names of its contributors
         may be used to endorse or promote products derived from this software without
         specific prior written permission.
  
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
  OF SUCH DAMAGE.
  */
  
  #include "gd32f4xx_sdio.h"
  
  /*!
      \brief      deinitialize the SDIO
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_deinit(void)
  {
      rcu_periph_reset_enable(RCU_SDIORST);
      rcu_periph_reset_disable(RCU_SDIORST);
  }
  
  /*!
      \brief      configure the SDIO clock
      \param[in]  clock_edge: SDIO_CLK clock edge
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_SDIOCLKEDGE_RISING: select the rising edge of the SDIOCLK to generate SDIO_CLK
        \arg        SDIO_SDIOCLKEDGE_FALLING: select the falling edge of the SDIOCLK to generate SDIO_CLK
      \param[in]  clock_bypass: clock bypass
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_CLOCKBYPASS_ENABLE: clock bypass
        \arg        SDIO_CLOCKBYPASS_DISABLE: no bypass
      \param[in]  clock_powersave: SDIO_CLK clock dynamic switch on/off for power saving
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_CLOCKPWRSAVE_ENABLE: SDIO_CLK closed when bus is idle
        \arg        SDIO_CLOCKPWRSAVE_DISABLE: SDIO_CLK clock is always on
      \param[in]  clock_division: clock division, less than 512
      \param[out] none
      \retval     none
  */
  void sdio_clock_config(uint32_t clock_edge, uint32_t clock_bypass, uint32_t clock_powersave, uint16_t clock_division)
  {
      uint32_t clock_config = 0U;
      clock_config = SDIO_CLKCTL;
      /* reset the CLKEDGE, CLKBYP, CLKPWRSAV, DIV */
      clock_config &= ~(SDIO_CLKCTL_CLKEDGE | SDIO_CLKCTL_CLKBYP | SDIO_CLKCTL_CLKPWRSAV | SDIO_CLKCTL_DIV8 | SDIO_CLKCTL_DIV);
      /* if the clock division is greater or equal to 256, set the DIV[8] */
      if(clock_division >= 256U){
          clock_config |= SDIO_CLKCTL_DIV8;
          clock_division -= 256U;
      }
      /* configure the SDIO_CLKCTL according to the parameters */
      clock_config |= (clock_edge | clock_bypass | clock_powersave | clock_division);
      SDIO_CLKCTL = clock_config;
  }
  
  /*!
      \brief      enable hardware clock control
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_hardware_clock_enable(void)
  {
      SDIO_CLKCTL |= SDIO_CLKCTL_HWCLKEN;
  }
  
  /*!
      \brief      disable hardware clock control
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_hardware_clock_disable(void)
  {
      SDIO_CLKCTL &= ~SDIO_CLKCTL_HWCLKEN;
  }
  
  /*!
      \brief      set different SDIO card bus mode
      \param[in]  bus_mode: SDIO card bus mode
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_BUSMODE_1BIT: 1-bit SDIO card bus mode
        \arg        SDIO_BUSMODE_4BIT: 4-bit SDIO card bus mode
        \arg        SDIO_BUSMODE_8BIT: 8-bit SDIO card bus mode
      \param[out] none
      \retval     none
  */
  void sdio_bus_mode_set(uint32_t bus_mode)
  {
      /* reset the SDIO card bus mode bits and set according to bus_mode */
      SDIO_CLKCTL &= ~SDIO_CLKCTL_BUSMODE;
      SDIO_CLKCTL |= bus_mode;
  }
  
  /*!
      \brief      set the SDIO power state
      \param[in]  power_state: SDIO power state
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_POWER_ON: SDIO power on
        \arg        SDIO_POWER_OFF: SDIO power off
      \param[out] none
      \retval     none
  */
  void sdio_power_state_set(uint32_t power_state)
  {
      SDIO_PWRCTL = power_state;
  }
  
  /*!
      \brief      get the SDIO power state
      \param[in]  none
      \param[out] none
      \retval     SDIO power state
        \arg        SDIO_POWER_ON: SDIO power on
        \arg        SDIO_POWER_OFF: SDIO power off
  */
  uint32_t sdio_power_state_get(void)
  {
      return SDIO_PWRCTL;
  }
  
  /*!
      \brief      enable SDIO_CLK clock output
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_clock_enable(void)
  {
      SDIO_CLKCTL |= SDIO_CLKCTL_CLKEN;
  }
  
  /*!
      \brief      disable SDIO_CLK clock output
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_clock_disable(void)
  {
      SDIO_CLKCTL &= ~SDIO_CLKCTL_CLKEN;
  }
  
  /*!
      \brief      configure the command and response
      \param[in]  cmd_index: command index, refer to the related specifications
      \param[in]  cmd_argument: command argument, refer to the related specifications
      \param[in]  response_type: response type
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_RESPONSETYPE_NO: no response
        \arg        SDIO_RESPONSETYPE_SHORT: short response
        \arg        SDIO_RESPONSETYPE_LONG: long response
      \param[out] none
      \retval     none
  */
  void sdio_command_response_config(uint32_t cmd_index, uint32_t cmd_argument, uint32_t response_type)
  {
      uint32_t cmd_config = 0U;
      /* disable the CSM */
      SDIO_CMDCTL &= ~SDIO_CMDCTL_CSMEN;
      /* reset the command index, command argument and response type */
      SDIO_CMDAGMT &= ~SDIO_CMDAGMT_CMDAGMT;
      SDIO_CMDAGMT = cmd_argument;
      cmd_config = SDIO_CMDCTL;
      cmd_config &= ~(SDIO_CMDCTL_CMDIDX | SDIO_CMDCTL_CMDRESP);
      /* configure SDIO_CMDCTL and SDIO_CMDAGMT according to the parameters */
      cmd_config |= (cmd_index | response_type);
      SDIO_CMDCTL = cmd_config;
  }
  
  /*!
      \brief      set the command state machine wait type
      \param[in]  wait_type: wait type
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_WAITTYPE_NO: not wait interrupt
        \arg        SDIO_WAITTYPE_INTERRUPT: wait interrupt
        \arg        SDIO_WAITTYPE_DATAEND: wait the end of data transfer
      \param[out] none
      \retval     none
  */
  void sdio_wait_type_set(uint32_t wait_type)
  {
      /* reset INTWAIT and WAITDEND */
      SDIO_CMDCTL &= ~(SDIO_CMDCTL_INTWAIT | SDIO_CMDCTL_WAITDEND);
      /* set the wait type according to wait_type */
      SDIO_CMDCTL |= wait_type;
  }
  
  /*!
      \brief      enable the CSM(command state machine)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_csm_enable(void)
  {
      SDIO_CMDCTL |= SDIO_CMDCTL_CSMEN;
  }
  
  /*!
      \brief      disable the CSM(command state machine)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_csm_disable(void)
  {
      SDIO_CMDCTL &= ~SDIO_CMDCTL_CSMEN;
  }
  
  /*!
      \brief      get the last response command index
      \param[in]  none
      \param[out] none
      \retval     last response command index
  */
  uint8_t sdio_command_index_get(void)
  {
      return (uint8_t)SDIO_RSPCMDIDX;
  }
  
  /*!
      \brief      get the response for the last received command
      \param[in]  sdio_responsex: SDIO response
                  only one parameter can be selected which is shown as below:
        \arg       SDIO_RESPONSE0: card response[31:0]/card response[127:96]
        \arg       SDIO_RESPONSE1: card response[95:64]
        \arg       SDIO_RESPONSE2: card response[63:32]
        \arg       SDIO_RESPONSE3: card response[31:1], plus bit 0
      \param[out] none
      \retval     response for the last received command
  */
  uint32_t sdio_response_get(uint32_t sdio_responsex)
  {
      uint32_t resp_content = 0U;
      switch(sdio_responsex){
      case SDIO_RESPONSE0:
          resp_content = SDIO_RESP0;
          break;
      case SDIO_RESPONSE1:
          resp_content = SDIO_RESP1;
          break;
      case SDIO_RESPONSE2:
          resp_content = SDIO_RESP2;
          break;
      case SDIO_RESPONSE3:
          resp_content = SDIO_RESP3;
          break;
      default:
          break;
      }
      return resp_content;
  }
  
  /*!
      \brief      configure the data timeout, data length and data block size
      \param[in]  data_timeout: data timeout period in card bus clock periods
      \param[in]  data_length: number of data bytes to be transferred
      \param[in]  data_blocksize: size of data block for block transfer
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_DATABLOCKSIZE_1BYTE: block size = 1 byte
        \arg        SDIO_DATABLOCKSIZE_2BYTES: block size = 2 bytes
        \arg        SDIO_DATABLOCKSIZE_4BYTES: block size = 4 bytes
        \arg        SDIO_DATABLOCKSIZE_8BYTES: block size = 8 bytes
        \arg        SDIO_DATABLOCKSIZE_16BYTES: block size = 16 bytes
        \arg        SDIO_DATABLOCKSIZE_32BYTES: block size = 32 bytes
        \arg        SDIO_DATABLOCKSIZE_64BYTES: block size = 64 bytes
        \arg        SDIO_DATABLOCKSIZE_128BYTES: block size = 128 bytes
        \arg        SDIO_DATABLOCKSIZE_256BYTES: block size = 256 bytes
        \arg        SDIO_DATABLOCKSIZE_512BYTES: block size = 512 bytes
        \arg        SDIO_DATABLOCKSIZE_1024BYTES: block size = 1024 bytes
        \arg        SDIO_DATABLOCKSIZE_2048BYTES: block size = 2048 bytes
        \arg        SDIO_DATABLOCKSIZE_4096BYTES: block size = 4096 bytes
        \arg        SDIO_DATABLOCKSIZE_8192BYTES: block size = 8192 bytes
        \arg        SDIO_DATABLOCKSIZE_16384BYTES: block size = 16384 bytes
      \param[out] none
      \retval     none
  */
  void sdio_data_config(uint32_t data_timeout, uint32_t data_length, uint32_t data_blocksize)
  {
      /* reset data timeout, data length and data block size */
      SDIO_DATATO &= ~SDIO_DATATO_DATATO;
      SDIO_DATALEN &= ~SDIO_DATALEN_DATALEN;
      SDIO_DATACTL &= ~SDIO_DATACTL_BLKSZ;
      /* configure the related parameters of data */
      SDIO_DATATO = data_timeout;
      SDIO_DATALEN = data_length;
      SDIO_DATACTL |= data_blocksize;
  }
  
  /*!
      \brief      configure the data transfer mode and direction
      \param[in]  transfer_mode: mode of data transfer
                  only one parameter can be selected which is shown as below:
        \arg       SDIO_TRANSMODE_BLOCK: block transfer
        \arg       SDIO_TRANSMODE_STREAM: stream transfer or SDIO multibyte transfer
      \param[in]  transfer_direction: data transfer direction, read or write
                  only one parameter can be selected which is shown as below:
        \arg       SDIO_TRANSDIRECTION_TOCARD: write data to card
        \arg       SDIO_TRANSDIRECTION_TOSDIO: read data from card
      \param[out] none
      \retval     none
  */
  void sdio_data_transfer_config(uint32_t transfer_mode, uint32_t transfer_direction)
  {
      uint32_t data_trans = 0U;
      /* reset the data transfer mode, transfer direction and set according to the parameters */
      data_trans = SDIO_DATACTL;
      data_trans &= ~(SDIO_DATACTL_TRANSMOD | SDIO_DATACTL_DATADIR);
      data_trans |= (transfer_mode | transfer_direction);
      SDIO_DATACTL = data_trans;
  }
  
  /*!
      \brief      enable the DSM(data state machine) for data transfer
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_dsm_enable(void)
  {
      SDIO_DATACTL |= SDIO_DATACTL_DATAEN;
  }
  
  /*!
      \brief      disable the DSM(data state machine)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_dsm_disable(void)
  {
      SDIO_DATACTL &= ~SDIO_DATACTL_DATAEN;
  }
  
  /*!
      \brief      write data(one word) to the transmit FIFO
      \param[in]  data: 32-bit data write to card
      \param[out] none
      \retval     none
  */
  void sdio_data_write(uint32_t data)
  {
      SDIO_FIFO = data;
  }
  
  /*!
      \brief      read data(one word) from the receive FIFO
      \param[in]  none
      \param[out] none
      \retval     received data
  */
  uint32_t sdio_data_read(void)
  {
      return SDIO_FIFO;
  }
  
  /*!
      \brief      get the number of remaining data bytes to be transferred to card
      \param[in]  none
      \param[out] none
      \retval     number of remaining data bytes to be transferred
  */
  uint32_t sdio_data_counter_get(void)
  {
      return SDIO_DATACNT;
  }
  
  /*!
      \brief      get the number of words remaining to be written or read from FIFO
      \param[in]  none
      \param[out] none
      \retval     remaining number of words
  */
  uint32_t sdio_fifo_counter_get(void)
  {
      return SDIO_FIFOCNT;
  }
  
  /*!
      \brief      enable the DMA request for SDIO
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_dma_enable(void)
  {
      SDIO_DATACTL |= SDIO_DATACTL_DMAEN;
  }
  
  /*!
      \brief      disable the DMA request for SDIO
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_dma_disable(void)
  {
      SDIO_DATACTL &= ~SDIO_DATACTL_DMAEN;
  }
  
  /*!
      \brief      get the flags state of SDIO
      \param[in]  flag: flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_FLAG_CCRCERR: command response received (CRC check failed) flag
        \arg        SDIO_FLAG_DTCRCERR: data block sent/received (CRC check failed) flag
        \arg        SDIO_FLAG_CMDTMOUT: command response timeout flag
        \arg        SDIO_FLAG_DTTMOUT: data timeout flag
        \arg        SDIO_FLAG_TXURE: transmit FIFO underrun error occurs flag
        \arg        SDIO_FLAG_RXORE: received FIFO overrun error occurs flag
        \arg        SDIO_FLAG_CMDRECV: command response received (CRC check passed) flag
        \arg        SDIO_FLAG_CMDSEND: command sent (no response required) flag
        \arg        SDIO_FLAG_DTEND: data end (data counter, SDIO_DATACNT, is zero) flag
        \arg        SDIO_FLAG_STBITE: start bit error in the bus flag
        \arg        SDIO_FLAG_DTBLKEND: data block sent/received (CRC check passed) flag
        \arg        SDIO_FLAG_CMDRUN: command transmission in progress flag
        \arg        SDIO_FLAG_TXRUN: data transmission in progress flag
        \arg        SDIO_FLAG_RXRUN: data reception in progress flag
        \arg        SDIO_FLAG_TFH: transmit FIFO is half empty flag: at least 8 words can be written into the FIFO
        \arg        SDIO_FLAG_RFH: receive FIFO is half full flag: at least 8 words can be read in the FIFO
        \arg        SDIO_FLAG_TFF: transmit FIFO is full flag
        \arg        SDIO_FLAG_RFF: receive FIFO is full flag
        \arg        SDIO_FLAG_TFE: transmit FIFO is empty flag
        \arg        SDIO_FLAG_RFE: receive FIFO is empty flag
        \arg        SDIO_FLAG_TXDTVAL: data is valid in transmit FIFO flag
        \arg        SDIO_FLAG_RXDTVAL: data is valid in receive FIFO flag
        \arg        SDIO_FLAG_SDIOINT: SD I/O interrupt received flag
        \arg        SDIO_FLAG_ATAEND: CE-ATA command completion signal received (only for CMD61) flag
      \param[out] none
      \retval     FlagStatus: SET or RESET
  */
  FlagStatus sdio_flag_get(uint32_t flag)
  {
      FlagStatus temp_flag = RESET;
      if(RESET != (SDIO_STAT & flag)){
          temp_flag = SET;
      }
      return temp_flag;
  }
  
  /*!
      \brief      clear the pending flags of SDIO
      \param[in]  flag: flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_FLAG_CCRCERR: command response received (CRC check failed) flag
        \arg        SDIO_FLAG_DTCRCERR: data block sent/received (CRC check failed) flag
        \arg        SDIO_FLAG_CMDTMOUT: command response timeout flag
        \arg        SDIO_FLAG_DTTMOUT: data timeout flag
        \arg        SDIO_FLAG_TXURE: transmit FIFO underrun error occurs flag
        \arg        SDIO_FLAG_RXORE: received FIFO overrun error occurs flag
        \arg        SDIO_FLAG_CMDRECV: command response received (CRC check passed) flag
        \arg        SDIO_FLAG_CMDSEND: command sent (no response required) flag
        \arg        SDIO_FLAG_DTEND: data end (data counter, SDIO_DATACNT, is zero) flag
        \arg        SDIO_FLAG_STBITE: start bit error in the bus flag
        \arg        SDIO_FLAG_DTBLKEND: data block sent/received (CRC check passed) flag
        \arg        SDIO_FLAG_SDIOINT: SD I/O interrupt received flag
        \arg        SDIO_FLAG_ATAEND: CE-ATA command completion signal received (only for CMD61) flag
      \param[out] none
      \retval     none
  */
  void sdio_flag_clear(uint32_t flag)
  {
      SDIO_INTC = flag;
  }
  
  /*!
      \brief      enable the SDIO interrupt
      \param[in]  int_flag: interrupt flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_INT_CCRCERR: SDIO CCRCERR interrupt
        \arg        SDIO_INT_DTCRCERR: SDIO DTCRCERR interrupt
        \arg        SDIO_INT_CMDTMOUT: SDIO CMDTMOUT interrupt
        \arg        SDIO_INT_DTTMOUT: SDIO DTTMOUT interrupt
        \arg        SDIO_INT_TXURE: SDIO TXURE interrupt
        \arg        SDIO_INT_RXORE: SDIO RXORE interrupt
        \arg        SDIO_INT_CMDRECV: SDIO CMDRECV interrupt
        \arg        SDIO_INT_CMDSEND: SDIO CMDSEND interrupt
        \arg        SDIO_INT_DTEND: SDIO DTEND interrupt
        \arg        SDIO_INT_STBITE: SDIO STBITE interrupt
        \arg        SDIO_INT_DTBLKEND: SDIO DTBLKEND interrupt
        \arg        SDIO_INT_CMDRUN: SDIO CMDRUN interrupt
        \arg        SDIO_INT_TXRUN: SDIO TXRUN interrupt
        \arg        SDIO_INT_RXRUN: SDIO RXRUN interrupt
        \arg        SDIO_INT_TFH: SDIO TFH interrupt
        \arg        SDIO_INT_RFH: SDIO RFH interrupt
        \arg        SDIO_INT_TFF: SDIO TFF interrupt
        \arg        SDIO_INT_RFF: SDIO RFF interrupt
        \arg        SDIO_INT_TFE: SDIO TFE interrupt
        \arg        SDIO_INT_RFE: SDIO RFE interrupt
        \arg        SDIO_INT_TXDTVAL: SDIO TXDTVAL interrupt
        \arg        SDIO_INT_RXDTVAL: SDIO RXDTVAL interrupt
        \arg        SDIO_INT_SDIOINT: SDIO SDIOINT interrupt
        \arg        SDIO_INT_ATAEND: SDIO ATAEND interrupt
      \param[out] none
      \retval     none
  */
  void sdio_interrupt_enable(uint32_t int_flag)
  {
      SDIO_INTEN |= int_flag;
  }
  
  /*!
      \brief      disable the SDIO interrupt
      \param[in]  int_flag: interrupt flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_INT_CCRCERR: SDIO CCRCERR interrupt
        \arg        SDIO_INT_DTCRCERR: SDIO DTCRCERR interrupt
        \arg        SDIO_INT_CMDTMOUT: SDIO CMDTMOUT interrupt
        \arg        SDIO_INT_DTTMOUT: SDIO DTTMOUT interrupt
        \arg        SDIO_INT_TXURE: SDIO TXURE interrupt
        \arg        SDIO_INT_RXORE: SDIO RXORE interrupt
        \arg        SDIO_INT_CMDRECV: SDIO CMDRECV interrupt
        \arg        SDIO_INT_CMDSEND: SDIO CMDSEND interrupt
        \arg        SDIO_INT_DTEND: SDIO DTEND interrupt
        \arg        SDIO_INT_STBITE: SDIO STBITE interrupt
        \arg        SDIO_INT_DTBLKEND: SDIO DTBLKEND interrupt
        \arg        SDIO_INT_CMDRUN: SDIO CMDRUN interrupt
        \arg        SDIO_INT_TXRUN: SDIO TXRUN interrupt
        \arg        SDIO_INT_RXRUN: SDIO RXRUN interrupt
        \arg        SDIO_INT_TFH: SDIO TFH interrupt
        \arg        SDIO_INT_RFH: SDIO RFH interrupt
        \arg        SDIO_INT_TFF: SDIO TFF interrupt
        \arg        SDIO_INT_RFF: SDIO RFF interrupt
        \arg        SDIO_INT_TFE: SDIO TFE interrupt
        \arg        SDIO_INT_RFE: SDIO RFE interrupt
        \arg        SDIO_INT_TXDTVAL: SDIO TXDTVAL interrupt
        \arg        SDIO_INT_RXDTVAL: SDIO RXDTVAL interrupt
        \arg        SDIO_INT_SDIOINT: SDIO SDIOINT interrupt
        \arg        SDIO_INT_ATAEND: SDIO ATAEND interrupt
      \param[out] none
      \retval     none
  */
  void sdio_interrupt_disable(uint32_t int_flag)
  {
      SDIO_INTEN &= ~int_flag;
  }
  
  /*!
      \brief      get the interrupt flags state of SDIO
      \param[in]  int_flag: interrupt flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_INT_FLAG_CCRCERR: SDIO CCRCERR interrupt flag
        \arg        SDIO_INT_FLAG_DTCRCERR: SDIO DTCRCERR interrupt flag
        \arg        SDIO_INT_FLAG_CMDTMOUT: SDIO CMDTMOUT interrupt flag
        \arg        SDIO_INT_FLAG_DTTMOUT: SDIO DTTMOUT interrupt flag
        \arg        SDIO_INT_FLAG_TXURE: SDIO TXURE interrupt flag
        \arg        SDIO_INT_FLAG_RXORE: SDIO RXORE interrupt flag
        \arg        SDIO_INT_FLAG_CMDRECV: SDIO CMDRECV interrupt flag
        \arg        SDIO_INT_FLAG_CMDSEND: SDIO CMDSEND interrupt flag
        \arg        SDIO_INT_FLAG_DTEND: SDIO DTEND interrupt flag
        \arg        SDIO_INT_FLAG_STBITE: SDIO STBITE interrupt flag
        \arg        SDIO_INT_FLAG_DTBLKEND: SDIO DTBLKEND interrupt flag
        \arg        SDIO_INT_FLAG_CMDRUN: SDIO CMDRUN interrupt flag
        \arg        SDIO_INT_FLAG_TXRUN: SDIO TXRUN interrupt flag
        \arg        SDIO_INT_FLAG_RXRUN: SDIO RXRUN interrupt flag
        \arg        SDIO_INT_FLAG_TFH: SDIO TFH interrupt flag
        \arg        SDIO_INT_FLAG_RFH: SDIO RFH interrupt flag
        \arg        SDIO_INT_FLAG_TFF: SDIO TFF interrupt flag
        \arg        SDIO_INT_FLAG_RFF: SDIO RFF interrupt flag
        \arg        SDIO_INT_FLAG_TFE: SDIO TFE interrupt flag
        \arg        SDIO_INT_FLAG_RFE: SDIO RFE interrupt flag
        \arg        SDIO_INT_FLAG_TXDTVAL: SDIO TXDTVAL interrupt flag
        \arg        SDIO_INT_FLAG_RXDTVAL: SDIO RXDTVAL interrupt flag
        \arg        SDIO_INT_FLAG_SDIOINT: SDIO SDIOINT interrupt flag
        \arg        SDIO_INT_FLAG_ATAEND: SDIO ATAEND interrupt flag
      \param[out] none
      \retval     FlagStatus: SET or RESET
  */
  FlagStatus sdio_interrupt_flag_get(uint32_t int_flag)
  {
      FlagStatus temp_flag = RESET;
      if(RESET != (SDIO_STAT & int_flag)){
          temp_flag = SET;
      }
      return temp_flag;
  }
  
  /*!
      \brief      clear the interrupt pending flags of SDIO
      \param[in]  int_flag: interrupt flags state of SDIO
                  one or more parameters can be selected which are shown as below:
        \arg        SDIO_INT_FLAG_CCRCERR: command response received (CRC check failed) flag
        \arg        SDIO_INT_FLAG_DTCRCERR: data block sent/received (CRC check failed) flag
        \arg        SDIO_INT_FLAG_CMDTMOUT: command response timeout flag
        \arg        SDIO_INT_FLAG_DTTMOUT: data timeout flag
        \arg        SDIO_INT_FLAG_TXURE: transmit FIFO underrun error occurs flag
        \arg        SDIO_INT_FLAG_RXORE: received FIFO overrun error occurs flag
        \arg        SDIO_INT_FLAG_CMDRECV: command response received (CRC check passed) flag
        \arg        SDIO_INT_FLAG_CMDSEND: command sent (no response required) flag
        \arg        SDIO_INT_FLAG_DTEND: data end (data counter, SDIO_DATACNT, is zero) flag
        \arg        SDIO_INT_FLAG_STBITE: start bit error in the bus flag
        \arg        SDIO_INT_FLAG_DTBLKEND: data block sent/received (CRC check passed) flag
        \arg        SDIO_INT_FLAG_SDIOINT: SD I/O interrupt received flag
        \arg        SDIO_INT_FLAG_ATAEND: CE-ATA command completion signal received (only for CMD61) flag
      \param[out] none
      \retval     none
  */
  void sdio_interrupt_flag_clear(uint32_t int_flag)
  {
      SDIO_INTC = int_flag;
  }
  
  /*!
      \brief      enable the read wait mode(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_readwait_enable(void)
  {
      SDIO_DATACTL |= SDIO_DATACTL_RWEN;
  }
  
  /*!
      \brief      disable the read wait mode(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_readwait_disable(void)
  {
      SDIO_DATACTL &= ~SDIO_DATACTL_RWEN;
  }
  
  /*!
      \brief      enable the function that stop the read wait process(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_stop_readwait_enable(void)
  {
      SDIO_DATACTL |= SDIO_DATACTL_RWSTOP;
  }
  
  /*!
      \brief      disable the function that stop the read wait process(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_stop_readwait_disable(void)
  {
      SDIO_DATACTL &= ~SDIO_DATACTL_RWSTOP;
  }
  
  /*!
      \brief      set the read wait type(SD I/O only)
      \param[in]  readwait_type: SD I/O read wait type
                  only one parameter can be selected which is shown as below:
        \arg        SDIO_READWAITTYPE_CLK: read wait control by stopping SDIO_CLK
        \arg        SDIO_READWAITTYPE_DAT2: read wait control using SDIO_DAT[2]
      \param[out] none
      \retval     none
  */
  void sdio_readwait_type_set(uint32_t readwait_type)
  {
      if(SDIO_READWAITTYPE_CLK == readwait_type){
          SDIO_DATACTL |= SDIO_DATACTL_RWTYPE;
      }else{
          SDIO_DATACTL &= ~SDIO_DATACTL_RWTYPE;
      }
  }
  
  /*!
      \brief      enable the SD I/O mode specific operation(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_operation_enable(void)
  {
      SDIO_DATACTL |= SDIO_DATACTL_IOEN;
  }
  
  /*!
      \brief      disable the SD I/O mode specific operation(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_operation_disable(void)
  {
      SDIO_DATACTL &= ~SDIO_DATACTL_IOEN;
  }
  
  /*!
      \brief      enable the SD I/O suspend operation(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_suspend_enable(void)
  {
      SDIO_CMDCTL |= SDIO_CMDCTL_SUSPEND;
  }
  
  /*!
      \brief      disable the SD I/O suspend operation(SD I/O only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_suspend_disable(void)
  {
      SDIO_CMDCTL &= ~SDIO_CMDCTL_SUSPEND;
  }
  
  /*!
      \brief      enable the CE-ATA command(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_command_enable(void)
  {
      SDIO_CMDCTL |= SDIO_CMDCTL_ATAEN;
  }
  
  /*!
      \brief      disable the CE-ATA command(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_command_disable(void)
  {
      SDIO_CMDCTL &= ~SDIO_CMDCTL_ATAEN;
  }
  
  /*!
      \brief      enable the CE-ATA interrupt(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_interrupt_enable(void)
  {
      SDIO_CMDCTL &= ~SDIO_CMDCTL_NINTEN;
  }
  
  /*!
      \brief      disable the CE-ATA interrupt(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_interrupt_disable(void)
  {
      SDIO_CMDCTL |= SDIO_CMDCTL_NINTEN;
  }
  
  /*!
      \brief      enable the CE-ATA command completion signal(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_command_completion_enable(void)
  {
      SDIO_CMDCTL |= SDIO_CMDCTL_ENCMDC;
  }
  
  /*!
      \brief      disable the CE-ATA command completion signal(CE-ATA only)
      \param[in]  none
      \param[out] none
      \retval     none
  */
  void sdio_ceata_command_completion_disable(void)
  {
      SDIO_CMDCTL &= ~SDIO_CMDCTL_ENCMDC;
  }
  