STM32H735xx HAL User Manual
Defines
ADC Private Macros
ADC

Defines

#define IS_ADC_CONVERSIONDATAMGT(DATA)
 Verify the ADC data conversion setting.
#define ADC_GET_RESOLUTION(__HANDLE__)   (LL_ADC_GetResolution((__HANDLE__)->Instance))
 Return resolution bits in CFGR register RES[1:0] field.
#define ADC_CLEAR_ERRORCODE(__HANDLE__)   ((__HANDLE__)->ErrorCode = HAL_ADC_ERROR_NONE)
 Clear ADC error code (set it to no error code "HAL_ADC_ERROR_NONE").
#define ADC_IS_ENABLE(__HANDLE__)
 Verification of ADC state: enabled or disabled.
#define ADC_IS_CONVERSION_ONGOING_REGULAR(__HANDLE__)   (LL_ADC_REG_IsConversionOngoing((__HANDLE__)->Instance))
 Check if conversion is on going on regular group.
#define ADC_IS_SYNCHRONOUS_CLOCK_MODE(__HANDLE__)
 Check if ADC clock mode is synchronous.
#define ADC_STATE_CLR_SET   MODIFY_REG
 Simultaneously clear and set specific bits of the handle State.
#define IS_ADC_RANGE(__RESOLUTION__, __ADC_VALUE__)   ((__ADC_VALUE__) <= __LL_ADC_DIGITAL_SCALE(__RESOLUTION__))
 Verify that a given value is aligned with the ADC resolution range.
#define IS_ADC3_RANGE(__RESOLUTION__, __ADC_VALUE__)   ((__ADC_VALUE__) <= __LL_ADC3_DIGITAL_SCALE(__RESOLUTION__))
 Verify that a given value is aligned with the ADC resolution range.
#define IS_ADC_REGULAR_NB_CONV(__LENGTH__)   (((__LENGTH__) >= (1UL)) && ((__LENGTH__) <= (16UL)))
 Verify the length of the scheduled regular conversions group.
#define IS_ADC_REGULAR_DISCONT_NUMBER(NUMBER)   (((NUMBER) >= (1UL)) && ((NUMBER) <= (8UL)))
 Verify the number of scheduled regular conversions in discontinuous mode.
#define IS_ADC_CLOCKPRESCALER(__ADC_CLOCK__)
 Verify the ADC clock setting.
#define IS_ADC_RESOLUTION(__RESOLUTION__)
 Verify the ADC resolution setting.
#define IS_ADC_RESOLUTION_8_BITS(__RESOLUTION__)   (((__RESOLUTION__) == ADC_RESOLUTION_8B))
 Verify the ADC resolution setting when limited to 8 bits.
#define IS_ADC3_DATA_ALIGN(__ALIGN__)
 Verify the ADC converted data alignment.
#define IS_ADC3_SAMPLINGMODE(__SAMPLINGMODE__)
 Verify the ADC regular conversions external trigger.
#define IS_ADC_SCAN_MODE(__SCAN_MODE__)
 Verify the ADC scan mode.
#define IS_ADC_EXTTRIG_EDGE(__EDGE__)
 Verify the ADC edge trigger setting for regular group.
#define IS_ADC_EXTTRIG(__REGTRIG__)
 Verify the ADC regular conversions external trigger.
#define IS_ADC_EOC_SELECTION(__EOC_SELECTION__)
 Verify the ADC regular conversions check for converted data availability.
#define IS_ADC_OVERRUN(__OVR__)
 Verify the ADC regular conversions overrun handling.
#define IS_ADC_SAMPLE_TIME(__TIME__)
 Verify the ADC conversions sampling time.
#define IS_ADC_REGULAR_RANK(__CHANNEL__)
 Verify the ADC regular channel setting.

Define Documentation

#define ADC_CLEAR_ERRORCODE (   __HANDLE__)    ((__HANDLE__)->ErrorCode = HAL_ADC_ERROR_NONE)

Clear ADC error code (set it to no error code "HAL_ADC_ERROR_NONE").

Parameters:
__HANDLE__ADC handle
Return values:
None

Definition at line 954 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_DeInit(), HAL_ADC_Init(), HAL_ADC_Start(), HAL_ADC_Start_DMA(), HAL_ADC_Start_IT(), HAL_ADCEx_InjectedStart(), HAL_ADCEx_InjectedStart_IT(), and HAL_ADCEx_MultiModeStart_DMA().

#define ADC_GET_RESOLUTION (   __HANDLE__)    (LL_ADC_GetResolution((__HANDLE__)->Instance))

Return resolution bits in CFGR register RES[1:0] field.

Parameters:
__HANDLE__ADC handle
Return values:
Valueof bitfield RES in CFGR register.

