Extended features functions. More...

Functions
HAL_StatusTypeDef	HAL_DMAEx_ConfigMuxRequestGenerator (DMA_HandleTypeDef hdma, HAL_DMA_MuxRequestGeneratorConfigTypeDef pRequestGeneratorConfig)
	Configure the DMAMUX request generator block used by the given DMA channel (instance). More...

HAL_StatusTypeDef	HAL_DMAEx_EnableMuxRequestGenerator (DMA_HandleTypeDef *hdma)
	Enable the DMAMUX request generator block used by the given DMA channel (instance). More...

HAL_StatusTypeDef	HAL_DMAEx_DisableMuxRequestGenerator (DMA_HandleTypeDef *hdma)
	Disable the DMAMUX request generator block used by the given DMA channel (instance). More...

HAL_StatusTypeDef	HAL_DMAEx_ConfigMuxSync (DMA_HandleTypeDef hdma, HAL_DMA_MuxSyncConfigTypeDef pSyncConfig)
	Configure the DMAMUX synchronization parameters for a given DMA channel (instance). More...

void	HAL_DMAEx_MUX_IRQHandler (DMA_HandleTypeDef *hdma)
	Handles DMAMUX interrupt request. More...

Detailed Description

Extended features functions.

 ===============================================================================
                #####  Extended features functions  #####
 ===============================================================================
    [..]  This section provides functions allowing to:

    (+) Configure the DMAMUX Synchronization Block using HAL_DMAEx_ConfigMuxSync function.
    (+) Configure the DMAMUX Request Generator Block using HAL_DMAEx_ConfigMuxRequestGenerator function.
       Functions HAL_DMAEx_EnableMuxRequestGenerator and HAL_DMAEx_DisableMuxRequestGenerator can then be used
       to respectively enable/disable the request generator.

Function Documentation

◆ HAL_DMAEx_ConfigMuxRequestGenerator()

HAL_StatusTypeDef HAL_DMAEx_ConfigMuxRequestGenerator	(	DMA_HandleTypeDef *	hdma,
		HAL_DMA_MuxRequestGeneratorConfigTypeDef *	pRequestGeneratorConfig
	)

Configure the DMAMUX request generator block used by the given DMA channel (instance).

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA channel.
pRequestGeneratorConfig	: pointer to HAL_DMA_MuxRequestGeneratorConfigTypeDef : contains the request generator parameters.

Return values

HAL status

Definition at line 150 of file stm32l4xx_hal_dma_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 
   assert_param(IS_DMAMUX_REQUEST_GEN_SIGNAL_ID(pRequestGeneratorConfig->SignalID));
 
   assert_param(IS_DMAMUX_REQUEST_GEN_POLARITY(pRequestGeneratorConfig->Polarity));
   assert_param(IS_DMAMUX_REQUEST_GEN_REQUEST_NUMBER(pRequestGeneratorConfig->RequestNumber));
 
   /* check if the DMA state is ready
      and DMA is using a DMAMUX request generator block
   */
   if((hdma->State == HAL_DMA_STATE_READY) && (hdma->DMAmuxRequestGen != 0U))
   {
     /* Process Locked */
     __HAL_LOCK(hdma);
 
     /* Set the request generator new parameters */
     hdma->DMAmuxRequestGen->RGCR = pRequestGeneratorConfig->SignalID | \
                                   ((pRequestGeneratorConfig->RequestNumber - 1U) << DMAMUX_RGxCR_GNBREQ_Pos)| \
                                   pRequestGeneratorConfig->Polarity;
    /* Process UnLocked */
    __HAL_UNLOCK(hdma);
 
    return HAL_OK;
  }
  else
  {
    return HAL_ERROR;
  }
 }

◆ HAL_DMAEx_ConfigMuxSync()

HAL_StatusTypeDef HAL_DMAEx_ConfigMuxSync	(	DMA_HandleTypeDef *	hdma,
		HAL_DMA_MuxSyncConfigTypeDef *	pSyncConfig
	)

Configure the DMAMUX synchronization parameters for a given DMA channel (instance).

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA channel.
pSyncConfig	: pointer to HAL_DMA_MuxSyncConfigTypeDef : contains the DMAMUX synchronization parameters

Return values

HAL status

