ADCEMLIB

Detailed Description

Analog to Digital Converter (ADC) Peripheral API.

This module contains functions to control the ADC peripheral of Silicon Labs 32-bit MCUs and SoCs. The ADC is used to convert analog signals into a digital representation.

Data Structures

struct  ADC_Init_TypeDef
 
struct  ADC_InitScan_TypeDef
 
struct  ADC_InitScanInput_TypeDef
 
struct  ADC_InitSingle_TypeDef
 

Macros

#define ADC_INIT_DEFAULT
 
#define ADC_INITSCAN_DEFAULT
 
#define ADC_INITSINGLE_DEFAULT
 

Enumerations

enum  ADC_AcqTime_TypeDef {
  adcAcqTime1 = _ADC_SINGLECTRL_AT_1CYCLE,
  adcAcqTime2 = _ADC_SINGLECTRL_AT_2CYCLES,
  adcAcqTime4 = _ADC_SINGLECTRL_AT_4CYCLES,
  adcAcqTime8 = _ADC_SINGLECTRL_AT_8CYCLES,
  adcAcqTime16 = _ADC_SINGLECTRL_AT_16CYCLES,
  adcAcqTime32 = _ADC_SINGLECTRL_AT_32CYCLES,
  adcAcqTime64 = _ADC_SINGLECTRL_AT_64CYCLES,
  adcAcqTime128 = _ADC_SINGLECTRL_AT_128CYCLES,
  adcAcqTime256 = _ADC_SINGLECTRL_AT_256CYCLES
}
 
enum  ADC_LPFilter_TypeDef {
  adcLPFilterBypass = _ADC_CTRL_LPFMODE_BYPASS,
  adcLPFilterRC = _ADC_CTRL_LPFMODE_RCFILT,
  adcLPFilterDeCap = _ADC_CTRL_LPFMODE_DECAP
}
 
enum  ADC_OvsRateSel_TypeDef {
  adcOvsRateSel2 = _ADC_CTRL_OVSRSEL_X2,
  adcOvsRateSel4 = _ADC_CTRL_OVSRSEL_X4,
  adcOvsRateSel8 = _ADC_CTRL_OVSRSEL_X8,
  adcOvsRateSel16 = _ADC_CTRL_OVSRSEL_X16,
  adcOvsRateSel32 = _ADC_CTRL_OVSRSEL_X32,
  adcOvsRateSel64 = _ADC_CTRL_OVSRSEL_X64,
  adcOvsRateSel128 = _ADC_CTRL_OVSRSEL_X128,
  adcOvsRateSel256 = _ADC_CTRL_OVSRSEL_X256,
  adcOvsRateSel512 = _ADC_CTRL_OVSRSEL_X512,
  adcOvsRateSel1024 = _ADC_CTRL_OVSRSEL_X1024,
  adcOvsRateSel2048 = _ADC_CTRL_OVSRSEL_X2048,
  adcOvsRateSel4096 = _ADC_CTRL_OVSRSEL_X4096
}
 
enum  ADC_PRSSEL_TypeDef {
  adcPRSSELCh0 = _ADC_SINGLECTRL_PRSSEL_PRSCH0,
  adcPRSSELCh1 = _ADC_SINGLECTRL_PRSSEL_PRSCH1,
  adcPRSSELCh2 = _ADC_SINGLECTRL_PRSSEL_PRSCH2,
  adcPRSSELCh3 = _ADC_SINGLECTRL_PRSSEL_PRSCH3,
  adcPRSSELCh4 = _ADC_SINGLECTRL_PRSSEL_PRSCH4,
  adcPRSSELCh5 = _ADC_SINGLECTRL_PRSSEL_PRSCH5,
  adcPRSSELCh6 = _ADC_SINGLECTRL_PRSSEL_PRSCH6,
  adcPRSSELCh7 = _ADC_SINGLECTRL_PRSSEL_PRSCH7,
  adcPRSSELCh8 = _ADC_SINGLECTRL_PRSSEL_PRSCH8,
  adcPRSSELCh9 = _ADC_SINGLECTRL_PRSSEL_PRSCH9,
  adcPRSSELCh10 = _ADC_SINGLECTRL_PRSSEL_PRSCH10,
  adcPRSSELCh11 = _ADC_SINGLECTRL_PRSSEL_PRSCH11
}
 
