ADC helper macro

Defines
#define	__LL_ADC_CHANNEL_TO_DECIMAL_NB(__CHANNEL__)   (((__CHANNEL__) & ADC_CHANNEL_ID_NUMBER_MASK) >> ADC_CHANNEL_ID_NUMBER_BITOFFSET_POS)
	Helper macro to get ADC channel number in decimal format from literals LL_ADC_CHANNEL_x.
#define	__LL_ADC_DECIMAL_NB_TO_CHANNEL(__DECIMAL_NB__)
	Helper macro to get ADC channel in literal format LL_ADC_CHANNEL_x from number in decimal format.
#define	__LL_ADC_IS_CHANNEL_INTERNAL(__CHANNEL__)   (((__CHANNEL__) & ADC_CHANNEL_ID_INTERNAL_CH_MASK) != 0U)
	Helper macro to determine whether the selected channel corresponds to literal definitions of driver.
#define	__LL_ADC_CHANNEL_INTERNAL_TO_EXTERNAL(__CHANNEL__)   ((__CHANNEL__) & ~ADC_CHANNEL_ID_INTERNAL_CH_MASK)
	Helper macro to convert a channel defined from parameter definition of a ADC internal channel (LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...), to its equivalent parameter definition of a ADC external channel (LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...).
#define	__LL_ADC_IS_CHANNEL_INTERNAL_AVAILABLE(__ADC_INSTANCE__, __CHANNEL__)
	Helper macro to determine whether the internal channel selected is available on the ADC instance selected.
#define	__LL_ADC_ANALOGWD_CHANNEL_GROUP(__CHANNEL__, __GROUP__)
	Helper macro to define ADC analog watchdog parameter: define a single channel to monitor with analog watchdog from sequencer channel and groups definition.
#define	__LL_ADC_ANALOGWD_SET_THRESHOLD_RESOLUTION(__ADC_RESOLUTION__, __AWD_THRESHOLD__)   ((__AWD_THRESHOLD__) << (0U))
	Helper macro to set the value of ADC analog watchdog threshold high or low in function of ADC resolution, when ADC resolution is different of 12 bits.
#define	__LL_ADC_ANALOGWD_GET_THRESHOLD_RESOLUTION(__ADC_RESOLUTION__, __AWD_THRESHOLD_12_BITS__)   (__AWD_THRESHOLD_12_BITS__)
	Helper macro to get the value of ADC analog watchdog threshold high or low in function of ADC resolution, when ADC resolution is different of 12 bits.
#define	__LL_ADC_MULTI_CONV_DATA_MASTER_SLAVE(__ADC_MULTI_MASTER_SLAVE__, __ADC_MULTI_CONV_DATA__)   (((__ADC_MULTI_CONV_DATA__) >> POSITION_VAL((__ADC_MULTI_MASTER_SLAVE__))) & ADC_DR_DATA)
	Helper macro to get the ADC multimode conversion data of ADC master or ADC slave from raw value with both ADC conversion data concatenated.
#define	__LL_ADC_COMMON_INSTANCE(__ADCx__)   (ADC12_COMMON)
	Helper macro to select the ADC common instance to which is belonging the selected ADC instance.
#define	__LL_ADC_IS_ENABLED_ALL_COMMON_INSTANCE(__ADCXY_COMMON__)
	Helper macro to check if all ADC instances sharing the same ADC common instance are disabled.
#define	__LL_ADC_DIGITAL_SCALE(__ADC_RESOLUTION__)   (0xFFFU)
	Helper macro to define the ADC conversion data full-scale digital value corresponding to the selected ADC resolution.
#define	__LL_ADC_CALC_DATA_TO_VOLTAGE(__VREFANALOG_VOLTAGE__, __ADC_DATA__, __ADC_RESOLUTION__)
	Helper macro to calculate the voltage (unit: mVolt) corresponding to a ADC conversion data (unit: digital value).
