MultiBuffer functions

Multibuffer functions. More...

Functions
HAL_StatusTypeDef	HAL_SDEx_ConfigDMAMultiBuffer (SD_HandleTypeDef *hsd, uint32_t *pDataBuffer0, uint32_t *pDataBuffer1, uint32_t BufferSize)
	Configure DMA Dual Buffer mode. The Data transfer is managed by an Internal DMA. More...
HAL_StatusTypeDef	HAL_SDEx_ReadBlocksDMAMultiBuffer (SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks)
	Reads block(s) from a specified address in a card. The received Data will be stored in Buffer0 and Buffer1. Buffer0, Buffer1 and BufferSize need to be configured by function HAL_SDEx_ConfigDMAMultiBuffer before call this function. More...
HAL_StatusTypeDef	HAL_SDEx_WriteBlocksDMAMultiBuffer (SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks)
	Write block(s) to a specified address in a card. The transfered Data are stored in Buffer0 and Buffer1. Buffer0, Buffer1 and BufferSize need to be configured by function HAL_SDEx_ConfigDMAMultiBuffer before call this function. More...
HAL_StatusTypeDef	HAL_SDEx_ChangeDMABuffer (SD_HandleTypeDef *hsd, HAL_SDEx_DMABuffer_MemoryTypeDef Buffer, uint32_t *pDataBuffer)
	Change the DMA Buffer0 or Buffer1 address on the fly. More...
void	HAL_SDEx_Read_DMADoubleBuffer0CpltCallback (SD_HandleTypeDef *hsd)
	Read DMA Buffer 0 Transfer completed callbacks. More...
void	HAL_SDEx_Read_DMADoubleBuffer1CpltCallback (SD_HandleTypeDef *hsd)
	Read DMA Buffer 1 Transfer completed callbacks. More...
void	HAL_SDEx_Write_DMADoubleBuffer0CpltCallback (SD_HandleTypeDef *hsd)
	Write DMA Buffer 0 Transfer completed callbacks. More...
void	HAL_SDEx_Write_DMADoubleBuffer1CpltCallback (SD_HandleTypeDef *hsd)
	Write DMA Buffer 1 Transfer completed callbacks. More...

Detailed Description

Multibuffer functions.

  ==============================================================================
          ##### Multibuffer functions #####
  ==============================================================================
  [..]
    This section provides functions allowing to configure the multibuffer mode and start read and write
    multibuffer mode for SD HAL driver.

Function Documentation

HAL_SDEx_ChangeDMABuffer()

HAL_StatusTypeDef HAL_SDEx_ChangeDMABuffer	(	SD_HandleTypeDef *	hsd,
		HAL_SDEx_DMABuffer_MemoryTypeDef	Buffer,
		uint32_t *	pDataBuffer
	)

Change the DMA Buffer0 or Buffer1 address on the fly.

Parameters

hsd	pointer to a SD_HandleTypeDef structure.
Buffer	the buffer to be changed, This parameter can be one of the following values: SD_DMA_BUFFER0 or SD_DMA_BUFFER1
pDataBuffer	The new address

Note

The BUFFER0 address can be changed only when the current transfer use BUFFER1 and the BUFFER1 address can be changed only when the current transfer use BUFFER0.

Return values

HAL

status

Definition at line 342 of file stm32l4xx_hal_sd_ex.c.

{
  if(Buffer == SD_DMA_BUFFER0)
  {
    /* change the buffer0 address */
    hsd->Instance->IDMABASE0 = (uint32_t)pDataBuffer;
  }
  else
  {
    /* change the memory1 address */
    hsd->Instance->IDMABASE1 = (uint32_t)pDataBuffer;
  }

  return HAL_OK;
}

HAL_SDEx_ConfigDMAMultiBuffer()

HAL_StatusTypeDef HAL_SDEx_ConfigDMAMultiBuffer	(	SD_HandleTypeDef *	hsd,
		uint32_t *	pDataBuffer0,
		uint32_t *	pDataBuffer1,
		uint32_t	BufferSize
	)

Configure DMA Dual Buffer mode. The Data transfer is managed by an Internal DMA.

Parameters

hsd	SD handle
pDataBuffer0	Pointer to the buffer0 that will contain/receive the transfered data
pDataBuffer1	Pointer to the buffer1 that will contain/receive the transfered data
BufferSize	Size of Buffer0 in Blocks. Buffer0 and Buffer1 must have the same size.

Return values

HAL

status

Definition at line 132 of file stm32l4xx_hal_sd_ex.c.

{
  if(hsd->State == HAL_SD_STATE_READY)
  {
    hsd->Instance->IDMABASE0= (uint32_t) pDataBuffer0;
    hsd->Instance->IDMABASE1= (uint32_t) pDataBuffer1;
    hsd->Instance->IDMABSIZE= (uint32_t) (BLOCKSIZE * BufferSize);

    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }
}

HAL_SDEx_Read_DMADoubleBuffer0CpltCallback()

__weak void HAL_SDEx_Read_DMADoubleBuffer0CpltCallback

(

SD_HandleTypeDef *

hsd

)

