CSEN - Capacitive Sense#

Capacitive Sense (CSEN) Peripheral API.

Provides functions to control the capacitive sense peripheral of Silicon Labs' 32-bit MCUs and SoCs. The CSEN includes a capacitance-to-digital circuit that measures capacitance on selected inputs. Measurements are performed using either a Successive Approximation Register (SAR) or a Delta Modulator (DM) analog to digital converter.

The CSEN can be configured to measure capacitance on a single port pin or to automatically measure multiple port pins in succession using scan mode. Also, several port pins can be shorted together to measure the combined capacitance.

The CSEN includes an accumulator, which can be configured to average multiple conversions on the selected input. Additionally, an Exponential Moving Average (EMA) calculator is included to provide data smoothing. A comparator is also included and can be used to terminate a continuous conversion when the configured threshold condition is met.

The following example shows how to initialize and start a single conversion on one input:

/* CSEN is a HFPERCLK peripheral. */
CMU_ClockEnable(cmuClock_HFPER, true);
CMU_ClockEnable(cmuClock_CSEN_HF, true);

/* Initialize with default settings. */
CSEN_Init_TypeDef csenInit = CSEN_INIT_DEFAULT;
CSEN_Init(CSEN, &csenInit);

/* Select the input pin and initialize the conversion mode. */
CSEN_InitMode_TypeDef csenInitMode = CSEN_INITMODE_DEFAULT;
csenInitMode.singleSel = csenSingleSelAPORT1XCH0;
CSEN_InitMode(CSEN, &csenInitMode);

/* Enable CSEN and manually start the conversion. */
CSEN_Enable(CSEN);
CSEN_Start(CSEN);

Modules#

CSEN_Init_TypeDef

CSEN_InitMode_TypeDef

Enumerations#

enum
CSEN_CmpMode_TypeDef {
csenCmpModeDisabled = 0
csenCmpModeGreater = CSEN_CTRL_CMPEN | CSEN_CTRL_CMPPOL_GT
csenCmpModeLessOrEqual = CSEN_CTRL_CMPEN | CSEN_CTRL_CMPPOL_LTE
csenCmpModeEMAWindow = CSEN_CTRL_EMACMPEN
}

Comparator Mode.

enum
CSEN_ConvSel_TypeDef {
csenConvSelSAR = CSEN_CTRL_CONVSEL_SAR
csenConvSelSARChop = CSEN_CTRL_CONVSEL_SAR | CSEN_CTRL_CHOPEN_ENABLE
csenConvSelDM = CSEN_CTRL_CONVSEL_DM
csenConvSelDMChop = CSEN_CTRL_CONVSEL_DM | CSEN_CTRL_CHOPEN_ENABLE
}

Converter Select.

enum
CSEN_SampleMode_TypeDef {
csenSampleModeBonded = CSEN_CTRL_CM_SGL | CSEN_CTRL_MCEN_ENABLE
csenSampleModeSingle = CSEN_CTRL_CM_SGL
csenSampleModeScan = CSEN_CTRL_CM_SCAN
csenSampleModeContBonded = CSEN_CTRL_CM_CONTSGL | CSEN_CTRL_MCEN_ENABLE
csenSampleModeContSingle = CSEN_CTRL_CM_CONTSGL
csenSampleModeContScan = CSEN_CTRL_CM_CONTSCAN
}

Sample Mode.

enum
CSEN_TrigSel_TypeDef {
csenTrigSelPRS = _CSEN_CTRL_STM_PRS
csenTrigSelTimer = _CSEN_CTRL_STM_TIMER
csenTrigSelStart = _CSEN_CTRL_STM_START
}

Starts Trigger Select.

enum
CSEN_AccMode_TypeDef {
csenAccMode1 = _CSEN_CTRL_ACU_ACC1
csenAccMode2 = _CSEN_CTRL_ACU_ACC2
csenAccMode4 = _CSEN_CTRL_ACU_ACC4
csenAccMode8 = _CSEN_CTRL_ACU_ACC8
csenAccMode16 = _CSEN_CTRL_ACU_ACC16
csenAccMode32 = _CSEN_CTRL_ACU_ACC32
csenAccMode64 = _CSEN_CTRL_ACU_ACC64
}

Accumulator Mode Select.

enum
CSEN_SARRes_TypeDef {
csenSARRes10 = _CSEN_CTRL_SARCR_CLK10
csenSARRes12 = _CSEN_CTRL_SARCR_CLK12
csenSARRes14 = _CSEN_CTRL_SARCR_CLK14
csenSARRes16 = _CSEN_CTRL_SARCR_CLK16
}

