LESENSE

Detailed Description

Low Energy Sensor (LESENSE) Peripheral API.

This module contains functions to control the LESENSE peripheral of Silicon Labs 32-bit MCUs and SoCs. LESENSE is a low energy sensor interface capable of autonomously collecting and processing data from multiple sensors even when in EM2.

Data Structures
struct	LESENSE_AltExDesc_TypeDef
struct	LESENSE_ChAll_TypeDef
struct	LESENSE_ChDesc_TypeDef
struct	LESENSE_ConfAltEx_TypeDef
struct	LESENSE_CoreCtrlDesc_TypeDef
struct	LESENSE_DecCtrlDesc_TypeDef
struct	LESENSE_DecStAll_TypeDef
struct	LESENSE_DecStCond_TypeDef
struct	LESENSE_DecStDesc_TypeDef
struct	LESENSE_Init_TypeDef
struct	LESENSE_PerCtrlDesc_TypeDef
struct	LESENSE_TimeCtrlDesc_TypeDef

Macros
#define	LESENSE_ALTEX_CH_CONF_DEFAULT
#define	LESENSE_ALTEX_CONF_DEFAULT
#define	LESENSE_CH_CONF_DEFAULT
#define	LESENSE_CORECTRL_DESC_DEFAULT
#define	LESENSE_DECCTRL_DESC_DEFAULT
#define	LESENSE_DECODER_CONF_DEFAULT
#define	LESENSE_INIT_DEFAULT
#define	LESENSE_NUM_CHANNELS   16
#define	LESENSE_NUM_DECODER_STATES   (_LESENSE_DECSTATE_DECSTATE_MASK + 1)
#define	LESENSE_PERCTRL_DESC_DEFAULT
#define	LESENSE_SCAN_CONF_DEFAULT
#define	LESENSE_ST_CONF_DEFAULT
#define	LESENSE_TIMECTRL_DESC_DEFAULT

Enumerations
enum	LESENSE_AltExMap_TypeDef {   lesenseAltExMapALTEX = _LESENSE_CTRL_ALTEXMAP_ALTEX,   lesenseAltExMapCH = _LESENSE_CTRL_ALTEXMAP_CH }
enum	LESENSE_AltExPinIdle_TypeDef {   lesenseAltExPinIdleDis = _LESENSE_ALTEXCONF_IDLECONF0_DISABLE,   lesenseAltExPinIdleHigh = _LESENSE_ALTEXCONF_IDLECONF0_HIGH,   lesenseAltExPinIdleLow = _LESENSE_ALTEXCONF_IDLECONF0_LOW }
enum	LESENSE_BiasMode_TypeDef {   lesenseBiasModeDutyCycle = LESENSE_BIASCTRL_BIASMODE_DUTYCYCLE,   lesenseBiasModeHighAcc = LESENSE_BIASCTRL_BIASMODE_HIGHACC,   lesenseBiasModeDontTouch = LESENSE_BIASCTRL_BIASMODE_DONTTOUCH }
enum	LESENSE_BufTrigLevel_TypeDef {   lesenseBufTrigHalf = LESENSE_CTRL_BUFIDL_HALFFULL,   lesenseBufTrigFull = LESENSE_CTRL_BUFIDL_FULL }
enum	LESENSE_ChClk_TypeDef {   lesenseClkLF = _LESENSE_CH_INTERACT_EXCLK_LFACLK,   lesenseClkHF = _LESENSE_CH_INTERACT_EXCLK_AUXHFRCO }
enum	LESENSE_ChCompMode_TypeDef {   lesenseCompModeLess = LESENSE_CH_EVAL_COMP_LESS,   lesenseCompModeGreaterOrEq = LESENSE_CH_EVAL_COMP_GE }
enum	LESENSE_ChEvalMode_TypeDef {   lesenseEvalModeThreshold = _LESENSE_CH_EVAL_MODE_THRES,   lesenseEvalModeSlidingWindow = _LESENSE_CH_EVAL_MODE_SLIDINGWIN,   lesenseEvalModeStepDetection = _LESENSE_CH_EVAL_MODE_STEPDET }
enum	LESENSE_ChIntMode_TypeDef {   lesenseSetIntNone = LESENSE_CH_INTERACT_SETIF_NONE,   lesenseSetIntLevel = LESENSE_CH_INTERACT_SETIF_LEVEL,   lesenseSetIntPosEdge = LESENSE_CH_INTERACT_SETIF_POSEDGE,   lesenseSetIntNegEdge = LESENSE_CH_INTERACT_SETIF_NEGEDGE }
enum	LESENSE_ChPinExMode_TypeDef {   lesenseChPinExDis = LESENSE_CH_INTERACT_EXMODE_DISABLE,   lesenseChPinExHigh = LESENSE_CH_INTERACT_EXMODE_HIGH,   lesenseChPinExLow = LESENSE_CH_INTERACT_EXMODE_LOW,   lesenseChPinExDACOut = LESENSE_CH_INTERACT_EXMODE_DACOUT }
enum	LESENSE_ChPinIdleMode_TypeDef {   lesenseChPinIdleDis = _LESENSE_IDLECONF_CH0_DISABLE,   lesenseChPinIdleHigh = _LESENSE_IDLECONF_CH0_HIGH,   lesenseChPinIdleLow = _LESENSE_IDLECONF_CH0_LOW,   lesenseChPinIdleDACC = _LESENSE_IDLECONF_CH0_DAC }
enum	LESENSE_ChSampleMode_TypeDef {   lesenseSampleModeCounter = 0x0 << _LESENSE_CH_INTERACT_SAMPLE_SHIFT,   lesenseSampleModeACMP = LESENSE_CH_INTERACT_SAMPLE_ACMP,   lesenseSampleModeADC = LESENSE_CH_INTERACT_SAMPLE_ADC,   lesenseSampleModeADCDiff = LESENSE_CH_INTERACT_SAMPLE_ADCDIFF }
enum	LESENSE_ClkPresc_TypeDef {   lesenseClkDiv_1 = 0,   lesenseClkDiv_2 = 1,   lesenseClkDiv_4 = 2,   lesenseClkDiv_8 = 3,   lesenseClkDiv_16 = 4,   lesenseClkDiv_32 = 5,   lesenseClkDiv_64 = 6,   lesenseClkDiv_128 = 7 }
enum	LESENSE_ControlACMP_TypeDef {   lesenseACMPModeDisable = _LESENSE_PERCTRL_ACMP0MODE_DISABLE,   lesenseACMPModeMux = _LESENSE_PERCTRL_ACMP0MODE_MUX,   lesenseACMPModeMuxThres = _LESENSE_PERCTRL_ACMP0MODE_MUXTHRES }
enum	LESENSE_ControlDACData_TypeDef {   lesenseDACIfData = _LESENSE_PERCTRL_DACCH0DATA_DACDATA,   lesenseThres = _LESENSE_PERCTRL_DACCH0DATA_THRES }
enum	LESENSE_DecInput_TypeDef {   lesenseDecInputSensorSt = LESENSE_DECCTRL_INPUT_SENSORSTATE,   lesenseDecInputPRS = LESENSE_DECCTRL_INPUT_PRS }
enum	LESENSE_DMAWakeUp_TypeDef {   lesenseDMAWakeUpDisable = LESENSE_CTRL_DMAWU_DISABLE,   lesenseDMAWakeUpBufValid = LESENSE_CTRL_DMAWU_BUFDATAV,   lesenseDMAWakeUpBufLevel = LESENSE_CTRL_DMAWU_BUFLEVEL }
enum	LESENSE_PRSSel_TypeDef {   lesensePRSCh0 = 0,   lesensePRSCh1 = 1,   lesensePRSCh2 = 2,   lesensePRSCh3 = 3,   lesensePRSCh4 = 4,   lesensePRSCh5 = 5,   lesensePRSCh6 = 6,   lesensePRSCh7 = 7,   lesensePRSCh8 = 8,   lesensePRSCh9 = 9,   lesensePRSCh10 = 10,   lesensePRSCh11 = 11 }
enum	LESENSE_ScanConfSel_TypeDef {   lesenseScanConfDirMap = LESENSE_CTRL_SCANCONF_DIRMAP,   lesenseScanConfInvMap = LESENSE_CTRL_SCANCONF_INVMAP,   lesenseScanConfToggle = LESENSE_CTRL_SCANCONF_TOGGLE,   lesenseScanConfDecDef = LESENSE_CTRL_SCANCONF_DECDEF }
enum	LESENSE_ScanMode_TypeDef {   lesenseScanStartPeriodic = LESENSE_CTRL_SCANMODE_PERIODIC,   lesenseScanStartOneShot = LESENSE_CTRL_SCANMODE_ONESHOT,   lesenseScanStartPRS = LESENSE_CTRL_SCANMODE_PRS }
enum	LESENSE_StTransAct_TypeDef {   lesenseTransActNone = LESENSE_ST_TCONFA_PRSACT_NONE,   lesenseTransActPRS0 = LESENSE_ST_TCONFA_PRSACT_PRS0,   lesenseTransActPRS1 = LESENSE_ST_TCONFA_PRSACT_PRS1,   lesenseTransActPRS01 = LESENSE_ST_TCONFA_PRSACT_PRS01,   lesenseTransActPRS2 = LESENSE_ST_TCONFA_PRSACT_PRS2,   lesenseTransActPRS02 = LESENSE_ST_TCONFA_PRSACT_PRS02,   lesenseTransActPRS12 = LESENSE_ST_TCONFA_PRSACT_PRS12,   lesenseTransActPRS012 = LESENSE_ST_TCONFA_PRSACT_PRS012,   lesenseTransActUp = LESENSE_ST_TCONFA_PRSACT_UP,   lesenseTransActDown = LESENSE_ST_TCONFA_PRSACT_DOWN,   lesenseTransActUpAndPRS2 = LESENSE_ST_TCONFA_PRSACT_UPANDPRS2,   lesenseTransActDownAndPRS2 = LESENSE_ST_TCONFA_PRSACT_DOWNANDPRS2 }
enum	LESENSE_WarmupMode_TypeDef {   lesenseWarmupModeNormal = LESENSE_PERCTRL_WARMUPMODE_NORMAL,   lesenseWarmupModeACMP = LESENSE_PERCTRL_WARMUPMODE_KEEPACMPWARM,   lesenseWarmupModeDAC = LESENSE_PERCTRL_WARMUPMODE_KEEPDACWARM,   lesenseWarmupModeKeepWarm = LESENSE_PERCTRL_WARMUPMODE_KEEPACMPDACWARM }

