Initialization and de-initialization functions

Initialization and Configuration functions. More...

Functions
HAL_StatusTypeDef	HAL_DMA2D_Init (DMA2D_HandleTypeDef *hdma2d)
	Initialize the DMA2D according to the specified parameters in the DMA2D_InitTypeDef and create the associated handle.
HAL_StatusTypeDef	HAL_DMA2D_DeInit (DMA2D_HandleTypeDef *hdma2d)
	Deinitializes the DMA2D peripheral registers to their default reset values.
__weak void	HAL_DMA2D_MspInit (DMA2D_HandleTypeDef *hdma2d)
	Initializes the DMA2D MSP.
__weak void	HAL_DMA2D_MspDeInit (DMA2D_HandleTypeDef *hdma2d)
	DeInitializes the DMA2D MSP.
HAL_StatusTypeDef	HAL_DMA2D_RegisterCallback (DMA2D_HandleTypeDef *hdma2d, HAL_DMA2D_CallbackIDTypeDef CallbackID, pDMA2D_CallbackTypeDef pCallback)
	Register a User DMA2D Callback To be used instead of the weak (surcharged) predefined callback.
HAL_StatusTypeDef	HAL_DMA2D_UnRegisterCallback (DMA2D_HandleTypeDef *hdma2d, HAL_DMA2D_CallbackIDTypeDef CallbackID)
	Unregister a DMA2D Callback DMA2D Callback is redirected to the weak (surcharged) predefined callback.

---

Detailed Description

Initialization and Configuration functions.

 ===============================================================================
                ##### Initialization and Configuration functions #####
 ===============================================================================
    [..]  This section provides functions allowing to:
      (+) Initialize and configure the DMA2D
      (+) De-initialize the DMA2D

---

Function Documentation

HAL_StatusTypeDef HAL_DMA2D_DeInit

(

DMA2D_HandleTypeDef *

hdma2d

)

Deinitializes the DMA2D peripheral registers to their default reset values.

Parameters:

hdma2d

pointer to a DMA2D_HandleTypeDef structure that contains the configuration information for the DMA2D.

Return values:

None

Definition at line 315 of file stm32h7xx_hal_dma2d.c.

References __HAL_RCC_DMA2D_IS_CLK_ENABLED, __DMA2D_HandleTypeDef::ErrorCode, HAL_DMA2D_Abort(), HAL_DMA2D_CLUTLoading_Abort(), HAL_DMA2D_ERROR_NONE, HAL_DMA2D_MspDeInit(), HAL_DMA2D_STATE_RESET, __DMA2D_HandleTypeDef::Instance, __DMA2D_HandleTypeDef::MspDeInitCallback, and __DMA2D_HandleTypeDef::State.

HAL_StatusTypeDef HAL_DMA2D_Init

(

DMA2D_HandleTypeDef *

hdma2d

)

Initialize the DMA2D according to the specified parameters in the DMA2D_InitTypeDef and create the associated handle.

Parameters:

hdma2d

pointer to a DMA2D_HandleTypeDef structure that contains the configuration information for the DMA2D.

Return values:

HAL

status

Definition at line 238 of file stm32h7xx_hal_dma2d.c.

References DMA2D_InitTypeDef::AlphaInverted, assert_param, DMA2D_InitTypeDef::BytesSwap, __DMA2D_HandleTypeDef::CLUTLoadingCpltCallback, DMA2D_InitTypeDef::ColorMode, __DMA2D_HandleTypeDef::ErrorCode, HAL_DMA2D_CLUTLoadingCpltCallback(), HAL_DMA2D_ERROR_NONE, HAL_DMA2D_LineEventCallback(), HAL_DMA2D_MspInit(), HAL_DMA2D_STATE_BUSY, HAL_DMA2D_STATE_READY, HAL_DMA2D_STATE_RESET, __DMA2D_HandleTypeDef::Init, __DMA2D_HandleTypeDef::Instance, IS_DMA2D_ALPHA_INVERTED, IS_DMA2D_BYTES_SWAP, IS_DMA2D_CMODE, IS_DMA2D_LOM_MODE, IS_DMA2D_MODE, IS_DMA2D_OFFSET, IS_DMA2D_RB_SWAP, __DMA2D_HandleTypeDef::LineEventCallback, DMA2D_InitTypeDef::LineOffsetMode, __DMA2D_HandleTypeDef::Lock, DMA2D_InitTypeDef::Mode, __DMA2D_HandleTypeDef::MspInitCallback, DMA2D_InitTypeDef::OutputOffset, DMA2D_InitTypeDef::RedBlueSwap, and __DMA2D_HandleTypeDef::State.

void HAL_DMA2D_MspDeInit

(

DMA2D_HandleTypeDef *

hdma2d

)

DeInitializes the DMA2D MSP.

Parameters:

hdma2d

pointer to a DMA2D_HandleTypeDef structure that contains the configuration information for the DMA2D.

Return values:

None

Definition at line 421 of file stm32h7xx_hal_dma2d.c.

Referenced by HAL_DMA2D_DeInit(), and HAL_DMA2D_UnRegisterCallback().

void HAL_DMA2D_MspInit

(

DMA2D_HandleTypeDef *

hdma2d

)

Initializes the DMA2D MSP.

Parameters:

hdma2d