Successive Approximation (SAR) Conversion Resolution.

enum
CSEN_DMRes_TypeDef {
csenDMRes10 = _CSEN_DMCFG_CRMODE_DM10
csenDMRes12 = _CSEN_DMCFG_CRMODE_DM12
csenDMRes14 = _CSEN_DMCFG_CRMODE_DM14
csenDMRes16 = _CSEN_DMCFG_CRMODE_DM16
}

Delta Modulator (DM) Conversion Resolution.

enum
CSEN_PCPrescale_TypeDef {
csenPCPrescaleDiv1 = _CSEN_TIMCTRL_PCPRESC_DIV1
csenPCPrescaleDiv2 = _CSEN_TIMCTRL_PCPRESC_DIV2
csenPCPrescaleDiv4 = _CSEN_TIMCTRL_PCPRESC_DIV4
csenPCPrescaleDiv8 = _CSEN_TIMCTRL_PCPRESC_DIV8
csenPCPrescaleDiv16 = _CSEN_TIMCTRL_PCPRESC_DIV16
csenPCPrescaleDiv32 = _CSEN_TIMCTRL_PCPRESC_DIV32
csenPCPrescaleDiv64 = _CSEN_TIMCTRL_PCPRESC_DIV64
csenPCPrescaleDiv128 = _CSEN_TIMCTRL_PCPRESC_DIV128
}

Period counter clock pre-scaler.

enum
CSEN_EMASample_TypeDef {
csenEMASampleW1 = _CSEN_EMACTRL_EMASAMPLE_W1
csenEMASampleW2 = _CSEN_EMACTRL_EMASAMPLE_W2
csenEMASampleW4 = _CSEN_EMACTRL_EMASAMPLE_W4
csenEMASampleW8 = _CSEN_EMACTRL_EMASAMPLE_W8
csenEMASampleW16 = _CSEN_EMACTRL_EMASAMPLE_W16
csenEMASampleW32 = _CSEN_EMACTRL_EMASAMPLE_W32
csenEMASampleW64 = _CSEN_EMACTRL_EMASAMPLE_W64
}

Exponential Moving Average sample weight.

enum
CSEN_ResetPhaseSel_TypeDef {
csenResetPhaseSel0 = 0
csenResetPhaseSel1 = 1
csenResetPhaseSel2 = 2
csenResetPhaseSel3 = 3
csenResetPhaseSel4 = 4
csenResetPhaseSel5 = 5
csenResetPhaseSel6 = 6
csenResetPhaseSel7 = 7
}

Reset Phase Timing Select (units are microseconds).

enum
CSEN_DriveSel_TypeDef {
csenDriveSelFull = 0
csenDriveSel1 = 1
csenDriveSel2 = 2
csenDriveSel3 = 3
csenDriveSel4 = 4
csenDriveSel5 = 5
csenDriveSel6 = 6
csenDriveSel7 = 7
}

Drive Strength Select.

enum
CSEN_GainSel_TypeDef {
csenGainSel1X = 0
csenGainSel2X = 1
csenGainSel3X = 2
csenGainSel4X = 3
csenGainSel5X = 4
csenGainSel6X = 5
csenGainSel7X = 6
csenGainSel8X = 7
}

Gain Select.

enum
CSEN_PRSSel_TypeDef {
csenPRSSELCh0 = _CSEN_PRSSEL_PRSSEL_PRSCH0
csenPRSSELCh1 = _CSEN_PRSSEL_PRSSEL_PRSCH1
csenPRSSELCh2 = _CSEN_PRSSEL_PRSSEL_PRSCH2
csenPRSSELCh3 = _CSEN_PRSSEL_PRSSEL_PRSCH3
csenPRSSELCh4 = _CSEN_PRSSEL_PRSSEL_PRSCH4
csenPRSSELCh5 = _CSEN_PRSSEL_PRSSEL_PRSCH5
csenPRSSELCh6 = _CSEN_PRSSEL_PRSSEL_PRSCH6
csenPRSSELCh7 = _CSEN_PRSSEL_PRSSEL_PRSCH7
csenPRSSELCh8 = _CSEN_PRSSEL_PRSSEL_PRSCH8
csenPRSSELCh9 = _CSEN_PRSSEL_PRSSEL_PRSCH9
csenPRSSELCh10 = _CSEN_PRSSEL_PRSSEL_PRSCH10
csenPRSSELCh11 = _CSEN_PRSSEL_PRSSEL_PRSCH11
}

Peripheral Reflex System signal used to trigger conversion.