Functions
void	LESENSE_AltExConfig (const LESENSE_ConfAltEx_TypeDef *confAltEx)
	Configure the LESENSE alternate excitation modes. More...
__STATIC_INLINE uint32_t	LESENSE_ChannelActiveGet (void)
	Get the currently active channel index. More...
void	LESENSE_ChannelAllConfig (const LESENSE_ChAll_TypeDef *confChAll)
	Configure all (16) LESENSE sensor channels. More...
void	LESENSE_ChannelConfig (const LESENSE_ChDesc_TypeDef *confCh, uint32_t chIdx)
	Configure a single LESENSE sensor channel. More...
void	LESENSE_ChannelEnable (uint8_t chIdx, bool enaScanCh, bool enaPin)
	Enable/disable LESENSE scan channel and the pin assigned to it. More...
void	LESENSE_ChannelEnableMask (uint16_t chMask, uint16_t pinMask)
	Enable/disable LESENSE scan channel and the pin assigned to it. More...
void	LESENSE_ChannelSlidingWindow (uint8_t chIdx, uint32_t windowSize, uint32_t initValue)
	Configure Sliding Window evaluation mode for a specific channel. More...
void	LESENSE_ChannelStepDetection (uint8_t chIdx, uint32_t stepSize, uint32_t initValue)
	Configure step detection evaluation mode for a specific channel. More...
void	LESENSE_ChannelThresSet (uint8_t chIdx, uint16_t acmpThres, uint16_t cntThres)
	Set LESENSE channel threshold parameters. More...
void	LESENSE_ChannelTimingSet (uint8_t chIdx, uint8_t exTime, uint8_t sampleDelay, uint16_t measDelay)
	Set LESENSE channel timing parameters. More...
void	LESENSE_ClkDivSet (LESENSE_ChClk_TypeDef clk, LESENSE_ClkPresc_TypeDef clkDiv)
	Set clock division for LESENSE timers. More...
void	LESENSE_DecoderPrsOut (bool enable, uint32_t decMask, uint32_t decVal)
	Enable or disable PRS output from the LESENSE decoder. More...
void	LESENSE_DecoderStart (void)
	Start LESENSE decoder. More...
void	LESENSE_DecoderStateAllConfig (const LESENSE_DecStAll_TypeDef *confDecStAll)
	Configure all LESENSE decoder states. More...
void	LESENSE_DecoderStateConfig (const LESENSE_DecStDesc_TypeDef *confDecSt, uint32_t decSt)
	Configure a single LESENSE decoder state. More...
uint32_t	LESENSE_DecoderStateGet (void)
	Get the current state of the LESENSE decoder. More...
void	LESENSE_DecoderStateSet (uint32_t decSt)
	Set LESENSE decoder state. More...
__STATIC_INLINE void	LESENSE_DecoderStop (void)
	Stop LESENSE decoder. More...
void	LESENSE_Init (const LESENSE_Init_TypeDef *init, bool reqReset)
	Initialize the LESENSE module. More...
__STATIC_INLINE void	LESENSE_IntClear (uint32_t flags)
	Clear one or more pending LESENSE interrupts. More...
__STATIC_INLINE void	LESENSE_IntDisable (uint32_t flags)
	Disable one or more LESENSE interrupts. More...
__STATIC_INLINE void	LESENSE_IntEnable (uint32_t flags)
	Enable one or more LESENSE interrupts. More...
__STATIC_INLINE uint32_t	LESENSE_IntGet (void)
	Get pending LESENSE interrupt flags. More...
__STATIC_INLINE uint32_t	LESENSE_IntGetEnabled (void)
	Get enabled and pending LESENSE interrupt flags. More...
__STATIC_INLINE void	LESENSE_IntSet (uint32_t flags)
	Set one or more pending LESENSE interrupts from SW. More...
void	LESENSE_Reset (void)
	Reset the LESENSE module. More...
void	LESENSE_ResultBufferClear (void)
	Clear result buffer. More...
uint32_t	LESENSE_ScanFreqSet (uint32_t refFreq, uint32_t scanFreq)
	Set scan frequency for periodic scanning. More...
void	LESENSE_ScanModeSet (LESENSE_ScanMode_TypeDef scanMode, bool start)
	Set scan mode of the LESENSE channels. More...
__STATIC_INLINE uint32_t	LESENSE_ScanResultDataBufferGet (uint32_t idx)
	Get data from the result data buffer. More...
__STATIC_INLINE uint32_t	LESENSE_ScanResultDataGet (void)
	Get the oldest unread data from the result buffer. More...
__STATIC_INLINE uint32_t	LESENSE_ScanResultGet (void)
	Get the latest scan comparison result (1 bit / channel). More...
void	LESENSE_ScanStart (void)
	Start scanning of sensors. More...
void	LESENSE_ScanStop (void)
	Stop scanning of sensors. More...
__STATIC_INLINE uint32_t	LESENSE_SensorStateGet (void)
	Get the current state of the LESENSE sensor. More...
void	LESENSE_StartDelaySet (uint8_t startDelay)
	Set start delay of sensor interaction on each channel. More...
__STATIC_INLINE uint32_t	LESENSE_StatusGet (void)
	Get the current status of LESENSE. More...
__STATIC_INLINE void	LESENSE_StatusWait (uint32_t flag)
	Wait until the status of LESENSE is equal to what requested. More...
void	LESENSE_StepSizeSet (uint32_t stepSize)
	Set the step size for all LESENSE channels. More...
void	LESENSE_WindowSizeSet (uint32_t windowSize)
	Set the window size for all LESENSE channels. More...

Macro Definition Documentation

#define LESENSE_ALTEX_CH_CONF_DEFAULT

Value:

{                                                                            \
  true,                  /* Alternate excitation enabled.*/                  \
  lesenseAltExPinIdleDis,/* Alternate excitation pin is disabled in idle. */ \
  false                  /* Excite only for corresponding channel. */        \
}

Default configuration for alternate excitation channel.

Definition at line 1008 of file em_lesense.h.

#define LESENSE_ALTEX_CONF_DEFAULT

Value:

{                                                                         \
  lesenseAltExMapCH,                                                      \
  {                                                                       \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 0. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 1. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 2. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 3. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 4. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 5. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 6. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 7. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 8. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 9. */  \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 10. */ \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 11. */ \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 12. */ \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 13. */ \
    LESENSE_ALTEX_CH_CONF_DEFAULT, /* Alternate excitation channel 14. */ \
    LESENSE_ALTEX_CH_CONF_DEFAULT  /* Alternate excitation channel 15. */ \
  }                                                                       \
}

Default configuration for all alternate excitation channels.

Definition at line 1040 of file em_lesense.h.

#define LESENSE_CH_CONF_DEFAULT

Value:

{                                                                                                     \
  true,                    /* Enable scan channel. */                                                 \
  true,                    /* Enable the assigned pin on scan channel. */                             \
  true,                    /* Enable interrupts on channel. */                                        \
  lesenseChPinExHigh,      /* Channel pin is high during the excitation period. */                    \
  lesenseChPinIdleLow,     /* Channel pin is low during the idle period. */                           \
  false,                   /* Don't use alternate excitation pins for excitation. */                  \
  false,                   /* Disabled to shift results from this channel to the decoder register. */ \
  false,                   /* Disabled to invert the scan result bit. */                              \
  false,                   /* Disabled to store counter value in the result buffer. */                \
  lesenseClkLF,            /* Use the LF clock for excitation timing. */                              \
  lesenseClkLF,            /* Use the LF clock for sample timing. */                                  \
  0x03U,                   /* Excitation time is set to 3(+1) excitation clock cycles. */             \
  0x09U,                   /* Sample delay is set to 9(+1) sample clock cycles. */                    \
  0x06U,                   /* Measure delay is set to 6 excitation clock cycles.*/                    \
  0x00U,                   /* ACMP threshold has been set to 0. */                                    \
  lesenseSampleModeACMP,   /* ACMP output will be used in comparison. */                              \
  lesenseSetIntNone,       /* No interrupt is generated by the channel. */                            \
  0xFFU,                   /* Counter threshold has bee set to 0xFF. */                               \
  lesenseCompModeLess,     /* Compare mode has been set to trigger interrupt on "less". */            \
  lesenseEvalModeThreshold /* Compare mode has been set to trigger interrupt on "less". */            \
}