Definition at line 946 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_AnalogWDGConfig(), HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

#define ADC_IS_CONVERSION_ONGOING_REGULAR (   __HANDLE__)    (LL_ADC_REG_IsConversionOngoing((__HANDLE__)->Instance))

Check if conversion is on going on regular group.

Parameters:
__HANDLE__ADC handle
Return values:
Value"0" (no conversion is on going) or value "1" (conversion is on going)

Definition at line 971 of file stm32h7xx_hal_adc.h.

#define ADC_IS_ENABLE (   __HANDLE__)
Value:
(( ((((__HANDLE__)->Instance->CR) & (ADC_CR_ADEN | ADC_CR_ADDIS)) == ADC_CR_ADEN) && \
          ((((__HANDLE__)->Instance->ISR) & ADC_FLAG_RDY) == ADC_FLAG_RDY)                  \
        ) ? SET : RESET)

Verification of ADC state: enabled or disabled.

Parameters:
__HANDLE__ADC handle
Return values:
SET(ADC enabled) or RESET (ADC disabled)

Definition at line 961 of file stm32h7xx_hal_adc.h.

#define ADC_IS_SYNCHRONOUS_CLOCK_MODE (   __HANDLE__)
Value:
(((((__HANDLE__)->Instance) == ADC1) || (((__HANDLE__)->Instance) == ADC2))? \
     ((ADC12_COMMON->CCR & ADC_CCR_CKMODE) != 0UL)                              \
     :((((ADC3_COMMON)->CCR) & ADC_CCR_CKMODE) != 0UL))

Check if ADC clock mode is synchronous.

Parameters:
__HANDLE__,:ADC handle
Return values:
SET(clock mode is synchronous) or RESET (clock mode is asynchronous)

Definition at line 980 of file stm32h7xx_hal_adc.h.

Referenced by ADC_ConfigureBoostMode().

#define ADC_STATE_CLR_SET   MODIFY_REG

Simultaneously clear and set specific bits of the handle State.

Note:
ADC_STATE_CLR_SET() macro is merely aliased to generic macro MODIFY_REG(), the first parameter is the ADC handle State, the second parameter is the bit field to clear, the third and last parameter is the bit field to set.
Return values:
None

Definition at line 996 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init(), HAL_ADC_Start(), HAL_ADC_Start_DMA(), HAL_ADC_Start_IT(), HAL_ADC_Stop(), HAL_ADC_Stop_DMA(), HAL_ADC_Stop_IT(), HAL_ADCEx_Calibration_Start(), HAL_ADCEx_InjectedStart(), HAL_ADCEx_InjectedStart_IT(), HAL_ADCEx_InjectedStop(), HAL_ADCEx_InjectedStop_IT(), HAL_ADCEx_MultiModeStart_DMA(), HAL_ADCEx_MultiModeStop_DMA(), HAL_ADCEx_RegularMultiModeStop_DMA(), HAL_ADCEx_RegularStop(), HAL_ADCEx_RegularStop_DMA(), and HAL_ADCEx_RegularStop_IT().

#define IS_ADC3_DATA_ALIGN (   __ALIGN__)
Value:
(((__ALIGN__) == ADC3_DATAALIGN_RIGHT) || \
                                       ((__ALIGN__) == ADC3_DATAALIGN_LEFT)    )

Verify the ADC converted data alignment.

Applicable for ADC3 on devices STM32H72xx and STM32H73xx.

Parameters:
__ALIGN__programmed ADC converted data alignment.
Return values:
SET(__ALIGN__ is a valid value) or RESET (__ALIGN__ is invalid)

Definition at line 1095 of file stm32h7xx_hal_adc.h.

#define IS_ADC3_RANGE (   __RESOLUTION__,
  __ADC_VALUE__ 
)    ((__ADC_VALUE__) <= __LL_ADC3_DIGITAL_SCALE(__RESOLUTION__))

Verify that a given value is aligned with the ADC resolution range.

Applicable for ADC3 on devices STM32H72xx and STM32H73xx.

Parameters:
__RESOLUTION__ADC resolution (12, 10, 8 or 6 bits).
__ADC_VALUE__value checked against the resolution.
Return values:
SET(__ADC_VALUE__ in line with __RESOLUTION__) or RESET (__ADC_VALUE__ not in line with __RESOLUTION__)

Definition at line 1014 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_AnalogWDGConfig(), HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

#define IS_ADC3_SAMPLINGMODE (   __SAMPLINGMODE__)
Value:
(((__SAMPLINGMODE__) == ADC_SAMPLING_MODE_NORMAL)          || \
                                                ((__SAMPLINGMODE__) == ADC_SAMPLING_MODE_BULB)            || \
                                                ((__SAMPLINGMODE__) == ADC_SAMPLING_MODE_TRIGGER_CONTROLED)  )