pointer to a DMA2D_HandleTypeDef structure that contains the configuration information for the DMA2D.

Return values:

None

Definition at line 405 of file stm32h7xx_hal_dma2d.c.

Referenced by HAL_DMA2D_Init(), and HAL_DMA2D_UnRegisterCallback().

HAL_StatusTypeDef HAL_DMA2D_RegisterCallback	(	DMA2D_HandleTypeDef *	hdma2d,
		HAL_DMA2D_CallbackIDTypeDef	CallbackID,
		pDMA2D_CallbackTypeDef	pCallback
	)

Register a User DMA2D Callback To be used instead of the weak (surcharged) predefined callback.

Parameters:

hdma2d	DMA2D handle
CallbackID	ID of the callback to be registered This parameter can be one of the following values: HAL_DMA2D_TRANSFERCOMPLETE_CB_ID DMA2D transfer complete Callback ID HAL_DMA2D_TRANSFERERROR_CB_ID DMA2D transfer error Callback ID HAL_DMA2D_LINEEVENT_CB_ID DMA2D line event Callback ID HAL_DMA2D_CLUTLOADINGCPLT_CB_ID DMA2D CLUT loading completion Callback ID HAL_DMA2D_MSPINIT_CB_ID DMA2D MspInit callback ID HAL_DMA2D_MSPDEINIT_CB_ID DMA2D MspDeInit callback ID
pCallback	pointer to the Callback function

Note:

No weak predefined callbacks are defined for HAL_DMA2D_TRANSFERCOMPLETE_CB_ID or HAL_DMA2D_TRANSFERERROR_CB_ID

Return values:

status

Definition at line 448 of file stm32h7xx_hal_dma2d.c.

References __DMA2D_HandleTypeDef::CLUTLoadingCpltCallback, __DMA2D_HandleTypeDef::ErrorCode, HAL_DMA2D_CLUTLOADINGCPLT_CB_ID, HAL_DMA2D_ERROR_INVALID_CALLBACK, HAL_DMA2D_LINEEVENT_CB_ID, HAL_DMA2D_MSPDEINIT_CB_ID, HAL_DMA2D_MSPINIT_CB_ID, HAL_DMA2D_STATE_READY, HAL_DMA2D_STATE_RESET, HAL_DMA2D_TRANSFERCOMPLETE_CB_ID, HAL_DMA2D_TRANSFERERROR_CB_ID, __DMA2D_HandleTypeDef::LineEventCallback, __DMA2D_HandleTypeDef::MspDeInitCallback, __DMA2D_HandleTypeDef::MspInitCallback, __DMA2D_HandleTypeDef::State, __DMA2D_HandleTypeDef::XferCpltCallback, and __DMA2D_HandleTypeDef::XferErrorCallback.

HAL_StatusTypeDef HAL_DMA2D_UnRegisterCallback	(	DMA2D_HandleTypeDef *	hdma2d,
		HAL_DMA2D_CallbackIDTypeDef	CallbackID
	)

Unregister a DMA2D Callback DMA2D Callback is redirected to the weak (surcharged) predefined callback.

Parameters:

hdma2d

DMA2D handle

CallbackID

ID of the callback to be unregistered This parameter can be one of the following values: HAL_DMA2D_TRANSFERCOMPLETE_CB_ID DMA2D transfer complete Callback ID HAL_DMA2D_TRANSFERERROR_CB_ID DMA2D transfer error Callback ID HAL_DMA2D_LINEEVENT_CB_ID DMA2D line event Callback ID HAL_DMA2D_CLUTLOADINGCPLT_CB_ID DMA2D CLUT loading completion Callback ID HAL_DMA2D_MSPINIT_CB_ID DMA2D MspInit callback ID HAL_DMA2D_MSPDEINIT_CB_ID DMA2D MspDeInit callback ID

Note:

No weak predefined callbacks are defined for HAL_DMA2D_TRANSFERCOMPLETE_CB_ID or HAL_DMA2D_TRANSFERERROR_CB_ID

Return values:

status

Definition at line 546 of file stm32h7xx_hal_dma2d.c.

References __DMA2D_HandleTypeDef::CLUTLoadingCpltCallback, __DMA2D_HandleTypeDef::ErrorCode, HAL_DMA2D_CLUTLOADINGCPLT_CB_ID, HAL_DMA2D_CLUTLoadingCpltCallback(), HAL_DMA2D_ERROR_INVALID_CALLBACK, HAL_DMA2D_LINEEVENT_CB_ID, HAL_DMA2D_LineEventCallback(), HAL_DMA2D_MspDeInit(), HAL_DMA2D_MSPDEINIT_CB_ID, HAL_DMA2D_MspInit(), HAL_DMA2D_MSPINIT_CB_ID, HAL_DMA2D_STATE_READY, HAL_DMA2D_STATE_RESET, HAL_DMA2D_TRANSFERCOMPLETE_CB_ID, HAL_DMA2D_TRANSFERERROR_CB_ID, __DMA2D_HandleTypeDef::LineEventCallback, __DMA2D_HandleTypeDef::MspDeInitCallback, __DMA2D_HandleTypeDef::MspInitCallback, __DMA2D_HandleTypeDef::State, __DMA2D_HandleTypeDef::XferCpltCallback, and __DMA2D_HandleTypeDef::XferErrorCallback.