enum
CSEN_InputSel_TypeDef {
csenInputSelDefault = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_DEFAULT
csenInputSelAPORT1CH0TO7 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT1CH0TO7
csenInputSelAPORT1CH8TO15 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT1CH8TO15
csenInputSelAPORT1CH16TO23 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT1CH16TO23
csenInputSelAPORT1CH24TO31 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT1CH24TO31
csenInputSelAPORT3CH0TO7 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT3CH0TO7
csenInputSelAPORT3CH8TO15 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT3CH8TO15
csenInputSelAPORT3CH16TO23 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT3CH16TO23
csenInputSelAPORT3CH24TO31 = _CSEN_SCANINPUTSEL0_INPUT0TO7SEL_APORT3CH24TO31
}

APORT channel to CSEN input selection.

enum
CSEN_SingleSel_TypeDef {
csenSingleSelDefault = _CSEN_SINGLECTRL_SINGLESEL_DEFAULT
csenSingleSelAPORT1XCH0 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH0
csenSingleSelAPORT1YCH1 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH1
csenSingleSelAPORT1XCH2 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH2
csenSingleSelAPORT1YCH3 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH3
csenSingleSelAPORT1XCH4 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH4
csenSingleSelAPORT1YCH5 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH5
csenSingleSelAPORT1XCH6 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH6
csenSingleSelAPORT1YCH7 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH7
csenSingleSelAPORT1XCH8 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH8
csenSingleSelAPORT1YCH9 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH9
csenSingleSelAPORT1XCH10 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH10
csenSingleSelAPORT1YCH11 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH11
csenSingleSelAPORT1XCH12 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH12
csenSingleSelAPORT1YCH13 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH13
csenSingleSelAPORT1XCH14 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH14
csenSingleSelAPORT1YCH15 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH15
csenSingleSelAPORT1XCH16 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH16
csenSingleSelAPORT1YCH17 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH17
csenSingleSelAPORT1XCH18 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH18
csenSingleSelAPORT1YCH19 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH19
csenSingleSelAPORT1XCH20 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH20
csenSingleSelAPORT1YCH21 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH21
csenSingleSelAPORT1XCH22 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH22
csenSingleSelAPORT1YCH23 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH23
csenSingleSelAPORT1XCH24 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH24
csenSingleSelAPORT1YCH25 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH25
csenSingleSelAPORT1XCH26 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH26
csenSingleSelAPORT1YCH27 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH27
csenSingleSelAPORT1XCH28 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH28
csenSingleSelAPORT1YCH29 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH29
csenSingleSelAPORT1XCH30 = _CSEN_SINGLECTRL_SINGLESEL_APORT1XCH30
csenSingleSelAPORT1YCH31 = _CSEN_SINGLECTRL_SINGLESEL_APORT1YCH31
csenSingleSelAPORT3XCH0 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH0
csenSingleSelAPORT3YCH1 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH1
csenSingleSelAPORT3XCH2 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH2
csenSingleSelAPORT3YCH3 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH3
csenSingleSelAPORT3XCH4 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH4
csenSingleSelAPORT3YCH5 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH5
csenSingleSelAPORT3XCH6 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH6
csenSingleSelAPORT3YCH7 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH7
csenSingleSelAPORT3XCH8 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH8
csenSingleSelAPORT3YCH9 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH9
csenSingleSelAPORT3XCH10 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH10
csenSingleSelAPORT3YCH11 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH11
csenSingleSelAPORT3XCH12 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH12
csenSingleSelAPORT3YCH13 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH13
csenSingleSelAPORT3XCH14 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH14
csenSingleSelAPORT3YCH15 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH15
csenSingleSelAPORT3XCH16 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH16
csenSingleSelAPORT3YCH17 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH17
csenSingleSelAPORT3XCH18 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH18
csenSingleSelAPORT3YCH19 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH19
csenSingleSelAPORT3XCH20 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH20
csenSingleSelAPORT3YCH21 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH21
csenSingleSelAPORT3XCH22 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH22
csenSingleSelAPORT3YCH23 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH23
csenSingleSelAPORT3XCH24 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH24
csenSingleSelAPORT3YCH25 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH25
csenSingleSelAPORT3XCH26 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH26
csenSingleSelAPORT3YCH27 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH27
csenSingleSelAPORT3XCH28 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH28
csenSingleSelAPORT3YCH29 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH29
csenSingleSelAPORT3XCH30 = _CSEN_SINGLECTRL_SINGLESEL_APORT3XCH30
csenSingleSelAPORT3YCH31 = _CSEN_SINGLECTRL_SINGLESEL_APORT3YCH31
}