enum  ADC_Ref_TypeDef {
  adcRef1V25 = _ADC_SINGLECTRL_REF_1V25,
  adcRef2V5 = _ADC_SINGLECTRL_REF_2V5,
  adcRefVDD = _ADC_SINGLECTRL_REF_VDD,
  adcRef5VDIFF = _ADC_SINGLECTRL_REF_5VDIFF,
  adcRefExtSingle = _ADC_SINGLECTRL_REF_EXTSINGLE,
  adcRef2xExtDiff = _ADC_SINGLECTRL_REF_2XEXTDIFF,
  adcRef2xVDD = _ADC_SINGLECTRL_REF_2XVDD
}
 
enum  ADC_Res_TypeDef {
  adcRes12Bit = _ADC_SINGLECTRL_RES_12BIT,
  adcRes8Bit = _ADC_SINGLECTRL_RES_8BIT,
  adcRes6Bit = _ADC_SINGLECTRL_RES_6BIT,
  adcResOVS = _ADC_SINGLECTRL_RES_OVS
}
 
enum  ADC_SingleInput_TypeDef {
  adcSingleInputCh0 = _ADC_SINGLECTRL_INPUTSEL_CH0,
  adcSingleInputCh1 = _ADC_SINGLECTRL_INPUTSEL_CH1,
  adcSingleInputCh2 = _ADC_SINGLECTRL_INPUTSEL_CH2,
  adcSingleInputCh3 = _ADC_SINGLECTRL_INPUTSEL_CH3,
  adcSingleInputCh4 = _ADC_SINGLECTRL_INPUTSEL_CH4,
  adcSingleInputCh5 = _ADC_SINGLECTRL_INPUTSEL_CH5,
  adcSingleInputCh6 = _ADC_SINGLECTRL_INPUTSEL_CH6,
  adcSingleInputCh7 = _ADC_SINGLECTRL_INPUTSEL_CH7,
  adcSingleInputTemp = _ADC_SINGLECTRL_INPUTSEL_TEMP,
  adcSingleInputVDDDiv3 = _ADC_SINGLECTRL_INPUTSEL_VDDDIV3,
  adcSingleInputVDD = _ADC_SINGLECTRL_INPUTSEL_VDD,
  adcSingleInputVSS = _ADC_SINGLECTRL_INPUTSEL_VSS,
  adcSingleInputVrefDiv2 = _ADC_SINGLECTRL_INPUTSEL_VREFDIV2,
  adcSingleInputDACOut0 = _ADC_SINGLECTRL_INPUTSEL_DAC0OUT0,
  adcSingleInputDACOut1 = _ADC_SINGLECTRL_INPUTSEL_DAC0OUT1,
  adcSingleInputATEST = 15,
  adcSingleInputCh0Ch1 = _ADC_SINGLECTRL_INPUTSEL_CH0CH1,
  adcSingleInputCh2Ch3 = _ADC_SINGLECTRL_INPUTSEL_CH2CH3,
  adcSingleInputCh4Ch5 = _ADC_SINGLECTRL_INPUTSEL_CH4CH5,
  adcSingleInputCh6Ch7 = _ADC_SINGLECTRL_INPUTSEL_CH6CH7,
  adcSingleInputDiff0 = 4
}
 
enum  ADC_Start_TypeDef {
  adcStartSingle = ADC_CMD_SINGLESTART,
  adcStartScan = ADC_CMD_SCANSTART,
  adcStartScanAndSingle = ADC_CMD_SCANSTART | ADC_CMD_SINGLESTART
}
 
enum  ADC_Warmup_TypeDef {
  adcWarmupNormal = _ADC_CTRL_WARMUPMODE_NORMAL,
  adcWarmupFastBG = _ADC_CTRL_WARMUPMODE_FASTBG,
  adcWarmupKeepScanRefWarm = _ADC_CTRL_WARMUPMODE_KEEPSCANREFWARM,
  adcWarmupKeepADCWarm = _ADC_CTRL_WARMUPMODE_KEEPADCWARM
}
 

Functions

__STATIC_INLINE uint32_t ADC_DataScanGet (ADC_TypeDef *adc)
 Get scan result.
 
