Functions
__STATIC_INLINE void	LL_ADC_SetChannelSamplingTime (ADC_TypeDef *ADCx, uint32_t Channel, uint32_t SamplingTime)
	Set sampling time of the selected ADC channel Unit: ADC clock cycles.
__STATIC_INLINE uint32_t	LL_ADC_GetChannelSamplingTime (ADC_TypeDef *ADCx, uint32_t Channel)
	Get sampling time of the selected ADC channel Unit: ADC clock cycles.
__STATIC_INLINE void	LL_ADC_SetChannelSingleDiff (ADC_TypeDef *ADCx, uint32_t Channel, uint32_t SingleDiff)
	Set mode single-ended or differential input of the selected ADC channel.
__STATIC_INLINE uint32_t	LL_ADC_GetChannelSingleDiff (ADC_TypeDef *ADCx, uint32_t Channel)
	Get mode single-ended or differential input of the selected ADC channel.

Function Documentation

__STATIC_INLINE uint32_t LL_ADC_GetChannelSamplingTime	(	ADC_TypeDef *	ADCx,
		uint32_t	Channel
	)

Get sampling time of the selected ADC channel Unit: ADC clock cycles.

Note:

On this device, sampling time is on channel scope: independently of channel mapped on ADC group regular or injected.

Conversion time is the addition of sampling time and processing time. On this STM32 series, ADC processing time is:

12.5 ADC clock cycles at ADC resolution 12 bits
10.5 ADC clock cycles at ADC resolution 10 bits
8.5 ADC clock cycles at ADC resolution 8 bits
6.5 ADC clock cycles at ADC resolution 6 bits

Reference Manual to LL API cross reference:: SMPR1 SMP0 LL_ADC_GetChannelSamplingTime
SMPR1 SMP1 LL_ADC_GetChannelSamplingTime
SMPR1 SMP2 LL_ADC_GetChannelSamplingTime
SMPR1 SMP3 LL_ADC_GetChannelSamplingTime
SMPR1 SMP4 LL_ADC_GetChannelSamplingTime
SMPR1 SMP5 LL_ADC_GetChannelSamplingTime
SMPR1 SMP6 LL_ADC_GetChannelSamplingTime
SMPR1 SMP7 LL_ADC_GetChannelSamplingTime
SMPR1 SMP8 LL_ADC_GetChannelSamplingTime
SMPR1 SMP9 LL_ADC_GetChannelSamplingTime
SMPR2 SMP10 LL_ADC_GetChannelSamplingTime
SMPR2 SMP11 LL_ADC_GetChannelSamplingTime
SMPR2 SMP12 LL_ADC_GetChannelSamplingTime
SMPR2 SMP13 LL_ADC_GetChannelSamplingTime
SMPR2 SMP14 LL_ADC_GetChannelSamplingTime
SMPR2 SMP15 LL_ADC_GetChannelSamplingTime
SMPR2 SMP16 LL_ADC_GetChannelSamplingTime
SMPR2 SMP17 LL_ADC_GetChannelSamplingTime
SMPR2 SMP18 LL_ADC_GetChannelSamplingTime

Parameters:

ADCx ADC instance

Channel

This parameter can be one of the following values:

(1) On STM32H7, parameter available only on ADC instance: ADC3.
(2) On STM32H7, parameter available only on ADC instance: ADC2.
(3) On STM32H7, fast channel (0.125 us for 14-bit resolution (ADC conversion rate up to 8 Ms/s)). Other channels are slow channels (conversion rate: refer to reference manual).

Return values:

Returned

value can be one of the following values:

Definition at line 5427 of file stm32h7xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_CHANNEL_SMPRX_REGOFFSET_MASK, ADC_CHANNEL_SMPx_BITOFFSET_MASK, ADC_CHANNEL_SMPx_BITOFFSET_POS, and ADC_SMPRX_REGOFFSET_POS.

__STATIC_INLINE uint32_t LL_ADC_GetChannelSingleDiff	(	ADC_TypeDef *	ADCx,
		uint32_t	Channel
	)

Get mode single-ended or differential input of the selected ADC channel.

Note:

