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.

main.cpp@4:05f28412d61b, 2016-11-21 (annotated)

Committer:
cparata
Date:
Mon Nov 21 14:57:55 2016 +0000
Revision:
4:05f28412d61b
Parent:
0:e4f89df7a7a5
Child:
6:2380444e4c75
Add muti-event support

Who changed what in which revision?

UserRevisionLine numberNew contents of line
cparata 0:e4f89df7a7a5 1 /**
cparata 0:e4f89df7a7a5 2 ******************************************************************************
cparata 0:e4f89df7a7a5 3 * @file main.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 Simple Example application for using the X_NUCLEO_IKS01A2
cparata 0:e4f89df7a7a5 8 * MEMS Inertial & Environmental Sensor Nucleo expansion board.
cparata 0:e4f89df7a7a5 9 ******************************************************************************
cparata 0:e4f89df7a7a5 10 * @attention
cparata 0:e4f89df7a7a5 11 *
cparata 0:e4f89df7a7a5 12 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 0:e4f89df7a7a5 13 *
cparata 0:e4f89df7a7a5 14 * Redistribution and use in source and binary forms, with or without modification,
cparata 0:e4f89df7a7a5 15 * are permitted provided that the following conditions are met:
cparata 0:e4f89df7a7a5 16 * 1. Redistributions of source code must retain the above copyright notice,
cparata 0:e4f89df7a7a5 17 * this list of conditions and the following disclaimer.
cparata 0:e4f89df7a7a5 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 0:e4f89df7a7a5 19 * this list of conditions and the following disclaimer in the documentation
cparata 0:e4f89df7a7a5 20 * and/or other materials provided with the distribution.
cparata 0:e4f89df7a7a5 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 0:e4f89df7a7a5 22 * may be used to endorse or promote products derived from this software
cparata 0:e4f89df7a7a5 23 * without specific prior written permission.
cparata 0:e4f89df7a7a5 24 *
cparata 0:e4f89df7a7a5 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 0:e4f89df7a7a5 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 0:e4f89df7a7a5 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 0:e4f89df7a7a5 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 0:e4f89df7a7a5 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 0:e4f89df7a7a5 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 0:e4f89df7a7a5 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 0:e4f89df7a7a5 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 0:e4f89df7a7a5 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 0:e4f89df7a7a5 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 0:e4f89df7a7a5 35 *
cparata 0:e4f89df7a7a5 36 ******************************************************************************
cparata 0:e4f89df7a7a5 37 */
cparata 0:e4f89df7a7a5 38
cparata 0:e4f89df7a7a5 39 /* Includes */
cparata 0:e4f89df7a7a5 40 #include "mbed.h"
cparata 0:e4f89df7a7a5 41 #include "x_nucleo_iks01a2.h"
cparata 0:e4f89df7a7a5 42
cparata 0:e4f89df7a7a5 43 /* Instantiate the expansion board */
cparata 0:e4f89df7a7a5 44 static X_NUCLEO_IKS01A2 *mems_expansion_board = X_NUCLEO_IKS01A2::Instance(D14, D15);
cparata 0:e4f89df7a7a5 45
cparata 0:e4f89df7a7a5 46 /* Retrieve the composing elements of the expansion board */
cparata 0:e4f89df7a7a5 47 static LSM6DSLSensor *acc_gyro = mems_expansion_board->acc_gyro;
cparata 0:e4f89df7a7a5 48
cparata 0:e4f89df7a7a5 49 InterruptIn lsm6dsl_int1(IKS01A2_PIN_LSM6DSL_INT1);
cparata 0:e4f89df7a7a5 50 InterruptIn mybutton(USER_BUTTON);
cparata 0:e4f89df7a7a5 51 DigitalOut myled(LED1);
cparata 0:e4f89df7a7a5 52
cparata 0:e4f89df7a7a5 53 volatile int tap = 0;
cparata 0:e4f89df7a7a5 54 volatile int change_mode = 0;
cparata 0:e4f89df7a7a5 55 static int mode = 1; /* 0 means No tap, 1 means Single Tap enabled, 2 means Double Tap enabled*/
cparata 0:e4f89df7a7a5 56
cparata 0:e4f89df7a7a5 57 void pressed();
cparata 0:e4f89df7a7a5 58 void tap_cb();
cparata 0:e4f89df7a7a5 59
cparata 0:e4f89df7a7a5 60 /* Simple main function */
cparata 0:e4f89df7a7a5 61 int main() {
cparata 0:e4f89df7a7a5 62 /* Attach callback to User button press */
cparata 0:e4f89df7a7a5 63 mybutton.fall(&pressed);
cparata 0:e4f89df7a7a5 64 /* Attach callback to LSM6DSL INT1 */
cparata 0:e4f89df7a7a5 65 lsm6dsl_int1.rise(&tap_cb);
cparata 0:e4f89df7a7a5 66
cparata 0:e4f89df7a7a5 67 /* Enable LSM6DSL accelerometer */
cparata 0:e4f89df7a7a5 68 acc_gyro->Enable_X();
cparata 0:e4f89df7a7a5 69 /* Enable Single Tap Detection. */
cparata 0:e4f89df7a7a5 70 acc_gyro->Enable_Single_Tap_Detection();
cparata 0:e4f89df7a7a5 71
cparata 0:e4f89df7a7a5 72 printf("\r\n--- Starting new run ---\r\n");
cparata 0:e4f89df7a7a5 73
cparata 0:e4f89df7a7a5 74 while(1) {
cparata 0:e4f89df7a7a5 75 if(change_mode) {
cparata 0:e4f89df7a7a5 76 change_mode = 0;
cparata 0:e4f89df7a7a5 77 mode = ((mode + 1) % 3);
cparata 0:e4f89df7a7a5 78 switch(mode) {
cparata 0:e4f89df7a7a5 79 case 0:
cparata 0:e4f89df7a7a5 80 /* Disable Double Tap */
cparata 0:e4f89df7a7a5 81 acc_gyro->Disable_Double_Tap_Detection();
cparata 0:e4f89df7a7a5 82 break;
cparata 0:e4f89df7a7a5 83 case 1:
cparata 0:e4f89df7a7a5 84 /* Enable Single Tap */
cparata 0:e4f89df7a7a5 85 acc_gyro->Enable_Single_Tap_Detection();
cparata 0:e4f89df7a7a5 86 break;
cparata 0:e4f89df7a7a5 87 case 2:
cparata 0:e4f89df7a7a5 88 /* Disable Single Tap and Enable Double Tap */
cparata 0:e4f89df7a7a5 89 acc_gyro->Disable_Single_Tap_Detection();
cparata 0:e4f89df7a7a5 90 acc_gyro->Enable_Double_Tap_Detection();
cparata 0:e4f89df7a7a5 91 break;
cparata 0:e4f89df7a7a5 92 }
cparata 0:e4f89df7a7a5 93 }
cparata 0:e4f89df7a7a5 94
cparata 0:e4f89df7a7a5 95 if (tap) {
cparata 0:e4f89df7a7a5 96 tap = 0;
cparata 0:e4f89df7a7a5 97 switch(mode) {
cparata 0:e4f89df7a7a5 98 case 0:
cparata 0:e4f89df7a7a5 99 default:
cparata 0:e4f89df7a7a5 100 break;
cparata 0:e4f89df7a7a5 101 case 1: {
cparata 4:05f28412d61b 102 LSM6DSL_Event_Status_t status;
cparata 4:05f28412d61b 103 acc_gyro->Get_Event_Status(&status);
cparata 4:05f28412d61b 104 if (status.TapStatus) {
cparata 0:e4f89df7a7a5 105 /* Led blinking. */
cparata 0:e4f89df7a7a5 106 myled = 1;
cparata 0:e4f89df7a7a5 107 wait(0.1);
cparata 0:e4f89df7a7a5 108 myled = 0;
cparata 0:e4f89df7a7a5 109
cparata 0:e4f89df7a7a5 110 /* Output data. */
cparata 0:e4f89df7a7a5 111 printf("Single Tap Detected!\r\n");
cparata 0:e4f89df7a7a5 112 }
cparata 0:e4f89df7a7a5 113 }
cparata 0:e4f89df7a7a5 114 case 2: {
cparata 4:05f28412d61b 115 LSM6DSL_Event_Status_t status;
cparata 4:05f28412d61b 116 acc_gyro->Get_Event_Status(&status);
cparata 4:05f28412d61b 117 if (status.DoubleTapStatus) {
cparata 0:e4f89df7a7a5 118 /* Double Led blinking */
cparata 0:e4f89df7a7a5 119 myled = 1;
cparata 0:e4f89df7a7a5 120 wait(0.1);
cparata 0:e4f89df7a7a5 121 myled = 0;
cparata 0:e4f89df7a7a5 122 wait(0.1);
cparata 0:e4f89df7a7a5 123 myled = 1;
cparata 0:e4f89df7a7a5 124 wait(0.1);
cparata 0:e4f89df7a7a5 125 myled = 0;
cparata 0:e4f89df7a7a5 126
cparata 0:e4f89df7a7a5 127 /* Output data. */
cparata 0:e4f89df7a7a5 128 printf("Double Tap Detected!\r\n");
cparata 0:e4f89df7a7a5 129 }
cparata 0:e4f89df7a7a5 130 }
cparata 0:e4f89df7a7a5 131 }
cparata 0:e4f89df7a7a5 132 }
cparata 0:e4f89df7a7a5 133 }
cparata 0:e4f89df7a7a5 134 }
cparata 0:e4f89df7a7a5 135
cparata 0:e4f89df7a7a5 136 void pressed() {
cparata 0:e4f89df7a7a5 137 change_mode = 1;
cparata 0:e4f89df7a7a5 138 }
cparata 0:e4f89df7a7a5 139
cparata 0:e4f89df7a7a5 140 void tap_cb() {
cparata 0:e4f89df7a7a5 141 tap = 1;
cparata 0:e4f89df7a7a5 142 }