Configuration of ADC transversal scope: analog watchdog
[ADC Exported Functions]

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 serie, 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 serie, 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. 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 5127 of file stm32l4xx_ll_adc.h.

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 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 serie, 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. 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: 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 (0) On STM32L4, parameter available only on analog watchdog number: AWD1.

Definition at line 5030 of file stm32l4xx_ll_adc.h.

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(). 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 5233 of file stm32l4xx_ll_adc.h.

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 serie, 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 serie, 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. 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 4894 of file stm32l4xx_ll_adc.h.

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 serie, 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 serie, 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. 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 5191 of file stm32l4xx_ll_adc.h.