Default configuration for scan channel.

Definition at line 889 of file em_lesense.h.

#define LESENSE_CORECTRL_DESC_DEFAULT

Value:

{                                                                                                   \
  lesenseScanStartPeriodic,  /* Start new scan each time the period counter overflows. */           \
  lesensePRSCh0,             /* Default PRS channel is selected. */                                 \
  lesenseScanConfDirMap,     /* Direct mapping SCANCONF register usage strategy. */                 \
  false,                     /* Don't invert ACMP0 output. */                                       \
  false,                     /* Don't invert ACMP1 output. */                                       \
  false,                     /* Disable dual sampling. */                                           \
  true,                      /* Store scan result after each scan. */                               \
  true,                      /* Overwrite result buffer register even if it is full. */             \
  lesenseBufTrigHalf,        /* Trigger interrupt and DMA request if result buffer is half full. */ \
  lesenseDMAWakeUpDisable,   /* Don't wake up on DMA from EM2. */                                   \
  lesenseBiasModeDontTouch,  /* Don't touch bias configuration. */                                  \
  true                       /* Keep LESENSE running in debug mode. */                              \
}

Default configuration for LESENSE_CtrlDesc_TypeDef structure.

Definition at line 579 of file em_lesense.h.

#define LESENSE_DECCTRL_DESC_DEFAULT

Value:

{                                     \
  lesenseDecInputSensorSt, /* The SENSORSTATE register is used as input to the decoder. */   \
  0U,                      /* State 0 is the initial state of the decoder. */                \
  false,                   /* Disable check of current state. */                             \
  true,                    /* Enable channel x % 16 interrupt on state x change. */          \
  true,                    /* Enable decoder hysteresis on PRS0 output. */                   \
  true,                    /* Enable decoder hysteresis on PRS1 output. */                   \
  true,                    /* Enable decoder hysteresis on PRS2 output. */                   \
  true,                    /* Enable decoder hysteresis on PRS3 output. */                   \
  false,                   /* Disable count mode on decoder PRS channels 0 and 1*/           \
  lesensePRSCh0,           /* PRS Channel 0 as input for bit 0 of the LESENSE decoder. */    \
  lesensePRSCh1,           /* PRS Channel 1 as input for bit 1 of the LESENSE decoder. */    \
  lesensePRSCh2,           /* PRS Channel 2 as input for bit 2 of the LESENSE decoder. */    \
  lesensePRSCh3,           /* PRS Channel 3 as input for bit 3 of the LESENSE decoder. */    \
}

Default configuration for LESENSE_PerCtrl_TypeDef structure.

Definition at line 749 of file em_lesense.h.

#define LESENSE_DECODER_CONF_DEFAULT

Default configuration for all decoder states.

Definition at line 1147 of file em_lesense.h.

#define LESENSE_INIT_DEFAULT

Value:

{                                                                                         \
  .coreCtrl = LESENSE_CORECTRL_DESC_DEFAULT, /* Default core control parameters. */       \
  .timeCtrl = LESENSE_TIMECTRL_DESC_DEFAULT, /* Default time control parameters. */       \
  .perCtrl  = LESENSE_PERCTRL_DESC_DEFAULT,  /* Default peripheral control parameters. */ \
  .decCtrl  = LESENSE_DECCTRL_DESC_DEFAULT   /* Default decoder control parameters. */    \
}

Default configuration for LESENSE_Init_TypeDef structure.

Definition at line 784 of file em_lesense.h.

#define LESENSE_NUM_CHANNELS   16

Number of LESENSE channels.

Definition at line 61 of file em_lesense.h.

Referenced by LESENSE_ChannelAllConfig(), LESENSE_ChannelConfig(), LESENSE_ChannelThresSet(), and LESENSE_Reset().

#define LESENSE_NUM_DECODER_STATES   (_LESENSE_DECSTATE_DECSTATE_MASK + 1)

Number of decoder states supported by current device.

Definition at line 58 of file em_lesense.h.

Referenced by LESENSE_DecoderStateAllConfig(), LESENSE_DecoderStateConfig(), and LESENSE_Reset().

#define LESENSE_PERCTRL_DESC_DEFAULT

Value:

{                                                                                                    \
  lesenseDACIfData,          /* DAC channel 0 data is defined by DAC_CH0DATA register. */            \
  lesenseDACIfData,          /* DAC channel 1 data is defined by DAC_CH1DATA register. */            \
  lesenseACMPModeMuxThres,   /* LESENSE controls the input mux and the threshold value of ACMP0. */  \
  lesenseACMPModeMuxThres,   /* LESENSE controls the input mux and the threshold value of ACMP1. */  \
  lesenseWarmupModeKeepWarm, /* Keep both ACMPs and the DAC powered up when LESENSE is idle. */      \
  false,                     /* DAC is enable for before every channel measurement. */               \
}

Default configuration for LESENSE_PerCtrl_TypeDef structure.

Definition at line 687 of file em_lesense.h.

#define LESENSE_SCAN_CONF_DEFAULT

Value:

{                                                   \
  {                                                 \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 0. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 1. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 2. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 3. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 4. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 5. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 6. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 7. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 8. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 9. */  \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 10. */ \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 11. */ \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 12. */ \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 13. */ \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 14. */ \
    LESENSE_CH_CONF_DEFAULT, /* Scan channel 15. */ \
  }                                                 \
}

Default configuration for all sensor channels.

Definition at line 939 of file em_lesense.h.

#define LESENSE_ST_CONF_DEFAULT

Value:

{                                                                      \
  0x0FU,               /* Compare value set to 0x0F. */                \
  0x00U,               /* All decoder inputs masked. */                \
  0U,                  /* Next state is state 0. */                    \
  lesenseTransActNone, /* No PRS action performed on compare match. */ \
  false                /* No interrupt triggered on compare match. */  \
}

Default configuration for decoder state condition.

Definition at line 1089 of file em_lesense.h.

#define LESENSE_TIMECTRL_DESC_DEFAULT

Value:

{                                                \
  0U,   /* No sensor interaction delay. */       \
  false /* Don't delay the AUXHFRCO startup. */  \
}

Default configuration for LESENSE_TimeCtrlDesc_TypeDef structure.

Definition at line 610 of file em_lesense.h.

Enumeration Type Documentation

enum LESENSE_AltExMap_TypeDef

Locations of the alternate excitation function.

Enumerator
lesenseAltExMapALTEX	Alternate excitation is mapped to the LES_ALTEX pins.
lesenseAltExMapCH	Alternative excitation is mapped to the pin of LESENSE channel (X+8 mod 16), X being the active channel.

Definition at line 135 of file em_lesense.h.

enum LESENSE_AltExPinIdle_TypeDef

Idle phase configuration of alternate excitation channels.

Enumerator
lesenseAltExPinIdleDis	ALTEX output is disabled in idle phase. Note: this value could be used for all alternate excitation channels.
lesenseAltExPinIdleHigh	ALTEX output is high in idle phase. Note: this value could be used for all alternate excitation channels.
lesenseAltExPinIdleLow	ALTEX output is low in idle phase. Note: this value could be used for all alternate excitation channels.

Definition at line 474 of file em_lesense.h.

enum LESENSE_BiasMode_TypeDef

Bias modes.

Enumerator
lesenseBiasModeDutyCycle	Duty cycle bias module between low power and high accuracy mode.
lesenseBiasModeHighAcc	Bias module is always in high accuracy mode.
lesenseBiasModeDontTouch	Bias module is controlled by the EMU and not affected by LESENSE.

Definition at line 181 of file em_lesense.h.

enum LESENSE_BufTrigLevel_TypeDef

Result buffer interrupt and DMA trigger levels.

Enumerator
lesenseBufTrigHalf	DMA and interrupt flags are set when result buffer is halffull.
lesenseBufTrigFull	DMA and interrupt flags set when result buffer is full.

Definition at line 154 of file em_lesense.h.

enum LESENSE_ChClk_TypeDef

Clock used for excitation and sample delay timing.

Enumerator
lesenseClkLF	LFACLK (LF clock) is used.
lesenseClkHF	AUXHFRCO (HF clock) is used.

Definition at line 423 of file em_lesense.h.

enum LESENSE_ChCompMode_TypeDef

Compare modes for counter comparison.

Enumerator
lesenseCompModeLess	Comparison evaluates to 1 if the sensor data is less than the counter threshold, or if the ACMP output is 0.
lesenseCompModeGreaterOrEq	Comparison evaluates to 1 if the sensor data is greater than, or equal to the counter threshold, or if the ACMP output is 1.

Definition at line 434 of file em_lesense.h.

enum LESENSE_ChEvalMode_TypeDef

Sensor evaluation modes.

Enumerator
lesenseEvalModeThreshold	Threshold comparison evaluation mode. In this mode the sensor data is compared to the configured threshold value. Two possible comparison operators can be used on the sensor data, either >= (GE) or < (LT). Which operator to use is given using the LESENSE_ChDesc_TypeDef::compMode member.
lesenseEvalModeSlidingWindow	Sliding window evaluation mode. In this mode the sensor data is evaluated against the upper and lower limits of a window range. The windows range is defined by a base value and a window size.
lesenseEvalModeStepDetection	Step detection evaluation mode. In this mode the sensor data is compared to the sensor data from the previous measurement. The sensor evaluation will result in a "1" if the difference between the current measurement and the previous one is greater than a configurable "step size". If the difference is less than the configured step size then the sensor evaluation will result in a "0".

