Rev 61 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 61 | Rev 77 | ||
|---|---|---|---|
| Line 1... | Line 1... | ||
| 1 | /** |
1 | /** |
| 2 | ****************************************************************************** |
2 | ****************************************************************************** |
| 3 | * @file stm32l1xx_hal_adc_ex.c |
3 | * @file stm32l1xx_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 | * "stm32l1xx_hal_adc.c". |
| 11 | * + Control functions |
11 | * |
| 12 | * ++ Channels configuration on injected group |
12 | @verbatim |
| 13 | * Other functions (generic functions) are available in file |
13 | [..] |
| 14 | * "stm32l1xx_hal_adc.c". |
14 | (@) Sections "ADC peripheral features" and "How to use this driver" are |
| 15 | * |
15 | available in file of generic functions "stm32l1xx_hal_adc.c". |
| 16 | @verbatim |
16 | [..] |
| 17 | [..] |
17 | @endverbatim |
| 18 | (@) Sections "ADC peripheral features" and "How to use this driver" are |
18 | ****************************************************************************** |
| 19 | available in file of generic functions "stm32l1xx_hal_adc.c". |
19 | * @attention |
| 20 | [..] |
20 | * |
| 21 | @endverbatim |
21 | * Copyright (c) 2017 STMicroelectronics. |
| 22 | ****************************************************************************** |
22 | * All rights reserved. |
| 23 | * @attention |
23 | * |
| 24 | * |
24 | * This software is licensed under terms that can be found in the LICENSE file |
| 25 | * <h2><center>© Copyright (c) 2017 STMicroelectronics. |
25 | * in the root directory of this software component. |
| 26 | * All rights reserved.</center></h2> |
26 | * If no LICENSE file comes with this software, it is provided AS-IS. |
| 27 | * |
27 | * |
| 28 | * This software component is licensed by ST under BSD 3-Clause license, |
28 | ****************************************************************************** |
| 29 | * the "License"; You may not use this file except in compliance with the |
29 | */ |
| 30 | * License. You may obtain a copy of the License at: |
30 | |
| 31 | * opensource.org/licenses/BSD-3-Clause |
31 | /* Includes ------------------------------------------------------------------*/ |
| 32 | * |
32 | #include "stm32l1xx_hal.h" |
| 33 | ****************************************************************************** |
33 | |
| 34 | */ |
34 | /** @addtogroup STM32L1xx_HAL_Driver |
| 35 | 35 | * @{ |
|
| 36 | /* Includes ------------------------------------------------------------------*/ |
36 | */ |
| 37 | #include "stm32l1xx_hal.h" |
37 | |
| 38 | 38 | /** @defgroup ADCEx ADCEx |
|
| 39 | /** @addtogroup STM32L1xx_HAL_Driver |
39 | * @brief ADC Extension HAL module driver |
| 40 | * @{ |
40 | * @{ |
| 41 | */ |
41 | */ |
| 42 | 42 | ||
| 43 | /** @defgroup ADCEx ADCEx |
43 | #ifdef HAL_ADC_MODULE_ENABLED |
| 44 | * @brief ADC Extension HAL module driver |
44 | |
| 45 | * @{ |
45 | /* Private typedef -----------------------------------------------------------*/ |
| 46 | */ |
46 | /* Private define ------------------------------------------------------------*/ |
| 47 | 47 | /** @defgroup ADCEx_Private_Constants ADCEx Private Constants |
|
| 48 | #ifdef HAL_ADC_MODULE_ENABLED |
48 | * @{ |
| 49 | 49 | */ |
|
| 50 | /* Private typedef -----------------------------------------------------------*/ |
50 | |
| 51 | /* Private define ------------------------------------------------------------*/ |
51 | /* ADC conversion cycles (unit: ADC clock cycles) */ |
| 52 | /** @defgroup ADCEx_Private_Constants ADCEx Private Constants |
52 | /* (selected sampling time + conversion time of 12 ADC clock cycles, with */ |
| 53 | * @{ |
53 | /* resolution 12 bits) */ |
| 54 | */ |
54 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_4CYCLE5 ( 16U) |
| 55 | 55 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_9CYCLES ( 21U) |
|
| 56 | /* ADC conversion cycles (unit: ADC clock cycles) */ |
56 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_16CYCLES ( 28U) |
| 57 | /* (selected sampling time + conversion time of 12 ADC clock cycles, with */ |
57 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_24CYCLES ( 36U) |
| 58 | /* resolution 12 bits) */ |
58 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_48CYCLES ( 60U) |
| 59 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_4CYCLE5 ( 16U) |
59 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_96CYCLES (108U) |
| 60 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_9CYCLES ( 21U) |
60 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_192CYCLES (204U) |
| 61 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_16CYCLES ( 28U) |
61 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_384CYCLES (396U) |
| 62 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_24CYCLES ( 36U) |
62 | |
| 63 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_48CYCLES ( 60U) |
63 | /* Delay for temperature sensor stabilization time. */ |
| 64 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_96CYCLES (108U) |
64 | /* Maximum delay is 10us (refer to device datasheet, parameter tSTART). */ |
| 65 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_192CYCLES (204U) |
65 | /* Unit: us */ |
| 66 | #define ADC_CONVERSIONCLOCKCYCLES_SAMPLETIME_384CYCLES (396U) |
66 | #define ADC_TEMPSENSOR_DELAY_US (10U) |
| 67 | 67 | ||
| 68 | /* Delay for temperature sensor stabilization time. */ |
68 | /** |
| 69 | /* Maximum delay is 10us (refer to device datasheet, parameter tSTART). */ |
69 | * @} |
| 70 | /* Unit: us */ |
70 | */ |
| 71 | #define ADC_TEMPSENSOR_DELAY_US (10U) |
71 | |
| 72 | 72 | /* Private macro -------------------------------------------------------------*/ |
|
| 73 | /** |
73 | /* Private variables ---------------------------------------------------------*/ |
| 74 | * @} |
74 | /* Private function prototypes -----------------------------------------------*/ |
| 75 | */ |
75 | /* Private functions ---------------------------------------------------------*/ |
| 76 | 76 | ||
| 77 | /* Private macro -------------------------------------------------------------*/ |
77 | /** @defgroup ADCEx_Exported_Functions ADCEx Exported Functions |
| 78 | /* Private variables ---------------------------------------------------------*/ |
78 | * @{ |
| 79 | /* Private function prototypes -----------------------------------------------*/ |
79 | */ |
| 80 | /* Private functions ---------------------------------------------------------*/ |
80 | |
| 81 | 81 | /** @defgroup ADCEx_Exported_Functions_Group1 ADC Extended IO operation functions |
|
| 82 | /** @defgroup ADCEx_Exported_Functions ADCEx Exported Functions |
82 | * @brief ADC Extended Input and Output operation functions |
| 83 | * @{ |
83 | * |
| 84 | */ |
84 | @verbatim |
| 85 | 85 | =============================================================================== |
|
| 86 | /** @defgroup ADCEx_Exported_Functions_Group1 ADC Extended IO operation functions |
86 | ##### IO operation functions ##### |
| 87 | * @brief ADC Extended Input and Output operation functions |
87 | =============================================================================== |
| 88 | * |
88 | [..] This section provides functions allowing to: |
| 89 | @verbatim |
89 | (+) Start conversion of injected group. |
| 90 | =============================================================================== |
90 | (+) Stop conversion of injected group. |
| 91 | ##### IO operation functions ##### |
91 | (+) Poll for conversion complete on injected group. |
| 92 | =============================================================================== |
92 | (+) Get result of injected channel conversion. |
| 93 | [..] This section provides functions allowing to: |
93 | (+) Start conversion of injected group and enable interruptions. |
| 94 | (+) Start conversion of injected group. |
94 | (+) Stop conversion of injected group and disable interruptions. |
| 95 | (+) Stop conversion of injected group. |
95 | |
| 96 | (+) Poll for conversion complete on injected group. |
96 | @endverbatim |
| 97 | (+) Get result of injected channel conversion. |
97 | * @{ |
| 98 | (+) Start conversion of injected group and enable interruptions. |
98 | */ |
| 99 | (+) Stop conversion of injected group and disable interruptions. |
99 | |
| 100 | |
100 | /** |
| 101 | @endverbatim |
101 | * @brief Enables ADC, starts conversion of injected group. |
| 102 | * @{ |
102 | * Interruptions enabled in this function: None. |
| 103 | */ |
103 | * @param hadc ADC handle |
| 104 | 104 | * @retval HAL status |
|
| 105 | /** |
105 | */ |
| 106 | * @brief Enables ADC, starts conversion of injected group. |
106 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc) |
| 107 | * Interruptions enabled in this function: None. |
107 | { |
| 108 | * @param hadc ADC handle |
108 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 109 | * @retval HAL status |
109 | |
| 110 | */ |
110 | /* Check the parameters */ |
| 111 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc) |
111 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 112 | { |
112 | |
| 113 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
113 | /* Process locked */ |
| 114 | 114 | __HAL_LOCK(hadc); |
|
| 115 | /* Check the parameters */ |
115 | |
| 116 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
116 | /* Enable the ADC peripheral */ |
| 117 | 117 | tmp_hal_status = ADC_Enable(hadc); |
|
| 118 | /* Process locked */ |
118 | |
| 119 | __HAL_LOCK(hadc); |
119 | /* Start conversion if ADC is effectively enabled */ |
| 120 | 120 | if (tmp_hal_status == HAL_OK) |
|
| 121 | /* Enable the ADC peripheral */ |
121 | { |
| 122 | tmp_hal_status = ADC_Enable(hadc); |
122 | /* Set ADC state */ |
| 123 | 123 | /* - Clear state bitfield related to injected group conversion results */ |
|
| 124 | /* Start conversion if ADC is effectively enabled */ |
124 | /* - Set state bitfield related to injected operation */ |
| 125 | if (tmp_hal_status == HAL_OK) |
125 | ADC_STATE_CLR_SET(hadc->State, |
| 126 | { |
126 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
| 127 | /* Set ADC state */ |
127 | HAL_ADC_STATE_INJ_BUSY); |
| 128 | /* - Clear state bitfield related to injected group conversion results */ |
128 | |
| 129 | /* - Set state bitfield related to injected operation */ |
129 | /* Check if a regular conversion is ongoing */ |
| 130 | ADC_STATE_CLR_SET(hadc->State, |
130 | /* Note: On this device, there is no ADC error code fields related to */ |
| 131 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
131 | /* conversions on group injected only. In case of conversion on */ |
| 132 | HAL_ADC_STATE_INJ_BUSY); |
132 | /* going on group regular, no error code is reset. */ |
| 133 | 133 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
|
| 134 | /* Check if a regular conversion is ongoing */ |
134 | { |
| 135 | /* Note: On this device, there is no ADC error code fields related to */ |
135 | /* Reset ADC all error code fields */ |
| 136 | /* conversions on group injected only. In case of conversion on */ |
136 | ADC_CLEAR_ERRORCODE(hadc); |
| 137 | /* going on group regular, no error code is reset. */ |
137 | } |
| 138 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
138 | |
| 139 | { |
139 | /* Process unlocked */ |
| 140 | /* Reset ADC all error code fields */ |
140 | /* Unlock before starting ADC conversions: in case of potential */ |
| 141 | ADC_CLEAR_ERRORCODE(hadc); |
141 | /* interruption, to let the process to ADC IRQ Handler. */ |
| 142 | } |
142 | __HAL_UNLOCK(hadc); |
| 143 | 143 | ||
| 144 | /* Process unlocked */ |
144 | /* Clear injected group conversion flag */ |
| 145 | /* Unlock before starting ADC conversions: in case of potential */ |
145 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
| 146 | /* interruption, to let the process to ADC IRQ Handler. */ |
146 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
| 147 | __HAL_UNLOCK(hadc); |
147 | |
| 148 | 148 | /* Enable conversion of injected group. */ |
|
| 149 | /* Clear injected group conversion flag */ |
149 | /* If software start has been selected, conversion starts immediately. */ |
| 150 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
150 | /* If external trigger has been selected, conversion will start at next */ |
| 151 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
151 | /* trigger event. */ |
| 152 | 152 | /* If automatic injected conversion is enabled, conversion will start */ |
|
| 153 | /* Enable conversion of injected group. */ |
153 | /* after next regular group conversion. */ |
| 154 | /* If software start has been selected, conversion starts immediately. */ |
154 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
| 155 | /* If external trigger has been selected, conversion will start at next */ |
155 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 156 | /* trigger event. */ |
156 | { |
| 157 | /* If automatic injected conversion is enabled, conversion will start */ |
157 | /* Enable ADC software conversion for injected channels */ |
| 158 | /* after next regular group conversion. */ |
158 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JSWSTART); |
| 159 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
159 | } |
| 160 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
160 | } |
| 161 | { |
161 | |
| 162 | /* Enable ADC software conversion for injected channels */ |
162 | /* Return function status */ |
| 163 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JSWSTART); |
163 | return tmp_hal_status; |
| 164 | } |
164 | } |
| 165 | } |
165 | |
| 166 | 166 | /** |
|
| 167 | /* Return function status */ |
167 | * @brief Stop conversion of injected channels. Disable ADC peripheral if |
| 168 | return tmp_hal_status; |
168 | * no regular conversion is on going. |
| 169 | } |
169 | * @note If ADC must be disabled and if conversion is on going on |
| 170 | 170 | * regular group, function HAL_ADC_Stop must be used to stop both |
|
| 171 | /** |
171 | * injected and regular groups, and disable the ADC. |
| 172 | * @brief Stop conversion of injected channels. Disable ADC peripheral if |
172 | * @note If injected group mode auto-injection is enabled, |
| 173 | * no regular conversion is on going. |
173 | * function HAL_ADC_Stop must be used. |
| 174 | * @note If ADC must be disabled and if conversion is on going on |
174 | * @note In case of auto-injection mode, HAL_ADC_Stop must be used. |
| 175 | * regular group, function HAL_ADC_Stop must be used to stop both |
175 | * @param hadc ADC handle |
| 176 | * injected and regular groups, and disable the ADC. |
176 | * @retval None |
| 177 | * @note If injected group mode auto-injection is enabled, |
177 | */ |
| 178 | * function HAL_ADC_Stop must be used. |
178 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc) |
| 179 | * @note In case of auto-injection mode, HAL_ADC_Stop must be used. |
179 | { |
| 180 | * @param hadc ADC handle |
180 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 181 | * @retval None |
181 | |
| 182 | */ |
182 | /* Check the parameters */ |
| 183 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc) |
183 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 184 | { |
184 | |
| 185 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
185 | /* Process locked */ |
| 186 | 186 | __HAL_LOCK(hadc); |
|
| 187 | /* Check the parameters */ |
187 | |
| 188 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
188 | /* Stop potential conversion and disable ADC peripheral */ |
| 189 | 189 | /* Conditioned to: */ |
|
| 190 | /* Process locked */ |
190 | /* - No conversion on the other group (regular group) is intended to */ |
| 191 | __HAL_LOCK(hadc); |
191 | /* continue (injected and regular groups stop conversion and ADC disable */ |
| 192 | 192 | /* are common) */ |
|
| 193 | /* Stop potential conversion and disable ADC peripheral */ |
193 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
| 194 | /* Conditioned to: */ |
194 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
| 195 | /* - No conversion on the other group (regular group) is intended to */ |
195 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 196 | /* continue (injected and regular groups stop conversion and ADC disable */ |
196 | { |
| 197 | /* are common) */ |
197 | /* Stop potential conversion on going, on regular and injected groups */ |
| 198 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
198 | /* Disable ADC peripheral */ |
| 199 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
199 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 200 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
200 | |
| 201 | { |
201 | /* Check if ADC is effectively disabled */ |
| 202 | /* Stop potential conversion on going, on regular and injected groups */ |
202 | if (tmp_hal_status == HAL_OK) |
| 203 | /* Disable ADC peripheral */ |
203 | { |
| 204 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
204 | /* Set ADC state */ |
| 205 | 205 | ADC_STATE_CLR_SET(hadc->State, |
|
| 206 | /* Check if ADC is effectively disabled */ |
206 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
| 207 | if (tmp_hal_status == HAL_OK) |
207 | HAL_ADC_STATE_READY); |
| 208 | { |
208 | } |
| 209 | /* Set ADC state */ |
209 | } |
| 210 | ADC_STATE_CLR_SET(hadc->State, |
210 | else |
| 211 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
211 | { |
| 212 | HAL_ADC_STATE_READY); |
212 | /* Update ADC state machine to error */ |
| 213 | } |
213 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 214 | } |
214 | |
| 215 | else |
215 | tmp_hal_status = HAL_ERROR; |
| 216 | { |
216 | } |
| 217 | /* Update ADC state machine to error */ |
217 | |
| 218 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
218 | /* Process unlocked */ |
| 219 | 219 | __HAL_UNLOCK(hadc); |
|
| 220 | tmp_hal_status = HAL_ERROR; |
220 | |
| 221 | } |
221 | /* Return function status */ |
| 222 | 222 | return tmp_hal_status; |
|
| 223 | /* Process unlocked */ |
223 | } |
| 224 | __HAL_UNLOCK(hadc); |
224 | |
| 225 | 225 | /** |
|
| 226 | /* Return function status */ |
226 | * @brief Wait for injected group conversion to be completed. |
| 227 | return tmp_hal_status; |
227 | * @param hadc ADC handle |
| 228 | } |
228 | * @param Timeout Timeout value in millisecond. |
| 229 | 229 | * @retval HAL status |
|
| 230 | /** |
230 | */ |
| 231 | * @brief Wait for injected group conversion to be completed. |
231 | HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout) |
| 232 | * @param hadc ADC handle |
232 | { |
| 233 | * @param Timeout Timeout value in millisecond. |
233 | uint32_t tickstart; |
| 234 | * @retval HAL status |
234 | |
| 235 | */ |
235 | /* Variables for polling in case of scan mode enabled and polling for each */ |
| 236 | HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout) |
236 | /* conversion. */ |
| 237 | { |
237 | /* Note: Variable "conversion_timeout_cpu_cycles" set to offset 28 CPU */ |
| 238 | uint32_t tickstart; |
238 | /* cycles to compensate number of CPU cycles for processing of variable */ |
| 239 | 239 | /* "conversion_timeout_cpu_cycles_max" */ |
|
| 240 | /* Variables for polling in case of scan mode enabled and polling for each */ |
240 | uint32_t conversion_timeout_cpu_cycles = 28; |
| 241 | /* conversion. */ |
241 | uint32_t conversion_timeout_cpu_cycles_max = 0; |
| 242 | /* Note: Variable "conversion_timeout_cpu_cycles" set to offset 28 CPU */ |
242 | |
| 243 | /* cycles to compensate number of CPU cycles for processing of variable */ |
243 | /* Check the parameters */ |
| 244 | /* "conversion_timeout_cpu_cycles_max" */ |
244 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 245 | uint32_t conversion_timeout_cpu_cycles = 28; |
245 | |
| 246 | uint32_t conversion_timeout_cpu_cycles_max = 0; |
246 | /* Get timeout */ |
| 247 | 247 | tickstart = HAL_GetTick(); |
|
| 248 | /* Check the parameters */ |
248 | |
| 249 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
249 | /* Polling for end of conversion: differentiation if single/sequence */ |
| 250 | 250 | /* conversion. */ |
|
| 251 | /* Get timeout */ |
251 | /* For injected group, flag JEOC is set only at the end of the sequence, */ |
| 252 | tickstart = HAL_GetTick(); |
252 | /* not for each conversion within the sequence. */ |
| 253 | 253 | /* If setting "EOCSelection" is set to poll for each single conversion, */ |
|
| 254 | /* Polling for end of conversion: differentiation if single/sequence */ |
254 | /* management of polling depends on setting of injected group sequencer: */ |
| 255 | /* conversion. */ |
255 | /* - If single conversion for injected group (scan mode disabled or */ |
| 256 | /* For injected group, flag JEOC is set only at the end of the sequence, */ |
256 | /* InjectedNbrOfConversion ==1), flag JEOC is used to determine the */ |
| 257 | /* not for each conversion within the sequence. */ |
257 | /* conversion completion. */ |
| 258 | /* If setting "EOCSelection" is set to poll for each single conversion, */ |
258 | /* - If sequence conversion for injected group (scan mode enabled and */ |
| 259 | /* management of polling depends on setting of injected group sequencer: */ |
259 | /* InjectedNbrOfConversion >=2), flag JEOC is set only at the end of the */ |
| 260 | /* - If single conversion for injected group (scan mode disabled or */ |
260 | /* sequence. */ |
| 261 | /* InjectedNbrOfConversion ==1), flag JEOC is used to determine the */ |
261 | /* To poll for each conversion, the maximum conversion time is computed */ |
| 262 | /* conversion completion. */ |
262 | /* from ADC conversion time (selected sampling time + conversion time of */ |
| 263 | /* - If sequence conversion for injected group (scan mode enabled and */ |
263 | /* 12 ADC clock cycles) and APB2/ADC clock prescalers (depending on */ |
| 264 | /* InjectedNbrOfConversion >=2), flag JEOC is set only at the end of the */ |
264 | /* settings, conversion time range can vary from 8 to several thousands */ |
| 265 | /* sequence. */ |
265 | /* of CPU cycles). */ |
| 266 | /* To poll for each conversion, the maximum conversion time is computed */ |
266 | |
| 267 | /* from ADC conversion time (selected sampling time + conversion time of */ |
267 | /* Note: On STM32L1, setting "EOCSelection" is related to regular group */ |
| 268 | /* 12 ADC clock cycles) and APB2/ADC clock prescalers (depending on */ |
268 | /* only, by hardware. For compatibility with other STM32 devices, */ |
| 269 | /* settings, conversion time range can vary from 8 to several thousands */ |
269 | /* this setting is related also to injected group by software. */ |
| 270 | /* of CPU cycles). */ |
270 | if (((hadc->Instance->JSQR & ADC_JSQR_JL) == RESET) || |
| 271 | 271 | (hadc->Init.EOCSelection != ADC_EOC_SINGLE_CONV) ) |
|
| 272 | /* Note: On STM32L1, setting "EOCSelection" is related to regular group */ |
272 | { |
| 273 | /* only, by hardware. For compatibility with other STM32 devices, */ |
273 | /* Wait until End of Conversion flag is raised */ |
| 274 | /* this setting is related also to injected group by software. */ |
274 | while(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
| 275 | if (((hadc->Instance->JSQR & ADC_JSQR_JL) == RESET) || |
275 | { |
| 276 | (hadc->Init.EOCSelection != ADC_EOC_SINGLE_CONV) ) |
276 | /* Check if timeout is disabled (set to infinite wait) */ |
| 277 | { |
277 | if(Timeout != HAL_MAX_DELAY) |
| 278 | /* Wait until End of Conversion flag is raised */ |
278 | { |
| 279 | while(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
279 | if((Timeout == 0) || ((HAL_GetTick() - tickstart ) > Timeout)) |
| 280 | { |
280 | { |
| 281 | /* Check if timeout is disabled (set to infinite wait) */ |
281 | /* New check to avoid false timeout detection in case of preemption */ |
| 282 | if(Timeout != HAL_MAX_DELAY) |
282 | if(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
| 283 | { |
283 | { |
| 284 | if((Timeout == 0) || ((HAL_GetTick() - tickstart ) > Timeout)) |
284 | /* Update ADC state machine to timeout */ |
| 285 | { |
285 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
| 286 | /* New check to avoid false timeout detection in case of preemption */ |
286 | |
| 287 | if(HAL_IS_BIT_CLR(hadc->Instance->SR, ADC_FLAG_JEOC)) |
287 | /* Process unlocked */ |
| 288 | { |
288 | __HAL_UNLOCK(hadc); |
| 289 | /* Update ADC state machine to timeout */ |
289 | |
| 290 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
290 | return HAL_TIMEOUT; |
| 291 | 291 | } |
|
| 292 | /* Process unlocked */ |
292 | } |
| 293 | __HAL_UNLOCK(hadc); |
293 | } |
| 294 | 294 | } |
|
| 295 | return HAL_TIMEOUT; |
295 | } |
| 296 | } |
296 | else |
| 297 | } |
297 | { |
| 298 | } |
298 | /* Computation of CPU cycles corresponding to ADC conversion cycles. */ |
| 299 | } |
299 | /* Retrieve ADC clock prescaler and ADC maximum conversion cycles on all */ |
| 300 | } |
300 | /* channels. */ |
| 301 | else |
301 | conversion_timeout_cpu_cycles_max = ADC_GET_CLOCK_PRESCALER_DECIMAL(hadc); |
| 302 | { |
302 | conversion_timeout_cpu_cycles_max *= ADC_CONVCYCLES_MAX_RANGE(hadc); |
| 303 | /* Computation of CPU cycles corresponding to ADC conversion cycles. */ |
303 | |
| 304 | /* Retrieve ADC clock prescaler and ADC maximum conversion cycles on all */ |
304 | /* Poll with maximum conversion time */ |
| 305 | /* channels. */ |
305 | while(conversion_timeout_cpu_cycles < conversion_timeout_cpu_cycles_max) |
| 306 | conversion_timeout_cpu_cycles_max = ADC_GET_CLOCK_PRESCALER_DECIMAL(hadc); |
306 | { |
| 307 | conversion_timeout_cpu_cycles_max *= ADC_CONVCYCLES_MAX_RANGE(hadc); |
307 | /* Check if timeout is disabled (set to infinite wait) */ |
| 308 | 308 | if(Timeout != HAL_MAX_DELAY) |
|
| 309 | /* Poll with maximum conversion time */ |
309 | { |
| 310 | while(conversion_timeout_cpu_cycles < conversion_timeout_cpu_cycles_max) |
310 | if((Timeout == 0) || ((HAL_GetTick() - tickstart ) > Timeout)) |
| 311 | { |
311 | { |
| 312 | /* Check if timeout is disabled (set to infinite wait) */ |
312 | /* New check to avoid false timeout detection in case of preemption */ |
| 313 | if(Timeout != HAL_MAX_DELAY) |
313 | if(conversion_timeout_cpu_cycles < conversion_timeout_cpu_cycles_max) |
| 314 | { |
314 | { |
| 315 | if((Timeout == 0) || ((HAL_GetTick() - tickstart ) > Timeout)) |
315 | /* Update ADC state machine to timeout */ |
| 316 | { |
316 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
| 317 | /* New check to avoid false timeout detection in case of preemption */ |
317 | |
| 318 | if(conversion_timeout_cpu_cycles < conversion_timeout_cpu_cycles_max) |
318 | /* Process unlocked */ |
| 319 | { |
319 | __HAL_UNLOCK(hadc); |
| 320 | /* Update ADC state machine to timeout */ |
320 | |
| 321 | SET_BIT(hadc->State, HAL_ADC_STATE_TIMEOUT); |
321 | return HAL_TIMEOUT; |
| 322 | 322 | } |
|
| 323 | /* Process unlocked */ |
323 | } |
| 324 | __HAL_UNLOCK(hadc); |
324 | } |
| 325 | 325 | conversion_timeout_cpu_cycles ++; |
|
| 326 | return HAL_TIMEOUT; |
326 | } |
| 327 | } |
327 | } |
| 328 | } |
328 | |
| 329 | } |
329 | /* Clear end of conversion flag of injected group if low power feature */ |
| 330 | conversion_timeout_cpu_cycles ++; |
330 | /* "Auto Wait" is disabled, to not interfere with this feature until data */ |
| 331 | } |
331 | /* register is read using function HAL_ADCEx_InjectedGetValue(). */ |
| 332 | } |
332 | if (hadc->Init.LowPowerAutoWait == DISABLE) |
| 333 | 333 | { |
|
| 334 | /* Clear end of conversion flag of injected group if low power feature */ |
334 | /* Clear injected group conversion flag */ |
| 335 | /* "Auto Wait" is disabled, to not interfere with this feature until data */ |
335 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JSTRT | ADC_FLAG_JEOC); |
| 336 | /* register is read using function HAL_ADCEx_InjectedGetValue(). */ |
336 | } |
| 337 | if (hadc->Init.LowPowerAutoWait == DISABLE) |
337 | |
| 338 | { |
338 | /* Update ADC state machine */ |
| 339 | /* Clear injected group conversion flag */ |
339 | SET_BIT(hadc->State, HAL_ADC_STATE_INJ_EOC); |
| 340 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JSTRT | ADC_FLAG_JEOC); |
340 | |
| 341 | } |
341 | /* Determine whether any further conversion upcoming on group injected */ |
| 342 | 342 | /* by external trigger, continuous mode or scan sequence on going. */ |
|
| 343 | /* Update ADC state machine */ |
343 | /* Note: On STM32L1, there is no independent flag of end of sequence. */ |
| 344 | SET_BIT(hadc->State, HAL_ADC_STATE_INJ_EOC); |
344 | /* The test of scan sequence on going is done either with scan */ |
| 345 | 345 | /* sequence disabled or with end of conversion flag set to */ |
|
| 346 | /* Determine whether any further conversion upcoming on group injected */ |
346 | /* of end of sequence. */ |
| 347 | /* by external trigger, continuous mode or scan sequence on going. */ |
347 | if(ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
| 348 | /* Note: On STM32L1, there is no independent flag of end of sequence. */ |
348 | (HAL_IS_BIT_CLR(hadc->Instance->JSQR, ADC_JSQR_JL) || |
| 349 | /* The test of scan sequence on going is done either with scan */ |
349 | HAL_IS_BIT_CLR(hadc->Instance->CR2, ADC_CR2_EOCS) ) && |
| 350 | /* sequence disabled or with end of conversion flag set to */ |
350 | (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) && |
| 351 | /* of end of sequence. */ |
351 | (ADC_IS_SOFTWARE_START_REGULAR(hadc) && |
| 352 | if(ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
352 | (hadc->Init.ContinuousConvMode == DISABLE) ) ) ) |
| 353 | (HAL_IS_BIT_CLR(hadc->Instance->JSQR, ADC_JSQR_JL) || |
353 | { |
| 354 | HAL_IS_BIT_CLR(hadc->Instance->CR2, ADC_CR2_EOCS) ) && |
354 | /* Set ADC state */ |
| 355 | (HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) && |
355 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_INJ_BUSY); |
| 356 | (ADC_IS_SOFTWARE_START_REGULAR(hadc) && |
356 | |
| 357 | (hadc->Init.ContinuousConvMode == DISABLE) ) ) ) |
357 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
| 358 | { |
358 | { |
| 359 | /* Set ADC state */ |
359 | SET_BIT(hadc->State, HAL_ADC_STATE_READY); |
| 360 | CLEAR_BIT(hadc->State, HAL_ADC_STATE_INJ_BUSY); |
360 | } |
| 361 | 361 | } |
|
| 362 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
362 | |
| 363 | { |
363 | /* Return ADC state */ |
| 364 | SET_BIT(hadc->State, HAL_ADC_STATE_READY); |
364 | return HAL_OK; |
| 365 | } |
365 | } |
| 366 | } |
366 | |
| 367 | 367 | /** |
|
| 368 | /* Return ADC state */ |
368 | * @brief Enables ADC, starts conversion of injected group with interruption. |
| 369 | return HAL_OK; |
369 | * - JEOC (end of conversion of injected group) |
| 370 | } |
370 | * Each of these interruptions has its dedicated callback function. |
| 371 | 371 | * @param hadc ADC handle |
|
| 372 | /** |
372 | * @retval HAL status. |
| 373 | * @brief Enables ADC, starts conversion of injected group with interruption. |
373 | */ |
| 374 | * - JEOC (end of conversion of injected group) |
374 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc) |
| 375 | * Each of these interruptions has its dedicated callback function. |
375 | { |
| 376 | * @param hadc ADC handle |
376 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 377 | * @retval HAL status. |
377 | |
| 378 | */ |
378 | /* Check the parameters */ |
| 379 | HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc) |
379 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 380 | { |
380 | |
| 381 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
381 | /* Process locked */ |
| 382 | 382 | __HAL_LOCK(hadc); |
|
| 383 | /* Check the parameters */ |
383 | |
| 384 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
384 | /* Enable the ADC peripheral */ |
| 385 | 385 | tmp_hal_status = ADC_Enable(hadc); |
|
| 386 | /* Process locked */ |
386 | |
| 387 | __HAL_LOCK(hadc); |
387 | /* Start conversion if ADC is effectively enabled */ |
| 388 | 388 | if (tmp_hal_status == HAL_OK) |
|
| 389 | /* Enable the ADC peripheral */ |
389 | { |
| 390 | tmp_hal_status = ADC_Enable(hadc); |
390 | /* Set ADC state */ |
| 391 | 391 | /* - Clear state bitfield related to injected group conversion results */ |
|
| 392 | /* Start conversion if ADC is effectively enabled */ |
392 | /* - Set state bitfield related to injected operation */ |
| 393 | if (tmp_hal_status == HAL_OK) |
393 | ADC_STATE_CLR_SET(hadc->State, |
| 394 | { |
394 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
| 395 | /* Set ADC state */ |
395 | HAL_ADC_STATE_INJ_BUSY); |
| 396 | /* - Clear state bitfield related to injected group conversion results */ |
396 | |
| 397 | /* - Set state bitfield related to injected operation */ |
397 | /* Check if a regular conversion is ongoing */ |
| 398 | ADC_STATE_CLR_SET(hadc->State, |
398 | /* Note: On this device, there is no ADC error code fields related to */ |
| 399 | HAL_ADC_STATE_READY | HAL_ADC_STATE_INJ_EOC, |
399 | /* conversions on group injected only. In case of conversion on */ |
| 400 | HAL_ADC_STATE_INJ_BUSY); |
400 | /* going on group regular, no error code is reset. */ |
| 401 | 401 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
|
| 402 | /* Check if a regular conversion is ongoing */ |
402 | { |
| 403 | /* Note: On this device, there is no ADC error code fields related to */ |
403 | /* Reset ADC all error code fields */ |
| 404 | /* conversions on group injected only. In case of conversion on */ |
404 | ADC_CLEAR_ERRORCODE(hadc); |
| 405 | /* going on group regular, no error code is reset. */ |
405 | } |
| 406 | if (HAL_IS_BIT_CLR(hadc->State, HAL_ADC_STATE_REG_BUSY)) |
406 | |
| 407 | { |
407 | /* Process unlocked */ |
| 408 | /* Reset ADC all error code fields */ |
408 | /* Unlock before starting ADC conversions: in case of potential */ |
| 409 | ADC_CLEAR_ERRORCODE(hadc); |
409 | /* interruption, to let the process to ADC IRQ Handler. */ |
| 410 | } |
410 | __HAL_UNLOCK(hadc); |
| 411 | 411 | ||
| 412 | /* Process unlocked */ |
412 | /* Clear injected group conversion flag */ |
| 413 | /* Unlock before starting ADC conversions: in case of potential */ |
413 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
| 414 | /* interruption, to let the process to ADC IRQ Handler. */ |
414 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
| 415 | __HAL_UNLOCK(hadc); |
415 | |
| 416 | 416 | /* Enable end of conversion interrupt for injected channels */ |
|
| 417 | /* Clear injected group conversion flag */ |
417 | __HAL_ADC_ENABLE_IT(hadc, ADC_IT_JEOC); |
| 418 | /* (To ensure of no unknown state from potential previous ADC operations) */ |
418 | |
| 419 | __HAL_ADC_CLEAR_FLAG(hadc, ADC_FLAG_JEOC); |
419 | /* Enable conversion of injected group. */ |
| 420 | 420 | /* If software start has been selected, conversion starts immediately. */ |
|
| 421 | /* Enable end of conversion interrupt for injected channels */ |
421 | /* If external trigger has been selected, conversion will start at next */ |
| 422 | __HAL_ADC_ENABLE_IT(hadc, ADC_IT_JEOC); |
422 | /* trigger event. */ |
| 423 | 423 | /* If automatic injected conversion is enabled, conversion will start */ |
|
| 424 | /* Enable conversion of injected group. */ |
424 | /* after next regular group conversion. */ |
| 425 | /* If software start has been selected, conversion starts immediately. */ |
425 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
| 426 | /* If external trigger has been selected, conversion will start at next */ |
426 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 427 | /* trigger event. */ |
427 | { |
| 428 | /* If automatic injected conversion is enabled, conversion will start */ |
428 | /* Enable ADC software conversion for injected channels */ |
| 429 | /* after next regular group conversion. */ |
429 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JSWSTART); |
| 430 | if (ADC_IS_SOFTWARE_START_INJECTED(hadc) && |
430 | } |
| 431 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
431 | } |
| 432 | { |
432 | |
| 433 | /* Enable ADC software conversion for injected channels */ |
433 | /* Return function status */ |
| 434 | SET_BIT(hadc->Instance->CR2, ADC_CR2_JSWSTART); |
434 | return tmp_hal_status; |
| 435 | } |
435 | } |
| 436 | } |
436 | |
| 437 | 437 | /** |
|
| 438 | /* Return function status */ |
438 | * @brief Stop conversion of injected channels, disable interruption of |
| 439 | return tmp_hal_status; |
439 | * end-of-conversion. Disable ADC peripheral if no regular conversion |
| 440 | } |
440 | * is on going. |
| 441 | 441 | * @note If ADC must be disabled and if conversion is on going on |
|
| 442 | /** |
442 | * regular group, function HAL_ADC_Stop must be used to stop both |
| 443 | * @brief Stop conversion of injected channels, disable interruption of |
443 | * injected and regular groups, and disable the ADC. |
| 444 | * end-of-conversion. Disable ADC peripheral if no regular conversion |
444 | * @note If injected group mode auto-injection is enabled, |
| 445 | * is on going. |
445 | * function HAL_ADC_Stop must be used. |
| 446 | * @note If ADC must be disabled and if conversion is on going on |
446 | * @param hadc ADC handle |
| 447 | * regular group, function HAL_ADC_Stop must be used to stop both |
447 | * @retval None |
| 448 | * injected and regular groups, and disable the ADC. |
448 | */ |
| 449 | * @note If injected group mode auto-injection is enabled, |
449 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc) |
| 450 | * function HAL_ADC_Stop must be used. |
450 | { |
| 451 | * @param hadc ADC handle |
451 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 452 | * @retval None |
452 | |
| 453 | */ |
453 | /* Check the parameters */ |
| 454 | HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc) |
454 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 455 | { |
455 | |
| 456 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
456 | /* Process locked */ |
| 457 | 457 | __HAL_LOCK(hadc); |
|
| 458 | /* Check the parameters */ |
458 | |
| 459 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
459 | /* Stop potential conversion and disable ADC peripheral */ |
| 460 | 460 | /* Conditioned to: */ |
|
| 461 | /* Process locked */ |
461 | /* - No conversion on the other group (regular group) is intended to */ |
| 462 | __HAL_LOCK(hadc); |
462 | /* continue (injected and regular groups stop conversion and ADC disable */ |
| 463 | 463 | /* are common) */ |
|
| 464 | /* Stop potential conversion and disable ADC peripheral */ |
464 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
| 465 | /* Conditioned to: */ |
465 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
| 466 | /* - No conversion on the other group (regular group) is intended to */ |
466 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
| 467 | /* continue (injected and regular groups stop conversion and ADC disable */ |
467 | { |
| 468 | /* are common) */ |
468 | /* Stop potential conversion on going, on regular and injected groups */ |
| 469 | /* - In case of auto-injection mode, HAL_ADC_Stop must be used. */ |
469 | /* Disable ADC peripheral */ |
| 470 | if(((hadc->State & HAL_ADC_STATE_REG_BUSY) == RESET) && |
470 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
| 471 | HAL_IS_BIT_CLR(hadc->Instance->CR1, ADC_CR1_JAUTO) ) |
471 | |
| 472 | { |
472 | /* Check if ADC is effectively disabled */ |
| 473 | /* Stop potential conversion on going, on regular and injected groups */ |
473 | if (tmp_hal_status == HAL_OK) |
| 474 | /* Disable ADC peripheral */ |
474 | { |
| 475 | tmp_hal_status = ADC_ConversionStop_Disable(hadc); |
475 | /* Disable ADC end of conversion interrupt for injected channels */ |
| 476 | 476 | __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC); |
|
| 477 | /* Check if ADC is effectively disabled */ |
477 | |
| 478 | if (tmp_hal_status == HAL_OK) |
478 | /* Set ADC state */ |
| 479 | { |
479 | ADC_STATE_CLR_SET(hadc->State, |
| 480 | /* Disable ADC end of conversion interrupt for injected channels */ |
480 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
| 481 | __HAL_ADC_DISABLE_IT(hadc, ADC_IT_JEOC); |
481 | HAL_ADC_STATE_READY); |
| 482 | 482 | } |
|
| 483 | /* Set ADC state */ |
483 | } |
| 484 | ADC_STATE_CLR_SET(hadc->State, |
484 | else |
| 485 | HAL_ADC_STATE_REG_BUSY | HAL_ADC_STATE_INJ_BUSY, |
485 | { |
| 486 | HAL_ADC_STATE_READY); |
486 | /* Update ADC state machine to error */ |
| 487 | } |
487 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 488 | } |
488 | |
| 489 | else |
489 | tmp_hal_status = HAL_ERROR; |
| 490 | { |
490 | } |
| 491 | /* Update ADC state machine to error */ |
491 | |
| 492 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
492 | /* Process unlocked */ |
| 493 | 493 | __HAL_UNLOCK(hadc); |
|
| 494 | tmp_hal_status = HAL_ERROR; |
494 | |
| 495 | } |
495 | /* Return function status */ |
| 496 | 496 | return tmp_hal_status; |
|
| 497 | /* Process unlocked */ |
497 | } |
| 498 | __HAL_UNLOCK(hadc); |
498 | |
| 499 | 499 | /** |
|
| 500 | /* Return function status */ |
500 | * @brief Get ADC injected group conversion result. |
| 501 | return tmp_hal_status; |
501 | * @note Reading register JDRx automatically clears ADC flag JEOC |
| 502 | } |
502 | * (ADC group injected end of unitary conversion). |
| 503 | 503 | * @note This function does not clear ADC flag JEOS |
|
| 504 | /** |
504 | * (ADC group injected end of sequence conversion) |
| 505 | * @brief Get ADC injected group conversion result. |
505 | * Occurrence of flag JEOS rising: |
| 506 | * @note Reading register JDRx automatically clears ADC flag JEOC |
506 | * - If sequencer is composed of 1 rank, flag JEOS is equivalent |
| 507 | * (ADC group injected end of unitary conversion). |
507 | * to flag JEOC. |
| 508 | * @note This function does not clear ADC flag JEOS |
508 | * - If sequencer is composed of several ranks, during the scan |
| 509 | * (ADC group injected end of sequence conversion) |
509 | * sequence flag JEOC only is raised, at the end of the scan sequence |
| 510 | * Occurrence of flag JEOS rising: |
510 | * both flags JEOC and EOS are raised. |
| 511 | * - If sequencer is composed of 1 rank, flag JEOS is equivalent |
511 | * Flag JEOS must not be cleared by this function because |
| 512 | * to flag JEOC. |
512 | * it would not be compliant with low power features |
| 513 | * - If sequencer is composed of several ranks, during the scan |
513 | * (feature low power auto-wait, not available on all STM32 families). |
| 514 | * sequence flag JEOC only is raised, at the end of the scan sequence |
514 | * To clear this flag, either use function: |
| 515 | * both flags JEOC and EOS are raised. |
515 | * in programming model IT: @ref HAL_ADC_IRQHandler(), in programming |
| 516 | * Flag JEOS must not be cleared by this function because |
516 | * model polling: @ref HAL_ADCEx_InjectedPollForConversion() |
| 517 | * it would not be compliant with low power features |
517 | * or @ref __HAL_ADC_CLEAR_FLAG(&hadc, ADC_FLAG_JEOS). |
| 518 | * (feature low power auto-wait, not available on all STM32 families). |
518 | * @param hadc ADC handle |
| 519 | * To clear this flag, either use function: |
519 | * @param InjectedRank the converted ADC injected rank. |
| 520 | * in programming model IT: @ref HAL_ADC_IRQHandler(), in programming |
520 | * This parameter can be one of the following values: |
| 521 | * model polling: @ref HAL_ADCEx_InjectedPollForConversion() |
521 | * @arg ADC_INJECTED_RANK_1: Injected Channel1 selected |
| 522 | * or @ref __HAL_ADC_CLEAR_FLAG(&hadc, ADC_FLAG_JEOS). |
522 | * @arg ADC_INJECTED_RANK_2: Injected Channel2 selected |
| 523 | * @param hadc ADC handle |
523 | * @arg ADC_INJECTED_RANK_3: Injected Channel3 selected |
| 524 | * @param InjectedRank the converted ADC injected rank. |
524 | * @arg ADC_INJECTED_RANK_4: Injected Channel4 selected |
| 525 | * This parameter can be one of the following values: |
525 | * @retval ADC group injected conversion data |
| 526 | * @arg ADC_INJECTED_RANK_1: Injected Channel1 selected |
526 | */ |
| 527 | * @arg ADC_INJECTED_RANK_2: Injected Channel2 selected |
527 | uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank) |
| 528 | * @arg ADC_INJECTED_RANK_3: Injected Channel3 selected |
528 | { |
| 529 | * @arg ADC_INJECTED_RANK_4: Injected Channel4 selected |
529 | uint32_t tmp_jdr = 0; |
| 530 | * @retval ADC group injected conversion data |
530 | |
| 531 | */ |
531 | /* Check the parameters */ |
| 532 | uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank) |
532 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 533 | { |
533 | assert_param(IS_ADC_INJECTED_RANK(InjectedRank)); |
| 534 | uint32_t tmp_jdr = 0; |
534 | |
| 535 | 535 | /* Get ADC converted value */ |
|
| 536 | /* Check the parameters */ |
536 | switch(InjectedRank) |
| 537 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
537 | { |
| 538 | assert_param(IS_ADC_INJECTED_RANK(InjectedRank)); |
538 | case ADC_INJECTED_RANK_4: |
| 539 | 539 | tmp_jdr = hadc->Instance->JDR4; |
|
| 540 | /* Get ADC converted value */ |
540 | break; |
| 541 | switch(InjectedRank) |
541 | case ADC_INJECTED_RANK_3: |
| 542 | { |
542 | tmp_jdr = hadc->Instance->JDR3; |
| 543 | case ADC_INJECTED_RANK_4: |
543 | break; |
| 544 | tmp_jdr = hadc->Instance->JDR4; |
544 | case ADC_INJECTED_RANK_2: |
| 545 | break; |
545 | tmp_jdr = hadc->Instance->JDR2; |
| 546 | case ADC_INJECTED_RANK_3: |
546 | break; |
| 547 | tmp_jdr = hadc->Instance->JDR3; |
547 | case ADC_INJECTED_RANK_1: |
| 548 | break; |
548 | default: |
| 549 | case ADC_INJECTED_RANK_2: |
549 | tmp_jdr = hadc->Instance->JDR1; |
| 550 | tmp_jdr = hadc->Instance->JDR2; |
550 | break; |
| 551 | break; |
551 | } |
| 552 | case ADC_INJECTED_RANK_1: |
552 | |
| 553 | default: |
553 | /* Return ADC converted value */ |
| 554 | tmp_jdr = hadc->Instance->JDR1; |
554 | return tmp_jdr; |
| 555 | break; |
555 | } |
| 556 | } |
556 | |
| 557 | 557 | /** |
|
| 558 | /* Return ADC converted value */ |
558 | * @brief Injected conversion complete callback in non blocking mode |
| 559 | return tmp_jdr; |
559 | * @param hadc ADC handle |
| 560 | } |
560 | * @retval None |
| 561 | 561 | */ |
|
| 562 | /** |
562 | __weak void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc) |
| 563 | * @brief Injected conversion complete callback in non blocking mode |
563 | { |
| 564 | * @param hadc ADC handle |
564 | /* Prevent unused argument(s) compilation warning */ |
| 565 | * @retval None |
565 | UNUSED(hadc); |
| 566 | */ |
566 | |
| 567 | __weak void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc) |
567 | /* NOTE : This function Should not be modified, when the callback is needed, |
| 568 | { |
568 | the HAL_ADCEx_InjectedConvCpltCallback could be implemented in the user file |
| 569 | /* Prevent unused argument(s) compilation warning */ |
569 | */ |
| 570 | UNUSED(hadc); |
570 | } |
| 571 | 571 | ||
| 572 | /* NOTE : This function Should not be modified, when the callback is needed, |
572 | /** |
| 573 | the HAL_ADCEx_InjectedConvCpltCallback could be implemented in the user file |
573 | * @} |
| 574 | */ |
574 | */ |
| 575 | } |
575 | |
| 576 | 576 | /** @defgroup ADCEx_Exported_Functions_Group2 ADC Extended Peripheral Control functions |
|
| 577 | /** |
577 | * @brief ADC Extended Peripheral Control functions |
| 578 | * @} |
578 | * |
| 579 | */ |
579 | @verbatim |
| 580 | 580 | =============================================================================== |
|
| 581 | /** @defgroup ADCEx_Exported_Functions_Group2 ADC Extended Peripheral Control functions |
581 | ##### Peripheral Control functions ##### |
| 582 | * @brief ADC Extended Peripheral Control functions |
582 | =============================================================================== |
| 583 | * |
583 | [..] This section provides functions allowing to: |
| 584 | @verbatim |
584 | (+) Configure channels on injected group |
| 585 | =============================================================================== |
585 | |
| 586 | ##### Peripheral Control functions ##### |
586 | @endverbatim |
| 587 | =============================================================================== |
587 | * @{ |
| 588 | [..] This section provides functions allowing to: |
588 | */ |
| 589 | (+) Configure channels on injected group |
589 | |
| 590 | |
590 | /** |
| 591 | @endverbatim |
591 | * @brief Configures the ADC injected group and the selected channel to be |
| 592 | * @{ |
592 | * linked to the injected group. |
| 593 | */ |
593 | * @note Possibility to update parameters on the fly: |
| 594 | 594 | * This function initializes injected group, following calls to this |
|
| 595 | /** |
595 | * function can be used to reconfigure some parameters of structure |
| 596 | * @brief Configures the ADC injected group and the selected channel to be |
596 | * "ADC_InjectionConfTypeDef" on the fly, without resetting the ADC. |
| 597 | * linked to the injected group. |
597 | * The setting of these parameters is conditioned to ADC state: |
| 598 | * @note Possibility to update parameters on the fly: |
598 | * this function must be called when ADC is not under conversion. |
| 599 | * This function initializes injected group, following calls to this |
599 | * @param hadc ADC handle |
| 600 | * function can be used to reconfigure some parameters of structure |
600 | * @param sConfigInjected Structure of ADC injected group and ADC channel for |
| 601 | * "ADC_InjectionConfTypeDef" on the fly, without reseting the ADC. |
601 | * injected group. |
| 602 | * The setting of these parameters is conditioned to ADC state: |
602 | * @retval None |
| 603 | * this function must be called when ADC is not under conversion. |
603 | */ |
| 604 | * @param hadc ADC handle |
604 | HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc, ADC_InjectionConfTypeDef* sConfigInjected) |
| 605 | * @param sConfigInjected Structure of ADC injected group and ADC channel for |
605 | { |
| 606 | * injected group. |
606 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
| 607 | * @retval None |
607 | __IO uint32_t wait_loop_index = 0; |
| 608 | */ |
608 | |
| 609 | HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc, ADC_InjectionConfTypeDef* sConfigInjected) |
609 | /* Check the parameters */ |
| 610 | { |
610 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
| 611 | HAL_StatusTypeDef tmp_hal_status = HAL_OK; |
611 | assert_param(IS_ADC_CHANNEL(sConfigInjected->InjectedChannel)); |
| 612 | __IO uint32_t wait_loop_index = 0; |
612 | assert_param(IS_ADC_SAMPLE_TIME(sConfigInjected->InjectedSamplingTime)); |
| 613 | 613 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->AutoInjectedConv)); |
|
| 614 | /* Check the parameters */ |
614 | assert_param(IS_ADC_EXTTRIGINJEC(sConfigInjected->ExternalTrigInjecConv)); |
| 615 | assert_param(IS_ADC_ALL_INSTANCE(hadc->Instance)); |
615 | assert_param(IS_ADC_RANGE(ADC_RESOLUTION_12B, sConfigInjected->InjectedOffset)); |
| 616 | assert_param(IS_ADC_CHANNEL(sConfigInjected->InjectedChannel)); |
616 | |
| 617 | assert_param(IS_ADC_SAMPLE_TIME(sConfigInjected->InjectedSamplingTime)); |
617 | if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE) |
| 618 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->AutoInjectedConv)); |
618 | { |
| 619 | assert_param(IS_ADC_EXTTRIGINJEC(sConfigInjected->ExternalTrigInjecConv)); |
619 | assert_param(IS_ADC_INJECTED_RANK(sConfigInjected->InjectedRank)); |
| 620 | assert_param(IS_ADC_RANGE(ADC_RESOLUTION_12B, sConfigInjected->InjectedOffset)); |
620 | assert_param(IS_ADC_INJECTED_NB_CONV(sConfigInjected->InjectedNbrOfConversion)); |
| 621 | 621 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->InjectedDiscontinuousConvMode)); |
|
| 622 | if(hadc->Init.ScanConvMode != ADC_SCAN_DISABLE) |
622 | } |
| 623 | { |
623 | |
| 624 | assert_param(IS_ADC_INJECTED_RANK(sConfigInjected->InjectedRank)); |
624 | if(sConfigInjected->ExternalTrigInjecConv != ADC_INJECTED_SOFTWARE_START) |
| 625 | assert_param(IS_ADC_INJECTED_NB_CONV(sConfigInjected->InjectedNbrOfConversion)); |
625 | { |
| 626 | assert_param(IS_FUNCTIONAL_STATE(sConfigInjected->InjectedDiscontinuousConvMode)); |
626 | assert_param(IS_ADC_EXTTRIGINJEC_EDGE(sConfigInjected->ExternalTrigInjecConvEdge)); |
| 627 | } |
627 | } |
| 628 | 628 | ||
| 629 | if(sConfigInjected->ExternalTrigInjecConv != ADC_INJECTED_SOFTWARE_START) |
629 | /* Process locked */ |
| 630 | { |
630 | __HAL_LOCK(hadc); |
| 631 | assert_param(IS_ADC_EXTTRIGINJEC_EDGE(sConfigInjected->ExternalTrigInjecConvEdge)); |
631 | |
| 632 | } |
632 | /* Configuration of injected group sequencer: */ |
| 633 | 633 | /* - if scan mode is disabled, injected channels sequence length is set to */ |
|
| 634 | /* Process locked */ |
634 | /* 0x00: 1 channel converted (channel on regular rank 1) */ |
| 635 | __HAL_LOCK(hadc); |
635 | /* Parameter "InjectedNbrOfConversion" is discarded. */ |
| 636 | 636 | /* Note: Scan mode is present by hardware on this device and, if */ |
|
| 637 | /* Configuration of injected group sequencer: */ |
637 | /* disabled, discards automatically nb of conversions. Anyway, nb of */ |
| 638 | /* - if scan mode is disabled, injected channels sequence length is set to */ |
638 | /* conversions is forced to 0x00 for alignment over all STM32 devices. */ |
| 639 | /* 0x00: 1 channel converted (channel on regular rank 1) */ |
639 | /* - if scan mode is enabled, injected channels sequence length is set to */ |
| 640 | /* Parameter "InjectedNbrOfConversion" is discarded. */ |
640 | /* parameter ""InjectedNbrOfConversion". */ |
| 641 | /* Note: Scan mode is present by hardware on this device and, if */ |
641 | if (hadc->Init.ScanConvMode == ADC_SCAN_DISABLE) |
| 642 | /* disabled, discards automatically nb of conversions. Anyway, nb of */ |
642 | { |
| 643 | /* conversions is forced to 0x00 for alignment over all STM32 devices. */ |
643 | if (sConfigInjected->InjectedRank == ADC_INJECTED_RANK_1) |
| 644 | /* - if scan mode is enabled, injected channels sequence length is set to */ |
644 | { |
| 645 | /* parameter ""InjectedNbrOfConversion". */ |
645 | /* Clear the old SQx bits for all injected ranks */ |
| 646 | if (hadc->Init.ScanConvMode == ADC_SCAN_DISABLE) |
646 | MODIFY_REG(hadc->Instance->JSQR , |
| 647 | { |
647 | ADC_JSQR_JL | |
| 648 | if (sConfigInjected->InjectedRank == ADC_INJECTED_RANK_1) |
648 | ADC_JSQR_JSQ4 | |
| 649 | { |
649 | ADC_JSQR_JSQ3 | |
| 650 | /* Clear the old SQx bits for all injected ranks */ |
650 | ADC_JSQR_JSQ2 | |
| 651 | MODIFY_REG(hadc->Instance->JSQR , |
651 | ADC_JSQR_JSQ1 , |
| 652 | ADC_JSQR_JL | |
652 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
| 653 | ADC_JSQR_JSQ4 | |
653 | ADC_INJECTED_RANK_1, |
| 654 | ADC_JSQR_JSQ3 | |
654 | 0x01) ); |
| 655 | ADC_JSQR_JSQ2 | |
655 | } |
| 656 | ADC_JSQR_JSQ1 , |
656 | /* If another injected rank than rank1 was intended to be set, and could */ |
| 657 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
657 | /* not due to ScanConvMode disabled, error is reported. */ |
| 658 | ADC_INJECTED_RANK_1, |
658 | else |
| 659 | 0x01) ); |
659 | { |
| 660 | } |
660 | /* Update ADC state machine to error */ |
| 661 | /* If another injected rank than rank1 was intended to be set, and could */ |
661 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 662 | /* not due to ScanConvMode disabled, error is reported. */ |
662 | |
| 663 | else |
663 | tmp_hal_status = HAL_ERROR; |
| 664 | { |
664 | } |
| 665 | /* Update ADC state machine to error */ |
665 | } |
| 666 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
666 | else |
| 667 | 667 | { |
|
| 668 | tmp_hal_status = HAL_ERROR; |
668 | /* Since injected channels rank conv. order depends on total number of */ |
| 669 | } |
669 | /* injected conversions, selected rank must be below or equal to total */ |
| 670 | } |
670 | /* number of injected conversions to be updated. */ |
| 671 | else |
671 | if (sConfigInjected->InjectedRank <= sConfigInjected->InjectedNbrOfConversion) |
| 672 | { |
672 | { |
| 673 | /* Since injected channels rank conv. order depends on total number of */ |
673 | /* Clear the old SQx bits for the selected rank */ |
| 674 | /* injected conversions, selected rank must be below or equal to total */ |
674 | /* Set the SQx bits for the selected rank */ |
| 675 | /* number of injected conversions to be updated. */ |
675 | MODIFY_REG(hadc->Instance->JSQR , |
| 676 | if (sConfigInjected->InjectedRank <= sConfigInjected->InjectedNbrOfConversion) |
676 | |
| 677 | { |
677 | ADC_JSQR_JL | |
| 678 | /* Clear the old SQx bits for the selected rank */ |
678 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
| 679 | /* Set the SQx bits for the selected rank */ |
679 | sConfigInjected->InjectedRank, |
| 680 | MODIFY_REG(hadc->Instance->JSQR , |
680 | sConfigInjected->InjectedNbrOfConversion) , |
| 681 | 681 | ||
| 682 | ADC_JSQR_JL | |
682 | ADC_JSQR_JL_SHIFT(sConfigInjected->InjectedNbrOfConversion) | |
| 683 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
683 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
| 684 | sConfigInjected->InjectedRank, |
684 | sConfigInjected->InjectedRank, |
| 685 | sConfigInjected->InjectedNbrOfConversion) , |
685 | sConfigInjected->InjectedNbrOfConversion) ); |
| 686 | 686 | } |
|
| 687 | ADC_JSQR_JL_SHIFT(sConfigInjected->InjectedNbrOfConversion) | |
687 | else |
| 688 | ADC_JSQR_RK_JL(sConfigInjected->InjectedChannel, |
688 | { |
| 689 | sConfigInjected->InjectedRank, |
689 | /* Clear the old SQx bits for the selected rank */ |
| 690 | sConfigInjected->InjectedNbrOfConversion) ); |
690 | MODIFY_REG(hadc->Instance->JSQR , |
| 691 | } |
691 | |
| 692 | else |
692 | ADC_JSQR_JL | |
| 693 | { |
693 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
| 694 | /* Clear the old SQx bits for the selected rank */ |
694 | sConfigInjected->InjectedRank, |
| 695 | MODIFY_REG(hadc->Instance->JSQR , |
695 | sConfigInjected->InjectedNbrOfConversion) , |
| 696 | 696 | ||
| 697 | ADC_JSQR_JL | |
697 | 0x00000000 ); |
| 698 | ADC_JSQR_RK_JL(ADC_JSQR_JSQ1, |
698 | } |
| 699 | sConfigInjected->InjectedRank, |
699 | } |
| 700 | sConfigInjected->InjectedNbrOfConversion) , |
700 | |
| 701 | 701 | /* Enable external trigger if trigger selection is different of software */ |
|
| 702 | 0x00000000 ); |
702 | /* start. */ |
| 703 | } |
703 | /* Note: This configuration keeps the hardware feature of parameter */ |
| 704 | } |
704 | /* ExternalTrigConvEdge "trigger edge none" equivalent to */ |
| 705 | 705 | /* software start. */ |
|
| 706 | /* Enable external trigger if trigger selection is different of software */ |
706 | |
| 707 | /* start. */ |
707 | if (sConfigInjected->ExternalTrigInjecConv != ADC_INJECTED_SOFTWARE_START) |
| 708 | /* Note: This configuration keeps the hardware feature of parameter */ |
708 | { |
| 709 | /* ExternalTrigConvEdge "trigger edge none" equivalent to */ |
709 | MODIFY_REG(hadc->Instance->CR2 , |
| 710 | /* software start. */ |
710 | ADC_CR2_JEXTEN | |
| 711 | 711 | ADC_CR2_JEXTSEL , |
|
| 712 | if (sConfigInjected->ExternalTrigInjecConv != ADC_INJECTED_SOFTWARE_START) |
712 | sConfigInjected->ExternalTrigInjecConv | |
| 713 | { |
713 | sConfigInjected->ExternalTrigInjecConvEdge ); |
| 714 | MODIFY_REG(hadc->Instance->CR2 , |
714 | } |
| 715 | ADC_CR2_JEXTEN | |
715 | else |
| 716 | ADC_CR2_JEXTSEL , |
716 | { |
| 717 | sConfigInjected->ExternalTrigInjecConv | |
717 | MODIFY_REG(hadc->Instance->CR2, |
| 718 | sConfigInjected->ExternalTrigInjecConvEdge ); |
718 | ADC_CR2_JEXTEN | |
| 719 | } |
719 | ADC_CR2_JEXTSEL , |
| 720 | else |
720 | 0x00000000 ); |
| 721 | { |
721 | } |
| 722 | MODIFY_REG(hadc->Instance->CR2, |
722 | |
| 723 | ADC_CR2_JEXTEN | |
723 | /* Configuration of injected group */ |
| 724 | ADC_CR2_JEXTSEL , |
724 | /* Parameters update conditioned to ADC state: */ |
| 725 | 0x00000000 ); |
725 | /* Parameters that can be updated only when ADC is disabled: */ |
| 726 | } |
726 | /* - Automatic injected conversion */ |
| 727 | 727 | /* - Injected discontinuous mode */ |
|
| 728 | /* Configuration of injected group */ |
728 | if ((ADC_IS_ENABLE(hadc) == RESET)) |
| 729 | /* Parameters update conditioned to ADC state: */ |
729 | { |
| 730 | /* Parameters that can be updated only when ADC is disabled: */ |
730 | hadc->Instance->CR1 &= ~(ADC_CR1_JAUTO | |
| 731 | /* - Automatic injected conversion */ |
731 | ADC_CR1_JDISCEN ); |
| 732 | /* - Injected discontinuous mode */ |
732 | |
| 733 | if ((ADC_IS_ENABLE(hadc) == RESET)) |
733 | /* Automatic injected conversion can be enabled if injected group */ |
| 734 | { |
734 | /* external triggers are disabled. */ |
| 735 | hadc->Instance->CR1 &= ~(ADC_CR1_JAUTO | |
735 | if (sConfigInjected->AutoInjectedConv == ENABLE) |
| 736 | ADC_CR1_JDISCEN ); |
736 | { |
| 737 | 737 | if (sConfigInjected->ExternalTrigInjecConv == ADC_INJECTED_SOFTWARE_START) |
|
| 738 | /* Automatic injected conversion can be enabled if injected group */ |
738 | { |
| 739 | /* external triggers are disabled. */ |
739 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO); |
| 740 | if (sConfigInjected->AutoInjectedConv == ENABLE) |
740 | } |
| 741 | { |
741 | else |
| 742 | if (sConfigInjected->ExternalTrigInjecConv == ADC_INJECTED_SOFTWARE_START) |
742 | { |
| 743 | { |
743 | /* Update ADC state machine to error */ |
| 744 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JAUTO); |
744 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 745 | } |
745 | |
| 746 | else |
746 | tmp_hal_status = HAL_ERROR; |
| 747 | { |
747 | } |
| 748 | /* Update ADC state machine to error */ |
748 | } |
| 749 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
749 | |
| 750 | 750 | /* Injected discontinuous can be enabled only if auto-injected mode is */ |
|
| 751 | tmp_hal_status = HAL_ERROR; |
751 | /* disabled. */ |
| 752 | } |
752 | if (sConfigInjected->InjectedDiscontinuousConvMode == ENABLE) |
| 753 | } |
753 | { |
| 754 | 754 | if (sConfigInjected->AutoInjectedConv == DISABLE) |
|
| 755 | /* Injected discontinuous can be enabled only if auto-injected mode is */ |
755 | { |
| 756 | /* disabled. */ |
756 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JDISCEN); |
| 757 | if (sConfigInjected->InjectedDiscontinuousConvMode == ENABLE) |
757 | } |
| 758 | { |
758 | else |
| 759 | if (sConfigInjected->AutoInjectedConv == DISABLE) |
759 | { |
| 760 | { |
760 | /* Update ADC state machine to error */ |
| 761 | SET_BIT(hadc->Instance->CR1, ADC_CR1_JDISCEN); |
761 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
| 762 | } |
762 | |
| 763 | else |
763 | tmp_hal_status = HAL_ERROR; |
| 764 | { |
764 | } |
| 765 | /* Update ADC state machine to error */ |
765 | } |
| 766 | SET_BIT(hadc->State, HAL_ADC_STATE_ERROR_CONFIG); |
766 | } |
| 767 | 767 | ||
| 768 | tmp_hal_status = HAL_ERROR; |
768 | /* Channel sampling time configuration */ |
| 769 | } |
769 | /* For InjectedChannels 0 to 9 */ |
| 770 | } |
770 | if (sConfigInjected->InjectedChannel < ADC_CHANNEL_10) |
| 771 | } |
771 | { |
| 772 | 772 | MODIFY_REG(hadc->Instance->SMPR3, |
|
| 773 | /* Channel sampling time configuration */ |
773 | ADC_SMPR3(ADC_SMPR3_SMP0, sConfigInjected->InjectedChannel), |
| 774 | /* For InjectedChannels 0 to 9 */ |
774 | ADC_SMPR3(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
| 775 | if (sConfigInjected->InjectedChannel < ADC_CHANNEL_10) |
775 | } |
| 776 | { |
776 | /* For InjectedChannels 10 to 19 */ |
| 777 | MODIFY_REG(hadc->Instance->SMPR3, |
777 | else if (sConfigInjected->InjectedChannel < ADC_CHANNEL_20) |
| 778 | ADC_SMPR3(ADC_SMPR3_SMP0, sConfigInjected->InjectedChannel), |
778 | { |
| 779 | ADC_SMPR3(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
779 | MODIFY_REG(hadc->Instance->SMPR2, |
| 780 | } |
780 | ADC_SMPR2(ADC_SMPR2_SMP10, sConfigInjected->InjectedChannel), |
| 781 | /* For InjectedChannels 10 to 19 */ |
781 | ADC_SMPR2(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
| 782 | else if (sConfigInjected->InjectedChannel < ADC_CHANNEL_20) |
782 | } |
| 783 | { |
783 | /* For InjectedChannels 20 to 26 for devices Cat.1, Cat.2, Cat.3 */ |
| 784 | MODIFY_REG(hadc->Instance->SMPR2, |
784 | /* For InjectedChannels 20 to 29 for devices Cat4, Cat.5 */ |
| 785 | ADC_SMPR2(ADC_SMPR2_SMP10, sConfigInjected->InjectedChannel), |
785 | else if (sConfigInjected->InjectedChannel <= ADC_SMPR1_CHANNEL_MAX) |
| 786 | ADC_SMPR2(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
786 | { |
| 787 | } |
787 | MODIFY_REG(hadc->Instance->SMPR1, |
| 788 | /* For InjectedChannels 20 to 26 for devices Cat.1, Cat.2, Cat.3 */ |
788 | ADC_SMPR1(ADC_SMPR1_SMP20, sConfigInjected->InjectedChannel), |
| 789 | /* For InjectedChannels 20 to 29 for devices Cat4, Cat.5 */ |
789 | ADC_SMPR1(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
| 790 | else if (sConfigInjected->InjectedChannel <= ADC_SMPR1_CHANNEL_MAX) |
790 | } |
| 791 | { |
791 | /* For InjectedChannels 30 to 31 for devices Cat4, Cat.5 */ |
| 792 | MODIFY_REG(hadc->Instance->SMPR1, |
792 | else |
| 793 | ADC_SMPR1(ADC_SMPR1_SMP20, sConfigInjected->InjectedChannel), |
793 | { |
| 794 | ADC_SMPR1(sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel) ); |
794 | ADC_SMPR0_CHANNEL_SET(hadc, sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel); |
| 795 | } |
795 | } |
| 796 | /* For InjectedChannels 30 to 31 for devices Cat4, Cat.5 */ |
796 | |
| 797 | else |
797 | |
| 798 | { |
798 | /* Configure the offset: offset enable/disable, InjectedChannel, offset value */ |
| 799 | ADC_SMPR0_CHANNEL_SET(hadc, sConfigInjected->InjectedSamplingTime, sConfigInjected->InjectedChannel); |
799 | switch(sConfigInjected->InjectedRank) |
| 800 | } |
800 | { |
| 801 | 801 | case 1: |
|
| 802 | 802 | /* Set injected channel 1 offset */ |
|
| 803 | /* Configure the offset: offset enable/disable, InjectedChannel, offset value */ |
803 | MODIFY_REG(hadc->Instance->JOFR1, |
| 804 | switch(sConfigInjected->InjectedRank) |
804 | ADC_JOFR1_JOFFSET1, |
| 805 | { |
805 | sConfigInjected->InjectedOffset); |
| 806 | case 1: |
806 | break; |
| 807 | /* Set injected channel 1 offset */ |
807 | case 2: |
| 808 | MODIFY_REG(hadc->Instance->JOFR1, |
808 | /* Set injected channel 2 offset */ |
| 809 | ADC_JOFR1_JOFFSET1, |
809 | MODIFY_REG(hadc->Instance->JOFR2, |
| 810 | sConfigInjected->InjectedOffset); |
810 | ADC_JOFR2_JOFFSET2, |
| 811 | break; |
811 | sConfigInjected->InjectedOffset); |
| 812 | case 2: |
812 | break; |
| 813 | /* Set injected channel 2 offset */ |
813 | case 3: |
| 814 | MODIFY_REG(hadc->Instance->JOFR2, |
814 | /* Set injected channel 3 offset */ |
| 815 | ADC_JOFR2_JOFFSET2, |
815 | MODIFY_REG(hadc->Instance->JOFR3, |
| 816 | sConfigInjected->InjectedOffset); |
816 | ADC_JOFR3_JOFFSET3, |
| 817 | break; |
817 | sConfigInjected->InjectedOffset); |
| 818 | case 3: |
818 | break; |
| 819 | /* Set injected channel 3 offset */ |
819 | case 4: |
| 820 | MODIFY_REG(hadc->Instance->JOFR3, |
820 | default: |
| 821 | ADC_JOFR3_JOFFSET3, |
821 | MODIFY_REG(hadc->Instance->JOFR4, |
| 822 | sConfigInjected->InjectedOffset); |
822 | ADC_JOFR4_JOFFSET4, |
| 823 | break; |
823 | sConfigInjected->InjectedOffset); |
| 824 | case 4: |
824 | break; |
| 825 | default: |
825 | } |
| 826 | MODIFY_REG(hadc->Instance->JOFR4, |
826 | |
| 827 | ADC_JOFR4_JOFFSET4, |
827 | /* If ADC1 Channel_16 or Channel_17 is selected, enable Temperature sensor */ |
| 828 | sConfigInjected->InjectedOffset); |
828 | /* and VREFINT measurement path. */ |
| 829 | break; |
829 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
| 830 | } |
830 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
| 831 | 831 | { |
|
| 832 | /* If ADC1 Channel_16 or Channel_17 is selected, enable Temperature sensor */ |
832 | SET_BIT(ADC->CCR, ADC_CCR_TSVREFE); |
| 833 | /* and VREFINT measurement path. */ |
833 | |
| 834 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR) || |
834 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR)) |
| 835 | (sConfigInjected->InjectedChannel == ADC_CHANNEL_VREFINT) ) |
835 | { |
| 836 | { |
836 | /* Delay for temperature sensor stabilization time */ |
| 837 | SET_BIT(ADC->CCR, ADC_CCR_TSVREFE); |
837 | /* Compute number of CPU cycles to wait for */ |
| 838 | 838 | wait_loop_index = (ADC_TEMPSENSOR_DELAY_US * (SystemCoreClock / 1000000)); |
|
| 839 | if ((sConfigInjected->InjectedChannel == ADC_CHANNEL_TEMPSENSOR)) |
839 | while(wait_loop_index != 0) |
| 840 | { |
840 | { |
| 841 | /* Delay for temperature sensor stabilization time */ |
841 | wait_loop_index--; |
| 842 | /* Compute number of CPU cycles to wait for */ |
842 | } |
| 843 | wait_loop_index = (ADC_TEMPSENSOR_DELAY_US * (SystemCoreClock / 1000000)); |
843 | } |
| 844 | while(wait_loop_index != 0) |
844 | } |
| 845 | { |
845 | |
| 846 | wait_loop_index--; |
846 | /* Process unlocked */ |
| 847 | } |
847 | __HAL_UNLOCK(hadc); |
| 848 | } |
848 | |
| 849 | } |
849 | /* Return function status */ |
| 850 | 850 | return tmp_hal_status; |
|
| 851 | /* Process unlocked */ |
851 | } |
| 852 | __HAL_UNLOCK(hadc); |
852 | |
| 853 | 853 | /** |
|
| 854 | /* Return function status */ |
854 | * @} |
| 855 | return tmp_hal_status; |
855 | */ |
| 856 | } |
856 | |
| 857 | 857 | /** |
|
| 858 | /** |
858 | * @} |
| 859 | * @} |
859 | */ |
| 860 | */ |
860 | |
| 861 | 861 | #endif /* HAL_ADC_MODULE_ENABLED */ |
|
| 862 | /** |
862 | /** |
| 863 | * @} |
863 | * @} |
| 864 | */ |
864 | */ |
| 865 | 865 | ||
| 866 | #endif /* HAL_ADC_MODULE_ENABLED */ |
866 | /** |
| 867 | /** |
867 | * @} |
| 868 | * @} |
868 | */ |
| 869 | */ |
- | |
| 870 | - | ||
| 871 | /** |
- | |
| 872 | * @} |
- | |
| 873 | */ |
- | |
| 874 | - | ||
| 875 | /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |
- | |