ADC - Analog to Digital Converter#

ADC_AcqTime_TypeDef#

ADC_AcqTime_TypeDef

Acquisition time (in ADC clock cycles).

ADC_OvsRateSel_TypeDef#

ADC_OvsRateSel_TypeDef

Oversample rate select.

ADC_PRSSEL_TypeDef#

ADC_PRSSEL_TypeDef

Peripheral Reflex System signal used to trigger a single sample.

ADC_Ref_TypeDef#

ADC_Ref_TypeDef

ADC Reference.

ADC_Res_TypeDef#

ADC_Res_TypeDef

Sample resolution.

ADC_PosSel_TypeDef#

ADC_PosSel_TypeDef

Positive input selection for single and scan conversion.

ADC_NegSel_TypeDef#

ADC_NegSel_TypeDef

Negative input selection for single and scan conversion.

ADC_ScanInputGroup_TypeDef#

ADC_ScanInputGroup_TypeDef

ADC scan input groups.

ADC_ScanNegInput_TypeDef#

ADC_ScanNegInput_TypeDef

ADC scan alternative negative inputs.

ADC_Start_TypeDef#

ADC_Start_TypeDef

ADC start command.

ADC_Warmup_TypeDef#

ADC_Warmup_TypeDef

Warm-up mode.

ADC_EM2ClockConfig_TypeDef#

ADC_EM2ClockConfig_TypeDef

ADC EM2 clock configuration.

ADC_Init#

void ADC_Init (ADC_TypeDef *adc, const ADC_Init_TypeDef *init)

Initialize ADC.

Initializes common parts for both single conversion and scan sequence. In addition, single and/or scan control configuration must be done. See ADC_InitSingle() and ADC_InitScan() respectively. For ADC architectures with the ADCn->SCANINPUTSEL register, use ADC_ScanSingleEndedInputAdd() to configure single-ended scan inputs or ADC_ScanDifferentialInputAdd() to configure differential scan inputs. ADC_ScanInputClear() is also provided for applications that need to update the input configuration.

Note

• This function will stop any ongoing conversion.

ADC_ScanInputClear#

void ADC_ScanInputClear (ADC_InitScan_TypeDef *scanInit)

Clear ADC scan input configuration.

ADC_ScanSingleEndedInputAdd#

uint32_t ADC_ScanSingleEndedInputAdd (ADC_InitScan_TypeDef *scanInit, ADC_ScanInputGroup_TypeDef inputGroup, ADC_PosSel_TypeDef singleEndedSel)

Initialize ADC scan single-ended input configuration.

Set a configuration for ADC scan conversion with single-ended inputs. The ADC_InitScan_TypeDef structure updated from this function will be passed to ADC_InitScan().

Returns

• Scan ID of selected ADC input. See section 25.3.4 in the reference manual for more information. Note that the returned integer represents the bit position in ADCn_SCANMASK set by this function. The accumulated mask is stored in scanInit->scanInputConfig->scanInputEn.

ADC_ScanDifferentialInputAdd#

uint32_t ADC_ScanDifferentialInputAdd (ADC_InitScan_TypeDef *scanInit, ADC_ScanInputGroup_TypeDef inputGroup, ADC_PosSel_TypeDef posSel, ADC_ScanNegInput_TypeDef negInput)

Initialize the ADC scan differential input configuration.

Set a configuration for the ADC scan conversion with differential inputs. The ADC_InitScan_TypeDef structure updated by this function should be passed to ADC_InitScan().

Returns

• Scan ID of the selected ADC input. See section 25.3.4 in the reference manual for more information. Note that the returned integer represents the bit position in ADCn_SCANMASK set by this function. The accumulated mask is stored in the scanInit->scanInputConfig->scanInputEn.

ADC_InitScan#

void ADC_InitScan (ADC_TypeDef *adc, const ADC_InitScan_TypeDef *init)

Initialize the ADC scan sequence.

See ADC_Start() for starting a scan sequence.

When selecting an external reference, the gain and offset calibration must be set explicitly (CAL register). For other references, the calibration is updated with values defined during manufacturing. For ADC architectures with the ADCn->SCANINPUTSEL register, use ADC_ScanSingleEndedInputAdd() to configure single-ended scan inputs or ADC_ScanDifferentialInputAdd() to configure differential scan inputs. ADC_ScanInputClear() is also provided for applications that need to update the input configuration.

Note

• This function will stop any ongoing scan sequence.

ADC_InitSingle#

void ADC_InitSingle (ADC_TypeDef *adc, const ADC_InitSingle_TypeDef *init)

Initialize the single ADC sample conversion.

See ADC_Start() for starting a single conversion.

When selecting an external reference, the gain and offset calibration must be set explicitly (CAL register). For other references, the calibration is updated with values defined during manufacturing.

Note

• This function will stop any ongoing single conversion.

• This function will set the BIASPROG_GPBIASACC bit when selecting the internal temperature sensor and clear the bit otherwise. Any application that depends on the state of the BIASPROG_GPBIASACC bit should modify it after a call to this function.