#define	__LL_ADC_CALC_TEMPERATURE_TYP_PARAMS(__TEMPSENSOR_TYP_AVGSLOPE__, __TEMPSENSOR_TYP_CALX_V__, __TEMPSENSOR_CALX_TEMP__, __VREFANALOG_VOLTAGE__, __TEMPSENSOR_ADC_DATA__, __ADC_RESOLUTION__)
	Helper macro to calculate the temperature (unit: degree Celsius) from ADC conversion data of internal temperature sensor.

---

Define Documentation

#define __LL_ADC_ANALOGWD_CHANNEL_GROUP	(		__CHANNEL__,
			__GROUP__
	)

Value:

(((__GROUP__) == LL_ADC_GROUP_REGULAR)                                                                  \
    ? (((__CHANNEL__) & ADC_CHANNEL_ID_MASK) | ADC_CR1_AWDEN | ADC_CR1_AWDSGL)                            \
      :                                                                                                   \
      ((__GROUP__) == LL_ADC_GROUP_INJECTED)                                                              \
       ? (((__CHANNEL__) & ADC_CHANNEL_ID_MASK) | ADC_CR1_JAWDEN | ADC_CR1_AWDSGL)                        \
         :                                                                                                \
         (((__CHANNEL__) & ADC_CHANNEL_ID_MASK) | ADC_CR1_JAWDEN | ADC_CR1_AWDEN | ADC_CR1_AWDSGL)        \
  )

Helper macro to define ADC analog watchdog parameter: define a single channel to monitor with analog watchdog from sequencer channel and groups definition.

Note:

To be used with function LL_ADC_SetAnalogWDMonitChannels(). Example: LL_ADC_SetAnalogWDMonitChannels( ADC1, LL_ADC_AWD1, __LL_ADC_ANALOGWD_CHANNEL_GROUP(LL_ADC_CHANNEL4, LL_ADC_GROUP_REGULAR))

Parameters:

__CHANNEL__

This parameter can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1. (1) For ADC channel read back from ADC register, comparison with internal channel parameter to be done using helper macro __LL_ADC_CHANNEL_INTERNAL_TO_EXTERNAL().

__GROUP__

This parameter can be one of the following values: LL_ADC_GROUP_REGULAR LL_ADC_GROUP_INJECTED LL_ADC_GROUP_REGULAR_INJECTED

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_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) LL_ADC_AWD_CH_TEMPSENSOR_INJ (1) LL_ADC_AWD_CH_TEMPSENSOR_REG_INJ (1) (1) On STM32F1, parameter available only on ADC instance: ADC1.

Definition at line 1297 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_ANALOGWD_GET_THRESHOLD_RESOLUTION	(		__ADC_RESOLUTION__,
			__AWD_THRESHOLD_12_BITS__
	)		(__AWD_THRESHOLD_12_BITS__)

Helper macro to get the value of ADC analog watchdog threshold high or low in function of ADC resolution, when ADC resolution is different of 12 bits.

Note:

To be used with function LL_ADC_GetAnalogWDThresholds(). Example, with a ADC resolution of 8 bits, to get the value of analog watchdog threshold high (on 8 bits): < threshold_value_6_bits > = __LL_ADC_ANALOGWD_GET_THRESHOLD_RESOLUTION (LL_ADC_RESOLUTION_8B, LL_ADC_GetAnalogWDThresholds(<ADCx param>, LL_ADC_AWD_THRESHOLD_HIGH) );

Parameters:

__ADC_RESOLUTION__	This parameter can be one of the following values: LL_ADC_RESOLUTION_12B
__AWD_THRESHOLD_12_BITS__	Value between Min_Data=0x000 and Max_Data=0xFFF

Return values:

Value

between Min_Data=0x000 and Max_Data=0xFFF

Definition at line 1348 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_ANALOGWD_SET_THRESHOLD_RESOLUTION	(		__ADC_RESOLUTION__,
			__AWD_THRESHOLD__
	)		((__AWD_THRESHOLD__) << (0U))