Definition at line 104 of file stm32l4xx_hal_dma_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 
   assert_param(IS_DMAMUX_SYNC_SIGNAL_ID(pSyncConfig->SyncSignalID));
 
   assert_param(IS_DMAMUX_SYNC_POLARITY(pSyncConfig-> SyncPolarity));
   assert_param(IS_DMAMUX_SYNC_STATE(pSyncConfig->SyncEnable));
   assert_param(IS_DMAMUX_SYNC_EVENT(pSyncConfig->EventEnable));
   assert_param(IS_DMAMUX_SYNC_REQUEST_NUMBER(pSyncConfig->RequestNumber));
 
   /*Check if the DMA state is ready */
   if(hdma->State == HAL_DMA_STATE_READY)
   {
     /* Process Locked */
     __HAL_LOCK(hdma);
 
     /* Set the new synchronization parameters (and keep the request ID filled during the Init)*/
     MODIFY_REG( hdma->DMAmuxChannel->CCR, \
                (~DMAMUX_CxCR_DMAREQ_ID) , \
                ((pSyncConfig->SyncSignalID) << DMAMUX_CxCR_SYNC_ID_Pos) | ((pSyncConfig->RequestNumber - 1U) << DMAMUX_CxCR_NBREQ_Pos) | \
                pSyncConfig->SyncPolarity | ((uint32_t)pSyncConfig->SyncEnable << DMAMUX_CxCR_SE_Pos) | \
                  ((uint32_t)pSyncConfig->EventEnable << DMAMUX_CxCR_EGE_Pos));
 
     /* Process UnLocked */
     __HAL_UNLOCK(hdma);
 
     return HAL_OK;
   }
   else
   {
     /*DMA State not Ready*/
     return HAL_ERROR;
   }
 }

◆ HAL_DMAEx_DisableMuxRequestGenerator()

HAL_StatusTypeDef HAL_DMAEx_DisableMuxRequestGenerator ( DMA_HandleTypeDef * hdma )

Disable the DMAMUX request generator block used by the given DMA channel (instance).

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA channel.

Return values

HAL status

Definition at line 217 of file stm32l4xx_hal_dma_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 
   /* check if the DMA state is ready
      and DMA is using a DMAMUX request generator block
   */
   if((hdma->State != HAL_DMA_STATE_RESET) && (hdma->DMAmuxRequestGen != 0))
   {
 
     /* Disable the request generator*/
     hdma->DMAmuxRequestGen->RGCR &= ~DMAMUX_RGxCR_GE;
 
     return HAL_OK;
   }
   else
   {
     return HAL_ERROR;
   }
 }

◆ HAL_DMAEx_EnableMuxRequestGenerator()

HAL_StatusTypeDef HAL_DMAEx_EnableMuxRequestGenerator ( DMA_HandleTypeDef * hdma )

Enable the DMAMUX request generator block used by the given DMA channel (instance).

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA channel.

Return values

HAL status

Definition at line 189 of file stm32l4xx_hal_dma_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
 
   /* check if the DMA state is ready
      and DMA is using a DMAMUX request generator block
   */
   if((hdma->State != HAL_DMA_STATE_RESET) && (hdma->DMAmuxRequestGen != 0))
   {
 
     /* Enable the request generator*/
     hdma->DMAmuxRequestGen->RGCR |= DMAMUX_RGxCR_GE;
 
    return HAL_OK;
  }
  else
  {
    return HAL_ERROR;
  }
 }

◆ HAL_DMAEx_MUX_IRQHandler()

void HAL_DMAEx_MUX_IRQHandler ( DMA_HandleTypeDef * hdma )

Handles DMAMUX interrupt request.

Parameters

hdma	pointer to a DMA_HandleTypeDef structure that contains the configuration information for the specified DMA channel.

Return values

None

Definition at line 245 of file stm32l4xx_hal_dma_ex.c.

 {
   /* Check for DMAMUX Synchronization overrun */
   if((hdma->DMAmuxChannelStatus->CSR & hdma->DMAmuxChannelStatusMask) != 0U)
   {
     /* Disable the synchro overrun interrupt */
     hdma->DMAmuxChannel->CCR &= ~DMAMUX_CxCR_SOIE;
 
     /* Clear the DMAMUX synchro overrun flag */
     hdma->DMAmuxChannelStatus->CFR = hdma->DMAmuxChannelStatusMask;
 
     /* Update error code */
     hdma->ErrorCode |= HAL_DMA_ERROR_SYNC;
 
     if(hdma->XferErrorCallback != NULL)
     {
       /* Transfer error callback */
       hdma->XferErrorCallback(hdma);
     }
   }
 
   if(hdma->DMAmuxRequestGen != 0)
   {
    /* if using a DMAMUX request generator block Check for DMAMUX request generator overrun */
     if((hdma->DMAmuxRequestGenStatus->RGSR & hdma->DMAmuxRequestGenStatusMask) != 0U)
     {
       /* Disable the request gen overrun interrupt */
       hdma->DMAmuxRequestGen->RGCR &= ~DMAMUX_RGxCR_OIE;
 
       /* Clear the DMAMUX request generator overrun flag */
       hdma->DMAmuxRequestGenStatus->RGCFR = hdma->DMAmuxRequestGenStatusMask;
 
       /* Update error code */
       hdma->ErrorCode |= HAL_DMA_ERROR_REQGEN;
 
       if(hdma->XferErrorCallback != NULL)
       {
         /* Transfer error callback */
         hdma->XferErrorCallback(hdma);
       }
     }
   }
 }