stm32l1xx_hal_dma_ex.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. /**
  2. ******************************************************************************
  3. * @file stm32l1xx_hal_dma_ex.h
  4. * @author MCD Application Team
  5. * @version V1.0.0
  6. * @date 5-September-2014
  7. * @brief Header file of DMA HAL extension module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32L1xx_HAL_DMA_EX_H
  39. #define __STM32L1xx_HAL_DMA_EX_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #include "stm32l1xx_hal_def.h"
  45. /** @addtogroup STM32L1xx_HAL_Driver
  46. * @{
  47. */
  48. /** @addtogroup DMAEx
  49. * @{
  50. */
  51. /* Exported types ------------------------------------------------------------*/
  52. /* Exported constants --------------------------------------------------------*/
  53. /* Exported macro ------------------------------------------------------------*/
  54. /** @defgroup DMAEx_Exported_Macros DMAEx Exported Macros
  55. * @{
  56. */
  57. /* Interrupt & Flag management */
  58. #if defined(STM32L100xC) || defined (STM32L151xC) || defined (STM32L152xC) || defined (STM32L162xC) || \
  59. defined(STM32L151xCA) || defined (STM32L151xD) || defined (STM32L152xCA) || defined (STM32L152xD) || defined (STM32L162xCA) || defined (STM32L162xD) || \
  60. defined(STM32L151xE) || defined (STM32L152xE) || defined (STM32L162xE)
  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 Get the DMA Channel pending flags.
  117. * @param __HANDLE__: DMA handle
  118. * @param __FLAG__: Get the specified flag.
  119. * This parameter can be any combination of the following values:
  120. * @arg DMA_FLAG_TCx: Transfer complete flag
  121. * @arg DMA_FLAG_HTx: Half transfer complete flag
  122. * @arg DMA_FLAG_TEx: Transfer error flag
  123. * Where x can be 1_7 or 1_5 to select the DMA Channel flag.
  124. * @retval The state of FLAG (SET or RESET).
  125. */
  126. #define __HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__)\
  127. (((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Channel7)? (DMA2->ISR & (__FLAG__)) :\
  128. (DMA1->ISR & (__FLAG__)))
  129. /**
  130. * @brief Clears the DMA Channel pending flags.
  131. * @param __HANDLE__: DMA handle
  132. * @param __FLAG__: specifies the flag to clear.
  133. * This parameter can be any combination of the following values:
  134. * @arg DMA_FLAG_TCx: Transfer complete flag
  135. * @arg DMA_FLAG_HTx: Half transfer complete flag
  136. * @arg DMA_FLAG_TEx: Transfer error flag
  137. * Where x can be 1_7 or 1_5 to select the DMA Channel flag.
  138. * @retval None
  139. */
  140. #define __HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) \
  141. (((uint32_t)((__HANDLE__)->Instance) > (uint32_t)DMA1_Channel7)? (DMA2->IFCR = (__FLAG__)) :\
  142. (DMA1->IFCR = (__FLAG__)))
  143. #else
  144. /**
  145. * @brief Returns the current DMA Channel transfer complete flag.
  146. * @param __HANDLE__: DMA handle
  147. * @retval The specified transfer complete flag index.
  148. */
  149. #define __HAL_DMA_GET_TC_FLAG_INDEX(__HANDLE__) \
  150. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TC1 :\
  151. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TC2 :\
  152. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TC3 :\
  153. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TC4 :\
  154. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TC5 :\
  155. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TC6 :\
  156. DMA_FLAG_TC7)
  157. /**
  158. * @brief Returns the current DMA Channel half transfer complete flag.
  159. * @param __HANDLE__: DMA handle
  160. * @retval The specified half transfer complete flag index.
  161. */
  162. #define __HAL_DMA_GET_HT_FLAG_INDEX(__HANDLE__)\
  163. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_HT1 :\
  164. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_HT2 :\
  165. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_HT3 :\
  166. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_HT4 :\
  167. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_HT5 :\
  168. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_HT6 :\
  169. DMA_FLAG_HT7)
  170. /**
  171. * @brief Returns the current DMA Channel transfer error flag.
  172. * @param __HANDLE__: DMA handle
  173. * @retval The specified transfer error flag index.
  174. */
  175. #define __HAL_DMA_GET_TE_FLAG_INDEX(__HANDLE__)\
  176. (((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel1))? DMA_FLAG_TE1 :\
  177. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel2))? DMA_FLAG_TE2 :\
  178. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel3))? DMA_FLAG_TE3 :\
  179. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel4))? DMA_FLAG_TE4 :\
  180. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel5))? DMA_FLAG_TE5 :\
  181. ((uint32_t)((__HANDLE__)->Instance) == ((uint32_t)DMA1_Channel6))? DMA_FLAG_TE6 :\
  182. DMA_FLAG_TE7)
  183. /**
  184. * @brief Get the DMA Channel pending flags.
  185. * @param __HANDLE__: DMA handle
  186. * @param __FLAG__: Get the specified flag.
  187. * This parameter can be any combination of the following values:
  188. * @arg DMA_FLAG_TCx: Transfer complete flag
  189. * @arg DMA_FLAG_HTx: Half transfer complete flag
  190. * @arg DMA_FLAG_TEx: Transfer error flag
  191. * Where x can be 1_7 to select the DMA Channel flag.
  192. * @retval The state of FLAG (SET or RESET).
  193. */
  194. #define __HAL_DMA_GET_FLAG(__HANDLE__, __FLAG__) (DMA1->ISR & (__FLAG__))
  195. /**
  196. * @brief Clears the DMA Channel pending flags.
  197. * @param __HANDLE__: DMA handle
  198. * @param __FLAG__: specifies the flag to clear.
  199. * This parameter can be any combination of the following values:
  200. * @arg DMA_FLAG_TCx: Transfer complete flag
  201. * @arg DMA_FLAG_HTx: Half transfer complete flag
  202. * @arg DMA_FLAG_TEx: Transfer error flag
  203. * Where x can be 1_7 to select the DMA Channel flag.
  204. * @retval None
  205. */
  206. #define __HAL_DMA_CLEAR_FLAG(__HANDLE__, __FLAG__) (DMA1->IFCR = (__FLAG__))
  207. #endif /* STM32L100xC || STM32L151xC || STM32L152xC || STM32L162xC || STM32L151xCA) || defined (STM32L151xD) || defined (STM32L152xCA) || defined (STM32L152xD) || defined (STM32L162xCA) || defined (STM32L162xD) || STM32L151xE || STM32L152xE || STM32L162xE */
  208. /**
  209. * @}
  210. */
  211. /**
  212. * @}
  213. */
  214. /**
  215. * @}
  216. */
  217. #ifdef __cplusplus
  218. }
  219. #endif
  220. #endif /* __STM32L1xx_HAL_DMA_EX_H */
  221. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/