Read DMA Buffer 0 Transfer completed callbacks.

Parameters

hsd

SD handle

Return values

None

Definition at line 363 of file stm32l4xx_hal_sd_ex.c.

{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(hsd);

  /* NOTE : This function should not be modified, when the callback is needed,
            the HAL_SDEx_Read_DMADoubleBuffer0CpltCallback can be implemented in the user file
   */
}

HAL_SDEx_Read_DMADoubleBuffer1CpltCallback()

__weak void HAL_SDEx_Read_DMADoubleBuffer1CpltCallback

(

SD_HandleTypeDef *

hsd

)

Read DMA Buffer 1 Transfer completed callbacks.

Parameters

hsd

SD handle

Return values

None

Definition at line 378 of file stm32l4xx_hal_sd_ex.c.

{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(hsd);

  /* NOTE : This function should not be modified, when the callback is needed,
            the HAL_SDEx_Read_DMADoubleBuffer1CpltCallback can be implemented in the user file
   */
}

HAL_SDEx_ReadBlocksDMAMultiBuffer()

HAL_StatusTypeDef HAL_SDEx_ReadBlocksDMAMultiBuffer	(	SD_HandleTypeDef *	hsd,
		uint32_t	BlockAdd,
		uint32_t	NumberOfBlocks
	)

Reads block(s) from a specified address in a card. The received Data will be stored in Buffer0 and Buffer1. Buffer0, Buffer1 and BufferSize need to be configured by function HAL_SDEx_ConfigDMAMultiBuffer before call this function.

Parameters

hsd	SD handle
BlockAdd	Block Address from where data is to be read
NumberOfBlocks	Total number of blocks to read

Return values

HAL

status

Definition at line 156 of file stm32l4xx_hal_sd_ex.c.

{
  SDMMC_DataInitTypeDef config;
  uint32_t errorstate;
  uint32_t DmaBase0_reg, DmaBase1_reg;
  uint32_t add = BlockAdd;

  if(hsd->State == HAL_SD_STATE_READY)
  {
    if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr))
    {
      hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;
      return HAL_ERROR;
    }

    DmaBase0_reg = hsd->Instance->IDMABASE0;
    DmaBase1_reg = hsd->Instance->IDMABASE1;
    if ((hsd->Instance->IDMABSIZE == 0U) || (DmaBase0_reg == 0U) || (DmaBase1_reg == 0U))
    {
      hsd->ErrorCode = HAL_SD_ERROR_ADDR_OUT_OF_RANGE;
      return HAL_ERROR;
    }

    /* Initialize data control register */
    hsd->Instance->DCTRL = 0;
    /* Clear old Flags*/
    __HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_DATA_FLAGS);

    hsd->ErrorCode = HAL_SD_ERROR_NONE;
    hsd->State = HAL_SD_STATE_BUSY;

    if(hsd->SdCard.CardType != CARD_SDHC_SDXC)
    {
      add *= 512U;
    }

    /* Set Block Size for Card */
    errorstate = SDMMC_CmdBlockLength(hsd->Instance, BLOCKSIZE);
    if(errorstate != HAL_SD_ERROR_NONE)
    {
      /* Clear all the static flags */
      __HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);
      hsd->ErrorCode |= errorstate;
      hsd->State = HAL_SD_STATE_READY;
      return HAL_ERROR;
    }

    /* Configure the SD DPSM (Data Path State Machine) */
    config.DataTimeOut   = SDMMC_DATATIMEOUT;
    config.DataLength    = BLOCKSIZE * NumberOfBlocks;
    config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;
    config.TransferDir   = SDMMC_TRANSFER_DIR_TO_SDMMC;
    config.TransferMode  = SDMMC_TRANSFER_MODE_BLOCK;
    config.DPSM          = SDMMC_DPSM_DISABLE;
    (void)SDMMC_ConfigData(hsd->Instance, &config);

    hsd->Instance->DCTRL |= SDMMC_DCTRL_FIFORST;

    __SDMMC_CMDTRANS_ENABLE( hsd->Instance);

    hsd->Instance->IDMACTRL = SDMMC_ENABLE_IDMA_DOUBLE_BUFF0;

    __HAL_SD_ENABLE_IT(hsd, (SDMMC_IT_DCRCFAIL | SDMMC_IT_DTIMEOUT | SDMMC_IT_RXOVERR | SDMMC_IT_DATAEND | SDMMC_IT_IDMABTC));

    /* Read Blocks in DMA mode */
    hsd->Context = (SD_CONTEXT_READ_MULTIPLE_BLOCK | SD_CONTEXT_DMA);

    /* Read Multi Block command */
    errorstate = SDMMC_CmdReadMultiBlock(hsd->Instance, add);
    if(errorstate != HAL_SD_ERROR_NONE)
    {
      hsd->State = HAL_SD_STATE_READY;
      hsd->ErrorCode |= errorstate;
      return HAL_ERROR;
    }

    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }

}

HAL_SDEx_Write_DMADoubleBuffer0CpltCallback()

__weak void HAL_SDEx_Write_DMADoubleBuffer0CpltCallback

(

SD_HandleTypeDef *

hsd

)

