1 /** 2 ****************************************************************************** 3 * @file stm32g4xx_hal_adc_ex.h 4 * @author MCD Application Team 5 * @brief Header file of ADC HAL extended module. 6 ****************************************************************************** 7 * @attention 8 * 9 * Copyright (c) 2019 STMicroelectronics. 10 * All rights reserved. 11 * 12 * This software is licensed under terms that can be found in the LICENSE file 13 * in the root directory of this software component. 14 * If no LICENSE file comes with this software, it is provided AS-IS. 15 * 16 ****************************************************************************** 17 */ 18 19 /* Define to prevent recursive inclusion -------------------------------------*/ 20 #ifndef STM32G4xx_HAL_ADC_EX_H 21 #define STM32G4xx_HAL_ADC_EX_H 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 /* Includes ------------------------------------------------------------------*/ 28 #include "stm32g4xx_hal_def.h" 29 30 /** @addtogroup STM32G4xx_HAL_Driver 31 * @{ 32 */ 33 34 /** @addtogroup ADCEx 35 * @{ 36 */ 37 38 /* Exported types ------------------------------------------------------------*/ 39 /** @defgroup ADCEx_Exported_Types ADC Extended Exported Types 40 * @{ 41 */ 42 43 /** 44 * @brief ADC Injected Conversion Oversampling structure definition 45 */ 46 typedef struct 47 { 48 uint32_t Ratio; /*!< Configures the oversampling ratio. 49 This parameter can be a value of @ref ADC_HAL_EC_OVS_RATIO */ 50 51 uint32_t RightBitShift; /*!< Configures the division coefficient for the Oversampler. 52 This parameter can be a value of @ref ADC_HAL_EC_OVS_SHIFT */ 53 } ADC_InjOversamplingTypeDef; 54 55 /** 56 * @brief Structure definition of ADC group injected and ADC channel affected to ADC group injected 57 * @note Parameters of this structure are shared within 2 scopes: 58 * - Scope channel: InjectedChannel, InjectedRank, InjectedSamplingTime , InjectedSingleDiff, 59 * InjectedOffsetNumber, InjectedOffset, InjectedOffsetSign, InjectedOffsetSaturation 60 * - Scope ADC group injected (affects all channels of injected group): InjectedNbrOfConversion, 61 * InjectedDiscontinuousConvMode, 62 * AutoInjectedConv, QueueInjectedContext, ExternalTrigInjecConv, ExternalTrigInjecConvEdge, 63 * InjecOversamplingMode, InjecOversampling. 64 * @note The setting of these parameters by function HAL_ADCEx_InjectedConfigChannel() is conditioned to ADC state. 65 * ADC state can be either: 66 * - For all parameters: ADC disabled (this is the only possible ADC state to modify parameter 67 * 'InjectedSingleDiff') 68 * - For parameters 'InjectedDiscontinuousConvMode', 'QueueInjectedContext', 'InjecOversampling': ADC enabled 69 * without conversion on going on injected group. 70 * - For parameters 'InjectedSamplingTime', 'InjectedOffset', 'InjectedOffsetNumber', 'InjectedOffsetSign', 71 * 'InjectedOffsetSaturation', 'AutoInjectedConv': ADC enabled without conversion on going on regular and 72 * injected groups. 73 * - For parameters 'InjectedChannel', 'InjectedRank', 'InjectedNbrOfConversion', 'ExternalTrigInjecConv', 74 * 'ExternalTrigInjecConvEdge': ADC enabled and while conversion on going 75 * on ADC groups regular and injected. 76 * If ADC is not in the appropriate state to modify some parameters, these parameters setting is bypassed 77 * without error reporting (as it can be the expected behavior in case of intended action to update another 78 * parameter (which fulfills the ADC state condition) on the fly). 79 */ 80 typedef struct 81 { 82 uint32_t InjectedChannel; /*!< Specifies the channel to configure into ADC group injected. 83 This parameter can be a value of @ref ADC_HAL_EC_CHANNEL 84 Note: Depending on devices and ADC instances, some channels may not be 85 available on device package pins. Refer to device datasheet for 86 channels availability. */ 87 88 uint32_t InjectedRank; /*!< Specifies the rank in the ADC group injected sequencer. 89 This parameter must be a value of @ref ADC_INJ_SEQ_RANKS. 90 Note: to disable a channel or change order of conversion sequencer, 91 rank containing a previous channel setting can be overwritten by 92 the new channel setting (or parameter number of conversions 93 adjusted) */ 94 95 uint32_t InjectedSamplingTime; /*!< Sampling time value to be set for the selected channel. 96 Unit: ADC clock cycles. 97 Conversion time is the addition of sampling time and processing time 98 (12.5 ADC clock cycles at ADC resolution 12 bits, 10.5 cycles at 10 bits, 99 8.5 cycles at 8 bits, 6.5 cycles at 6 bits). 100 This parameter can be a value of @ref ADC_HAL_EC_CHANNEL_SAMPLINGTIME. 101 Caution: This parameter applies to a channel that can be used in a 102 regular and/or injected group. It overwrites the last setting. 103 Note: In case of usage of internal measurement channels (VrefInt, ...), 104 sampling time constraints must be respected (sampling time can be 105 adjusted in function of ADC clock frequency and sampling time 106 setting). Refer to device datasheet for timings values. */ 107 108 uint32_t InjectedSingleDiff; /*!< Selection of single-ended or differential input. 109 In differential mode: Differential measurement is between the selected 110 channel 'i' (positive input) and channel 'i+1' (negative input). 111 Only channel 'i' has to be configured, channel 'i+1' is configured 112 automatically. 113 This parameter must be a value of 114 @ref ADC_HAL_EC_CHANNEL_SINGLE_DIFF_ENDING. 115 Caution: This parameter applies to a channel that can be used in a 116 regular and/or injected group. It overwrites the last setting. 117 Note: Refer to Reference Manual to ensure the selected channel is 118 available in differential mode. 119 Note: When configuring a channel 'i' in differential mode, the channel 120 'i+1' is not usable separately. 121 Note: This parameter must be modified when ADC is disabled (before ADC 122 start conversion or after ADC stop conversion). 123 If ADC is enabled, this parameter setting is bypassed without error 124 reporting (as it can be the expected behavior in case of another 125 parameter update on the fly) */ 126 127 uint32_t InjectedOffsetNumber; /*!< Selects the offset number. 128 This parameter can be a value of @ref ADC_HAL_EC_OFFSET_NB. 129 Caution: Only one offset is allowed per channel. This parameter 130 overwrites the last setting. */ 131 132 uint32_t InjectedOffset; /*!< Defines the offset to be applied on the raw converted data. 133 Offset value must be a positive number. 134 Depending of ADC resolution selected (12, 10, 8 or 6 bits), this 135 parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF, 136 0x3FF, 0xFF or 0x3F respectively. 137 Note: This parameter must be modified when no conversion is on going 138 on both regular and injected groups (ADC disabled, or ADC enabled 139 without continuous mode or external trigger that could launch a 140 conversion). */ 141 142 uint32_t InjectedOffsetSign; /*!< Define if the offset should be subtracted (negative sign) or added 143 (positive sign) from or to the raw converted data. 144 This parameter can be a value of @ref ADCEx_OffsetSign. 145 Note: This parameter must be modified when no conversion is on going 146 on both regular and injected groups (ADC disabled, or ADC 147 enabled without continuous mode or external trigger that could 148 launch a conversion). */ 149 FunctionalState InjectedOffsetSaturation; /*!< Define if the offset should be saturated upon under or over flow. 150 This parameter value can be ENABLE or DISABLE. 151 Note: This parameter must be modified when no conversion is on going 152 on both regular and injected groups (ADC disabled, or ADC enabled 153 without continuous mode or external trigger that could launch a 154 conversion). */ 155 156 uint32_t InjectedNbrOfConversion; /*!< Specifies the number of ranks that will be converted within the ADC group 157 injected sequencer. 158 To use the injected group sequencer and convert several ranks, parameter 159 'ScanConvMode' must be enabled. 160 This parameter must be a number between Min_Data = 1 and Max_Data = 4. 161 Caution: this setting impacts the entire injected group. Therefore, 162 call of HAL_ADCEx_InjectedConfigChannel() to configure a channel on 163 injected group can impact the configuration of other channels previously 164 set. */ 165 166 FunctionalState InjectedDiscontinuousConvMode; /*!< Specifies whether the conversions sequence of ADC group injected 167 is performed in Complete-sequence/Discontinuous-sequence 168 (main sequence subdivided in successive parts). 169 Discontinuous mode is used only if sequencer is enabled (parameter 170 'ScanConvMode'). If sequencer is disabled, this parameter is discarded. 171 Discontinuous mode can be enabled only if continuous mode is disabled. 172 This parameter can be set to ENABLE or DISABLE. 173 Note: This parameter must be modified when ADC is disabled (before ADC 174 start conversion or after ADC stop conversion). 175 Note: For injected group, discontinuous mode converts the sequence 176 channel by channel (discontinuous length fixed to 1 rank). 177 Caution: this setting impacts the entire injected group. Therefore, 178 call of HAL_ADCEx_InjectedConfigChannel() to 179 configure a channel on injected group can impact the 180 configuration of other channels previously set. */ 181 182 FunctionalState AutoInjectedConv; /*!< Enables or disables the selected ADC group injected automatic conversion 183 after regular one 184 This parameter can be set to ENABLE or DISABLE. 185 Note: To use Automatic injected conversion, discontinuous mode must 186 be disabled ('DiscontinuousConvMode' and 187 'InjectedDiscontinuousConvMode' set to DISABLE) 188 Note: To use Automatic injected conversion, injected group external 189 triggers must be disabled ('ExternalTrigInjecConv' set to 190 ADC_INJECTED_SOFTWARE_START) 191 Note: In case of DMA used with regular group: if DMA configured in 192 normal mode (single shot) JAUTO will be stopped upon DMA transfer 193 complete. 194 To maintain JAUTO always enabled, DMA must be configured in 195 circular mode. 196 Caution: this setting impacts the entire injected group. Therefore, 197 call of HAL_ADCEx_InjectedConfigChannel() to configure a channel 198 on injected group can impact the configuration of other channels 199 previously set. */ 200 201 FunctionalState QueueInjectedContext; /*!< Specifies whether the context queue feature is enabled. 202 This parameter can be set to ENABLE or DISABLE. 203 If context queue is enabled, injected sequencer&channels configurations 204 are queued on up to 2 contexts. If a 205 new injected context is set when queue is full, error is triggered by 206 interruption and through function 207 'HAL_ADCEx_InjectedQueueOverflowCallback'. 208 Caution: This feature request that the sequence is fully configured 209 before injected conversion start. 210 Therefore, configure channels with as many calls to 211 HAL_ADCEx_InjectedConfigChannel() as the 212 'InjectedNbrOfConversion' parameter. 213 Caution: this setting impacts the entire injected group. Therefore, 214 call of HAL_ADCEx_InjectedConfigChannel() to 215 configure a channel on injected group can impact the 216 configuration of other channels previously set. 217 Note: This parameter must be modified when ADC is disabled (before ADC 218 start conversion or after ADC stop conversion). */ 219 220 uint32_t ExternalTrigInjecConv; /*!< Selects the external event used to trigger the conversion start of 221 injected group. 222 If set to ADC_INJECTED_SOFTWARE_START, external triggers are disabled 223 and software trigger is used instead. 224 This parameter can be a value of 225 @ref ADC_injected_external_trigger_source. 226 Caution: this setting impacts the entire injected group. Therefore, 227 call of HAL_ADCEx_InjectedConfigChannel() to configure a channel 228 on injected group can impact the configuration of other channels 229 previously set. */ 230 231 uint32_t ExternalTrigInjecConvEdge; /*!< Selects the external trigger edge of injected group. 232 This parameter can be a value of @ref ADC_injected_external_trigger_edge. 233 If trigger source is set to ADC_INJECTED_SOFTWARE_START, this parameter 234 is discarded. 235 Caution: this setting impacts the entire injected group. Therefore, 236 call of HAL_ADCEx_InjectedConfigChannel() to 237 configure a channel on injected group can impact the 238 configuration of other channels previously set. */ 239 240 FunctionalState InjecOversamplingMode; /*!< Specifies whether the oversampling feature is enabled or disabled. 241 This parameter can be set to ENABLE or DISABLE. 242 Note: This parameter can be modified only if there is no 243 conversion is ongoing (both ADSTART and JADSTART cleared). */ 244 245 ADC_InjOversamplingTypeDef InjecOversampling; /*!< Specifies the Oversampling parameters. 246 Caution: this setting overwrites the previous oversampling 247 configuration if oversampling already enabled. 248 Note: This parameter can be modified only if there is no 249 conversion is ongoing (both ADSTART and JADSTART cleared).*/ 250 } ADC_InjectionConfTypeDef; 251 252 #if defined(ADC_MULTIMODE_SUPPORT) 253 /** 254 * @brief Structure definition of ADC multimode 255 * @note The setting of these parameters by function HAL_ADCEx_MultiModeConfigChannel() is conditioned by ADCs state 256 * (both Master and Slave ADCs). 257 * Both Master and Slave ADCs must be disabled. 258 */ 259 typedef struct 260 { 261 uint32_t Mode; /*!< Configures the ADC to operate in independent or multimode. 262 This parameter can be a value of @ref ADC_HAL_EC_MULTI_MODE. */ 263 264 uint32_t DMAAccessMode; /*!< Configures the DMA mode for multimode ADC: 265 selection whether 2 DMA channels (each ADC uses its own DMA channel) or 1 DMA channel 266 (one DMA channel for both ADC, DMA of ADC master). 267 This parameter can be a value of @ref ADC_HAL_EC_MULTI_DMA_TRANSFER_RESOLUTION. */ 268 269 uint32_t TwoSamplingDelay; /*!< Configures the Delay between 2 sampling phases. 270 This parameter can be a value of @ref ADC_HAL_EC_MULTI_TWOSMP_DELAY. 271 Delay range depends on selected resolution: 272 from 1 to 12 clock cycles for 12 bits, from 1 to 10 clock cycles for 10 bits, 273 from 1 to 8 clock cycles for 8 bits, from 1 to 6 clock cycles for 6 bits. */ 274 } ADC_MultiModeTypeDef; 275 #endif /* ADC_MULTIMODE_SUPPORT */ 276 277 /** 278 * @} 279 */ 280 281 /* Exported constants --------------------------------------------------------*/ 282 283 /** @defgroup ADCEx_Exported_Constants ADC Extended Exported Constants 284 * @{ 285 */ 286 287 /** @defgroup ADC_injected_external_trigger_source ADC group injected trigger source 288 * @{ 289 */ 290 /* ADC group regular trigger sources for all ADC instances */ 291 #define ADC_INJECTED_SOFTWARE_START (LL_ADC_INJ_TRIG_SOFTWARE) /*!< ADC group injected conversion 292 trigger software start */ 293 #define ADC_EXTERNALTRIGINJEC_T1_TRGO (LL_ADC_INJ_TRIG_EXT_TIM1_TRGO) /*!< ADC group injected conversion 294 trigger from external peripheral: TIM1 TRGO. */ 295 #define ADC_EXTERNALTRIGINJEC_T1_TRGO2 (LL_ADC_INJ_TRIG_EXT_TIM1_TRGO2) /*!< ADC group injected conversion 296 trigger from external peripheral: TIM1 TRGO2. */ 297 #define ADC_EXTERNALTRIGINJEC_T1_CC3 (LL_ADC_INJ_TRIG_EXT_TIM1_CH3) /*!< ADC group injected conversion 298 trigger from external peripheral: TIM1 channel 3 event (capture compare). */ 299 #define ADC_EXTERNALTRIGINJEC_T1_CC4 (LL_ADC_INJ_TRIG_EXT_TIM1_CH4) /*!< ADC group injected conversion 300 trigger from external peripheral: TIM1 channel 4 event (capture compare). */ 301 #define ADC_EXTERNALTRIGINJEC_T2_TRGO (LL_ADC_INJ_TRIG_EXT_TIM2_TRGO) /*!< ADC group injected conversion 302 trigger from external peripheral: TIM2 TRGO. */ 303 #define ADC_EXTERNALTRIGINJEC_T2_CC1 (LL_ADC_INJ_TRIG_EXT_TIM2_CH1) /*!< ADC group injected conversion 304 trigger from external peripheral: TIM2 channel 1 event (capture compare). */ 305 #define ADC_EXTERNALTRIGINJEC_T3_TRGO (LL_ADC_INJ_TRIG_EXT_TIM3_TRGO) /*!< ADC group injected conversion 306 trigger from external peripheral: TIM3 TRGO. */ 307 #define ADC_EXTERNALTRIGINJEC_T3_CC1 (LL_ADC_INJ_TRIG_EXT_TIM3_CH1) /*!< ADC group injected conversion 308 trigger from external peripheral: TIM3 channel 1 event (capture compare). */ 309 #define ADC_EXTERNALTRIGINJEC_T3_CC3 (LL_ADC_INJ_TRIG_EXT_TIM3_CH3) /*!< ADC group injected conversion 310 trigger from external peripheral: TIM3 channel 3 event (capture compare). */ 311 #define ADC_EXTERNALTRIGINJEC_T3_CC4 (LL_ADC_INJ_TRIG_EXT_TIM3_CH4) /*!< ADC group injected conversion 312 trigger from external peripheral: TIM3 channel 4 event (capture compare). */ 313 #define ADC_EXTERNALTRIGINJEC_T4_TRGO (LL_ADC_INJ_TRIG_EXT_TIM4_TRGO) /*!< ADC group injected conversion 314 trigger from external peripheral: TIM4 TRGO. */ 315 #define ADC_EXTERNALTRIGINJEC_T4_CC3 (LL_ADC_INJ_TRIG_EXT_TIM4_CH3) /*!< ADC group injected conversion 316 trigger from external peripheral: TIM4 channel 3 event (capture compare). */ 317 #define ADC_EXTERNALTRIGINJEC_T4_CC4 (LL_ADC_INJ_TRIG_EXT_TIM4_CH4) /*!< ADC group injected conversion 318 trigger from external peripheral: TIM4 channel 4 event (capture compare). */ 319 #define ADC_EXTERNALTRIGINJEC_T6_TRGO (LL_ADC_INJ_TRIG_EXT_TIM6_TRGO) /*!< ADC group injected conversion 320 trigger from external peripheral: TIM6 TRGO. */ 321 #define ADC_EXTERNALTRIGINJEC_T7_TRGO (LL_ADC_INJ_TRIG_EXT_TIM7_TRGO) /*!< ADC group injected conversion 322 trigger from external peripheral: TIM7 TRGO. */ 323 #define ADC_EXTERNALTRIGINJEC_T8_TRGO (LL_ADC_INJ_TRIG_EXT_TIM8_TRGO) /*!< ADC group injected conversion 324 trigger from external peripheral: TIM8 TRGO. */ 325 #define ADC_EXTERNALTRIGINJEC_T8_TRGO2 (LL_ADC_INJ_TRIG_EXT_TIM8_TRGO2) /*!< ADC group injected conversion 326 trigger from external peripheral: TIM8 TRGO2. */ 327 #define ADC_EXTERNALTRIGINJEC_T8_CC2 (LL_ADC_INJ_TRIG_EXT_TIM8_CH2) /*!< ADC group injected conversion 328 trigger from external peripheral: TIM8 channel 2 event (capture compare). */ 329 #define ADC_EXTERNALTRIGINJEC_T8_CC4 (LL_ADC_INJ_TRIG_EXT_TIM8_CH4) /*!< ADC group injected conversion 330 trigger from external peripheral: TIM8 channel 4 event (capture compare). */ 331 #define ADC_EXTERNALTRIGINJEC_T15_TRGO (LL_ADC_INJ_TRIG_EXT_TIM15_TRGO) /*!< ADC group injected conversion 332 trigger from external peripheral: TIM15 TRGO. */ 333 #define ADC_EXTERNALTRIGINJEC_T16_CC1 (LL_ADC_INJ_TRIG_EXT_TIM16_CH1) /*!< ADC group injected conversion 334 trigger from external peripheral: TIM8 channel 4 event (capture compare). */ 335 #define ADC_EXTERNALTRIGINJEC_T20_TRGO (LL_ADC_INJ_TRIG_EXT_TIM20_TRGO) /*!< ADC group injected conversion 336 trigger from external peripheral: TIM20 TRGO. */ 337 #define ADC_EXTERNALTRIGINJEC_T20_TRGO2 (LL_ADC_INJ_TRIG_EXT_TIM20_TRGO2) /*!< ADC group injected conversion 338 trigger from external peripheral: TIM20 TRGO2. */ 339 #define ADC_EXTERNALTRIGINJEC_T20_CC2 (LL_ADC_INJ_TRIG_EXT_TIM20_CH2) /*!< ADC group injected conversion 340 trigger from external peripheral: TIM20 channel 2 event (capture compare). */ 341 #define ADC_EXTERNALTRIGINJEC_T20_CC4 (LL_ADC_INJ_TRIG_EXT_TIM20_CH4) /*!< ADC group injected conversion 342 trigger from external peripheral: TIM20 channel 4 event (capture compare). */ 343 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG1 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG1) /*!< ADC group injected conversion 344 trigger from external peripheral: HRTIMER ADC trigger 1 event. */ 345 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG2 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG2) /*!< ADC group injected conversion 346 trigger from external peripheral: HRTIMER ADC trigger 2 event. */ 347 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG3 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG3) /*!< ADC group injected conversion 348 trigger from external peripheral: HRTIMER ADC trigger 3 event. */ 349 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG4 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG4) /*!< ADC group injected conversion 350 trigger from external peripheral: HRTIMER ADC trigger 4 event. */ 351 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG5 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG5) /*!< ADC group injected conversion 352 trigger from external peripheral: HRTIMER ADC trigger 5 event. */ 353 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG6 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG6) /*!< ADC group injected conversion 354 trigger from external peripheral: HRTIMER ADC trigger 6 event. */ 355 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG7 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG7) /*!< ADC group injected conversion 356 trigger from external peripheral: HRTIMER ADC trigger 7 event. */ 357 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG8 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG8) /*!< ADC group injected conversion 358 trigger from external peripheral: HRTIMER ADC trigger 8 event. */ 359 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG9 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG9) /*!< ADC group injected conversion 360 trigger from external peripheral: HRTIMER ADC trigger 9 event. */ 361 #define ADC_EXTERNALTRIGINJEC_HRTIM_TRG10 (LL_ADC_INJ_TRIG_EXT_HRTIM_TRG10) /*!< ADC group injected conversion 362 trigger from external peripheral: HRTIMER ADC trigger 10 event. */ 363 #define ADC_EXTERNALTRIGINJEC_EXT_IT3 (LL_ADC_INJ_TRIG_EXT_EXTI_LINE3) /*!< ADC group injected conversion 364 trigger from external peripheral: external interrupt line 3. */ 365 #define ADC_EXTERNALTRIGINJEC_EXT_IT15 (LL_ADC_INJ_TRIG_EXT_EXTI_LINE15) /*!< ADC group injected conversion 366 trigger from external peripheral: external interrupt line 15. */ 367 #define ADC_EXTERNALTRIGINJEC_LPTIM_OUT (LL_ADC_INJ_TRIG_EXT_LPTIM_OUT) /*!< ADC group injected conversion 368 trigger from external peripheral: LPTIMER OUT event. */ 369 /** 370 * @} 371 */ 372 373 /** @defgroup ADC_injected_external_trigger_edge ADC group injected trigger edge (when external trigger is selected) 374 * @{ 375 */ 376 #define ADC_EXTERNALTRIGINJECCONV_EDGE_NONE (0x00000000UL) /*!< Injected conversions trigger 377 disabled (SW start)*/ 378 #define ADC_EXTERNALTRIGINJECCONV_EDGE_RISING (ADC_JSQR_JEXTEN_0) /*!< Injected conversions trigger 379 polarity set to rising edge */ 380 #define ADC_EXTERNALTRIGINJECCONV_EDGE_FALLING (ADC_JSQR_JEXTEN_1) /*!< Injected conversions trigger 381 polarity set to falling edge */ 382 #define ADC_EXTERNALTRIGINJECCONV_EDGE_RISINGFALLING (ADC_JSQR_JEXTEN) /*!< Injected conversions trigger 383 polarity set to both rising and falling edges */ 384 /** 385 * @} 386 */ 387 388 /** @defgroup ADC_HAL_EC_CHANNEL_SINGLE_DIFF_ENDING Channel - Single or differential ending 389 * @{ 390 */ 391 #define ADC_SINGLE_ENDED (LL_ADC_SINGLE_ENDED) /*!< ADC channel ending set to single ended */ 392 #define ADC_DIFFERENTIAL_ENDED (LL_ADC_DIFFERENTIAL_ENDED) /*!< ADC channel ending set to differential */ 393 /** 394 * @} 395 */ 396 397 /** @defgroup ADC_HAL_EC_OFFSET_NB ADC instance - Offset number 398 * @{ 399 */ 400 #define ADC_OFFSET_NONE (ADC_OFFSET_4 + 1U) /*!< ADC offset disabled: no offset correction for the selected 401 ADC channel */ 402 #define ADC_OFFSET_1 (LL_ADC_OFFSET_1) /*!< ADC offset number 1: ADC channel and offset level to which 403 the offset programmed will be applied (independently of channel mapped 404 on ADC group regular or group injected) */ 405 #define ADC_OFFSET_2 (LL_ADC_OFFSET_2) /*!< ADC offset number 2: ADC channel and offset level to which 406 the offset programmed will be applied (independently of channel mapped 407 on ADC group regular or group injected) */ 408 #define ADC_OFFSET_3 (LL_ADC_OFFSET_3) /*!< ADC offset number 3: ADC channel and offset level to which 409 the offset programmed will be applied (independently of channel mapped 410 on ADC group regular or group injected) */ 411 #define ADC_OFFSET_4 (LL_ADC_OFFSET_4) /*!< ADC offset number 4: ADC channel and offset level to which 412 the offset programmed will be applied (independently of channel mapped 413 on ADC group regular or group injected) */ 414 /** 415 * @} 416 */ 417 418 /** @defgroup ADCEx_OffsetSign ADC Extended Offset Sign 419 * @{ 420 */ 421 #define ADC_OFFSET_SIGN_NEGATIVE (0x00000000UL) /*!< Offset sign negative, offset is subtracted */ 422 #define ADC_OFFSET_SIGN_POSITIVE (ADC_OFR1_OFFSETPOS) /*!< Offset sign positive, offset is added */ 423 /** 424 * @} 425 */ 426 427 /** @defgroup ADC_INJ_SEQ_RANKS ADC group injected - Sequencer ranks 428 * @{ 429 */ 430 #define ADC_INJECTED_RANK_1 (LL_ADC_INJ_RANK_1) /*!< ADC group injected sequencer rank 1 */ 431 #define ADC_INJECTED_RANK_2 (LL_ADC_INJ_RANK_2) /*!< ADC group injected sequencer rank 2 */ 432 #define ADC_INJECTED_RANK_3 (LL_ADC_INJ_RANK_3) /*!< ADC group injected sequencer rank 3 */ 433 #define ADC_INJECTED_RANK_4 (LL_ADC_INJ_RANK_4) /*!< ADC group injected sequencer rank 4 */ 434 /** 435 * @} 436 */ 437 438 #if defined(ADC_MULTIMODE_SUPPORT) 439 /** @defgroup ADC_HAL_EC_MULTI_MODE Multimode - Mode 440 * @{ 441 */ 442 #define ADC_MODE_INDEPENDENT (LL_ADC_MULTI_INDEPENDENT) /*!< ADC dual mode disabled 443 (ADC independent mode) */ 444 #define ADC_DUALMODE_REGSIMULT (LL_ADC_MULTI_DUAL_REG_SIMULT) /*!< ADC dual mode enabled: group regular 445 simultaneous */ 446 #define ADC_DUALMODE_INTERL (LL_ADC_MULTI_DUAL_REG_INTERL) /*!< ADC dual mode enabled: Combined 447 group regular interleaved */ 448 #define ADC_DUALMODE_INJECSIMULT (LL_ADC_MULTI_DUAL_INJ_SIMULT) /*!< ADC dual mode enabled: group 449 injected simultaneous */ 450 #define ADC_DUALMODE_ALTERTRIG (LL_ADC_MULTI_DUAL_INJ_ALTERN) /*!< ADC dual mode enabled: group 451 injected alternate trigger. Works only with external triggers (not internal 452 SW start) */ 453 #define ADC_DUALMODE_REGSIMULT_INJECSIMULT (LL_ADC_MULTI_DUAL_REG_SIM_INJ_SIM) /*!< ADC dual mode enabled: Combined 454 group regular simultaneous + group injected simultaneous */ 455 #define ADC_DUALMODE_REGSIMULT_ALTERTRIG (LL_ADC_MULTI_DUAL_REG_SIM_INJ_ALT) /*!< ADC dual mode enabled: Combined 456 group regular simultaneous + group injected alternate trigger */ 457 #define ADC_DUALMODE_REGINTERL_INJECSIMULT (LL_ADC_MULTI_DUAL_REG_INT_INJ_SIM) /*!< ADC dual mode enabled: Combined 458 group regular interleaved + group injected simultaneous */ 459 460 /** @defgroup ADC_HAL_EC_MULTI_DMA_TRANSFER_RESOLUTION Multimode - DMA transfer mode depending on ADC resolution 461 * @{ 462 */ 463 #define ADC_DMAACCESSMODE_DISABLED (0x00000000UL) /*!< DMA multimode disabled: each ADC uses its own 464 DMA channel */ 465 #define ADC_DMAACCESSMODE_12_10_BITS (ADC_CCR_MDMA_1) /*!< DMA multimode enabled (one DMA channel for both ADC, 466 DMA of ADC master) for 12 and 10 bits resolution */ 467 #define ADC_DMAACCESSMODE_8_6_BITS (ADC_CCR_MDMA) /*!< DMA multimode enabled (one DMA channel for both ADC, 468 DMA of ADC master) for 8 and 6 bits resolution */ 469 /** 470 * @} 471 */ 472 473 /** @defgroup ADC_HAL_EC_MULTI_TWOSMP_DELAY Multimode - Delay between two sampling phases 474 * @{ 475 */ 476 #define ADC_TWOSAMPLINGDELAY_1CYCLE (LL_ADC_MULTI_TWOSMP_DELAY_1CYCLE) /*!< ADC multimode delay between two 477 sampling phases: 1 ADC clock cycle */ 478 #define ADC_TWOSAMPLINGDELAY_2CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_2CYCLES) /*!< ADC multimode delay between two 479 sampling phases: 2 ADC clock cycles */ 480 #define ADC_TWOSAMPLINGDELAY_3CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_3CYCLES) /*!< ADC multimode delay between two 481 sampling phases: 3 ADC clock cycles */ 482 #define ADC_TWOSAMPLINGDELAY_4CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_4CYCLES) /*!< ADC multimode delay between two 483 sampling phases: 4 ADC clock cycles */ 484 #define ADC_TWOSAMPLINGDELAY_5CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_5CYCLES) /*!< ADC multimode delay between two 485 sampling phases: 5 ADC clock cycles */ 486 #define ADC_TWOSAMPLINGDELAY_6CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_6CYCLES) /*!< ADC multimode delay between two 487 sampling phases: 6 ADC clock cycles */ 488 #define ADC_TWOSAMPLINGDELAY_7CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_7CYCLES) /*!< ADC multimode delay between two 489 sampling phases: 7 ADC clock cycles */ 490 #define ADC_TWOSAMPLINGDELAY_8CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_8CYCLES) /*!< ADC multimode delay between two 491 sampling phases: 8 ADC clock cycles */ 492 #define ADC_TWOSAMPLINGDELAY_9CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_9CYCLES) /*!< ADC multimode delay between two 493 sampling phases: 9 ADC clock cycles */ 494 #define ADC_TWOSAMPLINGDELAY_10CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_10CYCLES) /*!< ADC multimode delay between two 495 sampling phases: 10 ADC clock cycles */ 496 #define ADC_TWOSAMPLINGDELAY_11CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_11CYCLES) /*!< ADC multimode delay between two 497 sampling phases: 11 ADC clock cycles */ 498 #define ADC_TWOSAMPLINGDELAY_12CYCLES (LL_ADC_MULTI_TWOSMP_DELAY_12CYCLES) /*!< ADC multimode delay between two 499 sampling phases: 12 ADC clock cycles */ 500 /** 501 * @} 502 */ 503 504 /** 505 * @} 506 */ 507 #endif /* ADC_MULTIMODE_SUPPORT */ 508 509 /** @defgroup ADC_HAL_EC_GROUPS ADC instance - Groups 510 * @{ 511 */ 512 #define ADC_REGULAR_GROUP (LL_ADC_GROUP_REGULAR) /*!< ADC group regular (available on 513 all STM32 devices) */ 514 #define ADC_INJECTED_GROUP (LL_ADC_GROUP_INJECTED) /*!< ADC group injected (not available on 515 all STM32 devices) */ 516 #define ADC_REGULAR_INJECTED_GROUP (LL_ADC_GROUP_REGULAR_INJECTED) /*!< ADC both groups regular and injected */ 517 /** 518 * @} 519 */ 520 521 /** @defgroup ADC_CFGR_fields ADCx CFGR fields 522 * @{ 523 */ 524 #define ADC_CFGR_FIELDS (ADC_CFGR_AWD1CH | ADC_CFGR_JAUTO | ADC_CFGR_JAWD1EN |\ 525 ADC_CFGR_AWD1EN | ADC_CFGR_AWD1SGL | ADC_CFGR_JQM |\ 526 ADC_CFGR_JDISCEN | ADC_CFGR_DISCNUM | ADC_CFGR_DISCEN |\ 527 ADC_CFGR_AUTDLY | ADC_CFGR_CONT | ADC_CFGR_OVRMOD |\ 528 ADC_CFGR_EXTEN | ADC_CFGR_EXTSEL | ADC_CFGR_ALIGN |\ 529 ADC_CFGR_RES | ADC_CFGR_DMACFG | ADC_CFGR_DMAEN ) 530 /** 531 * @} 532 */ 533 534 /** @defgroup ADC_SMPR1_fields ADCx SMPR1 fields 535 * @{ 536 */ 537 #if defined(ADC_SMPR1_SMPPLUS) 538 #define ADC_SMPR1_FIELDS (ADC_SMPR1_SMP9 | ADC_SMPR1_SMP8 | ADC_SMPR1_SMP7 |\ 539 ADC_SMPR1_SMP6 | ADC_SMPR1_SMP5 | ADC_SMPR1_SMP4 |\ 540 ADC_SMPR1_SMP3 | ADC_SMPR1_SMP2 | ADC_SMPR1_SMP1 |\ 541 ADC_SMPR1_SMP0 | ADC_SMPR1_SMPPLUS) 542 #else 543 #define ADC_SMPR1_FIELDS (ADC_SMPR1_SMP9 | ADC_SMPR1_SMP8 | ADC_SMPR1_SMP7 |\ 544 ADC_SMPR1_SMP6 | ADC_SMPR1_SMP5 | ADC_SMPR1_SMP4 |\ 545 ADC_SMPR1_SMP3 | ADC_SMPR1_SMP2 | ADC_SMPR1_SMP1 |\ 546 ADC_SMPR1_SMP0) 547 #endif /* ADC_SMPR1_SMPPLUS */ 548 /** 549 * @} 550 */ 551 552 /** @defgroup ADC_CFGR_fields_2 ADCx CFGR sub fields 553 * @{ 554 */ 555 /* ADC_CFGR fields of parameters that can be updated when no conversion 556 (neither regular nor injected) is on-going */ 557 #define ADC_CFGR_FIELDS_2 ((ADC_CFGR_DMACFG | ADC_CFGR_AUTDLY)) 558 /** 559 * @} 560 */ 561 562 /** 563 * @} 564 */ 565 566 /* Exported macros -----------------------------------------------------------*/ 567 568 #if defined(ADC_MULTIMODE_SUPPORT) 569 /** @defgroup ADCEx_Exported_Macro ADC Extended Exported Macros 570 * @{ 571 */ 572 573 /** @brief Force ADC instance in multimode mode independent (multimode disable). 574 * @note This macro must be used only in case of transition from multimode 575 * to mode independent and in case of unknown previous state, 576 * to ensure ADC configuration is in mode independent. 577 * @note Standard way of multimode configuration change is done from 578 * HAL ADC handle of ADC master using function 579 * "HAL_ADCEx_MultiModeConfigChannel(..., ADC_MODE_INDEPENDENT)" )". 580 * Usage of this macro is not the Standard way of multimode 581 * configuration and can lead to have HAL ADC handles status 582 * misaligned. Usage of this macro must be limited to cases 583 * mentioned above. 584 * @param __HANDLE__ ADC handle. 585 * @retval None 586 */ 587 #define ADC_FORCE_MODE_INDEPENDENT(__HANDLE__) \ 588 LL_ADC_SetMultimode(__LL_ADC_COMMON_INSTANCE((__HANDLE__)->Instance), LL_ADC_MULTI_INDEPENDENT) 589 590 /** 591 * @} 592 */ 593 #endif /* ADC_MULTIMODE_SUPPORT */ 594 595 /* Private macros ------------------------------------------------------------*/ 596 597 /** @defgroup ADCEx_Private_Macro_internal_HAL_driver ADC Extended Private Macros 598 * @{ 599 */ 600 /* Macro reserved for internal HAL driver usage, not intended to be used in */ 601 /* code of final user. */ 602 603 /** 604 * @brief Test if conversion trigger of injected group is software start 605 * or external trigger. 606 * @param __HANDLE__ ADC handle. 607 * @retval SET (software start) or RESET (external trigger). 608 */ 609 #define ADC_IS_SOFTWARE_START_INJECTED(__HANDLE__) \ 610 (((__HANDLE__)->Instance->JSQR & ADC_JSQR_JEXTEN) == 0UL) 611 612 /** 613 * @brief Check whether or not ADC is independent. 614 * @param __HANDLE__ ADC handle. 615 * @note When multimode feature is not available, the macro always returns SET. 616 * @retval SET (ADC is independent) or RESET (ADC is not). 617 */ 618 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 619 #define ADC_IS_INDEPENDENT(__HANDLE__) \ 620 ( ( ( ((__HANDLE__)->Instance) == ADC5) \ 621 )? \ 622 SET \ 623 : \ 624 RESET \ 625 ) 626 #elif defined(STM32G491xx) || defined(STM32G4A1xx) || defined(STM32G411xC) 627 #define ADC_IS_INDEPENDENT(__HANDLE__) \ 628 ( ( ( ((__HANDLE__)->Instance) == ADC3) \ 629 )? \ 630 SET \ 631 : \ 632 RESET \ 633 ) 634 #elif defined(STM32G411xB) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) || defined(STM32G471xx) 635 #define ADC_IS_INDEPENDENT(__HANDLE__) (RESET) 636 #endif /* defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) */ 637 638 /** 639 * @brief Set the selected injected Channel rank. 640 * @param __CHANNELNB__ Channel number. 641 * @param __RANKNB__ Rank number. 642 * @retval None 643 */ 644 #define ADC_JSQR_RK(__CHANNELNB__, __RANKNB__) \ 645 ((((__CHANNELNB__) & ADC_CHANNEL_ID_NUMBER_MASK) >> ADC_CHANNEL_ID_NUMBER_BITOFFSET_POS) \ 646 << ((__RANKNB__) & ADC_INJ_RANK_ID_JSQR_MASK)) 647 648 /** 649 * @brief Configure ADC injected context queue 650 * @param __INJECT_CONTEXT_QUEUE_MODE__ Injected context queue mode. 651 * @retval None 652 */ 653 #define ADC_CFGR_INJECT_CONTEXT_QUEUE(__INJECT_CONTEXT_QUEUE_MODE__) \ 654 ((__INJECT_CONTEXT_QUEUE_MODE__) << ADC_CFGR_JQM_Pos) 655 656 /** 657 * @brief Configure ADC discontinuous conversion mode for injected group 658 * @param __INJECT_DISCONTINUOUS_MODE__ Injected discontinuous mode. 659 * @retval None 660 */ 661 #define ADC_CFGR_INJECT_DISCCONTINUOUS(__INJECT_DISCONTINUOUS_MODE__) \ 662 ((__INJECT_DISCONTINUOUS_MODE__) << ADC_CFGR_JDISCEN_Pos) 663 664 /** 665 * @brief Configure ADC discontinuous conversion mode for regular group 666 * @param __REG_DISCONTINUOUS_MODE__ Regular discontinuous mode. 667 * @retval None 668 */ 669 #define ADC_CFGR_REG_DISCONTINUOUS(__REG_DISCONTINUOUS_MODE__) \ 670 ((__REG_DISCONTINUOUS_MODE__) << ADC_CFGR_DISCEN_Pos) 671 672 /** 673 * @brief Configure the number of discontinuous conversions for regular group. 674 * @param __NBR_DISCONTINUOUS_CONV__ Number of discontinuous conversions. 675 * @retval None 676 */ 677 #define ADC_CFGR_DISCONTINUOUS_NUM(__NBR_DISCONTINUOUS_CONV__) \ 678 (((__NBR_DISCONTINUOUS_CONV__) - 1UL) << ADC_CFGR_DISCNUM_Pos) 679 680 /** 681 * @brief Configure the ADC auto delay mode. 682 * @param __AUTOWAIT__ Auto delay bit enable or disable. 683 * @retval None 684 */ 685 #define ADC_CFGR_AUTOWAIT(__AUTOWAIT__) ((__AUTOWAIT__) << ADC_CFGR_AUTDLY_Pos) 686 687 /** 688 * @brief Configure ADC continuous conversion mode. 689 * @param __CONTINUOUS_MODE__ Continuous mode. 690 * @retval None 691 */ 692 #define ADC_CFGR_CONTINUOUS(__CONTINUOUS_MODE__) ((__CONTINUOUS_MODE__) << ADC_CFGR_CONT_Pos) 693 694 /** 695 * @brief Configure the ADC DMA continuous request. 696 * @param __DMACONTREQ_MODE__ DMA continuous request mode. 697 * @retval None 698 */ 699 #define ADC_CFGR_DMACONTREQ(__DMACONTREQ_MODE__) ((__DMACONTREQ_MODE__) << ADC_CFGR_DMACFG_Pos) 700 701 #if defined(ADC_MULTIMODE_SUPPORT) 702 /** 703 * @brief Configure the ADC DMA continuous request for ADC multimode. 704 * @param __DMACONTREQ_MODE__ DMA continuous request mode. 705 * @retval None 706 */ 707 #define ADC_CCR_MULTI_DMACONTREQ(__DMACONTREQ_MODE__) ((__DMACONTREQ_MODE__) << ADC_CCR_DMACFG_Pos) 708 #endif /* ADC_MULTIMODE_SUPPORT */ 709 710 /** 711 * @brief Shift the offset with respect to the selected ADC resolution. 712 * @note Offset has to be left-aligned on bit 11, the LSB (right bits) are set to 0. 713 * If resolution 12 bits, no shift. 714 * If resolution 10 bits, shift of 2 ranks on the left. 715 * If resolution 8 bits, shift of 4 ranks on the left. 716 * If resolution 6 bits, shift of 6 ranks on the left. 717 * Therefore, shift = (12 - resolution) = 12 - (12- (((RES[1:0]) >> 3)*2)). 718 * @param __HANDLE__ ADC handle 719 * @param __OFFSET__ Value to be shifted 720 * @retval None 721 */ 722 #define ADC_OFFSET_SHIFT_RESOLUTION(__HANDLE__, __OFFSET__) \ 723 ((__OFFSET__) << ((((__HANDLE__)->Instance->CFGR & ADC_CFGR_RES) >> 3UL) * 2UL)) 724 725 /** 726 * @brief Shift the AWD1 threshold with respect to the selected ADC resolution. 727 * @note Thresholds have to be left-aligned on bit 11, the LSB (right bits) are set to 0. 728 * If resolution 12 bits, no shift. 729 * If resolution 10 bits, shift of 2 ranks on the left. 730 * If resolution 8 bits, shift of 4 ranks on the left. 731 * If resolution 6 bits, shift of 6 ranks on the left. 732 * Therefore, shift = (12 - resolution) = 12 - (12- (((RES[1:0]) >> 3)*2)). 733 * @param __HANDLE__ ADC handle 734 * @param __THRESHOLD__ Value to be shifted 735 * @retval None 736 */ 737 #define ADC_AWD1THRESHOLD_SHIFT_RESOLUTION(__HANDLE__, __THRESHOLD__) \ 738 ((__THRESHOLD__) << ((((__HANDLE__)->Instance->CFGR & ADC_CFGR_RES) >> 3UL) * 2UL)) 739 740 /** 741 * @brief Shift the AWD2 and AWD3 threshold with respect to the selected ADC resolution. 742 * @note Thresholds have to be left-aligned on bit 7. 743 * If resolution 12 bits, shift of 4 ranks on the right (the 4 LSB are discarded). 744 * If resolution 10 bits, shift of 2 ranks on the right (the 2 LSB are discarded). 745 * If resolution 8 bits, no shift. 746 * If resolution 6 bits, shift of 2 ranks on the left (the 2 LSB are set to 0). 747 * @param __HANDLE__ ADC handle 748 * @param __THRESHOLD__ Value to be shifted 749 * @retval None 750 */ 751 #define ADC_AWD23THRESHOLD_SHIFT_RESOLUTION(__HANDLE__, __THRESHOLD__) \ 752 ((((__HANDLE__)->Instance->CFGR & ADC_CFGR_RES) != (ADC_CFGR_RES_1 | ADC_CFGR_RES_0)) ? \ 753 ((__THRESHOLD__) >> ((4UL - ((((__HANDLE__)->Instance->CFGR & ADC_CFGR_RES) >> 3UL) * 2UL)) & 0x1FUL)) : \ 754 ((__THRESHOLD__) << 2UL) \ 755 ) 756 757 /** 758 * @brief Clear Common Control Register. 759 * @param __HANDLE__ ADC handle. 760 * @retval None 761 */ 762 #if defined(ADC_MULTIMODE_SUPPORT) 763 #define ADC_CLEAR_COMMON_CONTROL_REGISTER(__HANDLE__) CLEAR_BIT(__LL_ADC_COMMON_INSTANCE((__HANDLE__)->Instance)->CCR, \ 764 ADC_CCR_CKMODE | \ 765 ADC_CCR_PRESC | \ 766 ADC_CCR_VBATSEL | \ 767 ADC_CCR_VSENSESEL | \ 768 ADC_CCR_VREFEN | \ 769 ADC_CCR_MDMA | \ 770 ADC_CCR_DMACFG | \ 771 ADC_CCR_DELAY | \ 772 ADC_CCR_DUAL) 773 #endif /* ADC_MULTIMODE_SUPPORT */ 774 775 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 776 /** 777 * @brief Set handle instance of the ADC slave associated to the ADC master. 778 * @param __HANDLE_MASTER__ ADC master handle. 779 * @param __HANDLE_SLAVE__ ADC slave handle. 780 * @note if __HANDLE_MASTER__ is the handle of a slave ADC or an independent ADC, __HANDLE_SLAVE__ instance is 781 * set to NULL. 782 * @retval None 783 */ 784 #define ADC_MULTI_SLAVE(__HANDLE_MASTER__, __HANDLE_SLAVE__) \ 785 ( ((__HANDLE_MASTER__)->Instance == ADC1) ? \ 786 ((__HANDLE_SLAVE__)->Instance = ADC2) \ 787 : \ 788 ((__HANDLE_MASTER__)->Instance == ADC3) ? \ 789 ((__HANDLE_SLAVE__)->Instance = ADC4) \ 790 : \ 791 ((__HANDLE_SLAVE__)->Instance = NULL) \ 792 ) 793 #elif defined(STM32G411xB) || defined(STM32G411xC) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) || defined(STM32G471xx) || defined(STM32G491xx) || defined(STM32G4A1xx) 794 /** 795 * @brief Set handle instance of the ADC slave associated to the ADC master. 796 * @param __HANDLE_MASTER__ ADC master handle. 797 * @param __HANDLE_SLAVE__ ADC slave handle. 798 * @note if __HANDLE_MASTER__ is the handle of a slave ADC or an independent ADC, __HANDLE_SLAVE__ instance is set 799 * to NULL. 800 * @retval None 801 */ 802 #define ADC_MULTI_SLAVE(__HANDLE_MASTER__, __HANDLE_SLAVE__) \ 803 ( ((__HANDLE_MASTER__)->Instance == ADC1) ? \ 804 ((__HANDLE_SLAVE__)->Instance = ADC2) \ 805 : \ 806 ((__HANDLE_SLAVE__)->Instance = NULL) \ 807 ) 808 #endif /* STM32G4xx */ 809 810 811 /** 812 * @brief Verify the ADC instance connected to the temperature sensor. 813 * @param __HANDLE__ ADC handle. 814 * @retval SET (ADC instance is valid) or RESET (ADC instance is invalid) 815 */ 816 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 817 #define ADC_TEMPERATURE_SENSOR_INSTANCE(__HANDLE__) \ 818 ((((__HANDLE__)->Instance) == ADC1) || (((__HANDLE__)->Instance) == ADC5)) 819 #elif defined(STM32G411xB) || defined(STM32G411xC) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) || defined(STM32G471xx) || defined(STM32G491xx) || defined(STM32G4A1xx) 820 #define ADC_TEMPERATURE_SENSOR_INSTANCE(__HANDLE__) (((__HANDLE__)->Instance) == ADC1) 821 #endif /* defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) */ 822 823 /** 824 * @brief Verify the ADC instance connected to the battery voltage VBAT. 825 * @param __HANDLE__ ADC handle. 826 * @retval SET (ADC instance is valid) or RESET (ADC instance is invalid) 827 */ 828 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 829 #define ADC_BATTERY_VOLTAGE_INSTANCE(__HANDLE__) \ 830 ((((__HANDLE__)->Instance) != ADC2) || (((__HANDLE__)->Instance) != ADC4)) 831 #elif defined(STM32G411xB) || defined(STM32G411xC) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) || defined(STM32G471xx) 832 #define ADC_BATTERY_VOLTAGE_INSTANCE(__HANDLE__) (((__HANDLE__)->Instance) != ADC2) 833 #elif defined(STM32G491xx) || defined(STM32G4A1xx) 834 #define ADC_BATTERY_VOLTAGE_INSTANCE(__HANDLE__) (((__HANDLE__)->Instance) == ADC1) 835 #endif /* STM32G4xx */ 836 837 /** 838 * @brief Verify the ADC instance connected to the internal voltage reference VREFINT. 839 * @param __HANDLE__ ADC handle. 840 * @retval SET (ADC instance is valid) or RESET (ADC instance is invalid) 841 */ 842 #define ADC_VREFINT_INSTANCE(__HANDLE__) (((__HANDLE__)->Instance) != ADC2) 843 844 /** 845 * @brief Verify the length of scheduled injected conversions group. 846 * @param __LENGTH__ number of programmed conversions. 847 * @retval SET (__LENGTH__ is within the maximum number of possible programmable injected conversions) 848 * or RESET (__LENGTH__ is null or too large) 849 */ 850 #define IS_ADC_INJECTED_NB_CONV(__LENGTH__) (((__LENGTH__) >= (1U)) && ((__LENGTH__) <= (4U))) 851 852 /** 853 * @brief Calibration factor size verification (7 bits maximum). 854 * @param __CALIBRATION_FACTOR__ Calibration factor value. 855 * @retval SET (__CALIBRATION_FACTOR__ is within the authorized size) or RESET (__CALIBRATION_FACTOR__ is too large) 856 */ 857 #define IS_ADC_CALFACT(__CALIBRATION_FACTOR__) ((__CALIBRATION_FACTOR__) <= (0x7FU)) 858 859 860 /** 861 * @brief Verify the ADC channel setting. 862 * @param __HANDLE__ ADC handle. 863 * @param __CHANNEL__ programmed ADC channel. 864 * @retval SET (__CHANNEL__ is valid) or RESET (__CHANNEL__ is invalid) 865 */ 866 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 867 #define IS_ADC_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_0) || \ 868 ((__CHANNEL__) == ADC_CHANNEL_1) || \ 869 ((__CHANNEL__) == ADC_CHANNEL_2) || \ 870 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 871 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 872 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 873 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 874 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 875 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 876 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 877 ((__CHANNEL__) == ADC_CHANNEL_14) || \ 878 ((__CHANNEL__) == ADC_CHANNEL_15)) || \ 879 ((((__HANDLE__)->Instance) == ADC1) && \ 880 (((__CHANNEL__) == ADC_CHANNEL_3) || \ 881 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 882 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 883 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP1) || \ 884 ((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR_ADC1) || \ 885 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 886 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 887 ((((__HANDLE__)->Instance) == ADC2) && \ 888 (((__CHANNEL__) == ADC_CHANNEL_3) || \ 889 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 890 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 891 ((__CHANNEL__) == ADC_CHANNEL_13) || \ 892 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP2) || \ 893 ((__CHANNEL__) == ADC_CHANNEL_17) || \ 894 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC2))) || \ 895 ((((__HANDLE__)->Instance) == ADC3) && \ 896 (((__CHANNEL__) == ADC_CHANNEL_3) || \ 897 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 898 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 899 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC3) || \ 900 ((__CHANNEL__) == ADC_CHANNEL_16) || \ 901 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 902 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 903 ((((__HANDLE__)->Instance) == ADC4) && \ 904 (((__CHANNEL__) == ADC_CHANNEL_3) || \ 905 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 906 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 907 ((__CHANNEL__) == ADC_CHANNEL_13) || \ 908 ((__CHANNEL__) == ADC_CHANNEL_16) || \ 909 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP6) || \ 910 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 911 ((((__HANDLE__)->Instance) == ADC5) && \ 912 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP5) || \ 913 ((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR_ADC5) || \ 914 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP4) || \ 915 ((__CHANNEL__) == ADC_CHANNEL_13) || \ 916 ((__CHANNEL__) == ADC_CHANNEL_16) || \ 917 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 918 ((__CHANNEL__) == ADC_CHANNEL_VREFINT)))) 919 #elif defined(STM32G471xx) 920 #define IS_ADC_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_0) || \ 921 ((__CHANNEL__) == ADC_CHANNEL_1) || \ 922 ((__CHANNEL__) == ADC_CHANNEL_2) || \ 923 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 924 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 925 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 926 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 927 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 928 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 929 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 930 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 931 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 932 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 933 ((__CHANNEL__) == ADC_CHANNEL_14) || \ 934 ((__CHANNEL__) == ADC_CHANNEL_15)) || \ 935 ((((__HANDLE__)->Instance) == ADC1) && \ 936 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP1) || \ 937 ((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR_ADC1) || \ 938 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 939 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 940 ((((__HANDLE__)->Instance) == ADC2) && \ 941 (((__CHANNEL__) == ADC_CHANNEL_13) || \ 942 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP2) || \ 943 ((__CHANNEL__) == ADC_CHANNEL_17) || \ 944 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC2))) || \ 945 ((((__HANDLE__)->Instance) == ADC3) && \ 946 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC3) || \ 947 ((__CHANNEL__) == ADC_CHANNEL_16) || \ 948 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 949 ((__CHANNEL__) == ADC_CHANNEL_VREFINT)))) 950 #elif defined(STM32G411xB) || defined(STM32G411xC) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) 951 #define IS_ADC_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_0) || \ 952 ((__CHANNEL__) == ADC_CHANNEL_1) || \ 953 ((__CHANNEL__) == ADC_CHANNEL_2) || \ 954 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 955 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 956 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 957 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 958 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 959 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 960 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 961 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 962 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 963 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 964 ((__CHANNEL__) == ADC_CHANNEL_14) || \ 965 ((__CHANNEL__) == ADC_CHANNEL_15)) || \ 966 ((((__HANDLE__)->Instance) == ADC1) && \ 967 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP1) || \ 968 ((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR_ADC1) || \ 969 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 970 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 971 ((((__HANDLE__)->Instance) == ADC2) && \ 972 (((__CHANNEL__) == ADC_CHANNEL_13) || \ 973 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP2) || \ 974 ((__CHANNEL__) == ADC_CHANNEL_17) || \ 975 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC2)))) 976 #elif defined(STM32G491xx) || defined(STM32G4A1xx) 977 #define IS_ADC_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_0) || \ 978 ((__CHANNEL__) == ADC_CHANNEL_1) || \ 979 ((__CHANNEL__) == ADC_CHANNEL_2) || \ 980 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 981 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 982 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 983 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 984 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 985 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 986 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 987 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 988 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 989 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 990 ((__CHANNEL__) == ADC_CHANNEL_14) || \ 991 ((__CHANNEL__) == ADC_CHANNEL_15)) || \ 992 ((((__HANDLE__)->Instance) == ADC1) && \ 993 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP1) || \ 994 ((__CHANNEL__) == ADC_CHANNEL_TEMPSENSOR_ADC1) || \ 995 ((__CHANNEL__) == ADC_CHANNEL_VBAT) || \ 996 ((__CHANNEL__) == ADC_CHANNEL_VREFINT))) || \ 997 ((((__HANDLE__)->Instance) == ADC2) && \ 998 (((__CHANNEL__) == ADC_CHANNEL_13) || \ 999 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP2) || \ 1000 ((__CHANNEL__) == ADC_CHANNEL_17) || \ 1001 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC2))) || \ 1002 ((((__HANDLE__)->Instance) == ADC3) && \ 1003 (((__CHANNEL__) == ADC_CHANNEL_VOPAMP3_ADC3) || \ 1004 ((__CHANNEL__) == ADC_CHANNEL_16) || \ 1005 ((__CHANNEL__) == ADC_CHANNEL_VOPAMP6) || \ 1006 ((__CHANNEL__) == ADC_CHANNEL_VREFINT)))) 1007 #endif /* defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) */ 1008 1009 /** 1010 * @brief Verify the ADC channel setting in differential mode. 1011 * @param __HANDLE__ ADC handle. 1012 * @param __CHANNEL__ programmed ADC channel. 1013 * @retval SET (__CHANNEL__ is valid) or RESET (__CHANNEL__ is invalid) 1014 */ 1015 #if defined(STM32G474xx) || defined(STM32G484xx) || defined(STM32G473xx) || defined(STM32G483xx) 1016 #define IS_ADC_DIFF_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_1) || \ 1017 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 1018 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 1019 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 1020 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 1021 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 1022 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 1023 ((__CHANNEL__) == ADC_CHANNEL_14)) || \ 1024 ((((__HANDLE__)->Instance) == ADC1) && \ 1025 (((__CHANNEL__) == ADC_CHANNEL_2) || \ 1026 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1027 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1028 ((__CHANNEL__) == ADC_CHANNEL_5))) || \ 1029 ((((__HANDLE__)->Instance) == ADC2) && \ 1030 (((__CHANNEL__) == ADC_CHANNEL_2) || \ 1031 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1032 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1033 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 1034 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 1035 ((__CHANNEL__) == ADC_CHANNEL_13))) || \ 1036 ((((__HANDLE__)->Instance) == ADC3) && \ 1037 (((__CHANNEL__) == ADC_CHANNEL_2) || \ 1038 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1039 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1040 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 1041 ((__CHANNEL__) == ADC_CHANNEL_15))) || \ 1042 ((((__HANDLE__)->Instance) == ADC4) && \ 1043 (((__CHANNEL__) == ADC_CHANNEL_2) || \ 1044 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1045 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1046 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 1047 ((__CHANNEL__) == ADC_CHANNEL_12) || \ 1048 ((__CHANNEL__) == ADC_CHANNEL_13) || \ 1049 ((__CHANNEL__) == ADC_CHANNEL_15))) || \ 1050 ((((__HANDLE__)->Instance) == ADC5) && \ 1051 (((__CHANNEL__) == ADC_CHANNEL_12) || \ 1052 ((__CHANNEL__) == ADC_CHANNEL_13) || \ 1053 ((__CHANNEL__) == ADC_CHANNEL_15))) ) 1054 #elif defined(STM32G471xx) || defined(STM32G491xx) || defined(STM32G4A1xx) || defined(STM32G411xC) 1055 #define IS_ADC_DIFF_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_1) || \ 1056 (((__CHANNEL__) == ADC_CHANNEL_2) || \ 1057 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1058 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1059 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 1060 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 1061 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 1062 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 1063 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 1064 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 1065 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 1066 ((__CHANNEL__) == ADC_CHANNEL_14)) || \ 1067 ((((__HANDLE__)->Instance) == ADC2) && \ 1068 (((__CHANNEL__) == ADC_CHANNEL_12) || \ 1069 ((__CHANNEL__) == ADC_CHANNEL_13))) || \ 1070 ((((__HANDLE__)->Instance) == ADC3) && \ 1071 ((__CHANNEL__) == ADC_CHANNEL_15))) ) 1072 #elif defined(STM32G411xB) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) 1073 #define IS_ADC_DIFF_CHANNEL(__HANDLE__, __CHANNEL__) ( ( ((__CHANNEL__) == ADC_CHANNEL_1) || \ 1074 ((__CHANNEL__) == ADC_CHANNEL_2) || \ 1075 ((__CHANNEL__) == ADC_CHANNEL_3) || \ 1076 ((__CHANNEL__) == ADC_CHANNEL_4) || \ 1077 ((__CHANNEL__) == ADC_CHANNEL_5) || \ 1078 ((__CHANNEL__) == ADC_CHANNEL_6) || \ 1079 ((__CHANNEL__) == ADC_CHANNEL_7) || \ 1080 ((__CHANNEL__) == ADC_CHANNEL_8) || \ 1081 ((__CHANNEL__) == ADC_CHANNEL_9) || \ 1082 ((__CHANNEL__) == ADC_CHANNEL_10) || \ 1083 ((__CHANNEL__) == ADC_CHANNEL_11) || \ 1084 ((__CHANNEL__) == ADC_CHANNEL_14)) || \ 1085 ((((__HANDLE__)->Instance) == ADC2) && \ 1086 (((__CHANNEL__) == ADC_CHANNEL_12) || \ 1087 ((__CHANNEL__) == ADC_CHANNEL_13))) ) 1088 #endif /* STM32G4xx */ 1089 1090 /** 1091 * @brief Verify the ADC single-ended input or differential mode setting. 1092 * @param __SING_DIFF__ programmed channel setting. 1093 * @retval SET (__SING_DIFF__ is valid) or RESET (__SING_DIFF__ is invalid) 1094 */ 1095 #define IS_ADC_SINGLE_DIFFERENTIAL(__SING_DIFF__) (((__SING_DIFF__) == ADC_SINGLE_ENDED) || \ 1096 ((__SING_DIFF__) == ADC_DIFFERENTIAL_ENDED) ) 1097 1098 /** 1099 * @brief Verify the ADC offset management setting. 1100 * @param __OFFSET_NUMBER__ ADC offset management. 1101 * @retval SET (__OFFSET_NUMBER__ is valid) or RESET (__OFFSET_NUMBER__ is invalid) 1102 */ 1103 #define IS_ADC_OFFSET_NUMBER(__OFFSET_NUMBER__) (((__OFFSET_NUMBER__) == ADC_OFFSET_NONE) || \ 1104 ((__OFFSET_NUMBER__) == ADC_OFFSET_1) || \ 1105 ((__OFFSET_NUMBER__) == ADC_OFFSET_2) || \ 1106 ((__OFFSET_NUMBER__) == ADC_OFFSET_3) || \ 1107 ((__OFFSET_NUMBER__) == ADC_OFFSET_4) ) 1108 1109 /** 1110 * @brief Verify the ADC offset sign setting. 1111 * @param __OFFSET_SIGN__ ADC offset sign. 1112 * @retval SET (__OFFSET_SIGN__ is valid) or RESET (__OFFSET_SIGN__ is invalid) 1113 */ 1114 #define IS_ADC_OFFSET_SIGN(__OFFSET_SIGN__) (((__OFFSET_SIGN__) == ADC_OFFSET_SIGN_NEGATIVE) || \ 1115 ((__OFFSET_SIGN__) == ADC_OFFSET_SIGN_POSITIVE) ) 1116 1117 /** 1118 * @brief Verify the ADC injected channel setting. 1119 * @param __CHANNEL__ programmed ADC injected channel. 1120 * @retval SET (__CHANNEL__ is valid) or RESET (__CHANNEL__ is invalid) 1121 */ 1122 #define IS_ADC_INJECTED_RANK(__CHANNEL__) (((__CHANNEL__) == ADC_INJECTED_RANK_1) || \ 1123 ((__CHANNEL__) == ADC_INJECTED_RANK_2) || \ 1124 ((__CHANNEL__) == ADC_INJECTED_RANK_3) || \ 1125 ((__CHANNEL__) == ADC_INJECTED_RANK_4) ) 1126 1127 /** 1128 * @brief Verify the ADC injected conversions external trigger. 1129 * @param __HANDLE__ ADC handle. 1130 * @param __INJTRIG__ programmed ADC injected conversions external trigger. 1131 * @retval SET (__INJTRIG__ is a valid value) or RESET (__INJTRIG__ is invalid) 1132 */ 1133 #if defined(STM32G474xx) || defined(STM32G484xx) 1134 #define IS_ADC_EXTTRIGINJEC(__HANDLE__, __INJTRIG__) (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO) || \ 1135 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO2) || \ 1136 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC4) || \ 1137 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_TRGO) || \ 1138 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_TRGO) || \ 1139 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_TRGO) || \ 1140 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T6_TRGO) || \ 1141 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T7_TRGO) || \ 1142 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO) || \ 1143 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO2) || \ 1144 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC4) || \ 1145 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T15_TRGO) || \ 1146 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO) || \ 1147 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO2) || \ 1148 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG2) || \ 1149 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG4) || \ 1150 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG5) || \ 1151 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG6) || \ 1152 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG7) || \ 1153 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG8) || \ 1154 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG9) || \ 1155 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG10) || \ 1156 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_LPTIM_OUT) || \ 1157 ((((__HANDLE__)->Instance == ADC1) || \ 1158 ((__HANDLE__)->Instance == ADC2)) && \ 1159 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_CC1) || \ 1160 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC1) || \ 1161 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC3) || \ 1162 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC4) || \ 1163 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T16_CC1) || \ 1164 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC4) || \ 1165 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT15))) || \ 1166 ((((__HANDLE__)->Instance == ADC3) || \ 1167 ((__HANDLE__)->Instance == ADC4) || \ 1168 ((__HANDLE__)->Instance == ADC5)) && \ 1169 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC3) || \ 1170 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC3) || \ 1171 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC4) || \ 1172 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC2) || \ 1173 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC2) || \ 1174 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG1) || \ 1175 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_HRTIM_TRG3) || \ 1176 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT3))) || \ 1177 ((__INJTRIG__) == ADC_INJECTED_SOFTWARE_START) ) 1178 #elif defined(STM32G473xx) || defined(STM32G483xx) 1179 #define IS_ADC_EXTTRIGINJEC(__HANDLE__, __INJTRIG__) (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO) || \ 1180 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO2) || \ 1181 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC4) || \ 1182 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_TRGO) || \ 1183 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_TRGO) || \ 1184 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_TRGO) || \ 1185 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T6_TRGO) || \ 1186 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T7_TRGO) || \ 1187 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO) || \ 1188 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO2) || \ 1189 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC4) || \ 1190 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T15_TRGO) || \ 1191 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO) || \ 1192 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO2) || \ 1193 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_LPTIM_OUT) || \ 1194 ((((__HANDLE__)->Instance == ADC1) || \ 1195 ((__HANDLE__)->Instance == ADC2)) && \ 1196 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_CC1) || \ 1197 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC1) || \ 1198 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC3) || \ 1199 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC4) || \ 1200 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T16_CC1) || \ 1201 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC4) || \ 1202 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT15))) || \ 1203 ((((__HANDLE__)->Instance == ADC3) || \ 1204 ((__HANDLE__)->Instance == ADC4) || \ 1205 ((__HANDLE__)->Instance == ADC5)) && \ 1206 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC3) || \ 1207 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC3) || \ 1208 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC4) || \ 1209 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC2) || \ 1210 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC2) || \ 1211 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT3))) || \ 1212 ((__INJTRIG__) == ADC_INJECTED_SOFTWARE_START) ) 1213 #elif defined(STM32G471xx) 1214 #define IS_ADC_EXTTRIGINJEC(__HANDLE__, __INJTRIG__) (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO) || \ 1215 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO2) || \ 1216 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC4) || \ 1217 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_TRGO) || \ 1218 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_TRGO) || \ 1219 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_TRGO) || \ 1220 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T6_TRGO) || \ 1221 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T7_TRGO) || \ 1222 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO) || \ 1223 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO2) || \ 1224 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC4) || \ 1225 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T15_TRGO) || \ 1226 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_LPTIM_OUT) || \ 1227 ((((__HANDLE__)->Instance == ADC1) || \ 1228 ((__HANDLE__)->Instance == ADC2)) && \ 1229 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_CC1) || \ 1230 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC1) || \ 1231 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC3) || \ 1232 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC4) || \ 1233 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T16_CC1) || \ 1234 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT15))) || \ 1235 ((((__HANDLE__)->Instance == ADC3)) && \ 1236 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC3) || \ 1237 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC3) || \ 1238 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC4) || \ 1239 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC2) || \ 1240 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT3))) || \ 1241 ((__INJTRIG__) == ADC_INJECTED_SOFTWARE_START) ) 1242 #elif defined(STM32G411xB) || defined(STM32G414xx) || defined(STM32GBK1CB) || defined(STM32G431xx) || defined(STM32G441xx) 1243 #define IS_ADC_EXTTRIGINJEC(__HANDLE__, __INJTRIG__) (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO) || \ 1244 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO2) || \ 1245 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC4) || \ 1246 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_TRGO) || \ 1247 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_CC1) || \ 1248 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_TRGO) || \ 1249 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC1) || \ 1250 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC3) || \ 1251 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC4) || \ 1252 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_TRGO) || \ 1253 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T6_TRGO) || \ 1254 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T7_TRGO) || \ 1255 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO) || \ 1256 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO2) || \ 1257 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC4) || \ 1258 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T15_TRGO) || \ 1259 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T16_CC1) || \ 1260 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT15) || \ 1261 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_LPTIM_OUT) || \ 1262 ((__INJTRIG__) == ADC_INJECTED_SOFTWARE_START) ) 1263 #elif defined(STM32G491xx) || defined(STM32G4A1xx) || defined(STM32G411xC) 1264 #define IS_ADC_EXTTRIGINJEC(__HANDLE__, __INJTRIG__) (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO) || \ 1265 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_TRGO2) || \ 1266 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC4) || \ 1267 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_TRGO) || \ 1268 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_TRGO) || \ 1269 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_TRGO) || \ 1270 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T6_TRGO) || \ 1271 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T7_TRGO) || \ 1272 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO) || \ 1273 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_TRGO2) || \ 1274 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC4) || \ 1275 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T15_TRGO) || \ 1276 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO) || \ 1277 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_TRGO2) || \ 1278 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_LPTIM_OUT) || \ 1279 ((((__HANDLE__)->Instance == ADC1) || \ 1280 ((__HANDLE__)->Instance == ADC2)) && \ 1281 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T2_CC1) || \ 1282 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC1) || \ 1283 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC3) || \ 1284 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T3_CC4) || \ 1285 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T16_CC1) || \ 1286 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC4) || \ 1287 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT15))) || \ 1288 (((__HANDLE__)->Instance == ADC3) && \ 1289 (((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T1_CC3) || \ 1290 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC3) || \ 1291 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T4_CC4) || \ 1292 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T8_CC2) || \ 1293 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_T20_CC2) || \ 1294 ((__INJTRIG__) == ADC_EXTERNALTRIGINJEC_EXT_IT3))) || \ 1295 ((__INJTRIG__) == ADC_INJECTED_SOFTWARE_START) ) 1296 #endif /* STM32G4xx */ 1297 1298 /** 1299 * @brief Verify the ADC edge trigger setting for injected group. 1300 * @param __EDGE__ programmed ADC edge trigger setting. 1301 * @retval SET (__EDGE__ is a valid value) or RESET (__EDGE__ is invalid) 1302 */ 1303 #define IS_ADC_EXTTRIGINJEC_EDGE(__EDGE__) (((__EDGE__) == ADC_EXTERNALTRIGINJECCONV_EDGE_NONE) || \ 1304 ((__EDGE__) == ADC_EXTERNALTRIGINJECCONV_EDGE_RISING) || \ 1305 ((__EDGE__) == ADC_EXTERNALTRIGINJECCONV_EDGE_FALLING) || \ 1306 ((__EDGE__) == ADC_EXTERNALTRIGINJECCONV_EDGE_RISINGFALLING) ) 1307 1308 #if defined(ADC_MULTIMODE_SUPPORT) 1309 /** 1310 * @brief Verify the ADC multimode setting. 1311 * @param __MODE__ programmed ADC multimode setting. 1312 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid) 1313 */ 1314 #define IS_ADC_MULTIMODE(__MODE__) (((__MODE__) == ADC_MODE_INDEPENDENT) || \ 1315 ((__MODE__) == ADC_DUALMODE_REGSIMULT_INJECSIMULT) || \ 1316 ((__MODE__) == ADC_DUALMODE_REGSIMULT_ALTERTRIG) || \ 1317 ((__MODE__) == ADC_DUALMODE_REGINTERL_INJECSIMULT) || \ 1318 ((__MODE__) == ADC_DUALMODE_INJECSIMULT) || \ 1319 ((__MODE__) == ADC_DUALMODE_REGSIMULT) || \ 1320 ((__MODE__) == ADC_DUALMODE_INTERL) || \ 1321 ((__MODE__) == ADC_DUALMODE_ALTERTRIG) ) 1322 1323 /** 1324 * @brief Verify the ADC multimode DMA access setting. 1325 * @param __MODE__ programmed ADC multimode DMA access setting. 1326 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid) 1327 */ 1328 #define IS_ADC_DMA_ACCESS_MULTIMODE(__MODE__) (((__MODE__) == ADC_DMAACCESSMODE_DISABLED) || \ 1329 ((__MODE__) == ADC_DMAACCESSMODE_12_10_BITS) || \ 1330 ((__MODE__) == ADC_DMAACCESSMODE_8_6_BITS) ) 1331 1332 /** 1333 * @brief Verify the ADC multimode delay setting. 1334 * @param __DELAY__ programmed ADC multimode delay setting. 1335 * @retval SET (__DELAY__ is a valid value) or RESET (__DELAY__ is invalid) 1336 */ 1337 #define IS_ADC_SAMPLING_DELAY(__DELAY__) (((__DELAY__) == ADC_TWOSAMPLINGDELAY_1CYCLE) || \ 1338 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_2CYCLES) || \ 1339 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_3CYCLES) || \ 1340 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_4CYCLES) || \ 1341 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_5CYCLES) || \ 1342 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_6CYCLES) || \ 1343 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_7CYCLES) || \ 1344 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_8CYCLES) || \ 1345 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_9CYCLES) || \ 1346 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_10CYCLES) || \ 1347 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_11CYCLES) || \ 1348 ((__DELAY__) == ADC_TWOSAMPLINGDELAY_12CYCLES) ) 1349 #endif /* ADC_MULTIMODE_SUPPORT */ 1350 1351 /** 1352 * @brief Verify the ADC analog watchdog setting. 1353 * @param __WATCHDOG__ programmed ADC analog watchdog setting. 1354 * @retval SET (__WATCHDOG__ is valid) or RESET (__WATCHDOG__ is invalid) 1355 */ 1356 #define IS_ADC_ANALOG_WATCHDOG_NUMBER(__WATCHDOG__) (((__WATCHDOG__) == ADC_ANALOGWATCHDOG_1) || \ 1357 ((__WATCHDOG__) == ADC_ANALOGWATCHDOG_2) || \ 1358 ((__WATCHDOG__) == ADC_ANALOGWATCHDOG_3) ) 1359 1360 /** 1361 * @brief Verify the ADC analog watchdog mode setting. 1362 * @param __WATCHDOG_MODE__ programmed ADC analog watchdog mode setting. 1363 * @retval SET (__WATCHDOG_MODE__ is valid) or RESET (__WATCHDOG_MODE__ is invalid) 1364 */ 1365 #define IS_ADC_ANALOG_WATCHDOG_MODE(__WATCHDOG_MODE__) (((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_NONE) || \ 1366 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_SINGLE_REG) || \ 1367 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_SINGLE_INJEC) || \ 1368 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_SINGLE_REGINJEC) || \ 1369 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_ALL_REG) || \ 1370 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_ALL_INJEC) || \ 1371 ((__WATCHDOG_MODE__) == ADC_ANALOGWATCHDOG_ALL_REGINJEC) ) 1372 1373 /** 1374 * @brief Verify the ADC analog watchdog filtering setting. 1375 * @param __FILTERING_MODE__ programmed ADC analog watchdog mode setting. 1376 * @retval SET (__FILTERING_MODE__ is valid) or RESET (__FILTERING_MODE__ is invalid) 1377 */ 1378 #define IS_ADC_ANALOG_WATCHDOG_FILTERING_MODE(__FILTERING_MODE__) \ 1379 (((__FILTERING_MODE__) == ADC_AWD_FILTERING_NONE) || \ 1380 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_2SAMPLES) || \ 1381 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_3SAMPLES) || \ 1382 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_4SAMPLES) || \ 1383 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_5SAMPLES) || \ 1384 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_6SAMPLES) || \ 1385 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_7SAMPLES) || \ 1386 ((__FILTERING_MODE__) == ADC_AWD_FILTERING_8SAMPLES) ) 1387 1388 1389 /** 1390 * @brief Verify the ADC conversion (regular or injected or both). 1391 * @param __CONVERSION__ ADC conversion group. 1392 * @retval SET (__CONVERSION__ is valid) or RESET (__CONVERSION__ is invalid) 1393 */ 1394 #define IS_ADC_CONVERSION_GROUP(__CONVERSION__) (((__CONVERSION__) == ADC_REGULAR_GROUP) || \ 1395 ((__CONVERSION__) == ADC_INJECTED_GROUP) || \ 1396 ((__CONVERSION__) == ADC_REGULAR_INJECTED_GROUP) ) 1397 1398 /** 1399 * @brief Verify the ADC event type. 1400 * @param __EVENT__ ADC event. 1401 * @retval SET (__EVENT__ is valid) or RESET (__EVENT__ is invalid) 1402 */ 1403 #define IS_ADC_EVENT_TYPE(__EVENT__) (((__EVENT__) == ADC_EOSMP_EVENT) || \ 1404 ((__EVENT__) == ADC_AWD_EVENT) || \ 1405 ((__EVENT__) == ADC_AWD2_EVENT) || \ 1406 ((__EVENT__) == ADC_AWD3_EVENT) || \ 1407 ((__EVENT__) == ADC_OVR_EVENT) || \ 1408 ((__EVENT__) == ADC_JQOVF_EVENT) ) 1409 1410 /** 1411 * @brief Verify the ADC oversampling ratio. 1412 * @param __RATIO__ programmed ADC oversampling ratio. 1413 * @retval SET (__RATIO__ is a valid value) or RESET (__RATIO__ is invalid) 1414 */ 1415 #define IS_ADC_OVERSAMPLING_RATIO(__RATIO__) (((__RATIO__) == ADC_OVERSAMPLING_RATIO_2 ) || \ 1416 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_4 ) || \ 1417 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_8 ) || \ 1418 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_16 ) || \ 1419 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_32 ) || \ 1420 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_64 ) || \ 1421 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_128 ) || \ 1422 ((__RATIO__) == ADC_OVERSAMPLING_RATIO_256 )) 1423 1424 /** 1425 * @brief Verify the ADC oversampling shift. 1426 * @param __SHIFT__ programmed ADC oversampling shift. 1427 * @retval SET (__SHIFT__ is a valid value) or RESET (__SHIFT__ is invalid) 1428 */ 1429 #define IS_ADC_RIGHT_BIT_SHIFT(__SHIFT__) (((__SHIFT__) == ADC_RIGHTBITSHIFT_NONE) || \ 1430 ((__SHIFT__) == ADC_RIGHTBITSHIFT_1 ) || \ 1431 ((__SHIFT__) == ADC_RIGHTBITSHIFT_2 ) || \ 1432 ((__SHIFT__) == ADC_RIGHTBITSHIFT_3 ) || \ 1433 ((__SHIFT__) == ADC_RIGHTBITSHIFT_4 ) || \ 1434 ((__SHIFT__) == ADC_RIGHTBITSHIFT_5 ) || \ 1435 ((__SHIFT__) == ADC_RIGHTBITSHIFT_6 ) || \ 1436 ((__SHIFT__) == ADC_RIGHTBITSHIFT_7 ) || \ 1437 ((__SHIFT__) == ADC_RIGHTBITSHIFT_8 )) 1438 1439 /** 1440 * @brief Verify the ADC oversampling triggered mode. 1441 * @param __MODE__ programmed ADC oversampling triggered mode. 1442 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid) 1443 */ 1444 #define IS_ADC_TRIGGERED_OVERSAMPLING_MODE(__MODE__) (((__MODE__) == ADC_TRIGGEREDMODE_SINGLE_TRIGGER) || \ 1445 ((__MODE__) == ADC_TRIGGEREDMODE_MULTI_TRIGGER) ) 1446 1447 /** 1448 * @brief Verify the ADC oversampling regular conversion resumed or continued mode. 1449 * @param __MODE__ programmed ADC oversampling regular conversion resumed or continued mode. 1450 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid) 1451 */ 1452 #define IS_ADC_REGOVERSAMPLING_MODE(__MODE__) (((__MODE__) == ADC_REGOVERSAMPLING_CONTINUED_MODE) || \ 1453 ((__MODE__) == ADC_REGOVERSAMPLING_RESUMED_MODE) ) 1454 1455 /** 1456 * @brief Verify the DFSDM mode configuration. 1457 * @param __HANDLE__ ADC handle. 1458 * @note When DMSDFM configuration is not supported, the macro systematically reports SET. For 1459 * this reason, the input parameter is the ADC handle and not the configuration parameter 1460 * directly. 1461 * @retval SET (DFSDM mode configuration is valid) or RESET (DFSDM mode configuration is invalid) 1462 */ 1463 #define IS_ADC_DFSDMCFG_MODE(__HANDLE__) (SET) 1464 1465 /** 1466 * @brief Return the DFSDM configuration mode. 1467 * @param __HANDLE__ ADC handle. 1468 * @note When DMSDFM configuration is not supported, the macro systematically reports 0x0 (i.e disabled). 1469 * For this reason, the input parameter is the ADC handle and not the configuration parameter 1470 * directly. 1471 * @retval DFSDM configuration mode 1472 */ 1473 #define ADC_CFGR_DFSDM(__HANDLE__) (0x0UL) 1474 1475 /** 1476 * @} 1477 */ 1478 1479 1480 /* Exported functions --------------------------------------------------------*/ 1481 /** @addtogroup ADCEx_Exported_Functions 1482 * @{ 1483 */ 1484 1485 /** @addtogroup ADCEx_Exported_Functions_Group1 1486 * @{ 1487 */ 1488 /* IO operation functions *****************************************************/ 1489 1490 /* ADC calibration */ 1491 HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef *hadc, uint32_t SingleDiff); 1492 uint32_t HAL_ADCEx_Calibration_GetValue(const ADC_HandleTypeDef *hadc, uint32_t SingleDiff); 1493 HAL_StatusTypeDef HAL_ADCEx_Calibration_SetValue(ADC_HandleTypeDef *hadc, uint32_t SingleDiff, 1494 uint32_t CalibrationFactor); 1495 1496 /* Blocking mode: Polling */ 1497 HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef *hadc); 1498 HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef *hadc); 1499 HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef *hadc, uint32_t Timeout); 1500 1501 /* Non-blocking mode: Interruption */ 1502 HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef *hadc); 1503 HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef *hadc); 1504 1505 #if defined(ADC_MULTIMODE_SUPPORT) 1506 /* ADC multimode */ 1507 HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA(ADC_HandleTypeDef *hadc, uint32_t *pData, uint32_t Length); 1508 HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA(ADC_HandleTypeDef *hadc); 1509 uint32_t HAL_ADCEx_MultiModeGetValue(const ADC_HandleTypeDef *hadc); 1510 #endif /* ADC_MULTIMODE_SUPPORT */ 1511 1512 /* ADC retrieve conversion value intended to be used with polling or interruption */ 1513 uint32_t HAL_ADCEx_InjectedGetValue(const ADC_HandleTypeDef *hadc, uint32_t InjectedRank); 1514 1515 /* ADC IRQHandler and Callbacks used in non-blocking modes (Interruption) */ 1516 void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef *hadc); 1517 void HAL_ADCEx_InjectedQueueOverflowCallback(ADC_HandleTypeDef *hadc); 1518 void HAL_ADCEx_LevelOutOfWindow2Callback(ADC_HandleTypeDef *hadc); 1519 void HAL_ADCEx_LevelOutOfWindow3Callback(ADC_HandleTypeDef *hadc); 1520 void HAL_ADCEx_EndOfSamplingCallback(ADC_HandleTypeDef *hadc); 1521 1522 /* ADC group regular conversions stop */ 1523 HAL_StatusTypeDef HAL_ADCEx_RegularStop(ADC_HandleTypeDef *hadc); 1524 HAL_StatusTypeDef HAL_ADCEx_RegularStop_IT(ADC_HandleTypeDef *hadc); 1525 HAL_StatusTypeDef HAL_ADCEx_RegularStop_DMA(ADC_HandleTypeDef *hadc); 1526 #if defined(ADC_MULTIMODE_SUPPORT) 1527 HAL_StatusTypeDef HAL_ADCEx_RegularMultiModeStop_DMA(ADC_HandleTypeDef *hadc); 1528 #endif /* ADC_MULTIMODE_SUPPORT */ 1529 1530 /** 1531 * @} 1532 */ 1533 1534 /** @addtogroup ADCEx_Exported_Functions_Group2 1535 * @{ 1536 */ 1537 /* Peripheral Control functions ***********************************************/ 1538 HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef *hadc, 1539 const ADC_InjectionConfTypeDef *pConfigInjected); 1540 #if defined(ADC_MULTIMODE_SUPPORT) 1541 HAL_StatusTypeDef HAL_ADCEx_MultiModeConfigChannel(ADC_HandleTypeDef *hadc, 1542 const ADC_MultiModeTypeDef *pMultimode); 1543 #endif /* ADC_MULTIMODE_SUPPORT */ 1544 1545 HAL_StatusTypeDef HAL_ADCEx_EnableInjectedQueue(ADC_HandleTypeDef *hadc); 1546 HAL_StatusTypeDef HAL_ADCEx_DisableInjectedQueue(ADC_HandleTypeDef *hadc); 1547 HAL_StatusTypeDef HAL_ADCEx_DisableVoltageRegulator(ADC_HandleTypeDef *hadc); 1548 HAL_StatusTypeDef HAL_ADCEx_EnterADCDeepPowerDownMode(ADC_HandleTypeDef *hadc); 1549 1550 /** 1551 * @} 1552 */ 1553 1554 /** 1555 * @} 1556 */ 1557 1558 /** 1559 * @} 1560 */ 1561 1562 /** 1563 * @} 1564 */ 1565 1566 #ifdef __cplusplus 1567 } 1568 #endif 1569 1570 #endif /* STM32G4xx_HAL_ADC_EX_H */ 1571
