Rev 2 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 2 | Rev 3 | ||
|---|---|---|---|
| Line 1... | Line 1... | ||
| 1 | /** |
1 | /** |
| 2 | ****************************************************************************** |
2 | ****************************************************************************** |
| 3 | * @file stm32f1xx_hal_adc_ex.c |
3 | * @file stm32f1xx_hal_adc_ex.c |
| 4 | * @author MCD Application Team |
4 | * @author MCD Application Team |
| 5 | * @brief This file provides firmware functions to manage the following |
5 | * @brief This file provides firmware functions to manage the following |
| 6 | * functionalities of the Analog to Digital Convertor (ADC) |
6 | * functionalities of the Analog to Digital Convertor (ADC) |
| 7 | * peripheral: |
7 | * peripheral: |
| 8 | * + Operation functions |
8 | * + Peripheral Control functions |
| 9 | * ++ Start, stop, get result of conversions of injected |
9 | * Other functions (generic functions) are available in file |
| 10 | * group, using 2 possible modes: polling, interruption. |
10 | * "stm32f1xx_hal_adc.c". |
| 11 | * ++ Multimode feature (available on devices with 2 ADCs or more) |
11 | * |
| 12 | * ++ Calibration (ADC automatic self-calibration) |
12 | ****************************************************************************** |
| 13 | * + Control functions |
13 | * @attention |
| 14 | * ++ Channels configuration on injected group |
14 | * |
| 15 | * Other functions (generic functions) are available in file |
15 | * Copyright (c) 2016 STMicroelectronics. |
| 16 | * "stm32f1xx_hal_adc.c". |
16 | * All rights reserved. |
| 17 | * |
17 | * |
| 18 | @verbatim |
18 | * This software is licensed under terms that can be found in the LICENSE file |
| 19 | [..] |
19 | * in the root directory of this software component. |
| 20 | (@) Sections "ADC peripheral features" and "How to use this driver" are |
20 | * If no LICENSE file comes with this software, it is provided AS-IS. |
| 21 | available in file of generic functions "stm32f1xx_hal_adc.c". |
21 | * |
| 22 | [..] |
22 | ****************************************************************************** |
| 23 | @endverbatim |
23 | @verbatim |
| 24 | ****************************************************************************** |
24 | [..] |
| 25 | * @attention |
25 | (@) Sections "ADC peripheral features" and "How to use this driver" are |
| 26 | * |
26 | available in file of generic functions "stm32f1xx_hal_adc.c". |
| 27 | * <h2><center>© Copyright (c) 2016 STMicroelectronics. |
27 | [..] |
| 28 | * All rights reserved.</center></h2> |
28 | @endverbatim |
| 29 | * |
29 | */ |
| 30 | * This software component is licensed by ST under BSD 3-Clause license, |
30 | |
| 31 | * the "License"; You may not use this file except in compliance with the |
31 | /* Includes ------------------------------------------------------------------*/ |
| 32 | * License. You may obtain a copy of the License at: |
32 | #include "stm32f1xx_hal.h" |
| 33 | * opensource.org/licenses/BSD-3-Clause |
33 | |
| 34 | * |
34 | /** @addtogroup STM32F1xx_HAL_Driver |
| 35 | ****************************************************************************** |
35 | * @{ |
| 36 | */ |
36 | */ |
| 37 | 37 | ||
| 38 | /* Includes ------------------------------------------------------------------*/ |
38 | /** @defgroup ADCEx ADCEx |
| 39 | #include "stm32f1xx_hal.h" |
39 | * @brief ADC Extension HAL module driver |
| 40 | 40 | * @{ |
|
| 41 | /** @addtogroup STM32F1xx_HAL_Driver |
41 | */ |
| 42 | * @{ |
42 | |
| 43 | */ |
43 | #ifdef HAL_ADC_MODULE_ENABLED |
| 44 | 44 | ||
| 45 | /** @defgroup ADCEx ADCEx |
45 | /* Private typedef -----------------------------------------------------------*/ |
| 46 | * @brief ADC Extension HAL module driver |
46 | /* Private define ------------------------------------------------------------*/ |
| 47 | * @{ |
47 | /** @defgroup ADCEx_Private_Constants ADCEx Private Constants |
| 48 | */ |
48 | * @{ |
| 49 | 49 | */ |
|
| 50 | #ifdef HAL_ADC_MODULE_ENABLED |
50 | |
| 51 | 51 | /* Delay for ADC calibration: */ |
|
| 52 | /* Private typedef -----------------------------------------------------------*/ |
52 | /* Hardware prerequisite before starting a calibration: the ADC must have */ |
| 53 | /* Private define ------------------------------------------------------------*/ |
53 | /* been in power-on state for at least two ADC clock cycles. */ |
| 54 | /** @defgroup ADCEx_Private_Constants ADCEx Private Constants |
54 | /* Unit: ADC clock cycles */ |
| 55 | * @{ |
55 | #define ADC_PRECALIBRATION_DELAY_ADCCLOCKCYCLES 2U |
| 56 | */ |
56 | |
| 57 | 57 | /* Timeout value for ADC calibration */ |
|
| 58 | /* Delay for ADC calibration: */ |
58 | /* Value defined to be higher than worst cases: low clocks freq, */ |
| 59 | /* Hardware prerequisite before starting a calibration: the ADC must have */ |
59 | /* maximum prescaler. */ |
| 60 | /* been in power-on state for at least two ADC clock cycles. */ |
60 | /* Ex of profile low frequency : Clock source at 0.1 MHz, ADC clock */ |
| 61 | /* Unit: ADC clock cycles */ |
61 | /* prescaler 4, sampling time 12.5 ADC clock cycles, resolution 12 bits. */ |
| 62 | #define ADC_PRECALIBRATION_DELAY_ADCCLOCKCYCLES 2U |
62 | /* Unit: ms */ |
| 63 | 63 | #define ADC_CALIBRATION_TIMEOUT 10U |
|
| 64 | /* Timeout value for ADC calibration */ |
64 | |
| 65 | /* Value defined to be higher than worst cases: low clocks freq, */ |
65 | /* Delay for temperature sensor stabilization time. */ |
| 66 | /* maximum prescaler. */ |
66 | /* Maximum delay is 10us (refer to device datasheet, parameter tSTART). */ |
| 67 | /* Ex of profile low frequency : Clock source at 0.1 MHz, ADC clock */ |
67 | /* Unit: us */ |
| 68 | /* prescaler 4, sampling time 12.5 ADC clock cycles, resolution 12 bits. */ |
68 | #define ADC_TEMPSENSOR_DELAY_US 10U |
| 69 | /* Unit: ms */ |
69 | |
| 70 | #define ADC_CALIBRATION_TIMEOUT 10U |
70 | /** |
| 71 | 71 | * @} |
|
| 72 | /* Delay for temperature sensor stabilization time. */ |
72 | */ |
| 73 | /* Maximum delay is 10us (refer to device datasheet, parameter tSTART). */ |
73 | |
| 74 | /* Unit: us */ |
74 | /* Private macro -------------------------------------------------------------*/ |
| 75 | #define ADC_TEMPSENSOR_DELAY_US 10U |
75 | /* Private variables ---------------------------------------------------------*/ |
| 76 | 76 | /* Private function prototypes -----------------------------------------------*/ |
|
| 77 | /** |
77 | /* Private functions ---------------------------------------------------------*/ |
| 78 | * @} |
78 | |
| 79 | */ |
79 | /** @defgroup ADCEx_Exported_Functions ADCEx Exported Functions |
| 80 | 80 | * @{ |
|
| 81 | /* Private macro -------------------------------------------------------------*/ |
81 | */ |
| 82 | /* Private variables ---------------------------------------------------------*/ |
82 | |
| 83 | /* Private function prototypes -----------------------------------------------*/ |
83 | /** @defgroup ADCEx_Exported_Functions_Group1 Extended Extended IO operation functions |
| 84 | /* Private functions ---------------------------------------------------------*/ |
84 | * @brief Extended Extended Input and Output operation functions |
| 85 | 85 | * |
|
| 86 | /** @defgroup ADCEx_Exported_Functions ADCEx Exported Functions |
86 | @verbatim |
| 87 | * @{ |
87 | =============================================================================== |
| 88 | */ |
88 | ##### IO operation functions ##### |
| 89 | 89 | =============================================================================== |
|
| 90 | /** @defgroup ADCEx_Exported_Functions_Group1 Extended Extended IO operation functions |
90 | [..] This section provides functions allowing to: |
| 91 | * @brief Extended Extended Input and Output operation functions |
91 | (+) Start conversion of injected group. |
| 92 | * |
92 | (+) Stop conversion of injected group. |
| 93 | @verbatim |
93 | (+) Poll for conversion complete on injected group. |
| 94 | =============================================================================== |
94 | (+) Get result of injected channel conversion. |
| 95 | ##### IO operation functions ##### |
95 | (+) Start conversion of injected group and enable interruptions. |
| 96 | =============================================================================== |
96 | (+) Stop conversion of injected group and disable interruptions. |
| 97 | [..] This section provides functions allowing to: |
97 | |
| 98 | (+) Start conversion of injected group. |
98 | (+) Start multimode and enable DMA transfer. |
| 99 | (+) Stop conversion of injected group. |
99 | (+) Stop multimode and disable ADC DMA transfer. |
| 100 | (+) Poll for conversion complete on injected group. |
100 | (+) Get result of multimode conversion. |
| 101 | (+) Get result of injected channel conversion. |
101 | |
| 102 | (+) Start conversion of injected group and enable interruptions. |
102 | (+) Perform the ADC self-calibration for single or differential ending. |
| 103 | (+) Stop conversion of injected group and disable interruptions. |
103 | (+) Get calibration factors for single or differential ending. |
| 104 | 104 | (+) Set calibration factors for single or differential ending. |
|
| 105 | (+) Start multimode and enable DMA transfer. |
105 | |
| 106 | (+) Stop multimode and disable ADC DMA transfer. |
106 | @endverbatim |
| 107 | (+) Get result of multimode conversion. |
107 | * @{ |
| 108 | 108 | */ |
|
| 109 | (+) Perform the ADC self-calibration for single or differential ending. |
109 | |
| 110 | (+) Get calibration factors for single or differential ending. |
110 | /** |
| 111 | (+) Set calibration factors for single or differential ending. |
111 | * @brief Perform an ADC automatic self-calibration |
| 112 | |
112 | * Calibration prerequisite: ADC must be disabled (execute this |
| 113 | @endverbatim |
113 | * function before HAL_ADC_Start() or after HAL_ADC_Stop() ). |
| 114 | * @{ |
114 | * During calibration process, ADC is enabled. ADC is let enabled at |
| 115 | */ |
115 | * the completion of this function. |
| 116 | 116 | * @param hadc: ADC handle |
|
| 117 | /** |
117 | * @retval HAL status |
| 118 | * @brief Perform an ADC automatic self-calibration |
118 | */ |
| 119 | * Calibration prerequisite: ADC must be disabled (execute this |
119 | HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc) |
| 120 | * function before HAL_ADC_Start() or after HAL_ADC_Stop() ). |
120 | { |
| 121 | * During calibration process, ADC is enabled. ADC is let enabled at |
121 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 122 | * the completion of this function. |
122 | uint32_t tickstart; |
| 123 | * @param hadc: ADC handle |
123 | __IO uint32_t wait_loop_index = 0U; |
| 124 | * @retval HAL status |
124 | |
| 125 | */ |
125 | /* Check the parameters */ |
| 126 | HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc) |
126 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 127 | { |
127 | |
| 128 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
128 | /* Process locked */ |
| 129 | uint32_t tickstart; |
129 | __HAL_LOCK(hadc); |
| 130 | __IO uint32_t wait_loop_index = 0U; |
130 | |
| 131 | 131 | /* 1. Disable ADC peripheral */ |
|
| 132 | /* Check the parameters */ |
132 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 133 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
133 | |
| 134 | 134 | /* 2. Calibration prerequisite delay before starting the calibration. */ |
|
| 135 | /* Process locked */ |
135 | /* - ADC must be enabled for at least two ADC clock cycles */ |
| 136 | __HAL_LOCK(hadc); |
136 | tmp_hal_status = ADC_Enable(hadc); |
| 137 | 137 | ||
| 138 | /* 1. Calibration prerequisite: */ |
138 | /* Check if ADC is effectively enabled */ |
| 139 | /* - ADC must be disabled for at least two ADC clock cycles in disable */ |
139 | if (tmp_hal_status == HAL_OK) |
| 140 | /* mode before ADC enable */ |
140 | { |
| 141 | /* Stop potential conversion on going, on regular and injected groups */ |
141 | /* Set ADC state */ |
| 142 | /* Disable ADC peripheral */ |
142 | ADC_STATE_CLR_SET(hadc->State, |
| 143 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
143 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
| 144 | 144 | HAL_ADC_STATE_BUSY_INTERNAL); |
|
| 145 | /* Check if ADC is effectively disabled */ |
145 | |
| 146 | if (tmp_hal_status == HAL_OK) |
146 | /* Hardware prerequisite: delay before starting the calibration. */ |
| 147 | { |
147 | /* - Computation of CPU clock cycles corresponding to ADC clock cycles. */ |
| 148 | /* Set ADC state */ |
148 | /* - Wait for the expected ADC clock cycles delay */ |
| 149 | ADC_STATE_CLR_SET(hadc->State, |
149 | wait_loop_index = ((SystemCoreClock |
| 150 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
150 | / HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_ADC)) |
| 151 | HAL_ADC_STATE_BUSY_INTERNAL); |
151 | * ADC_PRECALIBRATION_DELAY_ADCCLOCKCYCLES ); |
| 152 | 152 | ||
| 153 | /* Hardware prerequisite: delay before starting the calibration. */ |
153 | while(wait_loop_index != 0U) |
| 154 | /* - Computation of CPU clock cycles corresponding to ADC clock cycles. */ |
154 | { |
| 155 | /* - Wait for the expected ADC clock cycles delay */ |
155 | wait_loop_index--; |
| 156 | wait_loop_index = ((SystemCoreClock |
156 | } |
| 157 | / HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_ADC)) |
157 | |
| 158 | * ADC_PRECALIBRATION_DELAY_ADCCLOCKCYCLES ); |
158 | /* 3. Resets ADC calibration registers */ |
| 159 | 159 | SET_BIT(hadc->Instance->CR2, ADC_CR2_RSTCAL); |
|
| 160 | while(wait_loop_index != 0U) |
160 | |
| 161 | { |
161 | tickstart = HAL_GetTick(); |
| 162 | wait_loop_index--; |
162 | |
| 163 | } |
163 | /* Wait for calibration reset completion */ |
| 164 | 164 | while(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_RSTCAL)) |
|
| 165 | /* 2. Enable the ADC peripheral */ |
165 | { |
| 166 | ADC_Enable(hadc); |
166 | if((HAL_GetTick() - tickstart) > ADC_CALIBRATION_TIMEOUT) |
| 167 | 167 | { |
|
| 168 | /* 3. Resets ADC calibration registers */ |
168 | /* New check to avoid false timeout detection in case of preemption */ |
| 169 | SET_BIT(hadc->Instance->CR2, ADC_CR2_RSTCAL); |
169 | if(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_RSTCAL)) |
| 170 | 170 | { |
|
| 171 | tickstart = HAL_GetTick(); |
171 | /* Update ADC state machine to error */ |
| 172 | 172 | ADC_STATE_CLR_SET(hadc->State, |
|
| 173 | /* Wait for calibration reset completion */ |
173 | HAL_ADC_STATE_BUSY_INTERNAL, |
| 174 | while(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_RSTCAL)) |
174 | HAL_ADC_STATE_ERROR_INTERNAL); |
| 175 | { |
175 | |
| 176 | if((HAL_GetTick() - tickstart) > ADC_CALIBRATION_TIMEOUT) |
176 | /* Process unlocked */ |
| 177 | { |
177 | __HAL_UNLOCK(hadc); |
| 178 | /* New check to avoid false timeout detection in case of preemption */ |
178 | |
| 179 | if(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_RSTCAL)) |
179 | return HAL_ERROR; |
| 180 | { |
180 | } |
| 181 | /* Update ADC state machine to error */ |
181 | } |
| 182 | ADC_STATE_CLR_SET(hadc->State, |
182 | } |
| 183 | HAL_ADC_STATE_BUSY_INTERNAL, |
183 | |
| 184 | HAL_ADC_STATE_ERROR_INTERNAL); |
184 | /* 4. Start ADC calibration */ |
| 185 | 185 | SET_BIT(hadc->Instance->CR2, ADC_CR2_CAL); |
|
| 186 | /* Process unlocked */ |
186 | |
| 187 | __HAL_UNLOCK(hadc); |
187 | tickstart = HAL_GetTick(); |
| 188 | 188 | ||
| 189 | return HAL_ERROR; |
189 | /* Wait for calibration completion */ |
| 190 | } |
190 | while(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_CAL)) |
| 191 | } |
191 | { |
| 192 | } |
192 | if((HAL_GetTick() - tickstart) > ADC_CALIBRATION_TIMEOUT) |
| 193 | 193 | { |
|
| 194 | /* 4. Start ADC calibration */ |
194 | /* New check to avoid false timeout detection in case of preemption */ |
| 195 | SET_BIT(hadc->Instance->CR2, ADC_CR2_CAL); |
195 | if(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_CAL)) |
| 196 | 196 | { |
|
| 197 | tickstart = HAL_GetTick(); |
197 | /* Update ADC state machine to error */ |
| 198 | 198 | ADC_STATE_CLR_SET(hadc->State, |
|
| 199 | /* Wait for calibration completion */ |
199 | HAL_ADC_STATE_BUSY_INTERNAL, |
| 200 | while(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_CAL)) |
200 | HAL_ADC_STATE_ERROR_INTERNAL); |
| 201 | { |
201 | |
| 202 | if((HAL_GetTick() - tickstart) > ADC_CALIBRATION_TIMEOUT) |
202 | /* Process unlocked */ |
| 203 | { |
203 | __HAL_UNLOCK(hadc); |
| 204 | /* New check to avoid false timeout detection in case of preemption */ |
204 | |
| 205 | if(HAL_IS_BIT_SET(hadc->Instance->CR2, ADC_CR2_CAL)) |
205 | return HAL_ERROR; |
| 206 | { |
206 | } |
| 207 | /* Update ADC state machine to error */ |
207 | } |
| 208 | ADC_STATE_CLR_SET(hadc->State, |
208 | } |
| 209 | HAL_ADC_STATE_BUSY_INTERNAL, |
209 | |
| 210 | HAL_ADC_STATE_ERROR_INTERNAL); |
210 | /* Set ADC state */ |
| 211 | 211 | ADC_STATE_CLR_SET(hadc->State, |
|
| 212 | /* Process unlocked */ |
212 | HAL_ADC_STATE_BUSY_INTERNAL, |
| 213 | __HAL_UNLOCK(hadc); |
213 | HAL_ADC_STATE_READY); |
| 214 | 214 | } |
|
| 215 | return HAL_ERROR; |
215 | |
| 216 | } |
216 | /* Process unlocked */ |
| 217 | } |
217 | __HAL_UNLOCK(hadc); |
| 218 | } |
218 | |
| 219 | 219 | /* Return function status */ |
|
| 220 | /* Set ADC state */ |
220 | return tmp_hal_status; |
| 221 | ADC_STATE_CLR_SET(hadc->State, |
221 | } |
| 222 | HAL_ADC_STATE_BUSY_INTERNAL, |
222 | |
| 223 | HAL_ADC_STATE_READY); |
223 | /** |
| 224 | } |
224 | * @brief Enables ADC, starts conversion of injected group. |
| 225 | 225 | * Interruptions enabled in this function: None. |
|
| 226 | /* Process unlocked */ |
226 | * @param hadc: ADC handle |
| 227 | __HAL_UNLOCK(hadc); |
227 | * @retval HAL status |
| 228 | 228 | */ |
|
| 229 | /* Return function status */ |
229 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc) |
| 230 | return tmp_hal_status; |
230 | { |
| 231 | } |
231 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 232 | 232 | ||
| 233 | /** |
233 | /* Check the parameters */ |
| 234 | * @brief Enables ADC, starts conversion of injected group. |
234 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 235 | * Interruptions enabled in this function: None. |
235 | |
| 236 | * @param hadc: ADC handle |
236 | /* Process locked */ |
| 237 | * @retval HAL status |
237 | __HAL_LOCK(hadc); |
| 238 | */ |
238 | |
| 239 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc) |
239 | /* Enable the ADC peripheral */ |
| 240 | { |
240 | tmp_hal_status = ADC_Enable(hadc); |
| 241 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
241 | |
| 242 | 242 | /* Start conversion if ADC is effectively enabled */ |
|
| 243 | /* Check the parameters */ |
243 | if (tmp_hal_status == HAL_OK) |
| 244 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
244 | { |
| 245 | 245 | /* Set ADC state */ |
|
| 246 | /* Process locked */ |
246 | /* - Clear state bitfield related to injected group conversion results */ |
| 247 | __HAL_LOCK(hadc); |
247 | /* - Set state bitfield related to injected operation */ |
| 248 | 248 | ADC_STATE_CLR_SET(hadc->State, |
|
| 249 | /* Enable the ADC peripheral */ |
249 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
| 250 | tmp_hal_status = ADC_Enable(hadc); |
250 | HAL_ADC_STATE_INJ_BUSY); |
| 251 | 251 | ||
| 252 | /* Start conversion if ADC is effectively enabled */ |
252 | /* Case of independent mode or multimode (for devices with several ADCs): */ |
| 253 | if (tmp_hal_status == HAL_OK) |
253 | /* Set multimode state. */ |
| 254 | { |
254 | if (ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc)) |
| 255 | /* Set ADC state */ |
255 | { |
| 256 | /* - Clear state bitfield related to injected group conversion results */ |
256 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
| 257 | /* - Set state bitfield related to injected operation */ |
257 | } |
| 258 | ADC_STATE_CLR_SET(hadc->State, |
258 | else |
| 259 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
259 | { |
| 260 | HAL_ADC_STATE_INJ_BUSY); |
260 | SET_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
| 261 | 261 | } |
|
| 262 | /* Case of independent mode or multimode (for devices with several ADCs): */ |
262 | |
| 263 | /* Set multimode state. */ |
263 | /* Check if a regular conversion is ongoing */ |
| 264 | if (ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc)) |
264 | /* Note: On this device, there is no ADC error code fields related to */ |
| 265 | { |
265 | /* conversions on group injected only. In case of conversion on */ |
| 266 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
266 | /* going on group regular, no error code is reset. */ |
| 267 | } |
267 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
| 268 | else |
268 | { |
| 269 | { |
269 | /* Reset ADC all error code fields */ |
| 270 | SET_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
270 | ADC_CLEAR_ERRORCODE(hadc); |
| 271 | } |
271 | } |
| 272 | 272 | ||
| 273 | /* Check if a regular conversion is ongoing */ |
273 | /* Process unlocked */ |
| 274 | /* Note: On this device, there is no ADC error code fields related to */ |
274 | /* Unlock before starting ADC conversions: in case of potential */ |
| 275 | /* conversions on group injected only. In case of conversion on */ |
275 | /* interruption, to let the process to ADC IRQ Handler. */ |
| 276 | /* going on group regular, no error code is reset. */ |
276 | __HAL_UNLOCK(hadc); |
| 277 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
277 | |
| 278 | { |
278 | /* Clear injected group conversion flag */ |
| 279 | /* Reset ADC all error code fields */ |
279 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
| 280 | ADC_CLEAR_ERRORCODE(hadc); |
280 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
| 281 | } |
281 | |
| 282 | 282 | /* Enable conversion of injected group. */ |
|
| 283 | /* Process unlocked */ |
283 | /* If software start has been selected, conversion starts immediately. */ |
| 284 | /* Unlock before starting ADC conversions: in case of potential */ |
284 | /* If external trigger has been selected, conversion will start at next */ |
| 285 | /* interruption, to let the process to ADC IRQ Handler. */ |
285 | /* trigger event. */ |
| 286 | __HAL_UNLOCK(hadc); |
286 | /* If automatic injected conversion is enabled, conversion will start */ |
| 287 | 287 | /* after next regular group conversion. */ |
|
| 288 | /* Clear injected group conversion flag */ |
288 | /* Case of multimode enabled (for devices with several ADCs): if ADC is */ |
| 289 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
289 | /* slave, ADC is enabled only (conversion is not started). If ADC is */ |
| 290 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
290 | /* master, ADC is enabled and conversion is started. */ |
| 291 | 291 | if (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO)) |
|
| 292 | /* Enable conversion of injected group. */ |
292 | { |
| 293 | /* If software start has been selected, conversion starts immediately. */ |
293 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
| 294 | /* If external trigger has been selected, conversion will start at next */ |
294 | ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc) ) |
| 295 | /* trigger event. */ |
295 | { |
| 296 | /* If automatic injected conversion is enabled, conversion will start */ |
296 | /* Start ADC conversion on injected group with SW start */ |
| 297 | /* after next regular group conversion. */ |
297 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_JSWSTART | ADC_CR2_JEXTTRIG)); |
| 298 | /* Case of multimode enabled (for devices with several ADCs): if ADC is */ |
298 | } |
| 299 | /* slave, ADC is enabled only (conversion is not started). If ADC is */ |
299 | else |
| 300 | /* master, ADC is enabled and conversion is started. */ |
300 | { |
| 301 | if (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO)) |
301 | /* Start ADC conversion on injected group with external trigger */ |
| 302 | { |
302 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JEXTTRIG); |
| 303 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
303 | } |
| 304 | ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc) ) |
304 | } |
| 305 | { |
305 | } |
| 306 | /* Start ADC conversion on injected group with SW start */ |
306 | else |
| 307 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_JSWSTART | ADC_CR2_JEXTTRIG)); |
307 | { |
| 308 | } |
308 | /* Process unlocked */ |
| 309 | else |
309 | __HAL_UNLOCK(hadc); |
| 310 | { |
310 | } |
| 311 | /* Start ADC conversion on injected group with external trigger */ |
311 | |
| 312 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JEXTTRIG); |
312 | /* Return function status */ |
| 313 | } |
313 | return tmp_hal_status; |
| 314 | } |
314 | } |
| 315 | } |
315 | |
| 316 | else |
316 | /** |
| 317 | { |
317 | * @brief Stop conversion of injected channels. Disable ADC peripheral if |
| 318 | /* Process unlocked */ |
318 | * no regular conversion is on going. |
| 319 | __HAL_UNLOCK(hadc); |
319 | * @note If ADC must be disabled and if conversion is on going on |
| 320 | } |
320 | * regular group, function HAL_ADC_Stop must be used to stop both |
| 321 | 321 | * injected and regular groups, and disable the ADC. |
|
| 322 | /* Return function status */ |
322 | * @note If injected group mode auto-injection is enabled, |
| 323 | return tmp_hal_status; |
323 | * function HAL_ADC_Stop must be used. |
| 324 | } |
324 | * @note In case of auto-injection mode, HAL_ADC_Stop must be used. |
| 325 | 325 | * @param hadc: ADC handle |
|
| 326 | /** |
326 | * @retval None |
| 327 | * @brief Stop conversion of injected channels. Disable ADC peripheral if |
327 | */ |
| 328 | * no regular conversion is on going. |
328 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc) |
| 329 | * @note If ADC must be disabled and if conversion is on going on |
329 | { |
| 330 | * regular group, function HAL_ADC_Stop must be used to stop both |
330 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 331 | * injected and regular groups, and disable the ADC. |
331 | |
| 332 | * @note If injected group mode auto-injection is enabled, |
332 | /* Check the parameters */ |
| 333 | * function HAL_ADC_Stop must be used. |
333 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 334 | * @note In case of auto-injection mode, HAL_ADC_Stop must be used. |
334 | |
| 335 | * @param hadc: ADC handle |
335 | /* Process locked */ |
| 336 | * @retval None |
336 | __HAL_LOCK(hadc); |
| 337 | */ |
337 | |
| 338 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc) |
338 | /* Stop potential conversion and disable ADC peripheral */ |
| 339 | { |
339 | /* Conditioned to: */ |
| 340 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
340 | /* - No conversion on the other group (regular group) is intended to */ |
| 341 | 341 | /* continue (injected and regular groups stop conversion and ADC disable */ |
|
| 342 | /* Check the parameters */ |
342 | /* are common) */ |
| 343 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
343 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
| 344 | 344 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
|
| 345 | /* Process locked */ |
345 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 346 | __HAL_LOCK(hadc); |
346 | { |
| 347 | 347 | /* Stop potential conversion on going, on regular and injected groups */ |
|
| 348 | /* Stop potential conversion and disable ADC peripheral */ |
348 | /* Disable ADC peripheral */ |
| 349 | /* Conditioned to: */ |
349 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 350 | /* - No conversion on the other group (regular group) is intended to */ |
350 | |
| 351 | /* continue (injected and regular groups stop conversion and ADC disable */ |
351 | /* Check if ADC is effectively disabled */ |
| 352 | /* are common) */ |
352 | if (tmp_hal_status == HAL_OK) |
| 353 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
353 | { |
| 354 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
354 | /* Set ADC state */ |
| 355 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
355 | ADC_STATE_CLR_SET(hadc->State, |
| 356 | { |
356 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
| 357 | /* Stop potential conversion on going, on regular and injected groups */ |
357 | HAL_ADC_STATE_READY); |
| 358 | /* Disable ADC peripheral */ |
358 | } |
| 359 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
359 | } |
| 360 | 360 | else |
|
| 361 | /* Check if ADC is effectively disabled */ |
361 | { |
| 362 | if (tmp_hal_status == HAL_OK) |
362 | /* Update ADC state machine to error */ |
| 363 | { |
363 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 364 | /* Set ADC state */ |
364 | |
| 365 | ADC_STATE_CLR_SET(hadc->State, |
365 | tmp_hal_status = HAL_ERROR; |
| 366 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
366 | } |
| 367 | HAL_ADC_STATE_READY); |
367 | |
| 368 | } |
368 | /* Process unlocked */ |
| 369 | } |
369 | __HAL_UNLOCK(hadc); |
| 370 | else |
370 | |
| 371 | { |
371 | /* Return function status */ |
| 372 | /* Update ADC state machine to error */ |
372 | return tmp_hal_status; |
| 373 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
373 | } |
| 374 | 374 | ||
| 375 | tmp_hal_status = HAL_ERROR; |
375 | /** |
| 376 | } |
376 | * @brief Wait for injected group conversion to be completed. |
| 377 | 377 | * @param hadc: ADC handle |
|
| 378 | /* Process unlocked */ |
378 | * @param Timeout: Timeout value in millisecond. |
| 379 | __HAL_UNLOCK(hadc); |
379 | * @retval HAL status |
| 380 | 380 | */ |
|
| 381 | /* Return function status */ |
381 | HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout) |
| 382 | return tmp_hal_status; |
382 | { |
| 383 | } |
383 | uint32_t tickstart; |
| 384 | 384 | ||
| 385 | /** |
385 | /* Variables for polling in case of scan mode enabled and polling for each */ |
| 386 | * @brief Wait for injected group conversion to be completed. |
386 | /* conversion. */ |
| 387 | * @param hadc: ADC handle |
387 | __IO uint32_t Conversion_Timeout_CPU_cycles = 0U; |
| 388 | * @param Timeout: Timeout value in millisecond. |
388 | uint32_t Conversion_Timeout_CPU_cycles_max = 0U; |
| 389 | * @retval HAL status |
389 | |
| 390 | */ |
390 | /* Check the parameters */ |
| 391 | HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout) |
391 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 392 | { |
392 | |
| 393 | uint32_t tickstart; |
393 | /* Get timeout */ |
| 394 | 394 | tickstart = HAL_GetTick(); |
|
| 395 | /* Variables for polling in case of scan mode enabled and polling for each */ |
395 | |
| 396 | /* conversion. */ |
396 | /* Polling for end of conversion: differentiation if single/sequence */ |
| 397 | __IO uint32_t Conversion_Timeout_CPU_cycles = 0U; |
397 | /* conversion. */ |
| 398 | uint32_t Conversion_Timeout_CPU_cycles_max = 0U; |
398 | /* For injected group, flag JEOC is set only at the end of the sequence, */ |
| 399 | 399 | /* not for each conversion within the sequence. */ |
|
| 400 | /* Check the parameters */ |
400 | /* - If single conversion for injected group (scan mode disabled or */ |
| 401 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
401 | /* InjectedNbrOfConversion ==1), flag JEOC is used to determine the */ |
| 402 | 402 | /* conversion completion. */ |
|
| 403 | /* Get timeout */ |
403 | /* - If sequence conversion for injected group (scan mode enabled and */ |
| 404 | tickstart = HAL_GetTick(); |
404 | /* InjectedNbrOfConversion >=2), flag JEOC is set only at the end of the */ |
| 405 | 405 | /* sequence. */ |
|
| 406 | /* Polling for end of conversion: differentiation if single/sequence */ |
406 | /* To poll for each conversion, the maximum conversion time is computed */ |
| 407 | /* conversion. */ |
407 | /* from ADC conversion time (selected sampling time + conversion time of */ |
| 408 | /* For injected group, flag JEOC is set only at the end of the sequence, */ |
408 | /* 12.5 ADC clock cycles) and APB2/ADC clock prescalers (depending on */ |
| 409 | /* not for each conversion within the sequence. */ |
409 | /* settings, conversion time range can be from 28 to 32256 CPU cycles). */ |
| 410 | /* - If single conversion for injected group (scan mode disabled or */ |
410 | /* As flag JEOC is not set after each conversion, no timeout status can */ |
| 411 | /* InjectedNbrOfConversion ==1), flag JEOC is used to determine the */ |
411 | /* be set. */ |
| 412 | /* conversion completion. */ |
412 | if ((hadc->Instance->JSQR & ADC_JSQR_JL) == RESET) |
| 413 | /* - If sequence conversion for injected group (scan mode enabled and */ |
413 | { |
| 414 | /* InjectedNbrOfConversion >=2), flag JEOC is set only at the end of the */ |
414 | /* Wait until End of Conversion flag is raised */ |
| 415 | /* sequence. */ |
415 | while(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
| 416 | /* To poll for each conversion, the maximum conversion time is computed */ |
416 | { |
| 417 | /* from ADC conversion time (selected sampling time + conversion time of */ |
417 | /* Check if timeout is disabled (set to infinite wait) */ |
| 418 | /* 12.5 ADC clock cycles) and APB2/ADC clock prescalers (depending on */ |
418 | if(Timeout != HAL_MAX_DELAY) |
| 419 | /* settings, conversion time range can be from 28 to 32256 CPU cycles). */ |
419 | { |
| 420 | /* As flag JEOC is not set after each conversion, no timeout status can */ |
420 | if((Timeout == 0U) || ((HAL_GetTick() - tickstart ) > Timeout)) |
| 421 | /* be set. */ |
421 | { |
| 422 | if ((hadc->Instance->JSQR & ADC_JSQR_JL) == RESET) |
422 | /* New check to avoid false timeout detection in case of preemption */ |
| 423 | { |
423 | if(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
| 424 | /* Wait until End of Conversion flag is raised */ |
424 | { |
| 425 | while(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
425 | /* Update ADC state machine to timeout */ |
| 426 | { |
426 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
| 427 | /* Check if timeout is disabled (set to infinite wait) */ |
427 | |
| 428 | if(Timeout != HAL_MAX_DELAY) |
428 | /* Process unlocked */ |
| 429 | { |
429 | __HAL_UNLOCK(hadc); |
| 430 | if((Timeout == 0U) || ((HAL_GetTick() - tickstart ) > Timeout)) |
430 | |
| 431 | { |
431 | return HAL_TIMEOUT; |
| 432 | /* New check to avoid false timeout detection in case of preemption */ |
432 | } |
| 433 | if(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
433 | } |
| 434 | { |
434 | } |
| 435 | /* Update ADC state machine to timeout */ |
435 | } |
| 436 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
436 | } |
| 437 | 437 | else |
|
| 438 | /* Process unlocked */ |
438 | { |
| 439 | __HAL_UNLOCK(hadc); |
439 | /* Replace polling by wait for maximum conversion time */ |
| 440 | 440 | /* - Computation of CPU clock cycles corresponding to ADC clock cycles */ |
|
| 441 | return HAL_TIMEOUT; |
441 | /* and ADC maximum conversion cycles on all channels. */ |
| 442 | } |
442 | /* - Wait for the expected ADC clock cycles delay */ |
| 443 | } |
443 | Conversion_Timeout_CPU_cycles_max = ((SystemCoreClock |
| 444 | } |
444 | / HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_ADC)) |
| 445 | } |
445 | * ADC_CONVCYCLES_MAX_RANGE(hadc) ); |
| 446 | } |
446 | |
| 447 | else |
447 | while(Conversion_Timeout_CPU_cycles < Conversion_Timeout_CPU_cycles_max) |
| 448 | { |
448 | { |
| 449 | /* Replace polling by wait for maximum conversion time */ |
449 | /* Check if timeout is disabled (set to infinite wait) */ |
| 450 | /* - Computation of CPU clock cycles corresponding to ADC clock cycles */ |
450 | if(Timeout != HAL_MAX_DELAY) |
| 451 | /* and ADC maximum conversion cycles on all channels. */ |
451 | { |
| 452 | /* - Wait for the expected ADC clock cycles delay */ |
452 | if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout)) |
| 453 | Conversion_Timeout_CPU_cycles_max = ((SystemCoreClock |
453 | { |
| 454 | / HAL_RCCEx_GetPeriphCLKFreq(RCC_PERIPHCLK_ADC)) |
454 | /* New check to avoid false timeout detection in case of preemption */ |
| 455 | * ADC_CONVCYCLES_MAX_RANGE(hadc) ); |
455 | if(Conversion_Timeout_CPU_cycles < Conversion_Timeout_CPU_cycles_max) |
| 456 | 456 | { |
|
| 457 | while(Conversion_Timeout_CPU_cycles < Conversion_Timeout_CPU_cycles_max) |
457 | /* Update ADC state machine to timeout */ |
| 458 | { |
458 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
| 459 | /* Check if timeout is disabled (set to infinite wait) */ |
459 | |
| 460 | if(Timeout != HAL_MAX_DELAY) |
460 | /* Process unlocked */ |
| 461 | { |
461 | __HAL_UNLOCK(hadc); |
| 462 | if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout)) |
462 | |
| 463 | { |
463 | return HAL_TIMEOUT; |
| 464 | /* New check to avoid false timeout detection in case of preemption */ |
464 | } |
| 465 | if(Conversion_Timeout_CPU_cycles < Conversion_Timeout_CPU_cycles_max) |
465 | } |
| 466 | { |
466 | } |
| 467 | /* Update ADC state machine to timeout */ |
467 | Conversion_Timeout_CPU_cycles ++; |
| 468 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
468 | } |
| 469 | 469 | } |
|
| 470 | /* Process unlocked */ |
470 | |
| 471 | __HAL_UNLOCK(hadc); |
471 | /* Clear injected group conversion flag */ |
| 472 | 472 | /* Note: On STM32F1 ADC, clear regular conversion flag raised */ |
|
| 473 | return HAL_TIMEOUT; |
473 | /* simultaneously. */ |
| 474 | } |
474 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JSTRT | ADC_FLAG_JEOC | ADC_FLAG_EOC); |
| 475 | } |
475 | |
| 476 | } |
476 | /* Update ADC state machine */ |
| 477 | Conversion_Timeout_CPU_cycles ++; |
477 | SET_BIT(hadc->State, HAL_ADC_STATE_INJ_EOC); |
| 478 | } |
478 | |
| 479 | } |
479 | /* Determine whether any further conversion upcoming on group injected */ |
| 480 | 480 | /* by external trigger or by automatic injected conversion */ |
|
| 481 | /* Clear injected group conversion flag */ |
481 | /* from group regular. */ |
| 482 | /* Note: On STM32F1 ADC, clear regular conversion flag raised */ |
482 | if(ADC_IS_SOFTWARE_START_INJECTED(hadc) || |
| 483 | /* simultaneously. */ |
483 | (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) && |
| 484 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JSTRT | ADC_FLAG_JEOC | ADC_FLAG_EOC); |
484 | (ADC_IS_SOFTWARE_START_REGULAR(hadc) && |
| 485 | 485 | (hadc->Init.ContinuousConvMode == DISABLE) ) ) ) |
|
| 486 | /* Update ADC state machine */ |
486 | { |
| 487 | SET_BIT(hadc->State, HAL_ADC_STATE_INJ_EOC); |
487 | /* Set ADC state */ |
| 488 | 488 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_INJ_BUSY); |
|
| 489 | /* Determine whether any further conversion upcoming on group injected */ |
489 | |
| 490 | /* by external trigger or by automatic injected conversion */ |
490 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
| 491 | /* from group regular. */ |
491 | { |
| 492 | if(ADC_IS_SOFTWARE_START_INJECTED(hadc) || |
492 | SET_BIT(hadc->State, HAL_ADC_STATE_READY); |
| 493 | (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) && |
493 | } |
| 494 | (ADC_IS_SOFTWARE_START_REGULAR(hadc) && |
494 | } |
| 495 | (hadc->Init.ContinuousConvMode == DISABLE) ) ) ) |
495 | |
| 496 | { |
496 | /* Return ADC state */ |
| 497 | /* Set ADC state */ |
497 | return HAL_OK; |
| 498 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_INJ_BUSY); |
498 | } |
| 499 | 499 | ||
| 500 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
500 | /** |
| 501 | { |
501 | * @brief Enables ADC, starts conversion of injected group with interruption. |
| 502 | SET_BIT(hadc->State, HAL_ADC_STATE_READY); |
502 | * - JEOC (end of conversion of injected group) |
| 503 | } |
503 | * Each of these interruptions has its dedicated callback function. |
| 504 | } |
504 | * @param hadc: ADC handle |
| 505 | 505 | * @retval HAL status. |
|
| 506 | /* Return ADC state */ |
506 | */ |
| 507 | return HAL_OK; |
507 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc) |
| 508 | } |
508 | { |
| 509 | 509 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
|
| 510 | /** |
510 | |
| 511 | * @brief Enables ADC, starts conversion of injected group with interruption. |
511 | /* Check the parameters */ |
| 512 | * - JEOC (end of conversion of injected group) |
512 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 513 | * Each of these interruptions has its dedicated callback function. |
513 | |
| 514 | * @param hadc: ADC handle |
514 | /* Process locked */ |
| 515 | * @retval HAL status. |
515 | __HAL_LOCK(hadc); |
| 516 | */ |
516 | |
| 517 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc) |
517 | /* Enable the ADC peripheral */ |
| 518 | { |
518 | tmp_hal_status = ADC_Enable(hadc); |
| 519 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
519 | |
| 520 | 520 | /* Start conversion if ADC is effectively enabled */ |
|
| 521 | /* Check the parameters */ |
521 | if (tmp_hal_status == HAL_OK) |
| 522 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
522 | { |
| 523 | 523 | /* Set ADC state */ |
|
| 524 | /* Process locked */ |
524 | /* - Clear state bitfield related to injected group conversion results */ |
| 525 | __HAL_LOCK(hadc); |
525 | /* - Set state bitfield related to injected operation */ |
| 526 | 526 | ADC_STATE_CLR_SET(hadc->State, |
|
| 527 | /* Enable the ADC peripheral */ |
527 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
| 528 | tmp_hal_status = ADC_Enable(hadc); |
528 | HAL_ADC_STATE_INJ_BUSY); |
| 529 | 529 | ||
| 530 | /* Start conversion if ADC is effectively enabled */ |
530 | /* Case of independent mode or multimode (for devices with several ADCs): */ |
| 531 | if (tmp_hal_status == HAL_OK) |
531 | /* Set multimode state. */ |
| 532 | { |
532 | if (ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc)) |
| 533 | /* Set ADC state */ |
533 | { |
| 534 | /* - Clear state bitfield related to injected group conversion results */ |
534 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
| 535 | /* - Set state bitfield related to injected operation */ |
535 | } |
| 536 | ADC_STATE_CLR_SET(hadc->State, |
536 | else |
| 537 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
537 | { |
| 538 | HAL_ADC_STATE_INJ_BUSY); |
538 | SET_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
| 539 | 539 | } |
|
| 540 | /* Case of independent mode or multimode (for devices with several ADCs): */ |
540 | |
| 541 | /* Set multimode state. */ |
541 | /* Check if a regular conversion is ongoing */ |
| 542 | if (ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc)) |
542 | /* Note: On this device, there is no ADC error code fields related to */ |
| 543 | { |
543 | /* conversions on group injected only. In case of conversion on */ |
| 544 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
544 | /* going on group regular, no error code is reset. */ |
| 545 | } |
545 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
| 546 | else |
546 | { |
| 547 | { |
547 | /* Reset ADC all error code fields */ |
| 548 | SET_BIT(hadc->State, HAL_ADC_STATE_MULTIMODE_SLAVE); |
548 | ADC_CLEAR_ERRORCODE(hadc); |
| 549 | } |
549 | } |
| 550 | 550 | ||
| 551 | /* Check if a regular conversion is ongoing */ |
551 | /* Process unlocked */ |
| 552 | /* Note: On this device, there is no ADC error code fields related to */ |
552 | /* Unlock before starting ADC conversions: in case of potential */ |
| 553 | /* conversions on group injected only. In case of conversion on */ |
553 | /* interruption, to let the process to ADC IRQ Handler. */ |
| 554 | /* going on group regular, no error code is reset. */ |
554 | __HAL_UNLOCK(hadc); |
| 555 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
555 | |
| 556 | { |
556 | /* Clear injected group conversion flag */ |
| 557 | /* Reset ADC all error code fields */ |
557 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
| 558 | ADC_CLEAR_ERRORCODE(hadc); |
558 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
| 559 | } |
559 | |
| 560 | 560 | /* Enable end of conversion interrupt for injected channels */ |
|
| 561 | /* Process unlocked */ |
561 | __HAL_ADC_ENABLE_IT(hadc, ADC_IT_JEOC); |
| 562 | /* Unlock before starting ADC conversions: in case of potential */ |
562 | |
| 563 | /* interruption, to let the process to ADC IRQ Handler. */ |
563 | /* Start conversion of injected group if software start has been selected */ |
| 564 | __HAL_UNLOCK(hadc); |
564 | /* and if automatic injected conversion is disabled. */ |
| 565 | 565 | /* If external trigger has been selected, conversion will start at next */ |
|
| 566 | /* Clear injected group conversion flag */ |
566 | /* trigger event. */ |
| 567 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
567 | /* If automatic injected conversion is enabled, conversion will start */ |
| 568 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
568 | /* after next regular group conversion. */ |
| 569 | 569 | if (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO)) |
|
| 570 | /* Enable end of conversion interrupt for injected channels */ |
570 | { |
| 571 | __HAL_ADC_ENABLE_IT(hadc, ADC_IT_JEOC); |
571 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
| 572 | 572 | ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc) ) |
|
| 573 | /* Start conversion of injected group if software start has been selected */ |
573 | { |
| 574 | /* and if automatic injected conversion is disabled. */ |
574 | /* Start ADC conversion on injected group with SW start */ |
| 575 | /* If external trigger has been selected, conversion will start at next */ |
575 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_JSWSTART | ADC_CR2_JEXTTRIG)); |
| 576 | /* trigger event. */ |
576 | } |
| 577 | /* If automatic injected conversion is enabled, conversion will start */ |
577 | else |
| 578 | /* after next regular group conversion. */ |
578 | { |
| 579 | if (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO)) |
579 | /* Start ADC conversion on injected group with external trigger */ |
| 580 | { |
580 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JEXTTRIG); |
| 581 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
581 | } |
| 582 | ADC_NONMULTIMODE_OR_MULTIMODEMASTER(hadc) ) |
582 | } |
| 583 | { |
583 | } |
| 584 | /* Start ADC conversion on injected group with SW start */ |
584 | else |
| 585 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_JSWSTART | ADC_CR2_JEXTTRIG)); |
585 | { |
| 586 | } |
586 | /* Process unlocked */ |
| 587 | else |
587 | __HAL_UNLOCK(hadc); |
| 588 | { |
588 | } |
| 589 | /* Start ADC conversion on injected group with external trigger */ |
589 | |
| 590 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JEXTTRIG); |
590 | /* Return function status */ |
| 591 | } |
591 | return tmp_hal_status; |
| 592 | } |
592 | } |
| 593 | } |
593 | |
| 594 | else |
594 | /** |
| 595 | { |
595 | * @brief Stop conversion of injected channels, disable interruption of |
| 596 | /* Process unlocked */ |
596 | * end-of-conversion. Disable ADC peripheral if no regular conversion |
| 597 | __HAL_UNLOCK(hadc); |
597 | * is on going. |
| 598 | } |
598 | * @note If ADC must be disabled and if conversion is on going on |
| 599 | 599 | * regular group, function HAL_ADC_Stop must be used to stop both |
|
| 600 | /* Return function status */ |
600 | * injected and regular groups, and disable the ADC. |
| 601 | return tmp_hal_status; |
601 | * @note If injected group mode auto-injection is enabled, |
| 602 | } |
602 | * function HAL_ADC_Stop must be used. |
| 603 | 603 | * @param hadc: ADC handle |
|
| 604 | /** |
604 | * @retval None |
| 605 | * @brief Stop conversion of injected channels, disable interruption of |
605 | */ |
| 606 | * end-of-conversion. Disable ADC peripheral if no regular conversion |
606 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc) |
| 607 | * is on going. |
607 | { |
| 608 | * @note If ADC must be disabled and if conversion is on going on |
608 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 609 | * regular group, function HAL_ADC_Stop must be used to stop both |
609 | |
| 610 | * injected and regular groups, and disable the ADC. |
610 | /* Check the parameters */ |
| 611 | * @note If injected group mode auto-injection is enabled, |
611 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 612 | * function HAL_ADC_Stop must be used. |
612 | |
| 613 | * @param hadc: ADC handle |
613 | /* Process locked */ |
| 614 | * @retval None |
614 | __HAL_LOCK(hadc); |
| 615 | */ |
615 | |
| 616 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc) |
616 | /* Stop potential conversion and disable ADC peripheral */ |
| 617 | { |
617 | /* Conditioned to: */ |
| 618 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
618 | /* - No conversion on the other group (regular group) is intended to */ |
| 619 | 619 | /* continue (injected and regular groups stop conversion and ADC disable */ |
|
| 620 | /* Check the parameters */ |
620 | /* are common) */ |
| 621 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
621 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
| 622 | 622 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
|
| 623 | /* Process locked */ |
623 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 624 | __HAL_LOCK(hadc); |
624 | { |
| 625 | 625 | /* Stop potential conversion on going, on regular and injected groups */ |
|
| 626 | /* Stop potential conversion and disable ADC peripheral */ |
626 | /* Disable ADC peripheral */ |
| 627 | /* Conditioned to: */ |
627 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 628 | /* - No conversion on the other group (regular group) is intended to */ |
628 | |
| 629 | /* continue (injected and regular groups stop conversion and ADC disable */ |
629 | /* Check if ADC is effectively disabled */ |
| 630 | /* are common) */ |
630 | if (tmp_hal_status == HAL_OK) |
| 631 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
631 | { |
| 632 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
632 | /* Disable ADC end of conversion interrupt for injected channels */ |
| 633 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
633 | __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC); |
| 634 | { |
634 | |
| 635 | /* Stop potential conversion on going, on regular and injected groups */ |
635 | /* Set ADC state */ |
| 636 | /* Disable ADC peripheral */ |
636 | ADC_STATE_CLR_SET(hadc->State, |
| 637 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
637 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
| 638 | 638 | HAL_ADC_STATE_READY); |
|
| 639 | /* Check if ADC is effectively disabled */ |
639 | } |
| 640 | if (tmp_hal_status == HAL_OK) |
640 | } |
| 641 | { |
641 | else |
| 642 | /* Disable ADC end of conversion interrupt for injected channels */ |
642 | { |
| 643 | __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC); |
643 | /* Update ADC state machine to error */ |
| 644 | 644 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
|
| 645 | /* Set ADC state */ |
645 | |
| 646 | ADC_STATE_CLR_SET(hadc->State, |
646 | tmp_hal_status = HAL_ERROR; |
| 647 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
647 | } |
| 648 | HAL_ADC_STATE_READY); |
648 | |
| 649 | } |
649 | /* Process unlocked */ |
| 650 | } |
650 | __HAL_UNLOCK(hadc); |
| 651 | else |
651 | |
| 652 | { |
652 | /* Return function status */ |
| 653 | /* Update ADC state machine to error */ |
653 | return tmp_hal_status; |
| 654 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
654 | } |
| 655 | 655 | ||
| 656 | tmp_hal_status = HAL_ERROR; |
656 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
| 657 | } |
657 | /** |
| 658 | 658 | * @brief Enables ADC, starts conversion of regular group and transfers result |
|
| 659 | /* Process unlocked */ |
659 | * through DMA. |
| 660 | __HAL_UNLOCK(hadc); |
660 | * Multimode must have been previously configured using |
| 661 | 661 | * HAL_ADCEx_MultiModeConfigChannel() function. |
|
| 662 | /* Return function status */ |
662 | * Interruptions enabled in this function: |
| 663 | return tmp_hal_status; |
663 | * - DMA transfer complete |
| 664 | } |
664 | * - DMA half transfer |
| 665 | 665 | * Each of these interruptions has its dedicated callback function. |
|
| 666 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
666 | * @note: On STM32F1 devices, ADC slave regular group must be configured |
| 667 | /** |
667 | * with conversion trigger ADC_SOFTWARE_START. |
| 668 | * @brief Enables ADC, starts conversion of regular group and transfers result |
668 | * @note: ADC slave can be enabled preliminarily using single-mode |
| 669 | * through DMA. |
669 | * HAL_ADC_Start() function. |
| 670 | * Multimode must have been previously configured using |
670 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
| 671 | * HAL_ADCEx_MultiModeConfigChannel() function. |
671 | * @param pData: The destination Buffer address. |
| 672 | * Interruptions enabled in this function: |
672 | * @param Length: The length of data to be transferred from ADC peripheral to memory. |
| 673 | * - DMA transfer complete |
673 | * @retval None |
| 674 | * - DMA half transfer |
674 | */ |
| 675 | * Each of these interruptions has its dedicated callback function. |
675 | HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length) |
| 676 | * @note: On STM32F1 devices, ADC slave regular group must be configured |
676 | { |
| 677 | * with conversion trigger ADC_SOFTWARE_START. |
677 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 678 | * @note: ADC slave can be enabled preliminarily using single-mode |
678 | ADC_HandleTypeDef tmphadcSlave={0}; |
| 679 | * HAL_ADC_Start() function. |
679 | |
| 680 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
680 | /* Check the parameters */ |
| 681 | * @param pData: The destination Buffer address. |
681 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
| 682 | * @param Length: The length of data to be transferred from ADC peripheral to memory. |
682 | assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode)); |
| 683 | * @retval None |
683 | |
| 684 | */ |
684 | /* Process locked */ |
| 685 | HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length) |
685 | __HAL_LOCK(hadc); |
| 686 | { |
686 | |
| 687 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
687 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
| 688 | ADC_HandleTypeDef tmphadcSlave={0}; |
688 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
| 689 | 689 | ||
| 690 | /* Check the parameters */ |
690 | /* On STM32F1 devices, ADC slave regular group must be configured with */ |
| 691 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
691 | /* conversion trigger ADC_SOFTWARE_START. */ |
| 692 | assert_param(IS_FUNCTIONAL_STATE(hadc->Init.ContinuousConvMode)); |
692 | /* Note: External trigger of ADC slave must be enabled, it is already done */ |
| 693 | 693 | /* into function "HAL_ADC_Init()". */ |
|
| 694 | /* Process locked */ |
694 | if(!ADC_IS_SOFTWARE_START_REGULAR(&tmphadcSlave)) |
| 695 | __HAL_LOCK(hadc); |
695 | { |
| 696 | 696 | /* Update ADC state machine to error */ |
|
| 697 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
697 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 698 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
698 | |
| 699 | 699 | /* Process unlocked */ |
|
| 700 | /* On STM32F1 devices, ADC slave regular group must be configured with */ |
700 | __HAL_UNLOCK(hadc); |
| 701 | /* conversion trigger ADC_SOFTWARE_START. */ |
701 | |
| 702 | /* Note: External trigger of ADC slave must be enabled, it is already done */ |
702 | return HAL_ERROR; |
| 703 | /* into function "HAL_ADC_Init()". */ |
703 | } |
| 704 | if(!ADC_IS_SOFTWARE_START_REGULAR(&tmphadcSlave)) |
704 | |
| 705 | { |
705 | /* Enable the ADC peripherals: master and slave (in case if not already */ |
| 706 | /* Update ADC state machine to error */ |
706 | /* enabled previously) */ |
| 707 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
707 | tmp_hal_status = ADC_Enable(hadc); |
| 708 | 708 | if (tmp_hal_status == HAL_OK) |
|
| 709 | /* Process unlocked */ |
709 | { |
| 710 | __HAL_UNLOCK(hadc); |
710 | tmp_hal_status = ADC_Enable(&tmphadcSlave); |
| 711 | 711 | } |
|
| 712 | return HAL_ERROR; |
712 | |
| 713 | } |
713 | /* Start conversion if all ADCs of multimode are effectively enabled */ |
| 714 | 714 | if (tmp_hal_status == HAL_OK) |
|
| 715 | /* Enable the ADC peripherals: master and slave (in case if not already */ |
715 | { |
| 716 | /* enabled previously) */ |
716 | /* Set ADC state (ADC master) */ |
| 717 | tmp_hal_status = ADC_Enable(hadc); |
717 | /* - Clear state bitfield related to regular group conversion results */ |
| 718 | if (tmp_hal_status == HAL_OK) |
718 | /* - Set state bitfield related to regular operation */ |
| 719 | { |
719 | ADC_STATE_CLR_SET(hadc->State, |
| 720 | tmp_hal_status = ADC_Enable(&tmphadcSlave); |
720 | HAL_ADC_STATE_READY | HAL_ADC_STATE_REG_EOC | HAL_ADC_STATE_MULTIMODE_SLAVE, |
| 721 | } |
721 | HAL_ADC_STATE_REG_BUSY); |
| 722 | 722 | ||
| 723 | /* Start conversion if all ADCs of multimode are effectively enabled */ |
723 | /* If conversions on group regular are also triggering group injected, */ |
| 724 | if (tmp_hal_status == HAL_OK) |
724 | /* update ADC state. */ |
| 725 | { |
725 | if (READ_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO) != RESET) |
| 726 | /* Set ADC state (ADC master) */ |
726 | { |
| 727 | /* - Clear state bitfield related to regular group conversion results */ |
727 | ADC_STATE_CLR_SET(hadc->State, HAL_ADC_STATE_INJ_EOC, HAL_ADC_STATE_INJ_BUSY); |
| 728 | /* - Set state bitfield related to regular operation */ |
728 | } |
| 729 | ADC_STATE_CLR_SET(hadc->State, |
729 | |
| 730 | HAL_ADC_STATE_READY | HAL_ADC_STATE_REG_EOC | HAL_ADC_STATE_MULTIMODE_SLAVE, |
730 | /* Process unlocked */ |
| 731 | HAL_ADC_STATE_REG_BUSY); |
731 | /* Unlock before starting ADC conversions: in case of potential */ |
| 732 | 732 | /* interruption, to let the process to ADC IRQ Handler. */ |
|
| 733 | /* If conversions on group regular are also triggering group injected, */ |
733 | __HAL_UNLOCK(hadc); |
| 734 | /* update ADC state. */ |
734 | |
| 735 | if (READ_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO) != RESET) |
735 | /* Set ADC error code to none */ |
| 736 | { |
736 | ADC_CLEAR_ERRORCODE(hadc); |
| 737 | ADC_STATE_CLR_SET(hadc->State, HAL_ADC_STATE_INJ_EOC, HAL_ADC_STATE_INJ_BUSY); |
737 | |
| 738 | } |
738 | |
| 739 | 739 | /* Set the DMA transfer complete callback */ |
|
| 740 | /* Process unlocked */ |
740 | hadc->DMA_Handle->XferCpltCallback = ADC_DMAConvCplt; |
| 741 | /* Unlock before starting ADC conversions: in case of potential */ |
741 | |
| 742 | /* interruption, to let the process to ADC IRQ Handler. */ |
742 | /* Set the DMA half transfer complete callback */ |
| 743 | __HAL_UNLOCK(hadc); |
743 | hadc->DMA_Handle->XferHalfCpltCallback = ADC_DMAHalfConvCplt; |
| 744 | 744 | ||
| 745 | /* Set ADC error code to none */ |
745 | /* Set the DMA error callback */ |
| 746 | ADC_CLEAR_ERRORCODE(hadc); |
746 | hadc->DMA_Handle->XferErrorCallback = ADC_DMAError; |
| 747 | 747 | ||
| 748 | 748 | ||
| 749 | /* Set the DMA transfer complete callback */ |
749 | /* Manage ADC and DMA start: ADC overrun interruption, DMA start, ADC */ |
| 750 | hadc->DMA_Handle->XferCpltCallback = ADC_DMAConvCplt; |
750 | /* start (in case of SW start): */ |
| 751 | 751 | ||
| 752 | /* Set the DMA half transfer complete callback */ |
752 | /* Clear regular group conversion flag and overrun flag */ |
| 753 | hadc->DMA_Handle->XferHalfCpltCallback = ADC_DMAHalfConvCplt; |
753 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
| 754 | 754 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_EOC); |
|
| 755 | /* Set the DMA error callback */ |
755 | |
| 756 | hadc->DMA_Handle->XferErrorCallback = ADC_DMAError; |
756 | /* Enable ADC DMA mode of ADC master */ |
| 757 | 757 | SET_BIT(hadc->Instance->CR2, ADC_CR2_DMA); |
|
| 758 | 758 | ||
| 759 | /* Manage ADC and DMA start: ADC overrun interruption, DMA start, ADC */ |
759 | /* Start the DMA channel */ |
| 760 | /* start (in case of SW start): */ |
760 | HAL_DMA_Start_IT(hadc->DMA_Handle, (uint32_t)&hadc->Instance->DR, (uint32_t)pData, Length); |
| 761 | 761 | ||
| 762 | /* Clear regular group conversion flag and overrun flag */ |
762 | /* Start conversion of regular group if software start has been selected. */ |
| 763 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
763 | /* If external trigger has been selected, conversion will start at next */ |
| 764 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_EOC); |
764 | /* trigger event. */ |
| 765 | 765 | /* Note: Alternate trigger for single conversion could be to force an */ |
|
| 766 | /* Enable ADC DMA mode of ADC master */ |
766 | /* additional set of bit ADON "hadc->Instance->CR2 |= ADC_CR2_ADON;"*/ |
| 767 | SET_BIT(hadc->Instance->CR2, ADC_CR2_DMA); |
767 | if (ADC_IS_SOFTWARE_START_REGULAR(hadc)) |
| 768 | 768 | { |
|
| 769 | /* Start the DMA channel */ |
769 | /* Start ADC conversion on regular group with SW start */ |
| 770 | HAL_DMA_Start_IT(hadc->DMA_Handle, (uint32_t)&hadc->Instance->DR, (uint32_t)pData, Length); |
770 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_SWSTART | ADC_CR2_EXTTRIG)); |
| 771 | 771 | } |
|
| 772 | /* Start conversion of regular group if software start has been selected. */ |
772 | else |
| 773 | /* If external trigger has been selected, conversion will start at next */ |
773 | { |
| 774 | /* trigger event. */ |
774 | /* Start ADC conversion on regular group with external trigger */ |
| 775 | /* Note: Alternate trigger for single conversion could be to force an */ |
775 | SET_BIT(hadc->Instance->CR2, ADC_CR2_EXTTRIG); |
| 776 | /* additional set of bit ADON "hadc->Instance->CR2 |= ADC_CR2_ADON;"*/ |
776 | } |
| 777 | if (ADC_IS_SOFTWARE_START_REGULAR(hadc)) |
777 | } |
| 778 | { |
778 | else |
| 779 | /* Start ADC conversion on regular group with SW start */ |
779 | { |
| 780 | SET_BIT(hadc->Instance->CR2, (ADC_CR2_SWSTART | ADC_CR2_EXTTRIG)); |
780 | /* Process unlocked */ |
| 781 | } |
781 | __HAL_UNLOCK(hadc); |
| 782 | else |
782 | } |
| 783 | { |
783 | |
| 784 | /* Start ADC conversion on regular group with external trigger */ |
784 | /* Return function status */ |
| 785 | SET_BIT(hadc->Instance->CR2, ADC_CR2_EXTTRIG); |
785 | return tmp_hal_status; |
| 786 | } |
786 | } |
| 787 | } |
787 | |
| 788 | else |
788 | /** |
| 789 | { |
789 | * @brief Stop ADC conversion of regular group (and injected channels in |
| 790 | /* Process unlocked */ |
790 | * case of auto_injection mode), disable ADC DMA transfer, disable |
| 791 | __HAL_UNLOCK(hadc); |
791 | * ADC peripheral. |
| 792 | } |
792 | * @note Multimode is kept enabled after this function. To disable multimode |
| 793 | 793 | * (set with HAL_ADCEx_MultiModeConfigChannel(), ADC must be |
|
| 794 | /* Return function status */ |
794 | * reinitialized using HAL_ADC_Init() or HAL_ADC_ReInit(). |
| 795 | return tmp_hal_status; |
795 | * @note In case of DMA configured in circular mode, function |
| 796 | } |
796 | * HAL_ADC_Stop_DMA must be called after this function with handle of |
| 797 | 797 | * ADC slave, to properly disable the DMA channel. |
|
| 798 | /** |
798 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
| 799 | * @brief Stop ADC conversion of regular group (and injected channels in |
799 | * @retval None |
| 800 | * case of auto_injection mode), disable ADC DMA transfer, disable |
800 | */ |
| 801 | * ADC peripheral. |
801 | HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA(ADC_HandleTypeDef* hadc) |
| 802 | * @note Multimode is kept enabled after this function. To disable multimode |
802 | { |
| 803 | * (set with HAL_ADCEx_MultiModeConfigChannel(), ADC must be |
803 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 804 | * reinitialized using HAL_ADC_Init() or HAL_ADC_ReInit(). |
804 | ADC_HandleTypeDef tmphadcSlave={0}; |
| 805 | * @note In case of DMA configured in circular mode, function |
805 | |
| 806 | * HAL_ADC_Stop_DMA must be called after this function with handle of |
806 | /* Check the parameters */ |
| 807 | * ADC slave, to properly disable the DMA channel. |
807 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
| 808 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
808 | |
| 809 | * @retval None |
809 | /* Process locked */ |
| 810 | */ |
810 | __HAL_LOCK(hadc); |
| 811 | HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA(ADC_HandleTypeDef* hadc) |
811 | |
| 812 | { |
812 | /* Stop potential conversion on going, on regular and injected groups */ |
| 813 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
813 | /* Disable ADC master peripheral */ |
| 814 | ADC_HandleTypeDef tmphadcSlave={0}; |
814 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 815 | 815 | ||
| 816 | /* Check the parameters */ |
816 | /* Check if ADC is effectively disabled */ |
| 817 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
817 | if(tmp_hal_status == HAL_OK) |
| 818 | 818 | { |
|
| 819 | /* Process locked */ |
819 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
| 820 | __HAL_LOCK(hadc); |
820 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
| 821 | 821 | ||
| 822 | /* Stop potential conversion on going, on regular and injected groups */ |
822 | /* Disable ADC slave peripheral */ |
| 823 | /* Disable ADC master peripheral */ |
823 | tmp_hal_status = ADC_ConversionStop_Disable(&tmphadcSlave); |
| 824 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
824 | |
| 825 | 825 | /* Check if ADC is effectively disabled */ |
|
| 826 | /* Check if ADC is effectively disabled */ |
826 | if(tmp_hal_status != HAL_OK) |
| 827 | if(tmp_hal_status == HAL_OK) |
827 | { |
| 828 | { |
828 | /* Update ADC state machine to error */ |
| 829 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
829 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL); |
| 830 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
830 | |
| 831 | 831 | /* Process unlocked */ |
|
| 832 | /* Disable ADC slave peripheral */ |
832 | __HAL_UNLOCK(hadc); |
| 833 | tmp_hal_status = ADC_ConversionStop_Disable(&tmphadcSlave); |
833 | |
| 834 | 834 | return HAL_ERROR; |
|
| 835 | /* Check if ADC is effectively disabled */ |
835 | } |
| 836 | if(tmp_hal_status != HAL_OK) |
836 | |
| 837 | { |
837 | /* Disable ADC DMA mode */ |
| 838 | /* Update ADC state machine to error */ |
838 | CLEAR_BIT(hadc->Instance->CR2, ADC_CR2_DMA); |
| 839 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_INTERNAL); |
839 | |
| 840 | 840 | /* Reset configuration of ADC DMA continuous request for dual mode */ |
|
| 841 | /* Process unlocked */ |
841 | CLEAR_BIT(hadc->Instance->CR1, ADC_CR1_DUALMOD); |
| 842 | __HAL_UNLOCK(hadc); |
842 | |
| 843 | 843 | /* Disable the DMA channel (in case of DMA in circular mode or stop while */ |
|
| 844 | return HAL_ERROR; |
844 | /* while DMA transfer is on going) */ |
| 845 | } |
845 | tmp_hal_status = HAL_DMA_Abort(hadc->DMA_Handle); |
| 846 | 846 | ||
| 847 | /* Disable ADC DMA mode */ |
847 | /* Change ADC state (ADC master) */ |
| 848 | CLEAR_BIT(hadc->Instance->CR2, ADC_CR2_DMA); |
848 | ADC_STATE_CLR_SET(hadc->State, |
| 849 | 849 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
|
| 850 | /* Reset configuration of ADC DMA continuous request for dual mode */ |
850 | HAL_ADC_STATE_READY); |
| 851 | CLEAR_BIT(hadc->Instance->CR1, ADC_CR1_DUALMOD); |
851 | } |
| 852 | 852 | ||
| 853 | /* Disable the DMA channel (in case of DMA in circular mode or stop while */ |
853 | /* Process unlocked */ |
| 854 | /* while DMA transfer is on going) */ |
854 | __HAL_UNLOCK(hadc); |
| 855 | tmp_hal_status = HAL_DMA_Abort(hadc->DMA_Handle); |
855 | |
| 856 | 856 | /* Return function status */ |
|
| 857 | /* Change ADC state (ADC master) */ |
857 | return tmp_hal_status; |
| 858 | ADC_STATE_CLR_SET(hadc->State, |
858 | } |
| 859 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
859 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
| 860 | HAL_ADC_STATE_READY); |
860 | |
| 861 | } |
861 | /** |
| 862 | 862 | * @brief Get ADC injected group conversion result. |
|
| 863 | /* Process unlocked */ |
863 | * @note Reading register JDRx automatically clears ADC flag JEOC |
| 864 | __HAL_UNLOCK(hadc); |
864 | * (ADC group injected end of unitary conversion). |
| 865 | 865 | * @note This function does not clear ADC flag JEOS |
|
| 866 | /* Return function status */ |
866 | * (ADC group injected end of sequence conversion) |
| 867 | return tmp_hal_status; |
867 | * Occurrence of flag JEOS rising: |
| 868 | } |
868 | * - If sequencer is composed of 1 rank, flag JEOS is equivalent |
| 869 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
869 | * to flag JEOC. |
| 870 | 870 | * - If sequencer is composed of several ranks, during the scan |
|
| 871 | /** |
871 | * sequence flag JEOC only is raised, at the end of the scan sequence |
| 872 | * @brief Get ADC injected group conversion result. |
872 | * both flags JEOC and EOS are raised. |
| 873 | * @note Reading register JDRx automatically clears ADC flag JEOC |
873 | * Flag JEOS must not be cleared by this function because |
| 874 | * (ADC group injected end of unitary conversion). |
874 | * it would not be compliant with low power features |
| 875 | * @note This function does not clear ADC flag JEOS |
875 | * (feature low power auto-wait, not available on all STM32 families). |
| 876 | * (ADC group injected end of sequence conversion) |
876 | * To clear this flag, either use function: |
| 877 | * Occurrence of flag JEOS rising: |
877 | * in programming model IT: @ref HAL_ADC_IRQHandler(), in programming |
| 878 | * - If sequencer is composed of 1 rank, flag JEOS is equivalent |
878 | * model polling: @ref HAL_ADCEx_InjectedPollForConversion() |
| 879 | * to flag JEOC. |
879 | * or @ref __HAL_ADC_CLEAR_FLAG(&hadc, ADC_FLAG_JEOS). |
| 880 | * - If sequencer is composed of several ranks, during the scan |
880 | * @param hadc: ADC handle |
| 881 | * sequence flag JEOC only is raised, at the end of the scan sequence |
881 | * @param InjectedRank: the converted ADC injected rank. |
| 882 | * both flags JEOC and EOS are raised. |
882 | * This parameter can be one of the following values: |
| 883 | * Flag JEOS must not be cleared by this function because |
883 | * @arg ADC_INJECTED_RANK_1: Injected Channel1 selected |
| 884 | * it would not be compliant with low power features |
884 | * @arg ADC_INJECTED_RANK_2: Injected Channel2 selected |
| 885 | * (feature low power auto-wait, not available on all STM32 families). |
885 | * @arg ADC_INJECTED_RANK_3: Injected Channel3 selected |
| 886 | * To clear this flag, either use function: |
886 | * @arg ADC_INJECTED_RANK_4: Injected Channel4 selected |
| 887 | * in programming model IT: @ref HAL_ADC_IRQHandler(), in programming |
887 | * @retval ADC group injected conversion data |
| 888 | * model polling: @ref HAL_ADCEx_InjectedPollForConversion() |
888 | */ |
| 889 | * or @ref __HAL_ADC_CLEAR_FLAG(&hadc, ADC_FLAG_JEOS). |
889 | uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank) |
| 890 | * @param hadc: ADC handle |
890 | { |
| 891 | * @param InjectedRank: the converted ADC injected rank. |
891 | uint32_t tmp_jdr = 0U; |
| 892 | * This parameter can be one of the following values: |
892 | |
| 893 | * @arg ADC_INJECTED_RANK_1: Injected Channel1 selected |
893 | /* Check the parameters */ |
| 894 | * @arg ADC_INJECTED_RANK_2: Injected Channel2 selected |
894 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 895 | * @arg ADC_INJECTED_RANK_3: Injected Channel3 selected |
895 | assert_param(IS_ADC_INJECTED_RANK(InjectedRank)); |
| 896 | * @arg ADC_INJECTED_RANK_4: Injected Channel4 selected |
896 | |
| 897 | * @retval ADC group injected conversion data |
897 | /* Get ADC converted value */ |
| 898 | */ |
898 | switch(InjectedRank) |
| 899 | uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank) |
899 | { |
| 900 | { |
900 | case ADC_INJECTED_RANK_4: |
| 901 | uint32_t tmp_jdr = 0U; |
901 | tmp_jdr = hadc->Instance->JDR4; |
| 902 | 902 | break; |
|
| 903 | /* Check the parameters */ |
903 | case ADC_INJECTED_RANK_3: |
| 904 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
904 | tmp_jdr = hadc->Instance->JDR3; |
| 905 | assert_param(IS_ADC_INJECTED_RANK(InjectedRank)); |
905 | break; |
| 906 | 906 | case ADC_INJECTED_RANK_2: |
|
| 907 | /* Get ADC converted value */ |
907 | tmp_jdr = hadc->Instance->JDR2; |
| 908 | switch(InjectedRank) |
908 | break; |
| 909 | { |
909 | case ADC_INJECTED_RANK_1: |
| 910 | case ADC_INJECTED_RANK_4: |
910 | default: |
| 911 | tmp_jdr = hadc->Instance->JDR4; |
911 | tmp_jdr = hadc->Instance->JDR1; |
| 912 | break; |
912 | break; |
| 913 | case ADC_INJECTED_RANK_3: |
913 | } |
| 914 | tmp_jdr = hadc->Instance->JDR3; |
914 | |
| 915 | break; |
915 | /* Return ADC converted value */ |
| 916 | case ADC_INJECTED_RANK_2: |
916 | return tmp_jdr; |
| 917 | tmp_jdr = hadc->Instance->JDR2; |
917 | } |
| 918 | break; |
918 | |
| 919 | case ADC_INJECTED_RANK_1: |
919 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
| 920 | default: |
920 | /** |
| 921 | tmp_jdr = hadc->Instance->JDR1; |
921 | * @brief Returns the last ADC Master&Slave regular conversions results data |
| 922 | break; |
922 | * in the selected multi mode. |
| 923 | } |
923 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
| 924 | 924 | * @retval The converted data value. |
|
| 925 | /* Return ADC converted value */ |
925 | */ |
| 926 | return tmp_jdr; |
926 | uint32_t HAL_ADCEx_MultiModeGetValue(ADC_HandleTypeDef* hadc) |
| 927 | } |
927 | { |
| 928 | 928 | uint32_t tmpDR = 0U; |
|
| 929 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
929 | |
| 930 | /** |
930 | /* Check the parameters */ |
| 931 | * @brief Returns the last ADC Master&Slave regular conversions results data |
931 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
| 932 | * in the selected multi mode. |
932 | |
| 933 | * @param hadc: ADC handle of ADC master (handle of ADC slave must not be used) |
933 | /* Check the parameters */ |
| 934 | * @retval The converted data value. |
934 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 935 | */ |
935 | |
| 936 | uint32_t HAL_ADCEx_MultiModeGetValue(ADC_HandleTypeDef* hadc) |
936 | /* Note: EOC flag is not cleared here by software because automatically */ |
| 937 | { |
937 | /* cleared by hardware when reading register DR. */ |
| 938 | uint32_t tmpDR = 0U; |
938 | |
| 939 | 939 | /* On STM32F1 devices, ADC1 data register DR contains ADC2 conversions */ |
|
| 940 | /* Check the parameters */ |
940 | /* only if ADC1 DMA mode is enabled. */ |
| 941 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
941 | tmpDR = hadc->Instance->DR; |
| 942 | 942 | ||
| 943 | /* Check the parameters */ |
943 | if (HAL_IS_BIT_CLR(ADC1->CR2, ADC_CR2_DMA)) |
| 944 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
944 | { |
| 945 | 945 | tmpDR |= (ADC2->DR << 16U); |
|
| 946 | /* Note: EOC flag is not cleared here by software because automatically */ |
946 | } |
| 947 | /* cleared by hardware when reading register DR. */ |
947 | |
| 948 | 948 | /* Return ADC converted value */ |
|
| 949 | /* On STM32F1 devices, ADC1 data register DR contains ADC2 conversions */ |
949 | return tmpDR; |
| 950 | /* only if ADC1 DMA mode is enabled. */ |
950 | } |
| 951 | tmpDR = hadc->Instance->DR; |
951 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
| 952 | 952 | ||
| 953 | if (HAL_IS_BIT_CLR(ADC1->CR2, ADC_CR2_DMA)) |
953 | /** |
| 954 | { |
954 | * @brief Injected conversion complete callback in non blocking mode |
| 955 | tmpDR |= (ADC2->DR << 16U); |
955 | * @param hadc: ADC handle |
| 956 | } |
956 | * @retval None |
| 957 | 957 | */ |
|
| 958 | /* Return ADC converted value */ |
958 | __weak void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc) |
| 959 | return tmpDR; |
959 | { |
| 960 | } |
960 | /* Prevent unused argument(s) compilation warning */ |
| 961 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
961 | UNUSED(hadc); |
| 962 | 962 | /* NOTE : This function Should not be modified, when the callback is needed, |
|
| 963 | /** |
963 | the HAL_ADCEx_InjectedConvCpltCallback could be implemented in the user file |
| 964 | * @brief Injected conversion complete callback in non blocking mode |
964 | */ |
| 965 | * @param hadc: ADC handle |
965 | } |
| 966 | * @retval None |
966 | |
| 967 | */ |
967 | /** |
| 968 | __weak void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc) |
968 | * @} |
| 969 | { |
969 | */ |
| 970 | /* Prevent unused argument(s) compilation warning */ |
970 | |
| 971 | UNUSED(hadc); |
971 | /** @defgroup ADCEx_Exported_Functions_Group2 Extended Peripheral Control functions |
| 972 | /* NOTE : This function Should not be modified, when the callback is needed, |
972 | * @brief Extended Peripheral Control functions |
| 973 | the HAL_ADCEx_InjectedConvCpltCallback could be implemented in the user file |
973 | * |
| 974 | */ |
974 | @verbatim |
| 975 | } |
975 | =============================================================================== |
| 976 | 976 | ##### Peripheral Control functions ##### |
|
| 977 | /** |
977 | =============================================================================== |
| 978 | * @} |
978 | [..] This section provides functions allowing to: |
| 979 | */ |
979 | (+) Configure channels on injected group |
| 980 | 980 | (+) Configure multimode |
|
| 981 | /** @defgroup ADCEx_Exported_Functions_Group2 Extended Peripheral Control functions |
981 | |
| 982 | * @brief Extended Peripheral Control functions |
982 | @endverbatim |
| 983 | * |
983 | * @{ |
| 984 | @verbatim |
984 | */ |
| 985 | =============================================================================== |
985 | |
| 986 | ##### Peripheral Control functions ##### |
986 | /** |
| 987 | =============================================================================== |
987 | * @brief Configures the ADC injected group and the selected channel to be |
| 988 | [..] This section provides functions allowing to: |
988 | * linked to the injected group. |
| 989 | (+) Configure channels on injected group |
989 | * @note Possibility to update parameters on the fly: |
| 990 | (+) Configure multimode |
990 | * This function initializes injected group, following calls to this |
| 991 | 991 | * function can be used to reconfigure some parameters of structure |
|
| 992 | @endverbatim |
992 | * "ADC_InjectionConfTypeDef" on the fly, without resetting the ADC. |
| 993 | * @{ |
993 | * The setting of these parameters is conditioned to ADC state: |
| 994 | */ |
994 | * this function must be called when ADC is not under conversion. |
| 995 | 995 | * @param hadc: ADC handle |
|
| 996 | /** |
996 | * @param sConfigInjected: Structure of ADC injected group and ADC channel for |
| 997 | * @brief Configures the ADC injected group and the selected channel to be |
997 | * injected group. |
| 998 | * linked to the injected group. |
998 | * @retval None |
| 999 | * @note Possibility to update parameters on the fly: |
999 | */ |
| 1000 | * This function initializes injected group, following calls to this |
1000 | HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc, ADC_InjectionConfTypeDef* sConfigInjected) |
| 1001 | * function can be used to reconfigure some parameters of structure |
1001 | { |
| 1002 | * "ADC_InjectionConfTypeDef" on the fly, without reseting the ADC. |
1002 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 1003 | * The setting of these parameters is conditioned to ADC state: |
1003 | __IO uint32_t wait_loop_index = 0U; |
| 1004 | * this function must be called when ADC is not under conversion. |
1004 | |
| 1005 | * @param hadc: ADC handle |
1005 | /* Check the parameters */ |
| 1006 | * @param sConfigInjected: Structure of ADC injected group and ADC channel for |
1006 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 1007 | * injected group. |
1007 | assert_param(IS_ADC_CHANNEL(sConfigInjected->InjectedChannel)); |
| 1008 | * @retval None |
1008 | assert_param(IS_ADC_SAMPLE_TIME(sConfigInjected->InjectedSamplingTime)); |
| 1009 | */ |
1009 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->AutoInjectedConv)); |
| 1010 | HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc, ADC_InjectionConfTypeDef* sConfigInjected) |
1010 | assert_param(IS_ADC_EXTTRIGINJEC(sConfigInjected->ExternalTrigInjecConv)); |
| 1011 | { |
1011 | assert_param(IS_ADC_RANGE(sConfigInjected->InjectedOffset)); |
| 1012 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
1012 | |
| 1013 | __IO uint32_t wait_loop_index = 0U; |
1013 | if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE) |
| 1014 | 1014 | { |
|
| 1015 | /* Check the parameters */ |
1015 | assert_param(IS_ADC_INJECTED_RANK(sConfigInjected->InjectedRank)); |
| 1016 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
1016 | assert_param(IS_ADC_INJECTED_NB_CONV(sConfigInjected->InjectedNbrOfConversion)); |
| 1017 | assert_param(IS_ADC_CHANNEL(sConfigInjected->InjectedChannel)); |
1017 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->InjectedDiscontinuousConvMode)); |
| 1018 | assert_param(IS_ADC_SAMPLE_TIME(sConfigInjected->InjectedSamplingTime)); |
1018 | } |
| 1019 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->AutoInjectedConv)); |
1019 | |
| 1020 | assert_param(IS_ADC_EXTTRIGINJEC(sConfigInjected->ExternalTrigInjecConv)); |
1020 | /* Process locked */ |
| 1021 | assert_param(IS_ADC_RANGE(sConfigInjected->InjectedOffset)); |
1021 | __HAL_LOCK(hadc); |
| 1022 | 1022 | ||
| 1023 | if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE) |
1023 | /* Configuration of injected group sequencer: */ |
| 1024 | { |
1024 | /* - if scan mode is disabled, injected channels sequence length is set to */ |
| 1025 | assert_param(IS_ADC_INJECTED_RANK(sConfigInjected->InjectedRank)); |
1025 | /* 0x00: 1 channel converted (channel on regular rank 1) */ |
| 1026 | assert_param(IS_ADC_INJECTED_NB_CONV(sConfigInjected->InjectedNbrOfConversion)); |
1026 | /* Parameter "InjectedNbrOfConversion" is discarded. */ |
| 1027 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->InjectedDiscontinuousConvMode)); |
1027 | /* Note: Scan mode is present by hardware on this device and, if */ |
| 1028 | } |
1028 | /* disabled, discards automatically nb of conversions. Anyway, nb of */ |
| 1029 | 1029 | /* conversions is forced to 0x00 for alignment over all STM32 devices. */ |
|
| 1030 | /* Process locked */ |
1030 | /* - if scan mode is enabled, injected channels sequence length is set to */ |
| 1031 | __HAL_LOCK(hadc); |
1031 | /* parameter "InjectedNbrOfConversion". */ |
| 1032 | 1032 | if (hadc->Init.ScanConvMode == ADC_SCAN_DISABLE) |
|
| 1033 | /* Configuration of injected group sequencer: */ |
1033 | { |
| 1034 | /* - if scan mode is disabled, injected channels sequence length is set to */ |
1034 | if (sConfigInjected->InjectedRank == ADC_INJECTED_RANK_1) |
| 1035 | /* 0x00: 1 channel converted (channel on regular rank 1) */ |
1035 | { |
| 1036 | /* Parameter "InjectedNbrOfConversion" is discarded. */ |
1036 | /* Clear the old SQx bits for all injected ranks */ |
| 1037 | /* Note: Scan mode is present by hardware on this device and, if */ |
1037 | MODIFY_REG(hadc->Instance->JSQR , |
| 1038 | /* disabled, discards automatically nb of conversions. Anyway, nb of */ |
1038 | ADC_JSQR_JL | |
| 1039 | /* conversions is forced to 0x00 for alignment over all STM32 devices. */ |
1039 | ADC_JSQR_JSQ4 | |
| 1040 | /* - if scan mode is enabled, injected channels sequence length is set to */ |
1040 | ADC_JSQR_JSQ3 | |
| 1041 | /* parameter "InjectedNbrOfConversion". */ |
1041 | ADC_JSQR_JSQ2 | |
| 1042 | if (hadc->Init.ScanConvMode == ADC_SCAN_DISABLE) |
1042 | ADC_JSQR_JSQ1 , |
| 1043 | { |
1043 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
| 1044 | if (sConfigInjected->InjectedRank == ADC_INJECTED_RANK_1) |
1044 | ADC_INJECTED_RANK_1, |
| 1045 | { |
1045 | 0x01U)); |
| 1046 | /* Clear the old SQx bits for all injected ranks */ |
1046 | } |
| 1047 | MODIFY_REG(hadc->Instance->JSQR , |
1047 | /* If another injected rank than rank1 was intended to be set, and could */ |
| 1048 | ADC_JSQR_JL | |
1048 | /* not due to ScanConvMode disabled, error is reported. */ |
| 1049 | ADC_JSQR_JSQ4 | |
1049 | else |
| 1050 | ADC_JSQR_JSQ3 | |
1050 | { |
| 1051 | ADC_JSQR_JSQ2 | |
1051 | /* Update ADC state machine to error */ |
| 1052 | ADC_JSQR_JSQ1 , |
1052 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 1053 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
1053 | |
| 1054 | ADC_INJECTED_RANK_1, |
1054 | tmp_hal_status = HAL_ERROR; |
| 1055 | 0x01U)); |
1055 | } |
| 1056 | } |
1056 | } |
| 1057 | /* If another injected rank than rank1 was intended to be set, and could */ |
1057 | else |
| 1058 | /* not due to ScanConvMode disabled, error is reported. */ |
1058 | { |
| 1059 | else |
1059 | /* Since injected channels rank conv. order depends on total number of */ |
| 1060 | { |
1060 | /* injected conversions, selected rank must be below or equal to total */ |
| 1061 | /* Update ADC state machine to error */ |
1061 | /* number of injected conversions to be updated. */ |
| 1062 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
1062 | if (sConfigInjected->InjectedRank <= sConfigInjected->InjectedNbrOfConversion) |
| 1063 | 1063 | { |
|
| 1064 | tmp_hal_status = HAL_ERROR; |
1064 | /* Clear the old SQx bits for the selected rank */ |
| 1065 | } |
1065 | /* Set the SQx bits for the selected rank */ |
| 1066 | } |
1066 | MODIFY_REG(hadc->Instance->JSQR , |
| 1067 | else |
1067 | |
| 1068 | { |
1068 | ADC_JSQR_JL | |
| 1069 | /* Since injected channels rank conv. order depends on total number of */ |
1069 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
| 1070 | /* injected conversions, selected rank must be below or equal to total */ |
1070 | sConfigInjected->InjectedRank, |
| 1071 | /* number of injected conversions to be updated. */ |
1071 | sConfigInjected->InjectedNbrOfConversion) , |
| 1072 | if (sConfigInjected->InjectedRank <= sConfigInjected->InjectedNbrOfConversion) |
1072 | |
| 1073 | { |
1073 | ADC_JSQR_JL_SHIFT(sConfigInjected->InjectedNbrOfConversion) | |
| 1074 | /* Clear the old SQx bits for the selected rank */ |
1074 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
| 1075 | /* Set the SQx bits for the selected rank */ |
1075 | sConfigInjected->InjectedRank, |
| 1076 | MODIFY_REG(hadc->Instance->JSQR , |
1076 | sConfigInjected->InjectedNbrOfConversion) ); |
| 1077 | 1077 | } |
|
| 1078 | ADC_JSQR_JL | |
1078 | else |
| 1079 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
1079 | { |
| 1080 | sConfigInjected->InjectedRank, |
1080 | /* Clear the old SQx bits for the selected rank */ |
| 1081 | sConfigInjected->InjectedNbrOfConversion) , |
1081 | MODIFY_REG(hadc->Instance->JSQR , |
| 1082 | 1082 | ||
| 1083 | ADC_JSQR_JL_SHIFT(sConfigInjected->InjectedNbrOfConversion) | |
1083 | ADC_JSQR_JL | |
| 1084 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
1084 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
| 1085 | sConfigInjected->InjectedRank, |
1085 | sConfigInjected->InjectedRank, |
| 1086 | sConfigInjected->InjectedNbrOfConversion) ); |
1086 | sConfigInjected->InjectedNbrOfConversion) , |
| 1087 | } |
1087 | |
| 1088 | else |
1088 | 0x00000000U); |
| 1089 | { |
1089 | } |
| 1090 | /* Clear the old SQx bits for the selected rank */ |
1090 | } |
| 1091 | MODIFY_REG(hadc->Instance->JSQR , |
1091 | |
| 1092 | 1092 | /* Configuration of injected group */ |
|
| 1093 | ADC_JSQR_JL | |
1093 | /* Parameters update conditioned to ADC state: */ |
| 1094 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
1094 | /* Parameters that can be updated only when ADC is disabled: */ |
| 1095 | sConfigInjected->InjectedRank, |
1095 | /* - external trigger to start conversion */ |
| 1096 | sConfigInjected->InjectedNbrOfConversion) , |
1096 | /* Parameters update not conditioned to ADC state: */ |
| 1097 | 1097 | /* - Automatic injected conversion */ |
|
| 1098 | 0x00000000U); |
1098 | /* - Injected discontinuous mode */ |
| 1099 | } |
1099 | /* Note: In case of ADC already enabled, caution to not launch an unwanted */ |
| 1100 | } |
1100 | /* conversion while modifying register CR2 by writing 1 to bit ADON. */ |
| 1101 | 1101 | if (ADC_IS_ENABLE(hadc) == RESET) |
|
| 1102 | /* Configuration of injected group */ |
1102 | { |
| 1103 | /* Parameters update conditioned to ADC state: */ |
1103 | MODIFY_REG(hadc->Instance->CR2 , |
| 1104 | /* Parameters that can be updated only when ADC is disabled: */ |
1104 | ADC_CR2_JEXTSEL | |
| 1105 | /* - external trigger to start conversion */ |
1105 | ADC_CR2_ADON , |
| 1106 | /* Parameters update not conditioned to ADC state: */ |
1106 | ADC_CFGR_JEXTSEL(hadc, sConfigInjected->ExternalTrigInjecConv) ); |
| 1107 | /* - Automatic injected conversion */ |
1107 | } |
| 1108 | /* - Injected discontinuous mode */ |
1108 | |
| 1109 | /* Note: In case of ADC already enabled, caution to not launch an unwanted */ |
1109 | |
| 1110 | /* conversion while modifying register CR2 by writing 1 to bit ADON. */ |
1110 | /* Configuration of injected group */ |
| 1111 | if (ADC_IS_ENABLE(hadc) == RESET) |
1111 | /* - Automatic injected conversion */ |
| 1112 | { |
1112 | /* - Injected discontinuous mode */ |
| 1113 | MODIFY_REG(hadc->Instance->CR2 , |
1113 | |
| 1114 | ADC_CR2_JEXTSEL | |
1114 | /* Automatic injected conversion can be enabled if injected group */ |
| 1115 | ADC_CR2_ADON , |
1115 | /* external triggers are disabled. */ |
| 1116 | ADC_CFGR_JEXTSEL(hadc, sConfigInjected->ExternalTrigInjecConv) ); |
1116 | if (sConfigInjected->AutoInjectedConv == ENABLE) |
| 1117 | } |
1117 | { |
| 1118 | 1118 | if (sConfigInjected->ExternalTrigInjecConv == ADC_INJECTED_SOFTWARE_START) |
|
| 1119 | 1119 | { |
|
| 1120 | /* Configuration of injected group */ |
1120 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO); |
| 1121 | /* - Automatic injected conversion */ |
1121 | } |
| 1122 | /* - Injected discontinuous mode */ |
1122 | else |
| 1123 | 1123 | { |
|
| 1124 | /* Automatic injected conversion can be enabled if injected group */ |
1124 | /* Update ADC state machine to error */ |
| 1125 | /* external triggers are disabled. */ |
1125 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 1126 | if (sConfigInjected->AutoInjectedConv == ENABLE) |
1126 | |
| 1127 | { |
1127 | tmp_hal_status = HAL_ERROR; |
| 1128 | if (sConfigInjected->ExternalTrigInjecConv == ADC_INJECTED_SOFTWARE_START) |
1128 | } |
| 1129 | { |
1129 | } |
| 1130 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO); |
1130 | |
| 1131 | } |
1131 | /* Injected discontinuous can be enabled only if auto-injected mode is */ |
| 1132 | else |
1132 | /* disabled. */ |
| 1133 | { |
1133 | if (sConfigInjected->InjectedDiscontinuousConvMode == ENABLE) |
| 1134 | /* Update ADC state machine to error */ |
1134 | { |
| 1135 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
1135 | if (sConfigInjected->AutoInjectedConv == DISABLE) |
| 1136 | 1136 | { |
|
| 1137 | tmp_hal_status = HAL_ERROR; |
1137 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JDISCEN); |
| 1138 | } |
1138 | } |
| 1139 | } |
1139 | else |
| 1140 | 1140 | { |
|
| 1141 | /* Injected discontinuous can be enabled only if auto-injected mode is */ |
1141 | /* Update ADC state machine to error */ |
| 1142 | /* disabled. */ |
1142 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 1143 | if (sConfigInjected->InjectedDiscontinuousConvMode == ENABLE) |
1143 | |
| 1144 | { |
1144 | tmp_hal_status = HAL_ERROR; |
| 1145 | if (sConfigInjected->AutoInjectedConv == DISABLE) |
1145 | } |
| 1146 | { |
1146 | } |
| 1147 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JDISCEN); |
1147 | |
| 1148 | } |
1148 | |
| 1149 | else |
1149 | /* InjectedChannel sampling time configuration */ |
| 1150 | { |
1150 | /* For channels 10 to 17 */ |
| 1151 | /* Update ADC state machine to error */ |
1151 | if (sConfigInjected->InjectedChannel >= ADC_CHANNEL_10) |
| 1152 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
1152 | { |
| 1153 | 1153 | MODIFY_REG(hadc->Instance->SMPR1 , |
|
| 1154 | tmp_hal_status = HAL_ERROR; |
1154 | ADC_SMPR1(ADC_SMPR1_SMP10, sConfigInjected->InjectedChannel) , |
| 1155 | } |
1155 | ADC_SMPR1(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
| 1156 | } |
1156 | } |
| 1157 | 1157 | else /* For channels 0 to 9 */ |
|
| 1158 | 1158 | { |
|
| 1159 | /* InjectedChannel sampling time configuration */ |
1159 | MODIFY_REG(hadc->Instance->SMPR2 , |
| 1160 | /* For channels 10 to 17 */ |
1160 | ADC_SMPR2(ADC_SMPR2_SMP0, sConfigInjected->InjectedChannel) , |
| 1161 | if (sConfigInjected->InjectedChannel >= ADC_CHANNEL_10) |
1161 | ADC_SMPR2(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
| 1162 | { |
1162 | } |
| 1163 | MODIFY_REG(hadc->Instance->SMPR1 , |
1163 | |
| 1164 | ADC_SMPR1(ADC_SMPR1_SMP10, sConfigInjected->InjectedChannel) , |
1164 | /* If ADC1 InjectedChannel_16 or InjectedChannel_17 is selected, enable Temperature sensor */ |
| 1165 | ADC_SMPR1(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
1165 | /* and VREFINT measurement path. */ |
| 1166 | } |
1166 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
| 1167 | else /* For channels 0 to 9 */ |
1167 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
| 1168 | { |
1168 | { |
| 1169 | MODIFY_REG(hadc->Instance->SMPR2 , |
1169 | SET_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE); |
| 1170 | ADC_SMPR2(ADC_SMPR2_SMP0, sConfigInjected->InjectedChannel) , |
1170 | } |
| 1171 | ADC_SMPR2(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
1171 | |
| 1172 | } |
1172 | |
| 1173 | 1173 | /* Configure the offset: offset enable/disable, InjectedChannel, offset value */ |
|
| 1174 | /* If ADC1 InjectedChannel_16 or InjectedChannel_17 is selected, enable Temperature sensor */ |
1174 | switch(sConfigInjected->InjectedRank) |
| 1175 | /* and VREFINT measurement path. */ |
1175 | { |
| 1176 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
1176 | case 1: |
| 1177 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
1177 | /* Set injected channel 1 offset */ |
| 1178 | { |
1178 | MODIFY_REG(hadc->Instance->JOFR1, |
| 1179 | SET_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE); |
1179 | ADC_JOFR1_JOFFSET1, |
| 1180 | } |
1180 | sConfigInjected->InjectedOffset); |
| 1181 | 1181 | break; |
|
| 1182 | 1182 | case 2: |
|
| 1183 | /* Configure the offset: offset enable/disable, InjectedChannel, offset value */ |
1183 | /* Set injected channel 2 offset */ |
| 1184 | switch(sConfigInjected->InjectedRank) |
1184 | MODIFY_REG(hadc->Instance->JOFR2, |
| 1185 | { |
1185 | ADC_JOFR2_JOFFSET2, |
| 1186 | case 1: |
1186 | sConfigInjected->InjectedOffset); |
| 1187 | /* Set injected channel 1 offset */ |
1187 | break; |
| 1188 | MODIFY_REG(hadc->Instance->JOFR1, |
1188 | case 3: |
| 1189 | ADC_JOFR1_JOFFSET1, |
1189 | /* Set injected channel 3 offset */ |
| 1190 | sConfigInjected->InjectedOffset); |
1190 | MODIFY_REG(hadc->Instance->JOFR3, |
| 1191 | break; |
1191 | ADC_JOFR3_JOFFSET3, |
| 1192 | case 2: |
1192 | sConfigInjected->InjectedOffset); |
| 1193 | /* Set injected channel 2 offset */ |
1193 | break; |
| 1194 | MODIFY_REG(hadc->Instance->JOFR2, |
1194 | case 4: |
| 1195 | ADC_JOFR2_JOFFSET2, |
1195 | default: |
| 1196 | sConfigInjected->InjectedOffset); |
1196 | MODIFY_REG(hadc->Instance->JOFR4, |
| 1197 | break; |
1197 | ADC_JOFR4_JOFFSET4, |
| 1198 | case 3: |
1198 | sConfigInjected->InjectedOffset); |
| 1199 | /* Set injected channel 3 offset */ |
1199 | break; |
| 1200 | MODIFY_REG(hadc->Instance->JOFR3, |
1200 | } |
| 1201 | ADC_JOFR3_JOFFSET3, |
1201 | |
| 1202 | sConfigInjected->InjectedOffset); |
1202 | /* If ADC1 Channel_16 or Channel_17 is selected, enable Temperature sensor */ |
| 1203 | break; |
1203 | /* and VREFINT measurement path. */ |
| 1204 | case 4: |
1204 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
| 1205 | default: |
1205 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
| 1206 | MODIFY_REG(hadc->Instance->JOFR4, |
1206 | { |
| 1207 | ADC_JOFR4_JOFFSET4, |
1207 | /* For STM32F1 devices with several ADC: Only ADC1 can access internal */ |
| 1208 | sConfigInjected->InjectedOffset); |
1208 | /* measurement channels (VrefInt/TempSensor). If these channels are */ |
| 1209 | break; |
1209 | /* intended to be set on other ADC instances, an error is reported. */ |
| 1210 | } |
1210 | if (hadc->Instance == ADC1) |
| 1211 | 1211 | { |
|
| 1212 | /* If ADC1 Channel_16 or Channel_17 is selected, enable Temperature sensor */ |
1212 | if (READ_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE) == RESET) |
| 1213 | /* and VREFINT measurement path. */ |
1213 | { |
| 1214 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
1214 | SET_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE); |
| 1215 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
1215 | |
| 1216 | { |
1216 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR)) |
| 1217 | /* For STM32F1 devices with several ADC: Only ADC1 can access internal */ |
1217 | { |
| 1218 | /* measurement channels (VrefInt/TempSensor). If these channels are */ |
1218 | /* Delay for temperature sensor stabilization time */ |
| 1219 | /* intended to be set on other ADC instances, an error is reported. */ |
1219 | /* Compute number of CPU cycles to wait for */ |
| 1220 | if (hadc->Instance == ADC1) |
1220 | wait_loop_index = (ADC_TEMPSENSOR_DELAY_US * (SystemCoreClock / 1000000U)); |
| 1221 | { |
1221 | while(wait_loop_index != 0U) |
| 1222 | if (READ_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE) == RESET) |
1222 | { |
| 1223 | { |
1223 | wait_loop_index--; |
| 1224 | SET_BIT(hadc->Instance->CR2, ADC_CR2_TSVREFE); |
1224 | } |
| 1225 | 1225 | } |
|
| 1226 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR)) |
1226 | } |
| 1227 | { |
1227 | } |
| 1228 | /* Delay for temperature sensor stabilization time */ |
1228 | else |
| 1229 | /* Compute number of CPU cycles to wait for */ |
1229 | { |
| 1230 | wait_loop_index = (ADC_TEMPSENSOR_DELAY_US * (SystemCoreClock / 1000000U)); |
1230 | /* Update ADC state machine to error */ |
| 1231 | while(wait_loop_index != 0U) |
1231 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 1232 | { |
1232 | |
| 1233 | wait_loop_index--; |
1233 | tmp_hal_status = HAL_ERROR; |
| 1234 | } |
1234 | } |
| 1235 | } |
1235 | } |
| 1236 | } |
1236 | |
| 1237 | } |
1237 | /* Process unlocked */ |
| 1238 | else |
1238 | __HAL_UNLOCK(hadc); |
| 1239 | { |
1239 | |
| 1240 | /* Update ADC state machine to error */ |
1240 | /* Return function status */ |
| 1241 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
1241 | return tmp_hal_status; |
| 1242 | 1242 | } |
|
| 1243 | tmp_hal_status = HAL_ERROR; |
1243 | |
| 1244 | } |
1244 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
| 1245 | } |
1245 | /** |
| 1246 | 1246 | * @brief Enable ADC multimode and configure multimode parameters |
|
| 1247 | /* Process unlocked */ |
1247 | * @note Possibility to update parameters on the fly: |
| 1248 | __HAL_UNLOCK(hadc); |
1248 | * This function initializes multimode parameters, following |
| 1249 | 1249 | * calls to this function can be used to reconfigure some parameters |
|
| 1250 | /* Return function status */ |
1250 | * of structure "ADC_MultiModeTypeDef" on the fly, without resetting |
| 1251 | return tmp_hal_status; |
1251 | * the ADCs (both ADCs of the common group). |
| 1252 | } |
1252 | * The setting of these parameters is conditioned to ADC state. |
| 1253 | 1253 | * For parameters constraints, see comments of structure |
|
| 1254 | #if defined (STM32F103x6) || defined (STM32F103xB) || defined (STM32F105xC) || defined (STM32F107xC) || defined (STM32F103xE) || defined (STM32F103xG) |
1254 | * "ADC_MultiModeTypeDef". |
| 1255 | /** |
1255 | * @note To change back configuration from multimode to single mode, ADC must |
| 1256 | * @brief Enable ADC multimode and configure multimode parameters |
1256 | * be reset (using function HAL_ADC_Init() ). |
| 1257 | * @note Possibility to update parameters on the fly: |
1257 | * @param hadc: ADC handle |
| 1258 | * This function initializes multimode parameters, following |
1258 | * @param multimode: Structure of ADC multimode configuration |
| 1259 | * calls to this function can be used to reconfigure some parameters |
1259 | * @retval HAL status |
| 1260 | * of structure "ADC_MultiModeTypeDef" on the fly, without reseting |
1260 | */ |
| 1261 | * the ADCs (both ADCs of the common group). |
1261 | HAL_StatusTypeDef HAL_ADCEx_MultiModeConfigChannel(ADC_HandleTypeDef* hadc, ADC_MultiModeTypeDef* multimode) |
| 1262 | * The setting of these parameters is conditioned to ADC state. |
1262 | { |
| 1263 | * For parameters constraints, see comments of structure |
1263 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 1264 | * "ADC_MultiModeTypeDef". |
1264 | ADC_HandleTypeDef tmphadcSlave={0}; |
| 1265 | * @note To change back configuration from multimode to single mode, ADC must |
1265 | |
| 1266 | * be reset (using function HAL_ADC_Init() ). |
1266 | /* Check the parameters */ |
| 1267 | * @param hadc: ADC handle |
1267 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
| 1268 | * @param multimode: Structure of ADC multimode configuration |
1268 | assert_param(IS_ADC_MODE(multimode->Mode)); |
| 1269 | * @retval HAL status |
1269 | |
| 1270 | */ |
1270 | /* Process locked */ |
| 1271 | HAL_StatusTypeDef HAL_ADCEx_MultiModeConfigChannel(ADC_HandleTypeDef* hadc, ADC_MultiModeTypeDef* multimode) |
1271 | __HAL_LOCK(hadc); |
| 1272 | { |
1272 | |
| 1273 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
1273 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
| 1274 | ADC_HandleTypeDef tmphadcSlave={0}; |
1274 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
| 1275 | 1275 | ||
| 1276 | /* Check the parameters */ |
1276 | /* Parameters update conditioned to ADC state: */ |
| 1277 | assert_param(IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)); |
1277 | /* Parameters that can be updated when ADC is disabled or enabled without */ |
| 1278 | assert_param(IS_ADC_MODE(multimode->Mode)); |
1278 | /* conversion on going on regular group: */ |
| 1279 | 1279 | /* - ADC master and ADC slave DMA configuration */ |
|
| 1280 | /* Process locked */ |
1280 | /* Parameters that can be updated only when ADC is disabled: */ |
| 1281 | __HAL_LOCK(hadc); |
1281 | /* - Multimode mode selection */ |
| 1282 | 1282 | /* To optimize code, all multimode settings can be set when both ADCs of */ |
|
| 1283 | /* Set a temporary handle of the ADC slave associated to the ADC master */ |
1283 | /* the common group are in state: disabled. */ |
| 1284 | ADC_MULTI_SLAVE(hadc, &tmphadcSlave); |
1284 | if ((ADC_IS_ENABLE(hadc) == RESET) && |
| 1285 | 1285 | (ADC_IS_ENABLE(&tmphadcSlave) == RESET) && |
|
| 1286 | /* Parameters update conditioned to ADC state: */ |
1286 | (IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)) ) |
| 1287 | /* Parameters that can be updated when ADC is disabled or enabled without */ |
1287 | { |
| 1288 | /* conversion on going on regular group: */ |
1288 | MODIFY_REG(hadc->Instance->CR1, |
| 1289 | /* - ADC master and ADC slave DMA configuration */ |
1289 | ADC_CR1_DUALMOD , |
| 1290 | /* Parameters that can be updated only when ADC is disabled: */ |
1290 | multimode->Mode ); |
| 1291 | /* - Multimode mode selection */ |
1291 | } |
| 1292 | /* To optimize code, all multimode settings can be set when both ADCs of */ |
1292 | /* If one of the ADC sharing the same common group is enabled, no update */ |
| 1293 | /* the common group are in state: disabled. */ |
1293 | /* could be done on neither of the multimode structure parameters. */ |
| 1294 | if ((ADC_IS_ENABLE(hadc) == RESET) && |
1294 | else |
| 1295 | (ADC_IS_ENABLE(&tmphadcSlave) == RESET) && |
1295 | { |
| 1296 | (IS_ADC_MULTIMODE_MASTER_INSTANCE(hadc->Instance)) ) |
1296 | /* Update ADC state machine to error */ |
| 1297 | { |
1297 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 1298 | MODIFY_REG(hadc->Instance->CR1, |
1298 | |
| 1299 | ADC_CR1_DUALMOD , |
1299 | tmp_hal_status = HAL_ERROR; |
| 1300 | multimode->Mode ); |
1300 | } |
| 1301 | } |
1301 | |
| 1302 | /* If one of the ADC sharing the same common group is enabled, no update */ |
1302 | |
| 1303 | /* could be done on neither of the multimode structure parameters. */ |
1303 | /* Process unlocked */ |
| 1304 | else |
1304 | __HAL_UNLOCK(hadc); |
| 1305 | { |
1305 | |
| 1306 | /* Update ADC state machine to error */ |
1306 | /* Return function status */ |
| 1307 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
1307 | return tmp_hal_status; |
| 1308 | 1308 | } |
|
| 1309 | tmp_hal_status = HAL_ERROR; |
1309 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
| 1310 | } |
1310 | /** |
| 1311 | 1311 | * @} |
|
| 1312 | 1312 | */ |
|
| 1313 | /* Process unlocked */ |
1313 | |
| 1314 | __HAL_UNLOCK(hadc); |
1314 | /** |
| 1315 | 1315 | * @} |
|
| 1316 | /* Return function status */ |
1316 | */ |
| 1317 | return tmp_hal_status; |
1317 | |
| 1318 | } |
1318 | #endif /* HAL_ADC_MODULE_ENABLED */ |
| 1319 | #endif /* defined STM32F103x6 || defined STM32F103xB || defined STM32F105xC || defined STM32F107xC || defined STM32F103xE || defined STM32F103xG */ |
1319 | /** |
| 1320 | /** |
1320 | * @} |
| 1321 | * @} |
1321 | */ |
| 1322 | */ |
1322 | |
| 1323 | 1323 | /** |
|
| 1324 | /** |
1324 | * @} |
| 1325 | * @} |
1325 | */ |
| 1326 | */ |
- | |
| 1327 | - | ||
| 1328 | #endif /* HAL_ADC_MODULE_ENABLED */ |
- | |
| 1329 | /** |
- | |
| 1330 | * @} |
- | |
| 1331 | */ |
- | |
| 1332 | - | ||
| 1333 | /** |
- | |
| 1334 | * @} |
- | |
| 1335 | */ |
- | |
| 1336 | - | ||
| 1337 | /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |
- | |