Definition at line 448 of file em_lesense.h.

enum LESENSE_ChIntMode_TypeDef

Interrupt generation setup for CHx interrupt flag.

Enumerator
lesenseSetIntNone	No interrupt is generated.
lesenseSetIntLevel	Set interrupt flag if the sensor triggers.
lesenseSetIntPosEdge	Set interrupt flag on positive edge of the sensor state.
lesenseSetIntNegEdge	Set interrupt flag on negative edge of the sensor state.

Definition at line 358 of file em_lesense.h.

enum LESENSE_ChPinExMode_TypeDef

Channel pin mode for the excitation phase of the scan sequence.

Enumerator
lesenseChPinExDis	Channel pin is disabled.
lesenseChPinExHigh	Channel pin is configured as push-pull, driven HIGH.
lesenseChPinExLow	Channel pin is configured as push-pull, driven LOW.
lesenseChPinExDACOut	DAC output (only available on channel 0, 1, 2, 3, 12, 13, 14 and 15)

Definition at line 375 of file em_lesense.h.

enum LESENSE_ChPinIdleMode_TypeDef

Channel pin mode for the idle phase of the scan sequence.

Enumerator
lesenseChPinIdleDis	Channel pin is disabled in idle phase. Note: this value could be used for all channels.
lesenseChPinIdleHigh	Channel pin is configured as push-pull, driven HIGH in idle phase. Note: this value could be used for all channels.
lesenseChPinIdleLow	Channel pin is configured as push-pull, driven LOW in idle phase. Note: this value could be used for all channels.
lesenseChPinIdleDACC	Channel pin is connected to DAC output in idle phase. Note: this value could be used for all channels.

Definition at line 392 of file em_lesense.h.

enum LESENSE_ChSampleMode_TypeDef

Compare source selection for sensor sampling.

Enumerator
lesenseSampleModeCounter	Counter output will be used in comparison.
lesenseSampleModeACMP	ACMP output will be used in comparison.
lesenseSampleModeADC	ADC output will be used in comparison.
lesenseSampleModeADCDiff	Differential ADC output will be used in comparison.

Definition at line 339 of file em_lesense.h.

enum LESENSE_ClkPresc_TypeDef

Clock divisors for controlling the prescaling factor of the period counter. Note: these enumeration values are being used for different clock division related configuration parameters (hfPresc, lfPresc, pcPresc).

Enumerator
lesenseClkDiv_1	Divide clock by 1.
lesenseClkDiv_2	Divide clock by 2.
lesenseClkDiv_4	Divide clock by 4.
lesenseClkDiv_8	Divide clock by 8.
lesenseClkDiv_16	Divide clock by 16.
lesenseClkDiv_32	Divide clock by 32.
lesenseClkDiv_64	Divide clock by 64.
lesenseClkDiv_128	Divide clock by 128.

Definition at line 71 of file em_lesense.h.

enum LESENSE_ControlACMP_TypeDef

ACMPx control configuration.

Enumerator
lesenseACMPModeDisable	LESENSE does not control the ACMPx. Note: this value could be used for both ACMP0 and ACMP1.
lesenseACMPModeMux	LESENSE controls the input mux of ACMPx. Note: this value could be used for both ACMP0 and ACMP1.
lesenseACMPModeMuxThres	LESENSE controls the input mux of and the threshold value of ACMPx. Note: this value could be used for both ACMP0 and ACMP1.

Definition at line 294 of file em_lesense.h.

enum LESENSE_ControlDACData_TypeDef

DAC CHx data control configuration.

Enumerator
lesenseDACIfData	DAC channel x data is defined by DAC_CHxDATA register. Note: this value could be used for both DAC Ch0 and Ch1.
lesenseThres	DAC channel x data is defined by THRES in LESENSE_CHx_INTERACT. Note: this value could be used for both DAC Ch0 and Ch1.

Definition at line 216 of file em_lesense.h.

enum LESENSE_DecInput_TypeDef

Decoder input source configuration.

Enumerator
lesenseDecInputSensorSt	The SENSORSTATE register is used as input to the decoder.
lesenseDecInputPRS	PRS channels are used as input to the decoder.

Definition at line 328 of file em_lesense.h.

enum LESENSE_DMAWakeUp_TypeDef

Modes of operation for DMA wakeup from EM2.

Enumerator
lesenseDMAWakeUpDisable	No DMA wakeup from EM2.
lesenseDMAWakeUpBufValid	DMA wakeup from EM2 when data is valid in the result buffer.
lesenseDMAWakeUpBufLevel	DMA wakeup from EM2 when the resultbuffer is full/halffull, depending on RESBIDL configuration in LESENSE_CTRL register (selected by resBufTrigLevel in LESENSE_ResBufTrigLevel_TypeDef descriptor structure).

Definition at line 165 of file em_lesense.h.

enum LESENSE_PRSSel_TypeDef

PRS sources. Note: these enumeration values are being used for different PRS related configuration parameters.

Enumerator
lesensePRSCh0	PRS channel 0.
lesensePRSCh1	PRS channel 1.
lesensePRSCh2	PRS channel 2.
lesensePRSCh3	PRS channel 3.
lesensePRSCh4	PRS channel 4.
lesensePRSCh5	PRS channel 5.
lesensePRSCh6	PRS channel 6.
lesensePRSCh7	PRS channel 7.
lesensePRSCh8	PRS channel 8.
lesensePRSCh9	PRS channel 9.
lesensePRSCh10	PRS channel 10.
lesensePRSCh11	PRS channel 11.

Definition at line 101 of file em_lesense.h.

enum LESENSE_ScanConfSel_TypeDef

Scan configuration.

Enumerator
lesenseScanConfDirMap	The channel configuration registers (CHx_CONF) used are directly mapped to the channel number.
lesenseScanConfInvMap	The channel configuration registers used are CHx+8_CONF for channels 0-7 and CHx-8_CONF for channels 8-15.
lesenseScanConfToggle	The channel configuration registers used toggles between CHX_SCANCONF and CHX+8_SCANCONF when channel x triggers.
lesenseScanConfDecDef	The decoder state defines the channel configuration register (CHx_CONF) to be used.

Definition at line 195 of file em_lesense.h.

enum LESENSE_ScanMode_TypeDef

Scan modes.

Enumerator
lesenseScanStartPeriodic	New scan is started each time the period counter overflows.
lesenseScanStartOneShot	Single scan is performed when LESENSE_ScanStart() is called.
lesenseScanStartPRS	New scan is triggered by pulse on PRS channel.

Definition at line 85 of file em_lesense.h.

enum LESENSE_StTransAct_TypeDef

Transition action modes.

Enumerator
lesenseTransActNone	No PRS pulses generated (if PRSCOUNT == 0). Do not count (if PRSCOUNT == 1).
lesenseTransActPRS0	Generate pulse on LESPRS0 (if PRSCOUNT == 0).
lesenseTransActPRS1	Generate pulse on LESPRS1 (if PRSCOUNT == 0).
lesenseTransActPRS01	Generate pulse on LESPRS0 and LESPRS1 (if PRSCOUNT == 0).
lesenseTransActPRS2	Generate pulse on LESPRS2 (for both PRSCOUNT == 0 and PRSCOUNT == 1).
lesenseTransActPRS02	Generate pulse on LESPRS0 and LESPRS2 (if PRSCOUNT == 0).
lesenseTransActPRS12	Generate pulse on LESPRS1 and LESPRS2 (if PRSCOUNT == 0).
lesenseTransActPRS012	Generate pulse on LESPRS0, LESPRS1 and LESPRS2 (if PRSCOUNT == 0).
lesenseTransActUp	Count up (if PRSCOUNT == 1).
lesenseTransActDown	Count down (if PRSCOUNT == 1).
lesenseTransActUpAndPRS2	Count up and generate pulse on LESPRS2 (if PRSCOUNT == 1).
lesenseTransActDownAndPRS2	Count down and generate pulse on LESPRS2 (if PRSCOUNT == 1).

Definition at line 491 of file em_lesense.h.

enum LESENSE_WarmupMode_TypeDef

Warm up modes. ACMP and DAC duty cycle mode configuration.

Enumerator
lesenseWarmupModeNormal	ACMPs and DACs are shut down when LESENSE is idle.
lesenseWarmupModeACMP	ACMPs are kept powered up when LESENSE is idle.
lesenseWarmupModeDAC	The DAC is kept powered up when LESENSE is idle.
lesenseWarmupModeKeepWarm	ACMPs and the DAC are kept powered up when LESENSE is idle.

Definition at line 311 of file em_lesense.h.

Function Documentation

void LESENSE_AltExConfig

(

const LESENSE_ConfAltEx_TypeDef *

confAltEx

)

Configure the LESENSE alternate excitation modes.

This function configures the alternate excitation channels of the LESENSE interface. Please refer to the configuration parameter type definition (LESENSE_ConfAltEx_TypeDef) for more details.

Note

Parameter useAltEx must be true in the channel configuration structrure (LESENSE_ChDesc_TypeDef) in order to use alternate excitation pins on the channel.

Parameters

[in]

confAltEx

Configuration structure for LESENSE alternate excitation pins.

Definition at line 620 of file em_lesense.c.

