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 9:2693f9ef8ff7 1 /**
mapellil 9:2693f9ef8ff7 2 ******************************************************************************
mapellil 9:2693f9ef8ff7 3 * @file CustomConsoleService.h
mapellil 9:2693f9ef8ff7 4 * @author Central Labs / AST
mapellil 9:2693f9ef8ff7 5 * @version V0.9.0
mapellil 9:2693f9ef8ff7 6 * @date 23-Dec-2015
mapellil 9:2693f9ef8ff7 7 * @brief BLE console service
mapellil 9:2693f9ef8ff7 8 ******************************************************************************
mapellil 9:2693f9ef8ff7 9 * @attention
mapellil 9:2693f9ef8ff7 10 *
mapellil 9:2693f9ef8ff7 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mapellil 9:2693f9ef8ff7 12 *
mapellil 9:2693f9ef8ff7 13 * Redistribution and use in source and binary forms, with or without modification,
mapellil 9:2693f9ef8ff7 14 * are permitted provided that the following conditions are met:
mapellil 9:2693f9ef8ff7 15 * 1. Redistributions of source code must retain the above copyright notice,
mapellil 9:2693f9ef8ff7 16 * this list of conditions and the following disclaimer.
mapellil 9:2693f9ef8ff7 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mapellil 9:2693f9ef8ff7 18 * this list of conditions and the following disclaimer in the documentation
mapellil 9:2693f9ef8ff7 19 * and/or other materials provided with the distribution.
mapellil 9:2693f9ef8ff7 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mapellil 9:2693f9ef8ff7 21 * may be used to endorse or promote products derived from this software
mapellil 9:2693f9ef8ff7 22 * without specific prior written permission.
mapellil 9:2693f9ef8ff7 23 *
mapellil 9:2693f9ef8ff7 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mapellil 9:2693f9ef8ff7 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mapellil 9:2693f9ef8ff7 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mapellil 9:2693f9ef8ff7 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mapellil 9:2693f9ef8ff7 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mapellil 9:2693f9ef8ff7 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mapellil 9:2693f9ef8ff7 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mapellil 9:2693f9ef8ff7 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mapellil 9:2693f9ef8ff7 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mapellil 9:2693f9ef8ff7 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mapellil 9:2693f9ef8ff7 34 *
mapellil 9:2693f9ef8ff7 35 ******************************************************************************
mapellil 9:2693f9ef8ff7 36 */
mapellil 0:e93a11b4e044 37
mapellil 0:e93a11b4e044 38 #ifndef __CUSTOM_BLE_CONSOLE_SERVICE_H__
mapellil 0:e93a11b4e044 39 #define __CUSTOM_BLE_CONSOLE_SERVICE_H__
mapellil 0:e93a11b4e044 40
mapellil 0:e93a11b4e044 41 #include "BLE.h"
mapellil 20:b97e14ade434 42 #include "ble_debug.h"
mapellil 0:e93a11b4e044 43
mapellil 20:b97e14ade434 44 const UUID::LongUUIDBytes_t CONS_SERVICE_UUID_128 = { 0x00,0x00,0x00,0x00,0x00,0x0E,0x11,0xe1,0x9a,0xb4,0x00,0x02,0xa5,0xd5,0xc5,0x1b };
mapellil 20:b97e14ade434 45 const UUID::LongUUIDBytes_t CONS_TERM_CHAR_UUID_128 = { 0x00,0x00,0x00,0x01,0x00,0x0E,0x11,0xe1,0xac,0x36,0x00,0x02,0xa5,0xd5,0xc5,0x1b };
mapellil 20:b97e14ade434 46 const UUID::LongUUIDBytes_t CONS_STDERR_CHAR_UUID_128 = { 0x00,0x00,0x00,0x02,0x00,0x0E,0x11,0xe1,0xac,0x36,0x00,0x02,0xa5,0xd5,0xc5,0x1b };
mapellil 0:e93a11b4e044 47
mapellil 0:e93a11b4e044 48 #define W2ST_CONSOLE_MAX_CHAR_LEN 20
mapellil 0:e93a11b4e044 49
mapellil 0:e93a11b4e044 50 /* Custom Sensors Service */
mapellil 0:e93a11b4e044 51 class CustomConsoleService {
mapellil 0:e93a11b4e044 52 public:
mapellil 9:2693f9ef8ff7 53 CustomConsoleService(BLE &_ble) :
mapellil 0:e93a11b4e044 54 ble(_ble),
mapellil 0:e93a11b4e044 55 consTermCharacteristic(CONS_TERM_CHAR_UUID_128,LastTermBuffer, W2ST_CONSOLE_MAX_CHAR_LEN, W2ST_CONSOLE_MAX_CHAR_LEN, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE |
mapellil 0:e93a11b4e044 56 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
mapellil 0:e93a11b4e044 57 consStderrCharacteristic(CONS_STDERR_CHAR_UUID_128, LastStderrBuffer, W2ST_CONSOLE_MAX_CHAR_LEN, W2ST_CONSOLE_MAX_CHAR_LEN,
mapellil 0:e93a11b4e044 58 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
mapellil 0:e93a11b4e044 59 {
mapellil 0:e93a11b4e044 60
mapellil 0:e93a11b4e044 61 static bool serviceAdded = false; /* We should only ever need to add the env service once. */
mapellil 0:e93a11b4e044 62 if (serviceAdded) {
mapellil 0:e93a11b4e044 63 return;
mapellil 0:e93a11b4e044 64 }
mapellil 0:e93a11b4e044 65
mapellil 0:e93a11b4e044 66 GattCharacteristic *charTable[] = {&consTermCharacteristic, &consStderrCharacteristic};
mapellil 0:e93a11b4e044 67
mapellil 0:e93a11b4e044 68 GattService consService(CONS_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
mapellil 0:e93a11b4e044 69
mapellil 0:e93a11b4e044 70 ble.gattServer().addService(consService);
mapellil 0:e93a11b4e044 71
mapellil 0:e93a11b4e044 72 memset (LastTermBuffer, 0, W2ST_CONSOLE_MAX_CHAR_LEN);
mapellil 0:e93a11b4e044 73 memset (LastStderrBuffer, 0, W2ST_CONSOLE_MAX_CHAR_LEN);
mapellil 0:e93a11b4e044 74
mapellil 0:e93a11b4e044 75 isBTLEConnected = DISCONNECTED;
mapellil 0:e93a11b4e044 76 isEnabledTermNotify = false;
mapellil 0:e93a11b4e044 77 isEnabledStderrNotify = false;
mapellil 8:b042fe719f51 78 serviceAdded = true;
mapellil 0:e93a11b4e044 79 }
mapellil 0:e93a11b4e044 80
mapellil 0:e93a11b4e044 81 tBleStatus updateTerm (uint8_t *data,uint8_t length) {
mapellil 8:b042fe719f51 82 tBleStatus ret;
mapellil 0:e93a11b4e044 83 uint8_t Offset;
mapellil 0:e93a11b4e044 84 uint8_t DataToSend;
mapellil 2:d61a6f4d9682 85 // uint8_t BufferToWrite[W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 2:d61a6f4d9682 86 // uint8_t BytesToWrite;
mapellil 0:e93a11b4e044 87
mapellil 0:e93a11b4e044 88 if (isEnabledTermNotify && isBTLEConnected==CONNECTED) {
mapellil 0:e93a11b4e044 89 /* Split the code in packages */
mapellil 0:e93a11b4e044 90 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 91 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 92 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 93
mapellil 0:e93a11b4e044 94 /* keep a copy */
mapellil 0:e93a11b4e044 95 memcpy(LastTermBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 96 LastTermLen = DataToSend;
mapellil 4:007539036889 97 PRINTF("updateTerm handle: %d string: %s\n\r", consTermCharacteristic.getValueAttribute().getHandle(), LastTermBuffer);
mapellil 8:b042fe719f51 98 ret = ble.gattServer().write(consTermCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0);
mapellil 8:b042fe719f51 99 if (ret != BLE_ERROR_NONE) { /* FIXME the wrong errcode from BLE requires BLE fix */
mapellil 8:b042fe719f51 100 // BytesToWrite = sprintf((char *)BufferToWrite, "Error Updating Stdout Char\r\n");
mapellil 8:b042fe719f51 101 // updateStderr(BufferToWrite,BytesToWrite);
mapellil 8:b042fe719f51 102 }
mapellil 8:b042fe719f51 103 return ret;
mapellil 0:e93a11b4e044 104 }
mapellil 0:e93a11b4e044 105 }
mapellil 8:b042fe719f51 106 return BLE_STATUS_SUCCESS;
mapellil 0:e93a11b4e044 107 }
mapellil 0:e93a11b4e044 108
mapellil 0:e93a11b4e044 109 tBleStatus updateStderr (uint8_t *data,uint8_t length) {
mapellil 0:e93a11b4e044 110
mapellil 0:e93a11b4e044 111 uint8_t Offset;
mapellil 0:e93a11b4e044 112 uint8_t DataToSend;
mapellil 0:e93a11b4e044 113
mapellil 0:e93a11b4e044 114 if (isEnabledStderrNotify && isBTLEConnected==CONNECTED) {
mapellil 0:e93a11b4e044 115 /* Split the code in packages */
mapellil 0:e93a11b4e044 116 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 117 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 118 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 119
mapellil 0:e93a11b4e044 120 /* keep a copy */
mapellil 0:e93a11b4e044 121 memcpy(LastStderrBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 122 LastStderrLen = DataToSend;
mapellil 4:007539036889 123 PRINTF("updateStderr handle: %d string: %s\n\r", consStderrCharacteristic.getValueAttribute().getHandle(), LastStderrBuffer);
mapellil 8:b042fe719f51 124 return (ble.gattServer().write(consStderrCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0));
mapellil 0:e93a11b4e044 125 }
mapellil 0:e93a11b4e044 126 }
mapellil 8:b042fe719f51 127 return BLE_STATUS_SUCCESS;
mapellil 0:e93a11b4e044 128 }
mapellil 0:e93a11b4e044 129
mapellil 0:e93a11b4e044 130 void updateConnectionStatus (ConnectionStatus_t status){
mapellil 0:e93a11b4e044 131 isBTLEConnected = status;
mapellil 0:e93a11b4e044 132 isEnabledTermNotify = false;
mapellil 8:b042fe719f51 133 isEnabledStderrNotify = false;
mapellil 0:e93a11b4e044 134 }
mapellil 0:e93a11b4e044 135
mapellil 0:e93a11b4e044 136 bool isTermHandle (Gap::Handle_t handle) {
mapellil 13:d00147d01d4e 137 if (handle == consTermCharacteristic.getValueAttribute().getHandle() - BLE_HANDLE_VALUE_OFFSET) return true;
mapellil 0:e93a11b4e044 138 return false;
mapellil 0:e93a11b4e044 139 }
mapellil 0:e93a11b4e044 140
mapellil 0:e93a11b4e044 141 bool isStderrHandle (Gap::Handle_t handle) {
mapellil 13:d00147d01d4e 142 if (handle == consStderrCharacteristic.getValueAttribute().getHandle() - BLE_HANDLE_VALUE_OFFSET) return true;
mapellil 0:e93a11b4e044 143 return false;
mapellil 0:e93a11b4e044 144 }
mapellil 0:e93a11b4e044 145
mapellil 0:e93a11b4e044 146 void enNotify (Gap::Handle_t handle) {
mapellil 13:d00147d01d4e 147 if (isTermHandle(handle - BLE_HANDLE_EN_DIS_OFFSET)) { isEnabledTermNotify = true; return; }
mapellil 13:d00147d01d4e 148 if (isStderrHandle(handle - BLE_HANDLE_EN_DIS_OFFSET)) { isEnabledStderrNotify = true; return; }
mapellil 0:e93a11b4e044 149 }
mapellil 0:e93a11b4e044 150
mapellil 0:e93a11b4e044 151 void disNotify (Gap::Handle_t handle) {
mapellil 13:d00147d01d4e 152 if (isTermHandle(handle - BLE_HANDLE_EN_DIS_OFFSET)) { isEnabledTermNotify = false; return; }
mapellil 13:d00147d01d4e 153 if (isStderrHandle(handle - BLE_HANDLE_EN_DIS_OFFSET)) { isEnabledStderrNotify = false; return; }
mapellil 0:e93a11b4e044 154 }
mapellil 0:e93a11b4e044 155
mapellil 0:e93a11b4e044 156
mapellil 0:e93a11b4e044 157 private:
mapellil 9:2693f9ef8ff7 158 BLE &ble;
mapellil 0:e93a11b4e044 159 uint8_t LastTermBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 160 uint8_t LastTermLen;
mapellil 0:e93a11b4e044 161 uint8_t LastStderrBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 162 uint8_t LastStderrLen;
mapellil 0:e93a11b4e044 163
mapellil 0:e93a11b4e044 164 GattCharacteristic consTermCharacteristic;
mapellil 0:e93a11b4e044 165 GattCharacteristic consStderrCharacteristic;
mapellil 0:e93a11b4e044 166 ConnectionStatus_t isBTLEConnected;
mapellil 0:e93a11b4e044 167 bool isEnabledTermNotify;
mapellil 0:e93a11b4e044 168 bool isEnabledStderrNotify;
mapellil 0:e93a11b4e044 169 };
mapellil 0:e93a11b4e044 170
mapellil 0:e93a11b4e044 171 #endif /* #ifndef __CUSTOM_BLE_CONSOLE_SERVICE_H__*/