ADC_DataIdScanGet#

uint32_t ADC_DataIdScanGet (ADC_TypeDef *adc, uint32_t *scanId)

Get a scan result and scan select ID.

Note

• Only use if scan data valid. This function does not check the DV flag. The return value is meant to be used as an index for the scan select ID.

Returns

• The first scan data in the scan FIFO.

ADC_PrescaleCalc#

uint8_t ADC_PrescaleCalc (uint32_t adcFreq, uint32_t hfperFreq)

Calculate the prescaler value used to determine the ADC clock.

The ADC clock is given by: (HFPERCLK or HFPERCCLK) / (prescale + 1).

Note

• The return value is clamped to the maximum prescaler value that the hardware supports.

Returns

• A prescaler value to use for ADC in order to achieve a clock value <= adcFreq.

ADC_Reset#

void ADC_Reset (ADC_TypeDef *adc)

Reset ADC to a state that it was in after a hardware reset.

Note

• The ROUTE register is NOT reset by this function to allow a centralized setup of this feature.

ADC_TimebaseCalc#

uint8_t ADC_TimebaseCalc (uint32_t hfperFreq)

Calculate a timebase value to get a timebase providing at least 1 us.

Returns

• A timebase value to use for ADC to achieve at least 1 us.

ADC_DataSingleGet#

uint32_t ADC_DataSingleGet (ADC_TypeDef *adc)

Get a single conversion result.

Note

• Check data valid flag before calling this function.

Returns

• Single conversion data.

ADC_DataSinglePeek#

uint32_t ADC_DataSinglePeek (ADC_TypeDef *adc)

Peek single conversion result.

Note

• Check data valid flag before calling this function.

Returns

• Single conversion data.

ADC_DataScanGet#

uint32_t ADC_DataScanGet (ADC_TypeDef *adc)

Get a scan result.

Note

• Check data valid flag before calling this function.

Returns

• Scan conversion data.

ADC_DataScanPeek#

uint32_t ADC_DataScanPeek (ADC_TypeDef *adc)

Peek scan result.

Note

• Check data valid flag before calling this function.

Returns

• Scan conversion data.

ADC_IntClear#

void ADC_IntClear (ADC_TypeDef *adc, uint32_t flags)

Clear one or more pending ADC interrupts.

ADC_IntDisable#

void ADC_IntDisable (ADC_TypeDef *adc, uint32_t flags)

Disable one or more ADC interrupts.

ADC_IntEnable#

void ADC_IntEnable (ADC_TypeDef *adc, uint32_t flags)

Enable one or more ADC interrupts.

Note

• Depending on use, a pending interrupt may already be set prior to enabling the interrupt. Consider using ADC_IntClear() prior to enabling if the pending interrupt should be ignored.

ADC_IntGet#

uint32_t ADC_IntGet (ADC_TypeDef *adc)

Get pending ADC interrupt flags.

Note

• This function does not clear event bits.

Returns

• ADC interrupt sources pending. A bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

ADC_IntGetEnabled#

uint32_t ADC_IntGetEnabled (ADC_TypeDef *adc)

Get enabled and pending ADC interrupt flags.

Useful for handling more interrupt sources in the same interrupt handler.

Note

• This function does not clear interrupt flags.

Returns

• Pending and enabled ADC interrupt sources. The return value is the bitwise AND combination of

  • the OR combination of enabled interrupt sources in ADCx_IEN_nnn register (ADCx_IEN_nnn) and

  • the OR combination of valid interrupt flags of the ADC module (ADCx_IF_nnn).

ADC_IntSet#

void ADC_IntSet (ADC_TypeDef *adc, uint32_t flags)

Set one or more pending ADC interrupts from software.

ADC_Start#

void ADC_Start (ADC_TypeDef *adc, ADC_Start_TypeDef cmd)

Start scan sequence and/or single conversion.

ADC_CTRLX_VREFSEL_REG#

#define ADC_CTRLX_VREFSEL_REG

0x80UL

Single and scan mode voltage references.

Using unshifted enumerations and or in ADC_CTRLX_VREFSEL_REG to select the extension register CTRLX_VREFSEL.

ADC_SCANINPUTSEL_GROUP_NONE#

#define ADC_SCANINPUTSEL_GROUP_NONE

0xFFU

Define none selected group for ADC_SCANINPUTSEL.

ADC_SCANINPUTSEL_NONE#

#define ADC_SCANINPUTSEL_NONE

Define none selected for ADC_SCANINPUTSEL.

ADC_INIT_DEFAULT#

#define ADC_INIT_DEFAULT

Default configuration for ADC initialization structure.

ADC_INITSCAN_DEFAULT#

#define ADC_INITSCAN_DEFAULT

Default configuration for ADC scan initialization structure.

ADC_INITSINGLE_DEFAULT#

#define ADC_INITSINGLE_DEFAULT

Default configuration for ADC single conversion initialization structure.