APORT channel to CSEN single input selection.

Functions#

void
CSEN_DMBaselineSet(CSEN_TypeDef *csen, uint32_t up, uint32_t down)

Set the DM integrator initial value.

void
CSEN_Init(CSEN_TypeDef *csen, const CSEN_Init_TypeDef *init)

Initialize CSEN.

void
CSEN_InitMode(CSEN_TypeDef *csen, const CSEN_InitMode_TypeDef *init)

Initialize a CSEN measurement mode.

void
CSEN_Reset(CSEN_TypeDef *csen)

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

uint32_t
CSEN_DataGet(CSEN_TypeDef *csen)

Get the last conversion result.

uint32_t
CSEN_EMAGet(CSEN_TypeDef *csen)

Get the last exponential moving average.

void
CSEN_EMASet(CSEN_TypeDef *csen, uint32_t ema)

Set the exponential moving average initial value.

void
CSEN_Disable(CSEN_TypeDef *csen)

Disable CSEN.

void
CSEN_Enable(CSEN_TypeDef *csen)

Enable CSEN.

void
CSEN_IntClear(CSEN_TypeDef *csen, uint32_t flags)

Clear one or more pending CSEN interrupts.

void
CSEN_IntDisable(CSEN_TypeDef *csen, uint32_t flags)

Disable one or more CSEN interrupts.

void
CSEN_IntEnable(CSEN_TypeDef *csen, uint32_t flags)

Enable one or more CSEN interrupts.

uint32_t
CSEN_IntGet(CSEN_TypeDef *csen)

Get pending CSEN interrupt flags.

uint32_t
CSEN_IntGetEnabled(CSEN_TypeDef *csen)

Get enabled and pending CSEN interrupt flags.

void
CSEN_IntSet(CSEN_TypeDef *csen, uint32_t flags)

Set one or more pending CSEN interrupts from SW.

bool
CSEN_IsBusy(CSEN_TypeDef *csen)

Return CSEN conversion busy status.

void
CSEN_Start(CSEN_TypeDef *csen)

Start a scan sequence and/or a single conversion.

Macros#

#define
CSEN_INIT_DEFAULT undefined

CSEN default initialization.

#define
CSEN_INITMODE_DEFAULT undefined

CSEN default mode initialization.

Enumeration Documentation#

CSEN_CmpMode_TypeDef#

CSEN_CmpMode_TypeDef

Comparator Mode.

Selects the operation of the digital comparator.

Enumerator
csenCmpModeDisabled

Comparator is disabled.

csenCmpModeGreater

Comparator trips when the result is greater than the threshold.

csenCmpModeLessOrEqual

Comparator trips when the result is less than or equal to the threshold.

csenCmpModeEMAWindow

Comparator trips when the EMA is within the threshold window.


Definition at line 79 of file platform/emlib/inc/em_csen.h

CSEN_ConvSel_TypeDef#

CSEN_ConvSel_TypeDef

Converter Select.

Determines the converter operational mode.

Enumerator
csenConvSelSAR

Successive Approximation (SAR) converter.

csenConvSelSARChop

Successive Approximation (SAR) converter with low frequency attenuation.

csenConvSelDM

Delta Modulation (DM) converter.

csenConvSelDMChop

Delta Modulation (DM) converter with low frequency attenuation.


Definition at line 94 of file platform/emlib/inc/em_csen.h

CSEN_SampleMode_TypeDef#

CSEN_SampleMode_TypeDef

Sample Mode.

Determines how inputs are sampled for a conversion.

Enumerator
csenSampleModeBonded

Converts multiple inputs shorted together and stop.

csenSampleModeSingle

Converts one input and stop.

csenSampleModeScan

Converts multiple inputs one at a time and stop.

csenSampleModeContBonded

Continuously converts multiple inputs shorted together.

csenSampleModeContSingle

Continuously converts one input.

csenSampleModeContScan

Continuously converts multiple inputs one at a time.


Definition at line 109 of file platform/emlib/inc/em_csen.h

CSEN_TrigSel_TypeDef#

CSEN_TrigSel_TypeDef

Starts Trigger Select.

Enumerator
csenTrigSelPRS

PRS system.

csenTrigSelTimer

CSEN PC timer.

csenTrigSelStart

Start bit.


Definition at line 130 of file platform/emlib/inc/em_csen.h

CSEN_AccMode_TypeDef#

CSEN_AccMode_TypeDef

Accumulator Mode Select.

Enumerator
csenAccMode1

Accumulate 1 sample.

