Configuration of ADC transversal scope: analog watchdog

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. More...
__STATIC_INLINE uint32_t	LL_ADC_GetAnalogWDMonitChannels (ADC_TypeDef *ADCx, uint32_t AWDy)
	Get ADC analog watchdog monitored channel. More...
__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. More...
__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. More...
__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. More...

Detailed Description

Function Documentation

LL_ADC_ConfigAnalogWDThresholds()

__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 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.

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 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 5247 of file stm32l4xx_ll_adc.h.

{
  /* Set bits with content of parameter "AWDThresholdxxxValue" with bits      */
  /* position in register and register position depending on parameter        */
  /* "AWDy".                                                                  */
  /* Parameters "AWDy" and "AWDThresholdxxxValue" are used with masks because */
  /* containing other bits reserved for other purpose.                        */
  register __IO uint32_t *preg = __ADC_PTR_REG_OFFSET(ADCx->TR1, ((AWDy & ADC_AWD_TRX_REGOFFSET_MASK) >> ADC_AWD_TRX_REGOFFSET_POS));

  MODIFY_REG(*preg,
             ADC_TR1_HT1 | ADC_TR1_LT1,
             (AWDThresholdHighValue << ADC_TR1_HT1_BITOFFSET_POS) | AWDThresholdLowValue);
}

LL_ADC_GetAnalogWDMonitChannels()

__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 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 5139 of file stm32l4xx_ll_adc.h.

{
  register const __IO uint32_t *preg = __ADC_PTR_REG_OFFSET(ADCx->CFGR, ((AWDy & ADC_AWD_CRX_REGOFFSET_MASK) >> ADC_AWD_CRX_REGOFFSET_POS)
                                                            + ((AWDy & ADC_AWD_CR12_REGOFFSETGAP_MASK) * ADC_AWD_CR12_REGOFFSETGAP_VAL));

  register uint32_t AnalogWDMonitChannels = (READ_BIT(*preg, AWDy) & AWDy & ADC_AWD_CR_ALL_CHANNEL_MASK);

  /* If "AnalogWDMonitChannels" == 0, then the selected AWD is disabled       */
  /* (parameter value LL_ADC_AWD_DISABLE).                                    */
  /* Else, the selected AWD is enabled and is monitoring a group of channels  */
  /* or a single channel.                                                     */
  if (AnalogWDMonitChannels != 0UL)
  {
    if (AWDy == LL_ADC_AWD1)
    {
      if ((AnalogWDMonitChannels & ADC_CFGR_AWD1SGL) == 0UL)
      {
        /* AWD monitoring a group of channels */
        AnalogWDMonitChannels = ((AnalogWDMonitChannels
                                  | (ADC_AWD_CR23_CHANNEL_MASK)
                                 )
                                 & (~(ADC_CFGR_AWD1CH))
                                );
      }
      else
      {
        /* AWD monitoring a single channel */
        AnalogWDMonitChannels = (AnalogWDMonitChannels
                                 | (ADC_AWD2CR_AWD2CH_0 << (AnalogWDMonitChannels >> ADC_CFGR_AWD1CH_Pos))
                                );
      }
    }
    else
    {
      if ((AnalogWDMonitChannels & ADC_AWD_CR23_CHANNEL_MASK) == ADC_AWD_CR23_CHANNEL_MASK)
      {
        /* AWD monitoring a group of channels */
        AnalogWDMonitChannels = (ADC_AWD_CR23_CHANNEL_MASK
                                 | ((ADC_CFGR_JAWD1EN | ADC_CFGR_AWD1EN))
                                );
      }
      else
      {
        /* AWD monitoring a single channel */
        /* AWD monitoring a group of channels */
        AnalogWDMonitChannels = (AnalogWDMonitChannels
                                 | (ADC_CFGR_JAWD1EN | ADC_CFGR_AWD1EN | ADC_CFGR_AWD1SGL)
                                 | (__LL_ADC_CHANNEL_TO_DECIMAL_NB(AnalogWDMonitChannels) << ADC_CFGR_AWD1CH_Pos)
                                );
      }
    }
  }

  return AnalogWDMonitChannels;
}

LL_ADC_GetAnalogWDThresholds()

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

{
  register const __IO uint32_t *preg = __ADC_PTR_REG_OFFSET(ADCx->TR1, ((AWDy & ADC_AWD_TRX_REGOFFSET_MASK) >> ADC_AWD_TRX_REGOFFSET_POS));

  return (uint32_t)(READ_BIT(*preg,
                             (AWDThresholdsHighLow | ADC_TR1_LT1))
                    >> (((AWDThresholdsHighLow & ADC_AWD_TRX_BIT_HIGH_MASK) >> ADC_AWD_TRX_BIT_HIGH_SHIFT4) & ~(AWDThresholdsHighLow & ADC_TR1_LT1))
                   );
}

LL_ADC_SetAnalogWDMonitChannels()

__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 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 5003 of file stm32l4xx_ll_adc.h.

{
  /* Set bits with content of parameter "AWDChannelGroup" with bits position  */
  /* in register and register position depending on parameter "AWDy".         */
  /* Parameters "AWDChannelGroup" and "AWDy" are used with masks because      */
  /* containing other bits reserved for other purpose.                        */
  register __IO uint32_t *preg = __ADC_PTR_REG_OFFSET(ADCx->CFGR, ((AWDy & ADC_AWD_CRX_REGOFFSET_MASK) >> ADC_AWD_CRX_REGOFFSET_POS)
                                                      + ((AWDy & ADC_AWD_CR12_REGOFFSETGAP_MASK) * ADC_AWD_CR12_REGOFFSETGAP_VAL));

  MODIFY_REG(*preg,
             (AWDy & ADC_AWD_CR_ALL_CHANNEL_MASK),
             AWDChannelGroup & AWDy);
}

LL_ADC_SetAnalogWDThresholds()

__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 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.

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

{
  /* Set bits with content of parameter "AWDThresholdValue" with bits         */
  /* position in register and register position depending on parameters       */
  /* "AWDThresholdsHighLow" and "AWDy".                                       */
  /* Parameters "AWDy" and "AWDThresholdValue" are used with masks because    */
  /* containing other bits reserved for other purpose.                        */
  register __IO uint32_t *preg = __ADC_PTR_REG_OFFSET(ADCx->TR1, ((AWDy & ADC_AWD_TRX_REGOFFSET_MASK) >> ADC_AWD_TRX_REGOFFSET_POS));

  MODIFY_REG(*preg,
             AWDThresholdsHighLow,
             AWDThresholdValue << ((AWDThresholdsHighLow & ADC_AWD_TRX_BIT_HIGH_MASK) >> ADC_AWD_TRX_BIT_HIGH_SHIFT4));
}