You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

676 lines
28 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32l0xx_hal_dma.h
  4. * @author MCD Application Team
  5. * @brief Header file of DMA 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 STM32L0xx_HAL_DMA_H
  21. #define STM32L0xx_HAL_DMA_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /* Includes ------------------------------------------------------------------*/
  26. #include "stm32l0xx_hal_def.h"
  27. /** @addtogroup STM32L0xx_HAL_Driver
  28. * @{
  29. */
  30. /** @addtogroup DMA
  31. * @{
  32. */
  33. /* Exported types ------------------------------------------------------------*/
  34. /** @defgroup DMA_Exported_Types DMA Exported Types
  35. * @{
  36. */
  37. /**
  38. * @brief DMA Configuration Structure definition
  39. */
  40. typedef struct
  41. {
  42. uint32_t Request; /*!< Specifies the request selected for the specified channel.
  43. This parameter can be a value of @ref DMA_request */
  44. uint32_t Direction; /*!< Specifies if the data will be transferred from memory to peripheral,
  45. from memory to memory or from peripheral to memory.
  46. This parameter can be a value of @ref DMA_Data_transfer_direction */
  47. uint32_t PeriphInc; /*!< Specifies whether the Peripheral address register should be incremented or not.
  48. This parameter can be a value of @ref DMA_Peripheral_incremented_mode */
  49. uint32_t MemInc; /*!< Specifies whether the memory address register should be incremented or not.
  50. This parameter can be a value of @ref DMA_Memory_incremented_mode */
  51. uint32_t PeriphDataAlignment; /*!< Specifies the Peripheral data width.
  52. This parameter can be a value of @ref DMA_Peripheral_data_size */
  53. uint32_t MemDataAlignment; /*!< Specifies the Memory data width.
  54. This parameter can be a value of @ref DMA_Memory_data_size */
  55. uint32_t Mode; /*!< Specifies the operation mode of the DMAy Channelx.
  56. This parameter can be a value of @ref DMA_mode
  57. @note The circular buffer mode cannot be used if the memory-to-memory
  58. data transfer is configured on the selected Channel */
  59. uint32_t Priority; /*!< Specifies the software priority for the DMAy Channelx.
  60. This parameter can be a value of @ref DMA_Priority_level */
  61. } DMA_InitTypeDef;
  62. /**
  63. * @brief HAL DMA State structures definition
  64. */
  65. typedef enum
  66. {
  67. HAL_DMA_STATE_RESET = 0x00U, /*!< DMA not yet initialized or disabled */
  68. HAL_DMA_STATE_READY = 0x01U, /*!< DMA initialized and ready for use */
  69. HAL_DMA_STATE_BUSY = 0x02U, /*!< DMA process is ongoing */
  70. HAL_DMA_STATE_TIMEOUT = 0x03U, /*!< DMA timeout state */
  71. }HAL_DMA_StateTypeDef;
  72. /**
  73. * @brief HAL DMA Error Code structure definition
  74. */
  75. typedef enum
  76. {
  77. HAL_DMA_FULL_TRANSFER = 0x00U, /*!< Full transfer */
  78. HAL_DMA_HALF_TRANSFER = 0x01U /*!< Half Transfer */
  79. }HAL_DMA_LevelCompleteTypeDef;
  80. /**
  81. * @brief HAL DMA Callback ID structure definition
  82. */
  83. typedef enum
  84. {
  85. HAL_DMA_XFER_CPLT_CB_ID = 0x00U, /*!< Full transfer */
  86. HAL_DMA_XFER_HALFCPLT_CB_ID = 0x01U, /*!< Half transfer */
  87. HAL_DMA_XFER_ERROR_CB_ID = 0x02U, /*!< Error */
  88. HAL_DMA_XFER_ABORT_CB_ID = 0x03U, /*!< Abort */
  89. HAL_DMA_XFER_ALL_CB_ID = 0x04U /*!< All */
  90. }HAL_DMA_CallbackIDTypeDef;
  91. /**
  92. * @brief DMA handle Structure definition
  93. */
  94. typedef struct __DMA_HandleTypeDef
  95. {
  96. DMA_Channel_TypeDef *Instance; /*!< Register base address */
  97. DMA_InitTypeDef Init; /*!< DMA communication parameters */
  98. HAL_LockTypeDef Lock; /*!< DMA locking object */
  99. __IO HAL_DMA_StateTypeDef State; /*!< DMA transfer state */
  100. void *Parent; /*!< Parent object state */
  101. void (* XferCpltCallback)(struct __DMA_HandleTypeDef * hdma); /*!< DMA transfer complete callback */
  102. void (* XferHalfCpltCallback)(struct __DMA_HandleTypeDef * hdma); /*!< DMA Half transfer complete callback */
  103. void (* XferErrorCallback)(struct __DMA_HandleTypeDef * hdma); /*!< DMA transfer error callback */
  104. void (* XferAbortCallback)( struct __DMA_HandleTypeDef * hdma); /*!< DMA transfer abort callback */
  105. __IO uint32_t ErrorCode; /*!< DMA Error code */
  106. DMA_TypeDef *DmaBaseAddress; /*!< DMA Channel Base Address */
  107. uint32_t ChannelIndex; /*!< DMA Channel Index */
  108. }DMA_HandleTypeDef;
  109. /**
  110. * @}
  111. */
  112. /* Exported constants --------------------------------------------------------*/
  113. /** @defgroup DMA_Exported_Constants DMA Exported Constants
  114. * @{
  115. */
  116. /** @defgroup DMA_Error_Code DMA Error Code
  117. * @{
  118. */
  119. #define HAL_DMA_ERROR_NONE 0x00000000U /*!< No error */
  120. #define HAL_DMA_ERROR_TE 0x00000001U /*!< Transfer error */
  121. #define HAL_DMA_ERROR_NO_XFER 0x00000004U /*!< Abort requested with no Xfer ongoing */
  122. #define HAL_DMA_ERROR_TIMEOUT 0x00000020U /*!< Timeout error */
  123. #define HAL_DMA_ERROR_NOT_SUPPORTED 0x00000100U /*!< Not supported mode */
  124. /**
  125. * @}
  126. */
  127. /** @defgroup DMA_request DMA request
  128. * @{
  129. */
  130. #if defined (STM32L010x4) || defined (STM32L010x6) || defined (STM32L010x8) || defined (STM32L010xC)
  131. #define DMA_REQUEST_0 0U
  132. #define DMA_REQUEST_1 1U
  133. #define DMA_REQUEST_4 4U
  134. #define DMA_REQUEST_5 5U
  135. #define DMA_REQUEST_6 6U
  136. #define DMA_REQUEST_8 8U
  137. #define IS_DMA_ALL_REQUEST(REQUEST) (((REQUEST) == DMA_REQUEST_0) || \
  138. ((REQUEST) == DMA_REQUEST_1) || \
  139. ((REQUEST) == DMA_REQUEST_4) || \
  140. ((REQUEST) == DMA_REQUEST_5) || \
  141. ((REQUEST) == DMA_REQUEST_6) || \
  142. ((REQUEST) == DMA_REQUEST_8))
  143. /* STM32L010x4 || STM32L010x6 || STM32L010x8 || STM32L010xC */
  144. #elif defined (STM32L021xx) || defined (STM32L041xx) || defined (STM32L061xx) || defined (STM32L062xx) || defined (STM32L063xx) || defined (STM32L081xx) || defined (STM32L082xx) || defined (STM32L083xx)
  145. #define DMA_REQUEST_0 0U
  146. #define DMA_REQUEST_1 1U
  147. #define DMA_REQUEST_2 2U
  148. #define DMA_REQUEST_3 3U
  149. #define DMA_REQUEST_4 4U
  150. #define DMA_REQUEST_5 5U
  151. #define DMA_REQUEST_6 6U
  152. #define DMA_REQUEST_7 7U
  153. #define DMA_REQUEST_8 8U
  154. #define DMA_REQUEST_9 9U
  155. #define DMA_REQUEST_10 10U
  156. #define DMA_REQUEST_11 11U /* AES product only */
  157. #define DMA_REQUEST_12 12U
  158. #define DMA_REQUEST_13 13U
  159. #define DMA_REQUEST_14 14U
  160. #define DMA_REQUEST_15 15U
  161. #define IS_DMA_ALL_REQUEST(REQUEST) (((REQUEST) == DMA_REQUEST_0) || \
  162. ((REQUEST) == DMA_REQUEST_1) || \
  163. ((REQUEST) == DMA_REQUEST_2) || \
  164. ((REQUEST) == DMA_REQUEST_3) || \
  165. ((REQUEST) == DMA_REQUEST_4) || \
  166. ((REQUEST) == DMA_REQUEST_5) || \
  167. ((REQUEST) == DMA_REQUEST_6) || \
  168. ((REQUEST) == DMA_REQUEST_7) || \
  169. ((REQUEST) == DMA_REQUEST_8) || \
  170. ((REQUEST) == DMA_REQUEST_9) || \
  171. ((REQUEST) == DMA_REQUEST_10) || \
  172. ((REQUEST) == DMA_REQUEST_11) || \
  173. ((REQUEST) == DMA_REQUEST_12) || \
  174. ((REQUEST) == DMA_REQUEST_13) || \
  175. ((REQUEST) == DMA_REQUEST_14) || \
  176. ((REQUEST) == DMA_REQUEST_15))
  177. /* (STM32L021xx) || (STM32L041xx) || (STM32L061xx) || (STM32L062xx) || (STM32L063xx) || (STM32L081xx) || (STM32L082xx) || (STM32L083xx) */
  178. #else
  179. #define DMA_REQUEST_0 0U
  180. #define DMA_REQUEST_1 1U
  181. #define DMA_REQUEST_2 2U
  182. #define DMA_REQUEST_3 3U
  183. #define DMA_REQUEST_4 4U
  184. #define DMA_REQUEST_5 5U
  185. #define DMA_REQUEST_6 6U
  186. #define DMA_REQUEST_7 7U
  187. #define DMA_REQUEST_8 8U
  188. #define DMA_REQUEST_9 9U
  189. #define DMA_REQUEST_10 10U
  190. #define DMA_REQUEST_12 12U
  191. #define DMA_REQUEST_13 13U
  192. #define DMA_REQUEST_14 14U
  193. #define DMA_REQUEST_15 15U
  194. #define IS_DMA_ALL_REQUEST(REQUEST) (((REQUEST) == DMA_REQUEST_0) || \
  195. ((REQUEST) == DMA_REQUEST_1) || \
  196. ((REQUEST) == DMA_REQUEST_2) || \
  197. ((REQUEST) == DMA_REQUEST_3) || \
  198. ((REQUEST) == DMA_REQUEST_4) || \
  199. ((REQUEST) == DMA_REQUEST_5) || \
  200. ((REQUEST) == DMA_REQUEST_6) || \
  201. ((REQUEST) == DMA_REQUEST_7) || \
  202. ((REQUEST) == DMA_REQUEST_8) || \
  203. ((REQUEST) == DMA_REQUEST_9) || \
  204. ((REQUEST) == DMA_REQUEST_10) || \
  205. ((REQUEST) == DMA_REQUEST_12) || \
  206. ((REQUEST) == DMA_REQUEST_13) || \
  207. ((REQUEST) == DMA_REQUEST_14) || \
  208. ((REQUEST) == DMA_REQUEST_15))
  209. #endif /* (STM32L031xx) || (STM32L051xx) || (STM32L052xx) || (STM32L053xx) || (STM32L071xx) || (STM32L072xx) || (STM32L073xx) */
  210. /**
  211. * @}
  212. */
  213. /** @defgroup DMA_Data_transfer_direction DMA Data transfer direction
  214. * @{
  215. */
  216. #define DMA_PERIPH_TO_MEMORY 0x00000000U /*!< Peripheral to memory direction */
  217. #define DMA_MEMORY_TO_PERIPH DMA_CCR_DIR /*!< Memory to peripheral direction */
  218. #define DMA_MEMORY_TO_MEMORY DMA_CCR_MEM2MEM /*!< Memory to memory direction */
  219. /**
  220. * @}
  221. */
  222. /** @defgroup DMA_Peripheral_incremented_mode DMA Peripheral incremented mode
  223. * @{
  224. */
  225. #define DMA_PINC_ENABLE DMA_CCR_PINC /*!< Peripheral increment mode Enable */
  226. #define DMA_PINC_DISABLE 0x00000000U /*!< Peripheral increment mode Disable */
  227. /**
  228. * @}
  229. */
  230. /** @defgroup DMA_Memory_incremented_mode DMA Memory incremented mode
  231. * @{
  232. */
  233. #define DMA_MINC_ENABLE DMA_CCR_MINC /*!< Memory increment mode Enable */
  234. #define DMA_MINC_DISABLE 0x00000000U /*!< Memory increment mode Disable */
  235. /**
  236. * @}
  237. */
  238. /** @defgroup DMA_Peripheral_data_size DMA Peripheral data size
  239. * @{
  240. */
  241. #define DMA_PDATAALIGN_BYTE 0x00000000U /*!< Peripheral data alignment : Byte */
  242. #define DMA_PDATAALIGN_HALFWORD DMA_CCR_PSIZE_0 /*!< Peripheral data alignment : HalfWord */
  243. #define DMA_PDATAALIGN_WORD DMA_CCR_PSIZE_1 /*!< Peripheral data alignment : Word */
  244. /**
  245. * @}
  246. */
  247. /** @defgroup DMA_Memory_data_size DMA Memory data size
  248. * @{
  249. */
  250. #define DMA_MDATAALIGN_BYTE 0x00000000U /*!< Memory data alignment : Byte */
  251. #define DMA_MDATAALIGN_HALFWORD DMA_CCR_MSIZE_0 /*!< Memory data alignment : HalfWord */
  252. #define DMA_MDATAALIGN_WORD DMA_CCR_MSIZE_1 /*!< Memory data alignment : Word */
  253. /**
  254. * @}
  255. */
  256. /** @defgroup DMA_mode DMA mode
  257. * @{
  258. */
  259. #define DMA_NORMAL 0x00000000U /*!< Normal mode */
  260. #define DMA_CIRCULAR DMA_CCR_CIRC /*!< Circular mode */
  261. /**
  262. * @}
  263. */
  264. /** @defgroup DMA_Priority_level DMA Priority level
  265. * @{
  266. */
  267. #define DMA_PRIORITY_LOW 0x00000000U /*!< Priority level : Low */
  268. #define DMA_PRIORITY_MEDIUM DMA_CCR_PL_0 /*!< Priority level : Medium */
  269. #define DMA_PRIORITY_HIGH DMA_CCR_PL_1 /*!< Priority level : High */
  270. #define DMA_PRIORITY_VERY_HIGH DMA_CCR_PL /*!< Priority level : Very_High */
  271. /**
  272. * @}
  273. */
  274. /** @defgroup DMA_interrupt_enable_definitions DMA interrupt enable definitions
  275. * @{
  276. */
  277. #define DMA_IT_TC DMA_CCR_TCIE
  278. #define DMA_IT_HT DMA_CCR_HTIE
  279. #define DMA_IT_TE DMA_CCR_TEIE
  280. /**
  281. * @}
  282. */
  283. /** @defgroup DMA_flag_definitions DMA flag definitions
  284. * @{
  285. */
  286. #define DMA_FLAG_GL1 DMA_ISR_GIF1
  287. #define DMA_FLAG_TC1 DMA_ISR_TCIF1
  288. #define DMA_FLAG_HT1 DMA_ISR_HTIF1
  289. #define DMA_FLAG_TE1 DMA_ISR_TEIF1
  290. #define DMA_FLAG_GL2 DMA_ISR_GIF2
  291. #define DMA_FLAG_TC2 DMA_ISR_TCIF2
  292. #define DMA_FLAG_HT2 DMA_ISR_HTIF2
  293. #define DMA_FLAG_TE2 DMA_ISR_TEIF2
  294. #define DMA_FLAG_GL3 DMA_ISR_GIF3
  295. #define DMA_FLAG_TC3 DMA_ISR_TCIF3
  296. #define DMA_FLAG_HT3 DMA_ISR_HTIF3
  297. #define DMA_FLAG_TE3 DMA_ISR_TEIF3
  298. #define DMA_FLAG_GL4 DMA_ISR_GIF4
  299. #define DMA_FLAG_TC4 DMA_ISR_TCIF4
  300. #define DMA_FLAG_HT4 DMA_ISR_HTIF4
  301. #define DMA_FLAG_TE4 DMA_ISR_TEIF4
  302. #define DMA_FLAG_GL5 DMA_ISR_GIF5
  303. #define DMA_FLAG_TC5 DMA_ISR_TCIF5
  304. #define DMA_FLAG_HT5 DMA_ISR_HTIF5
  305. #define DMA_FLAG_TE5 DMA_ISR_TEIF5
  306. #define DMA_FLAG_GL6 DMA_ISR_GIF6
  307. #define DMA_FLAG_TC6 DMA_ISR_TCIF6
  308. #define DMA_FLAG_HT6 DMA_ISR_HTIF6
  309. #define DMA_FLAG_TE6 DMA_ISR_TEIF6
  310. #define DMA_FLAG_GL7 DMA_ISR_GIF7
  311. #define DMA_FLAG_TC7 DMA_ISR_TCIF7
  312. #define DMA_FLAG_HT7 DMA_ISR_HTIF7
  313. #define DMA_FLAG_TE7 DMA_ISR_TEIF7
  314. /**
  315. * @}
  316. */
  317. /**
  318. * @}
  319. */
  320. /* Exported macros -----------------------------------------------------------*/
  321. /** @defgroup DMA_Exported_Macros DMA Exported Macros
  322. * @{
  323. */
  324. /** @brief Reset DMA handle state.
  325. * @param __HANDLE__: DMA handle
  326. * @retval None
  327. */
  328. #define __HAL_DMA_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_DMA_STATE_RESET)
  329. /**
  330. * @brief Enable the specified DMA Channel.
  331. * @param __HANDLE__: DMA handle
  332. * @retval None
  333. */
  334. #define __HAL_DMA_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CCR |= DMA_CCR_EN)
  335. /**
  336. * @brief Disable the specified DMA Channel.
  337. * @param __HANDLE__: DMA handle
  338. * @retval None
  339. */
  340. #define __HAL_DMA_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CCR &= ~DMA_CCR_EN)
  341. /* Interrupt & Flag management */
  342. /**
  343. * @brief Return the current DMA Channel transfer complete flag.
  344. * @param __HANDLE__: DMA handle
  345. * @retval The specified transfer complete flag index.
  346. */
  347. #if defined (STM32L010x4) || defined (STM32L011xx) || defined (STM32L021xx)
  348. #define __HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__) \
  349. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TC1 :\
  350. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TC2 :\
  351. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TC3 :\
  352. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TC4 :\
  353. DMA_FLAG_TC5)
  354. #else
  355. #define __HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__) \
  356. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TC1 :\
  357. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TC2 :\
  358. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TC3 :\
  359. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TC4 :\
  360. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TC5 :\
  361. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TC6 :\
  362. DMA_FLAG_TC7)
  363. #endif
  364. /**
  365. * @brief Return the current DMA Channel half transfer complete flag.
  366. * @param __HANDLE__: DMA handle
  367. * @retval The specified half transfer complete flag index.
  368. */
  369. #if defined (STM32L010x4) || defined (STM32L011xx) || defined (STM32L021xx)
  370. #define __HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)\
  371. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_HT1 :\
  372. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_HT2 :\
  373. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_HT3 :\
  374. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_HT4 :\
  375. DMA_FLAG_HT5)
  376. #else
  377. #define __HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)\
  378. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_HT1 :\
  379. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_HT2 :\
  380. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_HT3 :\
  381. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_HT4 :\
  382. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_HT5 :\
  383. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_HT6 :\
  384. DMA_FLAG_HT7)
  385. #endif
  386. /**
  387. * @brief Returns the current DMA Channel transfer error flag.
  388. * @param __HANDLE__ DMA handle
  389. * @retval The specified transfer error flag index.
  390. */
  391. #if defined (STM32L010x4) || defined (STM32L011xx) || defined (STM32L021xx)
  392. #define __HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)\
  393. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TE1 :\
  394. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TE2 :\
  395. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TE3 :\
  396. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TE4 :\
  397. DMA_FLAG_TE5)
  398. #else
  399. #define __HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)\
  400. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TE1 :\
  401. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TE2 :\
  402. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TE3 :\
  403. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TE4 :\
  404. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TE5 :\
  405. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TE6 :\
  406. DMA_FLAG_TE7)
  407. #endif
  408. /**
  409. * @brief Returns the current DMA Channel Global interrupt flag.
  410. * @param __HANDLE__ DMA handle
  411. * @retval The specified transfer error flag index.
  412. */
  413. #if defined (STM32L010x4) || defined (STM32L011xx) || defined (STM32L021xx)
  414. #define __HAL_DMA_GET_GI_FLAG_INDEX(__HANDLE__)\
  415. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_ISR_GIF1 :\
  416. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_ISR_GIF2 :\
  417. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_ISR_GIF3 :\
  418. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_ISR_GIF4 :\
  419. DMA_ISR_GIF5)
  420. #else
  421. #define __HAL_DMA_GET_GI_FLAG_INDEX(__HANDLE__)\
  422. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_ISR_GIF1 :\
  423. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_ISR_GIF2 :\
  424. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_ISR_GIF3 :\
  425. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_ISR_GIF4 :\
  426. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_ISR_GIF5 :\
  427. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_ISR_GIF6 :\
  428. DMA_ISR_GIF7)
  429. #endif
  430. /**
  431. * @brief Get the DMA Channel pending flags.
  432. * @param __HANDLE__ DMA handle
  433. * @param __FLAG__ Get the specified flag.
  434. * This parameter can be any combination of the following values:
  435. * @arg DMA_FLAG_TCIFx: Transfer complete flag
  436. * @arg DMA_FLAG_HTIFx: Half transfer complete flag
  437. * @arg DMA_FLAG_TEIFx: Transfer error flag
  438. * @arg DMA_ISR_GIFx: Global interrupt flag
  439. * Where x can be 0_4, 1_5, 2_6 or 3_7 to select the DMA Channel flag.
  440. * @retval The state of FLAG (SET or RESET).
  441. */
  442. #define __HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__) (DMA1->ISR & (__FLAG__))
  443. /**
  444. * @brief Clears the DMA Channel pending flags.
  445. * @param __HANDLE__ DMA handle
  446. * @param __FLAG__ specifies the flag to clear.
  447. * This parameter can be any combination of the following values:
  448. * @arg DMA_FLAG_TCx: Transfer complete flag
  449. * @arg DMA_FLAG_HTx: Half transfer complete flag
  450. * @arg DMA_FLAG_TEx: Transfer error flag
  451. * @arg DMA_FLAG_GLx: Global interrupt flag
  452. * Where x can be 0_4, 1_5, 2_6 or 3_7 to select the DMA Channel flag.
  453. * @retval None
  454. */
  455. #define __HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) (DMA1->IFCR = (__FLAG__))
  456. /**
  457. * @brief Enable the specified DMA Channel interrupts.
  458. * @param __HANDLE__: DMA handle
  459. * @param __INTERRUPT__: specifies the DMA interrupt sources to be enabled or disabled.
  460. * This parameter can be any combination of the following values:
  461. * @arg DMA_IT_TC: Transfer complete interrupt mask
  462. * @arg DMA_IT_HT: Half transfer complete interrupt mask
  463. * @arg DMA_IT_TE: Transfer error interrupt mask
  464. * @retval None
  465. */
  466. #define __HAL_DMA_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CCR |= (__INTERRUPT__))
  467. /**
  468. * @brief Disable the specified DMA Channel interrupts.
  469. * @param __HANDLE__: DMA handle
  470. * @param __INTERRUPT__: specifies the DMA interrupt sources to be enabled or disabled.
  471. * This parameter can be any combination of the following values:
  472. * @arg DMA_IT_TC: Transfer complete interrupt mask
  473. * @arg DMA_IT_HT: Half transfer complete interrupt mask
  474. * @arg DMA_IT_TE: Transfer error interrupt mask
  475. * @retval None
  476. */
  477. #define __HAL_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CCR &= ~(__INTERRUPT__))
  478. /**
  479. * @brief Check whether the specified DMA Channel interrupt is enabled or not.
  480. * @param __HANDLE__: DMA handle
  481. * @param __INTERRUPT__: specifies the DMA interrupt source to check.
  482. * This parameter can be one of the following values:
  483. * @arg DMA_IT_TC: Transfer complete interrupt mask
  484. * @arg DMA_IT_HT: Half transfer complete interrupt mask
  485. * @arg DMA_IT_TE: Transfer error interrupt mask
  486. * @retval The state of DMA_IT (SET or RESET).
  487. */
  488. #define __HAL_DMA_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->CCR & (__INTERRUPT__)))
  489. /**
  490. * @brief Return the number of remaining data units in the current DMA Channel transfer.
  491. * @param __HANDLE__: DMA handle
  492. * @retval The number of remaining data units in the current DMA Channel transfer.
  493. */
  494. #define __HAL_DMA_GET_COUNTER(__HANDLE__) ((__HANDLE__)->Instance->CNDTR)
  495. /**
  496. * @}
  497. */
  498. /* Exported functions --------------------------------------------------------*/
  499. /** @addtogroup DMA_Exported_Functions
  500. * @{
  501. */
  502. /** @addtogroup DMA_Exported_Functions_Group1
  503. * @{
  504. */
  505. /* Initialization and de-initialization functions *****************************/
  506. HAL_StatusTypeDef HAL_DMA_Init(DMA_HandleTypeDef *hdma);
  507. HAL_StatusTypeDef HAL_DMA_DeInit (DMA_HandleTypeDef *hdma);
  508. /**
  509. * @}
  510. */
  511. /** @addtogroup DMA_Exported_Functions_Group2
  512. * @{
  513. */
  514. /* IO operation functions *****************************************************/
  515. HAL_StatusTypeDef HAL_DMA_Start (DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t DataLength);
  516. HAL_StatusTypeDef HAL_DMA_Start_IT(DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t DataLength);
  517. HAL_StatusTypeDef HAL_DMA_Abort(DMA_HandleTypeDef *hdma);
  518. HAL_StatusTypeDef HAL_DMA_Abort_IT(DMA_HandleTypeDef *hdma);
  519. HAL_StatusTypeDef HAL_DMA_PollForTransfer(DMA_HandleTypeDef *hdma, HAL_DMA_LevelCompleteTypeDef CompleteLevel, uint32_t Timeout);
  520. void HAL_DMA_IRQHandler(DMA_HandleTypeDef *hdma);
  521. HAL_StatusTypeDef HAL_DMA_RegisterCallback(DMA_HandleTypeDef *hdma, HAL_DMA_CallbackIDTypeDef CallbackID, void (* pCallback)( DMA_HandleTypeDef * _hdma));
  522. HAL_StatusTypeDef HAL_DMA_UnRegisterCallback(DMA_HandleTypeDef *hdma, HAL_DMA_CallbackIDTypeDef CallbackID);
  523. /**
  524. * @}
  525. */
  526. /** @addtogroup DMA_Exported_Functions_Group3
  527. * @{
  528. */
  529. /* Peripheral State and Error functions ***************************************/
  530. HAL_DMA_StateTypeDef HAL_DMA_GetState(DMA_HandleTypeDef *hdma);
  531. uint32_t HAL_DMA_GetError(DMA_HandleTypeDef *hdma);
  532. /**
  533. * @}
  534. */
  535. /**
  536. * @}
  537. */
  538. /* Define the private group ***********************************/
  539. /**************************************************************/
  540. /** @defgroup DMA_Private DMA Private
  541. * @{
  542. */
  543. #define IS_DMA_DIRECTION(DIRECTION) (((DIRECTION) == DMA_PERIPH_TO_MEMORY ) || \
  544. ((DIRECTION) == DMA_MEMORY_TO_PERIPH) || \
  545. ((DIRECTION) == DMA_MEMORY_TO_MEMORY))
  546. #define IS_DMA_BUFFER_SIZE(SIZE) (((SIZE) >= 0x1U) && ((SIZE) < 0x10000U))
  547. #define IS_DMA_PERIPHERAL_INC_STATE(STATE) (((STATE) == DMA_PINC_ENABLE) || \
  548. ((STATE) == DMA_PINC_DISABLE))
  549. #define IS_DMA_MEMORY_INC_STATE(STATE) (((STATE) == DMA_MINC_ENABLE) || \
  550. ((STATE) == DMA_MINC_DISABLE))
  551. #define IS_DMA_PERIPHERAL_DATA_SIZE(SIZE) (((SIZE) == DMA_PDATAALIGN_BYTE) || \
  552. ((SIZE) == DMA_PDATAALIGN_HALFWORD) || \
  553. ((SIZE) == DMA_PDATAALIGN_WORD))
  554. #define IS_DMA_MEMORY_DATA_SIZE(SIZE) (((SIZE) == DMA_MDATAALIGN_BYTE) || \
  555. ((SIZE) == DMA_MDATAALIGN_HALFWORD) || \
  556. ((SIZE) == DMA_MDATAALIGN_WORD ))
  557. #define IS_DMA_MODE(MODE) (((MODE) == DMA_NORMAL ) || \
  558. ((MODE) == DMA_CIRCULAR))
  559. #define IS_DMA_PRIORITY(PRIORITY) (((PRIORITY) == DMA_PRIORITY_LOW ) || \
  560. ((PRIORITY) == DMA_PRIORITY_MEDIUM) || \
  561. ((PRIORITY) == DMA_PRIORITY_HIGH) || \
  562. ((PRIORITY) == DMA_PRIORITY_VERY_HIGH))
  563. /**
  564. * @}
  565. */
  566. /**************************************************************/
  567. /**
  568. * @}
  569. */
  570. /**
  571. * @}
  572. */
  573. #ifdef __cplusplus
  574. }
  575. #endif
  576. #endif /* STM32L0xx_HAL_DMA_H */
  577. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/