stm32f7xx_ll_adc.c 42 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918
  1. /**
  2. ******************************************************************************
  3. * @file stm32f7xx_ll_adc.c
  4. * @author MCD Application Team
  5. * @brief ADC LL module driver
  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. #if defined(USE_FULL_LL_DRIVER)
  36. /* Includes ------------------------------------------------------------------*/
  37. #include "stm32f7xx_ll_adc.h"
  38. #include "stm32f7xx_ll_bus.h"
  39. #ifdef USE_FULL_ASSERT
  40. #include "stm32_assert.h"
  41. #else
  42. #define assert_param(expr) ((void)0U)
  43. #endif
  44. /** @addtogroup STM32F7xx_LL_Driver
  45. * @{
  46. */
  47. #if defined (ADC1) || defined (ADC2) || defined (ADC3)
  48. /** @addtogroup ADC_LL ADC
  49. * @{
  50. */
  51. /* Private types -------------------------------------------------------------*/
  52. /* Private variables ---------------------------------------------------------*/
  53. /* Private constants ---------------------------------------------------------*/
  54. /* Private macros ------------------------------------------------------------*/
  55. /** @addtogroup ADC_LL_Private_Macros
  56. * @{
  57. */
  58. /* Check of parameters for configuration of ADC hierarchical scope: */
  59. /* common to several ADC instances. */
  60. #define IS_LL_ADC_COMMON_CLOCK(__CLOCK__) \
  61. ( ((__CLOCK__) == LL_ADC_CLOCK_SYNC_PCLK_DIV2) \
  62. || ((__CLOCK__) == LL_ADC_CLOCK_SYNC_PCLK_DIV4) \
  63. || ((__CLOCK__) == LL_ADC_CLOCK_SYNC_PCLK_DIV6) \
  64. || ((__CLOCK__) == LL_ADC_CLOCK_SYNC_PCLK_DIV8) \
  65. )
  66. /* Check of parameters for configuration of ADC hierarchical scope: */
  67. /* ADC instance. */
  68. #define IS_LL_ADC_RESOLUTION(__RESOLUTION__) \
  69. ( ((__RESOLUTION__) == LL_ADC_RESOLUTION_12B) \
  70. || ((__RESOLUTION__) == LL_ADC_RESOLUTION_10B) \
  71. || ((__RESOLUTION__) == LL_ADC_RESOLUTION_8B) \
  72. || ((__RESOLUTION__) == LL_ADC_RESOLUTION_6B) \
  73. )
  74. #define IS_LL_ADC_DATA_ALIGN(__DATA_ALIGN__) \
  75. ( ((__DATA_ALIGN__) == LL_ADC_DATA_ALIGN_RIGHT) \
  76. || ((__DATA_ALIGN__) == LL_ADC_DATA_ALIGN_LEFT) \
  77. )
  78. #define IS_LL_ADC_SCAN_SELECTION(__SCAN_SELECTION__) \
  79. ( ((__SCAN_SELECTION__) == LL_ADC_SEQ_SCAN_DISABLE) \
  80. || ((__SCAN_SELECTION__) == LL_ADC_SEQ_SCAN_ENABLE) \
  81. )
  82. #define IS_LL_ADC_SEQ_SCAN_MODE(__SEQ_SCAN_MODE__) \
  83. ( ((__SCAN_MODE__) == LL_ADC_SEQ_SCAN_DISABLE) \
  84. || ((__SCAN_MODE__) == LL_ADC_SEQ_SCAN_ENABLE) \
  85. )
  86. /* Check of parameters for configuration of ADC hierarchical scope: */
  87. /* ADC group regular */
  88. #define IS_LL_ADC_REG_TRIG_SOURCE(__REG_TRIG_SOURCE__) \
  89. ( ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_SOFTWARE) \
  90. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM1_CH1) \
  91. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM1_CH2) \
  92. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM1_CH3) \
  93. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM2_CH2) \
  94. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM5_TRGO) \
  95. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM4_CH4) \
  96. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM3_CH4) \
  97. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM8_TRGO) \
  98. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM1_TRGO) \
  99. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM1_TRGO2) \
  100. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM2_TRGO) \
  101. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM4_TRGO) \
  102. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_TIM6_TRGO) \
  103. || ((__REG_TRIG_SOURCE__) == LL_ADC_REG_TRIG_EXT_EXTI_LINE11) \
  104. )
  105. #define IS_LL_ADC_REG_CONTINUOUS_MODE(__REG_CONTINUOUS_MODE__) \
  106. ( ((__REG_CONTINUOUS_MODE__) == LL_ADC_REG_CONV_SINGLE) \
  107. || ((__REG_CONTINUOUS_MODE__) == LL_ADC_REG_CONV_CONTINUOUS) \
  108. )
  109. #define IS_LL_ADC_REG_DMA_TRANSFER(__REG_DMA_TRANSFER__) \
  110. ( ((__REG_DMA_TRANSFER__) == LL_ADC_REG_DMA_TRANSFER_NONE) \
  111. || ((__REG_DMA_TRANSFER__) == LL_ADC_REG_DMA_TRANSFER_LIMITED) \
  112. || ((__REG_DMA_TRANSFER__) == LL_ADC_REG_DMA_TRANSFER_UNLIMITED) \
  113. )
  114. #define IS_LL_ADC_REG_FLAG_EOC_SELECTION(__REG_FLAG_EOC_SELECTION__) \
  115. ( ((__REG_FLAG_EOC_SELECTION__) == LL_ADC_REG_FLAG_EOC_SEQUENCE_CONV) \
  116. || ((__REG_FLAG_EOC_SELECTION__) == LL_ADC_REG_FLAG_EOC_UNITARY_CONV) \
  117. )
  118. #define IS_LL_ADC_REG_SEQ_SCAN_LENGTH(__REG_SEQ_SCAN_LENGTH__) \
  119. ( ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_DISABLE) \
  120. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_2RANKS) \
  121. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_3RANKS) \
  122. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_4RANKS) \
  123. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_5RANKS) \
  124. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_6RANKS) \
  125. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_7RANKS) \
  126. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_8RANKS) \
  127. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_9RANKS) \
  128. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_10RANKS) \
  129. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_11RANKS) \
  130. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_12RANKS) \
  131. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_13RANKS) \
  132. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_14RANKS) \
  133. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_15RANKS) \
  134. || ((__REG_SEQ_SCAN_LENGTH__) == LL_ADC_REG_SEQ_SCAN_ENABLE_16RANKS) \
  135. )
  136. #define IS_LL_ADC_REG_SEQ_SCAN_DISCONT_MODE(__REG_SEQ_DISCONT_MODE__) \
  137. ( ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_DISABLE) \
  138. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_1RANK) \
  139. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_2RANKS) \
  140. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_3RANKS) \
  141. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_4RANKS) \
  142. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_5RANKS) \
  143. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_6RANKS) \
  144. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_7RANKS) \
  145. || ((__REG_SEQ_DISCONT_MODE__) == LL_ADC_REG_SEQ_DISCONT_8RANKS) \
  146. )
  147. /* Check of parameters for configuration of ADC hierarchical scope: */
  148. /* ADC group injected */
  149. #define IS_LL_ADC_INJ_TRIG_SOURCE(__INJ_TRIG_SOURCE__) \
  150. ( ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_SOFTWARE) \
  151. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM1_TRGO) \
  152. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM1_CH4) \
  153. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM2_TRGO) \
  154. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM2_CH1) \
  155. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM3_CH4) \
  156. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM4_TRGO) \
  157. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM8_CH4) \
  158. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM1_TRGO2) \
  159. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM8_TRGO) \
  160. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM8_TRGO2) \
  161. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM3_CH3) \
  162. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM5_TRGO) \
  163. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM3_CH1) \
  164. || ((__INJ_TRIG_SOURCE__) == LL_ADC_INJ_TRIG_EXT_TIM6_TRGO) \
  165. )
  166. #define IS_LL_ADC_INJ_TRIG_EXT_EDGE(__INJ_TRIG_EXT_EDGE__) \
  167. ( ((__INJ_TRIG_EXT_EDGE__) == LL_ADC_INJ_TRIG_EXT_RISING) \
  168. || ((__INJ_TRIG_EXT_EDGE__) == LL_ADC_INJ_TRIG_EXT_FALLING) \
  169. || ((__INJ_TRIG_EXT_EDGE__) == LL_ADC_INJ_TRIG_EXT_RISINGFALLING) \
  170. )
  171. #define IS_LL_ADC_INJ_TRIG_AUTO(__INJ_TRIG_AUTO__) \
  172. ( ((__INJ_TRIG_AUTO__) == LL_ADC_INJ_TRIG_INDEPENDENT) \
  173. || ((__INJ_TRIG_AUTO__) == LL_ADC_INJ_TRIG_FROM_GRP_REGULAR) \
  174. )
  175. #define IS_LL_ADC_INJ_SEQ_SCAN_LENGTH(__INJ_SEQ_SCAN_LENGTH__) \
  176. ( ((__INJ_SEQ_SCAN_LENGTH__) == LL_ADC_INJ_SEQ_SCAN_DISABLE) \
  177. || ((__INJ_SEQ_SCAN_LENGTH__) == LL_ADC_INJ_SEQ_SCAN_ENABLE_2RANKS) \
  178. || ((__INJ_SEQ_SCAN_LENGTH__) == LL_ADC_INJ_SEQ_SCAN_ENABLE_3RANKS) \
  179. || ((__INJ_SEQ_SCAN_LENGTH__) == LL_ADC_INJ_SEQ_SCAN_ENABLE_4RANKS) \
  180. )
  181. #define IS_LL_ADC_INJ_SEQ_SCAN_DISCONT_MODE(__INJ_SEQ_DISCONT_MODE__) \
  182. ( ((__INJ_SEQ_DISCONT_MODE__) == LL_ADC_INJ_SEQ_DISCONT_DISABLE) \
  183. || ((__INJ_SEQ_DISCONT_MODE__) == LL_ADC_INJ_SEQ_DISCONT_1RANK) \
  184. )
  185. /* Check of parameters for configuration of ADC hierarchical scope: */
  186. /* multimode. */
  187. #if defined(ADC3)
  188. #define IS_LL_ADC_MULTI_MODE(__MULTI_MODE__) \
  189. ( ((__MULTI_MODE__) == LL_ADC_MULTI_INDEPENDENT) \
  190. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIMULT) \
  191. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_INTERL) \
  192. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_INJ_SIMULT) \
  193. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_INJ_ALTERN) \
  194. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIM_INJ_SIM) \
  195. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIM_INJ_ALT) \
  196. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_INT_INJ_SIM) \
  197. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_REG_SIM_INJ_SIM) \
  198. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_REG_SIM_INJ_ALT) \
  199. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_INJ_SIMULT) \
  200. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_REG_SIMULT) \
  201. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_REG_INTERL) \
  202. || ((__MULTI_MODE__) == LL_ADC_MULTI_TRIPLE_INJ_ALTERN) \
  203. )
  204. #else
  205. #define IS_LL_ADC_MULTI_MODE(__MULTI_MODE__) \
  206. ( ((__MULTI_MODE__) == LL_ADC_MULTI_INDEPENDENT) \
  207. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIMULT) \
  208. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_INTERL) \
  209. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_INJ_SIMULT) \
  210. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_INJ_ALTERN) \
  211. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIM_INJ_SIM) \
  212. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_SIM_INJ_ALT) \
  213. || ((__MULTI_MODE__) == LL_ADC_MULTI_DUAL_REG_INT_INJ_SIM) \
  214. )
  215. #endif
  216. #define IS_LL_ADC_MULTI_DMA_TRANSFER(__MULTI_DMA_TRANSFER__) \
  217. ( ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_EACH_ADC) \
  218. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_LIMIT_1) \
  219. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_LIMIT_2) \
  220. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_LIMIT_3) \
  221. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_UNLMT_1) \
  222. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_UNLMT_2) \
  223. || ((__MULTI_DMA_TRANSFER__) == LL_ADC_MULTI_REG_DMA_UNLMT_3) \
  224. )
  225. #define IS_LL_ADC_MULTI_TWOSMP_DELAY(__MULTI_TWOSMP_DELAY__) \
  226. ( ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_5CYCLES) \
  227. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_6CYCLES) \
  228. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_7CYCLES) \
  229. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_8CYCLES) \
  230. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_9CYCLES) \
  231. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_10CYCLES) \
  232. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_11CYCLES) \
  233. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_12CYCLES) \
  234. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_13CYCLES) \
  235. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_14CYCLES) \
  236. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_15CYCLES) \
  237. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_16CYCLES) \
  238. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_17CYCLES) \
  239. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_18CYCLES) \
  240. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_19CYCLES) \
  241. || ((__MULTI_TWOSMP_DELAY__) == LL_ADC_MULTI_TWOSMP_DELAY_20CYCLES) \
  242. )
  243. #define IS_LL_ADC_MULTI_MASTER_SLAVE(__MULTI_MASTER_SLAVE__) \
  244. ( ((__MULTI_MASTER_SLAVE__) == LL_ADC_MULTI_MASTER) \
  245. || ((__MULTI_MASTER_SLAVE__) == LL_ADC_MULTI_SLAVE) \
  246. || ((__MULTI_MASTER_SLAVE__) == LL_ADC_MULTI_MASTER_SLAVE) \
  247. )
  248. /**
  249. * @}
  250. */
  251. /* Private function prototypes -----------------------------------------------*/
  252. /* Exported functions --------------------------------------------------------*/
  253. /** @addtogroup ADC_LL_Exported_Functions
  254. * @{
  255. */
  256. /** @addtogroup ADC_LL_EF_Init
  257. * @{
  258. */
  259. /**
  260. * @brief De-initialize registers of all ADC instances belonging to
  261. * the same ADC common instance to their default reset values.
  262. * @param ADCxy_COMMON ADC common instance
  263. * (can be set directly from CMSIS definition or by using helper macro @ref __LL_ADC_COMMON_INSTANCE() )
  264. * @retval An ErrorStatus enumeration value:
  265. * - SUCCESS: ADC common registers are de-initialized
  266. * - ERROR: not applicable
  267. */
  268. ErrorStatus LL_ADC_CommonDeInit(ADC_Common_TypeDef *ADCxy_COMMON)
  269. {
  270. /* Check the parameters */
  271. assert_param(IS_ADC_COMMON_INSTANCE(ADCxy_COMMON));
  272. /* Force reset of ADC clock (core clock) */
  273. LL_APB2_GRP1_ForceReset(LL_APB2_GRP1_PERIPH_ADC);
  274. /* Release reset of ADC clock (core clock) */
  275. LL_APB2_GRP1_ReleaseReset(LL_APB2_GRP1_PERIPH_ADC);
  276. return SUCCESS;
  277. }
  278. /**
  279. * @brief Initialize some features of ADC common parameters
  280. * (all ADC instances belonging to the same ADC common instance)
  281. * and multimode (for devices with several ADC instances available).
  282. * @note The setting of ADC common parameters is conditioned to
  283. * ADC instances state:
  284. * All ADC instances belonging to the same ADC common instance
  285. * must be disabled.
  286. * @param ADCxy_COMMON ADC common instance
  287. * (can be set directly from CMSIS definition or by using helper macro @ref __LL_ADC_COMMON_INSTANCE() )
  288. * @param ADC_CommonInitStruct Pointer to a @ref LL_ADC_CommonInitTypeDef structure
  289. * @retval An ErrorStatus enumeration value:
  290. * - SUCCESS: ADC common registers are initialized
  291. * - ERROR: ADC common registers are not initialized
  292. */
  293. ErrorStatus LL_ADC_CommonInit(ADC_Common_TypeDef *ADCxy_COMMON, LL_ADC_CommonInitTypeDef *ADC_CommonInitStruct)
  294. {
  295. ErrorStatus status = SUCCESS;
  296. /* Check the parameters */
  297. assert_param(IS_ADC_COMMON_INSTANCE(ADCxy_COMMON));
  298. assert_param(IS_LL_ADC_COMMON_CLOCK(ADC_CommonInitStruct->CommonClock));
  299. assert_param(IS_LL_ADC_MULTI_MODE(ADC_CommonInitStruct->Multimode));
  300. if(ADC_CommonInitStruct->Multimode != LL_ADC_MULTI_INDEPENDENT)
  301. {
  302. assert_param(IS_LL_ADC_MULTI_DMA_TRANSFER(ADC_CommonInitStruct->MultiDMATransfer));
  303. assert_param(IS_LL_ADC_MULTI_TWOSMP_DELAY(ADC_CommonInitStruct->MultiTwoSamplingDelay));
  304. }
  305. /* Note: Hardware constraint (refer to description of functions */
  306. /* "LL_ADC_SetCommonXXX()" and "LL_ADC_SetMultiXXX()"): */
  307. /* On this STM32 serie, setting of these features is conditioned to */
  308. /* ADC state: */
  309. /* All ADC instances of the ADC common group must be disabled. */
  310. if(__LL_ADC_IS_ENABLED_ALL_COMMON_INSTANCE(ADCxy_COMMON) == 0U)
  311. {
  312. /* Configuration of ADC hierarchical scope: */
  313. /* - common to several ADC */
  314. /* (all ADC instances belonging to the same ADC common instance) */
  315. /* - Set ADC clock (conversion clock) */
  316. /* - multimode (if several ADC instances available on the */
  317. /* selected device) */
  318. /* - Set ADC multimode configuration */
  319. /* - Set ADC multimode DMA transfer */
  320. /* - Set ADC multimode: delay between 2 sampling phases */
  321. if(ADC_CommonInitStruct->Multimode != LL_ADC_MULTI_INDEPENDENT)
  322. {
  323. MODIFY_REG(ADCxy_COMMON->CCR,
  324. ADC_CCR_ADCPRE
  325. | ADC_CCR_MULTI
  326. | ADC_CCR_DMA
  327. | ADC_CCR_DDS
  328. | ADC_CCR_DELAY
  329. ,
  330. ADC_CommonInitStruct->CommonClock
  331. | ADC_CommonInitStruct->Multimode
  332. | ADC_CommonInitStruct->MultiDMATransfer
  333. | ADC_CommonInitStruct->MultiTwoSamplingDelay
  334. );
  335. }
  336. else
  337. {
  338. MODIFY_REG(ADCxy_COMMON->CCR,
  339. ADC_CCR_ADCPRE
  340. | ADC_CCR_MULTI
  341. | ADC_CCR_DMA
  342. | ADC_CCR_DDS
  343. | ADC_CCR_DELAY
  344. ,
  345. ADC_CommonInitStruct->CommonClock
  346. | LL_ADC_MULTI_INDEPENDENT
  347. );
  348. }
  349. }
  350. else
  351. {
  352. /* Initialization error: One or several ADC instances belonging to */
  353. /* the same ADC common instance are not disabled. */
  354. status = ERROR;
  355. }
  356. return status;
  357. }
  358. /**
  359. * @brief Set each @ref LL_ADC_CommonInitTypeDef field to default value.
  360. * @param ADC_CommonInitStruct Pointer to a @ref LL_ADC_CommonInitTypeDef structure
  361. * whose fields will be set to default values.
  362. * @retval None
  363. */
  364. void LL_ADC_CommonStructInit(LL_ADC_CommonInitTypeDef *ADC_CommonInitStruct)
  365. {
  366. /* Set ADC_CommonInitStruct fields to default values */
  367. /* Set fields of ADC common */
  368. /* (all ADC instances belonging to the same ADC common instance) */
  369. ADC_CommonInitStruct->CommonClock = LL_ADC_CLOCK_SYNC_PCLK_DIV2;
  370. /* Set fields of ADC multimode */
  371. ADC_CommonInitStruct->Multimode = LL_ADC_MULTI_INDEPENDENT;
  372. ADC_CommonInitStruct->MultiDMATransfer = LL_ADC_MULTI_REG_DMA_EACH_ADC;
  373. ADC_CommonInitStruct->MultiTwoSamplingDelay = LL_ADC_MULTI_TWOSMP_DELAY_5CYCLES;
  374. }
  375. /**
  376. * @brief De-initialize registers of the selected ADC instance
  377. * to their default reset values.
  378. * @note To reset all ADC instances quickly (perform a hard reset),
  379. * use function @ref LL_ADC_CommonDeInit().
  380. * @param ADCx ADC instance
  381. * @retval An ErrorStatus enumeration value:
  382. * - SUCCESS: ADC registers are de-initialized
  383. * - ERROR: ADC registers are not de-initialized
  384. */
  385. ErrorStatus LL_ADC_DeInit(ADC_TypeDef *ADCx)
  386. {
  387. ErrorStatus status = SUCCESS;
  388. /* Check the parameters */
  389. assert_param(IS_ADC_ALL_INSTANCE(ADCx));
  390. /* Disable ADC instance if not already disabled. */
  391. if(LL_ADC_IsEnabled(ADCx) == 1U)
  392. {
  393. /* Set ADC group regular trigger source to SW start to ensure to not */
  394. /* have an external trigger event occurring during the conversion stop */
  395. /* ADC disable process. */
  396. LL_ADC_REG_SetTriggerSource(ADCx, LL_ADC_REG_TRIG_SOFTWARE);
  397. /* Set ADC group injected trigger source to SW start to ensure to not */
  398. /* have an external trigger event occurring during the conversion stop */
  399. /* ADC disable process. */
  400. LL_ADC_INJ_SetTriggerSource(ADCx, LL_ADC_INJ_TRIG_SOFTWARE);
  401. /* Disable the ADC instance */
  402. LL_ADC_Disable(ADCx);
  403. }
  404. /* Check whether ADC state is compliant with expected state */
  405. /* (hardware requirements of bits state to reset registers below) */
  406. if(READ_BIT(ADCx->CR2, ADC_CR2_ADON) == 0U)
  407. {
  408. /* ========== Reset ADC registers ========== */
  409. /* Reset register SR */
  410. CLEAR_BIT(ADCx->SR,
  411. ( LL_ADC_FLAG_STRT
  412. | LL_ADC_FLAG_JSTRT
  413. | LL_ADC_FLAG_EOCS
  414. | LL_ADC_FLAG_OVR
  415. | LL_ADC_FLAG_JEOS
  416. | LL_ADC_FLAG_AWD1 )
  417. );
  418. /* Reset register CR1 */
  419. CLEAR_BIT(ADCx->CR1,
  420. ( ADC_CR1_OVRIE | ADC_CR1_RES | ADC_CR1_AWDEN
  421. | ADC_CR1_JAWDEN
  422. | ADC_CR1_DISCNUM | ADC_CR1_JDISCEN | ADC_CR1_DISCEN
  423. | ADC_CR1_JAUTO | ADC_CR1_AWDSGL | ADC_CR1_SCAN
  424. | ADC_CR1_JEOCIE | ADC_CR1_AWDIE | ADC_CR1_EOCIE
  425. | ADC_CR1_AWDCH )
  426. );
  427. /* Reset register CR2 */
  428. CLEAR_BIT(ADCx->CR2,
  429. ( ADC_CR2_SWSTART | ADC_CR2_EXTEN | ADC_CR2_EXTSEL
  430. | ADC_CR2_JSWSTART | ADC_CR2_JEXTEN | ADC_CR2_JEXTSEL
  431. | ADC_CR2_ALIGN | ADC_CR2_EOCS
  432. | ADC_CR2_DDS | ADC_CR2_DMA
  433. | ADC_CR2_CONT | ADC_CR2_ADON )
  434. );
  435. /* Reset register SMPR1 */
  436. CLEAR_BIT(ADCx->SMPR1,
  437. ( ADC_SMPR1_SMP18 | ADC_SMPR1_SMP17 | ADC_SMPR1_SMP16
  438. | ADC_SMPR1_SMP15 | ADC_SMPR1_SMP14 | ADC_SMPR1_SMP13
  439. | ADC_SMPR1_SMP12 | ADC_SMPR1_SMP11 | ADC_SMPR1_SMP10)
  440. );
  441. /* Reset register SMPR2 */
  442. CLEAR_BIT(ADCx->SMPR2,
  443. ( ADC_SMPR2_SMP9
  444. | ADC_SMPR2_SMP8 | ADC_SMPR2_SMP7 | ADC_SMPR2_SMP6
  445. | ADC_SMPR2_SMP5 | ADC_SMPR2_SMP4 | ADC_SMPR2_SMP3
  446. | ADC_SMPR2_SMP2 | ADC_SMPR2_SMP1 | ADC_SMPR2_SMP0)
  447. );
  448. /* Reset register JOFR1 */
  449. CLEAR_BIT(ADCx->JOFR1, ADC_JOFR1_JOFFSET1);
  450. /* Reset register JOFR2 */
  451. CLEAR_BIT(ADCx->JOFR2, ADC_JOFR2_JOFFSET2);
  452. /* Reset register JOFR3 */
  453. CLEAR_BIT(ADCx->JOFR3, ADC_JOFR3_JOFFSET3);
  454. /* Reset register JOFR4 */
  455. CLEAR_BIT(ADCx->JOFR4, ADC_JOFR4_JOFFSET4);
  456. /* Reset register HTR */
  457. SET_BIT(ADCx->HTR, ADC_HTR_HT);
  458. /* Reset register LTR */
  459. CLEAR_BIT(ADCx->LTR, ADC_LTR_LT);
  460. /* Reset register SQR1 */
  461. CLEAR_BIT(ADCx->SQR1,
  462. ( ADC_SQR1_L
  463. | ADC_SQR1_SQ16
  464. | ADC_SQR1_SQ15 | ADC_SQR1_SQ14 | ADC_SQR1_SQ13)
  465. );
  466. /* Reset register SQR2 */
  467. CLEAR_BIT(ADCx->SQR2,
  468. ( ADC_SQR2_SQ12 | ADC_SQR2_SQ11 | ADC_SQR2_SQ10
  469. | ADC_SQR2_SQ9 | ADC_SQR2_SQ8 | ADC_SQR2_SQ7)
  470. );
  471. /* Reset register JSQR */
  472. CLEAR_BIT(ADCx->JSQR,
  473. ( ADC_JSQR_JL
  474. | ADC_JSQR_JSQ4 | ADC_JSQR_JSQ3
  475. | ADC_JSQR_JSQ2 | ADC_JSQR_JSQ1 )
  476. );
  477. /* Reset register DR */
  478. /* bits in access mode read only, no direct reset applicable */
  479. /* Reset registers JDR1, JDR2, JDR3, JDR4 */
  480. /* bits in access mode read only, no direct reset applicable */
  481. /* Reset register CCR */
  482. CLEAR_BIT(ADC->CCR, ADC_CCR_TSVREFE | ADC_CCR_ADCPRE);
  483. }
  484. return status;
  485. }
  486. /**
  487. * @brief Initialize some features of ADC instance.
  488. * @note These parameters have an impact on ADC scope: ADC instance.
  489. * Affects both group regular and group injected (availability
  490. * of ADC group injected depends on STM32 families).
  491. * Refer to corresponding unitary functions into
  492. * @ref ADC_LL_EF_Configuration_ADC_Instance .
  493. * @note The setting of these parameters by function @ref LL_ADC_Init()
  494. * is conditioned to ADC state:
  495. * ADC instance must be disabled.
  496. * This condition is applied to all ADC features, for efficiency
  497. * and compatibility over all STM32 families. However, the different
  498. * features can be set under different ADC state conditions
  499. * (setting possible with ADC enabled without conversion on going,
  500. * ADC enabled with conversion on going, ...)
  501. * Each feature can be updated afterwards with a unitary function
  502. * and potentially with ADC in a different state than disabled,
  503. * refer to description of each function for setting
  504. * conditioned to ADC state.
  505. * @note After using this function, some other features must be configured
  506. * using LL unitary functions.
  507. * The minimum configuration remaining to be done is:
  508. * - Set ADC group regular or group injected sequencer:
  509. * map channel on the selected sequencer rank.
  510. * Refer to function @ref LL_ADC_REG_SetSequencerRanks().
  511. * - Set ADC channel sampling time
  512. * Refer to function LL_ADC_SetChannelSamplingTime();
  513. * @param ADCx ADC instance
  514. * @param ADC_InitStruct Pointer to a @ref LL_ADC_REG_InitTypeDef structure
  515. * @retval An ErrorStatus enumeration value:
  516. * - SUCCESS: ADC registers are initialized
  517. * - ERROR: ADC registers are not initialized
  518. */
  519. ErrorStatus LL_ADC_Init(ADC_TypeDef *ADCx, LL_ADC_InitTypeDef *ADC_InitStruct)
  520. {
  521. ErrorStatus status = SUCCESS;
  522. /* Check the parameters */
  523. assert_param(IS_ADC_ALL_INSTANCE(ADCx));
  524. assert_param(IS_LL_ADC_RESOLUTION(ADC_InitStruct->Resolution));
  525. assert_param(IS_LL_ADC_DATA_ALIGN(ADC_InitStruct->DataAlignment));
  526. assert_param(IS_LL_ADC_SCAN_SELECTION(ADC_InitStruct->SequencersScanMode));
  527. /* Note: Hardware constraint (refer to description of this function): */
  528. /* ADC instance must be disabled. */
  529. if(LL_ADC_IsEnabled(ADCx) == 0U)
  530. {
  531. /* Configuration of ADC hierarchical scope: */
  532. /* - ADC instance */
  533. /* - Set ADC data resolution */
  534. /* - Set ADC conversion data alignment */
  535. MODIFY_REG(ADCx->CR1,
  536. ADC_CR1_RES
  537. | ADC_CR1_SCAN
  538. ,
  539. ADC_InitStruct->Resolution
  540. | ADC_InitStruct->SequencersScanMode
  541. );
  542. MODIFY_REG(ADCx->CR2,
  543. ADC_CR2_ALIGN
  544. ,
  545. ADC_InitStruct->DataAlignment
  546. );
  547. }
  548. else
  549. {
  550. /* Initialization error: ADC instance is not disabled. */
  551. status = ERROR;
  552. }
  553. return status;
  554. }
  555. /**
  556. * @brief Set each @ref LL_ADC_InitTypeDef field to default value.
  557. * @param ADC_InitStruct Pointer to a @ref LL_ADC_InitTypeDef structure
  558. * whose fields will be set to default values.
  559. * @retval None
  560. */
  561. void LL_ADC_StructInit(LL_ADC_InitTypeDef *ADC_InitStruct)
  562. {
  563. /* Set ADC_InitStruct fields to default values */
  564. /* Set fields of ADC instance */
  565. ADC_InitStruct->Resolution = LL_ADC_RESOLUTION_12B;
  566. ADC_InitStruct->DataAlignment = LL_ADC_DATA_ALIGN_RIGHT;
  567. /* Enable scan mode to have a generic behavior with ADC of other */
  568. /* STM32 families, without this setting available: */
  569. /* ADC group regular sequencer and ADC group injected sequencer depend */
  570. /* only of their own configuration. */
  571. ADC_InitStruct->SequencersScanMode = LL_ADC_SEQ_SCAN_ENABLE;
  572. }
  573. /**
  574. * @brief Initialize some features of ADC group regular.
  575. * @note These parameters have an impact on ADC scope: ADC group regular.
  576. * Refer to corresponding unitary functions into
  577. * @ref ADC_LL_EF_Configuration_ADC_Group_Regular
  578. * (functions with prefix "REG").
  579. * @note The setting of these parameters by function @ref LL_ADC_Init()
  580. * is conditioned to ADC state:
  581. * ADC instance must be disabled.
  582. * This condition is applied to all ADC features, for efficiency
  583. * and compatibility over all STM32 families. However, the different
  584. * features can be set under different ADC state conditions
  585. * (setting possible with ADC enabled without conversion on going,
  586. * ADC enabled with conversion on going, ...)
  587. * Each feature can be updated afterwards with a unitary function
  588. * and potentially with ADC in a different state than disabled,
  589. * refer to description of each function for setting
  590. * conditioned to ADC state.
  591. * @note After using this function, other features must be configured
  592. * using LL unitary functions.
  593. * The minimum configuration remaining to be done is:
  594. * - Set ADC group regular or group injected sequencer:
  595. * map channel on the selected sequencer rank.
  596. * Refer to function @ref LL_ADC_REG_SetSequencerRanks().
  597. * - Set ADC channel sampling time
  598. * Refer to function LL_ADC_SetChannelSamplingTime();
  599. * @param ADCx ADC instance
  600. * @param ADC_REG_InitStruct Pointer to a @ref LL_ADC_REG_InitTypeDef structure
  601. * @retval An ErrorStatus enumeration value:
  602. * - SUCCESS: ADC registers are initialized
  603. * - ERROR: ADC registers are not initialized
  604. */
  605. ErrorStatus LL_ADC_REG_Init(ADC_TypeDef *ADCx, LL_ADC_REG_InitTypeDef *ADC_REG_InitStruct)
  606. {
  607. ErrorStatus status = SUCCESS;
  608. /* Check the parameters */
  609. assert_param(IS_ADC_ALL_INSTANCE(ADCx));
  610. assert_param(IS_LL_ADC_REG_TRIG_SOURCE(ADC_REG_InitStruct->TriggerSource));
  611. assert_param(IS_LL_ADC_REG_SEQ_SCAN_LENGTH(ADC_REG_InitStruct->SequencerLength));
  612. if(ADC_REG_InitStruct->SequencerLength != LL_ADC_REG_SEQ_SCAN_DISABLE)
  613. {
  614. assert_param(IS_LL_ADC_REG_SEQ_SCAN_DISCONT_MODE(ADC_REG_InitStruct->SequencerDiscont));
  615. }
  616. assert_param(IS_LL_ADC_REG_CONTINUOUS_MODE(ADC_REG_InitStruct->ContinuousMode));
  617. assert_param(IS_LL_ADC_REG_DMA_TRANSFER(ADC_REG_InitStruct->DMATransfer));
  618. /* Note: Hardware constraint (refer to description of this function): */
  619. /* ADC instance must be disabled. */
  620. if(LL_ADC_IsEnabled(ADCx) == 0U)
  621. {
  622. /* Configuration of ADC hierarchical scope: */
  623. /* - ADC group regular */
  624. /* - Set ADC group regular trigger source */
  625. /* - Set ADC group regular sequencer length */
  626. /* - Set ADC group regular sequencer discontinuous mode */
  627. /* - Set ADC group regular continuous mode */
  628. /* - Set ADC group regular conversion data transfer: no transfer or */
  629. /* transfer by DMA, and DMA requests mode */
  630. /* Note: On this STM32 serie, ADC trigger edge is set when starting */
  631. /* ADC conversion. */
  632. /* Refer to function @ref LL_ADC_REG_StartConversionExtTrig(). */
  633. if(ADC_REG_InitStruct->SequencerLength != LL_ADC_REG_SEQ_SCAN_DISABLE)
  634. {
  635. MODIFY_REG(ADCx->CR1,
  636. ADC_CR1_DISCEN
  637. | ADC_CR1_DISCNUM
  638. ,
  639. ADC_REG_InitStruct->SequencerLength
  640. | ADC_REG_InitStruct->SequencerDiscont
  641. );
  642. }
  643. else
  644. {
  645. MODIFY_REG(ADCx->CR1,
  646. ADC_CR1_DISCEN
  647. | ADC_CR1_DISCNUM
  648. ,
  649. ADC_REG_InitStruct->SequencerLength
  650. | LL_ADC_REG_SEQ_DISCONT_DISABLE
  651. );
  652. }
  653. MODIFY_REG(ADCx->CR2,
  654. ADC_CR2_EXTSEL
  655. | ADC_CR2_EXTEN
  656. | ADC_CR2_CONT
  657. | ADC_CR2_DMA
  658. | ADC_CR2_DDS
  659. ,
  660. (ADC_REG_InitStruct->TriggerSource & ADC_CR2_EXTSEL)
  661. | ADC_REG_InitStruct->ContinuousMode
  662. | ADC_REG_InitStruct->DMATransfer
  663. );
  664. /* Set ADC group regular sequencer length and scan direction */
  665. /* Note: Hardware constraint (refer to description of this function): */
  666. /* Note: If ADC instance feature scan mode is disabled */
  667. /* (refer to ADC instance initialization structure */
  668. /* parameter @ref SequencersScanMode */
  669. /* or function @ref LL_ADC_SetSequencersScanMode() ), */
  670. /* this parameter is discarded. */
  671. LL_ADC_REG_SetSequencerLength(ADCx, ADC_REG_InitStruct->SequencerLength);
  672. }
  673. else
  674. {
  675. /* Initialization error: ADC instance is not disabled. */
  676. status = ERROR;
  677. }
  678. return status;
  679. }
  680. /**
  681. * @brief Set each @ref LL_ADC_REG_InitTypeDef field to default value.
  682. * @param ADC_REG_InitStruct Pointer to a @ref LL_ADC_REG_InitTypeDef structure
  683. * whose fields will be set to default values.
  684. * @retval None
  685. */
  686. void LL_ADC_REG_StructInit(LL_ADC_REG_InitTypeDef *ADC_REG_InitStruct)
  687. {
  688. /* Set ADC_REG_InitStruct fields to default values */
  689. /* Set fields of ADC group regular */
  690. /* Note: On this STM32 serie, ADC trigger edge is set when starting */
  691. /* ADC conversion. */
  692. /* Refer to function @ref LL_ADC_REG_StartConversionExtTrig(). */
  693. ADC_REG_InitStruct->TriggerSource = LL_ADC_REG_TRIG_SOFTWARE;
  694. ADC_REG_InitStruct->SequencerLength = LL_ADC_REG_SEQ_SCAN_DISABLE;
  695. ADC_REG_InitStruct->SequencerDiscont = LL_ADC_REG_SEQ_DISCONT_DISABLE;
  696. ADC_REG_InitStruct->ContinuousMode = LL_ADC_REG_CONV_SINGLE;
  697. ADC_REG_InitStruct->DMATransfer = LL_ADC_REG_DMA_TRANSFER_NONE;
  698. }
  699. /**
  700. * @brief Initialize some features of ADC group injected.
  701. * @note These parameters have an impact on ADC scope: ADC group injected.
  702. * Refer to corresponding unitary functions into
  703. * @ref ADC_LL_EF_Configuration_ADC_Group_Regular
  704. * (functions with prefix "INJ").
  705. * @note The setting of these parameters by function @ref LL_ADC_Init()
  706. * is conditioned to ADC state:
  707. * ADC instance must be disabled.
  708. * This condition is applied to all ADC features, for efficiency
  709. * and compatibility over all STM32 families. However, the different
  710. * features can be set under different ADC state conditions
  711. * (setting possible with ADC enabled without conversion on going,
  712. * ADC enabled with conversion on going, ...)
  713. * Each feature can be updated afterwards with a unitary function
  714. * and potentially with ADC in a different state than disabled,
  715. * refer to description of each function for setting
  716. * conditioned to ADC state.
  717. * @note After using this function, other features must be configured
  718. * using LL unitary functions.
  719. * The minimum configuration remaining to be done is:
  720. * - Set ADC group injected sequencer:
  721. * map channel on the selected sequencer rank.
  722. * Refer to function @ref LL_ADC_INJ_SetSequencerRanks().
  723. * - Set ADC channel sampling time
  724. * Refer to function LL_ADC_SetChannelSamplingTime();
  725. * @param ADCx ADC instance
  726. * @param ADC_INJ_InitStruct Pointer to a @ref LL_ADC_INJ_InitTypeDef structure
  727. * @retval An ErrorStatus enumeration value:
  728. * - SUCCESS: ADC registers are initialized
  729. * - ERROR: ADC registers are not initialized
  730. */
  731. ErrorStatus LL_ADC_INJ_Init(ADC_TypeDef *ADCx, LL_ADC_INJ_InitTypeDef *ADC_INJ_InitStruct)
  732. {
  733. ErrorStatus status = SUCCESS;
  734. /* Check the parameters */
  735. assert_param(IS_ADC_ALL_INSTANCE(ADCx));
  736. assert_param(IS_LL_ADC_INJ_TRIG_SOURCE(ADC_INJ_InitStruct->TriggerSource));
  737. assert_param(IS_LL_ADC_INJ_SEQ_SCAN_LENGTH(ADC_INJ_InitStruct->SequencerLength));
  738. if(ADC_INJ_InitStruct->SequencerLength != LL_ADC_INJ_SEQ_SCAN_DISABLE)
  739. {
  740. assert_param(IS_LL_ADC_INJ_SEQ_SCAN_DISCONT_MODE(ADC_INJ_InitStruct->SequencerDiscont));
  741. }
  742. assert_param(IS_LL_ADC_INJ_TRIG_AUTO(ADC_INJ_InitStruct->TrigAuto));
  743. /* Note: Hardware constraint (refer to description of this function): */
  744. /* ADC instance must be disabled. */
  745. if(LL_ADC_IsEnabled(ADCx) == 0U)
  746. {
  747. /* Configuration of ADC hierarchical scope: */
  748. /* - ADC group injected */
  749. /* - Set ADC group injected trigger source */
  750. /* - Set ADC group injected sequencer length */
  751. /* - Set ADC group injected sequencer discontinuous mode */
  752. /* - Set ADC group injected conversion trigger: independent or */
  753. /* from ADC group regular */
  754. /* Note: On this STM32 serie, ADC trigger edge is set when starting */
  755. /* ADC conversion. */
  756. /* Refer to function @ref LL_ADC_INJ_StartConversionExtTrig(). */
  757. if(ADC_INJ_InitStruct->SequencerLength != LL_ADC_REG_SEQ_SCAN_DISABLE)
  758. {
  759. MODIFY_REG(ADCx->CR1,
  760. ADC_CR1_JDISCEN
  761. | ADC_CR1_JAUTO
  762. ,
  763. ADC_INJ_InitStruct->SequencerDiscont
  764. | ADC_INJ_InitStruct->TrigAuto
  765. );
  766. }
  767. else
  768. {
  769. MODIFY_REG(ADCx->CR1,
  770. ADC_CR1_JDISCEN
  771. | ADC_CR1_JAUTO
  772. ,
  773. LL_ADC_REG_SEQ_DISCONT_DISABLE
  774. | ADC_INJ_InitStruct->TrigAuto
  775. );
  776. }
  777. MODIFY_REG(ADCx->CR2,
  778. ADC_CR2_JEXTSEL
  779. | ADC_CR2_JEXTEN
  780. ,
  781. (ADC_INJ_InitStruct->TriggerSource & ADC_CR2_JEXTSEL)
  782. );
  783. /* Note: Hardware constraint (refer to description of this function): */
  784. /* Note: If ADC instance feature scan mode is disabled */
  785. /* (refer to ADC instance initialization structure */
  786. /* parameter @ref SequencersScanMode */
  787. /* or function @ref LL_ADC_SetSequencersScanMode() ), */
  788. /* this parameter is discarded. */
  789. LL_ADC_INJ_SetSequencerLength(ADCx, ADC_INJ_InitStruct->SequencerLength);
  790. }
  791. else
  792. {
  793. /* Initialization error: ADC instance is not disabled. */
  794. status = ERROR;
  795. }
  796. return status;
  797. }
  798. /**
  799. * @brief Set each @ref LL_ADC_INJ_InitTypeDef field to default value.
  800. * @param ADC_INJ_InitStruct Pointer to a @ref LL_ADC_INJ_InitTypeDef structure
  801. * whose fields will be set to default values.
  802. * @retval None
  803. */
  804. void LL_ADC_INJ_StructInit(LL_ADC_INJ_InitTypeDef *ADC_INJ_InitStruct)
  805. {
  806. /* Set ADC_INJ_InitStruct fields to default values */
  807. /* Set fields of ADC group injected */
  808. ADC_INJ_InitStruct->TriggerSource = LL_ADC_INJ_TRIG_SOFTWARE;
  809. ADC_INJ_InitStruct->SequencerLength = LL_ADC_INJ_SEQ_SCAN_DISABLE;
  810. ADC_INJ_InitStruct->SequencerDiscont = LL_ADC_INJ_SEQ_DISCONT_DISABLE;
  811. ADC_INJ_InitStruct->TrigAuto = LL_ADC_INJ_TRIG_INDEPENDENT;
  812. }
  813. /**
  814. * @}
  815. */
  816. /**
  817. * @}
  818. */
  819. /**
  820. * @}
  821. */
  822. #endif /* ADC1 || ADC2 || ADC3 */
  823. /**
  824. * @}
  825. */
  826. #endif /* USE_FULL_LL_DRIVER */
  827. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/