References _LESENSE_CTRL_ALTEXMAP_SHIFT, LESENSE_ConfAltEx_TypeDef::AltEx, LESENSE_ConfAltEx_TypeDef::altExMap, LESENSE_AltExDesc_TypeDef::alwaysEx, BUS_RegBitWrite(), LESENSE_AltExDesc_TypeDef::enablePin, LESENSE_AltExDesc_TypeDef::idleConf, LESENSE, lesenseAltExMapALTEX, and lesenseAltExMapCH.

__STATIC_INLINE uint32_t LESENSE_ChannelActiveGet

(

void

)

Get the currently active channel index.

Returns

This function returns the value of LESENSE_CHINDEX register that contains the index of the currently active channel (0-15).

Definition at line 1310 of file em_lesense.h.

References LESENSE.

void LESENSE_ChannelAllConfig

(

const LESENSE_ChAll_TypeDef *

confChAll

)

Configure all (16) LESENSE sensor channels.

This function configures all the sensor channels of LESENSE interface. Please refer to the configuration parameter type definition (LESENSE_ChAll_TypeDef) for more details.

Note

Channels can be configured individually using LESENSE_ChannelConfig() function. Notice that pins used by the LESENSE module must be properly configured by the user explicitly, in order for the LESENSE to work as intended. (When configuring pins, one should remember to consider the sequence of configuration, in order to avoid unintended pulses/glitches on output pins.)

Parameters

[in]

confChAll

Configuration structure for all (16) LESENSE sensor channels.

Definition at line 476 of file em_lesense.c.

References LESENSE_ChAll_TypeDef::Ch, LESENSE_ChannelConfig(), and LESENSE_NUM_CHANNELS.

Referenced by CAPLESENSE_setupLESENSE().

void LESENSE_ChannelConfig	(	const LESENSE_ChDesc_TypeDef *	confCh,
		uint32_t	chIdx
	)

Configure a single LESENSE sensor channel.

This function configures a single sensor channel of the LESENSE interface. Please refer to the configuration parameter type definition (LESENSE_ChDesc_TypeDef) for more details.

Note

This function has been designed to minimize the effects of sensor channel reconfiguration while LESENSE is in operation, however one shall be aware of these effects and the right timing of calling this function. Parameter useAltEx must be true in the channel configuration in order to use alternate excitation pins.

Parameters

[in]	confCh	Configuration structure for a single LESENSE sensor channel.
[in]	chIdx	Channel index to configure (0-15).

Definition at line 511 of file em_lesense.c.

References _LESENSE_CH_EVAL_DECODE_SHIFT, _LESENSE_CH_EVAL_MODE_MASK, _LESENSE_CH_EVAL_MODE_SHIFT, _LESENSE_CH_EVAL_SCANRESINV_SHIFT, _LESENSE_CH_EVAL_STRSAMPLE_SHIFT, _LESENSE_CH_INTERACT_ALTEX_SHIFT, _LESENSE_CH_INTERACT_EXCLK_SHIFT, _LESENSE_CH_INTERACT_SAMPLECLK_SHIFT, _LESENSE_CH_TIMING_EXTIME_MASK, _LESENSE_CH_TIMING_EXTIME_SHIFT, _LESENSE_CH_TIMING_MEASUREDLY_MASK, _LESENSE_CH_TIMING_MEASUREDLY_SHIFT, _LESENSE_CH_TIMING_SAMPLEDLY_MASK, _LESENSE_CH_TIMING_SAMPLEDLY_SHIFT, LESENSE_ChDesc_TypeDef::acmpThres, BUS_RegBitWrite(), LESENSE_ChDesc_TypeDef::chPinExMode, LESENSE_ChDesc_TypeDef::chPinIdleMode, LESENSE_ChDesc_TypeDef::cntThres, LESENSE_ChDesc_TypeDef::compMode, LESENSE_ChDesc_TypeDef::enaInt, LESENSE_ChDesc_TypeDef::enaPin, LESENSE_ChDesc_TypeDef::enaScanCh, LESENSE_ChDesc_TypeDef::evalMode, LESENSE_ChDesc_TypeDef::exClk, LESENSE_ChDesc_TypeDef::exTime, LESENSE_ChDesc_TypeDef::intMode, LESENSE_ChDesc_TypeDef::invRes, LESENSE, LESENSE_ChannelThresSet(), LESENSE_ChannelTimingSet(), LESENSE_NUM_CHANNELS, lesenseChPinExDACOut, LESENSE_ChDesc_TypeDef::measDelay, LESENSE_ChDesc_TypeDef::sampleClk, LESENSE_ChDesc_TypeDef::sampleDelay, LESENSE_ChDesc_TypeDef::sampleMode, LESENSE_ChDesc_TypeDef::shiftRes, LESENSE_ChDesc_TypeDef::storeCntRes, and LESENSE_ChDesc_TypeDef::useAltEx.

Referenced by LESENSE_ChannelAllConfig().

void LESENSE_ChannelEnable	(	uint8_t	chIdx,
		bool	enaScanCh,
		bool	enaPin
	)

Enable/disable LESENSE scan channel and the pin assigned to it.

Use this function to enable/disable a selected LESENSE scan channel and the pin assigned to.

Note

Users can enable/disable scan channels and the channel pin by LESENSE_ChannelConfig() function, but only with a significant overhead. This simple function serves the purpose of controlling these parameters after the channel has been configured.

Parameters

[in]	chIdx	Identifier of the scan channel. Valid range: 0-15.
[in]	enaScanCh	Enable/disable the selected scan channel by setting this parameter to true/false respectively.
[in]	enaPin	Enable/disable the pin assigned to the channel selected by chIdx.

Definition at line 708 of file em_lesense.c.

References BUS_RegBitWrite(), and LESENSE.

void LESENSE_ChannelEnableMask	(	uint16_t	chMask,
		uint16_t	pinMask
	)

Enable/disable LESENSE scan channel and the pin assigned to it.

Use this function to enable/disable LESENSE scan channels and the pins assigned to them using a mask.

Note

Users can enable/disable scan channels and channel pins by using LESENSE_ChannelAllConfig() function, but only with a significant overhead. This simple function serves the purpose of controlling these parameters after the channel has been configured.

Parameters

[in]	chMask	Set the corresponding bit to 1 to enable, 0 to disable the selected scan channel.
[in]	pinMask	Set the corresponding bit to 1 to enable, 0 to disable the pin on selected channel.

Definition at line 745 of file em_lesense.c.

References LESENSE.

void LESENSE_ChannelSlidingWindow	(	uint8_t	chIdx,
		uint32_t	windowSize,
		uint32_t	initValue
	)

Configure Sliding Window evaluation mode for a specific channel.

This function will configure the evaluation mode, the initial sensor measurement (COMPTHRES) and the window size. For other channel related configuration see the LESENSE_ChannelConfig() function.

Warning

Beware that the step size and window size configuration are global to all LESENSE channels and use the same register field in the hardware. This means that any windowSize configuration passed to this function will apply for all channels and override all other stepSize/windowSize configurations.

Parameters

[in]	chIdx	Identifier of the scan channel. Valid range: 0-15.
[in]	windowSize	Window size to be used on all channels.
[in]	initValue	The initial sensor value for the channel.

Definition at line 892 of file em_lesense.c.

References _LESENSE_CH_EVAL_COMPTHRES_MASK, _LESENSE_CH_EVAL_COMPTHRES_SHIFT, _LESENSE_CH_EVAL_MODE_MASK, LESENSE_CH_TypeDef::EVAL, LESENSE, LESENSE_CH_EVAL_MODE_SLIDINGWIN, and LESENSE_WindowSizeSet().

void LESENSE_ChannelStepDetection	(	uint8_t	chIdx,
		uint32_t	stepSize,
		uint32_t	initValue
	)

Configure step detection evaluation mode for a specific channel.

This function will configure the evaluation mode, the initial sensor measurement (COMPTHRES) and the window size. For other channel related configuration see the LESENSE_ChannelConfig() function.

Warning

Beware that the step size and window size configuration are global to all LESENSE channels and use the same register field in the hardware. This means that any stepSize configuration passed to this function will apply for all channels and override all other stepSize/windowSize configurations.

Parameters

[in]	chIdx	Identifier of the scan channel. Valid range: 0-15.
[in]	stepSize	Step size to be used on all channels.
[in]	initValue	The initial sensor value for the channel.

Definition at line 929 of file em_lesense.c.

References _LESENSE_CH_EVAL_COMPTHRES_MASK, _LESENSE_CH_EVAL_COMPTHRES_SHIFT, _LESENSE_CH_EVAL_MODE_MASK, LESENSE_CH_TypeDef::EVAL, LESENSE, LESENSE_CH_EVAL_MODE_STEPDET, and LESENSE_StepSizeSet().

void LESENSE_ChannelThresSet	(	uint8_t	chIdx,
		uint16_t	acmpThres,
		uint16_t	cntThres
	)

Set LESENSE channel threshold parameters.

Use this function to set threshold parameters on a selected LESENSE channel.

Note

Users can configure the channel threshold parameters by LESENSE_ChannelConfig() function, but only with a significant overhead. This simple function serves the purpose of controlling these parameters after the channel has been configured.

Parameters