Verify the ADC regular conversions external trigger.

Parameters:
__SAMPLINGMODE__programmed ADC regular conversions external trigger.
Return values:
SET(__SAMPLINGMODE__ is a valid value) or RESET (__SAMPLINGMODE__ is invalid)

Definition at line 1103 of file stm32h7xx_hal_adc.h.

#define IS_ADC_CLOCKPRESCALER (   __ADC_CLOCK__)
Value:
(((__ADC_CLOCK__) == ADC_CLOCK_SYNC_PCLK_DIV1) || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_SYNC_PCLK_DIV2) || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_SYNC_PCLK_DIV4) || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV1)     || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV2)     || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV4)     || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV6)     || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV8)     || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV10)    || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV12)    || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV16)    || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV32)    || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV64)    || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV128)   || \
                                              ((__ADC_CLOCK__) == ADC_CLOCK_ASYNC_DIV256) )

Verify the ADC clock setting.

Parameters:
__ADC_CLOCK__programmed ADC clock.
Return values:
SET(__ADC_CLOCK__ is a valid value) or RESET (__ADC_CLOCK__ is invalid)

Definition at line 1038 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_CONVERSIONDATAMGT (   DATA)
Value:
((((DATA) == ADC_CONVERSIONDATA_DR))          || \
    (((DATA) == ADC_CONVERSIONDATA_DFSDM))       || \
    (((DATA) == ADC_CONVERSIONDATA_DMA_ONESHOT)) || \
    (((DATA) == ADC_CONVERSIONDATA_DMA_CIRCULAR)))

Verify the ADC data conversion setting.

Parameters:
DATA: programmed DATA conversion mode.
Return values:
SET(DATA is a valid value) or RESET (DATA is invalid)

Definition at line 935 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_EOC_SELECTION (   __EOC_SELECTION__)
Value:
(((__EOC_SELECTION__) == ADC_EOC_SINGLE_CONV)    || \
                                                 ((__EOC_SELECTION__) == ADC_EOC_SEQ_CONV)  )

Verify the ADC regular conversions check for converted data availability.

Parameters:
__EOC_SELECTION__converted data availability check.
Return values:
SET(__EOC_SELECTION__ is a valid value) or RESET (__EOC_SELECTION__ is invalid)

Definition at line 1188 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init(), and HAL_ADC_IRQHandler().

#define IS_ADC_EXTTRIG (   __REGTRIG__)
Value:
(((__REGTRIG__) == ADC_EXTERNALTRIG_T1_CC1)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T1_CC2)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T1_CC3)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T2_CC2)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T3_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T4_CC4)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_EXT_IT11)      || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T8_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T8_TRGO2)      || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T1_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T1_TRGO2)      || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T2_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T4_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T6_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T15_TRGO)      || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T3_CC4)        || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_HR1_ADCTRG1)   || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_HR1_ADCTRG3)   || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_LPTIM1_OUT)    || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_LPTIM2_OUT)    || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_LPTIM3_OUT)    || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T23_TRGO)       || \
                                     ((__REGTRIG__) == ADC_EXTERNALTRIG_T24_TRGO)       || \
                                     ((__REGTRIG__) == ADC_SOFTWARE_START)           )

Verify the ADC regular conversions external trigger.

Parameters:
__REGTRIG__programmed ADC regular conversions external trigger.
Return values:
SET(__REGTRIG__ is a valid value) or RESET (__REGTRIG__ is invalid)

Definition at line 1133 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_EXTTRIG_EDGE (   __EDGE__)
Value:

Verify the ADC edge trigger setting for regular group.

Parameters:
__EDGE__programmed ADC edge trigger setting.
Return values:
SET(__EDGE__ is a valid value) or RESET (__EDGE__ is invalid)

Definition at line 1122 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init(), and HAL_ADCEx_MultiModeStart_DMA().

#define IS_ADC_OVERRUN (   __OVR__)
Value:
(((__OVR__) == ADC_OVR_DATA_PRESERVED)  || \
                                 ((__OVR__) == ADC_OVR_DATA_OVERWRITTEN)  )

Verify the ADC regular conversions overrun handling.

Parameters:
__OVR__ADC regular conversions overrun handling.
Return values:
SET(__OVR__ is a valid value) or RESET (__OVR__ is invalid)

Definition at line 1196 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_RANGE (   __RESOLUTION__,
  __ADC_VALUE__ 
)    ((__ADC_VALUE__) <= __LL_ADC_DIGITAL_SCALE(__RESOLUTION__))

Verify that a given value is aligned with the ADC resolution range.