Write DMA Buffer 0 Transfer completed callbacks.

Parameters

hsd

SD handle

Return values

None

Definition at line 393 of file stm32l4xx_hal_sd_ex.c.

{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(hsd);

  /* NOTE : This function should not be modified, when the callback is needed,
            the HAL_SDEx_Write_DMADoubleBuffer0CpltCallback can be implemented in the user file
   */
}

HAL_SDEx_Write_DMADoubleBuffer1CpltCallback()

__weak void HAL_SDEx_Write_DMADoubleBuffer1CpltCallback

(

SD_HandleTypeDef *

hsd

)

Write DMA Buffer 1 Transfer completed callbacks.

Parameters

hsd

SD handle

Return values

None

Definition at line 408 of file stm32l4xx_hal_sd_ex.c.

{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(hsd);

  /* NOTE : This function should not be modified, when the callback is needed,
            the HAL_SDEx_Write_DMADoubleBuffer0CpltCallback can be implemented in the user file
   */
}

HAL_SDEx_WriteBlocksDMAMultiBuffer()

HAL_StatusTypeDef HAL_SDEx_WriteBlocksDMAMultiBuffer	(	SD_HandleTypeDef *	hsd,
		uint32_t	BlockAdd,
		uint32_t	NumberOfBlocks
	)

Write block(s) to a specified address in a card. The transfered Data are stored in Buffer0 and Buffer1. Buffer0, Buffer1 and BufferSize need to be configured by function HAL_SDEx_ConfigDMAMultiBuffer before call this function.

Parameters

hsd	SD handle
BlockAdd	Block Address from where data is to be read
NumberOfBlocks	Total number of blocks to read

Return values

HAL

status

Definition at line 249 of file stm32l4xx_hal_sd_ex.c.

{
  SDMMC_DataInitTypeDef config;
  uint32_t errorstate;
  uint32_t DmaBase0_reg, DmaBase1_reg;
  uint32_t add = BlockAdd;

  if(hsd->State == HAL_SD_STATE_READY)
  {
    if((add + NumberOfBlocks) > (hsd->SdCard.LogBlockNbr))
    {
      hsd->ErrorCode |= HAL_SD_ERROR_ADDR_OUT_OF_RANGE;
      return HAL_ERROR;
    }

    DmaBase0_reg = hsd->Instance->IDMABASE0;
    DmaBase1_reg = hsd->Instance->IDMABASE1;
    if ((hsd->Instance->IDMABSIZE == 0U) || (DmaBase0_reg == 0U) || (DmaBase1_reg == 0U))
    {
      hsd->ErrorCode = HAL_SD_ERROR_ADDR_OUT_OF_RANGE;
      return HAL_ERROR;
    }

    /* Initialize data control register */
    hsd->Instance->DCTRL = 0;

    hsd->ErrorCode = HAL_SD_ERROR_NONE;

    hsd->State = HAL_SD_STATE_BUSY;

    if(hsd->SdCard.CardType != CARD_SDHC_SDXC)
    {
      add *= 512U;
    }

    /* Set Block Size for Card */
    errorstate = SDMMC_CmdBlockLength(hsd->Instance, BLOCKSIZE);
    if(errorstate != HAL_SD_ERROR_NONE)
    {
      /* Clear all the static flags */
      __HAL_SD_CLEAR_FLAG(hsd, SDMMC_STATIC_FLAGS);
      hsd->ErrorCode |= errorstate;
      hsd->State = HAL_SD_STATE_READY;
      return HAL_ERROR;
    }

    /* Configure the SD DPSM (Data Path State Machine) */
    config.DataTimeOut   = SDMMC_DATATIMEOUT;
    config.DataLength    = BLOCKSIZE * NumberOfBlocks;
    config.DataBlockSize = SDMMC_DATABLOCK_SIZE_512B;
    config.TransferDir   = SDMMC_TRANSFER_DIR_TO_CARD;
    config.TransferMode  = SDMMC_TRANSFER_MODE_BLOCK;
    config.DPSM          = SDMMC_DPSM_DISABLE;
    (void)SDMMC_ConfigData(hsd->Instance, &config);

    __SDMMC_CMDTRANS_ENABLE( hsd->Instance);

    hsd->Instance->IDMACTRL = SDMMC_ENABLE_IDMA_DOUBLE_BUFF0;

    __HAL_SD_ENABLE_IT(hsd, (SDMMC_IT_DCRCFAIL | SDMMC_IT_DTIMEOUT | SDMMC_IT_TXUNDERR | SDMMC_IT_DATAEND | SDMMC_IT_IDMABTC));

    /* Write Blocks in DMA mode */
    hsd->Context = (SD_CONTEXT_WRITE_MULTIPLE_BLOCK | SD_CONTEXT_DMA);

    /* Write Multi Block command */
    errorstate = SDMMC_CmdWriteMultiBlock(hsd->Instance, add);
    if(errorstate != HAL_SD_ERROR_NONE)
    {
      hsd->State = HAL_SD_STATE_READY;
      hsd->ErrorCode |= errorstate;
      return HAL_ERROR;
    }

    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }
}