[in]	chIdx	Identifier of the scan channel. Valid range: 0-15.
[in]	acmpThres	ACMP threshold. If perCtrl.dacCh0Data or perCtrl.dacCh1Data is set to lesenseDACIfData, acmpThres defines the 12-bit DAC data in the corresponding data register of the DAC interface (DACn_CH0DATA and DACn_CH1DATA). In this case, the valid range is: 0-4095 (12 bits). If perCtrl.dacCh0Data or perCtrl.dacCh1Data is set to #lesenseACMPThres, acmpThres defines the 6-bit Vdd scaling factor of ACMP negative input (VDDLEVEL in ACMP_INPUTSEL register). In this case, the valid range is: 0-63 (6 bits).
[in]	cntThres	Decision threshold for counter comparison. Valid range: 0-65535 (16 bits).

Definition at line 837 of file em_lesense.c.

References _LESENSE_CH_EVAL_COMPTHRES_MASK, _LESENSE_CH_EVAL_COMPTHRES_SHIFT, LESENSE, and LESENSE_NUM_CHANNELS.

Referenced by CAPLESENSE_setupLESENSE(), and LESENSE_ChannelConfig().

void LESENSE_ChannelTimingSet	(	uint8_t	chIdx,
		uint8_t	exTime,
		uint8_t	sampleDelay,
		uint16_t	measDelay
	)

Set LESENSE channel timing parameters.

Use this function to set timing parameters on a selected LESENSE channel.

Note

Users can configure the channel timing parameters by LESENSE_ChannelConfig() function, but only with a significant overhead. This simple function serves the purpose of controlling these parameters after the channel has been configured.

Parameters

[in]	chIdx	Identifier of the scan channel. Valid range: 0-15.
[in]	exTime	Excitation time on chIdx. Excitation will last exTime+1 excitation clock cycles. Valid range: 0-63 (6 bits).
[in]	sampleDelay	Sample delay on chIdx. Sampling will occur after sampleDelay+1 sample clock cycles. Valid range: 0-127 (7 bits).
[in]	measDelay	Measure delay on chIdx. Sensor measuring is delayed for measDelay+1 excitation clock cycles. Valid range: 0-127 (7 bits).

Definition at line 782 of file em_lesense.c.

References _LESENSE_CH_TIMING_EXTIME_MASK, _LESENSE_CH_TIMING_EXTIME_SHIFT, _LESENSE_CH_TIMING_MEASUREDLY_MASK, _LESENSE_CH_TIMING_MEASUREDLY_SHIFT, _LESENSE_CH_TIMING_SAMPLEDLY_MASK, _LESENSE_CH_TIMING_SAMPLEDLY_SHIFT, and LESENSE.

Referenced by LESENSE_ChannelConfig().

void LESENSE_ClkDivSet	(	LESENSE_ChClk_TypeDef	clk,
		LESENSE_ClkPresc_TypeDef	clkDiv
	)

Set clock division for LESENSE timers.

Use this function to configure the clock division for the LESENSE timers used for excitation timing. The division setting is global, but the clock source can be selected for each channel using LESENSE_ChannelConfig() function, please refer to the documentation of it for more details.

Note

If AUXHFRCO is used for excitation timing, LFACLK can not exceed 500kHz. LFACLK can not exceed 50kHz if the ACMP threshold level (ACMPTHRES) is not equal for all channels.

Parameters

[in]	clk	Select clock to prescale. lesenseClkHF - set AUXHFRCO clock divisor for HF timer. lesenseClkLF - set LFACLKles clock divisor for LF timer.
[in]	clkDiv	Clock divisor value. Valid range depends on the clk value.

Definition at line 414 of file em_lesense.c.

References _LESENSE_TIMCTRL_AUXPRESC_MASK, _LESENSE_TIMCTRL_AUXPRESC_SHIFT, _LESENSE_TIMCTRL_LFPRESC_MASK, _LESENSE_TIMCTRL_LFPRESC_SHIFT, LESENSE, lesenseClkDiv_8, lesenseClkHF, and lesenseClkLF.

Referenced by CAPLESENSE_setupLESENSE().

void LESENSE_DecoderPrsOut	(	bool	enable,
		uint32_t	decMask,
		uint32_t	decVal
	)

Enable or disable PRS output from the LESENSE decoder.

Parameters

[in]	enable	enable/disable the PRS output from the LESENSE decoder. true to enable and false to disable.
[in]	decMask	Decoder state compare value mask
[in]	decVal	Decoder state compare value.

Definition at line 1115 of file em_lesense.c.

References _LESENSE_PRSCTRL_DECCMPEN_SHIFT, _LESENSE_PRSCTRL_DECCMPMASK_SHIFT, _LESENSE_PRSCTRL_DECCMPVAL_SHIFT, and LESENSE.

void LESENSE_DecoderStart

(

void

)

Start LESENSE decoder.

Note

This function will wait for any pending previous write operation to the CMD register to complete before accessing the CMD register. It will also wait for the write operation to the CMD register to complete before returning. Each write operation to the CMD register may take up to 3 LF clock cycles, so the user should expect some delay. The user may implement a separate function to write multiple command bits in the CMD register in one single operation in order to optimize an application.

Definition at line 1199 of file em_lesense.c.

References LESENSE, LESENSE_CMD_DECODE, and LESENSE_SYNCBUSY_CMD.

void LESENSE_DecoderStateAllConfig

(

const LESENSE_DecStAll_TypeDef *

confDecStAll

)

Configure all LESENSE decoder states.

This function configures all the decoder states of the LESENSE interface. Please refer to the configuration parameter type definition (LESENSE_DecStAll_TypeDef) for more details.

Note

Decoder states can be configured individually using LESENSE_DecoderStateConfig() function.

Parameters

[in]

confDecStAll

Configuration structure for all (16 or 32) LESENSE decoder states.

Definition at line 999 of file em_lesense.c.

References LESENSE_DecoderStateConfig(), LESENSE_NUM_DECODER_STATES, and LESENSE_DecStAll_TypeDef::St.

void LESENSE_DecoderStateConfig	(	const LESENSE_DecStDesc_TypeDef *	confDecSt,
		uint32_t	decSt
	)

Configure a single LESENSE decoder state.

This function configures a single decoder state of the LESENSE interface. Please refer to the configuration parameter type definition (LESENSE_DecStDesc_TypeDef) for more details.

Parameters

[in]	confDecSt	Configuration structure for a single LESENSE decoder state.
[in]	decSt	Decoder state index to configure (0-15) or (0-31) depending on device.

Definition at line 1027 of file em_lesense.c.

References _LESENSE_ST_TCONFA_CHAIN_SHIFT, _LESENSE_ST_TCONFA_COMP_SHIFT, _LESENSE_ST_TCONFA_MASK_SHIFT, _LESENSE_ST_TCONFA_NEXTSTATE_SHIFT, _LESENSE_ST_TCONFA_SETIF_SHIFT, _LESENSE_ST_TCONFB_COMP_SHIFT, _LESENSE_ST_TCONFB_MASK_SHIFT, _LESENSE_ST_TCONFB_NEXTSTATE_SHIFT, _LESENSE_ST_TCONFB_SETIF_SHIFT, LESENSE_DecStDesc_TypeDef::chainDesc, LESENSE_DecStCond_TypeDef::compMask, LESENSE_DecStCond_TypeDef::compVal, LESENSE_DecStDesc_TypeDef::confA, LESENSE_DecStDesc_TypeDef::confB, LESENSE, LESENSE_NUM_DECODER_STATES, LESENSE_DecStCond_TypeDef::nextState, LESENSE_DecStCond_TypeDef::prsAct, and LESENSE_DecStCond_TypeDef::setInt.

Referenced by LESENSE_DecoderStateAllConfig().

uint32_t LESENSE_DecoderStateGet

(

void

)

Get the current state of the LESENSE decoder.

Returns

This function returns the value of LESENSE_DECSTATE register that represents the current state of the LESENSE decoder.

Definition at line 1095 of file em_lesense.c.

References _LESENSE_DECSTATE_DECSTATE_MASK, and LESENSE.

void LESENSE_DecoderStateSet

(

uint32_t

decSt

)

Set LESENSE decoder state.

This function can be used for setting the initial state of the LESENSE decoder.

Note

Make sure the LESENSE decoder state is initialized by this function before enabling the decoder!

Parameters

[in]

decSt

Decoder state to set as current state. Valid range: 0-15 or 0-31 depending on device.

Definition at line 1079 of file em_lesense.c.

References _LESENSE_DECSTATE_DECSTATE_MASK, and LESENSE.

Referenced by LESENSE_Init().

__STATIC_INLINE void LESENSE_DecoderStop

(

void

)

Stop LESENSE decoder.

This function disables the LESENSE decoder by setting the command to the LESENSE_DECCTRL register.

Definition at line 1248 of file em_lesense.h.

References LESENSE, and LESENSE_DECCTRL_DISABLE.

void LESENSE_Init	(	const LESENSE_Init_TypeDef *	init,
		bool	reqReset
	)

Initialize the LESENSE module.

This function configures the main parameters of the LESENSE interface. Please refer to the initialization parameter type definition (LESENSE_Init_TypeDef) for more details.

Note

LESENSE_Init() has been designed for initializing LESENSE once in an operation cycle. Be aware of the effects of reconfiguration if using this function from multiple sources in your code. This function has not been designed to be re-entrant. Requesting reset by setting reqReset to true is required in each reset or power-on cycle in order to configure the default values of the RAM mapped LESENSE registers. Notice that GPIO pins used by the LESENSE module must be properly configured by the user explicitly, in order for the LESENSE to work as intended. (When configuring pins, one should remember to consider the sequence of configuration, in order to avoid unintended pulses/glitches on output pins.)

