Configuration of ADC transversal scope: analog watchdog

Functions
__STATIC_INLINE void	DDL_ADC16_SetAnalogWDMonitChannels (ADC16_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	DDL_ADC16_GetAnalogWDMonitChannels (ADC16_TypeDef *ADCx, uint32_t AWDy)
	Get ADC analog watchdog monitored channel.
__STATIC_INLINE void	DDL_ADC16_ConfigAnalogWDThresholds (ADC16_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	DDL_ADC16_SetAnalogWDThresholds (ADC16_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	DDL_ADC16_GetAnalogWDThresholds (ADC16_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.
__STATIC_INLINE void	DDL_ADC16_SetAWDFilteringConfiguration (ADC16_TypeDef *ADCx, uint32_t AWDy, uint32_t FilteringConfig)
	Set ADC analog watchdog filtering configuration.
__STATIC_INLINE uint32_t	DDL_ADC16_GetAWDFilteringConfiguration (ADC16_TypeDef *ADCx, uint32_t AWDy)
	Get ADC analog watchdog filtering configuration.

Detailed Description

Function Documentation

DDL_ADC16_ConfigAnalogWDThresholds()

__STATIC_INLINE void DDL_ADC16_ConfigAnalogWDThresholds	(	ADC16_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 DDL_ADC16_SetAnalogWDThresholds().

• 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: (DDL_ADC16_AWD_CHANNEL4_REG_INJ | DDL_ADC16_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: DDL_ADC16_AWD_CHANNELxx_REG_INJ (do not use parameters DDL_ADC16_AWD_CHANNELxx_REG and DDL_ADC16_AWD_CHANNELxx_INJ)

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:0] (16 most significant bits).

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3
AWDThresholdHighValue	Value between Min_Data=0x0000 and Max_Data=0xFFFF
AWDThresholdLowValue	Value between Min_Data=0x0000 and Max_Data=0xFFFF

Return values

None

Definition at line 2650 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_GetAnalogWDMonitChannels()

__STATIC_INLINE uint32_t DDL_ADC16_GetAnalogWDMonitChannels	(	ADC16_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 DDL_ADC16_xxx: the returned channel number is only partly formatted on definition of literals DDL_ADC16_CHANNEL_x. Therefore, it has to be compared with parts of literals DDL_ADC16_CHANNEL_x or using helper macro __DDL_ADC16_CHANNEL_TO_DECIMAL_NB(). Then the selected literal DDL_ADC16_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 __DDL_ADC16_CHANNEL_TO_DECIMAL_NB(). Applicable only when the analog watchdog is set to monitor one channel.

• AWD standard (instance AWD1):
  • channels monitored: can monitor 1 channel or all channels.
  • groups monitored: ADC groups regular and-or injected.
• 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: (DDL_ADC16_AWD_CHANNEL4_REG_INJ | DDL_ADC16_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: DDL_ADC16_AWD_CHANNELxx_REG_INJ (do not use parameters DDL_ADC16_AWD_CHANNELxx_REG and DDL_ADC16_AWD_CHANNELxx_INJ)

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3

Return values

Returned

value can be one of the following values: DDL_ADC16_AWD_DISABLE DDL_ADC16_AWD_ALL_CHANNELS_REG DDL_ADC16_AWD_ALL_CHANNELS_INJ DDL_ADC16_AWD_ALL_CHANNELS_REG_INJ DDL_ADC16_AWD_CHANNEL_0_REG DDL_ADC16_AWD_CHANNEL_0_INJ DDL_ADC16_AWD_CHANNEL_0_REG_INJ DDL_ADC16_AWD_CHANNEL_1_REG DDL_ADC16_AWD_CHANNEL_1_INJ DDL_ADC16_AWD_CHANNEL_1_REG_INJ DDL_ADC16_AWD_CHANNEL_2_REG DDL_ADC16_AWD_CHANNEL_2_INJ DDL_ADC16_AWD_CHANNEL_2_REG_INJ DDL_ADC16_AWD_CHANNEL_3_REG DDL_ADC16_AWD_CHANNEL_3_INJ DDL_ADC16_AWD_CHANNEL_3_REG_INJ DDL_ADC16_AWD_CHANNEL_4_REG DDL_ADC16_AWD_CHANNEL_4_INJ DDL_ADC16_AWD_CHANNEL_4_REG_INJ DDL_ADC16_AWD_CHANNEL_5_REG DDL_ADC16_AWD_CHANNEL_5_INJ DDL_ADC16_AWD_CHANNEL_5_REG_INJ

Definition at line 2564 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_GetAnalogWDThresholds()

__STATIC_INLINE uint32_t DDL_ADC16_GetAnalogWDThresholds	(	ADC16_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: __DDL_ADC16_ANALOGWD_THRESHOLDS_HIGH_LOW().

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3
AWDThresholdsHighLow	This parameter can be one of the following values: DDL_ADC16_AWD_THRESHOLD_HIGH DDL_ADC16_AWD_THRESHOLD_LOW DDL_ADC16_AWD_THRESHOLDS_HIGH_LOW

Return values

Value

between Min_Data=0x0000 and Max_Data=0xFFFF

Definition at line 2734 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_GetAWDFilteringConfiguration()

__STATIC_INLINE uint32_t DDL_ADC16_GetAWDFilteringConfiguration	(	ADC16_TypeDef *	ADCx,
		uint32_t	AWDy )

Get ADC analog watchdog filtering configuration.

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1

Return values

Returned

value can be: DDL_ADC16_AWD_FILTERING_NONE DDL_ADC16_AWD_FILTERING_2SAMPLES DDL_ADC16_AWD_FILTERING_3SAMPLES DDL_ADC16_AWD_FILTERING_4SAMPLES DDL_ADC16_AWD_FILTERING_5SAMPLES DDL_ADC16_AWD_FILTERING_6SAMPLES DDL_ADC16_AWD_FILTERING_7SAMPLES DDL_ADC16_AWD_FILTERING_8SAMPLES

Definition at line 2785 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_SetAnalogWDMonitChannels()

__STATIC_INLINE void DDL_ADC16_SetAnalogWDMonitChannels	(	ADC16_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.

• AWD standard (instance AWD1):
  • channels monitored: can monitor 1 channel or all channels.
  • groups monitored: ADC groups regular and-or injected.
• 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: (DDL_ADC16_AWD_CHANNEL4_REG_INJ | DDL_ADC16_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: DDL_ADC16_AWD_CHANNELxx_REG_INJ (do not use parameters DDL_ADC16_AWD_CHANNELxx_REG and DDL_ADC16_AWD_CHANNELxx_INJ)

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3
AWDChannelGroup	This parameter can be one of the following values: DDL_ADC16_AWD_DISABLE DDL_ADC16_AWD_ALL_CHANNELS_REG DDL_ADC16_AWD_ALL_CHANNELS_INJ DDL_ADC16_AWD_ALL_CHANNELS_REG_INJ DDL_ADC16_AWD_CHANNEL_0_REG DDL_ADC16_AWD_CHANNEL_0_INJ DDL_ADC16_AWD_CHANNEL_0_REG_INJ DDL_ADC16_AWD_CHANNEL_1_REG DDL_ADC16_AWD_CHANNEL_1_INJ DDL_ADC16_AWD_CHANNEL_1_REG_INJ DDL_ADC16_AWD_CHANNEL_2_REG DDL_ADC16_AWD_CHANNEL_2_INJ DDL_ADC16_AWD_CHANNEL_2_REG_INJ DDL_ADC16_AWD_CHANNEL_3_REG DDL_ADC16_AWD_CHANNEL_3_INJ DDL_ADC16_AWD_CHANNEL_3_REG_INJ DDL_ADC16_AWD_CHANNEL_4_REG DDL_ADC16_AWD_CHANNEL_4_INJ DDL_ADC16_AWD_CHANNEL_4_REG_INJ DDL_ADC16_AWD_CHANNEL_5_REG DDL_ADC16_AWD_CHANNEL_5_INJ DDL_ADC16_AWD_CHANNEL_5_REG_INJ

Return values

None

Definition at line 2491 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_SetAnalogWDThresholds()

__STATIC_INLINE void DDL_ADC16_SetAnalogWDThresholds	(	ADC16_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 DDL_ADC16_ConfigAnalogWDThresholds().

• 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: (DDL_ADC16_AWD_CHANNEL4_REG_INJ | DDL_ADC16_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: DDL_ADC16_AWD_CHANNELxx_REG_INJ (do not use parameters DDL_ADC16_AWD_CHANNELxx_REG and DDL_ADC16_AWD_CHANNELxx_INJ)

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). ADC can be disabled, enabled with or without conversion on going on either ADC groups regular or injected.

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3
AWDThresholdsHighLow	This parameter can be one of the following values: DDL_ADC16_AWD_THRESHOLD_HIGH DDL_ADC16_AWD_THRESHOLD_LOW
AWDThresholdValue	Value between Min_Data=0x0000 and Max_Data=0xFFFF

Return values

None

Definition at line 2699 of file g32r4xx_ddl_adc16.h.

DDL_ADC16_SetAWDFilteringConfiguration()

__STATIC_INLINE void DDL_ADC16_SetAWDFilteringConfiguration	(	ADC16_TypeDef *	ADCx,
		uint32_t	AWDy,
		uint32_t	FilteringConfig )

Set ADC analog watchdog filtering configuration.

Parameters

ADCx	ADC instance
AWDy	This parameter can be one of the following values: DDL_ADC16_AWD1 DDL_ADC16_AWD2 DDL_ADC16_AWD3
FilteringConfig	This parameter can be one of the following values: DDL_ADC16_AWD_FILTERING_NONE DDL_ADC16_AWD_FILTERING_2SAMPLES DDL_ADC16_AWD_FILTERING_3SAMPLES DDL_ADC16_AWD_FILTERING_4SAMPLES DDL_ADC16_AWD_FILTERING_5SAMPLES DDL_ADC16_AWD_FILTERING_6SAMPLES DDL_ADC16_AWD_FILTERING_7SAMPLES DDL_ADC16_AWD_FILTERING_8SAMPLES

Return values

None

Definition at line 2763 of file g32r4xx_ddl_adc16.h.