Motion and Environmental sensor reader application connected via BLE to ST BlueMS iOS/Android application.

Dependencies:   HTS221 LIS3MDL LPS22HB LSM303AGR LSM6DSL

Fork of MOTENV_Mbed by ST Expansion SW Team

This application supports three different sets of ST hardware boards:

  • STEVAL-STLKT01V1 (aka SensorTile)
  • X-NUCLEO-IDB05A1 and X-NUCLEO-IKS01A2 expansion boards
  • B-L475E-IOT01A IoT Discovery board

    and runs over four different target configurations:

  • Nucleo F401RE + X-NUCLEO-IDB05A1 + X-NUCLEO-IKS01A2 (set target NUCLEO_F401RE)
  • DISCO_L475VG_IOT01A (set target DISCO_L475VG_IOT01A)
  • Nucleo L476RG + CRADLE + SENSORTILE (set compile target NUCLEO_L476RG)
  • Nucleo L476RG + CRADLE_EXPANSION_BOARD + SENSORTILE (set compile target NUCLEO_L476RG, remove macro MINI_CRADLE from mbed_app.json)

The first 2 configurations do not require any HW modifications (just use the above indicated targets).

Third configuration (CRADLE ) only requires to remove the two ST-LINK jumpers and JP6 from the Nucleo L476RG board in order to allow flashing the SensorTile through the Nucleo Jtag controller. Once flashed, if the battery is properly plugged and charged, the SensorTile could be mounted in the plastic enclosure being able to run as a small stand alone wearable device. Please note that this configuration do not provide a serial console for printf.

To enable last configuration (CRADLE_EXPANSION_BOARD), follow the steps below:

  • On Nucleo L476RG
    • open the two "ST-LINK" jumpers
    • open the MCU power supply jumper JP6
    • close the solder bridges SB63 and SB62 (to enable the serial console)
  • On SensorTile Arduino Cradle close the solder bridges SB21 and SB10 (to enable the serial console) and move the jumper J2 to the 5V position
  • Plug the Sensor Tile on the Arduino Cradle
  • Plug the Cradle on the Nucleo Arduino connector and connect the debug flat cable between Cradle and Nucleo Jtag connector (the cradle pin1 -identified by a dot- must be connected to the Nucleo pin1 (dot) of SWD CN4 jtag connector)
  • Plug the Nucleo USB cable on PC (a new COM port should appear); no need to plug the micro USB cable on the cradle.
  • Open a PC terminal to see the messages
  • Compile from mbed CLI or on-line compiler removing macro MINI_CRADLE from mbed_app.json file and selecting NUCLEO_ L476RG target
  • Flash the board with the binary

For all configurations on an Android or iOS device download and open the ST BlueMS application and connect to "MotEnvMbedOS" BLE device to see the sensor data.

For all configurations is also possible to add a 9 axis MotionFX sensor fusion library, which is part of the X-CUBE-MEMS package at this link.
The library comes in three flavours, choose your preferred according to the toolchain used (IAR, Keil or GC, Keil version should be used for the online compiler) and copy it in the Middlewares\ST\STM32_MotionFX_Library\Lib directory changing the file extension according to the toolchain used (.a for GCC, .ar for Keil).
In the file mbed_app.json add the macro definition "USE_SENSOR_FUSION_LIB" to the chosen target.
If compiling from CLI and using GCC_ARM toolchain option, in the file \mbed-os\tools\toolchains\gcc.py change the compiling option from

        if target.core == "Cortex-M4F":
            self.cpu.append("-mfpu=fpv4-sp-d16")
            self.cpu.append("-mfloat-abi=softfp")

to

        if target.core == "Cortex-M4F":
            self.cpu.append("-mfpu=fpv4-sp-d16")
            self.cpu.append("-mfloat-abi=hard")

and compile.

