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 Dec 17 13:53:13 2015 +0000
Revision:
6:c1b8fb74072e
Parent:
5:c3ba16d6612d
Child:
7:34014895dda8
I2C@400KHz, BLE app congestion management, license disclaimer

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mapellil 6:c1b8fb74072e 1 /**
mapellil 6:c1b8fb74072e 2 ******************************************************************************
mapellil 6:c1b8fb74072e 3 * @file CustomConfigService.h
mapellil 6:c1b8fb74072e 4 * @author AST / EST
mapellil 6:c1b8fb74072e 5 * @version V0.0.1
mapellil 6:c1b8fb74072e 6 * @date 16-Dec-2015
mapellil 6:c1b8fb74072e 7 * @brief Ble calibration service of Bluemicrosystem1 application
mapellil 6:c1b8fb74072e 8 ******************************************************************************
mapellil 6:c1b8fb74072e 9 * @attention
mapellil 0:e93a11b4e044 10 *
mapellil 6:c1b8fb74072e 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mapellil 0:e93a11b4e044 12 *
mapellil 6:c1b8fb74072e 13 * Redistribution and use in source and binary forms, with or without modification,
mapellil 6:c1b8fb74072e 14 * are permitted provided that the following conditions are met:
mapellil 6:c1b8fb74072e 15 * 1. Redistributions of source code must retain the above copyright notice,
mapellil 6:c1b8fb74072e 16 * this list of conditions and the following disclaimer.
mapellil 6:c1b8fb74072e 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mapellil 6:c1b8fb74072e 18 * this list of conditions and the following disclaimer in the documentation
mapellil 6:c1b8fb74072e 19 * and/or other materials provided with the distribution.
mapellil 6:c1b8fb74072e 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mapellil 6:c1b8fb74072e 21 * may be used to endorse or promote products derived from this software
mapellil 6:c1b8fb74072e 22 * without specific prior written permission.
mapellil 0:e93a11b4e044 23 *
mapellil 6:c1b8fb74072e 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mapellil 6:c1b8fb74072e 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mapellil 6:c1b8fb74072e 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mapellil 6:c1b8fb74072e 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mapellil 6:c1b8fb74072e 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mapellil 6:c1b8fb74072e 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mapellil 6:c1b8fb74072e 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mapellil 6:c1b8fb74072e 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mapellil 6:c1b8fb74072e 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mapellil 6:c1b8fb74072e 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mapellil 6:c1b8fb74072e 34 *
mapellil 6:c1b8fb74072e 35 ******************************************************************************
mapellil 0:e93a11b4e044 36 */
mapellil 0:e93a11b4e044 37 #ifndef __CUSTOM_BLE_CONFIG_SERVICE_H__
mapellil 0:e93a11b4e044 38 #define __CUSTOM_BLE_CONFIG_SERVICE_H__
mapellil 0:e93a11b4e044 39 #include "BLE.h"
mapellil 0:e93a11b4e044 40 #include "UUID.h"
mapellil 0:e93a11b4e044 41
mapellil 0:e93a11b4e044 42 #define STORE_BE_32(buf, val) ( ((buf)[3] = (uint8_t) (val) ) , \
mapellil 0:e93a11b4e044 43 ((buf)[2] = (uint8_t) (val>>8) ) , \
mapellil 0:e93a11b4e044 44 ((buf)[1] = (uint8_t) (val>>16) ) , \
mapellil 0:e93a11b4e044 45 ((buf)[0] = (uint8_t) (val>>24) ) )
mapellil 0:e93a11b4e044 46
mapellil 0:e93a11b4e044 47 #define SIZEOF_CONFIG_DATA_LEN 2+4+1+1
mapellil 0:e93a11b4e044 48
mapellil 0:e93a11b4e044 49 const LongUUIDBytes_t CONFIG_SERVICE_UUID_128 = {0x1b,0xc5,0xa5,0xd5,0x02,0x00,0xb4,0x9a,0xe1,0x11,0x0F,0x00,0x00,0x00,0x00,0x00};
mapellil 0:e93a11b4e044 50
mapellil 0:e93a11b4e044 51 const LongUUIDBytes_t CONFIG_W2ST_CHAR_UUID = {0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x0F,0x00,0x02,0x00,0x00,0x00};
mapellil 0:e93a11b4e044 52
mapellil 0:e93a11b4e044 53 /* Custom Config Service */
mapellil 0:e93a11b4e044 54 class CustomConfigService {
mapellil 0:e93a11b4e044 55 public:
mapellil 6:c1b8fb74072e 56 CustomConfigService(BLE &_ble, CustomBleErrManagement * ErrMgr=NULL ) :
mapellil 0:e93a11b4e044 57 ble(_ble),
mapellil 0:e93a11b4e044 58 configw2stCharacteristic(CONFIG_W2ST_CHAR_UUID, configData, SIZEOF_CONFIG_DATA_LEN, SIZEOF_CONFIG_DATA_LEN,
mapellil 0:e93a11b4e044 59 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY |
mapellil 0:e93a11b4e044 60 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE
mapellil 0:e93a11b4e044 61 ) {
mapellil 0:e93a11b4e044 62
mapellil 0:e93a11b4e044 63 static bool serviceAdded = false; /* We should only ever need to add the heart rate service once. */
mapellil 0:e93a11b4e044 64 if (serviceAdded) {
mapellil 0:e93a11b4e044 65 return;
mapellil 0:e93a11b4e044 66 }
mapellil 0:e93a11b4e044 67
mapellil 0:e93a11b4e044 68 GattCharacteristic *charTable[] = {&configw2stCharacteristic};
mapellil 0:e93a11b4e044 69
mapellil 0:e93a11b4e044 70 GattService configService(CONFIG_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
mapellil 0:e93a11b4e044 71
mapellil 0:e93a11b4e044 72 ble.gattServer().addService(configService);
mapellil 0:e93a11b4e044 73
mapellil 0:e93a11b4e044 74 isEnabledConfNotify = false;
mapellil 0:e93a11b4e044 75 memset (configData, 0, SIZEOF_CONFIG_DATA_LEN);
mapellil 0:e93a11b4e044 76 serviceAdded = true;
mapellil 0:e93a11b4e044 77 }
mapellil 0:e93a11b4e044 78
mapellil 0:e93a11b4e044 79
mapellil 6:c1b8fb74072e 80 void sendConfigState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
mapellil 6:c1b8fb74072e 81 if (bleErrMgr != NULL) {
mapellil 6:c1b8fb74072e 82 if (!bleErrMgr->isBleTxChannelOk()){
mapellil 6:c1b8fb74072e 83 bleErrMgr->signalBleTxOk(); // skip tx because of previous error
mapellil 6:c1b8fb74072e 84 return;
mapellil 6:c1b8fb74072e 85 }
mapellil 6:c1b8fb74072e 86 }
mapellil 0:e93a11b4e044 87 STORE_LE_16(configData ,TimeStamp);
mapellil 0:e93a11b4e044 88 STORE_BE_32(configData+2,Feature);
mapellil 0:e93a11b4e044 89 configData[6] = Command;
mapellil 0:e93a11b4e044 90 configData[7] = (val==0x01) ? 100: val;
mapellil 6:c1b8fb74072e 91 uint32_t err = ble.gattServer().write(configw2stCharacteristic.getValueAttribute().getHandle(), configData, SIZEOF_CONFIG_DATA_LEN, 0);
mapellil 6:c1b8fb74072e 92 if (!err) {
mapellil 6:c1b8fb74072e 93 bleErrMgr->signalBleTxOk();
mapellil 6:c1b8fb74072e 94 }else{
mapellil 6:c1b8fb74072e 95 bleErrMgr->signalBleTxErr(err);
mapellil 6:c1b8fb74072e 96 }
mapellil 0:e93a11b4e044 97 }
mapellil 0:e93a11b4e044 98
mapellil 0:e93a11b4e044 99 void updateConfigState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
mapellil 0:e93a11b4e044 100 if (ble.getGapState().connected && isEnabledConfNotify ) {
mapellil 0:e93a11b4e044 101 sendConfigState(Feature, Command, val, TimeStamp);
mapellil 0:e93a11b4e044 102 }
mapellil 0:e93a11b4e044 103 }
mapellil 0:e93a11b4e044 104
mapellil 0:e93a11b4e044 105 void updateConnectionStatus(ConnectionStatus_t status) {
mapellil 0:e93a11b4e044 106 isEnabledConfNotify = false;
mapellil 0:e93a11b4e044 107 memset (configData, 0, SIZEOF_CONFIG_DATA_LEN);
mapellil 0:e93a11b4e044 108 }
mapellil 0:e93a11b4e044 109
mapellil 0:e93a11b4e044 110 bool isConfHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 111 if (handle == configw2stCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 112 return false;
mapellil 0:e93a11b4e044 113 }
mapellil 0:e93a11b4e044 114
mapellil 0:e93a11b4e044 115 void enNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 116 if (isConfHandle(handle)) {
mapellil 5:c3ba16d6612d 117 PRINTF("enNotify! %d\n\r", handle); isEnabledConfNotify = true; return; }
mapellil 0:e93a11b4e044 118 }
mapellil 0:e93a11b4e044 119
mapellil 0:e93a11b4e044 120 void disNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 121 if (isConfHandle(handle)) {
mapellil 0:e93a11b4e044 122 isEnabledConfNotify = false; return; }
mapellil 0:e93a11b4e044 123 }
mapellil 0:e93a11b4e044 124
mapellil 0:e93a11b4e044 125 private:
mapellil 6:c1b8fb74072e 126 BLE &ble;
mapellil 6:c1b8fb74072e 127 CustomBleErrManagement *bleErrMgr;
mapellil 6:c1b8fb74072e 128 uint8_t configData[SIZEOF_CONFIG_DATA_LEN];
mapellil 6:c1b8fb74072e 129 uint8_t configState;
mapellil 6:c1b8fb74072e 130 GattCharacteristic configw2stCharacteristic;
mapellil 6:c1b8fb74072e 131 bool isEnabledConfNotify;
mapellil 0:e93a11b4e044 132
mapellil 0:e93a11b4e044 133 };
mapellil 0:e93a11b4e044 134
mapellil 0:e93a11b4e044 135 #endif /* #ifndef __CUSTOM_BLE_CONFIG_SERVICE_H__*/