stm32f1xx_hal_dma_ex.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294
  1. /**
  2. ******************************************************************************
  3. * @file stm32f1xx_hal_dma_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of DMA HAL extension module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  10. *
  11. * Redistribution and use in source and binary forms, with or without modification,
  12. * are permitted provided that the following conditions are met:
  13. * 1. Redistributions of source code must retain the above copyright notice,
  14. * this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright notice,
  16. * this list of conditions and the following disclaimer in the documentation
  17. * and/or other materials provided with the distribution.
  18. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  19. * may be used to endorse or promote products derived from this software
  20. * without specific prior written permission.
  21. *
  22. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  23. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  26. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  28. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  29. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. ******************************************************************************
  34. */
  35. /* Define to prevent recursive inclusion -------------------------------------*/
  36. #ifndef __STM32F1xx_HAL_DMA_EX_H
  37. #define __STM32F1xx_HAL_DMA_EX_H
  38. #ifdef __cplusplus
  39. extern "C" {
  40. #endif
  41. /* Includes ------------------------------------------------------------------*/
  42. #include "stm32f1xx_hal_def.h"
  43. /** @addtogroup STM32F1xx_HAL_Driver
  44. * @{
  45. */
  46. /** @defgroup DMAEx DMAEx
  47. * @{
  48. */
  49. /* Exported types ------------------------------------------------------------*/
  50. /* Exported constants --------------------------------------------------------*/
  51. /* Exported macro ------------------------------------------------------------*/
  52. /** @defgroup DMAEx_Exported_Macros DMA Extended Exported Macros
  53. * @{
  54. */
  55. /* Interrupt & Flag management */
  56. #if defined (STM32F100xE) || defined (STM32F101xE) || defined (STM32F101xG) || defined (STM32F103xE) || \
  57. defined (STM32F103xG) || defined (STM32F105xC) || defined (STM32F107xC)
  58. /** @defgroup DMAEx_High_density_XL_density_Product_devices DMAEx High density and XL density product devices
  59. * @{
  60. */
  61. /**
  62. * @brief Returns the current DMA Channel transfer complete flag.
  63. * @param __HANDLE__: DMA handle
  64. * @retval The specified transfer complete flag index.
  65. */
  66. #define __HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__) \
  67. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TC1 :\
  68. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TC2 :\
  69. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TC3 :\
  70. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TC4 :\
  71. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TC5 :\
  72. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TC6 :\
  73. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel7))? DMA_FLAG_TC7 :\
  74. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel1))? DMA_FLAG_TC1 :\
  75. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel2))? DMA_FLAG_TC2 :\
  76. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel3))? DMA_FLAG_TC3 :\
  77. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel4))? DMA_FLAG_TC4 :\
  78. DMA_FLAG_TC5)
  79. /**
  80. * @brief Returns the current DMA Channel half transfer complete flag.
  81. * @param __HANDLE__: DMA handle
  82. * @retval The specified half transfer complete flag index.
  83. */
  84. #define __HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)\
  85. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_HT1 :\
  86. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_HT2 :\
  87. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_HT3 :\
  88. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_HT4 :\
  89. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_HT5 :\
  90. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_HT6 :\
  91. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel7))? DMA_FLAG_HT7 :\
  92. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel1))? DMA_FLAG_HT1 :\
  93. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel2))? DMA_FLAG_HT2 :\
  94. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel3))? DMA_FLAG_HT3 :\
  95. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel4))? DMA_FLAG_HT4 :\
  96. DMA_FLAG_HT5)
  97. /**
  98. * @brief Returns the current DMA Channel transfer error flag.
  99. * @param __HANDLE__: DMA handle
  100. * @retval The specified transfer error flag index.
  101. */
  102. #define __HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)\
  103. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TE1 :\
  104. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TE2 :\
  105. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TE3 :\
  106. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TE4 :\
  107. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TE5 :\
  108. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TE6 :\
  109. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel7))? DMA_FLAG_TE7 :\
  110. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel1))? DMA_FLAG_TE1 :\
  111. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel2))? DMA_FLAG_TE2 :\
  112. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel3))? DMA_FLAG_TE3 :\
  113. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel4))? DMA_FLAG_TE4 :\
  114. DMA_FLAG_TE5)
  115. /**
  116. * @brief Return the current DMA Channel Global interrupt flag.
  117. * @param __HANDLE__: DMA handle
  118. * @retval The specified transfer error flag index.
  119. */
  120. #define __HAL_DMA_GET_GI_FLAG_INDEX(__HANDLE__)\
  121. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_GL1 :\
  122. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_GL2 :\
  123. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_GL3 :\
  124. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_GL4 :\
  125. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_GL5 :\
  126. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_GL6 :\
  127. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel7))? DMA_FLAG_GL7 :\
  128. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel1))? DMA_FLAG_GL1 :\
  129. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel2))? DMA_FLAG_GL2 :\
  130. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel3))? DMA_FLAG_GL3 :\
  131. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA2_Channel4))? DMA_FLAG_GL4 :\
  132. DMA_FLAG_GL5)
  133. /**
  134. * @brief Get the DMA Channel pending flags.
  135. * @param __HANDLE__: DMA handle
  136. * @param __FLAG__: Get the specified flag.
  137. * This parameter can be any combination of the following values:
  138. * @arg DMA_FLAG_TCx: Transfer complete flag
  139. * @arg DMA_FLAG_HTx: Half transfer complete flag
  140. * @arg DMA_FLAG_TEx: Transfer error flag
  141. * Where x can be 1_7 or 1_5 (depending on DMA1 or DMA2) to select the DMA Channel flag.
  142. * @retval The state of FLAG (SET or RESET).
  143. */
  144. #define __HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__)\
  145. (((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Channel7)? (DMA2->ISR & (__FLAG__)) :\
  146. (DMA1->ISR & (__FLAG__)))
  147. /**
  148. * @brief Clears the DMA Channel pending flags.
  149. * @param __HANDLE__: DMA handle
  150. * @param __FLAG__: specifies the flag to clear.
  151. * This parameter can be any combination of the following values:
  152. * @arg DMA_FLAG_TCx: Transfer complete flag
  153. * @arg DMA_FLAG_HTx: Half transfer complete flag
  154. * @arg DMA_FLAG_TEx: Transfer error flag
  155. * Where x can be 1_7 or 1_5 (depending on DMA1 or DMA2) to select the DMA Channel flag.
  156. * @retval None
  157. */
  158. #define __HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) \
  159. (((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Channel7)? (DMA2->IFCR = (__FLAG__)) :\
  160. (DMA1->IFCR = (__FLAG__)))
  161. /**
  162. * @}
  163. */
  164. #else
  165. /** @defgroup DMA_Low_density_Medium_density_Product_devices DMA Low density and Medium density product devices
  166. * @{
  167. */
  168. /**
  169. * @brief Returns the current DMA Channel transfer complete flag.
  170. * @param __HANDLE__: DMA handle
  171. * @retval The specified transfer complete flag index.
  172. */
  173. #define __HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__) \
  174. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TC1 :\
  175. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TC2 :\
  176. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TC3 :\
  177. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TC4 :\
  178. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TC5 :\
  179. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TC6 :\
  180. DMA_FLAG_TC7)
  181. /**
  182. * @brief Return the current DMA Channel half transfer complete flag.
  183. * @param __HANDLE__: DMA handle
  184. * @retval The specified half transfer complete flag index.
  185. */
  186. #define __HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)\
  187. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_HT1 :\
  188. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_HT2 :\
  189. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_HT3 :\
  190. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_HT4 :\
  191. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_HT5 :\
  192. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_HT6 :\
  193. DMA_FLAG_HT7)
  194. /**
  195. * @brief Return the current DMA Channel transfer error flag.
  196. * @param __HANDLE__: DMA handle
  197. * @retval The specified transfer error flag index.
  198. */
  199. #define __HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)\
  200. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TE1 :\
  201. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TE2 :\
  202. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TE3 :\
  203. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TE4 :\
  204. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TE5 :\
  205. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TE6 :\
  206. DMA_FLAG_TE7)
  207. /**
  208. * @brief Return the current DMA Channel Global interrupt flag.
  209. * @param __HANDLE__: DMA handle
  210. * @retval The specified transfer error flag index.
  211. */
  212. #define __HAL_DMA_GET_GI_FLAG_INDEX(__HANDLE__)\
  213. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_GL1 :\
  214. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_GL2 :\
  215. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_GL3 :\
  216. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_GL4 :\
  217. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_GL5 :\
  218. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_GL6 :\
  219. DMA_FLAG_GL7)
  220. /**
  221. * @brief Get the DMA Channel pending flags.
  222. * @param __HANDLE__: DMA handle
  223. * @param __FLAG__: Get the specified flag.
  224. * This parameter can be any combination of the following values:
  225. * @arg DMA_FLAG_TCx: Transfer complete flag
  226. * @arg DMA_FLAG_HTx: Half transfer complete flag
  227. * @arg DMA_FLAG_TEx: Transfer error flag
  228. * @arg DMA_FLAG_GLx: Global interrupt flag
  229. * Where x can be 1_7 to select the DMA Channel flag.
  230. * @retval The state of FLAG (SET or RESET).
  231. */
  232. #define __HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__) (DMA1->ISR & (__FLAG__))
  233. /**
  234. * @brief Clear the DMA Channel pending flags.
  235. * @param __HANDLE__: DMA handle
  236. * @param __FLAG__: specifies the flag to clear.
  237. * This parameter can be any combination of the following values:
  238. * @arg DMA_FLAG_TCx: Transfer complete flag
  239. * @arg DMA_FLAG_HTx: Half transfer complete flag
  240. * @arg DMA_FLAG_TEx: Transfer error flag
  241. * @arg DMA_FLAG_GLx: Global interrupt flag
  242. * Where x can be 1_7 to select the DMA Channel flag.
  243. * @retval None
  244. */
  245. #define __HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) (DMA1->IFCR = (__FLAG__))
  246. /**
  247. * @}
  248. */
  249. #endif
  250. /**
  251. * @}
  252. */
  253. /**
  254. * @}
  255. */
  256. /**
  257. * @}
  258. */
  259. #ifdef __cplusplus
  260. }
  261. #endif /* STM32F100xE || STM32F101xE || STM32F101xG || STM32F103xE || */
  262. /* STM32F103xG || STM32F105xC || STM32F107xC */
  263. #endif /* __STM32F1xx_HAL_DMA_H */
  264. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/