Committer:
mapellil
Date:
Thu Oct 19 07:43:37 2017 +0000
Revision:
36:7abc45e9b0a5
Parent:
20:b97e14ade434
Updated libs

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mapellil 0:e93a11b4e044 1 /**
mapellil 0:e93a11b4e044 2 ******************************************************************************
mapellil 20:b97e14ade434 3 * @file MotionFA_Manager.h
mapellil 20:b97e14ade434 4 * @author MEMS Application Team
mapellil 20:b97e14ade434 5 * @version V2.0.0
mapellil 20:b97e14ade434 6 * @date 01-May-2017
mapellil 20:b97e14ade434 7 * @brief Header for MotionCP_Manager.c module
mapellil 0:e93a11b4e044 8 ******************************************************************************
mapellil 0:e93a11b4e044 9 * @attention
mapellil 0:e93a11b4e044 10 *
mapellil 20:b97e14ade434 11 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
mapellil 0:e93a11b4e044 12 *
mapellil 0:e93a11b4e044 13 * Redistribution and use in source and binary forms, with or without modification,
mapellil 0:e93a11b4e044 14 * are permitted provided that the following conditions are met:
mapellil 0:e93a11b4e044 15 * 1. Redistributions of source code must retain the above copyright notice,
mapellil 0:e93a11b4e044 16 * this list of conditions and the following disclaimer.
mapellil 0:e93a11b4e044 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mapellil 0:e93a11b4e044 18 * this list of conditions and the following disclaimer in the documentation
mapellil 0:e93a11b4e044 19 * and/or other materials provided with the distribution.
mapellil 0:e93a11b4e044 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mapellil 0:e93a11b4e044 21 * may be used to endorse or promote products derived from this software
mapellil 0:e93a11b4e044 22 * without specific prior written permission.
mapellil 0:e93a11b4e044 23 *
mapellil 0:e93a11b4e044 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mapellil 0:e93a11b4e044 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mapellil 0:e93a11b4e044 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mapellil 0:e93a11b4e044 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mapellil 0:e93a11b4e044 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mapellil 0:e93a11b4e044 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mapellil 0:e93a11b4e044 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mapellil 0:e93a11b4e044 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mapellil 0:e93a11b4e044 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mapellil 0:e93a11b4e044 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mapellil 0:e93a11b4e044 34 *
mapellil 0:e93a11b4e044 35 ******************************************************************************
mapellil 0:e93a11b4e044 36 */
mapellil 20:b97e14ade434 37
mapellil 20:b97e14ade434 38 /* Define to prevent recursive inclusion -------------------------------------*/
mapellil 20:b97e14ade434 39 #ifndef _MOTIONFA_MANAGER_H_
mapellil 20:b97e14ade434 40 #define _MOTIONFA_MANAGER_H_
mapellil 0:e93a11b4e044 41
mapellil 0:e93a11b4e044 42 #ifdef __cplusplus
mapellil 20:b97e14ade434 43 extern "C" {
mapellil 0:e93a11b4e044 44 #endif
mapellil 0:e93a11b4e044 45
mapellil 20:b97e14ade434 46 /* Includes ------------------------------------------------------------------*/
mapellil 20:b97e14ade434 47 #include "string.h"
mapellil 20:b97e14ade434 48 #include "motion_fx.h"
mapellil 0:e93a11b4e044 49
mapellil 20:b97e14ade434 50 #define USE_IKS01A2
mapellil 0:e93a11b4e044 51
mapellil 20:b97e14ade434 52 #define LSM6DSL_G_0 0
mapellil 20:b97e14ade434 53 #define LSM6DS3_G_0 1
mapellil 20:b97e14ade434 54 #define LSM6DS0_G_0 2
mapellil 0:e93a11b4e044 55
mapellil 0:e93a11b4e044 56 typedef struct
mapellil 0:e93a11b4e044 57 {
mapellil 0:e93a11b4e044 58 signed short magOffX; /* X axis Offset */
mapellil 0:e93a11b4e044 59 signed short magOffY; /* Y axis Offset */
mapellil 0:e93a11b4e044 60 signed short magOffZ; /* Z axis Offset */
mapellil 0:e93a11b4e044 61 } osxMFX_calibFactor;
mapellil 20:b97e14ade434 62
mapellil 20:b97e14ade434 63 /** @addtogroup MOTION_FA_Applications
mapellil 20:b97e14ade434 64 * @{
mapellil 20:b97e14ade434 65 */
mapellil 0:e93a11b4e044 66
mapellil 20:b97e14ade434 67 /** @addtogroup FITNESS_ACTIVITIES
mapellil 20:b97e14ade434 68 * @{
mapellil 20:b97e14ade434 69 */
mapellil 0:e93a11b4e044 70
mapellil 20:b97e14ade434 71 /* Extern Variables ----------------------------------------------------------*/
mapellil 20:b97e14ade434 72 /* Exported Macros -----------------------------------------------------------*/
mapellil 20:b97e14ade434 73 /* Exported Types ------------------------------------------------------------*/
mapellil 20:b97e14ade434 74 /* Imported Variables --------------------------------------------------------*/
mapellil 20:b97e14ade434 75 /* Exported Functions Prototypes ---------------------------------------------*/
mapellil 20:b97e14ade434 76 //void MotionFX_manager_init(void *handle);
mapellil 20:b97e14ade434 77 void MotionFX_manager_init(unsigned char instance);
mapellil 20:b97e14ade434 78 void MotionFX_manager_run(MFX_input_t *data_in, MFX_output_t *data_out, float delta_time);
mapellil 0:e93a11b4e044 79 void MotionFX_manager_start_6X(void);
mapellil 0:e93a11b4e044 80 void MotionFX_manager_stop_6X(void);
mapellil 0:e93a11b4e044 81 void MotionFX_manager_start_9X(void);
mapellil 0:e93a11b4e044 82 void MotionFX_manager_stop_9X(void);
mapellil 0:e93a11b4e044 83
mapellil 20:b97e14ade434 84 void MotionFX_manager_MagCal_run(MFX_MagCal_input_t *data_in, MFX_MagCal_output_t *data_out);
mapellil 20:b97e14ade434 85 void MotionFX_manager_MagCal_start(int sampletime);
mapellil 20:b97e14ade434 86 void MotionFX_manager_MagCal_stop(int sampletime);
mapellil 20:b97e14ade434 87
mapellil 20:b97e14ade434 88 char MotionFX_LoadMagCalFromNVM(unsigned short int dataSize, unsigned int *data);
mapellil 20:b97e14ade434 89 char MotionFX_SaveMagCalInNVM(unsigned short int dataSize, unsigned int *data);
mapellil 0:e93a11b4e044 90
mapellil 20:b97e14ade434 91 /**
mapellil 20:b97e14ade434 92 * @}
mapellil 20:b97e14ade434 93 */
mapellil 0:e93a11b4e044 94
mapellil 20:b97e14ade434 95 /**
mapellil 20:b97e14ade434 96 * @}
mapellil 20:b97e14ade434 97 */
mapellil 0:e93a11b4e044 98
mapellil 0:e93a11b4e044 99 #ifdef __cplusplus
mapellil 0:e93a11b4e044 100 }
mapellil 0:e93a11b4e044 101 #endif
mapellil 0:e93a11b4e044 102
mapellil 20:b97e14ade434 103 #endif /* _MOTIONFA_MANAGER_H_ */
mapellil 0:e93a11b4e044 104
mapellil 20:b97e14ade434 105 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
mapellil 20:b97e14ade434 106