ST / Mbed 2 deprecated SingleDoubleTap_IKS01A2

Example of single tap and double tap detection for LSM6DSL in X-NUCLEO-IKS01A2

Dependencies:   X_NUCLEO_IKS01A2 mbed

Fork of SingleDoubleTap_IKS01A2 by ST Expansion SW Team

Single and Double Tap Demo Application based on sensor expansion board X-NUCLEO-IKS01A2

Main function is to show how to detect the single and double tap events using the sensor expansion board and send a notification using UART to a connected PC or Desktop and display it on terminal applications like TeraTerm.
After connection has been established:
- the user can try to tap the board and then view the notification using an hyper terminal. When the single tap is detected, the LED is switched on for a while.
- the user can press the user button to pass from the single tap detection to the double tap detection feature. The user can try to double tap the board and then view the notification using an hyper terminal. When the double tap is detected, the LED is switched on twice for a while.
- the user can press again the user button to disable the single and double tap detection feature.
- the user can press the user button to enable again the single tap detection feature and so on.

X_NUCLEO_IKS01A2/Components/LSM6DSLSensor/LSM6DSLSensor.h@2:21a191bd1998, 2016-08-19 (annotated)

Committer:
cparata
Date:
Fri Aug 19 12:31:21 2016 +0000
Revision:
2:21a191bd1998
Child:
4:05f28412d61b
Add interfaces to all components

Who changed what in which revision?

