Chau Vo / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/hal/TARGET_Silicon_Labs/TARGET_EFM32/emlib/src/em_lesense.c@50:a417edff4437, 2016-01-15 (annotated)

Committer:
mbed_official
Date:
Fri Jan 15 07:45:16 2016 +0000
Revision:
50:a417edff4437
Parent:
0:9b334a45a8ff
Child:
144:ef7eb2e8f9f7
Synchronized with git revision 6010f32619bfcbb01cc73747d4ff9040863482d9



Full URL: https://github.com/mbedmicro/mbed/commit/6010f32619bfcbb01cc73747d4ff9040863482d9/



Remove doubling of buffer size in realiseEndpoint()

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 2 * @file em_lesense.c
bogdanm 0:9b334a45a8ff 3 * @brief Low Energy Sensor (LESENSE) Peripheral API
mbed_official 50:a417edff4437 4 * @version 4.2.1
bogdanm 0:9b334a45a8ff 5 *******************************************************************************
bogdanm 0:9b334a45a8ff 6 * @section License
mbed_official 50:a417edff4437 7 * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
bogdanm 0:9b334a45a8ff 8 *******************************************************************************
bogdanm 0:9b334a45a8ff 9 *
bogdanm 0:9b334a45a8ff 10 * Permission is granted to anyone to use this software for any purpose,
bogdanm 0:9b334a45a8ff 11 * including commercial applications, and to alter it and redistribute it
bogdanm 0:9b334a45a8ff 12 * freely, subject to the following restrictions:
bogdanm 0:9b334a45a8ff 13 *
bogdanm 0:9b334a45a8ff 14 * 1. The origin of this software must not be misrepresented; you must not
bogdanm 0:9b334a45a8ff 15 * claim that you wrote the original software.
bogdanm 0:9b334a45a8ff 16 * 2. Altered source versions must be plainly marked as such, and must not be
bogdanm 0:9b334a45a8ff 17 * misrepresented as being the original software.
bogdanm 0:9b334a45a8ff 18 * 3. This notice may not be removed or altered from any source distribution.
bogdanm 0:9b334a45a8ff 19 *
bogdanm 0:9b334a45a8ff 20 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
bogdanm 0:9b334a45a8ff 21 * obligation to support this Software. Silicon Labs is providing the
bogdanm 0:9b334a45a8ff 22 * Software "AS IS", with no express or implied warranties of any kind,
bogdanm 0:9b334a45a8ff 23 * including, but not limited to, any implied warranties of merchantability
bogdanm 0:9b334a45a8ff 24 * or fitness for any particular purpose or warranties against infringement
bogdanm 0:9b334a45a8ff 25 * of any proprietary rights of a third party.
bogdanm 0:9b334a45a8ff 26 *
bogdanm 0:9b334a45a8ff 27 * Silicon Labs will not be liable for any consequential, incidental, or
bogdanm 0:9b334a45a8ff 28 * special damages, or any other relief, or for any claim by any third party,
bogdanm 0:9b334a45a8ff 29 * arising from your use of this Software.
bogdanm 0:9b334a45a8ff 30 *
bogdanm 0:9b334a45a8ff 31 ******************************************************************************/
bogdanm 0:9b334a45a8ff 32
bogdanm 0:9b334a45a8ff 33 #include "em_lesense.h"
bogdanm 0:9b334a45a8ff 34 #if defined(LESENSE_COUNT) && (LESENSE_COUNT > 0)
bogdanm 0:9b334a45a8ff 35 #include "em_assert.h"
mbed_official 50:a417edff4437 36 #include "em_bus.h"
bogdanm 0:9b334a45a8ff 37 #include "em_cmu.h"
bogdanm 0:9b334a45a8ff 38
bogdanm 0:9b334a45a8ff 39 /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
mbed_official 50:a417edff4437 40 #if !defined(UINT32_MAX)
bogdanm 0:9b334a45a8ff 41 #define UINT32_MAX ((uint32_t)(0xFFFFFFFF))
bogdanm 0:9b334a45a8ff 42 #endif
bogdanm 0:9b334a45a8ff 43 /** @endcond */
bogdanm 0:9b334a45a8ff 44
bogdanm 0:9b334a45a8ff 45 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 46 * @addtogroup EM_Library
bogdanm 0:9b334a45a8ff 47 * @{
bogdanm 0:9b334a45a8ff 48 ******************************************************************************/
bogdanm 0:9b334a45a8ff 49
bogdanm 0:9b334a45a8ff 50 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 51 * @addtogroup LESENSE
bogdanm 0:9b334a45a8ff 52 * @brief Low Energy Sensor (LESENSE) Peripheral API
bogdanm 0:9b334a45a8ff 53 * @{
bogdanm 0:9b334a45a8ff 54 ******************************************************************************/
bogdanm 0:9b334a45a8ff 55
bogdanm 0:9b334a45a8ff 56 /*******************************************************************************
bogdanm 0:9b334a45a8ff 57 ************************** LOCAL FUNCTIONS ********************************
bogdanm 0:9b334a45a8ff 58 ******************************************************************************/
bogdanm 0:9b334a45a8ff 59
bogdanm 0:9b334a45a8ff 60
bogdanm 0:9b334a45a8ff 61 /*******************************************************************************
bogdanm 0:9b334a45a8ff 62 ************************** GLOBAL FUNCTIONS *******************************
bogdanm 0:9b334a45a8ff 63 ******************************************************************************/
bogdanm 0:9b334a45a8ff 64
bogdanm 0:9b334a45a8ff 65 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 66 * @brief
bogdanm 0:9b334a45a8ff 67 * Initialize the LESENSE module.
bogdanm 0:9b334a45a8ff 68 *
bogdanm 0:9b334a45a8ff 69 * @details
bogdanm 0:9b334a45a8ff 70 * This function configures the main parameters of the LESENSE interface.
bogdanm 0:9b334a45a8ff 71 * Please refer to the initialization parameter type definition
bogdanm 0:9b334a45a8ff 72 * (@ref LESENSE_Init_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 73 *
bogdanm 0:9b334a45a8ff 74 * @note
bogdanm 0:9b334a45a8ff 75 * @ref LESENSE_Init() has been designed for initializing LESENSE once in an
bogdanm 0:9b334a45a8ff 76 * operation cycle. Be aware of the effects of reconfiguration if using this
bogdanm 0:9b334a45a8ff 77 * function from multiple sources in your code. This function has not been
bogdanm 0:9b334a45a8ff 78 * designed to be re-entrant.
bogdanm 0:9b334a45a8ff 79 * Requesting reset by setting @p reqReset to true is required in each reset
bogdanm 0:9b334a45a8ff 80 * or power-on cycle in order to configure the default values of the RAM
bogdanm 0:9b334a45a8ff 81 * mapped LESENSE registers.
bogdanm 0:9b334a45a8ff 82 * Notice that GPIO pins used by the LESENSE module must be properly
bogdanm 0:9b334a45a8ff 83 * configured by the user explicitly, in order for the LESENSE to work as
bogdanm 0:9b334a45a8ff 84 * intended.
bogdanm 0:9b334a45a8ff 85 * (When configuring pins, one should remember to consider the sequence of
bogdanm 0:9b334a45a8ff 86 * configuration, in order to avoid unintended pulses/glitches on output
bogdanm 0:9b334a45a8ff 87 * pins.)
bogdanm 0:9b334a45a8ff 88 *
bogdanm 0:9b334a45a8ff 89 * @param[in] init
bogdanm 0:9b334a45a8ff 90 * LESENSE initialization structure.
bogdanm 0:9b334a45a8ff 91 *
bogdanm 0:9b334a45a8ff 92 * @param[in] reqReset
bogdanm 0:9b334a45a8ff 93 * Request to call @ref LESENSE_Reset() first in order to initialize all
bogdanm 0:9b334a45a8ff 94 * LESENSE registers with the default value.
bogdanm 0:9b334a45a8ff 95 ******************************************************************************/
bogdanm 0:9b334a45a8ff 96 void LESENSE_Init(LESENSE_Init_TypeDef const *init, bool const reqReset)
bogdanm 0:9b334a45a8ff 97 {
bogdanm 0:9b334a45a8ff 98 /* Sanity check of initialization values */
bogdanm 0:9b334a45a8ff 99 EFM_ASSERT((uint32_t)init->timeCtrl.startDelay < 4U);
bogdanm 0:9b334a45a8ff 100 EFM_ASSERT((uint32_t)init->perCtrl.dacPresc < 32U);
bogdanm 0:9b334a45a8ff 101
bogdanm 0:9b334a45a8ff 102 /* Reset LESENSE registers if requested. */
bogdanm 0:9b334a45a8ff 103 if (reqReset)
bogdanm 0:9b334a45a8ff 104 {
bogdanm 0:9b334a45a8ff 105 LESENSE_Reset();
bogdanm 0:9b334a45a8ff 106 }
bogdanm 0:9b334a45a8ff 107
bogdanm 0:9b334a45a8ff 108 /* Set sensor start delay for each channel. */
bogdanm 0:9b334a45a8ff 109 LESENSE_StartDelaySet((uint32_t)init->timeCtrl.startDelay);
bogdanm 0:9b334a45a8ff 110
bogdanm 0:9b334a45a8ff 111 /* LESENSE core control configuration.
bogdanm 0:9b334a45a8ff 112 * Set PRS source, SCANCONF register usage strategy, interrupt and
bogdanm 0:9b334a45a8ff 113 * DMA trigger level condition, DMA wakeup condition, bias mode,
bogdanm 0:9b334a45a8ff 114 * enable/disable to sample both ACMPs simultaneously, enable/disable to store
bogdanm 0:9b334a45a8ff 115 * SCANRES in CNT_RES after each scan, enable/disable to always write to the
bogdanm 0:9b334a45a8ff 116 * result buffer, even if it is full, enable/disable LESENSE running in debug
bogdanm 0:9b334a45a8ff 117 * mode. */
mbed_official 50:a417edff4437 118 LESENSE->CTRL =
mbed_official 50:a417edff4437 119 ((uint32_t)init->coreCtrl.prsSel << _LESENSE_CTRL_PRSSEL_SHIFT)
mbed_official 50:a417edff4437 120 | (uint32_t)init->coreCtrl.scanConfSel
mbed_official 50:a417edff4437 121 | (uint32_t)init->coreCtrl.bufTrigLevel
mbed_official 50:a417edff4437 122 | (uint32_t)init->coreCtrl.wakeupOnDMA
mbed_official 50:a417edff4437 123 | ((uint32_t)init->coreCtrl.invACMP0 << _LESENSE_CTRL_ACMP0INV_SHIFT)
mbed_official 50:a417edff4437 124 | ((uint32_t)init->coreCtrl.invACMP1 << _LESENSE_CTRL_ACMP1INV_SHIFT)
mbed_official 50:a417edff4437 125 | ((uint32_t)init->coreCtrl.dualSample << _LESENSE_CTRL_DUALSAMPLE_SHIFT)
mbed_official 50:a417edff4437 126 | ((uint32_t)init->coreCtrl.storeScanRes << _LESENSE_CTRL_STRSCANRES_SHIFT)
mbed_official 50:a417edff4437 127 | ((uint32_t)init->coreCtrl.bufOverWr << _LESENSE_CTRL_BUFOW_SHIFT)
mbed_official 50:a417edff4437 128 | ((uint32_t)init->coreCtrl.debugRun << _LESENSE_CTRL_DEBUGRUN_SHIFT);
bogdanm 0:9b334a45a8ff 129
bogdanm 0:9b334a45a8ff 130 /* Set scan mode in the CTRL register using the provided function, don't
bogdanm 0:9b334a45a8ff 131 * start scanning immediately. */
bogdanm 0:9b334a45a8ff 132 LESENSE_ScanModeSet((LESENSE_ScanMode_TypeDef)init->coreCtrl.scanStart, false);
bogdanm 0:9b334a45a8ff 133
bogdanm 0:9b334a45a8ff 134 /* LESENSE peripheral control configuration.
bogdanm 0:9b334a45a8ff 135 * Set DAC0 and DAC1 data source, conversion mode, output mode. Set DAC
bogdanm 0:9b334a45a8ff 136 * prescaler and reference. Set ACMP0 and ACMP1 control mode. Set ACMP and DAC
bogdanm 0:9b334a45a8ff 137 * duty cycle (warm up) mode. */
mbed_official 50:a417edff4437 138 LESENSE->PERCTRL =
mbed_official 50:a417edff4437 139 ((uint32_t)init->perCtrl.dacCh0Data << _LESENSE_PERCTRL_DACCH0DATA_SHIFT)
mbed_official 50:a417edff4437 140 | ((uint32_t)init->perCtrl.dacCh0ConvMode << _LESENSE_PERCTRL_DACCH0CONV_SHIFT)
mbed_official 50:a417edff4437 141 | ((uint32_t)init->perCtrl.dacCh0OutMode << _LESENSE_PERCTRL_DACCH0OUT_SHIFT)
mbed_official 50:a417edff4437 142 | ((uint32_t)init->perCtrl.dacCh1Data << _LESENSE_PERCTRL_DACCH1DATA_SHIFT)
mbed_official 50:a417edff4437 143 | ((uint32_t)init->perCtrl.dacCh1ConvMode << _LESENSE_PERCTRL_DACCH1CONV_SHIFT)
mbed_official 50:a417edff4437 144 | ((uint32_t)init->perCtrl.dacCh1OutMode << _LESENSE_PERCTRL_DACCH1OUT_SHIFT)
mbed_official 50:a417edff4437 145 | ((uint32_t)init->perCtrl.dacPresc << _LESENSE_PERCTRL_DACPRESC_SHIFT)
mbed_official 50:a417edff4437 146 | (uint32_t)init->perCtrl.dacRef
mbed_official 50:a417edff4437 147 | ((uint32_t)init->perCtrl.acmp0Mode << _LESENSE_PERCTRL_ACMP0MODE_SHIFT)
mbed_official 50:a417edff4437 148 | ((uint32_t)init->perCtrl.acmp1Mode << _LESENSE_PERCTRL_ACMP1MODE_SHIFT)
mbed_official 50:a417edff4437 149 | (uint32_t)init->perCtrl.warmupMode;
bogdanm 0:9b334a45a8ff 150
bogdanm 0:9b334a45a8ff 151 /* LESENSE decoder general control configuration.
bogdanm 0:9b334a45a8ff 152 * Set decoder input source, select PRS input for decoder bits.
bogdanm 0:9b334a45a8ff 153 * Enable/disable the decoder to check the present state.
bogdanm 0:9b334a45a8ff 154 * Enable/disable decoder to channel interrupt mapping.
bogdanm 0:9b334a45a8ff 155 * Enable/disable decoder hysteresis on PRS output.
bogdanm 0:9b334a45a8ff 156 * Enable/disable decoder hysteresis on count events.
bogdanm 0:9b334a45a8ff 157 * Enable/disable decoder hysteresis on interrupt requests.
bogdanm 0:9b334a45a8ff 158 * Enable/disable count mode on LESPRS0 and LESPRS1. */
mbed_official 50:a417edff4437 159 LESENSE->DECCTRL =
mbed_official 50:a417edff4437 160 (uint32_t)init->decCtrl.decInput
mbed_official 50:a417edff4437 161 | ((uint32_t)init->decCtrl.prsChSel0 << _LESENSE_DECCTRL_PRSSEL0_SHIFT)
mbed_official 50:a417edff4437 162 | ((uint32_t)init->decCtrl.prsChSel1 << _LESENSE_DECCTRL_PRSSEL1_SHIFT)
mbed_official 50:a417edff4437 163 | ((uint32_t)init->decCtrl.prsChSel2 << _LESENSE_DECCTRL_PRSSEL2_SHIFT)
mbed_official 50:a417edff4437 164 | ((uint32_t)init->decCtrl.prsChSel3 << _LESENSE_DECCTRL_PRSSEL3_SHIFT)
mbed_official 50:a417edff4437 165 | ((uint32_t)init->decCtrl.chkState << _LESENSE_DECCTRL_ERRCHK_SHIFT)
mbed_official 50:a417edff4437 166 | ((uint32_t)init->decCtrl.intMap << _LESENSE_DECCTRL_INTMAP_SHIFT)
mbed_official 50:a417edff4437 167 | ((uint32_t)init->decCtrl.hystPRS0 << _LESENSE_DECCTRL_HYSTPRS0_SHIFT)
mbed_official 50:a417edff4437 168 | ((uint32_t)init->decCtrl.hystPRS1 << _LESENSE_DECCTRL_HYSTPRS1_SHIFT)
mbed_official 50:a417edff4437 169 | ((uint32_t)init->decCtrl.hystPRS2 << _LESENSE_DECCTRL_HYSTPRS2_SHIFT)
mbed_official 50:a417edff4437 170 | ((uint32_t)init->decCtrl.hystIRQ << _LESENSE_DECCTRL_HYSTIRQ_SHIFT)
mbed_official 50:a417edff4437 171 | ((uint32_t)init->decCtrl.prsCount << _LESENSE_DECCTRL_PRSCNT_SHIFT);
bogdanm 0:9b334a45a8ff 172
bogdanm 0:9b334a45a8ff 173 /* Set initial LESENSE decoder state. */
bogdanm 0:9b334a45a8ff 174 LESENSE_DecoderStateSet((uint32_t)init->decCtrl.initState);
bogdanm 0:9b334a45a8ff 175
bogdanm 0:9b334a45a8ff 176 /* LESENSE bias control configuration. */
bogdanm 0:9b334a45a8ff 177 LESENSE->BIASCTRL = (uint32_t)init->coreCtrl.biasMode;
bogdanm 0:9b334a45a8ff 178 }
bogdanm 0:9b334a45a8ff 179
bogdanm 0:9b334a45a8ff 180
bogdanm 0:9b334a45a8ff 181 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 182 * @brief
bogdanm 0:9b334a45a8ff 183 * Set scan frequency for periodic scanning.
bogdanm 0:9b334a45a8ff 184 *
bogdanm 0:9b334a45a8ff 185 * @details
bogdanm 0:9b334a45a8ff 186 * This function only applies to LESENSE if period counter is being used as
bogdanm 0:9b334a45a8ff 187 * a trigger for scan start.
bogdanm 0:9b334a45a8ff 188 * The calculation is based on the following formula:
bogdanm 0:9b334a45a8ff 189 * Fscan = LFACLKles / ((1+PCTOP)*2^PCPRESC)
bogdanm 0:9b334a45a8ff 190 *
bogdanm 0:9b334a45a8ff 191 * @note
bogdanm 0:9b334a45a8ff 192 * Note that the calculation does not necessarily result in the requested
bogdanm 0:9b334a45a8ff 193 * scan frequency due to integer division. Check the return value for the
bogdanm 0:9b334a45a8ff 194 * resulted scan frequency.
bogdanm 0:9b334a45a8ff 195 *
bogdanm 0:9b334a45a8ff 196 * @param[in] refFreq
bogdanm 0:9b334a45a8ff 197 * Select reference LFACLK clock frequency in Hz. If set to 0, the current
bogdanm 0:9b334a45a8ff 198 * clock frequency is being used as a reference.
bogdanm 0:9b334a45a8ff 199 *
bogdanm 0:9b334a45a8ff 200 * @param[in] scanFreq
bogdanm 0:9b334a45a8ff 201 * Set the desired scan frequency in Hz.
bogdanm 0:9b334a45a8ff 202 *
bogdanm 0:9b334a45a8ff 203 * @return
bogdanm 0:9b334a45a8ff 204 * Frequency in Hz calculated and set by this function. Users can use this to
bogdanm 0:9b334a45a8ff 205 * compare the requested and set values.
bogdanm 0:9b334a45a8ff 206 ******************************************************************************/
bogdanm 0:9b334a45a8ff 207 uint32_t LESENSE_ScanFreqSet(uint32_t refFreq, uint32_t const scanFreq)
bogdanm 0:9b334a45a8ff 208 {
bogdanm 0:9b334a45a8ff 209 uint32_t tmp;
bogdanm 0:9b334a45a8ff 210 uint32_t pcPresc = 0UL; /* Period counter prescaler. */
bogdanm 0:9b334a45a8ff 211 uint32_t clkDiv = 1UL; /* Clock divisor value (2^pcPresc). */
bogdanm 0:9b334a45a8ff 212 uint32_t pcTop = 63UL; /* Period counter top value (max. 63). */
bogdanm 0:9b334a45a8ff 213 uint32_t calcScanFreq; /* Variable for testing the calculation algorithm. */
bogdanm 0:9b334a45a8ff 214
bogdanm 0:9b334a45a8ff 215
bogdanm 0:9b334a45a8ff 216 /* If refFreq is set to 0, the currently configured reference clock is
bogdanm 0:9b334a45a8ff 217 * assumed. */
bogdanm 0:9b334a45a8ff 218 if (!refFreq)
bogdanm 0:9b334a45a8ff 219 {
bogdanm 0:9b334a45a8ff 220 refFreq = CMU_ClockFreqGet(cmuClock_LESENSE);
bogdanm 0:9b334a45a8ff 221 }
bogdanm 0:9b334a45a8ff 222
bogdanm 0:9b334a45a8ff 223 /* Max. value of pcPresc is 128, thus using reference frequency less than
bogdanm 0:9b334a45a8ff 224 * 33554431Hz (33.554431MHz), the frequency calculation in the while loop
bogdanm 0:9b334a45a8ff 225 * below will not overflow. */
bogdanm 0:9b334a45a8ff 226 EFM_ASSERT(refFreq < ((uint32_t)UINT32_MAX / 128UL));
bogdanm 0:9b334a45a8ff 227
bogdanm 0:9b334a45a8ff 228 /* Sanity check of scan frequency value. */
bogdanm 0:9b334a45a8ff 229 EFM_ASSERT((scanFreq > 0U) && (scanFreq <= refFreq));
bogdanm 0:9b334a45a8ff 230
bogdanm 0:9b334a45a8ff 231 /* Calculate the minimum necessary prescaler value in order to provide the
bogdanm 0:9b334a45a8ff 232 * biggest possible resolution for setting scan frequency.
bogdanm 0:9b334a45a8ff 233 * Maximum number of calculation cycles is 7 (value of lesenseClkDiv_128). */
mbed_official 50:a417edff4437 234 while ((refFreq / ((uint32_t)scanFreq * clkDiv) > (pcTop + 1UL))
mbed_official 50:a417edff4437 235 && (pcPresc < lesenseClkDiv_128))
bogdanm 0:9b334a45a8ff 236 {
bogdanm 0:9b334a45a8ff 237 ++pcPresc;
bogdanm 0:9b334a45a8ff 238 clkDiv = (uint32_t)1UL << pcPresc;
bogdanm 0:9b334a45a8ff 239 }
bogdanm 0:9b334a45a8ff 240
bogdanm 0:9b334a45a8ff 241 /* Calculate pcTop value. */
bogdanm 0:9b334a45a8ff 242 pcTop = ((uint32_t)refFreq / ((uint32_t)scanFreq * clkDiv)) - 1UL;
bogdanm 0:9b334a45a8ff 243
bogdanm 0:9b334a45a8ff 244 /* Clear current PCPRESC and PCTOP settings. Be aware of the effect of
bogdanm 0:9b334a45a8ff 245 * non-atomic Read-Modify-Write on LESENSE->TIMCRTL. */
mbed_official 50:a417edff4437 246 tmp = LESENSE->TIMCTRL & (~_LESENSE_TIMCTRL_PCPRESC_MASK
mbed_official 50:a417edff4437 247 & ~_LESENSE_TIMCTRL_PCTOP_MASK);
bogdanm 0:9b334a45a8ff 248
bogdanm 0:9b334a45a8ff 249 /* Set new values in tmp while reserving other settings. */
mbed_official 50:a417edff4437 250 tmp |= ((uint32_t)pcPresc << _LESENSE_TIMCTRL_PCPRESC_SHIFT)
mbed_official 50:a417edff4437 251 | ((uint32_t)pcTop << _LESENSE_TIMCTRL_PCTOP_SHIFT);
bogdanm 0:9b334a45a8ff 252
bogdanm 0:9b334a45a8ff 253 /* Set values in LESENSE_TIMCTRL register. */
bogdanm 0:9b334a45a8ff 254 LESENSE->TIMCTRL = tmp;
bogdanm 0:9b334a45a8ff 255
bogdanm 0:9b334a45a8ff 256 /* For testing the calculation algorithm. */
bogdanm 0:9b334a45a8ff 257 calcScanFreq = ((uint32_t)refFreq / ((uint32_t)(1UL + pcTop) * clkDiv));
bogdanm 0:9b334a45a8ff 258
bogdanm 0:9b334a45a8ff 259 return calcScanFreq;
bogdanm 0:9b334a45a8ff 260 }
bogdanm 0:9b334a45a8ff 261
bogdanm 0:9b334a45a8ff 262
bogdanm 0:9b334a45a8ff 263 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 264 * @brief
bogdanm 0:9b334a45a8ff 265 * Set scan mode of the LESENSE channels.
bogdanm 0:9b334a45a8ff 266 *
bogdanm 0:9b334a45a8ff 267 * @details
bogdanm 0:9b334a45a8ff 268 * This function configures how the scan start is being triggered. It can be
bogdanm 0:9b334a45a8ff 269 * used for re-configuring the scan mode while running the application but it
bogdanm 0:9b334a45a8ff 270 * is also used by LESENSE_Init() for initialization.
bogdanm 0:9b334a45a8ff 271 *
bogdanm 0:9b334a45a8ff 272 * @note
bogdanm 0:9b334a45a8ff 273 * Users can configure the scan mode by LESENSE_Init() function, but only with
bogdanm 0:9b334a45a8ff 274 * a significant overhead. This simple function serves the purpose of
bogdanm 0:9b334a45a8ff 275 * controlling this parameter after the channel has been configured.
bogdanm 0:9b334a45a8ff 276 * Please be aware the effects of the non-atomic Read-Modify-Write cycle!
bogdanm 0:9b334a45a8ff 277 *
bogdanm 0:9b334a45a8ff 278 * @param[in] scanMode
bogdanm 0:9b334a45a8ff 279 * Select where to map LESENSE alternate excitation channels.
bogdanm 0:9b334a45a8ff 280 * @li lesenseScanStartPeriodic - New scan is started each time the period
bogdanm 0:9b334a45a8ff 281 * counter overflows.
bogdanm 0:9b334a45a8ff 282 * @li lesenseScanStartOneShot - Single scan is performed when
bogdanm 0:9b334a45a8ff 283 * LESENSE_ScanStart() is called.
bogdanm 0:9b334a45a8ff 284 * @li lesenseScanStartPRS - New scan is triggered by pulse on PRS channel.
bogdanm 0:9b334a45a8ff 285 *
bogdanm 0:9b334a45a8ff 286 * @param[in] start
bogdanm 0:9b334a45a8ff 287 * If true, LESENSE_ScanStart() is immediately issued after configuration.
bogdanm 0:9b334a45a8ff 288 ******************************************************************************/
bogdanm 0:9b334a45a8ff 289 void LESENSE_ScanModeSet(LESENSE_ScanMode_TypeDef const scanMode,
bogdanm 0:9b334a45a8ff 290 bool const start)
bogdanm 0:9b334a45a8ff 291 {
bogdanm 0:9b334a45a8ff 292 uint32_t tmp; /* temporary storage of the CTRL register value */
bogdanm 0:9b334a45a8ff 293
bogdanm 0:9b334a45a8ff 294
bogdanm 0:9b334a45a8ff 295 /* Save the CTRL register value to tmp.
bogdanm 0:9b334a45a8ff 296 * Please be aware the effects of the non-atomic Read-Modify-Write cycle! */
bogdanm 0:9b334a45a8ff 297 tmp = LESENSE->CTRL & ~(_LESENSE_CTRL_SCANMODE_MASK);
bogdanm 0:9b334a45a8ff 298 /* Setting the requested scanMode to the CTRL register. Casting signed int
bogdanm 0:9b334a45a8ff 299 * (enum) to unsigned long (uint32_t). */
bogdanm 0:9b334a45a8ff 300 tmp |= (uint32_t)scanMode;
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 /* Write the new value to the CTRL register. */
bogdanm 0:9b334a45a8ff 303 LESENSE->CTRL = tmp;
bogdanm 0:9b334a45a8ff 304
bogdanm 0:9b334a45a8ff 305 /* Start sensor scanning if requested. */
bogdanm 0:9b334a45a8ff 306 if (start)
bogdanm 0:9b334a45a8ff 307 {
bogdanm 0:9b334a45a8ff 308 LESENSE_ScanStart();
bogdanm 0:9b334a45a8ff 309 }
bogdanm 0:9b334a45a8ff 310 }
bogdanm 0:9b334a45a8ff 311
bogdanm 0:9b334a45a8ff 312
bogdanm 0:9b334a45a8ff 313 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 314 * @brief
bogdanm 0:9b334a45a8ff 315 * Set start delay of sensor interaction on each channel.
bogdanm 0:9b334a45a8ff 316 *
bogdanm 0:9b334a45a8ff 317 * @details
bogdanm 0:9b334a45a8ff 318 * This function sets start delay of sensor interaction on each channel.
bogdanm 0:9b334a45a8ff 319 * It can be used for adjusting the start delay while running the application
bogdanm 0:9b334a45a8ff 320 * but it is also used by LESENSE_Init() for initialization.
bogdanm 0:9b334a45a8ff 321 *
bogdanm 0:9b334a45a8ff 322 * @note
bogdanm 0:9b334a45a8ff 323 * Users can configure the start delay by LESENSE_Init() function, but only
bogdanm 0:9b334a45a8ff 324 * with a significant overhead. This simple function serves the purpose of
bogdanm 0:9b334a45a8ff 325 * controlling this parameter after the channel has been configured.
bogdanm 0:9b334a45a8ff 326 * Please be aware the effects of the non-atomic Read-Modify-Write cycle!
bogdanm 0:9b334a45a8ff 327 *
bogdanm 0:9b334a45a8ff 328 * @param[in] startDelay
bogdanm 0:9b334a45a8ff 329 * Number of LFACLK cycles to delay. Valid range: 0-3 (2 bit).
bogdanm 0:9b334a45a8ff 330 ******************************************************************************/
bogdanm 0:9b334a45a8ff 331 void LESENSE_StartDelaySet(uint8_t const startDelay)
bogdanm 0:9b334a45a8ff 332 {
bogdanm 0:9b334a45a8ff 333 uint32_t tmp; /* temporary storage of the TIMCTRL register value */
bogdanm 0:9b334a45a8ff 334
bogdanm 0:9b334a45a8ff 335
bogdanm 0:9b334a45a8ff 336 /* Sanity check of startDelay. */
bogdanm 0:9b334a45a8ff 337 EFM_ASSERT(startDelay < 4U);
bogdanm 0:9b334a45a8ff 338
bogdanm 0:9b334a45a8ff 339 /* Save the TIMCTRL register value to tmp.
bogdanm 0:9b334a45a8ff 340 * Please be aware the effects of the non-atomic Read-Modify-Write cycle! */
bogdanm 0:9b334a45a8ff 341 tmp = LESENSE->TIMCTRL & ~(_LESENSE_TIMCTRL_STARTDLY_MASK);
bogdanm 0:9b334a45a8ff 342 /* Setting the requested startDelay to the TIMCTRL register. */
bogdanm 0:9b334a45a8ff 343 tmp |= (uint32_t)startDelay << _LESENSE_TIMCTRL_STARTDLY_SHIFT;
bogdanm 0:9b334a45a8ff 344
bogdanm 0:9b334a45a8ff 345 /* Write the new value to the TIMCTRL register. */
bogdanm 0:9b334a45a8ff 346 LESENSE->TIMCTRL = tmp;
bogdanm 0:9b334a45a8ff 347 }
bogdanm 0:9b334a45a8ff 348
bogdanm 0:9b334a45a8ff 349
bogdanm 0:9b334a45a8ff 350 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 351 * @brief
bogdanm 0:9b334a45a8ff 352 * Set clock division for LESENSE timers.
bogdanm 0:9b334a45a8ff 353 *
bogdanm 0:9b334a45a8ff 354 * @details
bogdanm 0:9b334a45a8ff 355 * Use this function to configure the clock division for the LESENSE timers
bogdanm 0:9b334a45a8ff 356 * used for excitation timing.
bogdanm 0:9b334a45a8ff 357 * The division setting is global, but the clock source can be selected for
bogdanm 0:9b334a45a8ff 358 * each channel using LESENSE_ChannelConfig() function, please refer to the
bogdanm 0:9b334a45a8ff 359 * documentation of it for more details.
bogdanm 0:9b334a45a8ff 360 *
bogdanm 0:9b334a45a8ff 361 * @note
bogdanm 0:9b334a45a8ff 362 * If AUXHFRCO is used for excitation timing, LFACLK can not exceed 500kHz.
bogdanm 0:9b334a45a8ff 363 * LFACLK can not exceed 50kHz if the ACMP threshold level (ACMPTHRES) is not
bogdanm 0:9b334a45a8ff 364 * equal for all channels.
bogdanm 0:9b334a45a8ff 365 *
bogdanm 0:9b334a45a8ff 366 * @param[in] clk
bogdanm 0:9b334a45a8ff 367 * Select clock to prescale.
bogdanm 0:9b334a45a8ff 368 * @li lesenseClkHF - set AUXHFRCO clock divisor for HF timer.
bogdanm 0:9b334a45a8ff 369 * @li lesenseClkLF - set LFACLKles clock divisor for LF timer.
bogdanm 0:9b334a45a8ff 370 *
bogdanm 0:9b334a45a8ff 371 * @param[in] clkDiv
bogdanm 0:9b334a45a8ff 372 * Clock divisor value. Valid range depends on the @p clk value.
bogdanm 0:9b334a45a8ff 373 ******************************************************************************/
bogdanm 0:9b334a45a8ff 374 void LESENSE_ClkDivSet(LESENSE_ChClk_TypeDef const clk,
bogdanm 0:9b334a45a8ff 375 LESENSE_ClkPresc_TypeDef const clkDiv)
bogdanm 0:9b334a45a8ff 376 {
bogdanm 0:9b334a45a8ff 377 uint32_t tmp;
bogdanm 0:9b334a45a8ff 378
bogdanm 0:9b334a45a8ff 379
bogdanm 0:9b334a45a8ff 380 /* Select clock to prescale */
bogdanm 0:9b334a45a8ff 381 switch (clk)
bogdanm 0:9b334a45a8ff 382 {
mbed_official 50:a417edff4437 383 case lesenseClkHF:
mbed_official 50:a417edff4437 384 /* Sanity check of clock divisor for HF clock. */
mbed_official 50:a417edff4437 385 EFM_ASSERT((uint32_t)clkDiv <= lesenseClkDiv_8);
bogdanm 0:9b334a45a8ff 386
mbed_official 50:a417edff4437 387 /* Clear current AUXPRESC settings. */
mbed_official 50:a417edff4437 388 tmp = LESENSE->TIMCTRL & ~(_LESENSE_TIMCTRL_AUXPRESC_MASK);
bogdanm 0:9b334a45a8ff 389
mbed_official 50:a417edff4437 390 /* Set new values in tmp while reserving other settings. */
mbed_official 50:a417edff4437 391 tmp |= ((uint32_t)clkDiv << _LESENSE_TIMCTRL_AUXPRESC_SHIFT);
bogdanm 0:9b334a45a8ff 392
mbed_official 50:a417edff4437 393 /* Set values in LESENSE_TIMCTRL register. */
mbed_official 50:a417edff4437 394 LESENSE->TIMCTRL = tmp;
mbed_official 50:a417edff4437 395 break;
bogdanm 0:9b334a45a8ff 396
mbed_official 50:a417edff4437 397 case lesenseClkLF:
mbed_official 50:a417edff4437 398 /* Clear current LFPRESC settings. */
mbed_official 50:a417edff4437 399 tmp = LESENSE->TIMCTRL & ~(_LESENSE_TIMCTRL_LFPRESC_MASK);
bogdanm 0:9b334a45a8ff 400
mbed_official 50:a417edff4437 401 /* Set new values in tmp while reserving other settings. */
mbed_official 50:a417edff4437 402 tmp |= ((uint32_t)clkDiv << _LESENSE_TIMCTRL_LFPRESC_SHIFT);
bogdanm 0:9b334a45a8ff 403
mbed_official 50:a417edff4437 404 /* Set values in LESENSE_TIMCTRL register. */
mbed_official 50:a417edff4437 405 LESENSE->TIMCTRL = tmp;
mbed_official 50:a417edff4437 406 break;
bogdanm 0:9b334a45a8ff 407
mbed_official 50:a417edff4437 408 default:
mbed_official 50:a417edff4437 409 EFM_ASSERT(0);
mbed_official 50:a417edff4437 410 break;
bogdanm 0:9b334a45a8ff 411 }
bogdanm 0:9b334a45a8ff 412 }
bogdanm 0:9b334a45a8ff 413
bogdanm 0:9b334a45a8ff 414
bogdanm 0:9b334a45a8ff 415 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 416 * @brief
bogdanm 0:9b334a45a8ff 417 * Configure all (16) LESENSE sensor channels.
bogdanm 0:9b334a45a8ff 418 *
bogdanm 0:9b334a45a8ff 419 * @details
bogdanm 0:9b334a45a8ff 420 * This function configures all the sensor channels of LESENSE interface.
bogdanm 0:9b334a45a8ff 421 * Please refer to the configuration parameter type definition
bogdanm 0:9b334a45a8ff 422 * (LESENSE_ChAll_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 423 *
bogdanm 0:9b334a45a8ff 424 * @note
bogdanm 0:9b334a45a8ff 425 * Channels can be configured individually using LESENSE_ChannelConfig()
bogdanm 0:9b334a45a8ff 426 * function.
bogdanm 0:9b334a45a8ff 427 * Notice that pins used by the LESENSE module must be properly configured
bogdanm 0:9b334a45a8ff 428 * by the user explicitly, in order for the LESENSE to work as intended.
bogdanm 0:9b334a45a8ff 429 * (When configuring pins, one should remember to consider the sequence of
bogdanm 0:9b334a45a8ff 430 * configuration, in order to avoid unintended pulses/glitches on output
bogdanm 0:9b334a45a8ff 431 * pins.)
bogdanm 0:9b334a45a8ff 432 *
bogdanm 0:9b334a45a8ff 433 * @param[in] confChAll
bogdanm 0:9b334a45a8ff 434 * Configuration structure for all (16) LESENSE sensor channels.
bogdanm 0:9b334a45a8ff 435 ******************************************************************************/
bogdanm 0:9b334a45a8ff 436 void LESENSE_ChannelAllConfig(LESENSE_ChAll_TypeDef const *confChAll)
bogdanm 0:9b334a45a8ff 437 {
bogdanm 0:9b334a45a8ff 438 uint32_t i;
bogdanm 0:9b334a45a8ff 439
bogdanm 0:9b334a45a8ff 440 /* Iterate through all the 16 channels */
bogdanm 0:9b334a45a8ff 441 for (i = 0U; i < 16U; ++i)
bogdanm 0:9b334a45a8ff 442 {
bogdanm 0:9b334a45a8ff 443 /* Configure scan channels. */
bogdanm 0:9b334a45a8ff 444 LESENSE_ChannelConfig(&confChAll->Ch[i], i);
bogdanm 0:9b334a45a8ff 445 }
bogdanm 0:9b334a45a8ff 446 }
bogdanm 0:9b334a45a8ff 447
bogdanm 0:9b334a45a8ff 448
bogdanm 0:9b334a45a8ff 449 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 450 * @brief
bogdanm 0:9b334a45a8ff 451 * Configure a single LESENSE sensor channel.
bogdanm 0:9b334a45a8ff 452 *
bogdanm 0:9b334a45a8ff 453 * @details
bogdanm 0:9b334a45a8ff 454 * This function configures a single sensor channel of the LESENSE interface.
bogdanm 0:9b334a45a8ff 455 * Please refer to the configuration parameter type definition
bogdanm 0:9b334a45a8ff 456 * (LESENSE_ChDesc_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 457 *
bogdanm 0:9b334a45a8ff 458 * @note
bogdanm 0:9b334a45a8ff 459 * This function has been designed to minimize the effects of sensor channel
bogdanm 0:9b334a45a8ff 460 * reconfiguration while LESENSE is in operation, however one shall be aware
bogdanm 0:9b334a45a8ff 461 * of these effects and the right timing of calling this function.
bogdanm 0:9b334a45a8ff 462 * Parameter @p useAltEx must be true in the channel configuration in order to
bogdanm 0:9b334a45a8ff 463 * use alternate excitation pins.
bogdanm 0:9b334a45a8ff 464 *
bogdanm 0:9b334a45a8ff 465 * @param[in] confCh
bogdanm 0:9b334a45a8ff 466 * Configuration structure for a single LESENSE sensor channel.
bogdanm 0:9b334a45a8ff 467 *
bogdanm 0:9b334a45a8ff 468 * @param[in] chIdx
bogdanm 0:9b334a45a8ff 469 * Channel index to configure (0-15).
bogdanm 0:9b334a45a8ff 470 ******************************************************************************/
bogdanm 0:9b334a45a8ff 471 void LESENSE_ChannelConfig(LESENSE_ChDesc_TypeDef const *confCh,
bogdanm 0:9b334a45a8ff 472 uint32_t const chIdx)
bogdanm 0:9b334a45a8ff 473 {
bogdanm 0:9b334a45a8ff 474 uint32_t tmp; /* Service variable. */
bogdanm 0:9b334a45a8ff 475
bogdanm 0:9b334a45a8ff 476
bogdanm 0:9b334a45a8ff 477 /* Sanity check of configuration parameters */
bogdanm 0:9b334a45a8ff 478 EFM_ASSERT(chIdx < 16U);
bogdanm 0:9b334a45a8ff 479 EFM_ASSERT(confCh->exTime < 64U);
bogdanm 0:9b334a45a8ff 480 EFM_ASSERT(confCh->sampleDelay < 128U);
bogdanm 0:9b334a45a8ff 481 EFM_ASSERT(confCh->measDelay < 128U);
bogdanm 0:9b334a45a8ff 482 /* Not a complete assert, as the max. value of acmpThres depends on other
bogdanm 0:9b334a45a8ff 483 * configuration parameters, check the parameter description of acmpThres for
bogdanm 0:9b334a45a8ff 484 * for more details! */
bogdanm 0:9b334a45a8ff 485 EFM_ASSERT(confCh->acmpThres < 4096U);
mbed_official 50:a417edff4437 486 EFM_ASSERT(!(confCh->chPinExMode == lesenseChPinExDACOut
mbed_official 50:a417edff4437 487 && (chIdx != 2U)
mbed_official 50:a417edff4437 488 && (chIdx != 3U)
mbed_official 50:a417edff4437 489 && (chIdx != 4U)
mbed_official 50:a417edff4437 490 && (chIdx != 5U)));
mbed_official 50:a417edff4437 491 EFM_ASSERT(!(confCh->chPinIdleMode == lesenseChPinIdleDACCh1
mbed_official 50:a417edff4437 492 && ((chIdx != 12U)
mbed_official 50:a417edff4437 493 && (chIdx != 13U)
mbed_official 50:a417edff4437 494 && (chIdx != 14U)
mbed_official 50:a417edff4437 495 && (chIdx != 15U))));
mbed_official 50:a417edff4437 496 EFM_ASSERT(!(confCh->chPinIdleMode == lesenseChPinIdleDACCh0
mbed_official 50:a417edff4437 497 && ((chIdx != 0U)
mbed_official 50:a417edff4437 498 && (chIdx != 1U)
mbed_official 50:a417edff4437 499 && (chIdx != 2U)
mbed_official 50:a417edff4437 500 && (chIdx != 3U))));
bogdanm 0:9b334a45a8ff 501
bogdanm 0:9b334a45a8ff 502 /* Configure chIdx setup in LESENSE idle phase.
bogdanm 0:9b334a45a8ff 503 * Read-modify-write in order to support reconfiguration during LESENSE
bogdanm 0:9b334a45a8ff 504 * operation. */
bogdanm 0:9b334a45a8ff 505 tmp = (LESENSE->IDLECONF & ~((uint32_t)0x3UL << (chIdx * 2UL)));
bogdanm 0:9b334a45a8ff 506 tmp |= ((uint32_t)confCh->chPinIdleMode << (chIdx * 2UL));
bogdanm 0:9b334a45a8ff 507 LESENSE->IDLECONF = tmp;
bogdanm 0:9b334a45a8ff 508
bogdanm 0:9b334a45a8ff 509 /* Channel specific timing configuration on scan channel chIdx.
bogdanm 0:9b334a45a8ff 510 * Set excitation time, sampling delay, measurement delay. */
bogdanm 0:9b334a45a8ff 511 LESENSE_ChannelTimingSet(chIdx,
bogdanm 0:9b334a45a8ff 512 (uint32_t)confCh->exTime,
bogdanm 0:9b334a45a8ff 513 (uint32_t)confCh->sampleDelay,
bogdanm 0:9b334a45a8ff 514 (uint32_t)confCh->measDelay);
bogdanm 0:9b334a45a8ff 515
bogdanm 0:9b334a45a8ff 516 /* Channel specific configuration of clocks, sample mode, excitation pin mode
bogdanm 0:9b334a45a8ff 517 * alternate excitation usage and interrupt mode on scan channel chIdx in
bogdanm 0:9b334a45a8ff 518 * LESENSE_CHchIdx_INTERACT. */
mbed_official 50:a417edff4437 519 LESENSE->CH[chIdx].INTERACT =
mbed_official 50:a417edff4437 520 ((uint32_t)confCh->exClk << _LESENSE_CH_INTERACT_EXCLK_SHIFT)
mbed_official 50:a417edff4437 521 | ((uint32_t)confCh->sampleClk << _LESENSE_CH_INTERACT_SAMPLECLK_SHIFT)
mbed_official 50:a417edff4437 522 | (uint32_t)confCh->sampleMode
mbed_official 50:a417edff4437 523 | (uint32_t)confCh->intMode
mbed_official 50:a417edff4437 524 | (uint32_t)confCh->chPinExMode
mbed_official 50:a417edff4437 525 | ((uint32_t)confCh->useAltEx << _LESENSE_CH_INTERACT_ALTEX_SHIFT);
bogdanm 0:9b334a45a8ff 526
bogdanm 0:9b334a45a8ff 527 /* Configure channel specific counter comparison mode, optional result
bogdanm 0:9b334a45a8ff 528 * forwarding to decoder, optional counter value storing and optional result
bogdanm 0:9b334a45a8ff 529 * inverting on scan channel chIdx in LESENSE_CHchIdx_EVAL. */
mbed_official 50:a417edff4437 530 LESENSE->CH[chIdx].EVAL =
mbed_official 50:a417edff4437 531 (uint32_t)confCh->compMode
mbed_official 50:a417edff4437 532 | ((uint32_t)confCh->shiftRes << _LESENSE_CH_EVAL_DECODE_SHIFT)
mbed_official 50:a417edff4437 533 | ((uint32_t)confCh->storeCntRes << _LESENSE_CH_EVAL_STRSAMPLE_SHIFT)
mbed_official 50:a417edff4437 534 | ((uint32_t)confCh->invRes << _LESENSE_CH_EVAL_SCANRESINV_SHIFT);
bogdanm 0:9b334a45a8ff 535
bogdanm 0:9b334a45a8ff 536 /* Configure analog comparator (ACMP) threshold and decision threshold for
bogdanm 0:9b334a45a8ff 537 * counter separately with the function provided for that. */
bogdanm 0:9b334a45a8ff 538 LESENSE_ChannelThresSet(chIdx,
bogdanm 0:9b334a45a8ff 539 (uint32_t)confCh->acmpThres,
bogdanm 0:9b334a45a8ff 540 (uint32_t)confCh->cntThres);
bogdanm 0:9b334a45a8ff 541
mbed_official 50:a417edff4437 542 /* Enable/disable interrupts on channel */
mbed_official 50:a417edff4437 543 BUS_RegBitWrite(&(LESENSE->IEN), chIdx, confCh->enaInt);
bogdanm 0:9b334a45a8ff 544
bogdanm 0:9b334a45a8ff 545 /* Enable/disable CHchIdx pin. */
mbed_official 50:a417edff4437 546 BUS_RegBitWrite(&(LESENSE->ROUTE), chIdx, confCh->enaPin);
bogdanm 0:9b334a45a8ff 547
bogdanm 0:9b334a45a8ff 548 /* Enable/disable scan channel chIdx. */
mbed_official 50:a417edff4437 549 BUS_RegBitWrite(&(LESENSE->CHEN), chIdx, confCh->enaScanCh);
bogdanm 0:9b334a45a8ff 550 }
bogdanm 0:9b334a45a8ff 551
bogdanm 0:9b334a45a8ff 552
bogdanm 0:9b334a45a8ff 553 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 554 * @brief
bogdanm 0:9b334a45a8ff 555 * Configure the LESENSE alternate excitation modes.
bogdanm 0:9b334a45a8ff 556 *
bogdanm 0:9b334a45a8ff 557 * @details
bogdanm 0:9b334a45a8ff 558 * This function configures the alternate excitation channels of the LESENSE
bogdanm 0:9b334a45a8ff 559 * interface. Please refer to the configuration parameter type definition
bogdanm 0:9b334a45a8ff 560 * (LESENSE_ConfAltEx_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 561 *
bogdanm 0:9b334a45a8ff 562 * @note
bogdanm 0:9b334a45a8ff 563 * Parameter @p useAltEx must be true in the channel configuration structrure
bogdanm 0:9b334a45a8ff 564 * (LESENSE_ChDesc_TypeDef) in order to use alternate excitation pins on the
bogdanm 0:9b334a45a8ff 565 * channel.
bogdanm 0:9b334a45a8ff 566 *
bogdanm 0:9b334a45a8ff 567 * @param[in] confAltEx
bogdanm 0:9b334a45a8ff 568 * Configuration structure for LESENSE alternate excitation pins.
bogdanm 0:9b334a45a8ff 569 ******************************************************************************/
bogdanm 0:9b334a45a8ff 570 void LESENSE_AltExConfig(LESENSE_ConfAltEx_TypeDef const *confAltEx)
bogdanm 0:9b334a45a8ff 571 {
bogdanm 0:9b334a45a8ff 572 uint32_t i;
bogdanm 0:9b334a45a8ff 573 uint32_t tmp;
bogdanm 0:9b334a45a8ff 574
bogdanm 0:9b334a45a8ff 575
bogdanm 0:9b334a45a8ff 576 /* Configure alternate excitation mapping.
mbed_official 50:a417edff4437 577 * Atomic read-modify-write using BUS_RegBitWrite function in order to
bogdanm 0:9b334a45a8ff 578 * support reconfiguration during LESENSE operation. */
mbed_official 50:a417edff4437 579 BUS_RegBitWrite(&(LESENSE->CTRL),
mbed_official 50:a417edff4437 580 _LESENSE_CTRL_ALTEXMAP_SHIFT,
mbed_official 50:a417edff4437 581 confAltEx->altExMap);
bogdanm 0:9b334a45a8ff 582
bogdanm 0:9b334a45a8ff 583 switch (confAltEx->altExMap)
bogdanm 0:9b334a45a8ff 584 {
mbed_official 50:a417edff4437 585 case lesenseAltExMapALTEX:
mbed_official 50:a417edff4437 586 /* Iterate through the 8 possible alternate excitation pin descriptors. */
mbed_official 50:a417edff4437 587 for (i = 0U; i < 8U; ++i)
mbed_official 50:a417edff4437 588 {
mbed_official 50:a417edff4437 589 /* Enable/disable alternate excitation pin i.
mbed_official 50:a417edff4437 590 * Atomic read-modify-write using BUS_RegBitWrite function in order to
mbed_official 50:a417edff4437 591 * support reconfiguration during LESENSE operation. */
mbed_official 50:a417edff4437 592 BUS_RegBitWrite(&(LESENSE->ROUTE),
mbed_official 50:a417edff4437 593 (16UL + i),
mbed_official 50:a417edff4437 594 confAltEx->AltEx[i].enablePin);
mbed_official 50:a417edff4437 595
mbed_official 50:a417edff4437 596 /* Setup the idle phase state of alternate excitation pin i.
mbed_official 50:a417edff4437 597 * Read-modify-write in order to support reconfiguration during LESENSE
mbed_official 50:a417edff4437 598 * operation. */
mbed_official 50:a417edff4437 599 tmp = (LESENSE->ALTEXCONF & ~((uint32_t)0x3UL << (i * 2UL)));
mbed_official 50:a417edff4437 600 tmp |= ((uint32_t)confAltEx->AltEx[i].idleConf << (i * 2UL));
mbed_official 50:a417edff4437 601 LESENSE->ALTEXCONF = tmp;
bogdanm 0:9b334a45a8ff 602
mbed_official 50:a417edff4437 603 /* Enable/disable always excite on channel i */
mbed_official 50:a417edff4437 604 BUS_RegBitWrite(&(LESENSE->ALTEXCONF),
mbed_official 50:a417edff4437 605 (16UL + i),
mbed_official 50:a417edff4437 606 confAltEx->AltEx[i].alwaysEx);
mbed_official 50:a417edff4437 607 }
mbed_official 50:a417edff4437 608 break;
mbed_official 50:a417edff4437 609
mbed_official 50:a417edff4437 610 case lesenseAltExMapACMP:
mbed_official 50:a417edff4437 611 /* Iterate through all the 16 alternate excitation channels */
mbed_official 50:a417edff4437 612 for (i = 0U; i < 16U; ++i)
mbed_official 50:a417edff4437 613 {
mbed_official 50:a417edff4437 614 /* Enable/disable alternate ACMP excitation channel pin i. */
mbed_official 50:a417edff4437 615 /* Atomic read-modify-write using BUS_RegBitWrite function in order to
mbed_official 50:a417edff4437 616 * support reconfiguration during LESENSE operation. */
mbed_official 50:a417edff4437 617 BUS_RegBitWrite(&(LESENSE->ROUTE),
mbed_official 50:a417edff4437 618 i,
mbed_official 50:a417edff4437 619 confAltEx->AltEx[i].enablePin);
mbed_official 50:a417edff4437 620 }
mbed_official 50:a417edff4437 621 break;
mbed_official 50:a417edff4437 622 default:
mbed_official 50:a417edff4437 623 /* Illegal value. */
mbed_official 50:a417edff4437 624 EFM_ASSERT(0);
mbed_official 50:a417edff4437 625 break;
bogdanm 0:9b334a45a8ff 626 }
bogdanm 0:9b334a45a8ff 627 }
bogdanm 0:9b334a45a8ff 628
bogdanm 0:9b334a45a8ff 629
bogdanm 0:9b334a45a8ff 630 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 631 * @brief
bogdanm 0:9b334a45a8ff 632 * Enable/disable LESENSE scan channel and the pin assigned to it.
bogdanm 0:9b334a45a8ff 633 *
bogdanm 0:9b334a45a8ff 634 * @details
bogdanm 0:9b334a45a8ff 635 * Use this function to enable/disable a selected LESENSE scan channel and the
bogdanm 0:9b334a45a8ff 636 * pin assigned to.
bogdanm 0:9b334a45a8ff 637 *
bogdanm 0:9b334a45a8ff 638 * @note
bogdanm 0:9b334a45a8ff 639 * Users can enable/disable scan channels and the channel pin by
bogdanm 0:9b334a45a8ff 640 * LESENSE_ChannelConfig() function, but only with a significant overhead.
bogdanm 0:9b334a45a8ff 641 * This simple function serves the purpose of controlling these parameters
bogdanm 0:9b334a45a8ff 642 * after the channel has been configured.
bogdanm 0:9b334a45a8ff 643 *
bogdanm 0:9b334a45a8ff 644 * @param[in] chIdx
bogdanm 0:9b334a45a8ff 645 * Identifier of the scan channel. Valid range: 0-15.
bogdanm 0:9b334a45a8ff 646 *
bogdanm 0:9b334a45a8ff 647 * @param[in] enaScanCh
bogdanm 0:9b334a45a8ff 648 * Enable/disable the selected scan channel by setting this parameter to
bogdanm 0:9b334a45a8ff 649 * true/false respectively.
bogdanm 0:9b334a45a8ff 650 *
bogdanm 0:9b334a45a8ff 651 * @param[in] enaPin
bogdanm 0:9b334a45a8ff 652 * Enable/disable the pin assigned to the channel selected by @p chIdx.
bogdanm 0:9b334a45a8ff 653 ******************************************************************************/
bogdanm 0:9b334a45a8ff 654 void LESENSE_ChannelEnable(uint8_t const chIdx,
bogdanm 0:9b334a45a8ff 655 bool const enaScanCh,
bogdanm 0:9b334a45a8ff 656 bool const enaPin)
bogdanm 0:9b334a45a8ff 657 {
bogdanm 0:9b334a45a8ff 658 /* Enable/disable the assigned pin of scan channel chIdx.
mbed_official 50:a417edff4437 659 * Note: BUS_RegBitWrite() function is used for setting/clearing single
bogdanm 0:9b334a45a8ff 660 * bit peripheral register bitfields. Read the function description in
mbed_official 50:a417edff4437 661 * em_bus.h for more details. */
mbed_official 50:a417edff4437 662 BUS_RegBitWrite(&(LESENSE->ROUTE), chIdx, enaPin);
bogdanm 0:9b334a45a8ff 663
bogdanm 0:9b334a45a8ff 664 /* Enable/disable scan channel chIdx. */
mbed_official 50:a417edff4437 665 BUS_RegBitWrite(&(LESENSE->CHEN), chIdx, enaScanCh);
bogdanm 0:9b334a45a8ff 666 }
bogdanm 0:9b334a45a8ff 667
bogdanm 0:9b334a45a8ff 668
bogdanm 0:9b334a45a8ff 669 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 670 * @brief
bogdanm 0:9b334a45a8ff 671 * Enable/disable LESENSE scan channel and the pin assigned to it.
bogdanm 0:9b334a45a8ff 672 *
bogdanm 0:9b334a45a8ff 673 * @details
bogdanm 0:9b334a45a8ff 674 * Use this function to enable/disable LESENSE scan channels and the pins
bogdanm 0:9b334a45a8ff 675 * assigned to them using a mask.
bogdanm 0:9b334a45a8ff 676 *
bogdanm 0:9b334a45a8ff 677 * @note
bogdanm 0:9b334a45a8ff 678 * Users can enable/disable scan channels and channel pins by using
bogdanm 0:9b334a45a8ff 679 * LESENSE_ChannelAllConfig() function, but only with a significant overhead.
bogdanm 0:9b334a45a8ff 680 * This simple function serves the purpose of controlling these parameters
bogdanm 0:9b334a45a8ff 681 * after the channel has been configured.
bogdanm 0:9b334a45a8ff 682 *
bogdanm 0:9b334a45a8ff 683 * @param[in] chMask
bogdanm 0:9b334a45a8ff 684 * Set the corresponding bit to 1 to enable, 0 to disable the selected scan
bogdanm 0:9b334a45a8ff 685 * channel.
bogdanm 0:9b334a45a8ff 686 *
bogdanm 0:9b334a45a8ff 687 * @param[in] pinMask
bogdanm 0:9b334a45a8ff 688 * Set the corresponding bit to 1 to enable, 0 to disable the pin on selected
bogdanm 0:9b334a45a8ff 689 * channel.
bogdanm 0:9b334a45a8ff 690 ******************************************************************************/
bogdanm 0:9b334a45a8ff 691 void LESENSE_ChannelEnableMask(uint16_t chMask, uint16_t pinMask)
bogdanm 0:9b334a45a8ff 692 {
bogdanm 0:9b334a45a8ff 693 /* Enable/disable all channels at once according to the mask. */
bogdanm 0:9b334a45a8ff 694 LESENSE->CHEN = chMask;
bogdanm 0:9b334a45a8ff 695 /* Enable/disable all channel pins at once according to the mask. */
bogdanm 0:9b334a45a8ff 696 LESENSE->ROUTE = pinMask;
bogdanm 0:9b334a45a8ff 697 }
bogdanm 0:9b334a45a8ff 698
bogdanm 0:9b334a45a8ff 699
bogdanm 0:9b334a45a8ff 700 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 701 * @brief
bogdanm 0:9b334a45a8ff 702 * Set LESENSE channel timing parameters.
bogdanm 0:9b334a45a8ff 703 *
bogdanm 0:9b334a45a8ff 704 * @details
bogdanm 0:9b334a45a8ff 705 * Use this function to set timing parameters on a selected LESENSE channel.
bogdanm 0:9b334a45a8ff 706 *
bogdanm 0:9b334a45a8ff 707 * @note
bogdanm 0:9b334a45a8ff 708 * Users can configure the channel timing parameters by
bogdanm 0:9b334a45a8ff 709 * LESENSE_ChannelConfig() function, but only with a significant overhead.
bogdanm 0:9b334a45a8ff 710 * This simple function serves the purpose of controlling these parameters
bogdanm 0:9b334a45a8ff 711 * after the channel has been configured.
bogdanm 0:9b334a45a8ff 712 *
bogdanm 0:9b334a45a8ff 713 * @param[in] chIdx
bogdanm 0:9b334a45a8ff 714 * Identifier of the scan channel. Valid range: 0-15.
bogdanm 0:9b334a45a8ff 715 *
bogdanm 0:9b334a45a8ff 716 * @param[in] exTime
bogdanm 0:9b334a45a8ff 717 * Excitation time on chIdx. Excitation will last exTime+1 excitation clock
bogdanm 0:9b334a45a8ff 718 * cycles. Valid range: 0-63 (6 bits).
bogdanm 0:9b334a45a8ff 719 *
bogdanm 0:9b334a45a8ff 720 * @param[in] sampleDelay
bogdanm 0:9b334a45a8ff 721 * Sample delay on chIdx. Sampling will occur after sampleDelay+1 sample clock
bogdanm 0:9b334a45a8ff 722 * cycles. Valid range: 0-127 (7 bits).
bogdanm 0:9b334a45a8ff 723 *
bogdanm 0:9b334a45a8ff 724 * @param[in] measDelay
bogdanm 0:9b334a45a8ff 725 * Measure delay on chIdx. Sensor measuring is delayed for measDelay+1
bogdanm 0:9b334a45a8ff 726 * excitation clock cycles. Valid range: 0-127 (7 bits).
bogdanm 0:9b334a45a8ff 727 ******************************************************************************/
bogdanm 0:9b334a45a8ff 728 void LESENSE_ChannelTimingSet(uint8_t const chIdx,
bogdanm 0:9b334a45a8ff 729 uint8_t const exTime,
bogdanm 0:9b334a45a8ff 730 uint8_t const sampleDelay,
bogdanm 0:9b334a45a8ff 731 uint8_t const measDelay)
bogdanm 0:9b334a45a8ff 732 {
bogdanm 0:9b334a45a8ff 733 /* Sanity check of parameters. */
bogdanm 0:9b334a45a8ff 734 EFM_ASSERT(exTime < 64U);
bogdanm 0:9b334a45a8ff 735 EFM_ASSERT(sampleDelay < 128U);
bogdanm 0:9b334a45a8ff 736 EFM_ASSERT(measDelay < 128U);
bogdanm 0:9b334a45a8ff 737
bogdanm 0:9b334a45a8ff 738 /* Channel specific timing configuration on scan channel chIdx.
bogdanm 0:9b334a45a8ff 739 * Setting excitation time, sampling delay, measurement delay. */
mbed_official 50:a417edff4437 740 LESENSE->CH[chIdx].TIMING =
mbed_official 50:a417edff4437 741 ((uint32_t)exTime << _LESENSE_CH_TIMING_EXTIME_SHIFT)
mbed_official 50:a417edff4437 742 | ((uint32_t)sampleDelay << _LESENSE_CH_TIMING_SAMPLEDLY_SHIFT)
mbed_official 50:a417edff4437 743 | ((uint32_t)measDelay << _LESENSE_CH_TIMING_MEASUREDLY_SHIFT);
bogdanm 0:9b334a45a8ff 744 }
bogdanm 0:9b334a45a8ff 745
bogdanm 0:9b334a45a8ff 746
bogdanm 0:9b334a45a8ff 747 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 748 * @brief
bogdanm 0:9b334a45a8ff 749 * Set LESENSE channel threshold parameters.
bogdanm 0:9b334a45a8ff 750 *
bogdanm 0:9b334a45a8ff 751 * @details
bogdanm 0:9b334a45a8ff 752 * Use this function to set threshold parameters on a selected LESENSE
bogdanm 0:9b334a45a8ff 753 * channel.
bogdanm 0:9b334a45a8ff 754 *
bogdanm 0:9b334a45a8ff 755 * @note
bogdanm 0:9b334a45a8ff 756 * Users can configure the channel threshold parameters by
bogdanm 0:9b334a45a8ff 757 * LESENSE_ChannelConfig() function, but only with a significant overhead.
bogdanm 0:9b334a45a8ff 758 * This simple function serves the purpose of controlling these parameters
bogdanm 0:9b334a45a8ff 759 * after the channel has been configured.
bogdanm 0:9b334a45a8ff 760 *
bogdanm 0:9b334a45a8ff 761 * @param[in] chIdx
bogdanm 0:9b334a45a8ff 762 * Identifier of the scan channel. Valid range: 0-15.
bogdanm 0:9b334a45a8ff 763 *
bogdanm 0:9b334a45a8ff 764 * @param[in] acmpThres
bogdanm 0:9b334a45a8ff 765 * ACMP threshold.
bogdanm 0:9b334a45a8ff 766 * @li If perCtrl.dacCh0Data or perCtrl.dacCh1Data is set to
bogdanm 0:9b334a45a8ff 767 * #lesenseDACIfData, acmpThres defines the 12-bit DAC data in the
bogdanm 0:9b334a45a8ff 768 * corresponding data register of the DAC interface (DACn_CH0DATA and
bogdanm 0:9b334a45a8ff 769 * DACn_CH1DATA). In this case, the valid range is: 0-4095 (12 bits).
bogdanm 0:9b334a45a8ff 770 *
bogdanm 0:9b334a45a8ff 771 * @li If perCtrl.dacCh0Data or perCtrl.dacCh1Data is set to
bogdanm 0:9b334a45a8ff 772 * #lesenseACMPThres, acmpThres defines the 6-bit Vdd scaling factor of ACMP
bogdanm 0:9b334a45a8ff 773 * negative input (VDDLEVEL in ACMP_INPUTSEL register). In this case, the
bogdanm 0:9b334a45a8ff 774 * valid range is: 0-63 (6 bits).
bogdanm 0:9b334a45a8ff 775 *
bogdanm 0:9b334a45a8ff 776 * @param[in] cntThres
bogdanm 0:9b334a45a8ff 777 * Decision threshold for counter comparison.
bogdanm 0:9b334a45a8ff 778 * Valid range: 0-65535 (16 bits).
bogdanm 0:9b334a45a8ff 779 ******************************************************************************/
bogdanm 0:9b334a45a8ff 780 void LESENSE_ChannelThresSet(uint8_t const chIdx,
bogdanm 0:9b334a45a8ff 781 uint16_t const acmpThres,
bogdanm 0:9b334a45a8ff 782 uint16_t const cntThres)
bogdanm 0:9b334a45a8ff 783 {
bogdanm 0:9b334a45a8ff 784 uint32_t tmp; /* temporary storage */
bogdanm 0:9b334a45a8ff 785
bogdanm 0:9b334a45a8ff 786
bogdanm 0:9b334a45a8ff 787 /* Sanity check for acmpThres only, cntThres is 16bit value. */
bogdanm 0:9b334a45a8ff 788 EFM_ASSERT(acmpThres < 4096U);
bogdanm 0:9b334a45a8ff 789 /* Sanity check for LESENSE channel id. */
bogdanm 0:9b334a45a8ff 790 EFM_ASSERT(chIdx < 16);
bogdanm 0:9b334a45a8ff 791
bogdanm 0:9b334a45a8ff 792 /* Save the INTERACT register value of channel chIdx to tmp.
bogdanm 0:9b334a45a8ff 793 * Please be aware the effects of the non-atomic Read-Modify-Write cycle! */
bogdanm 0:9b334a45a8ff 794 tmp = LESENSE->CH[chIdx].INTERACT & ~(_LESENSE_CH_INTERACT_ACMPTHRES_MASK);
bogdanm 0:9b334a45a8ff 795 /* Set the ACMP threshold value to the INTERACT register of channel chIdx. */
bogdanm 0:9b334a45a8ff 796 tmp |= (uint32_t)acmpThres << _LESENSE_CH_INTERACT_ACMPTHRES_SHIFT;
bogdanm 0:9b334a45a8ff 797 /* Write the new value to the INTERACT register. */
bogdanm 0:9b334a45a8ff 798 LESENSE->CH[chIdx].INTERACT = tmp;
bogdanm 0:9b334a45a8ff 799
bogdanm 0:9b334a45a8ff 800 /* Save the EVAL register value of channel chIdx to tmp.
bogdanm 0:9b334a45a8ff 801 * Please be aware the effects of the non-atomic Read-Modify-Write cycle! */
bogdanm 0:9b334a45a8ff 802 tmp = LESENSE->CH[chIdx].EVAL & ~(_LESENSE_CH_EVAL_COMPTHRES_MASK);
bogdanm 0:9b334a45a8ff 803 /* Set the counter threshold value to the INTERACT register of channel chIdx. */
bogdanm 0:9b334a45a8ff 804 tmp |= (uint32_t)cntThres << _LESENSE_CH_EVAL_COMPTHRES_SHIFT;
bogdanm 0:9b334a45a8ff 805 /* Write the new value to the EVAL register. */
bogdanm 0:9b334a45a8ff 806 LESENSE->CH[chIdx].EVAL = tmp;
bogdanm 0:9b334a45a8ff 807 }
bogdanm 0:9b334a45a8ff 808
bogdanm 0:9b334a45a8ff 809
bogdanm 0:9b334a45a8ff 810 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 811 * @brief
bogdanm 0:9b334a45a8ff 812 * Configure all LESENSE decoder states.
bogdanm 0:9b334a45a8ff 813 *
bogdanm 0:9b334a45a8ff 814 * @details
bogdanm 0:9b334a45a8ff 815 * This function configures all the decoder states of the LESENSE interface.
bogdanm 0:9b334a45a8ff 816 * Please refer to the configuration parameter type definition
bogdanm 0:9b334a45a8ff 817 * (LESENSE_DecStAll_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 818 *
bogdanm 0:9b334a45a8ff 819 * @note
bogdanm 0:9b334a45a8ff 820 * Decoder states can be configured individually using
bogdanm 0:9b334a45a8ff 821 * LESENSE_DecoderStateConfig() function.
bogdanm 0:9b334a45a8ff 822 *
bogdanm 0:9b334a45a8ff 823 * @param[in] confDecStAll
bogdanm 0:9b334a45a8ff 824 * Configuration structure for all (16) LESENSE decoder states.
bogdanm 0:9b334a45a8ff 825 ******************************************************************************/
bogdanm 0:9b334a45a8ff 826 void LESENSE_DecoderStateAllConfig(LESENSE_DecStAll_TypeDef const *confDecStAll)
bogdanm 0:9b334a45a8ff 827 {
bogdanm 0:9b334a45a8ff 828 uint32_t i;
bogdanm 0:9b334a45a8ff 829
bogdanm 0:9b334a45a8ff 830 /* Iterate through all the 16 decoder states. */
bogdanm 0:9b334a45a8ff 831 for (i = 0U; i < 16U; ++i)
bogdanm 0:9b334a45a8ff 832 {
bogdanm 0:9b334a45a8ff 833 /* Configure decoder state i. */
bogdanm 0:9b334a45a8ff 834 LESENSE_DecoderStateConfig(&confDecStAll->St[i], i);
bogdanm 0:9b334a45a8ff 835 }
bogdanm 0:9b334a45a8ff 836 }
bogdanm 0:9b334a45a8ff 837
bogdanm 0:9b334a45a8ff 838
bogdanm 0:9b334a45a8ff 839 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 840 * @brief
bogdanm 0:9b334a45a8ff 841 * Configure a single LESENSE decoder state.
bogdanm 0:9b334a45a8ff 842 *
bogdanm 0:9b334a45a8ff 843 * @details
bogdanm 0:9b334a45a8ff 844 * This function configures a single decoder state of the LESENSE interface.
bogdanm 0:9b334a45a8ff 845 * Please refer to the configuration parameter type definition
bogdanm 0:9b334a45a8ff 846 * (LESENSE_DecStDesc_TypeDef) for more details.
bogdanm 0:9b334a45a8ff 847 *
bogdanm 0:9b334a45a8ff 848 * @param[in] confDecSt
bogdanm 0:9b334a45a8ff 849 * Configuration structure for a single LESENSE decoder state.
bogdanm 0:9b334a45a8ff 850 *
bogdanm 0:9b334a45a8ff 851 * @param[in] decSt
bogdanm 0:9b334a45a8ff 852 * Decoder state index to configure (0-15).
bogdanm 0:9b334a45a8ff 853 ******************************************************************************/
bogdanm 0:9b334a45a8ff 854 void LESENSE_DecoderStateConfig(LESENSE_DecStDesc_TypeDef const *confDecSt,
bogdanm 0:9b334a45a8ff 855 uint32_t const decSt)
bogdanm 0:9b334a45a8ff 856 {
bogdanm 0:9b334a45a8ff 857 /* Sanity check of configuration parameters */
bogdanm 0:9b334a45a8ff 858 EFM_ASSERT(decSt < 16U);
bogdanm 0:9b334a45a8ff 859 EFM_ASSERT((uint32_t)confDecSt->confA.compMask < 16U);
bogdanm 0:9b334a45a8ff 860 EFM_ASSERT((uint32_t)confDecSt->confA.compVal < 16U);
bogdanm 0:9b334a45a8ff 861 EFM_ASSERT((uint32_t)confDecSt->confA.nextState < 16U);
bogdanm 0:9b334a45a8ff 862 EFM_ASSERT((uint32_t)confDecSt->confB.compMask < 16U);
bogdanm 0:9b334a45a8ff 863 EFM_ASSERT((uint32_t)confDecSt->confB.compVal < 16U);
bogdanm 0:9b334a45a8ff 864 EFM_ASSERT((uint32_t)confDecSt->confB.nextState < 16U);
bogdanm 0:9b334a45a8ff 865
bogdanm 0:9b334a45a8ff 866 /* Configure state descriptor A (LESENSE_STi_TCONFA) for decoder state i.
bogdanm 0:9b334a45a8ff 867 * Setting sensor compare value, sensor mask, next state index,
bogdanm 0:9b334a45a8ff 868 * transition action, interrupt flag option and state descriptor chaining
bogdanm 0:9b334a45a8ff 869 * configurations. */
mbed_official 50:a417edff4437 870 LESENSE->ST[decSt].TCONFA =
mbed_official 50:a417edff4437 871 (uint32_t)confDecSt->confA.prsAct
mbed_official 50:a417edff4437 872 | ((uint32_t)confDecSt->confA.compMask << _LESENSE_ST_TCONFA_MASK_SHIFT)
mbed_official 50:a417edff4437 873 | ((uint32_t)confDecSt->confA.compVal << _LESENSE_ST_TCONFA_COMP_SHIFT)
mbed_official 50:a417edff4437 874 | ((uint32_t)confDecSt->confA.nextState << _LESENSE_ST_TCONFA_NEXTSTATE_SHIFT)
mbed_official 50:a417edff4437 875 | ((uint32_t)confDecSt->confA.setInt << _LESENSE_ST_TCONFA_SETIF_SHIFT)
mbed_official 50:a417edff4437 876 | ((uint32_t)confDecSt->chainDesc << _LESENSE_ST_TCONFA_CHAIN_SHIFT);
bogdanm 0:9b334a45a8ff 877
bogdanm 0:9b334a45a8ff 878 /* Configure state descriptor Bi (LESENSE_STi_TCONFB).
bogdanm 0:9b334a45a8ff 879 * Setting sensor compare value, sensor mask, next state index, transition
bogdanm 0:9b334a45a8ff 880 * action and interrupt flag option configurations. */
mbed_official 50:a417edff4437 881 LESENSE->ST[decSt].TCONFB =
mbed_official 50:a417edff4437 882 (uint32_t)confDecSt->confB.prsAct
mbed_official 50:a417edff4437 883 | ((uint32_t)confDecSt->confB.compMask << _LESENSE_ST_TCONFB_MASK_SHIFT)
mbed_official 50:a417edff4437 884 | ((uint32_t)confDecSt->confB.compVal << _LESENSE_ST_TCONFB_COMP_SHIFT)
mbed_official 50:a417edff4437 885 | ((uint32_t)confDecSt->confB.nextState << _LESENSE_ST_TCONFB_NEXTSTATE_SHIFT)
mbed_official 50:a417edff4437 886 | ((uint32_t)confDecSt->confB.setInt << _LESENSE_ST_TCONFB_SETIF_SHIFT);
bogdanm 0:9b334a45a8ff 887 }
bogdanm 0:9b334a45a8ff 888
bogdanm 0:9b334a45a8ff 889
bogdanm 0:9b334a45a8ff 890 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 891 * @brief
bogdanm 0:9b334a45a8ff 892 * Set LESENSE decoder state.
bogdanm 0:9b334a45a8ff 893 *
bogdanm 0:9b334a45a8ff 894 * @details
bogdanm 0:9b334a45a8ff 895 * This function can be used for setting the initial state of the LESENSE
bogdanm 0:9b334a45a8ff 896 * decoder.
bogdanm 0:9b334a45a8ff 897 *
bogdanm 0:9b334a45a8ff 898 * @note
bogdanm 0:9b334a45a8ff 899 * Make sure the LESENSE decoder state is initialized by this function before
bogdanm 0:9b334a45a8ff 900 * enabling the decoder!
bogdanm 0:9b334a45a8ff 901 *
bogdanm 0:9b334a45a8ff 902 * @param[in] decSt
bogdanm 0:9b334a45a8ff 903 * Decoder state to set as current state. Valid range: 0-15
bogdanm 0:9b334a45a8ff 904 ******************************************************************************/
bogdanm 0:9b334a45a8ff 905 void LESENSE_DecoderStateSet(uint32_t decSt)
bogdanm 0:9b334a45a8ff 906 {
bogdanm 0:9b334a45a8ff 907 EFM_ASSERT(decSt < 16U);
bogdanm 0:9b334a45a8ff 908
bogdanm 0:9b334a45a8ff 909 LESENSE->DECSTATE = decSt & _LESENSE_DECSTATE_DECSTATE_MASK;
bogdanm 0:9b334a45a8ff 910 }
bogdanm 0:9b334a45a8ff 911
bogdanm 0:9b334a45a8ff 912
bogdanm 0:9b334a45a8ff 913 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 914 * @brief
bogdanm 0:9b334a45a8ff 915 * Get the current state of the LESENSE decoder.
bogdanm 0:9b334a45a8ff 916 *
bogdanm 0:9b334a45a8ff 917 * @return
bogdanm 0:9b334a45a8ff 918 * This function returns the value of LESENSE_DECSTATE register that
bogdanm 0:9b334a45a8ff 919 * represents the current state of the LESENSE decoder.
bogdanm 0:9b334a45a8ff 920 ******************************************************************************/
bogdanm 0:9b334a45a8ff 921 uint32_t LESENSE_DecoderStateGet(void)
bogdanm 0:9b334a45a8ff 922 {
bogdanm 0:9b334a45a8ff 923 return LESENSE->DECSTATE & _LESENSE_DECSTATE_DECSTATE_MASK;
bogdanm 0:9b334a45a8ff 924 }
bogdanm 0:9b334a45a8ff 925
bogdanm 0:9b334a45a8ff 926
bogdanm 0:9b334a45a8ff 927 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 928 * @brief
bogdanm 0:9b334a45a8ff 929 * Start scanning of sensors.
bogdanm 0:9b334a45a8ff 930 *
bogdanm 0:9b334a45a8ff 931 * @note
bogdanm 0:9b334a45a8ff 932 * This function will wait for any pending previous write operation to the
bogdanm 0:9b334a45a8ff 933 * CMD register to complete before accessing the CMD register. It will also
bogdanm 0:9b334a45a8ff 934 * wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 935 * returning. Each write operation to the CMD register may take up to 3 LF
bogdanm 0:9b334a45a8ff 936 * clock cycles, so the user should expect some delay. The user may implement
bogdanm 0:9b334a45a8ff 937 * a separate function to write multiple command bits in the CMD register
mbed_official 50:a417edff4437 938 * in one single operation in order to optimize an application.
bogdanm 0:9b334a45a8ff 939 ******************************************************************************/
bogdanm 0:9b334a45a8ff 940 void LESENSE_ScanStart(void)
bogdanm 0:9b334a45a8ff 941 {
bogdanm 0:9b334a45a8ff 942 /* Wait for any pending previous write operation to the CMD register to
bogdanm 0:9b334a45a8ff 943 complete before accessing the CMD register. */
mbed_official 50:a417edff4437 944 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 945 ;
bogdanm 0:9b334a45a8ff 946
bogdanm 0:9b334a45a8ff 947 /* Start scanning of sensors */
bogdanm 0:9b334a45a8ff 948 LESENSE->CMD = LESENSE_CMD_START;
bogdanm 0:9b334a45a8ff 949
bogdanm 0:9b334a45a8ff 950 /* Wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 951 returning. */
mbed_official 50:a417edff4437 952 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 953 ;
bogdanm 0:9b334a45a8ff 954 }
bogdanm 0:9b334a45a8ff 955
bogdanm 0:9b334a45a8ff 956
bogdanm 0:9b334a45a8ff 957 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 958 * @brief
bogdanm 0:9b334a45a8ff 959 * Stop scanning of sensors.
bogdanm 0:9b334a45a8ff 960 *
bogdanm 0:9b334a45a8ff 961 * @note
bogdanm 0:9b334a45a8ff 962 * This function will wait for any pending previous write operation to the
bogdanm 0:9b334a45a8ff 963 * CMD register to complete before accessing the CMD register. It will also
bogdanm 0:9b334a45a8ff 964 * wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 965 * returning. Each write operation to the CMD register may take up to 3 LF
bogdanm 0:9b334a45a8ff 966 * clock cycles, so the user should expect some delay. The user may implement
bogdanm 0:9b334a45a8ff 967 * a separate function to write multiple command bits in the CMD register
mbed_official 50:a417edff4437 968 * in one single operation in order to optimize an application.
bogdanm 0:9b334a45a8ff 969 *
bogdanm 0:9b334a45a8ff 970 * @note
bogdanm 0:9b334a45a8ff 971 * If issued during a scan, the command takes effect after scan completion.
bogdanm 0:9b334a45a8ff 972 ******************************************************************************/
bogdanm 0:9b334a45a8ff 973 void LESENSE_ScanStop(void)
bogdanm 0:9b334a45a8ff 974 {
bogdanm 0:9b334a45a8ff 975 /* Wait for any pending previous write operation to the CMD register to
bogdanm 0:9b334a45a8ff 976 complete before accessing the CMD register. */
mbed_official 50:a417edff4437 977 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 978 ;
bogdanm 0:9b334a45a8ff 979
bogdanm 0:9b334a45a8ff 980 /* Stop scanning of sensors */
bogdanm 0:9b334a45a8ff 981 LESENSE->CMD = LESENSE_CMD_STOP;
bogdanm 0:9b334a45a8ff 982
bogdanm 0:9b334a45a8ff 983 /* Wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 984 returning. */
mbed_official 50:a417edff4437 985 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 986 ;
bogdanm 0:9b334a45a8ff 987 }
bogdanm 0:9b334a45a8ff 988
bogdanm 0:9b334a45a8ff 989
bogdanm 0:9b334a45a8ff 990 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 991 * @brief
bogdanm 0:9b334a45a8ff 992 * Start LESENSE decoder.
bogdanm 0:9b334a45a8ff 993 *
bogdanm 0:9b334a45a8ff 994 * @note
bogdanm 0:9b334a45a8ff 995 * This function will wait for any pending previous write operation to the
bogdanm 0:9b334a45a8ff 996 * CMD register to complete before accessing the CMD register. It will also
bogdanm 0:9b334a45a8ff 997 * wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 998 * returning. Each write operation to the CMD register may take up to 3 LF
bogdanm 0:9b334a45a8ff 999 * clock cycles, so the user should expect some delay. The user may implement
bogdanm 0:9b334a45a8ff 1000 * a separate function to write multiple command bits in the CMD register
mbed_official 50:a417edff4437 1001 * in one single operation in order to optimize an application.
bogdanm 0:9b334a45a8ff 1002 ******************************************************************************/
bogdanm 0:9b334a45a8ff 1003 void LESENSE_DecoderStart(void)
bogdanm 0:9b334a45a8ff 1004 {
bogdanm 0:9b334a45a8ff 1005 /* Wait for any pending previous write operation to the CMD register to
bogdanm 0:9b334a45a8ff 1006 complete before accessing the CMD register. */
mbed_official 50:a417edff4437 1007 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1008 ;
bogdanm 0:9b334a45a8ff 1009
bogdanm 0:9b334a45a8ff 1010 /* Start decoder */
bogdanm 0:9b334a45a8ff 1011 LESENSE->CMD = LESENSE_CMD_DECODE;
bogdanm 0:9b334a45a8ff 1012
bogdanm 0:9b334a45a8ff 1013 /* Wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 1014 returning. */
mbed_official 50:a417edff4437 1015 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1016 ;
bogdanm 0:9b334a45a8ff 1017 }
bogdanm 0:9b334a45a8ff 1018
bogdanm 0:9b334a45a8ff 1019
bogdanm 0:9b334a45a8ff 1020 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 1021 * @brief
bogdanm 0:9b334a45a8ff 1022 * Clear result buffer.
bogdanm 0:9b334a45a8ff 1023 *
bogdanm 0:9b334a45a8ff 1024 * @note
bogdanm 0:9b334a45a8ff 1025 * This function will wait for any pending previous write operation to the
bogdanm 0:9b334a45a8ff 1026 * CMD register to complete before accessing the CMD register. It will also
bogdanm 0:9b334a45a8ff 1027 * wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 1028 * returning. Each write operation to the CMD register may take up to 3 LF
bogdanm 0:9b334a45a8ff 1029 * clock cycles, so the user should expect some delay. The user may implement
bogdanm 0:9b334a45a8ff 1030 * a separate function to write multiple command bits in the CMD register
mbed_official 50:a417edff4437 1031 * in one single operation in order to optimize an application.
bogdanm 0:9b334a45a8ff 1032 ******************************************************************************/
bogdanm 0:9b334a45a8ff 1033 void LESENSE_ResultBufferClear(void)
bogdanm 0:9b334a45a8ff 1034 {
bogdanm 0:9b334a45a8ff 1035 /* Wait for any pending previous write operation to the CMD register to
bogdanm 0:9b334a45a8ff 1036 complete before accessing the CMD register. */
mbed_official 50:a417edff4437 1037 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1038 ;
bogdanm 0:9b334a45a8ff 1039
bogdanm 0:9b334a45a8ff 1040 LESENSE->CMD = LESENSE_CMD_CLEARBUF;
bogdanm 0:9b334a45a8ff 1041
bogdanm 0:9b334a45a8ff 1042 /* Wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 1043 returning. */
mbed_official 50:a417edff4437 1044 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1045 ;
bogdanm 0:9b334a45a8ff 1046 }
bogdanm 0:9b334a45a8ff 1047
bogdanm 0:9b334a45a8ff 1048
bogdanm 0:9b334a45a8ff 1049 /***************************************************************************//**
bogdanm 0:9b334a45a8ff 1050 * @brief
bogdanm 0:9b334a45a8ff 1051 * Reset the LESENSE module.
bogdanm 0:9b334a45a8ff 1052 *
bogdanm 0:9b334a45a8ff 1053 * @details
bogdanm 0:9b334a45a8ff 1054 * Use this function to reset the LESENSE registers.
bogdanm 0:9b334a45a8ff 1055 *
bogdanm 0:9b334a45a8ff 1056 * @note
bogdanm 0:9b334a45a8ff 1057 * Resetting LESENSE registers is required in each reset or power-on cycle in
bogdanm 0:9b334a45a8ff 1058 * order to configure the default values of the RAM mapped LESENSE registers.
bogdanm 0:9b334a45a8ff 1059 * LESENSE_Reset() can be called on initialization by setting the @p reqReset
bogdanm 0:9b334a45a8ff 1060 * parameter to true in LESENSE_Init().
bogdanm 0:9b334a45a8ff 1061 ******************************************************************************/
bogdanm 0:9b334a45a8ff 1062 void LESENSE_Reset(void)
bogdanm 0:9b334a45a8ff 1063 {
bogdanm 0:9b334a45a8ff 1064 uint32_t i;
bogdanm 0:9b334a45a8ff 1065
bogdanm 0:9b334a45a8ff 1066 /* Disable all LESENSE interrupts first */
bogdanm 0:9b334a45a8ff 1067 LESENSE->IEN = _LESENSE_IEN_RESETVALUE;
bogdanm 0:9b334a45a8ff 1068
bogdanm 0:9b334a45a8ff 1069 /* Clear all pending LESENSE interrupts */
bogdanm 0:9b334a45a8ff 1070 LESENSE->IFC = _LESENSE_IFC_MASK;
bogdanm 0:9b334a45a8ff 1071
bogdanm 0:9b334a45a8ff 1072 /* Stop the decoder */
bogdanm 0:9b334a45a8ff 1073 LESENSE->DECCTRL |= LESENSE_DECCTRL_DISABLE;
bogdanm 0:9b334a45a8ff 1074
bogdanm 0:9b334a45a8ff 1075 /* Wait for any pending previous write operation to the CMD register to
bogdanm 0:9b334a45a8ff 1076 complete before accessing the CMD register. */
mbed_official 50:a417edff4437 1077 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1078 ;
mbed_official 50:a417edff4437 1079
bogdanm 0:9b334a45a8ff 1080 /* Stop sensor scan and clear result buffer */
bogdanm 0:9b334a45a8ff 1081 LESENSE->CMD = (LESENSE_CMD_STOP | LESENSE_CMD_CLEARBUF);
bogdanm 0:9b334a45a8ff 1082
bogdanm 0:9b334a45a8ff 1083 /* Reset LESENSE configuration registers */
bogdanm 0:9b334a45a8ff 1084 LESENSE->CTRL = _LESENSE_CTRL_RESETVALUE;
bogdanm 0:9b334a45a8ff 1085 LESENSE->PERCTRL = _LESENSE_PERCTRL_RESETVALUE;
bogdanm 0:9b334a45a8ff 1086 LESENSE->DECCTRL = _LESENSE_DECCTRL_RESETVALUE;
bogdanm 0:9b334a45a8ff 1087 LESENSE->BIASCTRL = _LESENSE_BIASCTRL_RESETVALUE;
bogdanm 0:9b334a45a8ff 1088 LESENSE->CHEN = _LESENSE_CHEN_RESETVALUE;
bogdanm 0:9b334a45a8ff 1089 LESENSE->IDLECONF = _LESENSE_IDLECONF_RESETVALUE;
bogdanm 0:9b334a45a8ff 1090 LESENSE->ALTEXCONF = _LESENSE_ALTEXCONF_RESETVALUE;
bogdanm 0:9b334a45a8ff 1091
bogdanm 0:9b334a45a8ff 1092 /* Disable LESENSE to control GPIO pins */
bogdanm 0:9b334a45a8ff 1093 LESENSE->ROUTE = _LESENSE_ROUTE_RESETVALUE;
bogdanm 0:9b334a45a8ff 1094
bogdanm 0:9b334a45a8ff 1095 /* Reset all channel configuration registers */
bogdanm 0:9b334a45a8ff 1096 for (i = 0U; i < 16U; ++i)
bogdanm 0:9b334a45a8ff 1097 {
bogdanm 0:9b334a45a8ff 1098 LESENSE->CH[i].TIMING = _LESENSE_CH_TIMING_RESETVALUE;
bogdanm 0:9b334a45a8ff 1099 LESENSE->CH[i].INTERACT = _LESENSE_CH_INTERACT_RESETVALUE;
bogdanm 0:9b334a45a8ff 1100 LESENSE->CH[i].EVAL = _LESENSE_CH_EVAL_RESETVALUE;
bogdanm 0:9b334a45a8ff 1101 }
bogdanm 0:9b334a45a8ff 1102
bogdanm 0:9b334a45a8ff 1103 /* Reset all decoder state configuration registers */
bogdanm 0:9b334a45a8ff 1104 for (i = 0U; i < 16U; ++i)
bogdanm 0:9b334a45a8ff 1105 {
bogdanm 0:9b334a45a8ff 1106 LESENSE->ST[i].TCONFA = _LESENSE_ST_TCONFA_RESETVALUE;
bogdanm 0:9b334a45a8ff 1107 LESENSE->ST[i].TCONFB = _LESENSE_ST_TCONFB_RESETVALUE;
bogdanm 0:9b334a45a8ff 1108 }
mbed_official 50:a417edff4437 1109
bogdanm 0:9b334a45a8ff 1110 /* Wait for the write operation to the CMD register to complete before
bogdanm 0:9b334a45a8ff 1111 returning. */
mbed_official 50:a417edff4437 1112 while (LESENSE_SYNCBUSY_CMD & LESENSE->SYNCBUSY)
mbed_official 50:a417edff4437 1113 ;
bogdanm 0:9b334a45a8ff 1114 }
bogdanm 0:9b334a45a8ff 1115
bogdanm 0:9b334a45a8ff 1116
bogdanm 0:9b334a45a8ff 1117 /** @} (end addtogroup LESENSE) */
bogdanm 0:9b334a45a8ff 1118 /** @} (end addtogroup EM_Library) */
bogdanm 0:9b334a45a8ff 1119
bogdanm 0:9b334a45a8ff 1120 #endif /* defined(LESENSE_COUNT) && (LESENSE_COUNT > 0) */