__STATIC_INLINE uint32_t ADC_DataScanPeek (ADC_TypeDef *adc)
 Peek scan result.
 
__STATIC_INLINE uint32_t ADC_DataSingleGet (ADC_TypeDef *adc)
 Get single conversion result.
 
__STATIC_INLINE uint32_t ADC_DataSinglePeek (ADC_TypeDef *adc)
 Peek single conversion result.
 
void ADC_Init (ADC_TypeDef *adc, const ADC_Init_TypeDef *init)
 Initialize ADC.
 
void ADC_InitScan (ADC_TypeDef *adc, const ADC_InitScan_TypeDef *init)
 Initialize ADC scan sequence.
 
void ADC_InitSingle (ADC_TypeDef *adc, const ADC_InitSingle_TypeDef *init)
 Initialize single ADC sample conversion.
 
__STATIC_INLINE void ADC_IntClear (ADC_TypeDef *adc, uint32_t flags)
 Clear one or more pending ADC interrupts.
 
__STATIC_INLINE void ADC_IntDisable (ADC_TypeDef *adc, uint32_t flags)
 Disable one or more ADC interrupts.
 
__STATIC_INLINE void ADC_IntEnable (ADC_TypeDef *adc, uint32_t flags)
 Enable one or more ADC interrupts.
 
__STATIC_INLINE uint32_t ADC_IntGet (ADC_TypeDef *adc)
 Get pending ADC interrupt flags.
 
__STATIC_INLINE 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.
 
__STATIC_INLINE void ADC_IntSet (ADC_TypeDef *adc, uint32_t flags)
 Set one or more pending ADC interrupts from SW.
 
uint8_t ADC_PrescaleCalc (uint32_t adcFreq, uint32_t hfperFreq)
 Calculate prescaler value used to determine ADC clock.
 
void ADC_Reset (ADC_TypeDef *adc)
 Reset ADC to same state as after a HW reset.
 
__STATIC_INLINE void ADC_Start (ADC_TypeDef *adc, ADC_Start_TypeDef cmd)
 Start scan sequence and/or single conversion.
 
uint8_t ADC_TimebaseCalc (uint32_t hfperFreq)
 Calculate timebase value in order to get a timebase providing at least 1us.
 

Macro Definition Documentation

#define ADC_INIT_DEFAULT
Value:
{ \
adcOvsRateSel2, /* 2x oversampling (if enabled). */ \
adcLPFilterBypass, /* No input filter selected. */ \
adcWarmupNormal, /* ADC shutdown after each conversion. */ \
_ADC_CTRL_TIMEBASE_DEFAULT, /* Use HW default value. */ \
_ADC_CTRL_PRESC_DEFAULT, /* Use HW default value. */ \
false /* Do not use tailgate. */ \
}

Default config for ADC init structure.

Definition at line 819 of file em_adc.h.

Referenced by adcInit(), MIC_init(), and TOUCH_Init().

#define ADC_INITSCAN_DEFAULT
Value:
{ \
adcPRSSELCh0, /* PRS ch0 (if enabled). */ \
adcAcqTime1, /* 1 ADC_CLK cycle acquisition time. */ \
adcRef1V25, /* 1.25V internal reference. */ \
adcRes12Bit, /* 12 bit resolution. */ \
0, /* No input selected. */ \
false, /* Single-ended input. */ \
false, /* PRS disabled. */ \
false, /* Right adjust. */ \
false, /* Deactivate conversion after one scan sequence. */ \
}

Default config for ADC scan init structure.

Definition at line 925 of file em_adc.h.

Referenced by MIC_init().

#define ADC_INITSINGLE_DEFAULT
Value:
{ \
adcPRSSELCh0, /* PRS ch0 (if enabled). */ \
adcAcqTime1, /* 1 ADC_CLK cycle acquisition time. */ \
adcRef1V25, /* 1.25V internal reference. */ \
adcRes12Bit, /* 12 bit resolution. */ \
adcSingleInpCh0, /* CH0 input selected. */ \
false, /* Single ended input. */ \
false, /* PRS disabled. */ \
false, /* Right adjust. */ \
false /* Deactivate conversion after one scan sequence. */ \
}

