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.
 
 
 

316 lines
14 KiB

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