Functions
__STATIC_INLINE void	LL_ADC_SetAnalogWDMonitChannels (ADC_TypeDef *ADCx, uint32_t AWDy, uint32_t AWDChannelGroup)
	Set ADC analog watchdog monitored channels: a single channel, multiple channels or all channels, on ADC groups regular and-or injected.
__STATIC_INLINE uint32_t	LL_ADC_GetAnalogWDMonitChannels (ADC_TypeDef *ADCx, uint32_t AWDy)
	Get ADC analog watchdog monitored channel.
__STATIC_INLINE void	LL_ADC_ConfigAnalogWDThresholds (ADC_TypeDef *ADCx, uint32_t AWDy, uint32_t AWDThresholdHighValue, uint32_t AWDThresholdLowValue)
	Set ADC analog watchdog thresholds value of both thresholds high and low.
__STATIC_INLINE void	LL_ADC_SetAnalogWDThresholds (ADC_TypeDef *ADCx, uint32_t AWDy, uint32_t AWDThresholdsHighLow, uint32_t AWDThresholdValue)
	Set ADC analog watchdog threshold value of threshold high or low.
__STATIC_INLINE uint32_t	LL_ADC_GetAnalogWDThresholds (ADC_TypeDef *ADCx, uint32_t AWDy, uint32_t AWDThresholdsHighLow)
	Get ADC analog watchdog threshold value of threshold high, threshold low or raw data with ADC thresholds high and low concatenated.

Function Documentation

__STATIC_INLINE void LL_ADC_ConfigAnalogWDThresholds	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDy,
		uint32_t	AWDThresholdHighValue,
		uint32_t	AWDThresholdLowValue
	)

Set ADC analog watchdog thresholds value of both thresholds high and low.

Note:

If value of only one threshold high or low must be set, use function LL_ADC_SetAnalogWDThresholds().

In case of ADC resolution different of 12 bits, analog watchdog thresholds data require a specific shift. Use helper macro __LL_ADC_ANALOGWD_SET_THRESHOLD_RESOLUTION().

On this STM32 series, there are 2 kinds of analog watchdog instance:

AWD standard (instance AWD1):
- channels monitored: can monitor 1 channel or all channels.
- groups monitored: ADC groups regular and-or injected.
- resolution: resolution is not limited (corresponds to ADC resolution configured).
AWD flexible (instances AWD2, AWD3):
- channels monitored: flexible on channels monitored, selection is channel wise, from from 1 to all channels. Specificity of this analog watchdog: Multiple channels can be selected. For example: (LL_ADC_AWD_CHANNEL4_REG_INJ | LL_ADC_AWD_CHANNEL5_REG_INJ | ...)
- groups monitored: not selection possible (monitoring on both groups regular and injected). Channels selected are monitored on groups regular and injected: LL_ADC_AWD_CHANNELxx_REG_INJ (do not use parameters LL_ADC_AWD_CHANNELxx_REG and LL_ADC_AWD_CHANNELxx_INJ)
- resolution: resolution is limited to 8 bits: if ADC resolution is 12 bits the 4 LSB are ignored, if ADC resolution is 10 bits the 2 LSB are ignored.

If ADC oversampling is enabled, ADC analog watchdog thresholds are impacted: the comparison of analog watchdog thresholds is done on oversampling final computation (after ratio and shift application): ADC data register bitfield [15:4] (12 most significant bits).

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:: TR1 HT1 LL_ADC_ConfigAnalogWDThresholds
TR2 HT2 LL_ADC_ConfigAnalogWDThresholds
TR3 HT3 LL_ADC_ConfigAnalogWDThresholds
TR1 LT1 LL_ADC_ConfigAnalogWDThresholds
TR2 LT2 LL_ADC_ConfigAnalogWDThresholds
TR3 LT3 LL_ADC_ConfigAnalogWDThresholds

Parameters:

ADCx	ADC instance
AWDy	This parameter can be one of the following values: LL_ADC_AWD1 LL_ADC_AWD2 LL_ADC_AWD3
AWDThresholdHighValue	Value between Min_Data=0x000 and Max_Data=0xFFF
AWDThresholdLowValue	Value between Min_Data=0x000 and Max_Data=0xFFF

Return values:

None

Definition at line 5318 of file stm32l4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_AWD_TRX_REGOFFSET_MASK, ADC_AWD_TRX_REGOFFSET_POS, and ADC_TR1_HT1_BITOFFSET_POS.

Referenced by HAL_ADC_AnalogWDGConfig().