csenAccMode2

Accumulate 2 samples.

csenAccMode4

Accumulate 4 samples.

csenAccMode8

Accumulate 8 samples.

csenAccMode16

Accumulate 16 samples.

csenAccMode32

Accumulate 32 samples.

csenAccMode64

Accumulate 64 samples.


Definition at line 137 of file platform/emlib/inc/em_csen.h

CSEN_SARRes_TypeDef#

CSEN_SARRes_TypeDef

Successive Approximation (SAR) Conversion Resolution.

Enumerator
csenSARRes10

10-bit resolution.

csenSARRes12

12-bit resolution.

csenSARRes14

14-bit resolution.

csenSARRes16

16-bit resolution.


Definition at line 148 of file platform/emlib/inc/em_csen.h

CSEN_DMRes_TypeDef#

CSEN_DMRes_TypeDef

Delta Modulator (DM) Conversion Resolution.

Enumerator
csenDMRes10

10-bit resolution.

csenDMRes12

12-bit resolution.

csenDMRes14

14-bit resolution.

csenDMRes16

16-bit resolution.


Definition at line 156 of file platform/emlib/inc/em_csen.h

CSEN_PCPrescale_TypeDef#

CSEN_PCPrescale_TypeDef

Period counter clock pre-scaler.

See the reference manual for source clock information.

Enumerator
csenPCPrescaleDiv1

Divide by 1.

csenPCPrescaleDiv2

Divide by 2.

csenPCPrescaleDiv4

Divide by 4.

csenPCPrescaleDiv8

Divide by 8.

csenPCPrescaleDiv16

Divide by 16.

csenPCPrescaleDiv32

Divide by 32.

csenPCPrescaleDiv64

Divide by 64.

csenPCPrescaleDiv128

Divide by 128.


Definition at line 165 of file platform/emlib/inc/em_csen.h

CSEN_EMASample_TypeDef#

CSEN_EMASample_TypeDef

Exponential Moving Average sample weight.

Enumerator
csenEMASampleW1

Weight 1.

csenEMASampleW2

Weight 2.

csenEMASampleW4

Weight 4.

csenEMASampleW8

Weight 8.

csenEMASampleW16

Weight 16.

csenEMASampleW32

Weight 32.

csenEMASampleW64

Weight 64.


Definition at line 177 of file platform/emlib/inc/em_csen.h

CSEN_ResetPhaseSel_TypeDef#

CSEN_ResetPhaseSel_TypeDef

Reset Phase Timing Select (units are microseconds).

Enumerator
csenResetPhaseSel0

Reset phase time = 0.75 usec.

csenResetPhaseSel1

Reset phase time = 1.00 usec.

csenResetPhaseSel2

Reset phase time = 1.20 usec.

csenResetPhaseSel3

Reset phase time = 1.50 usec.

csenResetPhaseSel4

Reset phase time = 2.00 usec.

csenResetPhaseSel5

Reset phase time = 3.00 usec.

csenResetPhaseSel6

Reset phase time = 6.00 usec.

csenResetPhaseSel7

Reset phase time = 12.0 usec.


Definition at line 188 of file platform/emlib/inc/em_csen.h

CSEN_DriveSel_TypeDef#

CSEN_DriveSel_TypeDef

Drive Strength Select.

Scales the output current.

Enumerator
csenDriveSelFull

Drive strength = fully on.

csenDriveSel1

Drive strength = 1/8 full scale.

csenDriveSel2

Drive strength = 1/4 full scale.

csenDriveSel3

Drive strength = 3/8 full scale.

csenDriveSel4

Drive strength = 1/2 full scale.

csenDriveSel5

Drive strength = 5/8 full scale.

csenDriveSel6

Drive strength = 3/4 full scale.

csenDriveSel7

Drive strength = 7/8 full scale.


Definition at line 200 of file platform/emlib/inc/em_csen.h

CSEN_GainSel_TypeDef#

CSEN_GainSel_TypeDef

Gain Select.

See reference manual for information on each setting.

Enumerator
csenGainSel1X

Gain = 1x.

csenGainSel2X

Gain = 2x.

csenGainSel3X

Gain = 3x.

csenGainSel4X

Gain = 4x.

csenGainSel5X

Gain = 5x.

csenGainSel6X

Gain = 6x.

csenGainSel7X

Gain = 7x.

csenGainSel8X

Gain = 8x.


Definition at line 212 of file platform/emlib/inc/em_csen.h

CSEN_PRSSel_TypeDef#

CSEN_PRSSel_TypeDef

Peripheral Reflex System signal used to trigger conversion.

