STM32H735xx HAL User Manual
Functions
I/O operation functions
MDMA Exported Functions

I/O operation functions. More...

Functions

HAL_StatusTypeDef HAL_MDMA_Start (MDMA_HandleTypeDef *hmdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t BlockDataLength, uint32_t BlockCount)
 Starts the MDMA Transfer.
HAL_StatusTypeDef HAL_MDMA_Start_IT (MDMA_HandleTypeDef *hmdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t BlockDataLength, uint32_t BlockCount)
 Starts the MDMA Transfer with interrupts enabled.
HAL_StatusTypeDef HAL_MDMA_Abort (MDMA_HandleTypeDef *hmdma)
 Aborts the MDMA Transfer.
HAL_StatusTypeDef HAL_MDMA_Abort_IT (MDMA_HandleTypeDef *hmdma)
 Aborts the MDMA Transfer in Interrupt mode.
HAL_StatusTypeDef HAL_MDMA_PollForTransfer (MDMA_HandleTypeDef *hmdma, HAL_MDMA_LevelCompleteTypeDef CompleteLevel, uint32_t Timeout)
 Polling for transfer complete.
HAL_StatusTypeDef HAL_MDMA_GenerateSWRequest (MDMA_HandleTypeDef *hmdma)
 Generate an MDMA SW request trigger to activate the request on the given Channel.
void HAL_MDMA_IRQHandler (MDMA_HandleTypeDef *hmdma)
 Handles MDMA interrupt request.

Detailed Description

I/O operation functions.

 ===============================================================================
                      #####  IO operation functions  #####
 ===============================================================================
    [..]  This section provides functions allowing to:
      (+) Configure the source, destination address and data length and Start MDMA transfer
      (+) Configure the source, destination address and data length and
          Start MDMA transfer with interrupt
      (+) Abort MDMA transfer
      (+) Poll for transfer complete
      (+) Generate a SW request (when Request is set to MDMA_REQUEST_SW)
      (+) Handle MDMA interrupt request


Function Documentation

HAL_StatusTypeDef HAL_MDMA_Abort ( MDMA_HandleTypeDef hmdma)

Aborts the MDMA Transfer.

Parameters:
hmdma: pointer to a MDMA_HandleTypeDef structure that contains the configuration information for the specified MDMA Channel.
Note:
After disabling a MDMA Channel, a check for wait until the MDMA Channel is effectively disabled is added. If a Channel is disabled while a data transfer is ongoing, the current data will be transferred and the Channel will be effectively disabled only after the transfer of this single data is finished.
Return values:
HALstatus

Definition at line 1215 of file stm32h7xx_hal_mdma.c.

References __HAL_MDMA_CLEAR_FLAG, __HAL_MDMA_DISABLE, __HAL_MDMA_DISABLE_IT, __MDMA_HandleTypeDef::ErrorCode, HAL_GetTick(), HAL_MDMA_ERROR_NO_XFER, HAL_MDMA_ERROR_TIMEOUT, HAL_MDMA_STATE_BUSY, HAL_MDMA_STATE_ERROR, HAL_MDMA_STATE_READY, HAL_TIMEOUT_MDMA_ABORT, __MDMA_HandleTypeDef::Instance, MDMA_FLAG_BFTC, MDMA_FLAG_BRT, MDMA_FLAG_BT, MDMA_FLAG_CTC, MDMA_FLAG_TE, MDMA_IT_BFTC, MDMA_IT_BRT, MDMA_IT_BT, MDMA_IT_CTC, MDMA_IT_TE, and __MDMA_HandleTypeDef::State.

Referenced by HAL_MDMA_PollForTransfer(), and HAL_OSPI_Abort().

HAL_StatusTypeDef HAL_MDMA_Abort_IT ( MDMA_HandleTypeDef hmdma)

Aborts the MDMA Transfer in Interrupt mode.

Parameters:
hmdma: pointer to a MDMA_HandleTypeDef structure that contains the configuration information for the specified MDMA Channel.
Return values:
HALstatus

Definition at line 1280 of file stm32h7xx_hal_mdma.c.

References __HAL_MDMA_DISABLE, __MDMA_HandleTypeDef::ErrorCode, HAL_MDMA_ERROR_NO_XFER, HAL_MDMA_STATE_ABORT, HAL_MDMA_STATE_BUSY, and __MDMA_HandleTypeDef::State.