Parameters:
__RESOLUTION__ADC resolution (16, 14, 12, 10 or 8 bits).
__ADC_VALUE__value checked against the resolution.
Return values:
SET(__ADC_VALUE__ in line with __RESOLUTION__) or RESET (__ADC_VALUE__ not in line with __RESOLUTION__)

Definition at line 1004 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_AnalogWDGConfig(), HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

#define IS_ADC_REGULAR_DISCONT_NUMBER (   NUMBER)    (((NUMBER) >= (1UL)) && ((NUMBER) <= (8UL)))

Verify the number of scheduled regular conversions in discontinuous mode.

Parameters:
NUMBERnumber of scheduled regular conversions in discontinuous mode.
Return values:
SET(NUMBER is within the maximum number of regular conversions in discontinuous mode) or RESET (NUMBER is null or too large)

Definition at line 1030 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_REGULAR_NB_CONV (   __LENGTH__)    (((__LENGTH__) >= (1UL)) && ((__LENGTH__) <= (16UL)))

Verify the length of the scheduled regular conversions group.

Parameters:
__LENGTH__number of programmed conversions.
Return values:
SET(__LENGTH__ is within the maximum number of possible programmable regular conversions) or RESET (__LENGTH__ is null or too large)

Definition at line 1022 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_REGULAR_RANK (   __CHANNEL__)
Value:
(((__CHANNEL__) == ADC_REGULAR_RANK_1 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_2 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_3 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_4 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_5 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_6 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_7 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_8 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_9 ) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_10) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_11) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_12) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_13) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_14) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_15) || \
                                          ((__CHANNEL__) == ADC_REGULAR_RANK_16)   )

Verify the ADC regular channel setting.

Parameters:
__CHANNEL__programmed ADC regular channel.
Return values:
SET(__CHANNEL__ is valid) or RESET (__CHANNEL__ is invalid)

Definition at line 1218 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_ConfigChannel().

#define IS_ADC_RESOLUTION (   __RESOLUTION__)
Value:
(((__RESOLUTION__) == ADC_RESOLUTION_16B) || \
                                           ((__RESOLUTION__) == ADC_RESOLUTION_14B) || \
                                           ((__RESOLUTION__) == ADC_RESOLUTION_12B) || \
                                           ((__RESOLUTION__) == ADC_RESOLUTION_10B) || \
                                           ((__RESOLUTION__) == ADC_RESOLUTION_8B)  || \
                                           ((__RESOLUTION__) == ADC_RESOLUTION_6B)    )

Verify the ADC resolution setting.

Parameters:
__RESOLUTION__programmed ADC resolution.
Return values:
SET(__RESOLUTION__ is a valid value) or RESET (__RESOLUTION__ is invalid)

Definition at line 1060 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().

#define IS_ADC_RESOLUTION_8_BITS (   __RESOLUTION__)    (((__RESOLUTION__) == ADC_RESOLUTION_8B))

Verify the ADC resolution setting when limited to 8 bits.

Parameters:
__RESOLUTION__programmed ADC resolution when limited to 8 bits.
Return values:
SET(__RESOLUTION__ is a valid value) or RESET (__RESOLUTION__ is invalid)

Definition at line 1087 of file stm32h7xx_hal_adc.h.

#define IS_ADC_SAMPLE_TIME (   __TIME__)
Value:
(((__TIME__) == ADC_SAMPLETIME_1CYCLE_5)    || \
                                      ((__TIME__) == ADC_SAMPLETIME_2CYCLES_5)   || \
                                      ((__TIME__) == ADC_SAMPLETIME_8CYCLES_5)   || \
                                      ((__TIME__) == ADC_SAMPLETIME_16CYCLES_5)  || \
                                      ((__TIME__) == ADC_SAMPLETIME_32CYCLES_5)  || \
                                      ((__TIME__) == ADC_SAMPLETIME_64CYCLES_5)  || \
                                      ((__TIME__) == ADC_SAMPLETIME_387CYCLES_5) || \
                                      ((__TIME__) == ADC_SAMPLETIME_810CYCLES_5)   )

Verify the ADC conversions sampling time.

Parameters:
__TIME__ADC conversions sampling time.
Return values:
SET(__TIME__ is a valid value) or RESET (__TIME__ is invalid)

Definition at line 1204 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

#define IS_ADC_SCAN_MODE (   __SCAN_MODE__)
Value:
(((__SCAN_MODE__) == ADC_SCAN_DISABLE) || \
                                         ((__SCAN_MODE__) == ADC_SCAN_ENABLE)    )

Verify the ADC scan mode.

Parameters:
__SCAN_MODE__programmed ADC scan mode.
Return values:
SET(__SCAN_MODE__ is valid) or RESET (__SCAN_MODE__ is invalid)

Definition at line 1114 of file stm32h7xx_hal_adc.h.

Referenced by HAL_ADC_Init().