Configuration of ADC transversal scope: analog watchdog

Functions
__STATIC_INLINE void	LL_ADC_SetAnalogWDMonitChannels (ADC_TypeDef *ADCx, uint32_t AWDChannelGroup)
	Set ADC analog watchdog monitored channels: a single channel or all channels, on ADC groups regular and-or injected.
__STATIC_INLINE uint32_t	LL_ADC_GetAnalogWDMonitChannels (ADC_TypeDef *ADCx)
	Get ADC analog watchdog monitored channel.
__STATIC_INLINE void	LL_ADC_SetAnalogWDThresholds (ADC_TypeDef *ADCx, 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 AWDThresholdsHighLow)
	Get ADC analog watchdog threshold value of threshold high or threshold low.

---

Function Documentation

__STATIC_INLINE uint32_t LL_ADC_GetAnalogWDMonitChannels

(

ADC_TypeDef *

ADCx

)

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 serie, there is only 1 kind 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).

Reference Manual to LL API cross reference:

CR1 AWD1CH LL_ADC_GetAnalogWDMonitChannels
CR1 AWD1SGL LL_ADC_GetAnalogWDMonitChannels
CR1 AWD1EN LL_ADC_GetAnalogWDMonitChannels

Parameters:

ADCx	ADC instance

Return values:

Returned

value can be one of the following values: LL_ADC_AWD_DISABLE LL_ADC_AWD_ALL_CHANNELS_REG LL_ADC_AWD_ALL_CHANNELS_INJ LL_ADC_AWD_ALL_CHANNELS_REG_INJ LL_ADC_AWD_CHANNEL_0_REG LL_ADC_AWD_CHANNEL_0_INJ LL_ADC_AWD_CHANNEL_0_REG_INJ LL_ADC_AWD_CHANNEL_1_REG LL_ADC_AWD_CHANNEL_1_INJ LL_ADC_AWD_CHANNEL_1_REG_INJ LL_ADC_AWD_CHANNEL_2_REG LL_ADC_AWD_CHANNEL_2_INJ LL_ADC_AWD_CHANNEL_2_REG_INJ LL_ADC_AWD_CHANNEL_3_REG LL_ADC_AWD_CHANNEL_3_INJ LL_ADC_AWD_CHANNEL_3_REG_INJ LL_ADC_AWD_CHANNEL_4_REG LL_ADC_AWD_CHANNEL_4_INJ LL_ADC_AWD_CHANNEL_4_REG_INJ LL_ADC_AWD_CHANNEL_5_REG LL_ADC_AWD_CHANNEL_5_INJ LL_ADC_AWD_CHANNEL_5_REG_INJ LL_ADC_AWD_CHANNEL_6_REG LL_ADC_AWD_CHANNEL_6_INJ LL_ADC_AWD_CHANNEL_6_REG_INJ LL_ADC_AWD_CHANNEL_7_REG LL_ADC_AWD_CHANNEL_7_INJ LL_ADC_AWD_CHANNEL_7_REG_INJ LL_ADC_AWD_CHANNEL_8_REG LL_ADC_AWD_CHANNEL_8_INJ LL_ADC_AWD_CHANNEL_8_REG_INJ LL_ADC_AWD_CHANNEL_9_REG LL_ADC_AWD_CHANNEL_9_INJ LL_ADC_AWD_CHANNEL_9_REG_INJ LL_ADC_AWD_CHANNEL_10_REG LL_ADC_AWD_CHANNEL_10_INJ LL_ADC_AWD_CHANNEL_10_REG_INJ LL_ADC_AWD_CHANNEL_11_REG LL_ADC_AWD_CHANNEL_11_INJ LL_ADC_AWD_CHANNEL_11_REG_INJ LL_ADC_AWD_CHANNEL_12_REG LL_ADC_AWD_CHANNEL_12_INJ LL_ADC_AWD_CHANNEL_12_REG_INJ LL_ADC_AWD_CHANNEL_13_REG LL_ADC_AWD_CHANNEL_13_INJ LL_ADC_AWD_CHANNEL_13_REG_INJ LL_ADC_AWD_CHANNEL_14_REG LL_ADC_AWD_CHANNEL_14_INJ LL_ADC_AWD_CHANNEL_14_REG_INJ LL_ADC_AWD_CHANNEL_15_REG LL_ADC_AWD_CHANNEL_15_INJ LL_ADC_AWD_CHANNEL_15_REG_INJ LL_ADC_AWD_CHANNEL_16_REG LL_ADC_AWD_CHANNEL_16_INJ LL_ADC_AWD_CHANNEL_16_REG_INJ LL_ADC_AWD_CHANNEL_17_REG LL_ADC_AWD_CHANNEL_17_INJ LL_ADC_AWD_CHANNEL_17_REG_INJ LL_ADC_AWD_CHANNEL_18_REG LL_ADC_AWD_CHANNEL_18_INJ LL_ADC_AWD_CHANNEL_18_REG_INJ

Definition at line 3473 of file stm32f4xx_ll_adc.h.

__STATIC_INLINE uint32_t LL_ADC_GetAnalogWDThresholds	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDThresholdsHighLow
	)

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

Note:

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:

HTR HT LL_ADC_GetAnalogWDThresholds
LTR LT LL_ADC_GetAnalogWDThresholds

Parameters:

ADCx	ADC instance
AWDThresholdsHighLow	This parameter can be one of the following values: LL_ADC_AWD_THRESHOLD_HIGH LL_ADC_AWD_THRESHOLD_LOW

Return values:

Value

between Min_Data=0x000 and Max_Data=0xFFF

Definition at line 3523 of file stm32f4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET.