When configuring a channel 'i' in differential mode, the channel 'i+1' is not usable separately. Therefore, to ensure a channel is configured in single-ended mode, the configuration of channel itself and the channel 'i-1' must be read back (to ensure that the selected channel channel has not been configured in differential mode by the previous channel).

Refer to Reference Manual to ensure the selected channel is available in differential mode. For example, internal channels (VrefInt, TempSensor, ...) are not available in differential mode.

When configuring a channel 'i' in differential mode, the channel 'i+1' is not usable separately.

On STM32H7, some channels are internally fixed to single-ended inputs configuration:

ADC1: Channels 0, 6, 7, 8, 9, 13, 14, 15, 17, and 19
ADC2: Channels 0, 6, 7, 8, 9, 13, 14, 15 and 19
ADC3: Channels 0, 6, 7, 8, 9, 12, 16, 17, and 19

One or several values can be selected. In this case, the value returned is null if all channels are in single ended-mode. Example: (LL_ADC_CHANNEL_4 | LL_ADC_CHANNEL_12 | ...)

Reference Manual to LL API cross reference:: DIFSEL DIFSEL LL_ADC_GetChannelSingleDiff

Parameters:

ADCx	ADC instance
Channel	This parameter can be a combination of the following values: LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_18 LL_ADC_CHANNEL_19

Return values:

0,:	channel in single-ended mode, else: channel in differential mode

Definition at line 5559 of file stm32h7xx_ll_adc.h.

References ADC_SINGLEDIFF_CHANNEL_MASK.

__STATIC_INLINE void LL_ADC_SetChannelSamplingTime	(	ADC_TypeDef *	ADCx,
		uint32_t	Channel,
		uint32_t	SamplingTime
	)

Set sampling time of the selected ADC channel Unit: ADC clock cycles.

Note:

On this device, sampling time is on channel scope: independently of channel mapped on ADC group regular or injected.

In case of internal channel (VrefInt, TempSensor, ...) to be converted: sampling time constraints must be respected (sampling time can be adjusted in function of ADC clock frequency and sampling time setting). Refer to device datasheet for timings values (parameters TS_vrefint, TS_temp, ...).

Conversion time is the addition of sampling time and processing time. On this STM32 series, ADC processing time is:

12.5 ADC clock cycles at ADC resolution 12 bits
10.5 ADC clock cycles at ADC resolution 10 bits
8.5 ADC clock cycles at ADC resolution 8 bits
6.5 ADC clock cycles at ADC resolution 6 bits

In case of ADC conversion of internal channel (VrefInt, temperature sensor, ...), a sampling time minimum value is required. Refer to device datasheet.

On this STM32 series, setting of this feature is conditioned to ADC state: ADC must be disabled or enabled without conversion on going on either groups regular or injected.

Reference Manual to LL API cross reference:: SMPR1 SMP0 LL_ADC_SetChannelSamplingTime
SMPR1 SMP1 LL_ADC_SetChannelSamplingTime
SMPR1 SMP2 LL_ADC_SetChannelSamplingTime
SMPR1 SMP3 LL_ADC_SetChannelSamplingTime
SMPR1 SMP4 LL_ADC_SetChannelSamplingTime
SMPR1 SMP5 LL_ADC_SetChannelSamplingTime
SMPR1 SMP6 LL_ADC_SetChannelSamplingTime
SMPR1 SMP7 LL_ADC_SetChannelSamplingTime
SMPR1 SMP8 LL_ADC_SetChannelSamplingTime
SMPR1 SMP9 LL_ADC_SetChannelSamplingTime
SMPR2 SMP10 LL_ADC_SetChannelSamplingTime
SMPR2 SMP11 LL_ADC_SetChannelSamplingTime
SMPR2 SMP12 LL_ADC_SetChannelSamplingTime
SMPR2 SMP13 LL_ADC_SetChannelSamplingTime
SMPR2 SMP14 LL_ADC_SetChannelSamplingTime
SMPR2 SMP15 LL_ADC_SetChannelSamplingTime
SMPR2 SMP16 LL_ADC_SetChannelSamplingTime
SMPR2 SMP17 LL_ADC_SetChannelSamplingTime
SMPR2 SMP18 LL_ADC_SetChannelSamplingTime

