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.

Committer:
cparata
Date:
Fri Aug 19 12:31:21 2016 +0000
Revision:
2:21a191bd1998
Child:
3:1676461f57b7
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 LSM303AGR_MAG_Sensor.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 LSM303AGR magnetometer sensor.
cparata 2:21a191bd1998 8 ******************************************************************************
cparata 2:21a191bd1998 9 * @attention
cparata 2:21a191bd1998 10 *
cparata 2:21a191bd1998 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 2:21a191bd1998 12 *
cparata 2:21a191bd1998 13 * Redistribution and use in source and binary forms, with or without modification,
cparata 2:21a191bd1998 14 * are permitted provided that the following conditions are met:
cparata 2:21a191bd1998 15 * 1. Redistributions of source code must retain the above copyright notice,
cparata 2:21a191bd1998 16 * this list of conditions and the following disclaimer.
cparata 2:21a191bd1998 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 2:21a191bd1998 18 * this list of conditions and the following disclaimer in the documentation
cparata 2:21a191bd1998 19 * and/or other materials provided with the distribution.
cparata 2:21a191bd1998 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 2:21a191bd1998 21 * may be used to endorse or promote products derived from this software
cparata 2:21a191bd1998 22 * without specific prior written permission.
cparata 2:21a191bd1998 23 *
cparata 2:21a191bd1998 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 2:21a191bd1998 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 2:21a191bd1998 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 2:21a191bd1998 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 2:21a191bd1998 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 2:21a191bd1998 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 2:21a191bd1998 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 2:21a191bd1998 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 2:21a191bd1998 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 2:21a191bd1998 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 2:21a191bd1998 34 *
cparata 2:21a191bd1998 35 ******************************************************************************
cparata 2:21a191bd1998 36 */
cparata 2:21a191bd1998 37
cparata 2:21a191bd1998 38
cparata 2:21a191bd1998 39 /* Prevent recursive inclusion -----------------------------------------------*/
cparata 2:21a191bd1998 40
cparata 2:21a191bd1998 41 #ifndef __LSM303AGR_MAG_Sensor_H__
cparata 2:21a191bd1998 42 #define __LSM303AGR_MAG_Sensor_H__
cparata 2:21a191bd1998 43
cparata 2:21a191bd1998 44
cparata 2:21a191bd1998 45 /* Includes ------------------------------------------------------------------*/
cparata 2:21a191bd1998 46
cparata 2:21a191bd1998 47 #include "DevI2C.h"
cparata 2:21a191bd1998 48 #include "LSM303AGR_MAG_driver.h"
cparata 2:21a191bd1998 49 #include "MagneticSensor.h"
cparata 2:21a191bd1998 50
cparata 2:21a191bd1998 51
cparata 2:21a191bd1998 52 /* Class Declaration ---------------------------------------------------------*/
cparata 2:21a191bd1998 53
cparata 2:21a191bd1998 54 /**
cparata 2:21a191bd1998 55 * Abstract class of an LSM303AGR Inertial Measurement Unit (IMU) 6 axes
cparata 2:21a191bd1998 56 * sensor.
cparata 2:21a191bd1998 57 */
cparata 2:21a191bd1998 58 class LSM303AGR_MAG_Sensor
cparata 2:21a191bd1998 59 {
cparata 2:21a191bd1998 60 public:
cparata 2:21a191bd1998 61 LSM303AGR_MAG_Sensor(DevI2C &i2c);
cparata 2:21a191bd1998 62 LSM303AGR_MAG_Sensor(DevI2C &i2c, uint8_t address);
cparata 2:21a191bd1998 63 virtual int Init(void *init);
cparata 2:21a191bd1998 64 virtual int ReadID(uint8_t *id);
cparata 2:21a191bd1998 65 virtual int Get_M_Axes(int32_t *pData);
cparata 2:21a191bd1998 66 virtual int Get_M_AxesRaw(int16_t *pData);
cparata 2:21a191bd1998 67 int Enable(void);
cparata 2:21a191bd1998 68 int Disable(void);
cparata 2:21a191bd1998 69 int Get_M_Sensitivity(float *pfData);
cparata 2:21a191bd1998 70 int Get_M_ODR(float *odr);
cparata 2:21a191bd1998 71 int Set_M_ODR(float odr);
cparata 2:21a191bd1998 72 int Get_M_FS(float *fullScale);
cparata 2:21a191bd1998 73 int Set_M_FS(float fullScale);
cparata 2:21a191bd1998 74 int ReadReg(uint8_t reg, uint8_t *data);
cparata 2:21a191bd1998 75 int WriteReg(uint8_t reg, uint8_t data);
cparata 2:21a191bd1998 76
cparata 2:21a191bd1998 77 /**
cparata 2:21a191bd1998 78 * @brief Utility function to read data.
cparata 2:21a191bd1998 79 * @param pBuffer: pointer to data to be read.
cparata 2:21a191bd1998 80 * @param RegisterAddr: specifies internal address register to be read.
cparata 2:21a191bd1998 81 * @param NumByteToRead: number of bytes to be read.
cparata 2:21a191bd1998 82 * @retval 0 if ok, an error code otherwise.
cparata 2:21a191bd1998 83 */
cparata 2:21a191bd1998 84 uint8_t IO_Read(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToRead)
cparata 2:21a191bd1998 85 {
cparata 2:21a191bd1998 86 return (uint8_t) dev_i2c.i2c_read(pBuffer, address, RegisterAddr, NumByteToRead);
cparata 2:21a191bd1998 87 }
cparata 2:21a191bd1998 88
cparata 2:21a191bd1998 89 /**
cparata 2:21a191bd1998 90 * @brief Utility function to write data.
cparata 2:21a191bd1998 91 * @param pBuffer: pointer to data to be written.
cparata 2:21a191bd1998 92 * @param RegisterAddr: specifies internal address register to be written.
cparata 2:21a191bd1998 93 * @param NumByteToWrite: number of bytes to write.
cparata 2:21a191bd1998 94 * @retval 0 if ok, an error code otherwise.
cparata 2:21a191bd1998 95 */
cparata 2:21a191bd1998 96 uint8_t IO_Write(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToWrite)
cparata 2:21a191bd1998 97 {
cparata 2:21a191bd1998 98 return (uint8_t) dev_i2c.i2c_write(pBuffer, address, RegisterAddr, NumByteToWrite);
cparata 2:21a191bd1998 99 }
cparata 2:21a191bd1998 100
cparata 2:21a191bd1998 101 private:
cparata 2:21a191bd1998 102
cparata 2:21a191bd1998 103 /* Helper classes. */
cparata 2:21a191bd1998 104 DevI2C &dev_i2c;
cparata 2:21a191bd1998 105
cparata 2:21a191bd1998 106 /* Configuration */
cparata 2:21a191bd1998 107 uint8_t address;
cparata 2:21a191bd1998 108 };
cparata 2:21a191bd1998 109
cparata 2:21a191bd1998 110 #ifdef __cplusplus
cparata 2:21a191bd1998 111 extern "C" {
cparata 2:21a191bd1998 112 #endif
cparata 2:21a191bd1998 113 uint8_t LSM303AGR_MAG_IO_Write( void *handle, uint8_t WriteAddr, uint8_t *pBuffer, uint16_t nBytesToWrite );
cparata 2:21a191bd1998 114 uint8_t LSM303AGR_MAG_IO_Read( void *handle, uint8_t ReadAddr, uint8_t *pBuffer, uint16_t nBytesToRead );
cparata 2:21a191bd1998 115 #ifdef __cplusplus
cparata 2:21a191bd1998 116 }
cparata 2:21a191bd1998 117 #endif
cparata 2:21a191bd1998 118
cparata 2:21a191bd1998 119 #endif