Referenced by HAL_OSPI_Abort_IT(), and HAL_OSPI_IRQHandler().

HAL_StatusTypeDef HAL_MDMA_GenerateSWRequest ( MDMA_HandleTypeDef hmdma)

Generate an MDMA SW request trigger to activate the request on the given Channel.

Parameters:
hmdma,:pointer to a MDMA_HandleTypeDef structure that contains the configuration information for the specified MDMA Stream.
Return values:
HALstatus

Definition at line 1462 of file stm32h7xx_hal_mdma.c.

References __MDMA_HandleTypeDef::ErrorCode, HAL_MDMA_ERROR_BUSY, HAL_MDMA_ERROR_NO_XFER, and __MDMA_HandleTypeDef::Instance.

HAL_StatusTypeDef HAL_MDMA_PollForTransfer ( MDMA_HandleTypeDef hmdma,
HAL_MDMA_LevelCompleteTypeDef  CompleteLevel,
uint32_t  Timeout 
)
HAL_StatusTypeDef HAL_MDMA_Start ( MDMA_HandleTypeDef hmdma,
uint32_t  SrcAddress,
uint32_t  DstAddress,
uint32_t  BlockDataLength,
uint32_t  BlockCount 
)

Starts the MDMA Transfer.

Parameters:
hmdma: pointer to a MDMA_HandleTypeDef structure that contains the configuration information for the specified MDMA Channel.
SrcAddress: The source memory Buffer address
DstAddress: The destination memory Buffer address
BlockDataLength: The length of a block transfer in bytes
BlockCount: The number of a blocks to be transfer
Return values:
HALstatus

Definition at line 1072 of file stm32h7xx_hal_mdma.c.

References __HAL_MDMA_DISABLE, __HAL_MDMA_ENABLE, assert_param, __MDMA_HandleTypeDef::ErrorCode, HAL_MDMA_ERROR_NONE, HAL_MDMA_STATE_BUSY, HAL_MDMA_STATE_READY, __MDMA_HandleTypeDef::Init, __MDMA_HandleTypeDef::Instance, IS_MDMA_BLOCK_COUNT, IS_MDMA_TRANSFER_LENGTH, MDMA_REQUEST_SW, MDMA_SetConfig(), MDMA_InitTypeDef::Request, and __MDMA_HandleTypeDef::State.

HAL_StatusTypeDef HAL_MDMA_Start_IT ( MDMA_HandleTypeDef hmdma,
uint32_t  SrcAddress,
uint32_t  DstAddress,
uint32_t  BlockDataLength,
uint32_t  BlockCount 
)

Starts the MDMA Transfer with interrupts enabled.

Parameters:
hmdma: pointer to a MDMA_HandleTypeDef structure that contains the configuration information for the specified MDMA Channel.
SrcAddress: The source memory Buffer address
DstAddress: The destination memory Buffer address
BlockDataLength: The length of a block transfer in bytes
BlockCount: The number of a blocks to be transfer
Return values:
HALstatus

Definition at line 1132 of file stm32h7xx_hal_mdma.c.

References __HAL_MDMA_DISABLE, __HAL_MDMA_ENABLE, __HAL_MDMA_ENABLE_IT, assert_param, __MDMA_HandleTypeDef::ErrorCode, HAL_MDMA_ERROR_NONE, HAL_MDMA_STATE_BUSY, HAL_MDMA_STATE_READY, __MDMA_HandleTypeDef::Init, __MDMA_HandleTypeDef::Instance, IS_MDMA_BLOCK_COUNT, IS_MDMA_TRANSFER_LENGTH, MDMA_IT_BFTC, MDMA_IT_BRT, MDMA_IT_BT, MDMA_IT_CTC, MDMA_IT_TE, MDMA_REQUEST_SW, MDMA_SetConfig(), MDMA_InitTypeDef::Request, __MDMA_HandleTypeDef::State, __MDMA_HandleTypeDef::XferBlockCpltCallback, __MDMA_HandleTypeDef::XferBufferCpltCallback, and __MDMA_HandleTypeDef::XferRepeatBlockCpltCallback.

Referenced by HAL_OSPI_Receive_DMA(), HAL_OSPI_Transmit_DMA(), HAL_SDRAM_Read_DMA(), HAL_SDRAM_Write_DMA(), HAL_SRAM_Read_DMA(), and HAL_SRAM_Write_DMA().