Helper macro to set the value of ADC analog watchdog threshold high or low in function of ADC resolution, when ADC resolution is different of 12 bits.

Note:

To be used with function LL_ADC_SetAnalogWDThresholds(). Example, with a ADC resolution of 8 bits, to set the value of analog watchdog threshold high (on 8 bits): LL_ADC_SetAnalogWDThresholds (< ADCx param >, __LL_ADC_ANALOGWD_SET_THRESHOLD_RESOLUTION(LL_ADC_RESOLUTION_8B, <threshold_value_8_bits>) );

Parameters:

__ADC_RESOLUTION__	This parameter can be one of the following values: LL_ADC_RESOLUTION_12B
__AWD_THRESHOLD__	Value between Min_Data=0x000 and Max_Data=0xFFF

Return values:

Value

between Min_Data=0x000 and Max_Data=0xFFF

Definition at line 1326 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_CALC_DATA_TO_VOLTAGE	(		__VREFANALOG_VOLTAGE__,
			__ADC_DATA__,
			__ADC_RESOLUTION__
	)

Value:

((__ADC_DATA__) * (__VREFANALOG_VOLTAGE__)                                   \
   / __LL_ADC_DIGITAL_SCALE(__ADC_RESOLUTION__)                                \
  )

Helper macro to calculate the voltage (unit: mVolt) corresponding to a ADC conversion data (unit: digital value).

Note:

Analog reference voltage (Vref+) must be known from user board environment or can be calculated using ADC measurement.

Parameters:

__VREFANALOG_VOLTAGE__	Analog reference voltage (unit: mV)
__ADC_DATA__	ADC conversion data (resolution 12 bits) (unit: digital value).
__ADC_RESOLUTION__	This parameter can be one of the following values: LL_ADC_RESOLUTION_12B

Return values:

ADC	conversion data equivalent voltage value (unit: mVolt)

Definition at line 1478 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_CALC_TEMPERATURE_TYP_PARAMS	(		__TEMPSENSOR_TYP_AVGSLOPE__,
			__TEMPSENSOR_TYP_CALX_V__,
			__TEMPSENSOR_CALX_TEMP__,
			__VREFANALOG_VOLTAGE__,
			__TEMPSENSOR_ADC_DATA__,
			__ADC_RESOLUTION__
	)

Value:

((( (                                                                        \
       (int32_t)(((__TEMPSENSOR_TYP_CALX_V__))                                 \
                 * 1000)                                                       \
       -                                                                       \
       (int32_t)((((__TEMPSENSOR_ADC_DATA__) * (__VREFANALOG_VOLTAGE__))       \
                  / __LL_ADC_DIGITAL_SCALE(__ADC_RESOLUTION__))                \
                 * 1000)                                                       \
      )                                                                        \
    ) / (__TEMPSENSOR_TYP_AVGSLOPE__)                                          \
   ) + (__TEMPSENSOR_CALX_TEMP__)                                              \
  )

Helper macro to calculate the temperature (unit: degree Celsius) from ADC conversion data of internal temperature sensor.

Note:

Computation is using temperature sensor typical values (refer to device datasheet).

Calculation formula: Temperature = (TS_TYP_CALx_VOLT(uV) - TS_ADC_DATA * Conversion_uV) / Avg_Slope + CALx_TEMP with TS_ADC_DATA = temperature sensor raw data measured by ADC (unit: digital value) Avg_Slope = temperature sensor slope (unit: uV/Degree Celsius) TS_TYP_CALx_VOLT = temperature sensor digital value at temperature CALx_TEMP (unit: mV) Caution: Calculation relevancy under reserve the temperature sensor of the current device has characteristics in line with datasheet typical values. If temperature sensor calibration values are available on on this device (presence of macro __LL_ADC_CALC_TEMPERATURE()), temperature calculation will be more accurate using helper macro __LL_ADC_CALC_TEMPERATURE().