__STATIC_INLINE uint32_t LL_ADC_GetAnalogWDMonitChannels	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDy
	)

Get ADC analog watchdog monitored channel.

Note:

Usage of the returned channel number:

To reinject this channel into another function LL_ADC_xxx: the returned channel number is only partly formatted on definition of literals LL_ADC_CHANNEL_x. Therefore, it has to be compared with parts of literals LL_ADC_CHANNEL_x or using helper macro __LL_ADC_CHANNEL_TO_DECIMAL_NB(). Then the selected literal LL_ADC_CHANNEL_x can be used as parameter for another function.
To get the channel number in decimal format: process the returned value with the helper macro __LL_ADC_CHANNEL_TO_DECIMAL_NB(). Applicable only when the analog watchdog is set to monitor one channel.

On this STM32 series, there are 2 kinds of analog watchdog instance:

AWD standard (instance AWD1):
- channels monitored: can monitor 1 channel or all channels.
- groups monitored: ADC groups regular and-or injected.
- resolution: resolution is not limited (corresponds to ADC resolution configured).
AWD flexible (instances AWD2, AWD3):
- channels monitored: flexible on channels monitored, selection is channel wise, from from 1 to all channels. Specificity of this analog watchdog: Multiple channels can be selected. For example: (LL_ADC_AWD_CHANNEL4_REG_INJ | LL_ADC_AWD_CHANNEL5_REG_INJ | ...)
- groups monitored: not selection possible (monitoring on both groups regular and injected). Channels selected are monitored on groups regular and injected: LL_ADC_AWD_CHANNELxx_REG_INJ (do not use parameters LL_ADC_AWD_CHANNELxx_REG and LL_ADC_AWD_CHANNELxx_INJ)
- resolution: resolution is limited to 8 bits: if ADC resolution is 12 bits the 4 LSB are ignored, if ADC resolution is 10 bits the 2 LSB are ignored.

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:: CFGR AWD1CH LL_ADC_GetAnalogWDMonitChannels
CFGR AWD1SGL LL_ADC_GetAnalogWDMonitChannels
CFGR AWD1EN LL_ADC_GetAnalogWDMonitChannels
CFGR JAWD1EN LL_ADC_GetAnalogWDMonitChannels
AWD2CR AWD2CH LL_ADC_GetAnalogWDMonitChannels
AWD3CR AWD3CH LL_ADC_GetAnalogWDMonitChannels

Parameters:

ADCx	ADC instance
AWDy	This parameter can be one of the following values: LL_ADC_AWD1 LL_ADC_AWD2 (1) LL_ADC_AWD3 (1) (1) On this AWD number, monitored channel can be retrieved if only 1 channel is programmed (or none or all channels). This function cannot retrieve monitored channel if multiple channels are programmed simultaneously by bitfield.

Return values:

Returned

value can be one of the following values:

(0) On STM32L4, parameter available only on analog watchdog number: AWD1.

Definition at line 5210 of file stm32l4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, __LL_ADC_CHANNEL_TO_DECIMAL_NB, ADC_AWD_CR12_REGOFFSETGAP_MASK, ADC_AWD_CR12_REGOFFSETGAP_VAL, ADC_AWD_CR23_CHANNEL_MASK, ADC_AWD_CR_ALL_CHANNEL_MASK, ADC_AWD_CRX_REGOFFSET_MASK, ADC_AWD_CRX_REGOFFSET_POS, and LL_ADC_AWD1.

__STATIC_INLINE uint32_t LL_ADC_GetAnalogWDThresholds	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDy,
		uint32_t	AWDThresholdsHighLow
	)

Get ADC analog watchdog threshold value of threshold high, threshold low or raw data with ADC thresholds high and low concatenated.

Note:: If raw data with ADC thresholds high and low is retrieved, the data of each threshold high or low can be isolated using helper macro: __LL_ADC_ANALOGWD_THRESHOLDS_HIGH_LOW().; In case of ADC resolution different of 12 bits, analog watchdog thresholds data require a specific shift. Use helper macro __LL_ADC_ANALOGWD_GET_THRESHOLD_RESOLUTION().

Reference Manual to LL API cross reference:: TR1 HT1 LL_ADC_GetAnalogWDThresholds
TR2 HT2 LL_ADC_GetAnalogWDThresholds
TR3 HT3 LL_ADC_GetAnalogWDThresholds
TR1 LT1 LL_ADC_GetAnalogWDThresholds
TR2 LT2 LL_ADC_GetAnalogWDThresholds
TR3 LT3 LL_ADC_GetAnalogWDThresholds