Default config for ADC single conversion init structure.

Definition at line 1026 of file em_adc.h.

Referenced by adcInit().

Enumeration Type Documentation

Acquisition time (in ADC clock cycles).

Enumerator
adcAcqTime1 

1 clock cycle.

adcAcqTime2 

2 clock cycles.

adcAcqTime4 

4 clock cycles.

adcAcqTime8 

8 clock cycles.

adcAcqTime16 

16 clock cycles.

adcAcqTime32 

32 clock cycles.

adcAcqTime64 

64 clock cycles.

adcAcqTime128 

128 clock cycles.

adcAcqTime256 

256 clock cycles.

Definition at line 60 of file em_adc.h.

Lowpass filter mode.

Enumerator
adcLPFilterBypass 

No filter or decoupling capacitor.

adcLPFilterRC 

On-chip RC filter.

adcLPFilterDeCap 

On-chip decoupling capacitor.

Definition at line 74 of file em_adc.h.

Oversample rate select.

Enumerator
adcOvsRateSel2 

2 samples per conversion result.

adcOvsRateSel4 

4 samples per conversion result.

adcOvsRateSel8 

8 samples per conversion result.

adcOvsRateSel16 

16 samples per conversion result.

adcOvsRateSel32 

32 samples per conversion result.

adcOvsRateSel64 

64 samples per conversion result.

adcOvsRateSel128 

128 samples per conversion result.

adcOvsRateSel256 

256 samples per conversion result.

adcOvsRateSel512 

512 samples per conversion result.

adcOvsRateSel1024 

1024 samples per conversion result.

adcOvsRateSel2048 

2048 samples per conversion result.

adcOvsRateSel4096 

4096 samples per conversion result.

Definition at line 87 of file em_adc.h.

Peripheral Reflex System signal used to trigger single sample.

Enumerator
adcPRSSELCh0 

PRS channel 0.

adcPRSSELCh1 

PRS channel 1.

adcPRSSELCh2 

PRS channel 2.

adcPRSSELCh3 

PRS channel 3.

adcPRSSELCh4 

PRS channel 4.

adcPRSSELCh5 

PRS channel 5.

adcPRSSELCh6 

PRS channel 6.

adcPRSSELCh7 

PRS channel 7.

adcPRSSELCh8 

PRS channel 8.

adcPRSSELCh9 

PRS channel 9.

adcPRSSELCh10 

PRS channel 10.

adcPRSSELCh11 

PRS channel 11.

Definition at line 126 of file em_adc.h.

Single and scan mode voltage references. Using unshifted enums and or in ADC_CTRLX_VREFSEL_REG to select the extension register CTRLX_VREFSEL.

Enumerator
adcRef1V25 

Internal 1.25V reference.

adcRef2V5 

Internal 2.5V reference.

adcRefVDD 

Buffered VDD.

adcRef5VDIFF 

Internal differential 5V reference.

adcRefExtSingle 

Single ended external reference from pin 6.

adcRef2xExtDiff 

Differential external reference from pin 6 and 7.

adcRef2xVDD 

Unbuffered 2xVDD.

Definition at line 191 of file em_adc.h.

Sample resolution.

Enumerator
adcRes12Bit 

12 bit sampling.

adcRes8Bit 

8 bit sampling.

adcRes6Bit 

6 bit sampling.

adcResOVS 

Oversampling.

Definition at line 267 of file em_adc.h.

Single sample input selection.

Enumerator
adcSingleInputCh0 

Channel 0.

adcSingleInputCh1 

Channel 1.

adcSingleInputCh2 

Channel 2.

adcSingleInputCh3 

Channel 3.

adcSingleInputCh4 

Channel 4.

adcSingleInputCh5 

Channel 5.

adcSingleInputCh6 

Channel 6.

adcSingleInputCh7 

Channel 7.

adcSingleInputTemp 

Temperature reference.

adcSingleInputVDDDiv3 

VDD divided by 3.

adcSingleInputVDD 

VDD.

adcSingleInputVSS 

VSS.

adcSingleInputVrefDiv2 

Vref divided by 2.

adcSingleInputDACOut0 

DAC output 0.

adcSingleInputDACOut1 

DAC output 1.

adcSingleInputATEST 