As calculation input, the analog reference voltage (Vref+) must be defined as it impacts the ADC LSB equivalent voltage.

Analog reference voltage (Vref+) must be known from user board environment or can be calculated using ADC measurement.

ADC measurement data must correspond to a resolution of 12bits (full scale digital value 4095). If not the case, the data must be preliminarily rescaled to an equivalent resolution of 12 bits.

Parameters:

__TEMPSENSOR_TYP_AVGSLOPE__	Device datasheet data: Temperature sensor slope typical value (unit: uV/DegCelsius). On STM32F1, refer to device datasheet parameter "Avg_Slope".
__TEMPSENSOR_TYP_CALX_V__	Device datasheet data: Temperature sensor voltage typical value (at temperature and Vref+ defined in parameters below) (unit: mV). On STM32F1, refer to device datasheet parameter "V25".
__TEMPSENSOR_CALX_TEMP__	Device datasheet data: Temperature at which temperature sensor voltage (see parameter above) is corresponding (unit: mV)
__VREFANALOG_VOLTAGE__	Analog voltage reference (Vref+) voltage (unit: mV)
__TEMPSENSOR_ADC_DATA__	ADC conversion data of internal temperature sensor (unit: digital value).
__ADC_RESOLUTION__	ADC resolution at which internal temperature sensor voltage has been measured. This parameter can be one of the following values: LL_ADC_RESOLUTION_12B

Return values:

Temperature

(unit: degree Celsius)

Definition at line 1526 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_CHANNEL_INTERNAL_TO_EXTERNAL

(

__CHANNEL__

)

((__CHANNEL__) & ~ADC_CHANNEL_ID_INTERNAL_CH_MASK)

Helper macro to convert a channel defined from parameter definition of a ADC internal channel (LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...), to its equivalent parameter definition of a ADC external channel (LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...).

Note:

The channel parameter can be, additionally to a value defined from parameter definition of a ADC internal channel (LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...), a value defined from parameter definition of ADC external channel (LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...) or a value from functions where a channel number is returned from ADC registers.

Parameters:

__CHANNEL__

This parameter can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1.

Return values:

Returned

value can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17

Definition at line 1155 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_CHANNEL_TO_DECIMAL_NB

(

__CHANNEL__

)

(((__CHANNEL__) & ADC_CHANNEL_ID_NUMBER_MASK) >> ADC_CHANNEL_ID_NUMBER_BITOFFSET_POS)

Helper macro to get ADC channel number in decimal format from literals LL_ADC_CHANNEL_x.

Note:

Example: __LL_ADC_CHANNEL_TO_DECIMAL_NB(LL_ADC_CHANNEL_4) will return decimal number "4".

The input can be a value from functions where a channel number is returned, either defined with number or with bitfield (only one bit must be set).

Parameters:

__CHANNEL__

This parameter can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1.

Return values:

Value

between Min_Data=0 and Max_Data=18

Definition at line 1003 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_COMMON_INSTANCE

(

__ADCx__

)

(ADC12_COMMON)

Helper macro to select the ADC common instance to which is belonging the selected ADC instance.

Note:

ADC common register instance can be used for:

• Set parameters common to several ADC instances
• Multimode (for devices with several ADC instances) Refer to functions having argument "ADCxy_COMMON" as parameter.

On STM32F1, there is no common ADC instance. However, ADC instance ADC1 has a role of common ADC instance for ADC1 and ADC2: this instance is used to manage internal channels and multimode (these features are managed in ADC common instances on some other STM32 devices). ADC instance ADC3 (if available on the selected device) has no ADC common instance.

Parameters:

__ADCx__

ADC instance

Return values:

ADC	common register instance

Definition at line 1399 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_DECIMAL_NB_TO_CHANNEL

(

__DECIMAL_NB__

)

Value:

(((__DECIMAL_NB__) <= 9U)                                                                                     \
    ? (                                                                                                         \
       ((__DECIMAL_NB__) << ADC_CHANNEL_ID_NUMBER_BITOFFSET_POS)                                       |        \
       (ADC_SMPR2_REGOFFSET | (((uint32_t) (3U * (__DECIMAL_NB__))) << ADC_CHANNEL_SMPx_BITOFFSET_POS))         \
      )                                                                                                         \
      :                                                                                                         \
      (                                                                                                         \
       ((__DECIMAL_NB__) << ADC_CHANNEL_ID_NUMBER_BITOFFSET_POS)                                              | \
       (ADC_SMPR1_REGOFFSET | (((uint32_t) (3U * ((__DECIMAL_NB__) - 10U))) << ADC_CHANNEL_SMPx_BITOFFSET_POS)) \
      )                                                                                                         \
  )

Helper macro to get ADC channel in literal format LL_ADC_CHANNEL_x from number in decimal format.

Note:

Example: __LL_ADC_DECIMAL_NB_TO_CHANNEL(4) will return a data equivalent to "LL_ADC_CHANNEL_4".

Parameters:

__DECIMAL_NB__,:

Value between Min_Data=0 and Max_Data=18

Return values:

Returned

value can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1. (1) For ADC channel read back from ADC register, comparison with internal channel parameter to be done using helper macro __LL_ADC_CHANNEL_INTERNAL_TO_EXTERNAL().

Definition at line 1040 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_DIGITAL_SCALE

(

__ADC_RESOLUTION__

)

(0xFFFU)

Helper macro to define the ADC conversion data full-scale digital value corresponding to the selected ADC resolution.

Note:

ADC conversion data full-scale corresponds to voltage range determined by analog voltage references Vref+ and Vref- (refer to reference manual).

Parameters:

__ADC_RESOLUTION__

This parameter can be one of the following values: LL_ADC_RESOLUTION_12B

Return values:

ADC	conversion data equivalent voltage value (unit: mVolt)

Definition at line 1462 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_IS_CHANNEL_INTERNAL

(

__CHANNEL__

)

(((__CHANNEL__) & ADC_CHANNEL_ID_INTERNAL_CH_MASK) != 0U)

Helper macro to determine whether the selected channel corresponds to literal definitions of driver.

Note:

The different literal definitions of ADC channels are:

• ADC internal channel: LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...
• ADC external channel (channel connected to a GPIO pin): LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...

The channel parameter must be a value defined from literal definition of a ADC internal channel (LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...), ADC external channel (LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...), must not be a value from functions where a channel number is returned from ADC registers, because internal and external channels share the same channel number in ADC registers. The differentiation is made only with parameters definitions of driver.

Parameters:

__CHANNEL__

This parameter can be one of the following values: LL_ADC_CHANNEL_0 LL_ADC_CHANNEL_1 LL_ADC_CHANNEL_2 LL_ADC_CHANNEL_3 LL_ADC_CHANNEL_4 LL_ADC_CHANNEL_5 LL_ADC_CHANNEL_6 LL_ADC_CHANNEL_7 LL_ADC_CHANNEL_8 LL_ADC_CHANNEL_9 LL_ADC_CHANNEL_10 LL_ADC_CHANNEL_11 LL_ADC_CHANNEL_12 LL_ADC_CHANNEL_13 LL_ADC_CHANNEL_14 LL_ADC_CHANNEL_15 LL_ADC_CHANNEL_16 LL_ADC_CHANNEL_17 LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1.

Return values:

Value

"0" if the channel corresponds to a parameter definition of a ADC external channel (channel connected to a GPIO pin). Value "1" if the channel corresponds to a parameter definition of a ADC internal channel.

Definition at line 1096 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_IS_CHANNEL_INTERNAL_AVAILABLE	(		__ADC_INSTANCE__,
			__CHANNEL__
	)

Value:

(((__ADC_INSTANCE__) == ADC1)                                                \
    ? (                                                                        \
       ((__CHANNEL__) == LL_ADC_CHANNEL_VREFINT)    ||                         \
       ((__CHANNEL__) == LL_ADC_CHANNEL_TEMPSENSOR)                            \
      )                                                                        \
      :                                                                        \
      (0U)                                                                     \
  )

Helper macro to determine whether the internal channel selected is available on the ADC instance selected.

Note:

The channel parameter must be a value defined from parameter definition of a ADC internal channel (LL_ADC_CHANNEL_VREFINT, LL_ADC_CHANNEL_TEMPSENSOR, ...), must not be a value defined from parameter definition of ADC external channel (LL_ADC_CHANNEL_1, LL_ADC_CHANNEL_2, ...) or a value from functions where a channel number is returned from ADC registers, because internal and external channels share the same channel number in ADC registers. The differentiation is made only with parameters definitions of driver.

Parameters:

__ADC_INSTANCE__	ADC instance
__CHANNEL__	This parameter can be one of the following values: LL_ADC_CHANNEL_VREFINT (1) LL_ADC_CHANNEL_TEMPSENSOR (1) (1) On STM32F1, parameter available only on ADC instance: ADC1.

Return values:

Value

"0" if the internal channel selected is not available on the ADC instance selected. Value "1" if the internal channel selected is available on the ADC instance selected.

Definition at line 1180 of file stm32f1xx_ll_adc.h.

#define __LL_ADC_IS_ENABLED_ALL_COMMON_INSTANCE

(

__ADCXY_COMMON__

)

Value:

(LL_ADC_IsEnabled(ADC1) |                                                    \
   LL_ADC_IsEnabled(ADC2)  )

Helper macro to check if all ADC instances sharing the same ADC common instance are disabled.

Note:

This check is required by functions with setting conditioned to ADC state: All ADC instances of the ADC common group must be disabled. Refer to functions having argument "ADCxy_COMMON" as parameter.

On devices with only 1 ADC common instance, parameter of this macro is useless and can be ignored (parameter kept for compatibility with devices featuring several ADC common instances).

On STM32F1, there is no common ADC instance. However, ADC instance ADC1 has a role of common ADC instance for ADC1 and ADC2: this instance is used to manage internal channels and multimode (these features are managed in ADC common instances on some other STM32 devices). ADC instance ADC3 (if available on the selected device) has no ADC common instance.

Parameters:

__ADCXY_COMMON__

ADC common instance (can be set directly from CMSIS definition or by using helper macro __LL_ADC_COMMON_INSTANCE() )

Return values:

Value

"0" if all ADC instances sharing the same ADC common instance are disabled. Value "1" if at least one ADC instance sharing the same ADC common instance is enabled.

Definition at line 1444 of file stm32f1xx_ll_adc.h.

Referenced by LL_ADC_CommonInit().

#define __LL_ADC_MULTI_CONV_DATA_MASTER_SLAVE	(		__ADC_MULTI_MASTER_SLAVE__,
			__ADC_MULTI_CONV_DATA__
	)		(((__ADC_MULTI_CONV_DATA__) >> POSITION_VAL((__ADC_MULTI_MASTER_SLAVE__))) & ADC_DR_DATA)

Helper macro to get the ADC multimode conversion data of ADC master or ADC slave from raw value with both ADC conversion data concatenated.

Note:

This macro is intended to be used when multimode transfer by DMA is enabled. In this case the transferred data need to processed with this macro to separate the conversion data of ADC master and ADC slave.

Parameters:

__ADC_MULTI_MASTER_SLAVE__	This parameter can be one of the following values: LL_ADC_MULTI_MASTER LL_ADC_MULTI_SLAVE
__ADC_MULTI_CONV_DATA__	Value between Min_Data=0x000 and Max_Data=0xFFF

Return values:

Value

between Min_Data=0x000 and Max_Data=0xFFF

Definition at line 1365 of file stm32f1xx_ll_adc.h.