Parameters:

ADCx	ADC instance
Channel	This parameter can be one of the following values: LL_ADC_CHANNEL_0 (3) LL_ADC_CHANNEL_1 (3) LL_ADC_CHANNEL_2 (3) LL_ADC_CHANNEL_3 (3) LL_ADC_CHANNEL_4 (3) LL_ADC_CHANNEL_5 (3) LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_18 LL_ADC_CHANNEL_19 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) LL_ADC_CHANNEL_VBAT (1) LL_ADC_CHANNEL_DAC1CH1_ADC2 (2) LL_ADC_CHANNEL_DAC1CH2_ADC2 (2) (1) On STM32H7, parameter available only on ADC instance: ADC3. (2) On STM32H7, parameter available only on ADC instance: ADC2. (3) On STM32H7, fast channel (0.125 us for 14-bit resolution (ADC conversion rate up to 8 Ms/s)). Other channels are slow channels (conversion rate: refer to reference manual).
SamplingTime	This parameter can be one of the following values: LL_ADC_SAMPLINGTIME_1CYCLE_5 LL_ADC_SAMPLINGTIME_2CYCLES_5 LL_ADC_SAMPLINGTIME_8CYCLES_5 LL_ADC_SAMPLINGTIME_16CYCLES_5 LL_ADC_SAMPLINGTIME_32CYCLES_5 LL_ADC_SAMPLINGTIME_64CYCLES_5 LL_ADC_SAMPLINGTIME_387CYCLES_5 LL_ADC_SAMPLINGTIME_810CYCLES_5

Return values:

None

Definition at line 5342 of file stm32h7xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_CHANNEL_SMPRX_REGOFFSET_MASK, ADC_CHANNEL_SMPx_BITOFFSET_MASK, ADC_CHANNEL_SMPx_BITOFFSET_POS, and ADC_SMPRX_REGOFFSET_POS.

Referenced by HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

__STATIC_INLINE void LL_ADC_SetChannelSingleDiff	(	ADC_TypeDef *	ADCx,
		uint32_t	Channel,
		uint32_t	SingleDiff
	)

Set mode single-ended or differential input of the selected ADC channel.

Note:

Channel ending is on channel scope: independently of channel mapped on ADC group regular or injected. In differential mode: Differential measurement is carried out between the selected channel 'i' (positive input) and channel 'i+1' (negative input). Only channel 'i' has to be configured, channel 'i+1' is configured automatically.

Refer to Reference Manual to ensure the selected channel is available in differential mode. For example, internal channels (VrefInt, TempSensor, ...) are not available in differential mode.

When configuring a channel 'i' in differential mode, the channel 'i+1' is not usable separately.

On STM32H7, some channels are internally fixed to single-ended inputs configuration:

ADC1: Channels 0, 6, 7, 8, 9, 13, 14, 15, 17, and 19
ADC2: Channels 0, 6, 7, 8, 9, 13, 14, 15 and 19
ADC3: Channels 0, 6, 7, 8, 9, 12, 16, 17, and 19

For ADC channels configured in differential mode, both inputs should be biased at (Vref+)/2 +/-200mV. (Vref+ is the analog voltage reference)

On this STM32 series, setting of this feature is conditioned to ADC state: ADC must be ADC disabled.

One or several values can be selected. Example: (LL_ADC_CHANNEL_4 | LL_ADC_CHANNEL_12 | ...)

Reference Manual to LL API cross reference:: DIFSEL DIFSEL LL_ADC_SetChannelSingleDiff

Parameters:

ADCx	ADC instance
Channel	This parameter can be one of the following values: LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_18 LL_ADC_CHANNEL_19
SingleDiff	This parameter can be a combination of the following values: LL_ADC_SINGLE_ENDED LL_ADC_DIFFERENTIAL_ENDED

Return values:

None

Definition at line 5488 of file stm32h7xx_ll_adc.h.

References ADC_SINGLEDIFF_CHANNEL_MASK, and ADC_SINGLEDIFF_CHANNEL_SHIFT_MASK.

Referenced by HAL_ADC_ConfigChannel(), and HAL_ADCEx_InjectedConfigChannel().

Functions

Function Documentation