__STATIC_INLINE void LL_ADC_SetAnalogWDMonitChannels	(	ADC_TypeDef *	ADCx,
		uint32_t	AWDChannelGroup
	)

Set ADC analog watchdog monitored channels: a single channel 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 serie, there is only 1 kind 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).

Reference Manual to LL API cross reference:

CR1 AWD1CH LL_ADC_SetAnalogWDMonitChannels
CR1 AWD1SGL LL_ADC_SetAnalogWDMonitChannels
CR1 AWD1EN LL_ADC_SetAnalogWDMonitChannels

Parameters:

ADCx

ADC instance

AWDChannelGroup

This parameter can be one of the following values: LL_ADC_AWD_DISABLE LL_ADC_AWD_ALL_CHANNELS_REG LL_ADC_AWD_ALL_CHANNELS_INJ LL_ADC_AWD_ALL_CHANNELS_REG_INJ LL_ADC_AWD_CHANNEL_0_REG LL_ADC_AWD_CHANNEL_0_INJ LL_ADC_AWD_CHANNEL_0_REG_INJ LL_ADC_AWD_CHANNEL_1_REG LL_ADC_AWD_CHANNEL_1_INJ LL_ADC_AWD_CHANNEL_1_REG_INJ LL_ADC_AWD_CHANNEL_2_REG LL_ADC_AWD_CHANNEL_2_INJ LL_ADC_AWD_CHANNEL_2_REG_INJ LL_ADC_AWD_CHANNEL_3_REG LL_ADC_AWD_CHANNEL_3_INJ LL_ADC_AWD_CHANNEL_3_REG_INJ LL_ADC_AWD_CHANNEL_4_REG LL_ADC_AWD_CHANNEL_4_INJ LL_ADC_AWD_CHANNEL_4_REG_INJ LL_ADC_AWD_CHANNEL_5_REG LL_ADC_AWD_CHANNEL_5_INJ LL_ADC_AWD_CHANNEL_5_REG_INJ LL_ADC_AWD_CHANNEL_6_REG LL_ADC_AWD_CHANNEL_6_INJ LL_ADC_AWD_CHANNEL_6_REG_INJ LL_ADC_AWD_CHANNEL_7_REG LL_ADC_AWD_CHANNEL_7_INJ LL_ADC_AWD_CHANNEL_7_REG_INJ LL_ADC_AWD_CHANNEL_8_REG LL_ADC_AWD_CHANNEL_8_INJ LL_ADC_AWD_CHANNEL_8_REG_INJ LL_ADC_AWD_CHANNEL_9_REG LL_ADC_AWD_CHANNEL_9_INJ LL_ADC_AWD_CHANNEL_9_REG_INJ LL_ADC_AWD_CHANNEL_10_REG LL_ADC_AWD_CHANNEL_10_INJ LL_ADC_AWD_CHANNEL_10_REG_INJ LL_ADC_AWD_CHANNEL_11_REG LL_ADC_AWD_CHANNEL_11_INJ LL_ADC_AWD_CHANNEL_11_REG_INJ LL_ADC_AWD_CHANNEL_12_REG LL_ADC_AWD_CHANNEL_12_INJ LL_ADC_AWD_CHANNEL_12_REG_INJ LL_ADC_AWD_CHANNEL_13_REG LL_ADC_AWD_CHANNEL_13_INJ LL_ADC_AWD_CHANNEL_13_REG_INJ LL_ADC_AWD_CHANNEL_14_REG LL_ADC_AWD_CHANNEL_14_INJ LL_ADC_AWD_CHANNEL_14_REG_INJ LL_ADC_AWD_CHANNEL_15_REG LL_ADC_AWD_CHANNEL_15_INJ LL_ADC_AWD_CHANNEL_15_REG_INJ LL_ADC_AWD_CHANNEL_16_REG LL_ADC_AWD_CHANNEL_16_INJ LL_ADC_AWD_CHANNEL_16_REG_INJ LL_ADC_AWD_CHANNEL_17_REG LL_ADC_AWD_CHANNEL_17_INJ LL_ADC_AWD_CHANNEL_17_REG_INJ LL_ADC_AWD_CHANNEL_18_REG LL_ADC_AWD_CHANNEL_18_INJ LL_ADC_AWD_CHANNEL_18_REG_INJ LL_ADC_AWD_CH_VREFINT_REG (1) LL_ADC_AWD_CH_VREFINT_INJ (1) LL_ADC_AWD_CH_VREFINT_REG_INJ (1) LL_ADC_AWD_CH_TEMPSENSOR_REG (1)(2) LL_ADC_AWD_CH_TEMPSENSOR_INJ (1)(2) LL_ADC_AWD_CH_TEMPSENSOR_REG_INJ (1)(2) LL_ADC_AWD_CH_VBAT_REG (1) LL_ADC_AWD_CH_VBAT_INJ (1) LL_ADC_AWD_CH_VBAT_REG_INJ (1) (1) On STM32F4, parameter available only on ADC instance: ADC1. (2) On devices STM32F42x and STM32F43x, limitation: this internal channel is shared between temperature sensor and Vbat, only 1 measurement path must be enabled.

Return values:

None

Definition at line 3377 of file stm32f4xx_ll_adc.h.

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

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

Note:

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 serie, there is only 1 kind 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).

Reference Manual to LL API cross reference:

HTR HT LL_ADC_SetAnalogWDThresholds
LTR LT LL_ADC_SetAnalogWDThresholds

Parameters:

ADCx	ADC instance
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 3500 of file stm32f4xx_ll_adc.h.

References __ADC_PTR_REG_OFFSET.