Parameters:

ADCx	ADC instance
AWDy	This parameter can be one of the following values: LL_ADC_AWD1 LL_ADC_AWD2 LL_ADC_AWD3
AWDThresholdsHighLow	This parameter can be one of the following values: LL_ADC_AWD_THRESHOLD_HIGH LL_ADC_AWD_THRESHOLD_LOW LL_ADC_AWD_THRESHOLDS_HIGH_LOW

Return values:

Value between Min_Data=0x000 and Max_Data=0xFFF

Definition at line 5431 of file stm32l4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_AWD_TRX_BIT_HIGH_MASK, ADC_AWD_TRX_BIT_HIGH_SHIFT4, ADC_AWD_TRX_REGOFFSET_MASK, and ADC_AWD_TRX_REGOFFSET_POS.

__STATIC_INLINE void LL_ADC_SetAnalogWDMonitChannels	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDy,
		uint32_t	AWDChannelGroup
	)

Set ADC analog watchdog monitored channels: a single channel, multiple channels or all channels, on ADC groups regular and-or injected.

Note:

Once monitored channels are selected, analog watchdog is enabled.

In case of need to define a single channel to monitor with analog watchdog from sequencer channel definition, use helper macro __LL_ADC_ANALOGWD_CHANNEL_GROUP().

On this STM32 series, there are 2 kinds of analog watchdog instance:

AWD standard (instance AWD1):
- channels monitored: can monitor 1 channel or all channels.
- groups monitored: ADC groups regular and-or injected.
- resolution: resolution is not limited (corresponds to ADC resolution configured).
AWD flexible (instances AWD2, AWD3):
- channels monitored: flexible on channels monitored, selection is channel wise, from from 1 to all channels. Specificity of this analog watchdog: Multiple channels can be selected. For example: (LL_ADC_AWD_CHANNEL4_REG_INJ | LL_ADC_AWD_CHANNEL5_REG_INJ | ...)
- groups monitored: not selection possible (monitoring on both groups regular and injected). Channels selected are monitored on groups regular and injected: LL_ADC_AWD_CHANNELxx_REG_INJ (do not use parameters LL_ADC_AWD_CHANNELxx_REG and LL_ADC_AWD_CHANNELxx_INJ)
- resolution: resolution is limited to 8 bits: if ADC resolution is 12 bits the 4 LSB are ignored, if ADC resolution is 10 bits the 2 LSB are ignored.

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:: CFGR AWD1CH LL_ADC_SetAnalogWDMonitChannels
CFGR AWD1SGL LL_ADC_SetAnalogWDMonitChannels
CFGR AWD1EN LL_ADC_SetAnalogWDMonitChannels
CFGR JAWD1EN LL_ADC_SetAnalogWDMonitChannels
AWD2CR AWD2CH LL_ADC_SetAnalogWDMonitChannels
AWD3CR AWD3CH LL_ADC_SetAnalogWDMonitChannels

Parameters:

ADCx	ADC instance
AWDy	This parameter can be one of the following values: LL_ADC_AWD1 LL_ADC_AWD2 LL_ADC_AWD3
AWDChannelGroup	This parameter can be one of the following values: LL_ADC_AWD_DISABLE LL_ADC_AWD_ALL_CHANNELS_REG (0) LL_ADC_AWD_ALL_CHANNELS_INJ (0) LL_ADC_AWD_ALL_CHANNELS_REG_INJ LL_ADC_AWD_CHANNEL_0_REG (0) LL_ADC_AWD_CHANNEL_0_INJ (0) LL_ADC_AWD_CHANNEL_0_REG_INJ LL_ADC_AWD_CHANNEL_1_REG (0) LL_ADC_AWD_CHANNEL_1_INJ (0) LL_ADC_AWD_CHANNEL_1_REG_INJ LL_ADC_AWD_CHANNEL_2_REG (0) LL_ADC_AWD_CHANNEL_2_INJ (0) LL_ADC_AWD_CHANNEL_2_REG_INJ LL_ADC_AWD_CHANNEL_3_REG (0) LL_ADC_AWD_CHANNEL_3_INJ (0) LL_ADC_AWD_CHANNEL_3_REG_INJ LL_ADC_AWD_CHANNEL_4_REG (0) LL_ADC_AWD_CHANNEL_4_INJ (0) LL_ADC_AWD_CHANNEL_4_REG_INJ LL_ADC_AWD_CHANNEL_5_REG (0) LL_ADC_AWD_CHANNEL_5_INJ (0) LL_ADC_AWD_CHANNEL_5_REG_INJ LL_ADC_AWD_CHANNEL_6_REG (0) LL_ADC_AWD_CHANNEL_6_INJ (0) LL_ADC_AWD_CHANNEL_6_REG_INJ LL_ADC_AWD_CHANNEL_7_REG (0) LL_ADC_AWD_CHANNEL_7_INJ (0) LL_ADC_AWD_CHANNEL_7_REG_INJ LL_ADC_AWD_CHANNEL_8_REG (0) LL_ADC_AWD_CHANNEL_8_INJ (0) LL_ADC_AWD_CHANNEL_8_REG_INJ LL_ADC_AWD_CHANNEL_9_REG (0) LL_ADC_AWD_CHANNEL_9_INJ (0) LL_ADC_AWD_CHANNEL_9_REG_INJ LL_ADC_AWD_CHANNEL_10_REG (0) LL_ADC_AWD_CHANNEL_10_INJ (0) LL_ADC_AWD_CHANNEL_10_REG_INJ LL_ADC_AWD_CHANNEL_11_REG (0) LL_ADC_AWD_CHANNEL_11_INJ (0) LL_ADC_AWD_CHANNEL_11_REG_INJ LL_ADC_AWD_CHANNEL_12_REG (0) LL_ADC_AWD_CHANNEL_12_INJ (0) LL_ADC_AWD_CHANNEL_12_REG_INJ LL_ADC_AWD_CHANNEL_13_REG (0) LL_ADC_AWD_CHANNEL_13_INJ (0) LL_ADC_AWD_CHANNEL_13_REG_INJ LL_ADC_AWD_CHANNEL_14_REG (0) LL_ADC_AWD_CHANNEL_14_INJ (0) LL_ADC_AWD_CHANNEL_14_REG_INJ LL_ADC_AWD_CHANNEL_15_REG (0) LL_ADC_AWD_CHANNEL_15_INJ (0) LL_ADC_AWD_CHANNEL_15_REG_INJ LL_ADC_AWD_CHANNEL_16_REG (0) LL_ADC_AWD_CHANNEL_16_INJ (0) LL_ADC_AWD_CHANNEL_16_REG_INJ LL_ADC_AWD_CHANNEL_17_REG (0) LL_ADC_AWD_CHANNEL_17_INJ (0) LL_ADC_AWD_CHANNEL_17_REG_INJ LL_ADC_AWD_CHANNEL_18_REG (0) LL_ADC_AWD_CHANNEL_18_INJ (0) LL_ADC_AWD_CHANNEL_18_REG_INJ LL_ADC_AWD_CH_VREFINT_REG (0)(1) LL_ADC_AWD_CH_VREFINT_INJ (0)(1) LL_ADC_AWD_CH_VREFINT_REG_INJ (1) LL_ADC_AWD_CH_TEMPSENSOR_REG (0)(4) LL_ADC_AWD_CH_TEMPSENSOR_INJ (0)(4) LL_ADC_AWD_CH_TEMPSENSOR_REG_INJ (4) LL_ADC_AWD_CH_VBAT_REG (0)(4) LL_ADC_AWD_CH_VBAT_INJ (0)(4) LL_ADC_AWD_CH_VBAT_REG_INJ (4) LL_ADC_AWD_CH_DAC1CH1_REG (0)(2)(5) LL_ADC_AWD_CH_DAC1CH1_INJ (0)(2)(5) LL_ADC_AWD_CH_DAC1CH1_REG_INJ (2)(5) LL_ADC_AWD_CH_DAC1CH2_REG (0)(2)(5) LL_ADC_AWD_CH_DAC1CH2_INJ (0)(2)(5) LL_ADC_AWD_CH_DAC1CH2_REG_INJ (2)(5) LL_ADC_AWD_CH_DAC1CH1_ADC2_REG (0)(2)(6) LL_ADC_AWD_CH_DAC1CH1_ADC2_INJ (0)(2)(6) LL_ADC_AWD_CH_DAC1CH1_ADC2_REG_INJ (2)(6) LL_ADC_AWD_CH_DAC1CH2_ADC2_REG (0)(2)(6) LL_ADC_AWD_CH_DAC1CH2_ADC2_INJ (0)(2)(6) LL_ADC_AWD_CH_DAC1CH2_ADC2_REG_INJ (2)(6) LL_ADC_AWD_CH_DAC1CH1_ADC3_REG (0)(3)(6) LL_ADC_AWD_CH_DAC1CH1_ADC3_INJ (0)(3)(6) LL_ADC_AWD_CH_DAC1CH1_ADC3_REG_INJ (3)(6) LL_ADC_AWD_CH_DAC1CH2_ADC3_REG (0)(3)(6) LL_ADC_AWD_CH_DAC1CH2_ADC3_INJ (0)(3)(6) LL_ADC_AWD_CH_DAC1CH2_ADC3_REG_INJ (3)(6) (0) On STM32L4, parameter available only on analog watchdog number: AWD1. (1) On STM32L4, parameter available only on ADC instance: ADC1. (2) On STM32L4, parameter available only on ADC instance: ADC2. (3) On STM32L4, parameter available only on ADC instance: ADC3. (4) On STM32L4, parameter available only on ADC instances: ADC1, ADC3. (5) On STM32L4, parameter available on devices with only 1 ADC instance. (6) On STM32L4, parameter available on devices with several ADC instances.