Parameters

[in]	init	LESENSE initialization structure.
[in]	reqReset	Request to call LESENSE_Reset() first in order to initialize all LESENSE registers with the default value.

Definition at line 118 of file em_lesense.c.

References _LESENSE_CTRL_BUFOW_SHIFT, _LESENSE_CTRL_DEBUGRUN_SHIFT, _LESENSE_CTRL_DUALSAMPLE_SHIFT, _LESENSE_CTRL_PRSSEL_SHIFT, _LESENSE_CTRL_STRSCANRES_SHIFT, _LESENSE_DECCTRL_ERRCHK_SHIFT, _LESENSE_DECCTRL_HYSTIRQ_SHIFT, _LESENSE_DECCTRL_HYSTPRS0_SHIFT, _LESENSE_DECCTRL_HYSTPRS1_SHIFT, _LESENSE_DECCTRL_HYSTPRS2_SHIFT, _LESENSE_DECCTRL_INTMAP_SHIFT, _LESENSE_DECCTRL_PRSCNT_SHIFT, _LESENSE_DECCTRL_PRSSEL0_SHIFT, _LESENSE_DECCTRL_PRSSEL1_SHIFT, _LESENSE_DECCTRL_PRSSEL2_SHIFT, _LESENSE_DECCTRL_PRSSEL3_SHIFT, _LESENSE_PERCTRL_ACMP0INV_MASK, _LESENSE_PERCTRL_ACMP0INV_SHIFT, _LESENSE_PERCTRL_ACMP0MODE_SHIFT, _LESENSE_PERCTRL_ACMP1INV_SHIFT, _LESENSE_PERCTRL_ACMP1MODE_SHIFT, _LESENSE_PERCTRL_DACCH0DATA_SHIFT, _LESENSE_PERCTRL_DACCH1DATA_SHIFT, _LESENSE_PERCTRL_DACCONVTRIG_SHIFT, _LESENSE_TIMCTRL_AUXSTARTUP_MASK, _LESENSE_TIMCTRL_AUXSTARTUP_SHIFT, LESENSE_PerCtrlDesc_TypeDef::acmp0Mode, LESENSE_PerCtrlDesc_TypeDef::acmp1Mode, LESENSE_CoreCtrlDesc_TypeDef::biasMode, LESENSE_CoreCtrlDesc_TypeDef::bufOverWr, LESENSE_CoreCtrlDesc_TypeDef::bufTrigLevel, LESENSE_DecCtrlDesc_TypeDef::chkState, LESENSE_Init_TypeDef::coreCtrl, LESENSE_PerCtrlDesc_TypeDef::dacCh0Data, LESENSE_PerCtrlDesc_TypeDef::dacCh1Data, LESENSE_PerCtrlDesc_TypeDef::dacScan, LESENSE_CoreCtrlDesc_TypeDef::debugRun, LESENSE_Init_TypeDef::decCtrl, LESENSE_DecCtrlDesc_TypeDef::decInput, LESENSE_TimeCtrlDesc_TypeDef::delayAuxStartup, LESENSE_CoreCtrlDesc_TypeDef::dualSample, LESENSE_DecCtrlDesc_TypeDef::hystIRQ, LESENSE_DecCtrlDesc_TypeDef::hystPRS0, LESENSE_DecCtrlDesc_TypeDef::hystPRS1, LESENSE_DecCtrlDesc_TypeDef::hystPRS2, LESENSE_DecCtrlDesc_TypeDef::initState, LESENSE_DecCtrlDesc_TypeDef::intMap, LESENSE_CoreCtrlDesc_TypeDef::invACMP0, LESENSE_CoreCtrlDesc_TypeDef::invACMP1, LESENSE, LESENSE_DecoderStateSet(), LESENSE_Reset(), LESENSE_ScanModeSet(), LESENSE_StartDelaySet(), LESENSE_Init_TypeDef::perCtrl, LESENSE_DecCtrlDesc_TypeDef::prsChSel0, LESENSE_DecCtrlDesc_TypeDef::prsChSel1, LESENSE_DecCtrlDesc_TypeDef::prsChSel2, LESENSE_DecCtrlDesc_TypeDef::prsChSel3, LESENSE_DecCtrlDesc_TypeDef::prsCount, LESENSE_CoreCtrlDesc_TypeDef::prsSel, LESENSE_CoreCtrlDesc_TypeDef::scanConfSel, LESENSE_CoreCtrlDesc_TypeDef::scanStart, LESENSE_TimeCtrlDesc_TypeDef::startDelay, LESENSE_CoreCtrlDesc_TypeDef::storeScanRes, LESENSE_Init_TypeDef::timeCtrl, LESENSE_CoreCtrlDesc_TypeDef::wakeupOnDMA, and LESENSE_PerCtrlDesc_TypeDef::warmupMode.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE void LESENSE_IntClear

(

uint32_t

flags

)

Clear one or more pending LESENSE interrupts.

Parameters

[in]

flags

Pending LESENSE interrupt sources to clear. Use a set of interrupt flags OR-ed together to clear multiple interrupt sources of the LESENSE module (LESENSE_IF_nnn).

Definition at line 1417 of file em_lesense.h.

References LESENSE.

Referenced by CAPLESENSE_setupLESENSE(), and LESENSE_IRQHandler().

__STATIC_INLINE void LESENSE_IntDisable

(

uint32_t

flags

)

Disable one or more LESENSE interrupts.

Parameters

[in]

flags

LESENSE interrupt sources to disable. Use a set of interrupt flags OR-ed together to disable multiple interrupt sources of the LESENSE module (LESENSE_IF_nnn).

Definition at line 1447 of file em_lesense.h.

References LESENSE.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE void LESENSE_IntEnable

(

uint32_t

flags

)

Enable one or more LESENSE interrupts.

Parameters

[in]

flags

LESENSE interrupt sources to enable. Use a set of interrupt flags OR-ed together to enable multiple interrupt sources of the LESENSE module (LESENSE_IF_nnn).

Definition at line 1432 of file em_lesense.h.

References LESENSE.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE uint32_t LESENSE_IntGet

(

void

)

Get pending LESENSE interrupt flags.

Note

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

Returns

Pending LESENSE interrupt sources. The OR combination of valid interrupt flags of the LESENSE module (LESENSE_IF_nnn).

Definition at line 1479 of file em_lesense.h.

References LESENSE.

__STATIC_INLINE uint32_t LESENSE_IntGetEnabled

(

void

)

Get enabled and pending LESENSE interrupt flags.

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

Note

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

Returns

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

• the OR combination of enabled interrupt sources in LESENSE_IEN_nnn register (LESENSE_IEN_nnn) and
• the OR combination of valid interrupt flags of the LESENSE module (LESENSE_IF_nnn).

Definition at line 1503 of file em_lesense.h.

References LESENSE.

Referenced by LESENSE_IRQHandler().

__STATIC_INLINE void LESENSE_IntSet

(

uint32_t

flags

)

Set one or more pending LESENSE interrupts from SW.

Parameters

[in]

flags

LESENSE interrupt sources to set to pending. Use a set of interrupt flags OR-ed together to set multiple interrupt sources of the LESENSE module (LESENSE_IFS_nnn).

Definition at line 1462 of file em_lesense.h.

References LESENSE.

void LESENSE_Reset

(

void

)

Reset the LESENSE module.

Use this function to reset the LESENSE registers.

Note

Resetting LESENSE registers is required in each reset or power-on cycle in order to configure the default values of the RAM mapped LESENSE registers. LESENSE_Reset() can be called on initialization by setting the reqReset parameter to true in LESENSE_Init().

Definition at line 1258 of file em_lesense.c.

References _LESENSE_ALTEXCONF_RESETVALUE, _LESENSE_BIASCTRL_RESETVALUE, _LESENSE_CH_EVAL_RESETVALUE, _LESENSE_CH_INTERACT_RESETVALUE, _LESENSE_CH_TIMING_RESETVALUE, _LESENSE_CHEN_RESETVALUE, _LESENSE_CTRL_RESETVALUE, _LESENSE_DECCTRL_RESETVALUE, _LESENSE_EVALCTRL_RESETVALUE, _LESENSE_IDLECONF_RESETVALUE, _LESENSE_IEN_RESETVALUE, _LESENSE_IFC_MASK, _LESENSE_PERCTRL_RESETVALUE, _LESENSE_PRSCTRL_RESETVALUE, _LESENSE_ROUTEPEN_RESETVALUE, _LESENSE_ST_TCONFA_RESETVALUE, _LESENSE_ST_TCONFB_RESETVALUE, LESENSE, LESENSE_CMD_CLEARBUF, LESENSE_CMD_STOP, LESENSE_DECCTRL_DISABLE, LESENSE_NUM_CHANNELS, LESENSE_NUM_DECODER_STATES, and LESENSE_SYNCBUSY_CMD.

Referenced by LESENSE_Init().

void LESENSE_ResultBufferClear

(

void

)

Clear result buffer.

Note

This function will wait for any pending previous write operation to the CMD register to complete before accessing the CMD register. It will also wait for the write operation to the CMD register to complete before returning. Each write operation to the CMD register may take up to 3 LF clock cycles, so the user should expect some delay. The user may implement a separate function to write multiple command bits in the CMD register in one single operation in order to optimize an application.