ATEST.

adcSingleInputCh0Ch1 

Positive Ch0, negative Ch1.

adcSingleInputCh2Ch3 

Positive Ch2, negative Ch3.

adcSingleInputCh4Ch5 

Positive Ch4, negative Ch5.

adcSingleInputCh6Ch7 

Positive Ch6, negative Ch7.

adcSingleInputDiff0 

Differential 0.

Definition at line 276 of file em_adc.h.

ADC Start command.

Enumerator
adcStartSingle 

Start single conversion.

adcStartScan 

Start scan sequence.

adcStartScanAndSingle 

Start scan sequence and single conversion, typically used when tailgating single conversion after scan sequence.

Definition at line 721 of file em_adc.h.

Warm-up mode.

Enumerator
adcWarmupNormal 

ADC shutdown after each conversion.

adcWarmupFastBG 

Do not warm-up bandgap references.

adcWarmupKeepScanRefWarm 

Reference selected for scan mode kept warm.

adcWarmupKeepADCWarm 

ADC and reference selected for scan mode kept warmup, allowing continuous conversion.

Definition at line 736 of file em_adc.h.

Function Documentation

__STATIC_INLINE uint32_t ADC_DataScanGet ( ADC_TypeDef adc)

Get scan result.

Note
Check data valid flag before calling this function.
Parameters
[in]adcPointer to ADC peripheral register block.
Returns
Scan conversion data.

Definition at line 1109 of file em_adc.h.

References ADC_TypeDef::SCANDATA.

__STATIC_INLINE uint32_t ADC_DataScanPeek ( ADC_TypeDef adc)

Peek scan result.

Note
Check data valid flag before calling this function.
Parameters
[in]adcPointer to ADC peripheral register block.
Returns
Scan conversion data.

Definition at line 1127 of file em_adc.h.

References ADC_TypeDef::SCANDATAP.

__STATIC_INLINE uint32_t ADC_DataSingleGet ( ADC_TypeDef adc)

Get single conversion result.

Note
Check data valid flag before calling this function.
Parameters
[in]adcPointer to ADC peripheral register block.
Returns
Single conversion data.

Definition at line 1073 of file em_adc.h.

References ADC_TypeDef::SINGLEDATA.

Referenced by ADC0_IRQHandler(), and getAdcSample().

__STATIC_INLINE uint32_t ADC_DataSinglePeek ( ADC_TypeDef adc)

Peek single conversion result.

Note
Check data valid flag before calling this function.
Parameters
[in]adcPointer to ADC peripheral register block.
Returns
Single conversion data.

Definition at line 1091 of file em_adc.h.

References ADC_TypeDef::SINGLEDATAP.

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, please refer to 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.
Parameters
[in]adcPointer to ADC peripheral register block.
[in]initPointer to ADC initialization structure.

Definition at line 384 of file em_adc.c.

References _ADC_CTRL_LPFMODE_MASK, _ADC_CTRL_LPFMODE_SHIFT, _ADC_CTRL_OVSRSEL_SHIFT, _ADC_CTRL_PRESC_MASK, _ADC_CTRL_PRESC_SHIFT, _ADC_CTRL_TIMEBASE_MASK, _ADC_CTRL_TIMEBASE_SHIFT, _ADC_CTRL_WARMUPMODE_SHIFT, ADC0, ADC_CMD_SCANSTOP, ADC_CMD_SINGLESTOP, ADC_CTRL_TAILGATE, ADC_IntClear(), ADC_PrescaleCalc(), BUS_RegMaskedWrite(), ADC_TypeDef::CMD, ADC_TypeDef::CTRL, ADC_Init_TypeDef::lpfMode, ADC_Init_TypeDef::ovsRateSel, ADC_Init_TypeDef::prescale, ADC_Init_TypeDef::tailgate, ADC_Init_TypeDef::timebase, and ADC_Init_TypeDef::warmUpMode.

Referenced by adcInit(), MIC_init(), and TOUCH_Init().

void ADC_InitScan ( ADC_TypeDef adc,
const ADC_InitScan_TypeDef init 
)

Initialize ADC scan sequence.

Please refer to ADC_Start() for starting 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.
Parameters
[in]adcPointer to ADC peripheral register block.
[in]initPointer to ADC initialization structure.