Return values:

None

Definition at line 5074 of file stm32l4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_AWD_CR12_REGOFFSETGAP_MASK, ADC_AWD_CR12_REGOFFSETGAP_VAL, ADC_AWD_CR_ALL_CHANNEL_MASK, ADC_AWD_CRX_REGOFFSET_MASK, and ADC_AWD_CRX_REGOFFSET_POS.

Referenced by HAL_ADC_AnalogWDGConfig().

__STATIC_INLINE void LL_ADC_SetAnalogWDThresholds	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDy,
		uint32_t	AWDThresholdsHighLow,
		uint32_t	AWDThresholdValue
	)

Set ADC analog watchdog threshold value of threshold high or low.

Note:

If values of both thresholds high or low must be set, use function LL_ADC_ConfigAnalogWDThresholds().

In case of ADC resolution different of 12 bits, analog watchdog thresholds data require a specific shift. Use helper macro __LL_ADC_ANALOGWD_SET_THRESHOLD_RESOLUTION().

On this STM32 series, there are 2 kinds of analog watchdog instance:

AWD standard (instance AWD1):
- channels monitored: can monitor 1 channel or all channels.
- groups monitored: ADC groups regular and-or injected.
- resolution: resolution is not limited (corresponds to ADC resolution configured).
AWD flexible (instances AWD2, AWD3):
- channels monitored: flexible on channels monitored, selection is channel wise, from from 1 to all channels. Specificity of this analog watchdog: Multiple channels can be selected. For example: (LL_ADC_AWD_CHANNEL4_REG_INJ | LL_ADC_AWD_CHANNEL5_REG_INJ | ...)
- groups monitored: not selection possible (monitoring on both groups regular and injected). Channels selected are monitored on groups regular and injected: LL_ADC_AWD_CHANNELxx_REG_INJ (do not use parameters LL_ADC_AWD_CHANNELxx_REG and LL_ADC_AWD_CHANNELxx_INJ)
- resolution: resolution is limited to 8 bits: if ADC resolution is 12 bits the 4 LSB are ignored, if ADC resolution is 10 bits the 2 LSB are ignored.

If ADC oversampling is enabled, ADC analog watchdog thresholds are impacted: the comparison of analog watchdog thresholds is done on oversampling final computation (after ratio and shift application): ADC data register bitfield [15:4] (12 most significant bits).

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 ADC groups regular or injected.

Reference Manual to LL API cross reference:: TR1 HT1 LL_ADC_SetAnalogWDThresholds
TR2 HT2 LL_ADC_SetAnalogWDThresholds
TR3 HT3 LL_ADC_SetAnalogWDThresholds
TR1 LT1 LL_ADC_SetAnalogWDThresholds
TR2 LT2 LL_ADC_SetAnalogWDThresholds
TR3 LT3 LL_ADC_SetAnalogWDThresholds

Parameters:

ADCx	ADC instance
AWDy	This parameter can be one of the following values: LL_ADC_AWD1 LL_ADC_AWD2 LL_ADC_AWD3
AWDThresholdsHighLow	This parameter can be one of the following values: LL_ADC_AWD_THRESHOLD_HIGH LL_ADC_AWD_THRESHOLD_LOW
AWDThresholdValue	Value between Min_Data=0x000 and Max_Data=0xFFF

Return values:

None

Definition at line 5387 of file stm32l4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET, ADC_AWD_TRX_BIT_HIGH_MASK, ADC_AWD_TRX_BIT_HIGH_SHIFT4, ADC_AWD_TRX_REGOFFSET_MASK, and ADC_AWD_TRX_REGOFFSET_POS.

Functions

Function Documentation