Enumerator
csenPRSSELCh0

PRS channel 0.

csenPRSSELCh1

PRS channel 1.

csenPRSSELCh2

PRS channel 2.

csenPRSSELCh3

PRS channel 3.

csenPRSSELCh4

PRS channel 4.

csenPRSSELCh5

PRS channel 5.

csenPRSSELCh6

PRS channel 6.

csenPRSSELCh7

PRS channel 7.

csenPRSSELCh8

PRS channel 8.

csenPRSSELCh9

PRS channel 9.

csenPRSSELCh10

PRS channel 10.

csenPRSSELCh11

PRS channel 11.


Definition at line 224 of file platform/emlib/inc/em_csen.h

CSEN_InputSel_TypeDef#

CSEN_InputSel_TypeDef

APORT channel to CSEN input selection.

Enumerator
csenInputSelDefault
csenInputSelAPORT1CH0TO7
csenInputSelAPORT1CH8TO15
csenInputSelAPORT1CH16TO23
csenInputSelAPORT1CH24TO31
csenInputSelAPORT3CH0TO7
csenInputSelAPORT3CH8TO15
csenInputSelAPORT3CH16TO23
csenInputSelAPORT3CH24TO31

Definition at line 248 of file platform/emlib/inc/em_csen.h

CSEN_SingleSel_TypeDef#

CSEN_SingleSel_TypeDef

APORT channel to CSEN single input selection.

Enumerator
csenSingleSelDefault
csenSingleSelAPORT1XCH0
csenSingleSelAPORT1YCH1
csenSingleSelAPORT1XCH2
csenSingleSelAPORT1YCH3
csenSingleSelAPORT1XCH4
csenSingleSelAPORT1YCH5
csenSingleSelAPORT1XCH6
csenSingleSelAPORT1YCH7
csenSingleSelAPORT1XCH8
csenSingleSelAPORT1YCH9
csenSingleSelAPORT1XCH10
csenSingleSelAPORT1YCH11
csenSingleSelAPORT1XCH12
csenSingleSelAPORT1YCH13
csenSingleSelAPORT1XCH14
csenSingleSelAPORT1YCH15
csenSingleSelAPORT1XCH16
csenSingleSelAPORT1YCH17
csenSingleSelAPORT1XCH18
csenSingleSelAPORT1YCH19
csenSingleSelAPORT1XCH20
csenSingleSelAPORT1YCH21
csenSingleSelAPORT1XCH22
csenSingleSelAPORT1YCH23
csenSingleSelAPORT1XCH24
csenSingleSelAPORT1YCH25
csenSingleSelAPORT1XCH26
csenSingleSelAPORT1YCH27
csenSingleSelAPORT1XCH28
csenSingleSelAPORT1YCH29
csenSingleSelAPORT1XCH30
csenSingleSelAPORT1YCH31
csenSingleSelAPORT3XCH0
csenSingleSelAPORT3YCH1
csenSingleSelAPORT3XCH2
csenSingleSelAPORT3YCH3
csenSingleSelAPORT3XCH4
csenSingleSelAPORT3YCH5
csenSingleSelAPORT3XCH6
csenSingleSelAPORT3YCH7
csenSingleSelAPORT3XCH8
csenSingleSelAPORT3YCH9
csenSingleSelAPORT3XCH10
csenSingleSelAPORT3YCH11
csenSingleSelAPORT3XCH12
csenSingleSelAPORT3YCH13
csenSingleSelAPORT3XCH14
csenSingleSelAPORT3YCH15
csenSingleSelAPORT3XCH16
csenSingleSelAPORT3YCH17
csenSingleSelAPORT3XCH18
csenSingleSelAPORT3YCH19
csenSingleSelAPORT3XCH20
csenSingleSelAPORT3YCH21
csenSingleSelAPORT3XCH22
csenSingleSelAPORT3YCH23
csenSingleSelAPORT3XCH24
csenSingleSelAPORT3YCH25
csenSingleSelAPORT3XCH26
csenSingleSelAPORT3YCH27
csenSingleSelAPORT3XCH28
csenSingleSelAPORT3YCH29
csenSingleSelAPORT3XCH30
csenSingleSelAPORT3YCH31

Definition at line 261 of file platform/emlib/inc/em_csen.h

Function Documentation#

CSEN_DMBaselineSet#

void CSEN_DMBaselineSet (CSEN_TypeDef * csen, uint32_t up, uint32_t down)

Set the DM integrator initial value.

Parameters
[in]csen

A pointer to the CSEN peripheral register block.

[in]up