Definition at line 689 of file em_adc.c.

References _ADC_SCANCTRL_AT_SHIFT, _ADC_SCANCTRL_PRSSEL_SHIFT, _ADC_SCANCTRL_REF_SHIFT, _ADC_SCANCTRL_RES_SHIFT, ADC_InitScan_TypeDef::acqTime, ADC_CMD_SCANSTOP, ADC_SCANCTRL_ADJ_LEFT, ADC_SCANCTRL_DIFF, ADC_SCANCTRL_PRSEN, ADC_SCANCTRL_REP, BUS_RegBitWrite(), ADC_TypeDef::CMD, ADC_TypeDef::CTRL, ADC_InitScan_TypeDef::diff, ADC_InitScan_TypeDef::input, ADC_InitScan_TypeDef::leftAdjust, ADC_InitScan_TypeDef::prsEnable, ADC_InitScan_TypeDef::prsSel, ADC_InitScan_TypeDef::reference, ADC_InitScan_TypeDef::rep, ADC_InitScan_TypeDef::resolution, ADC_TypeDef::SCANCTRL, and ADC_TypeDef::STATUS.

Referenced by MIC_init().

void ADC_InitSingle ( ADC_TypeDef adc,
const ADC_InitSingle_TypeDef init 
)

Initialize single ADC sample conversion.

Please refer to ADC_Start() for starting 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.
Parameters
[in]adcPointer to ADC peripheral register block.
[in]initPointer to ADC initialization structure.

Definition at line 826 of file em_adc.c.

References _ADC_SINGLECTRL_AT_MASK, _ADC_SINGLECTRL_AT_SHIFT, _ADC_SINGLECTRL_INPUTSEL_SHIFT, _ADC_SINGLECTRL_PRSSEL_SHIFT, _ADC_SINGLECTRL_REF_SHIFT, _ADC_SINGLECTRL_RES_SHIFT, ADC_InitSingle_TypeDef::acqTime, ADC_CMD_SINGLESTOP, ADC_SINGLECTRL_ADJ_LEFT, ADC_SINGLECTRL_DIFF, ADC_SINGLECTRL_PRSEN, ADC_SINGLECTRL_REP, adcAcqTime8, adcRef1V25, ADC_TypeDef::BIASPROG, BUS_RegBitWrite(), ADC_TypeDef::CMD, ADC_TypeDef::CTRL, ADC_InitSingle_TypeDef::diff, ADC_InitSingle_TypeDef::input, ADC_InitSingle_TypeDef::leftAdjust, ADC_InitSingle_TypeDef::prsEnable, ADC_InitSingle_TypeDef::prsSel, ADC_InitSingle_TypeDef::reference, ADC_InitSingle_TypeDef::rep, ADC_InitSingle_TypeDef::resolution, ADC_TypeDef::SINGLECTRL, and ADC_TypeDef::STATUS.

Referenced by ADC0_IRQHandler(), adcInit(), and TOUCH_Init().

__STATIC_INLINE void ADC_IntClear ( ADC_TypeDef adc,
uint32_t  flags 
)

Clear one or more pending ADC interrupts.

Parameters
[in]adcPointer to ADC peripheral register block.
[in]flagsPending ADC interrupt source to clear. Use a bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

Definition at line 1166 of file em_adc.h.

References ADC_TypeDef::IFC.

Referenced by ADC0_IRQHandler(), ADC_Init(), and TOUCH_Init().

__STATIC_INLINE void ADC_IntDisable ( ADC_TypeDef adc,
uint32_t  flags 
)

Disable one or more ADC interrupts.

Parameters
[in]adcPointer to ADC peripheral register block.
[in]flagsADC interrupt sources to disable. Use a bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

Definition at line 1182 of file em_adc.h.

References ADC_TypeDef::IEN.

Referenced by TOUCH_GetPos(), and TOUCH_Init().

__STATIC_INLINE void ADC_IntEnable ( ADC_TypeDef adc,
uint32_t  flags 
)

Enable one or more ADC interrupts.

Note
Depending on the use, a pending interrupt may already be set prior to enabling the interrupt. Consider using ADC_IntClear() prior to enabling if such a pending interrupt should be ignored.
Parameters
[in]adcPointer to ADC peripheral register block.
[in]flagsADC interrupt sources to enable. Use a bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

