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:
Fri Nov 20 09:55:58 2015 +0000
Revision:
4:007539036889
Parent:
2:d61a6f4d9682
Child:
6:c1b8fb74072e
Updated BLE API, IDB and MBED libs

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mapellil 0:e93a11b4e044 1 /* mbed Microcontroller Library
mapellil 0:e93a11b4e044 2 * Copyright (c) 2006-2013 ARM Limited
mapellil 0:e93a11b4e044 3 *
mapellil 0:e93a11b4e044 4 * Licensed under the Apache License, Version 2.0 (the "License");
mapellil 0:e93a11b4e044 5 * you may not use this file except in compliance with the License.
mapellil 0:e93a11b4e044 6 * You may obtain a copy of the License at
mapellil 0:e93a11b4e044 7 *
mapellil 0:e93a11b4e044 8 * http://www.apache.org/licenses/LICENSE-2.0
mapellil 0:e93a11b4e044 9 *
mapellil 0:e93a11b4e044 10 * Unless required by applicable law or agreed to in writing, software
mapellil 0:e93a11b4e044 11 * distributed under the License is distributed on an "AS IS" BASIS,
mapellil 0:e93a11b4e044 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mapellil 0:e93a11b4e044 13 * See the License for the specific language governing permissions and
mapellil 0:e93a11b4e044 14 * limitations under the License.
mapellil 0:e93a11b4e044 15 */
mapellil 0:e93a11b4e044 16
mapellil 0:e93a11b4e044 17 #ifndef __CUSTOM_BLE_CONSOLE_SERVICE_H__
mapellil 0:e93a11b4e044 18 #define __CUSTOM_BLE_CONSOLE_SERVICE_H__
mapellil 0:e93a11b4e044 19
mapellil 0:e93a11b4e044 20 #include "BLE.h"
mapellil 0:e93a11b4e044 21
mapellil 0:e93a11b4e044 22 const LongUUIDBytes_t CONS_SERVICE_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0xb4,0x9a,0xe1,0x11,0x0E,0x00,0x00,0x00,0x00,0x00 };
mapellil 0:e93a11b4e044 23
mapellil 0:e93a11b4e044 24 const LongUUIDBytes_t CONS_TERM_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x0E,0x00,0x01,0x00,0x00,0x00 };
mapellil 0:e93a11b4e044 25 const LongUUIDBytes_t CONS_STDERR_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x0E,0x00,0x02,0x00,0x00,0x00 };
mapellil 0:e93a11b4e044 26
mapellil 0:e93a11b4e044 27 #define W2ST_CONSOLE_MAX_CHAR_LEN 20
mapellil 0:e93a11b4e044 28
mapellil 0:e93a11b4e044 29 /* Custom Sensors Service */
mapellil 0:e93a11b4e044 30 class CustomConsoleService {
mapellil 0:e93a11b4e044 31 public:
mapellil 0:e93a11b4e044 32 CustomConsoleService(BLEDevice &_ble) :
mapellil 0:e93a11b4e044 33 ble(_ble),
mapellil 0:e93a11b4e044 34 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 35 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
mapellil 0:e93a11b4e044 36 consStderrCharacteristic(CONS_STDERR_CHAR_UUID_128, LastStderrBuffer, W2ST_CONSOLE_MAX_CHAR_LEN, W2ST_CONSOLE_MAX_CHAR_LEN,
mapellil 0:e93a11b4e044 37 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
mapellil 0:e93a11b4e044 38 {
mapellil 0:e93a11b4e044 39
mapellil 0:e93a11b4e044 40 static bool serviceAdded = false; /* We should only ever need to add the env service once. */
mapellil 0:e93a11b4e044 41 if (serviceAdded) {
mapellil 0:e93a11b4e044 42 return;
mapellil 0:e93a11b4e044 43 }
mapellil 0:e93a11b4e044 44
mapellil 0:e93a11b4e044 45 GattCharacteristic *charTable[] = {&consTermCharacteristic, &consStderrCharacteristic};
mapellil 0:e93a11b4e044 46
mapellil 0:e93a11b4e044 47 GattService consService(CONS_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
mapellil 0:e93a11b4e044 48
mapellil 0:e93a11b4e044 49 ble.gattServer().addService(consService);
mapellil 0:e93a11b4e044 50
mapellil 0:e93a11b4e044 51 memset (LastTermBuffer, 0, W2ST_CONSOLE_MAX_CHAR_LEN);
mapellil 0:e93a11b4e044 52 memset (LastStderrBuffer, 0, W2ST_CONSOLE_MAX_CHAR_LEN);
mapellil 0:e93a11b4e044 53
mapellil 0:e93a11b4e044 54 isBTLEConnected = DISCONNECTED;
mapellil 0:e93a11b4e044 55 isEnabledTermNotify = false;
mapellil 0:e93a11b4e044 56 isEnabledStderrNotify = false;
mapellil 0:e93a11b4e044 57 serviceAdded = true;
mapellil 0:e93a11b4e044 58 }
mapellil 0:e93a11b4e044 59
mapellil 0:e93a11b4e044 60 tBleStatus updateTerm (uint8_t *data,uint8_t length) {
mapellil 0:e93a11b4e044 61 tBleStatus ret;
mapellil 0:e93a11b4e044 62 uint8_t Offset;
mapellil 0:e93a11b4e044 63 uint8_t DataToSend;
mapellil 2:d61a6f4d9682 64 // uint8_t BufferToWrite[W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 2:d61a6f4d9682 65 // uint8_t BytesToWrite;
mapellil 0:e93a11b4e044 66
mapellil 0:e93a11b4e044 67 if (isEnabledTermNotify && isBTLEConnected==CONNECTED) {
mapellil 0:e93a11b4e044 68 /* Split the code in packages */
mapellil 0:e93a11b4e044 69 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 70 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 71 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 72
mapellil 0:e93a11b4e044 73 /* keep a copy */
mapellil 0:e93a11b4e044 74 memcpy(LastTermBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 75 LastTermLen = DataToSend;
mapellil 4:007539036889 76 PRINTF("updateTerm handle: %d string: %s\n\r", consTermCharacteristic.getValueAttribute().getHandle(), LastTermBuffer);
mapellil 0:e93a11b4e044 77 ret = ble.gattServer().write(consTermCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0);
mapellil 0:e93a11b4e044 78 if (ret != BLE_ERROR_NONE) { /* FIXME the wrong errcode from BLE requires BLE fix */
mapellil 0:e93a11b4e044 79 // BytesToWrite = sprintf((char *)BufferToWrite, "Error Updating Stdout Char\r\n");
mapellil 0:e93a11b4e044 80 // updateStderr(BufferToWrite,BytesToWrite);
mapellil 0:e93a11b4e044 81 }
mapellil 0:e93a11b4e044 82 return ret;
mapellil 0:e93a11b4e044 83 }
mapellil 0:e93a11b4e044 84 }
mapellil 0:e93a11b4e044 85 return BLE_STATUS_SUCCESS;
mapellil 0:e93a11b4e044 86 }
mapellil 0:e93a11b4e044 87
mapellil 0:e93a11b4e044 88 tBleStatus updateStderr (uint8_t *data,uint8_t length) {
mapellil 0:e93a11b4e044 89
mapellil 0:e93a11b4e044 90 uint8_t Offset;
mapellil 0:e93a11b4e044 91 uint8_t DataToSend;
mapellil 0:e93a11b4e044 92
mapellil 0:e93a11b4e044 93 if (isEnabledStderrNotify && isBTLEConnected==CONNECTED) {
mapellil 0:e93a11b4e044 94 /* Split the code in packages */
mapellil 0:e93a11b4e044 95 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 96 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 97 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 98
mapellil 0:e93a11b4e044 99 /* keep a copy */
mapellil 0:e93a11b4e044 100 memcpy(LastStderrBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 101 LastStderrLen = DataToSend;
mapellil 4:007539036889 102 PRINTF("updateStderr handle: %d string: %s\n\r", consStderrCharacteristic.getValueAttribute().getHandle(), LastStderrBuffer);
mapellil 0:e93a11b4e044 103 return (ble.gattServer().write(consStderrCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0));
mapellil 0:e93a11b4e044 104 }
mapellil 0:e93a11b4e044 105 }
mapellil 0:e93a11b4e044 106 return BLE_STATUS_SUCCESS;
mapellil 0:e93a11b4e044 107 }
mapellil 0:e93a11b4e044 108
mapellil 0:e93a11b4e044 109 void updateConnectionStatus (ConnectionStatus_t status){
mapellil 0:e93a11b4e044 110 isBTLEConnected = status;
mapellil 0:e93a11b4e044 111 isEnabledTermNotify = false;
mapellil 0:e93a11b4e044 112 isEnabledStderrNotify = false;
mapellil 0:e93a11b4e044 113 }
mapellil 0:e93a11b4e044 114
mapellil 0:e93a11b4e044 115 bool isTermHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 116 if (handle == consTermCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 117 return false;
mapellil 0:e93a11b4e044 118 }
mapellil 0:e93a11b4e044 119
mapellil 0:e93a11b4e044 120 bool isStderrHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 121 if (handle == consStderrCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 122 return false;
mapellil 0:e93a11b4e044 123 }
mapellil 0:e93a11b4e044 124
mapellil 0:e93a11b4e044 125 void enNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 126 if (isTermHandle(handle)) { isEnabledTermNotify = true; return; }
mapellil 0:e93a11b4e044 127 if (isStderrHandle(handle)) { isEnabledStderrNotify = true; return; }
mapellil 0:e93a11b4e044 128 }
mapellil 0:e93a11b4e044 129
mapellil 0:e93a11b4e044 130 void disNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 131 if (isTermHandle(handle)) { isEnabledTermNotify = false; return; }
mapellil 0:e93a11b4e044 132 if (isStderrHandle(handle)) { isEnabledStderrNotify = false; return; }
mapellil 0:e93a11b4e044 133 }
mapellil 0:e93a11b4e044 134
mapellil 0:e93a11b4e044 135
mapellil 0:e93a11b4e044 136 private:
mapellil 0:e93a11b4e044 137 BLEDevice &ble;
mapellil 0:e93a11b4e044 138 uint8_t LastTermBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 139 uint8_t LastTermLen;
mapellil 0:e93a11b4e044 140 uint8_t LastStderrBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 141 uint8_t LastStderrLen;
mapellil 0:e93a11b4e044 142
mapellil 0:e93a11b4e044 143 GattCharacteristic consTermCharacteristic;
mapellil 0:e93a11b4e044 144 GattCharacteristic consStderrCharacteristic;
mapellil 0:e93a11b4e044 145 ConnectionStatus_t isBTLEConnected;
mapellil 0:e93a11b4e044 146 bool isEnabledTermNotify;
mapellil 0:e93a11b4e044 147 bool isEnabledStderrNotify;
mapellil 0:e93a11b4e044 148 };
mapellil 0:e93a11b4e044 149
mapellil 0:e93a11b4e044 150 #endif /* #ifndef __CUSTOM_BLE_CONSOLE_SERVICE_H__*/