UserRevisionLine numberNew contents of line
cparata 2:21a191bd1998 1 /**
cparata 2:21a191bd1998 2 ******************************************************************************
cparata 2:21a191bd1998 3 * @file LSM6DSLSensor.h
cparata 2:21a191bd1998 4 * @author AST
cparata 2:21a191bd1998 5 * @version V1.0.0
cparata 2:21a191bd1998 6 * @date 5 August 2016
cparata 2:21a191bd1998 7 * @brief Abstract Class of an LSM6DSL Inertial Measurement Unit (IMU) 6 axes
cparata 2:21a191bd1998 8 * sensor.
cparata 2:21a191bd1998 9 ******************************************************************************
cparata 2:21a191bd1998 10 * @attention
cparata 2:21a191bd1998 11 *
cparata 2:21a191bd1998 12 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 2:21a191bd1998 13 *
cparata 2:21a191bd1998 14 * Redistribution and use in source and binary forms, with or without modification,
cparata 2:21a191bd1998 15 * are permitted provided that the following conditions are met:
cparata 2:21a191bd1998 16 * 1. Redistributions of source code must retain the above copyright notice,
cparata 2:21a191bd1998 17 * this list of conditions and the following disclaimer.
cparata 2:21a191bd1998 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 2:21a191bd1998 19 * this list of conditions and the following disclaimer in the documentation
cparata 2:21a191bd1998 20 * and/or other materials provided with the distribution.
cparata 2:21a191bd1998 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 2:21a191bd1998 22 * may be used to endorse or promote products derived from this software
cparata 2:21a191bd1998 23 * without specific prior written permission.
cparata 2:21a191bd1998 24 *
cparata 2:21a191bd1998 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 2:21a191bd1998 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 2:21a191bd1998 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 2:21a191bd1998 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 2:21a191bd1998 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 2:21a191bd1998 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 2:21a191bd1998 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 2:21a191bd1998 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 2:21a191bd1998 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 2:21a191bd1998 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 2:21a191bd1998 35 *
cparata 2:21a191bd1998 36 ******************************************************************************
cparata 2:21a191bd1998 37 */
cparata 2:21a191bd1998 38
cparata 2:21a191bd1998 39
cparata 2:21a191bd1998 40 /* Prevent recursive inclusion -----------------------------------------------*/
cparata 2:21a191bd1998 41
cparata 2:21a191bd1998 42 #ifndef __LSM6DSLSensor_H__
cparata 2:21a191bd1998 43 #define __LSM6DSLSensor_H__
cparata 2:21a191bd1998 44
cparata 2:21a191bd1998 45
cparata 2:21a191bd1998 46 /* Includes ------------------------------------------------------------------*/
cparata 2:21a191bd1998 47
cparata 2:21a191bd1998 48 #include "DevI2C.h"
cparata 2:21a191bd1998 49 #include "LSM6DSL_ACC_GYRO_driver.h"
cparata 2:21a191bd1998 50 #include "MotionSensor.h"
cparata 2:21a191bd1998 51 #include "GyroSensor.h"
cparata 2:21a191bd1998 52
cparata 2:21a191bd1998 53 /* Defines -------------------------------------------------------------------*/
cparata 2:21a191bd1998 54
cparata 2:21a191bd1998 55 #define LSM6DSL_ACC_SENSITIVITY_FOR_FS_2G 0.061 /**< Sensitivity value for 2 g full scale [mg/LSB] */
cparata 2:21a191bd1998 56 #define LSM6DSL_ACC_SENSITIVITY_FOR_FS_4G 0.122 /**< Sensitivity value for 4 g full scale [mg/LSB] */
cparata 2:21a191bd1998 57 #define LSM6DSL_ACC_SENSITIVITY_FOR_FS_8G 0.244 /**< Sensitivity value for 8 g full scale [mg/LSB] */
cparata 2:21a191bd1998 58 #define LSM6DSL_ACC_SENSITIVITY_FOR_FS_16G 0.488 /**< Sensitivity value for 16 g full scale [mg/LSB] */
cparata 2:21a191bd1998 59
cparata 2:21a191bd1998 60 #define LSM6DSL_GYRO_SENSITIVITY_FOR_FS_125DPS 04.375 /**< Sensitivity value for 125 dps full scale [mdps/LSB] */
cparata 2:21a191bd1998 61 #define LSM6DSL_GYRO_SENSITIVITY_FOR_FS_245DPS 08.750 /**< Sensitivity value for 245 dps full scale [mdps/LSB] */
cparata 2:21a191bd1998 62 #define LSM6DSL_GYRO_SENSITIVITY_FOR_FS_500DPS 17.500 /**< Sensitivity value for 500 dps full scale [mdps/LSB] */
cparata 2:21a191bd1998 63 #define LSM6DSL_GYRO_SENSITIVITY_FOR_FS_1000DPS 35.000 /**< Sensitivity value for 1000 dps full scale [mdps/LSB] */
cparata 2:21a191bd1998 64 #define LSM6DSL_GYRO_SENSITIVITY_FOR_FS_2000DPS 70.000 /**< Sensitivity value for 2000 dps full scale [mdps/LSB] */
cparata 2:21a191bd1998 65
cparata 2:21a191bd1998 66 #define LSM6DSL_PEDOMETER_THRESHOLD_LOW 0x00 /**< Lowest value of pedometer threshold */
cparata 2:21a191bd1998 67 #define LSM6DSL_PEDOMETER_THRESHOLD_MID_LOW 0x07
cparata 2:21a191bd1998 68 #define LSM6DSL_PEDOMETER_THRESHOLD_MID 0x0F
cparata 2:21a191bd1998 69 #define LSM6DSL_PEDOMETER_THRESHOLD_MID_HIGH 0x17
cparata 2:21a191bd1998 70 #define LSM6DSL_PEDOMETER_THRESHOLD_HIGH 0x1F /**< Highest value of pedometer threshold */
cparata 2:21a191bd1998 71
cparata 2:21a191bd1998 72 #define LSM6DSL_WAKE_UP_THRESHOLD_LOW 0x01 /**< Lowest value of wake up threshold */
cparata 2:21a191bd1998 73 #define LSM6DSL_WAKE_UP_THRESHOLD_MID_LOW 0x0F
cparata 2:21a191bd1998 74 #define LSM6DSL_WAKE_UP_THRESHOLD_MID 0x1F
cparata 2:21a191bd1998 75 #define LSM6DSL_WAKE_UP_THRESHOLD_MID_HIGH 0x2F
cparata 2:21a191bd1998 76 #define LSM6DSL_WAKE_UP_THRESHOLD_HIGH 0x3F /**< Highest value of wake up threshold */
cparata 2:21a191bd1998 77
cparata 2:21a191bd1998 78 #define LSM6DSL_TAP_THRESHOLD_LOW 0x01 /**< Lowest value of wake up threshold */
cparata 2:21a191bd1998 79 #define LSM6DSL_TAP_THRESHOLD_MID_LOW 0x08
cparata 2:21a191bd1998 80 #define LSM6DSL_TAP_THRESHOLD_MID 0x10
cparata 2:21a191bd1998 81 #define LSM6DSL_TAP_THRESHOLD_MID_HIGH 0x18
cparata 2:21a191bd1998 82 #define LSM6DSL_TAP_THRESHOLD_HIGH 0x1F /**< Highest value of wake up threshold */
cparata 2:21a191bd1998 83
cparata 2:21a191bd1998 84 #define LSM6DSL_TAP_SHOCK_TIME_LOW 0x00 /**< Lowest value of wake up threshold */
cparata 2:21a191bd1998 85 #define LSM6DSL_TAP_SHOCK_TIME_MID_LOW 0x01
cparata 2:21a191bd1998 86 #define LSM6DSL_TAP_SHOCK_TIME_MID_HIGH 0x02
cparata 2:21a191bd1998 87 #define LSM6DSL_TAP_SHOCK_TIME_HIGH 0x03 /**< Highest value of wake up threshold */
cparata 2:21a191bd1998 88
cparata 2:21a191bd1998 89 #define LSM6DSL_TAP_QUIET_TIME_LOW 0x00 /**< Lowest value of wake up threshold */
cparata 2:21a191bd1998 90 #define LSM6DSL_TAP_QUIET_TIME_MID_LOW 0x01
cparata 2:21a191bd1998 91 #define LSM6DSL_TAP_QUIET_TIME_MID_HIGH 0x02
cparata 2:21a191bd1998 92 #define LSM6DSL_TAP_QUIET_TIME_HIGH 0x03 /**< Highest value of wake up threshold */
cparata 2:21a191bd1998 93
cparata 2:21a191bd1998 94 #define LSM6DSL_TAP_DURATION_TIME_LOW 0x00 /**< Lowest value of wake up threshold */
cparata 2:21a191bd1998 95 #define LSM6DSL_TAP_DURATION_TIME_MID_LOW 0x04
cparata 2:21a191bd1998 96 #define LSM6DSL_TAP_DURATION_TIME_MID 0x08
cparata 2:21a191bd1998 97 #define LSM6DSL_TAP_DURATION_TIME_MID_HIGH 0x0C
cparata 2:21a191bd1998 98 #define LSM6DSL_TAP_DURATION_TIME_HIGH 0x0F /**< Highest value of wake up threshold */
cparata 2:21a191bd1998 99
cparata 2:21a191bd1998 100 /* Class Declaration ---------------------------------------------------------*/
cparata 2:21a191bd1998 101
cparata 2:21a191bd1998 102 /**
cparata 2:21a191bd1998 103 * Abstract class of an LSM6DSL Inertial Measurement Unit (IMU) 6 axes
cparata 2:21a191bd1998 104 * sensor.
cparata 2:21a191bd1998 105 */
cparata 2:21a191bd1998 106 class LSM6DSLSensor : public MotionSensor, public GyroSensor
cparata 2:21a191bd1998 107 {
cparata 2:21a191bd1998 108 public:
cparata 2:21a191bd1998 109 LSM6DSLSensor(DevI2C &i2c);
cparata 2:21a191bd1998 110 LSM6DSLSensor(DevI2C &i2c, uint8_t address);
cparata 2:21a191bd1998 111 virtual int Init(void *init);
cparata 2:21a191bd1998 112 virtual int ReadID(uint8_t *id);
cparata 2:21a191bd1998 113 virtual int Get_X_Axes(int32_t *pData);
cparata 2:21a191bd1998 114 virtual int Get_G_Axes(int32_t *pData);
cparata 2:21a191bd1998 115 virtual int Get_X_Sensitivity(float *pfData);
cparata 2:21a191bd1998 116 virtual int Get_G_Sensitivity(float *pfData);
cparata 2:21a191bd1998 117 virtual int Get_X_AxesRaw(int16_t *pData);
cparata 2:21a191bd1998 118 virtual int Get_G_AxesRaw(int16_t *pData);
cparata 2:21a191bd1998 119 virtual int Get_X_ODR(float *odr);
cparata 2:21a191bd1998 120 virtual int Get_G_ODR(float *odr);
cparata 2:21a191bd1998 121 virtual int Set_X_ODR(float odr);
cparata 2:21a191bd1998 122 virtual int Set_G_ODR(float odr);
cparata 2:21a191bd1998 123 virtual int Get_X_FS(float *fullScale);
cparata 2:21a191bd1998 124 virtual int Get_G_FS(float *fullScale);
cparata 2:21a191bd1998 125 virtual int Set_X_FS(float fullScale);
cparata 2:21a191bd1998 126 virtual int Set_G_FS(float fullScale);
cparata 2:21a191bd1998 127 int Enable_X(void);
cparata 2:21a191bd1998 128 int Enable_G(void);
cparata 2:21a191bd1998 129 int Disable_X(void);
cparata 2:21a191bd1998 130 int Disable_G(void);
cparata 2:21a191bd1998 131 int Enable_Free_Fall_Detection(void);
cparata 2:21a191bd1998 132 int Disable_Free_Fall_Detection(void);
cparata 2:21a191bd1998 133 int Get_Status_Free_Fall_Detection(uint8_t *status);
cparata 2:21a191bd1998 134 int Set_Free_Fall_Threshold(uint8_t thr);
cparata 2:21a191bd1998 135 int Enable_Pedometer(void);
cparata 2:21a191bd1998 136 int Disable_Pedometer(void);
cparata 2:21a191bd1998 137 int Get_Status_Pedometer(uint8_t *status);
cparata 2:21a191bd1998 138 int Get_Step_Counter(uint16_t *step_count);
cparata 2:21a191bd1998 139 int Reset_Step_Counter(void);
cparata 2:21a191bd1998 140 int Set_Pedometer_Threshold(uint8_t thr);
cparata 2:21a191bd1998 141 int Enable_Tilt_Detection(void);
cparata 2:21a191bd1998 142 int Disable_Tilt_Detection(void);
cparata 2:21a191bd1998 143 int Get_Status_Tilt_Detection(uint8_t *status);
cparata 2:21a191bd1998 144 int Enable_Wake_Up_Detection(void);
cparata 2:21a191bd1998 145 int Disable_Wake_Up_Detection(void);
cparata 2:21a191bd1998 146 int Get_Status_Wake_Up_Detection(uint8_t *status);
cparata 2:21a191bd1998 147 int Set_Wake_Up_Threshold(uint8_t thr);
cparata 2:21a191bd1998 148 int Enable_Single_Tap_Detection(void);
cparata 2:21a191bd1998 149 int Disable_Single_Tap_Detection(void);
cparata 2:21a191bd1998 150 int Get_Status_Single_Tap_Detection(uint8_t *status);
cparata 2:21a191bd1998 151 int Enable_Double_Tap_Detection(void);
cparata 2:21a191bd1998 152 int Disable_Double_Tap_Detection(void);
cparata 2:21a191bd1998 153 int Get_Status_Double_Tap_Detection(uint8_t *status);
cparata 2:21a191bd1998 154 int Set_Tap_Threshold(uint8_t thr);
cparata 2:21a191bd1998 155 int Set_Tap_Shock_Time(uint8_t time);
cparata 2:21a191bd1998 156 int Set_Tap_Quiet_Time(uint8_t time);
cparata 2:21a191bd1998 157 int Set_Tap_Duration_Time(uint8_t time);
cparata 2:21a191bd1998 158 int Enable_6D_Orientation(void);
cparata 2:21a191bd1998 159 int Disable_6D_Orientation(void);
cparata 2:21a191bd1998 160 int Get_Status_6D_Orientation(uint8_t *status);
cparata 2:21a191bd1998 161 int Get_6D_Orientation_XL(uint8_t *xl);
cparata 2:21a191bd1998 162 int Get_6D_Orientation_XH(uint8_t *xh);
cparata 2:21a191bd1998 163 int Get_6D_Orientation_YL(uint8_t *yl);
cparata 2:21a191bd1998 164 int Get_6D_Orientation_YH(uint8_t *yh);
cparata 2:21a191bd1998 165 int Get_6D_Orientation_ZL(uint8_t *zl);
cparata 2:21a191bd1998 166 int Get_6D_Orientation_ZH(uint8_t *zh);
cparata 2:21a191bd1998 167 int ReadReg(uint8_t reg, uint8_t *data);
cparata 2:21a191bd1998 168 int WriteReg(uint8_t reg, uint8_t data);
cparata 2:21a191bd1998 169
cparata 2:21a191bd1998 170 /**
cparata 2:21a191bd1998 171 * @brief Utility function to read data.
cparata 2:21a191bd1998 172 * @param pBuffer: pointer to data to be read.
cparata 2:21a191bd1998 173 * @param RegisterAddr: specifies internal address register to be read.
cparata 2:21a191bd1998 174 * @param NumByteToRead: number of bytes to be read.
cparata 2:21a191bd1998 175 * @retval 0 if ok, an error code otherwise.
cparata 2:21a191bd1998 176 */
cparata 2:21a191bd1998 177 uint8_t IO_Read(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToRead)
cparata 2:21a191bd1998 178 {
cparata 2:21a191bd1998 179 return (uint8_t) dev_i2c.i2c_read(pBuffer, address, RegisterAddr, NumByteToRead);
cparata 2:21a191bd1998 180 }
cparata 2:21a191bd1998 181
cparata 2:21a191bd1998 182 /**
cparata 2:21a191bd1998 183 * @brief Utility function to write data.
cparata 2:21a191bd1998 184 * @param pBuffer: pointer to data to be written.
cparata 2:21a191bd1998 185 * @param RegisterAddr: specifies internal address register to be written.
cparata 2:21a191bd1998 186 * @param NumByteToWrite: number of bytes to write.
cparata 2:21a191bd1998 187 * @retval 0 if ok, an error code otherwise.
cparata 2:21a191bd1998 188 */
cparata 2:21a191bd1998 189 uint8_t IO_Write(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToWrite)
cparata 2:21a191bd1998 190 {
cparata 2:21a191bd1998 191 return (uint8_t) dev_i2c.i2c_write(pBuffer, address, RegisterAddr, NumByteToWrite);
cparata 2:21a191bd1998 192 }
cparata 2:21a191bd1998 193
cparata 2:21a191bd1998 194 private:
cparata 2:21a191bd1998 195 int Set_X_ODR_When_Enabled(float odr);
cparata 2:21a191bd1998 196 int Set_G_ODR_When_Enabled(float odr);
cparata 2:21a191bd1998 197 int Set_X_ODR_When_Disabled(float odr);
cparata 2:21a191bd1998 198 int Set_G_ODR_When_Disabled(float odr);
cparata 2:21a191bd1998 199
cparata 2:21a191bd1998 200 /* Helper classes. */
cparata 2:21a191bd1998 201 DevI2C &dev_i2c;
cparata 2:21a191bd1998 202
cparata 2:21a191bd1998 203 /* Configuration */
cparata 2:21a191bd1998 204 uint8_t address;
cparata 2:21a191bd1998 205
cparata 2:21a191bd1998 206 uint8_t X_isEnabled;
cparata 2:21a191bd1998 207 float X_Last_ODR;
cparata 2:21a191bd1998 208 uint8_t G_isEnabled;
cparata 2:21a191bd1998 209 float G_Last_ODR;
cparata 2:21a191bd1998 210 };
cparata 2:21a191bd1998 211
cparata 2:21a191bd1998 212 #ifdef __cplusplus
cparata 2:21a191bd1998 213 extern "C" {
cparata 2:21a191bd1998 214 #endif
cparata 2:21a191bd1998 215 uint8_t LSM6DSL_IO_Write( void *handle, uint8_t WriteAddr, uint8_t *pBuffer, uint16_t nBytesToWrite );
cparata 2:21a191bd1998 216 uint8_t LSM6DSL_IO_Read( void *handle, uint8_t ReadAddr, uint8_t *pBuffer, uint16_t nBytesToRead );
cparata 2:21a191bd1998 217 #ifdef __cplusplus
cparata 2:21a191bd1998 218 }
cparata 2:21a191bd1998 219 #endif
cparata 2:21a191bd1998 220
cparata 2:21a191bd1998 221 #endif