stm32f4xx_hal_dma2d.h 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630
  1. /**
  2. ******************************************************************************
  3. * @file stm32f4xx_hal_dma2d.h
  4. * @author MCD Application Team
  5. * @brief Header file of DMA2D HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.</center></h2>
  11. *
  12. * This software component is licensed by ST under BSD 3-Clause license,
  13. * the "License"; You may not use this file except in compliance with the
  14. * License. You may obtain a copy of the License at:
  15. * opensource.org/licenses/BSD-3-Clause
  16. *
  17. ******************************************************************************
  18. */
  19. /* Define to prevent recursive inclusion -------------------------------------*/
  20. #ifndef STM32F4xx_HAL_DMA2D_H
  21. #define STM32F4xx_HAL_DMA2D_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /* Includes ------------------------------------------------------------------*/
  26. #include "stm32f4xx_hal_def.h"
  27. /** @addtogroup STM32F4xx_HAL_Driver
  28. * @{
  29. */
  30. #if defined (DMA2D)
  31. /** @addtogroup DMA2D DMA2D
  32. * @brief DMA2D HAL module driver
  33. * @{
  34. */
  35. /* Exported types ------------------------------------------------------------*/
  36. /** @defgroup DMA2D_Exported_Types DMA2D Exported Types
  37. * @{
  38. */
  39. #define MAX_DMA2D_LAYER 2U /*!< DMA2D maximum number of layers */
  40. /**
  41. * @brief DMA2D CLUT Structure definition
  42. */
  43. typedef struct
  44. {
  45. uint32_t *pCLUT; /*!< Configures the DMA2D CLUT memory address.*/
  46. uint32_t CLUTColorMode; /*!< Configures the DMA2D CLUT color mode.
  47. This parameter can be one value of @ref DMA2D_CLUT_CM. */
  48. uint32_t Size; /*!< Configures the DMA2D CLUT size.
  49. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF.*/
  50. } DMA2D_CLUTCfgTypeDef;
  51. /**
  52. * @brief DMA2D Init structure definition
  53. */
  54. typedef struct
  55. {
  56. uint32_t Mode; /*!< Configures the DMA2D transfer mode.
  57. This parameter can be one value of @ref DMA2D_Mode. */
  58. uint32_t ColorMode; /*!< Configures the color format of the output image.
  59. This parameter can be one value of @ref DMA2D_Output_Color_Mode. */
  60. uint32_t OutputOffset; /*!< Specifies the Offset value.
  61. This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x3FFF. */
  62. } DMA2D_InitTypeDef;
  63. /**
  64. * @brief DMA2D Layer structure definition
  65. */
  66. typedef struct
  67. {
  68. uint32_t InputOffset; /*!< Configures the DMA2D foreground or background offset.
  69. This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x3FFF. */
  70. uint32_t InputColorMode; /*!< Configures the DMA2D foreground or background color mode.
  71. This parameter can be one value of @ref DMA2D_Input_Color_Mode. */
  72. uint32_t AlphaMode; /*!< Configures the DMA2D foreground or background alpha mode.
  73. This parameter can be one value of @ref DMA2D_Alpha_Mode. */
  74. uint32_t InputAlpha; /*!< Specifies the DMA2D foreground or background alpha value and color value in case of A8 or A4 color mode.
  75. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF except for the color modes detailed below.
  76. @note In case of A8 or A4 color mode (ARGB), this parameter must be a number between
  77. Min_Data = 0x00000000 and Max_Data = 0xFFFFFFFF where
  78. - InputAlpha[24:31] is the alpha value ALPHA[0:7]
  79. - InputAlpha[16:23] is the red value RED[0:7]
  80. - InputAlpha[8:15] is the green value GREEN[0:7]
  81. - InputAlpha[0:7] is the blue value BLUE[0:7]. */
  82. } DMA2D_LayerCfgTypeDef;
  83. /**
  84. * @brief HAL DMA2D State structures definition
  85. */
  86. typedef enum
  87. {
  88. HAL_DMA2D_STATE_RESET = 0x00U, /*!< DMA2D not yet initialized or disabled */
  89. HAL_DMA2D_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
  90. HAL_DMA2D_STATE_BUSY = 0x02U, /*!< An internal process is ongoing */
  91. HAL_DMA2D_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
  92. HAL_DMA2D_STATE_ERROR = 0x04U, /*!< DMA2D state error */
  93. HAL_DMA2D_STATE_SUSPEND = 0x05U /*!< DMA2D process is suspended */
  94. }HAL_DMA2D_StateTypeDef;
  95. /**
  96. * @brief DMA2D handle Structure definition
  97. */
  98. typedef struct __DMA2D_HandleTypeDef
  99. {
  100. DMA2D_TypeDef *Instance; /*!< DMA2D register base address. */
  101. DMA2D_InitTypeDef Init; /*!< DMA2D communication parameters. */
  102. void (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D transfer complete callback. */
  103. void (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D transfer error callback. */
  104. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  105. void (* LineEventCallback)( struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D line event callback. */
  106. void (* CLUTLoadingCpltCallback)( struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D CLUT loading completion callback. */
  107. void (* MspInitCallback)( struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D Msp Init callback. */
  108. void (* MspDeInitCallback)( struct __DMA2D_HandleTypeDef * hdma2d); /*!< DMA2D Msp DeInit callback. */
  109. #endif /* (USE_HAL_DMA2D_REGISTER_CALLBACKS) */
  110. DMA2D_LayerCfgTypeDef LayerCfg[MAX_DMA2D_LAYER]; /*!< DMA2D Layers parameters */
  111. HAL_LockTypeDef Lock; /*!< DMA2D lock. */
  112. __IO HAL_DMA2D_StateTypeDef State; /*!< DMA2D transfer state. */
  113. __IO uint32_t ErrorCode; /*!< DMA2D error code. */
  114. } DMA2D_HandleTypeDef;
  115. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  116. /**
  117. * @brief HAL DMA2D Callback pointer definition
  118. */
  119. typedef void (*pDMA2D_CallbackTypeDef)(DMA2D_HandleTypeDef * hdma2d); /*!< Pointer to a DMA2D common callback function */
  120. #endif /* USE_HAL_DMA2D_REGISTER_CALLBACKS */
  121. /**
  122. * @}
  123. */
  124. /* Exported constants --------------------------------------------------------*/
  125. /** @defgroup DMA2D_Exported_Constants DMA2D Exported Constants
  126. * @{
  127. */
  128. /** @defgroup DMA2D_Error_Code DMA2D Error Code
  129. * @{
  130. */
  131. #define HAL_DMA2D_ERROR_NONE 0x00000000U /*!< No error */
  132. #define HAL_DMA2D_ERROR_TE 0x00000001U /*!< Transfer error */
  133. #define HAL_DMA2D_ERROR_CE 0x00000002U /*!< Configuration error */
  134. #define HAL_DMA2D_ERROR_CAE 0x00000004U /*!< CLUT access error */
  135. #define HAL_DMA2D_ERROR_TIMEOUT 0x00000020U /*!< Timeout error */
  136. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  137. #define HAL_DMA2D_ERROR_INVALID_CALLBACK 0x00000040U /*!< Invalid callback error */
  138. #endif /* USE_HAL_UART_REGISTER_CALLBACKS */
  139. /**
  140. * @}
  141. */
  142. /** @defgroup DMA2D_Mode DMA2D Mode
  143. * @{
  144. */
  145. #define DMA2D_M2M 0x00000000U /*!< DMA2D memory to memory transfer mode */
  146. #define DMA2D_M2M_PFC DMA2D_CR_MODE_0 /*!< DMA2D memory to memory with pixel format conversion transfer mode */
  147. #define DMA2D_M2M_BLEND DMA2D_CR_MODE_1 /*!< DMA2D memory to memory with blending transfer mode */
  148. #define DMA2D_R2M DMA2D_CR_MODE /*!< DMA2D register to memory transfer mode */
  149. /**
  150. * @}
  151. */
  152. /** @defgroup DMA2D_Output_Color_Mode DMA2D Output Color Mode
  153. * @{
  154. */
  155. #define DMA2D_OUTPUT_ARGB8888 0x00000000U /*!< ARGB8888 DMA2D color mode */
  156. #define DMA2D_OUTPUT_RGB888 DMA2D_OPFCCR_CM_0 /*!< RGB888 DMA2D color mode */
  157. #define DMA2D_OUTPUT_RGB565 DMA2D_OPFCCR_CM_1 /*!< RGB565 DMA2D color mode */
  158. #define DMA2D_OUTPUT_ARGB1555 (DMA2D_OPFCCR_CM_0|DMA2D_OPFCCR_CM_1) /*!< ARGB1555 DMA2D color mode */
  159. #define DMA2D_OUTPUT_ARGB4444 DMA2D_OPFCCR_CM_2 /*!< ARGB4444 DMA2D color mode */
  160. /**
  161. * @}
  162. */
  163. /** @defgroup DMA2D_Input_Color_Mode DMA2D Input Color Mode
  164. * @{
  165. */
  166. #define DMA2D_INPUT_ARGB8888 0x00000000U /*!< ARGB8888 color mode */
  167. #define DMA2D_INPUT_RGB888 0x00000001U /*!< RGB888 color mode */
  168. #define DMA2D_INPUT_RGB565 0x00000002U /*!< RGB565 color mode */
  169. #define DMA2D_INPUT_ARGB1555 0x00000003U /*!< ARGB1555 color mode */
  170. #define DMA2D_INPUT_ARGB4444 0x00000004U /*!< ARGB4444 color mode */
  171. #define DMA2D_INPUT_L8 0x00000005U /*!< L8 color mode */
  172. #define DMA2D_INPUT_AL44 0x00000006U /*!< AL44 color mode */
  173. #define DMA2D_INPUT_AL88 0x00000007U /*!< AL88 color mode */
  174. #define DMA2D_INPUT_L4 0x00000008U /*!< L4 color mode */
  175. #define DMA2D_INPUT_A8 0x00000009U /*!< A8 color mode */
  176. #define DMA2D_INPUT_A4 0x0000000AU /*!< A4 color mode */
  177. /**
  178. * @}
  179. */
  180. /** @defgroup DMA2D_Alpha_Mode DMA2D Alpha Mode
  181. * @{
  182. */
  183. #define DMA2D_NO_MODIF_ALPHA 0x00000000U /*!< No modification of the alpha channel value */
  184. #define DMA2D_REPLACE_ALPHA 0x00000001U /*!< Replace original alpha channel value by programmed alpha value */
  185. #define DMA2D_COMBINE_ALPHA 0x00000002U /*!< Replace original alpha channel value by programmed alpha value
  186. with original alpha channel value */
  187. /**
  188. * @}
  189. */
  190. /** @defgroup DMA2D_CLUT_CM DMA2D CLUT Color Mode
  191. * @{
  192. */
  193. #define DMA2D_CCM_ARGB8888 0x00000000U /*!< ARGB8888 DMA2D CLUT color mode */
  194. #define DMA2D_CCM_RGB888 0x00000001U /*!< RGB888 DMA2D CLUT color mode */
  195. /**
  196. * @}
  197. */
  198. /** @defgroup DMA2D_Interrupts DMA2D Interrupts
  199. * @{
  200. */
  201. #define DMA2D_IT_CE DMA2D_CR_CEIE /*!< Configuration Error Interrupt */
  202. #define DMA2D_IT_CTC DMA2D_CR_CTCIE /*!< CLUT Transfer Complete Interrupt */
  203. #define DMA2D_IT_CAE DMA2D_CR_CAEIE /*!< CLUT Access Error Interrupt */
  204. #define DMA2D_IT_TW DMA2D_CR_TWIE /*!< Transfer Watermark Interrupt */
  205. #define DMA2D_IT_TC DMA2D_CR_TCIE /*!< Transfer Complete Interrupt */
  206. #define DMA2D_IT_TE DMA2D_CR_TEIE /*!< Transfer Error Interrupt */
  207. /**
  208. * @}
  209. */
  210. /** @defgroup DMA2D_Flags DMA2D Flags
  211. * @{
  212. */
  213. #define DMA2D_FLAG_CE DMA2D_ISR_CEIF /*!< Configuration Error Interrupt Flag */
  214. #define DMA2D_FLAG_CTC DMA2D_ISR_CTCIF /*!< CLUT Transfer Complete Interrupt Flag */
  215. #define DMA2D_FLAG_CAE DMA2D_ISR_CAEIF /*!< CLUT Access Error Interrupt Flag */
  216. #define DMA2D_FLAG_TW DMA2D_ISR_TWIF /*!< Transfer Watermark Interrupt Flag */
  217. #define DMA2D_FLAG_TC DMA2D_ISR_TCIF /*!< Transfer Complete Interrupt Flag */
  218. #define DMA2D_FLAG_TE DMA2D_ISR_TEIF /*!< Transfer Error Interrupt Flag */
  219. /**
  220. * @}
  221. */
  222. /** @defgroup DMA2D_Aliases DMA2D API Aliases
  223. * @{
  224. */
  225. #define HAL_DMA2D_DisableCLUT HAL_DMA2D_CLUTLoading_Abort /*!< Aliased to HAL_DMA2D_CLUTLoading_Abort for compatibility with legacy code */
  226. /**
  227. * @}
  228. */
  229. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  230. /**
  231. * @brief HAL DMA2D common Callback ID enumeration definition
  232. */
  233. typedef enum
  234. {
  235. HAL_DMA2D_MSPINIT_CB_ID = 0x00U, /*!< DMA2D MspInit callback ID */
  236. HAL_DMA2D_MSPDEINIT_CB_ID = 0x01U, /*!< DMA2D MspDeInit callback ID */
  237. HAL_DMA2D_TRANSFERCOMPLETE_CB_ID = 0x02U, /*!< DMA2D transfer complete callback ID */
  238. HAL_DMA2D_TRANSFERERROR_CB_ID = 0x03U, /*!< DMA2D transfer error callback ID */
  239. HAL_DMA2D_LINEEVENT_CB_ID = 0x04U, /*!< DMA2D line event callback ID */
  240. HAL_DMA2D_CLUTLOADINGCPLT_CB_ID = 0x05U, /*!< DMA2D CLUT loading completion callback ID */
  241. }HAL_DMA2D_CallbackIDTypeDef;
  242. #endif /* USE_HAL_DMA2D_REGISTER_CALLBACKS */
  243. /**
  244. * @}
  245. */
  246. /* Exported macros ------------------------------------------------------------*/
  247. /** @defgroup DMA2D_Exported_Macros DMA2D Exported Macros
  248. * @{
  249. */
  250. /** @brief Reset DMA2D handle state
  251. * @param __HANDLE__ specifies the DMA2D handle.
  252. * @retval None
  253. */
  254. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  255. #define __HAL_DMA2D_RESET_HANDLE_STATE(__HANDLE__) do{ \
  256. (__HANDLE__)->State = HAL_DMA2D_STATE_RESET;\
  257. (__HANDLE__)->MspInitCallback = NULL; \
  258. (__HANDLE__)->MspDeInitCallback = NULL; \
  259. }while(0)
  260. #else
  261. #define __HAL_DMA2D_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_DMA2D_STATE_RESET)
  262. #endif /* USE_HAL_DMA2D_REGISTER_CALLBACKS */
  263. /**
  264. * @brief Enable the DMA2D.
  265. * @param __HANDLE__ DMA2D handle
  266. * @retval None.
  267. */
  268. #define __HAL_DMA2D_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= DMA2D_CR_START)
  269. /* Interrupt & Flag management */
  270. /**
  271. * @brief Get the DMA2D pending flags.
  272. * @param __HANDLE__ DMA2D handle
  273. * @param __FLAG__ flag to check.
  274. * This parameter can be any combination of the following values:
  275. * @arg DMA2D_FLAG_CE: Configuration error flag
  276. * @arg DMA2D_FLAG_CTC: CLUT transfer complete flag
  277. * @arg DMA2D_FLAG_CAE: CLUT access error flag
  278. * @arg DMA2D_FLAG_TW: Transfer Watermark flag
  279. * @arg DMA2D_FLAG_TC: Transfer complete flag
  280. * @arg DMA2D_FLAG_TE: Transfer error flag
  281. * @retval The state of FLAG.
  282. */
  283. #define __HAL_DMA2D_GET_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR & (__FLAG__))
  284. /**
  285. * @brief Clear the DMA2D pending flags.
  286. * @param __HANDLE__ DMA2D handle
  287. * @param __FLAG__ specifies the flag to clear.
  288. * This parameter can be any combination of the following values:
  289. * @arg DMA2D_FLAG_CE: Configuration error flag
  290. * @arg DMA2D_FLAG_CTC: CLUT transfer complete flag
  291. * @arg DMA2D_FLAG_CAE: CLUT access error flag
  292. * @arg DMA2D_FLAG_TW: Transfer Watermark flag
  293. * @arg DMA2D_FLAG_TC: Transfer complete flag
  294. * @arg DMA2D_FLAG_TE: Transfer error flag
  295. * @retval None
  296. */
  297. #define __HAL_DMA2D_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->IFCR = (__FLAG__))
  298. /**
  299. * @brief Enable the specified DMA2D interrupts.
  300. * @param __HANDLE__ DMA2D handle
  301. * @param __INTERRUPT__ specifies the DMA2D interrupt sources to be enabled.
  302. * This parameter can be any combination of the following values:
  303. * @arg DMA2D_IT_CE: Configuration error interrupt mask
  304. * @arg DMA2D_IT_CTC: CLUT transfer complete interrupt mask
  305. * @arg DMA2D_IT_CAE: CLUT access error interrupt mask
  306. * @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
  307. * @arg DMA2D_IT_TC: Transfer complete interrupt mask
  308. * @arg DMA2D_IT_TE: Transfer error interrupt mask
  309. * @retval None
  310. */
  311. #define __HAL_DMA2D_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__))
  312. /**
  313. * @brief Disable the specified DMA2D interrupts.
  314. * @param __HANDLE__ DMA2D handle
  315. * @param __INTERRUPT__ specifies the DMA2D interrupt sources to be disabled.
  316. * This parameter can be any combination of the following values:
  317. * @arg DMA2D_IT_CE: Configuration error interrupt mask
  318. * @arg DMA2D_IT_CTC: CLUT transfer complete interrupt mask
  319. * @arg DMA2D_IT_CAE: CLUT access error interrupt mask
  320. * @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
  321. * @arg DMA2D_IT_TC: Transfer complete interrupt mask
  322. * @arg DMA2D_IT_TE: Transfer error interrupt mask
  323. * @retval None
  324. */
  325. #define __HAL_DMA2D_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__))
  326. /**
  327. * @brief Check whether the specified DMA2D interrupt source is enabled or not.
  328. * @param __HANDLE__ DMA2D handle
  329. * @param __INTERRUPT__ specifies the DMA2D interrupt source to check.
  330. * This parameter can be one of the following values:
  331. * @arg DMA2D_IT_CE: Configuration error interrupt mask
  332. * @arg DMA2D_IT_CTC: CLUT transfer complete interrupt mask
  333. * @arg DMA2D_IT_CAE: CLUT access error interrupt mask
  334. * @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
  335. * @arg DMA2D_IT_TC: Transfer complete interrupt mask
  336. * @arg DMA2D_IT_TE: Transfer error interrupt mask
  337. * @retval The state of INTERRUPT source.
  338. */
  339. #define __HAL_DMA2D_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR & (__INTERRUPT__))
  340. /**
  341. * @}
  342. */
  343. /* Exported functions --------------------------------------------------------*/
  344. /** @addtogroup DMA2D_Exported_Functions DMA2D Exported Functions
  345. * @{
  346. */
  347. /** @addtogroup DMA2D_Exported_Functions_Group1 Initialization and de-initialization functions
  348. * @{
  349. */
  350. /* Initialization and de-initialization functions *******************************/
  351. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d);
  352. HAL_StatusTypeDef HAL_DMA2D_DeInit (DMA2D_HandleTypeDef *hdma2d);
  353. void HAL_DMA2D_MspInit(DMA2D_HandleTypeDef* hdma2d);
  354. void HAL_DMA2D_MspDeInit(DMA2D_HandleTypeDef* hdma2d);
  355. /* Callbacks Register/UnRegister functions ***********************************/
  356. #if (USE_HAL_DMA2D_REGISTER_CALLBACKS == 1)
  357. HAL_StatusTypeDef HAL_DMA2D_RegisterCallback(DMA2D_HandleTypeDef *hdma2d, HAL_DMA2D_CallbackIDTypeDef CallbackID, pDMA2D_CallbackTypeDef pCallback);
  358. HAL_StatusTypeDef HAL_DMA2D_UnRegisterCallback(DMA2D_HandleTypeDef *hdma2d, HAL_DMA2D_CallbackIDTypeDef CallbackID);
  359. #endif /* USE_HAL_DMA2D_REGISTER_CALLBACKS */
  360. /**
  361. * @}
  362. */
  363. /** @addtogroup DMA2D_Exported_Functions_Group2 IO operation functions
  364. * @{
  365. */
  366. /* IO operation functions *******************************************************/
  367. HAL_StatusTypeDef HAL_DMA2D_Start(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width, uint32_t Height);
  368. HAL_StatusTypeDef HAL_DMA2D_BlendingStart(DMA2D_HandleTypeDef *hdma2d, uint32_t SrcAddress1, uint32_t SrcAddress2, uint32_t DstAddress, uint32_t Width, uint32_t Height);
  369. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width, uint32_t Height);
  370. HAL_StatusTypeDef HAL_DMA2D_BlendingStart_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t SrcAddress1, uint32_t SrcAddress2, uint32_t DstAddress, uint32_t Width, uint32_t Height);
  371. HAL_StatusTypeDef HAL_DMA2D_Suspend(DMA2D_HandleTypeDef *hdma2d);
  372. HAL_StatusTypeDef HAL_DMA2D_Resume(DMA2D_HandleTypeDef *hdma2d);
  373. HAL_StatusTypeDef HAL_DMA2D_Abort(DMA2D_HandleTypeDef *hdma2d);
  374. HAL_StatusTypeDef HAL_DMA2D_EnableCLUT(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
  375. HAL_StatusTypeDef HAL_DMA2D_CLUTStartLoad(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef *CLUTCfg, uint32_t LayerIdx);
  376. HAL_StatusTypeDef HAL_DMA2D_CLUTStartLoad_IT(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef *CLUTCfg, uint32_t LayerIdx);
  377. HAL_StatusTypeDef HAL_DMA2D_CLUTLoad(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef CLUTCfg, uint32_t LayerIdx);
  378. HAL_StatusTypeDef HAL_DMA2D_CLUTLoad_IT(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef CLUTCfg, uint32_t LayerIdx);
  379. HAL_StatusTypeDef HAL_DMA2D_CLUTLoading_Abort(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
  380. HAL_StatusTypeDef HAL_DMA2D_CLUTLoading_Suspend(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
  381. HAL_StatusTypeDef HAL_DMA2D_CLUTLoading_Resume(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
  382. HAL_StatusTypeDef HAL_DMA2D_PollForTransfer(DMA2D_HandleTypeDef *hdma2d, uint32_t Timeout);
  383. void HAL_DMA2D_IRQHandler(DMA2D_HandleTypeDef *hdma2d);
  384. void HAL_DMA2D_LineEventCallback(DMA2D_HandleTypeDef *hdma2d);
  385. void HAL_DMA2D_CLUTLoadingCpltCallback(DMA2D_HandleTypeDef *hdma2d);
  386. /**
  387. * @}
  388. */
  389. /** @addtogroup DMA2D_Exported_Functions_Group3 Peripheral Control functions
  390. * @{
  391. */
  392. /* Peripheral Control functions *************************************************/
  393. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
  394. HAL_StatusTypeDef HAL_DMA2D_ConfigCLUT(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef CLUTCfg, uint32_t LayerIdx);
  395. HAL_StatusTypeDef HAL_DMA2D_ProgramLineEvent(DMA2D_HandleTypeDef *hdma2d, uint32_t Line);
  396. HAL_StatusTypeDef HAL_DMA2D_EnableDeadTime(DMA2D_HandleTypeDef *hdma2d);
  397. HAL_StatusTypeDef HAL_DMA2D_DisableDeadTime(DMA2D_HandleTypeDef *hdma2d);
  398. HAL_StatusTypeDef HAL_DMA2D_ConfigDeadTime(DMA2D_HandleTypeDef *hdma2d, uint8_t DeadTime);
  399. /**
  400. * @}
  401. */
  402. /** @addtogroup DMA2D_Exported_Functions_Group4 Peripheral State and Error functions
  403. * @{
  404. */
  405. /* Peripheral State functions ***************************************************/
  406. HAL_DMA2D_StateTypeDef HAL_DMA2D_GetState(DMA2D_HandleTypeDef *hdma2d);
  407. uint32_t HAL_DMA2D_GetError(DMA2D_HandleTypeDef *hdma2d);
  408. /**
  409. * @}
  410. */
  411. /**
  412. * @}
  413. */
  414. /* Private constants ---------------------------------------------------------*/
  415. /** @addtogroup DMA2D_Private_Constants DMA2D Private Constants
  416. * @{
  417. */
  418. /** @defgroup DMA2D_Maximum_Line_WaterMark DMA2D Maximum Line Watermark
  419. * @{
  420. */
  421. #define DMA2D_LINE_WATERMARK_MAX DMA2D_LWR_LW /*!< DMA2D maximum line watermark */
  422. /**
  423. * @}
  424. */
  425. /** @defgroup DMA2D_Color_Value DMA2D Color Value
  426. * @{
  427. */
  428. #define DMA2D_COLOR_VALUE 0x000000FFU /*!< Color value mask */
  429. /**
  430. * @}
  431. */
  432. /** @defgroup DMA2D_Max_Layer DMA2D Maximum Number of Layers
  433. * @{
  434. */
  435. #define DMA2D_MAX_LAYER 2U /*!< DMA2D maximum number of layers */
  436. /**
  437. * @}
  438. */
  439. /** @defgroup DMA2D_Layers DMA2D Layers
  440. * @{
  441. */
  442. #define DMA2D_BACKGROUND_LAYER 0x00000000U /*!< DMA2D Background Layer (layer 0) */
  443. #define DMA2D_FOREGROUND_LAYER 0x00000001U /*!< DMA2D Foreground Layer (layer 1) */
  444. /**
  445. * @}
  446. */
  447. /** @defgroup DMA2D_Offset DMA2D Offset
  448. * @{
  449. */
  450. #define DMA2D_OFFSET DMA2D_FGOR_LO /*!< maximum Line Offset */
  451. /**
  452. * @}
  453. */
  454. /** @defgroup DMA2D_Size DMA2D Size
  455. * @{
  456. */
  457. #define DMA2D_PIXEL (DMA2D_NLR_PL >> 16U) /*!< DMA2D maximum number of pixels per line */
  458. #define DMA2D_LINE DMA2D_NLR_NL /*!< DMA2D maximum number of lines */
  459. /**
  460. * @}
  461. */
  462. /** @defgroup DMA2D_CLUT_Size DMA2D CLUT Size
  463. * @{
  464. */
  465. #define DMA2D_CLUT_SIZE (DMA2D_FGPFCCR_CS >> 8U) /*!< DMA2D maximum CLUT size */
  466. /**
  467. * @}
  468. */
  469. /**
  470. * @}
  471. */
  472. /* Private macros ------------------------------------------------------------*/
  473. /** @defgroup DMA2D_Private_Macros DMA2D Private Macros
  474. * @{
  475. */
  476. #define IS_DMA2D_LAYER(LAYER) (((LAYER) == DMA2D_BACKGROUND_LAYER) || ((LAYER) == DMA2D_FOREGROUND_LAYER))
  477. #define IS_DMA2D_MODE(MODE) (((MODE) == DMA2D_M2M) || ((MODE) == DMA2D_M2M_PFC) || \
  478. ((MODE) == DMA2D_M2M_BLEND) || ((MODE) == DMA2D_R2M))
  479. #define IS_DMA2D_CMODE(MODE_ARGB) (((MODE_ARGB) == DMA2D_OUTPUT_ARGB8888) || ((MODE_ARGB) == DMA2D_OUTPUT_RGB888) || \
  480. ((MODE_ARGB) == DMA2D_OUTPUT_RGB565) || ((MODE_ARGB) == DMA2D_OUTPUT_ARGB1555) || \
  481. ((MODE_ARGB) == DMA2D_OUTPUT_ARGB4444))
  482. #define IS_DMA2D_COLOR(COLOR) ((COLOR) <= DMA2D_COLOR_VALUE)
  483. #define IS_DMA2D_LINE(LINE) ((LINE) <= DMA2D_LINE)
  484. #define IS_DMA2D_PIXEL(PIXEL) ((PIXEL) <= DMA2D_PIXEL)
  485. #define IS_DMA2D_OFFSET(OOFFSET) ((OOFFSET) <= DMA2D_OFFSET)
  486. #define IS_DMA2D_INPUT_COLOR_MODE(INPUT_CM) (((INPUT_CM) == DMA2D_INPUT_ARGB8888) || ((INPUT_CM) == DMA2D_INPUT_RGB888) || \
  487. ((INPUT_CM) == DMA2D_INPUT_RGB565) || ((INPUT_CM) == DMA2D_INPUT_ARGB1555) || \
  488. ((INPUT_CM) == DMA2D_INPUT_ARGB4444) || ((INPUT_CM) == DMA2D_INPUT_L8) || \
  489. ((INPUT_CM) == DMA2D_INPUT_AL44) || ((INPUT_CM) == DMA2D_INPUT_AL88) || \
  490. ((INPUT_CM) == DMA2D_INPUT_L4) || ((INPUT_CM) == DMA2D_INPUT_A8) || \
  491. ((INPUT_CM) == DMA2D_INPUT_A4))
  492. #define IS_DMA2D_ALPHA_MODE(AlphaMode) (((AlphaMode) == DMA2D_NO_MODIF_ALPHA) || \
  493. ((AlphaMode) == DMA2D_REPLACE_ALPHA) || \
  494. ((AlphaMode) == DMA2D_COMBINE_ALPHA))
  495. #define IS_DMA2D_CLUT_CM(CLUT_CM) (((CLUT_CM) == DMA2D_CCM_ARGB8888) || ((CLUT_CM) == DMA2D_CCM_RGB888))
  496. #define IS_DMA2D_CLUT_SIZE(CLUT_SIZE) ((CLUT_SIZE) <= DMA2D_CLUT_SIZE)
  497. #define IS_DMA2D_LINEWATERMARK(LineWatermark) ((LineWatermark) <= DMA2D_LINE_WATERMARK_MAX)
  498. #define IS_DMA2D_IT(IT) (((IT) == DMA2D_IT_CTC) || ((IT) == DMA2D_IT_CAE) || \
  499. ((IT) == DMA2D_IT_TW) || ((IT) == DMA2D_IT_TC) || \
  500. ((IT) == DMA2D_IT_TE) || ((IT) == DMA2D_IT_CE))
  501. #define IS_DMA2D_GET_FLAG(FLAG) (((FLAG) == DMA2D_FLAG_CTC) || ((FLAG) == DMA2D_FLAG_CAE) || \
  502. ((FLAG) == DMA2D_FLAG_TW) || ((FLAG) == DMA2D_FLAG_TC) || \
  503. ((FLAG) == DMA2D_FLAG_TE) || ((FLAG) == DMA2D_FLAG_CE))
  504. /**
  505. * @}
  506. */
  507. /**
  508. * @}
  509. */
  510. #endif /* defined (DMA2D) */
  511. /**
  512. * @}
  513. */
  514. #ifdef __cplusplus
  515. }
  516. #endif
  517. #endif /* STM32F4xx_HAL_DMA2D_H */
  518. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/