An initial value for the ramp-up integrator.

[in]down

An initial value for the ramp-down integrator. Has no effect if low-frequency attenuation is not configured.

Sets the initial value of the integrator(s) for the Delta Modulation (DM) converter. The initial value for the ramp-down integrator has no effect if the low-frequency attenuation was not selected by the mode initialization function CSEN_InitMode().

Note

  • Confirm CSEN is idle before calling this function.


Definition at line 81 of file platform/emlib/src/em_csen.c

CSEN_Init#

void CSEN_Init (CSEN_TypeDef * csen, const CSEN_Init_TypeDef * init)

Initialize CSEN.

Parameters
[in]csen

A pointer to the CSEN peripheral register block.

[in]init

A pointer to the CSEN initialization structure.

Initializes common functionality for all measurement types. In addition, measurement mode must be configured. See CSEN_InitMode().

Note

  • This function will stop any ongoing conversion and disable CSEN.


Definition at line 107 of file platform/emlib/src/em_csen.c

CSEN_InitMode#

void CSEN_InitMode (CSEN_TypeDef * csen, const CSEN_InitMode_TypeDef * init)

Initialize a CSEN measurement mode.

Parameters
[in]csen

A pointer to the CSEN peripheral register block.

[in]init

A pointer to the CSEN measurement mode initialization structure.

Used to configure any type of measurement mode. After the measurement has been configured, calling CSEN_Enable() will enable CSEN and allow it to start a conversion from the selected trigger source. To manually start a conversion, use CSEN_Start(). To check if a conversion is in progress, use CSEN_IsBusy(), or alternatively use the interrupt flags returned by CSEN_IntGet() to detect when a conversion is completed.

Note

  • This function will stop any ongoing conversion and disable CSEN.


Definition at line 174 of file platform/emlib/src/em_csen.c

CSEN_Reset#

void CSEN_Reset (CSEN_TypeDef * csen)

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

Parameters
[in]csen

A pointer to the CSEN peripheral register block.


Definition at line 250 of file platform/emlib/src/em_csen.c

CSEN_DataGet#

uint32_t CSEN_DataGet (CSEN_TypeDef * csen)

Get the last conversion result.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

Note

  • Check the conversion busy flag before calling this function. In addition, the result width and format depend on the parameters passed to the CSEN_InitMode() function.

Returns

  • Result data from last conversion.


Definition at line 514 of file platform/emlib/inc/em_csen.h

CSEN_EMAGet#

uint32_t CSEN_EMAGet (CSEN_TypeDef * csen)

Get the last exponential moving average.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

Note

  • Confirm that CSEN is idle before calling this function.

Returns

  • Exponential moving average from last conversion.


Definition at line 532 of file platform/emlib/inc/em_csen.h

CSEN_EMASet#

void CSEN_EMASet (CSEN_TypeDef * csen, uint32_t ema)

Set the exponential moving average initial value.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

[in]ema

Initial value for the exponential moving average.

Note

  • Call this function before starting a conversion.


Definition at line 550 of file platform/emlib/inc/em_csen.h

CSEN_Disable#

void CSEN_Disable (CSEN_TypeDef * csen)

Disable CSEN.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.


Definition at line 562 of file platform/emlib/inc/em_csen.h

CSEN_Enable#

void CSEN_Enable (CSEN_TypeDef * csen)

Enable CSEN.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.


Definition at line 574 of file platform/emlib/inc/em_csen.h

CSEN_IntClear#

void CSEN_IntClear (CSEN_TypeDef * csen, uint32_t flags)

Clear one or more pending CSEN interrupts.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

[in]flags

Pending CSEN interrupt source to clear. Use a bitwise logic OR combination of valid interrupt flags for the CSEN module (CSEN_IF_nnn).


Definition at line 595 of file platform/emlib/inc/em_csen.h

CSEN_IntDisable#

void CSEN_IntDisable (CSEN_TypeDef * csen, uint32_t flags)

Disable one or more CSEN interrupts.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

[in]flags

CSEN interrupt sources to disable. Use a bitwise logic OR combination of valid interrupt flags for the CSEN module (CSEN_IF_nnn).


Definition at line 611 of file platform/emlib/inc/em_csen.h

CSEN_IntEnable#

void CSEN_IntEnable (CSEN_TypeDef * csen, uint32_t flags)

Enable one or more CSEN interrupts.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

[in]flags

CSEN interrupt sources to enable. Use a bitwise logic OR combination of valid interrupt flags for the CSEN module (CSEN_IF_nnn).

Note

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


