EFM32 Wonder Gecko Software Documentation  efm32wg-doc-5.1.2
Data Structures | Macros | Enumerations | Functions
ADC
EMLIB

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

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. */ \
}
adcOvsRateSel2
Definition: em_adc.h:92
_ADC_CTRL_PRESC_DEFAULT
#define _ADC_CTRL_PRESC_DEFAULT
Definition: efm32wg_adc.h:99
_ADC_CTRL_TIMEBASE_DEFAULT
#define _ADC_CTRL_TIMEBASE_DEFAULT
Definition: efm32wg_adc.h:105
adcLPFilterBypass
Definition: em_adc.h:78
adcWarmupNormal
Definition: em_adc.h:749

Default config for ADC init structure.

Definition at line 836 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. */ \
}
adcRes12Bit
Definition: em_adc.h:269
adcRef1V25
Definition: em_adc.h:192
adcAcqTime1
Definition: em_adc.h:62
adcPRSSELCh0
Definition: em_adc.h:133

Default config for ADC scan init structure.

Definition at line 946 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. */ \
}
adcRes12Bit
Definition: em_adc.h:269
adcRef1V25
Definition: em_adc.h:192
adcAcqTime1
Definition: em_adc.h:62
adcPRSSELCh0
Definition: em_adc.h:133

Default config for ADC single conversion init structure.

Definition at line 1049 of file em_adc.h.

Referenced by adcInit().

Enumeration Type Documentation

enum ADC_AcqTime_TypeDef

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.

enum ADC_LPFilter_TypeDef

Lowpass filter mode.

Enumerator
adcLPFilterBypass 

No filter or decoupling capacitor.

adcLPFilterRC 

On-chip RC filter.

adcLPFilterDeCap 

On-chip decoupling capacitor.

Definition at line 75 of file em_adc.h.

enum ADC_OvsRateSel_TypeDef

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 89 of file em_adc.h.

enum ADC_PRSSEL_TypeDef

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 130 of file em_adc.h.

enum ADC_Ref_TypeDef

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 189 of file em_adc.h.

enum ADC_Res_TypeDef

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.

enum ADC_SingleInput_TypeDef

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 278 of file em_adc.h.

enum ADC_Start_TypeDef

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 729 of file em_adc.h.

enum ADC_Warmup_TypeDef

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 746 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 1134 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 1153 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 1096 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 1115 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 371 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 710 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 854 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 1194 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 1211 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 1233 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 1253 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 1278 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 1302 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).

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 1025 of file em_adc.c.

References 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 1066 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 1318 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 1118 of file em_adc.c.

References CMU_ClockFreqGet(), and cmuClock_HFPER.

Referenced by adcInit(), and MIC_init().