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 12 13:42:02 2016 +0000
Revision:
0:e4f89df7a7a5
First release of Single/Double Tap for LSM6DSL in IKS01A2

Who changed what in which revision?

UserRevisionLine numberNew contents of line
cparata 0:e4f89df7a7a5 1 /**
cparata 0:e4f89df7a7a5 2 ******************************************************************************
cparata 0:e4f89df7a7a5 3 * @file x_nucleo_iks01a2.cpp
cparata 0:e4f89df7a7a5 4 * @author AST / EST
cparata 0:e4f89df7a7a5 5 * @version V0.0.1
cparata 0:e4f89df7a7a5 6 * @date 9-August-2016
cparata 0:e4f89df7a7a5 7 * @brief Implementation file for the X_NUCLEO_IKS01A2 singleton class
cparata 0:e4f89df7a7a5 8 ******************************************************************************
cparata 0:e4f89df7a7a5 9 * @attention
cparata 0:e4f89df7a7a5 10 *
cparata 0:e4f89df7a7a5 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 0:e4f89df7a7a5 12 *
cparata 0:e4f89df7a7a5 13 * Redistribution and use in source and binary forms, with or without modification,
cparata 0:e4f89df7a7a5 14 * are permitted provided that the following conditions are met:
cparata 0:e4f89df7a7a5 15 * 1. Redistributions of source code must retain the above copyright notice,
cparata 0:e4f89df7a7a5 16 * this list of conditions and the following disclaimer.
cparata 0:e4f89df7a7a5 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 0:e4f89df7a7a5 18 * this list of conditions and the following disclaimer in the documentation
cparata 0:e4f89df7a7a5 19 * and/or other materials provided with the distribution.
cparata 0:e4f89df7a7a5 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 0:e4f89df7a7a5 21 * may be used to endorse or promote products derived from this software
cparata 0:e4f89df7a7a5 22 * without specific prior written permission.
cparata 0:e4f89df7a7a5 23 *
cparata 0:e4f89df7a7a5 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 0:e4f89df7a7a5 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 0:e4f89df7a7a5 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 0:e4f89df7a7a5 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 0:e4f89df7a7a5 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 0:e4f89df7a7a5 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 0:e4f89df7a7a5 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 0:e4f89df7a7a5 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 0:e4f89df7a7a5 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 0:e4f89df7a7a5 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 0:e4f89df7a7a5 34 *
cparata 0:e4f89df7a7a5 35 ******************************************************************************
cparata 0:e4f89df7a7a5 36 */
cparata 0:e4f89df7a7a5 37
cparata 0:e4f89df7a7a5 38 /* Includes ------------------------------------------------------------------*/
cparata 0:e4f89df7a7a5 39 #include "mbed.h"
cparata 0:e4f89df7a7a5 40 #include "x_nucleo_iks01a2.h"
cparata 0:e4f89df7a7a5 41
cparata 0:e4f89df7a7a5 42 /* Static variables ----------------------------------------------------------*/
cparata 0:e4f89df7a7a5 43 X_NUCLEO_IKS01A2* X_NUCLEO_IKS01A2::_instance = NULL;
cparata 0:e4f89df7a7a5 44
cparata 0:e4f89df7a7a5 45
cparata 0:e4f89df7a7a5 46 /* Methods -------------------------------------------------------------------*/
cparata 0:e4f89df7a7a5 47 /**
cparata 0:e4f89df7a7a5 48 * @brief Constructor
cparata 0:e4f89df7a7a5 49 */
cparata 0:e4f89df7a7a5 50 X_NUCLEO_IKS01A2::X_NUCLEO_IKS01A2(DevI2C *ext_i2c) : dev_i2c(ext_i2c),
cparata 0:e4f89df7a7a5 51 ht_sensor(new HTS221Sensor(*dev_i2c)),
cparata 0:e4f89df7a7a5 52 magnetometer(new LSM303AGR_MAG_Sensor(*dev_i2c)),
cparata 0:e4f89df7a7a5 53 accelerometer(new LSM303AGR_ACC_Sensor(*dev_i2c)),
cparata 0:e4f89df7a7a5 54 pt_sensor(new LPS22HBSensor(*dev_i2c)),
cparata 0:e4f89df7a7a5 55 acc_gyro(new LSM6DSLSensor(*dev_i2c))
cparata 0:e4f89df7a7a5 56 {
cparata 0:e4f89df7a7a5 57
cparata 0:e4f89df7a7a5 58 }
cparata 0:e4f89df7a7a5 59
cparata 0:e4f89df7a7a5 60 /**
cparata 0:e4f89df7a7a5 61 * @brief Get singleton instance
cparata 0:e4f89df7a7a5 62 * @return a pointer to the initialized singleton instance of class X_NUCLEO_IKS01A2.
cparata 0:e4f89df7a7a5 63 * A return value of NULL indicates an out of memory situation.
cparata 0:e4f89df7a7a5 64 * @param[in] ext_i2c (optional) pointer to an instance of DevI2C to be used
cparata 0:e4f89df7a7a5 65 * for communication on the expansion board.
cparata 0:e4f89df7a7a5 66 * Defaults to NULL.
cparata 0:e4f89df7a7a5 67 * Taken into account only on the very first call of one of the 'Instance' functions.
cparata 0:e4f89df7a7a5 68 * If not provided a new DevI2C will be created with standard
cparata 0:e4f89df7a7a5 69 * configuration parameters.
cparata 0:e4f89df7a7a5 70 * The used DevI2C object gets saved in instance variable dev_i2c.
cparata 0:e4f89df7a7a5 71 */
cparata 0:e4f89df7a7a5 72 X_NUCLEO_IKS01A2* X_NUCLEO_IKS01A2::Instance(DevI2C *ext_i2c) {
cparata 0:e4f89df7a7a5 73 if(_instance == NULL) {
cparata 0:e4f89df7a7a5 74 if(ext_i2c == NULL)
cparata 0:e4f89df7a7a5 75 ext_i2c = new DevI2C(IKS01A2_PIN_I2C_SDA, IKS01A2_PIN_I2C_SCL);
cparata 0:e4f89df7a7a5 76
cparata 0:e4f89df7a7a5 77 if(ext_i2c != NULL)
cparata 0:e4f89df7a7a5 78 _instance = new X_NUCLEO_IKS01A2(ext_i2c);
cparata 0:e4f89df7a7a5 79 }
cparata 0:e4f89df7a7a5 80
cparata 0:e4f89df7a7a5 81 return _instance;
cparata 0:e4f89df7a7a5 82 }
cparata 0:e4f89df7a7a5 83
cparata 0:e4f89df7a7a5 84 /**
cparata 0:e4f89df7a7a5 85 * @brief Get singleton instance
cparata 0:e4f89df7a7a5 86 * @return a pointer to the initialized singleton instance of class X_NUCLEO_IKS01A1.
cparata 0:e4f89df7a7a5 87 * A return value of NULL indicates an out of memory situation.
cparata 0:e4f89df7a7a5 88 * @param[in] sda I2C data line pin.
cparata 0:e4f89df7a7a5 89 * Taken into account only on the very first call of one of the 'Instance' functions.
cparata 0:e4f89df7a7a5 90 * A new DevI2C will be created based on parameters 'sda' and 'scl'.
cparata 0:e4f89df7a7a5 91 * The used DevI2C object gets saved in instance variable dev_i2c.
cparata 0:e4f89df7a7a5 92 * @param[in] scl I2C clock line pin.
cparata 0:e4f89df7a7a5 93 * Taken into account only on the very first call of one of the 'Instance' functions.
cparata 0:e4f89df7a7a5 94 * A new DevI2C will be created based on parameters 'sda' and 'scl'.
cparata 0:e4f89df7a7a5 95 * The used DevI2C object gets saved in instance variable dev_i2c.
cparata 0:e4f89df7a7a5 96 */
cparata 0:e4f89df7a7a5 97 X_NUCLEO_IKS01A2* X_NUCLEO_IKS01A2::Instance(PinName sda, PinName scl) {
cparata 0:e4f89df7a7a5 98 if(_instance == NULL) {
cparata 0:e4f89df7a7a5 99 DevI2C *ext_i2c = new DevI2C(sda, scl);
cparata 0:e4f89df7a7a5 100
cparata 0:e4f89df7a7a5 101 if(ext_i2c != NULL)
cparata 0:e4f89df7a7a5 102 _instance = new X_NUCLEO_IKS01A2(ext_i2c);
cparata 0:e4f89df7a7a5 103 }
cparata 0:e4f89df7a7a5 104
cparata 0:e4f89df7a7a5 105 return _instance;
cparata 0:e4f89df7a7a5 106 }