Example of tilt detection for LSM6DSO in X-NUCLEO-IKS01A3
Dependencies: X_NUCLEO_IKS01A3
Tilt Detection Demo Application with LSM6DSO based on sensor expansion board X-NUCLEO-IKS01A3
Main function is to show how to detect the tilt event 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 tilt the board and then view the notification using an hyper terminal. When the tilt event is detected, the LED is switched on for a while.
- the user button can be used to enable/disable the tilt detection feature.
main.cpp@0:a1b39e1d2ad4, 2019-03-06 (annotated)
- Committer:
- cparata
- Date:
- Wed Mar 06 13:37:33 2019 +0000
- Revision:
- 0:a1b39e1d2ad4
- Child:
- 5:ec2f08a6c698
First version of Tilt_LSM6DSO_IKS01A3 application
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
cparata | 0:a1b39e1d2ad4 | 1 | /** |
cparata | 0:a1b39e1d2ad4 | 2 | ****************************************************************************** |
cparata | 0:a1b39e1d2ad4 | 3 | * @file main.cpp |
cparata | 0:a1b39e1d2ad4 | 4 | * @author SRA |
cparata | 0:a1b39e1d2ad4 | 5 | * @version V1.0.0 |
cparata | 0:a1b39e1d2ad4 | 6 | * @date 5-March-2019 |
cparata | 0:a1b39e1d2ad4 | 7 | * @brief Simple Example application for using the X_NUCLEO_IKS01A3 |
cparata | 0:a1b39e1d2ad4 | 8 | * MEMS Inertial & Environmental Sensor Nucleo expansion board. |
cparata | 0:a1b39e1d2ad4 | 9 | ****************************************************************************** |
cparata | 0:a1b39e1d2ad4 | 10 | * @attention |
cparata | 0:a1b39e1d2ad4 | 11 | * |
cparata | 0:a1b39e1d2ad4 | 12 | * <h2><center>© COPYRIGHT(c) 2019 STMicroelectronics</center></h2> |
cparata | 0:a1b39e1d2ad4 | 13 | * |
cparata | 0:a1b39e1d2ad4 | 14 | * Redistribution and use in source and binary forms, with or without modification, |
cparata | 0:a1b39e1d2ad4 | 15 | * are permitted provided that the following conditions are met: |
cparata | 0:a1b39e1d2ad4 | 16 | * 1. Redistributions of source code must retain the above copyright notice, |
cparata | 0:a1b39e1d2ad4 | 17 | * this list of conditions and the following disclaimer. |
cparata | 0:a1b39e1d2ad4 | 18 | * 2. Redistributions in binary form must reproduce the above copyright notice, |
cparata | 0:a1b39e1d2ad4 | 19 | * this list of conditions and the following disclaimer in the documentation |
cparata | 0:a1b39e1d2ad4 | 20 | * and/or other materials provided with the distribution. |
cparata | 0:a1b39e1d2ad4 | 21 | * 3. Neither the name of STMicroelectronics nor the names of its contributors |
cparata | 0:a1b39e1d2ad4 | 22 | * may be used to endorse or promote products derived from this software |
cparata | 0:a1b39e1d2ad4 | 23 | * without specific prior written permission. |
cparata | 0:a1b39e1d2ad4 | 24 | * |
cparata | 0:a1b39e1d2ad4 | 25 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
cparata | 0:a1b39e1d2ad4 | 26 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
cparata | 0:a1b39e1d2ad4 | 27 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
cparata | 0:a1b39e1d2ad4 | 28 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
cparata | 0:a1b39e1d2ad4 | 29 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
cparata | 0:a1b39e1d2ad4 | 30 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
cparata | 0:a1b39e1d2ad4 | 31 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
cparata | 0:a1b39e1d2ad4 | 32 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
cparata | 0:a1b39e1d2ad4 | 33 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
cparata | 0:a1b39e1d2ad4 | 34 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
cparata | 0:a1b39e1d2ad4 | 35 | * |
cparata | 0:a1b39e1d2ad4 | 36 | ****************************************************************************** |
cparata | 0:a1b39e1d2ad4 | 37 | */ |
cparata | 0:a1b39e1d2ad4 | 38 | |
cparata | 0:a1b39e1d2ad4 | 39 | /* Includes */ |
cparata | 0:a1b39e1d2ad4 | 40 | #include "mbed.h" |
cparata | 0:a1b39e1d2ad4 | 41 | #include "XNucleoIKS01A3.h" |
cparata | 0:a1b39e1d2ad4 | 42 | |
cparata | 0:a1b39e1d2ad4 | 43 | /* Instantiate the expansion board */ |
cparata | 0:a1b39e1d2ad4 | 44 | static XNucleoIKS01A3 *mems_expansion_board = XNucleoIKS01A3::instance(D14, D15, D4, D5, A3, D6, A4); |
cparata | 0:a1b39e1d2ad4 | 45 | |
cparata | 0:a1b39e1d2ad4 | 46 | /* Retrieve the composing elements of the expansion board */ |
cparata | 0:a1b39e1d2ad4 | 47 | static LSM6DSOSensor *acc_gyro = mems_expansion_board->acc_gyro; |
cparata | 0:a1b39e1d2ad4 | 48 | |
cparata | 0:a1b39e1d2ad4 | 49 | InterruptIn mybutton(USER_BUTTON); |
cparata | 0:a1b39e1d2ad4 | 50 | DigitalOut myled(LED1); |
cparata | 0:a1b39e1d2ad4 | 51 | |
cparata | 0:a1b39e1d2ad4 | 52 | volatile int mems_event = 0; |
cparata | 0:a1b39e1d2ad4 | 53 | volatile int toggle_tilt_enable = 0; |
cparata | 0:a1b39e1d2ad4 | 54 | static int tilt_is_enabled = 1; |
cparata | 0:a1b39e1d2ad4 | 55 | |
cparata | 0:a1b39e1d2ad4 | 56 | /* User button callback. */ |
cparata | 0:a1b39e1d2ad4 | 57 | void pressed_cb() { |
cparata | 0:a1b39e1d2ad4 | 58 | toggle_tilt_enable = 1; |
cparata | 0:a1b39e1d2ad4 | 59 | } |
cparata | 0:a1b39e1d2ad4 | 60 | |
cparata | 0:a1b39e1d2ad4 | 61 | /* Interrupt 1 callback. */ |
cparata | 0:a1b39e1d2ad4 | 62 | void int1_cb() { |
cparata | 0:a1b39e1d2ad4 | 63 | mems_event = 1; |
cparata | 0:a1b39e1d2ad4 | 64 | } |
cparata | 0:a1b39e1d2ad4 | 65 | |
cparata | 0:a1b39e1d2ad4 | 66 | /* Simple main function */ |
cparata | 0:a1b39e1d2ad4 | 67 | int main() { |
cparata | 0:a1b39e1d2ad4 | 68 | /* Attach callback to User button press */ |
cparata | 0:a1b39e1d2ad4 | 69 | mybutton.fall(&pressed_cb); |
cparata | 0:a1b39e1d2ad4 | 70 | /* Attach callback to LSM6DSO INT1 */ |
cparata | 0:a1b39e1d2ad4 | 71 | acc_gyro->attach_int1_irq(&int1_cb); |
cparata | 0:a1b39e1d2ad4 | 72 | |
cparata | 0:a1b39e1d2ad4 | 73 | /* Enable LSM6DSO accelerometer */ |
cparata | 0:a1b39e1d2ad4 | 74 | acc_gyro->enable_x(); |
cparata | 0:a1b39e1d2ad4 | 75 | /* Enable Tilt Detection. */ |
cparata | 0:a1b39e1d2ad4 | 76 | acc_gyro->enable_tilt_detection(); |
cparata | 0:a1b39e1d2ad4 | 77 | |
cparata | 0:a1b39e1d2ad4 | 78 | printf("\r\n--- Starting new run ---\r\n"); |
cparata | 0:a1b39e1d2ad4 | 79 | |
cparata | 0:a1b39e1d2ad4 | 80 | while(1) { |
cparata | 0:a1b39e1d2ad4 | 81 | if(toggle_tilt_enable) { |
cparata | 0:a1b39e1d2ad4 | 82 | toggle_tilt_enable = 0; |
cparata | 0:a1b39e1d2ad4 | 83 | if(tilt_is_enabled == 0) { |
cparata | 0:a1b39e1d2ad4 | 84 | acc_gyro->enable_tilt_detection(); |
cparata | 0:a1b39e1d2ad4 | 85 | tilt_is_enabled = 1; |
cparata | 0:a1b39e1d2ad4 | 86 | } else { |
cparata | 0:a1b39e1d2ad4 | 87 | acc_gyro->disable_tilt_detection(); |
cparata | 0:a1b39e1d2ad4 | 88 | tilt_is_enabled = 0; |
cparata | 0:a1b39e1d2ad4 | 89 | } |
cparata | 0:a1b39e1d2ad4 | 90 | } |
cparata | 0:a1b39e1d2ad4 | 91 | |
cparata | 0:a1b39e1d2ad4 | 92 | if (mems_event) { |
cparata | 0:a1b39e1d2ad4 | 93 | mems_event = 0; |
cparata | 0:a1b39e1d2ad4 | 94 | LSM6DSO_Event_Status_t status; |
cparata | 0:a1b39e1d2ad4 | 95 | acc_gyro->get_event_status(&status); |
cparata | 0:a1b39e1d2ad4 | 96 | if (status.TiltStatus) { |
cparata | 0:a1b39e1d2ad4 | 97 | /* Led blinking. */ |
cparata | 0:a1b39e1d2ad4 | 98 | myled = 1; |
cparata | 0:a1b39e1d2ad4 | 99 | wait(0.2); |
cparata | 0:a1b39e1d2ad4 | 100 | myled = 0; |
cparata | 0:a1b39e1d2ad4 | 101 | |
cparata | 0:a1b39e1d2ad4 | 102 | /* Output data. */ |
cparata | 0:a1b39e1d2ad4 | 103 | printf("Tilt Detected!\r\n"); |
cparata | 0:a1b39e1d2ad4 | 104 | } |
cparata | 0:a1b39e1d2ad4 | 105 | } |
cparata | 0:a1b39e1d2ad4 | 106 | } |
cparata | 0:a1b39e1d2ad4 | 107 | } |