Definition at line 1229 of file em_lesense.c.

References LESENSE, LESENSE_CMD_CLEARBUF, and LESENSE_SYNCBUSY_CMD.

Referenced by CAPLESENSE_setupLESENSE().

uint32_t LESENSE_ScanFreqSet	(	uint32_t	refFreq,
		uint32_t	scanFreq
	)

Set scan frequency for periodic scanning.

This function only applies to LESENSE if period counter is being used as a trigger for scan start. The calculation is based on the following formula: Fscan = LFACLKles / ((1+PCTOP)*2^PCPRESC)

Note

Note that the calculation does not necessarily result in the requested scan frequency due to integer division. Check the return value for the resulted scan frequency.

Parameters

[in]	refFreq	Select reference LFACLK clock frequency in Hz. If set to 0, the current clock frequency is being used as a reference.
[in]	scanFreq	Set the desired scan frequency in Hz.

Returns

Frequency in Hz calculated and set by this function. Users can use this to compare the requested and set values.

Definition at line 247 of file em_lesense.c.

References _LESENSE_TIMCTRL_PCPRESC_MASK, _LESENSE_TIMCTRL_PCPRESC_SHIFT, _LESENSE_TIMCTRL_PCTOP_MASK, _LESENSE_TIMCTRL_PCTOP_SHIFT, CMU_ClockFreqGet(), cmuClock_LESENSE, LESENSE, and lesenseClkDiv_128.

Referenced by CAPLESENSE_setupLESENSE().

void LESENSE_ScanModeSet	(	LESENSE_ScanMode_TypeDef	scanMode,
		bool	start
	)

Set scan mode of the LESENSE channels.

This function configures how the scan start is being triggered. It can be used for re-configuring the scan mode while running the application but it is also used by LESENSE_Init() for initialization.

Note

Users can configure the scan mode by LESENSE_Init() function, but only with a significant overhead. This simple function serves the purpose of controlling this parameter after the channel has been configured. Please be aware the effects of the non-atomic Read-Modify-Write cycle!

Parameters

[in]	scanMode	Select where to map LESENSE alternate excitation channels. lesenseScanStartPeriodic - New scan is started each time the period counter overflows. lesenseScanStartOneShot - Single scan is performed when LESENSE_ScanStart() is called. lesenseScanStartPRS - New scan is triggered by pulse on PRS channel.
[in]	start	If true, LESENSE_ScanStart() is immediately issued after configuration.

Definition at line 329 of file em_lesense.c.

References _LESENSE_CTRL_SCANMODE_MASK, LESENSE, and LESENSE_ScanStart().

Referenced by LESENSE_Init().

__STATIC_INLINE uint32_t LESENSE_ScanResultDataBufferGet

(

uint32_t

idx

)

Get data from the result data buffer.

Note

Make sure that the STORERES bit is set in LESENSE_CHx_EVAL, or STRSCANRES bit is set in LESENSE_CTRL, otherwise this function will return undefined value.

Parameters

[in]

idx

Result data buffer index. Valid range: 0-15.

Returns

This function returns the selected word from the result data buffer.

Definition at line 1367 of file em_lesense.h.

References LESENSE.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE uint32_t LESENSE_ScanResultDataGet

(

void

)

Get the oldest unread data from the result buffer.

Note

Make sure that the STORERES bit is set in LESENSE_CHx_EVAL, or STRSCANRES bit is set in LESENSE_CTRL, otherwise this function will return undefined value.

Returns

This function returns the value of LESENSE_RESDATA register that contains the oldest unread counter result from the result buffer.

Definition at line 1346 of file em_lesense.h.

References LESENSE.

Referenced by LESENSE_IRQHandler().

__STATIC_INLINE uint32_t LESENSE_ScanResultGet

(

void

)

Get the latest scan comparison result (1 bit / channel).

Returns

This function returns the value of LESENSE_SCANRES register that contains the comparison result of the last scan on all channels. Bit x is set if a comparison triggered on channel x, which means that the LESENSE counter met the comparison criteria set in LESENSE_CHx_EVAL by COMPMODE and CNTTHRES.

Definition at line 1327 of file em_lesense.h.

References _LESENSE_SCANRES_SCANRES_MASK, and LESENSE.

void LESENSE_ScanStart

(

void

)

Start scanning of sensors.

Note

This function will wait for any pending previous write operation to the CMD register to complete before accessing the CMD register. It will also wait for the write operation to the CMD register to complete before returning. Each write operation to the CMD register may take up to 3 LF clock cycles, so the user should expect some delay. The user may implement a separate function to write multiple command bits in the CMD register in one single operation in order to optimize an application.

Definition at line 1136 of file em_lesense.c.

References LESENSE, LESENSE_CMD_START, and LESENSE_SYNCBUSY_CMD.

Referenced by CAPLESENSE_setupLESENSE(), and LESENSE_ScanModeSet().

void LESENSE_ScanStop

(

void

)

Stop scanning of sensors.

Note

This function will wait for any pending previous write operation to the CMD register to complete before accessing the CMD register. It will also wait for the write operation to the CMD register to complete before returning. Each write operation to the CMD register may take up to 3 LF clock cycles, so the user should expect some delay. The user may implement a separate function to write multiple command bits in the CMD register in one single operation in order to optimize an application.

If issued during a scan, the command takes effect after scan completion.

Definition at line 1169 of file em_lesense.c.

References LESENSE, LESENSE_CMD_STOP, and LESENSE_SYNCBUSY_CMD.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE uint32_t LESENSE_SensorStateGet

(

void

)

Get the current state of the LESENSE sensor.

Returns

This function returns the value of LESENSE_SENSORSTATE register that represents the current state of the LESENSE sensor.

Definition at line 1381 of file em_lesense.h.

References LESENSE.

void LESENSE_StartDelaySet

(

uint8_t

startDelay

)

Set start delay of sensor interaction on each channel.

This function sets start delay of sensor interaction on each channel. It can be used for adjusting the start delay while running the application but it is also used by LESENSE_Init() for initialization.

Note

Users can configure the start delay by LESENSE_Init() function, but only with a significant overhead. This simple function serves the purpose of controlling this parameter after the channel has been configured. Please be aware the effects of the non-atomic Read-Modify-Write cycle!

Parameters

[in]

startDelay

Number of LFACLK cycles to delay. Valid range: 0-3 (2 bit).

Definition at line 371 of file em_lesense.c.

References _LESENSE_TIMCTRL_STARTDLY_MASK, _LESENSE_TIMCTRL_STARTDLY_SHIFT, and LESENSE.

Referenced by LESENSE_Init().

__STATIC_INLINE uint32_t LESENSE_StatusGet

(

void

)

Get the current status of LESENSE.

Returns

This function returns the value of LESENSE_STATUS register that contains the OR combination of the following status bits:

• LESENSE_STATUS_RESV - Result data valid. Set when data is available in the result buffer. Cleared when the buffer is empty.
• LESENSE_STATUS_RESFULL - Result buffer full. Set when the result buffer is full.
• LESENSE_STATUS_RUNNING - LESENSE is active.
• LESENSE_STATUS_SCANACTIVE - LESENSE is currently interfacing sensors.

Definition at line 1269 of file em_lesense.h.

References LESENSE.

Referenced by CAPLESENSE_setupLESENSE().

__STATIC_INLINE void LESENSE_StatusWait

(

uint32_t

flag

)

Wait until the status of LESENSE is equal to what requested.

This function is polling the LESENSE_STATUS register and waits until the requested combination of flags are set.

Parameters

[in]

flag

The OR combination of the following status bits: LESENSE_STATUS_BUFDATAV - Result data valid. Set when data is available in the result buffer. Cleared when the buffer is empty. LESENSE_STATUS_BUFHALFFULL - Result buffer half full. Set when the result buffer is half full. LESENSE_STATUS_BUFFULL - Result buffer full. Set when the result buffer is full. LESENSE_STATUS_RUNNING - LESENSE is active. LESENSE_STATUS_SCANACTIVE - LESENSE is currently interfacing sensors. LESENSE_STATUS_DACACTIVE - The DAC interface is currently active.

Definition at line 1295 of file em_lesense.h.

References LESENSE.

void LESENSE_StepSizeSet

(

uint32_t

stepSize

)

Set the step size for all LESENSE channels.

The step size is configured using the same register field as use to configure window size. So calling this function will overwrite any previously configured window size as done by the LESENSE_WindowSizeSet() function.

Parameters

[in]

stepSize

The step size to use for all channels.

Definition at line 977 of file em_lesense.c.

References LESENSE_WindowSizeSet().

Referenced by LESENSE_ChannelStepDetection().

void LESENSE_WindowSizeSet

(

uint32_t

windowSize

)

Set the window size for all LESENSE channels.

The window size is used by all channels that are configured as lesenseEvalModeSlidingWindow.

Warning

The window size configuration is using the same register field as the step detection size. So the window size configuration will have an effect on channels configured with the lesenseEvalModeStepDetection evaluation mode as well.

Parameters

[in]

windowSize

The window size to use for all channels.

Definition at line 958 of file em_lesense.c.

References _LESENSE_EVALCTRL_WINSIZE_MASK, and LESENSE.

Referenced by LESENSE_ChannelSlidingWindow(), and LESENSE_StepSizeSet().