stm32f0xx_hal_adc_ex.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. /**
  2. ******************************************************************************
  3. * @file stm32f0xx_hal_adc_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of ADC HAL Extension module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file
  13. * in the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. *
  16. ******************************************************************************
  17. */
  18. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef __STM32F0xx_HAL_ADC_EX_H
  20. #define __STM32F0xx_HAL_ADC_EX_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32f0xx_hal_def.h"
  26. /** @addtogroup STM32F0xx_HAL_Driver
  27. * @{
  28. */
  29. /** @addtogroup ADCEx
  30. * @{
  31. */
  32. /* Exported types ------------------------------------------------------------*/
  33. /* Exported constants --------------------------------------------------------*/
  34. /** @defgroup ADC_Exported_Constants ADC Exported Constants
  35. * @{
  36. */
  37. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  38. #define ADC_CCR_ALL (ADC_CCR_VBATEN | ADC_CCR_TSEN | ADC_CCR_VREFEN)
  39. #else
  40. #define ADC_CCR_ALL (ADC_CCR_TSEN | ADC_CCR_VREFEN)
  41. #endif
  42. /** @defgroup ADC_External_trigger_source_Regular ADC External trigger source Regular
  43. * @{
  44. */
  45. /* List of external triggers with generic trigger name, sorted by trigger */
  46. /* name: */
  47. /* External triggers of regular group for ADC1 */
  48. #define ADC_EXTERNALTRIGCONV_T1_TRGO ADC1_2_EXTERNALTRIG_T1_TRGO
  49. #define ADC_EXTERNALTRIGCONV_T1_CC4 ADC1_2_EXTERNALTRIG_T1_CC4
  50. #define ADC_EXTERNALTRIGCONV_T3_TRGO ADC1_2_EXTERNALTRIG_T3_TRGO
  51. #define ADC_SOFTWARE_START (ADC_CFGR1_EXTSEL + 1U)
  52. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  53. #define ADC_EXTERNALTRIGCONV_T2_TRGO ADC1_2_EXTERNALTRIG_T2_TRGO
  54. #endif
  55. #if !defined(STM32F030x6) && !defined(STM32F070x6) && !defined(STM32F042x6)
  56. #define ADC_EXTERNALTRIGCONV_T15_TRGO ADC1_2_EXTERNALTRIG_T15_TRGO
  57. #endif
  58. /**
  59. * @}
  60. */
  61. /** @defgroup ADC_channels ADC channels
  62. * @{
  63. */
  64. /* Note: Depending on devices, some channels may not be available on package */
  65. /* pins. Refer to device datasheet for channels availability. */
  66. /* Note: Channels are used by bitfields for setting of channel selection */
  67. /* (register ADC_CHSELR) and used by number for setting of analog */
  68. /* watchdog channel (bits AWDCH in register ADC_CFGR1). */
  69. /* Channels are defined with decimal numbers and converted them to */
  70. /* bitfields when needed. */
  71. #define ADC_CHANNEL_0 ( 0x00000000U)
  72. #define ADC_CHANNEL_1 ( 0x00000001U)
  73. #define ADC_CHANNEL_2 ( 0x00000002U)
  74. #define ADC_CHANNEL_3 ( 0x00000003U)
  75. #define ADC_CHANNEL_4 ( 0x00000004U)
  76. #define ADC_CHANNEL_5 ( 0x00000005U)
  77. #define ADC_CHANNEL_6 ( 0x00000006U)
  78. #define ADC_CHANNEL_7 ( 0x00000007U)
  79. #define ADC_CHANNEL_8 ( 0x00000008U)
  80. #define ADC_CHANNEL_9 ( 0x00000009U)
  81. #define ADC_CHANNEL_10 ( 0x0000000AU)
  82. #define ADC_CHANNEL_11 ( 0x0000000BU)
  83. #define ADC_CHANNEL_12 ( 0x0000000CU)
  84. #define ADC_CHANNEL_13 ( 0x0000000DU)
  85. #define ADC_CHANNEL_14 ( 0x0000000EU)
  86. #define ADC_CHANNEL_15 ( 0x0000000FU)
  87. #define ADC_CHANNEL_16 ( 0x00000010U)
  88. #define ADC_CHANNEL_17 ( 0x00000011U)
  89. #define ADC_CHANNEL_TEMPSENSOR ADC_CHANNEL_16
  90. #define ADC_CHANNEL_VREFINT ADC_CHANNEL_17
  91. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  92. #define ADC_CHANNEL_18 ( 0x00000012U)
  93. #define ADC_CHANNEL_VBAT ADC_CHANNEL_18
  94. #endif
  95. /**
  96. * @}
  97. */
  98. /**
  99. * @}
  100. */
  101. /* Exported macro ------------------------------------------------------------*/
  102. /* Private macros ------------------------------------------------------------*/
  103. /** @defgroup ADCEx_Private_Macros ADCEx Private Macros
  104. * @{
  105. */
  106. /* Macro reserved for internal HAL driver usage, not intended to be used in */
  107. /* code of final user. */
  108. /**
  109. * @brief Test if the selected ADC channel is an internal channel
  110. * VrefInt/TempSensor/Vbat
  111. * Note: On STM32F0, availability of internal channel Vbat depends on
  112. * devices lines.
  113. * @param __CHANNEL__ ADC channel
  114. * @retval None
  115. */
  116. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  117. #define ADC_IS_CHANNEL_INTERNAL(__CHANNEL__) \
  118. (((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR) || \
  119. ((__CHANNEL__) == ADC_CHANNEL_VREFINT) || \
  120. ((__CHANNEL__) == ADC_CHANNEL_VBAT) \
  121. )
  122. #else
  123. #define ADC_IS_CHANNEL_INTERNAL(__CHANNEL__) \
  124. (((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR) || \
  125. ((__CHANNEL__) == ADC_CHANNEL_VREFINT) \
  126. )
  127. #endif
  128. /**
  129. * @brief Select the internal measurement path to be enabled/disabled
  130. * corresponding to the selected ADC internal channel
  131. * VrefInt/TempSensor/Vbat.
  132. * Note: On STM32F0, availability of internal channel Vbat depends on
  133. * devices lines.
  134. * @param __CHANNEL__ ADC channel
  135. * @retval Bit of register ADC_CCR
  136. */
  137. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  138. #define ADC_CHANNEL_INTERNAL_PATH(__CHANNEL__) \
  139. (( (__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR \
  140. )? \
  141. (ADC_CCR_TSEN) \
  142. : \
  143. ( \
  144. ( (__CHANNEL__) == ADC_CHANNEL_VREFINT \
  145. )? \
  146. (ADC_CCR_VREFEN) \
  147. : \
  148. (ADC_CCR_VBATEN) \
  149. ) \
  150. )
  151. #else
  152. #define ADC_CHANNEL_INTERNAL_PATH(__CHANNEL__) \
  153. (( (__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR \
  154. )? \
  155. (ADC_CCR_TSEN) \
  156. : \
  157. (ADC_CCR_VREFEN) \
  158. )
  159. #endif
  160. #if defined (STM32F030x6) || defined (STM32F070x6)
  161. #define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \
  162. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \
  163. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \
  164. ((REGTRIG) == ADC_SOFTWARE_START))
  165. #elif defined (STM32F042x6)
  166. #define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \
  167. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \
  168. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T2_TRGO) || \
  169. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \
  170. ((REGTRIG) == ADC_SOFTWARE_START))
  171. #elif defined (STM32F030xC) || defined (STM32F070xB) || defined (STM32F030x8)
  172. #define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \
  173. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \
  174. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \
  175. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T15_TRGO) || \
  176. ((REGTRIG) == ADC_SOFTWARE_START))
  177. #else
  178. #define IS_ADC_EXTTRIG(REGTRIG) (((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_TRGO) || \
  179. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T1_CC4) || \
  180. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T2_TRGO) || \
  181. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T3_TRGO) || \
  182. ((REGTRIG) == ADC_EXTERNALTRIGCONV_T15_TRGO) || \
  183. ((REGTRIG) == ADC_SOFTWARE_START))
  184. #endif
  185. #if !defined(STM32F030x6) && !defined(STM32F030x8) && !defined(STM32F070x6) && !defined(STM32F070xB) && !defined(STM32F030xC)
  186. #define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_CHANNEL_0) || \
  187. ((CHANNEL) == ADC_CHANNEL_1) || \
  188. ((CHANNEL) == ADC_CHANNEL_2) || \
  189. ((CHANNEL) == ADC_CHANNEL_3) || \
  190. ((CHANNEL) == ADC_CHANNEL_4) || \
  191. ((CHANNEL) == ADC_CHANNEL_5) || \
  192. ((CHANNEL) == ADC_CHANNEL_6) || \
  193. ((CHANNEL) == ADC_CHANNEL_7) || \
  194. ((CHANNEL) == ADC_CHANNEL_8) || \
  195. ((CHANNEL) == ADC_CHANNEL_9) || \
  196. ((CHANNEL) == ADC_CHANNEL_10) || \
  197. ((CHANNEL) == ADC_CHANNEL_11) || \
  198. ((CHANNEL) == ADC_CHANNEL_12) || \
  199. ((CHANNEL) == ADC_CHANNEL_13) || \
  200. ((CHANNEL) == ADC_CHANNEL_14) || \
  201. ((CHANNEL) == ADC_CHANNEL_15) || \
  202. ((CHANNEL) == ADC_CHANNEL_TEMPSENSOR) || \
  203. ((CHANNEL) == ADC_CHANNEL_VREFINT) || \
  204. ((CHANNEL) == ADC_CHANNEL_VBAT) )
  205. #else
  206. #define IS_ADC_CHANNEL(CHANNEL) (((CHANNEL) == ADC_CHANNEL_0) || \
  207. ((CHANNEL) == ADC_CHANNEL_1) || \
  208. ((CHANNEL) == ADC_CHANNEL_2) || \
  209. ((CHANNEL) == ADC_CHANNEL_3) || \
  210. ((CHANNEL) == ADC_CHANNEL_4) || \
  211. ((CHANNEL) == ADC_CHANNEL_5) || \
  212. ((CHANNEL) == ADC_CHANNEL_6) || \
  213. ((CHANNEL) == ADC_CHANNEL_7) || \
  214. ((CHANNEL) == ADC_CHANNEL_8) || \
  215. ((CHANNEL) == ADC_CHANNEL_9) || \
  216. ((CHANNEL) == ADC_CHANNEL_10) || \
  217. ((CHANNEL) == ADC_CHANNEL_11) || \
  218. ((CHANNEL) == ADC_CHANNEL_12) || \
  219. ((CHANNEL) == ADC_CHANNEL_13) || \
  220. ((CHANNEL) == ADC_CHANNEL_14) || \
  221. ((CHANNEL) == ADC_CHANNEL_15) || \
  222. ((CHANNEL) == ADC_CHANNEL_TEMPSENSOR) || \
  223. ((CHANNEL) == ADC_CHANNEL_VREFINT) )
  224. #endif
  225. /**
  226. * @}
  227. */
  228. /* Exported functions --------------------------------------------------------*/
  229. /** @addtogroup ADCEx_Exported_Functions
  230. * @{
  231. */
  232. /* IO operation functions *****************************************************/
  233. /** @addtogroup ADCEx_Exported_Functions_Group1
  234. * @{
  235. */
  236. /* ADC calibration */
  237. HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc);
  238. /**
  239. * @}
  240. */
  241. /**
  242. * @}
  243. */
  244. /**
  245. * @}
  246. */
  247. /**
  248. * @}
  249. */
  250. #ifdef __cplusplus
  251. }
  252. #endif
  253. #endif /* __STM32F0xx_HAL_ADC_EX_H */