Definition at line 632 of file platform/emlib/inc/em_csen.h

CSEN_IntGet#

uint32_t CSEN_IntGet (CSEN_TypeDef * csen)

Get pending CSEN interrupt flags.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

Note

  • The event bits are not cleared by the use of this function.

Returns

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


Definition at line 651 of file platform/emlib/inc/em_csen.h

CSEN_IntGetEnabled#

uint32_t CSEN_IntGetEnabled (CSEN_TypeDef * csen)

Get enabled and pending CSEN interrupt flags.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

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

Note

  • Interrupt flags are not cleared by the use of this function.

Returns

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

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

    • the OR combination of valid interrupt flags of the CSEN module (CSENx_IF_nnn).


Definition at line 675 of file platform/emlib/inc/em_csen.h

CSEN_IntSet#

void CSEN_IntSet (CSEN_TypeDef * csen, uint32_t flags)

Set one or more pending CSEN interrupts from SW.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

[in]flags

CSEN interrupt sources to set to pending. Use a bitwise logic OR combination of valid interrupt flags for the CSEN module (CSEN_IF_nnn).


Definition at line 698 of file platform/emlib/inc/em_csen.h

CSEN_IsBusy#

bool CSEN_IsBusy (CSEN_TypeDef * csen)

Return CSEN conversion busy status.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.

Returns

  • True if CSEN conversion is in progress.


Definition at line 713 of file platform/emlib/inc/em_csen.h

CSEN_Start#

void CSEN_Start (CSEN_TypeDef * csen)

Start a scan sequence and/or a single conversion.

Parameters
[in]csen

Pointer to a CSEN peripheral register block.


Definition at line 725 of file platform/emlib/inc/em_csen.h

Macro Definition Documentation#

CSEN_INIT_DEFAULT#

#define CSEN_INIT_DEFAULT
Value:
{ \
false, /* Charge pump low accuracy mode. */ \
false, /* Use external kelvin connection. */ \
false, /* Disable keep warm. */ \
0, /* 0+3 cycle warm-up time. */ \
0, /* Period counter reload. */ \
csenPCPrescaleDiv1, /* Period counter prescale. */ \
csenPRSSELCh0, /* PRS channel 0. */ \
csenInputSelAPORT1CH0TO7, /* input0To7 -> aport1ch0to7 */ \
csenInputSelAPORT1CH8TO15, /* input8To15 -> aport1ch8to15 */ \
csenInputSelAPORT1CH16TO23, /* input16To23 -> aport1ch16to23 */ \
csenInputSelAPORT1CH24TO31, /* input24To31 -> aport1ch24to31 */ \
csenInputSelAPORT3CH0TO7, /* input32To39 -> aport3ch0to7 */ \
csenInputSelAPORT3CH8TO15, /* input40To47 -> aport3ch8to15 */ \
csenInputSelAPORT3CH16TO23, /* input48To55 -> aport3ch16to23 */ \
csenInputSelAPORT3CH24TO31, /* input56To63 -> aport3ch24to31 */ \
}

CSEN default initialization.


Definition at line 368 of file platform/emlib/inc/em_csen.h

CSEN_INITMODE_DEFAULT#

#define CSEN_INITMODE_DEFAULT
Value:
{ \
csenSampleModeSingle, /* Sample one input and stop. */ \
csenTrigSelStart, /* Use start bit to trigger. */ \
false, /* Disable DMA. */ \
false, /* Average the accumulated result. */ \
csenAccMode1, /* Accumulate 1 sample. */ \
csenEMASampleW1, /* Disable the EMA. */ \
csenCmpModeDisabled, /* Disable the comparator. */ \
0, /* Comparator threshold not used. */ \
csenSingleSelDefault, /* Disconnect the single input. */ \
0, /* Disable inputs 0 to 31. */ \
0, /* Disable inputs 32 to 63. */ \
false, /* Do not ground inactive inputs. */ \
csenConvSelSAR, /* Use the SAR converter. */ \
csenSARRes10, /* Set SAR resolution to 10 bits. */ \
csenDMRes10, /* Set DM resolution to 10 bits. */ \
0, /* Set DM conv/cycle to default. */ \
0, /* Set DM cycles to default. */ \
0, /* Set DM initial delta to default. */ \
false, /* Use DM auto delta reduction. */ \
csenResetPhaseSel0, /* Use shortest reset phase time. */ \
csenDriveSelFull, /* Use full output current. */ \
csenGainSel8X, /* Use highest converter gain. */ \
}

CSEN default mode initialization.


Definition at line 469 of file platform/emlib/inc/em_csen.h