Definition at line 1203 of file em_adc.h.

References ADC_TypeDef::IEN.

Referenced by TOUCH_GetPos(), and TOUCH_Init().

__STATIC_INLINE uint32_t ADC_IntGet ( ADC_TypeDef adc)

Get pending ADC interrupt flags.

Note
The event bits are not cleared by the use of this function.
Parameters
[in]adcPointer to ADC peripheral register block.
Returns
ADC interrupt sources pending. A bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

Definition at line 1222 of file em_adc.h.

References ADC_TypeDef::IF.

Referenced by getAdcSample().

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

Parameters
[in]adcPointer to ADC peripheral register block.
Note
Interrupt flags are not cleared by the use of this function.
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).

Definition at line 1246 of file em_adc.h.

References ADC_TypeDef::IEN, and ADC_TypeDef::IF.

__STATIC_INLINE void ADC_IntSet ( ADC_TypeDef adc,
uint32_t  flags 
)

Set one or more pending ADC interrupts from SW.

Parameters
[in]adcPointer to ADC peripheral register block.
[in]flagsADC interrupt sources to set to pending. Use a bitwise logic OR combination of valid interrupt flags for the ADC module (ADC_IF_nnn).

Definition at line 1269 of file em_adc.h.

References ADC_TypeDef::IFS.

uint8_t ADC_PrescaleCalc ( uint32_t  adcFreq,
uint32_t  hfperFreq 
)

Calculate prescaler value used to determine ADC clock.

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

Note
The return value is clamped to the max prescaler value hardware supports.
Parameters
[in]adcFreqADC frequency wanted. The frequency will automatically be adjusted to be within valid range according to reference manual.
[in]hfperFreqFrequency in Hz of reference HFPER clock. Set to 0 to use currently defined HFPER clock setting.
Returns
Prescaler value to use for ADC in order to achieve a clock value <= adcFreq.

Definition at line 988 of file em_adc.c.

References _ADC_CTRL_PRESC_MASK, _ADC_CTRL_PRESC_SHIFT, CMU_ClockFreqGet(), and cmuClock_HFPER.

Referenced by ADC_Init(), adcInit(), MIC_init(), and TOUCH_Init().

void ADC_Reset ( ADC_TypeDef adc)

Reset ADC to same state as after a HW reset.

Note
The ROUTE register is NOT reset by this function, in order to allow for centralized setup of this feature.
Parameters
[in]adcPointer to ADC peripheral register block.

Definition at line 1029 of file em_adc.c.

References _ADC_BIASPROG_RESETVALUE, _ADC_CTRL_RESETVALUE, _ADC_IEN_RESETVALUE, _ADC_IFC_MASK, _ADC_SCANCTRL_RESETVALUE, _ADC_SINGLECTRL_RESETVALUE, ADC_CMD_SCANSTOP, ADC_CMD_SINGLESTOP, adcRef1V25, ADC_TypeDef::BIASPROG, ADC_TypeDef::CMD, ADC_TypeDef::CTRL, ADC_TypeDef::IEN, ADC_TypeDef::IFC, ADC_TypeDef::SCANCTRL, and ADC_TypeDef::SINGLECTRL.

__STATIC_INLINE void ADC_Start ( ADC_TypeDef adc,
ADC_Start_TypeDef  cmd 
)

Start scan sequence and/or single conversion.

Parameters
[in]adcPointer to ADC peripheral register block.
[in]cmdCommand indicating which type of sampling to start.

Definition at line 1284 of file em_adc.h.

References ADC_TypeDef::CMD.

Referenced by ADC0_IRQHandler(), getAdcSample(), and TOUCH_Init().

uint8_t ADC_TimebaseCalc ( uint32_t  hfperFreq)

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

Parameters
[in]hfperFreqFrequency in Hz of reference HFPER clock. Set to 0 to use currently defined HFPER clock setting.
Returns
Timebase value to use for ADC in order to achieve at least 1 us.

Definition at line 1080 of file em_adc.c.

References CMU_ClockFreqGet(), and cmuClock_HFPER.

Referenced by adcInit(), and MIC_init().