ST / Mbed 2 deprecated Bluemicrosystem1

X-NUCLEO-IKS01A1 Environmental/Motion sensors data transmitted via X-NUCLEO-IDB04A1 BLE board. Compatible with iOS/Android ST BlueMS V2.1 application.

Dependencies:   BLE_API X_NUCLEO_IDB0XA1 X_NUCLEO_IKS01A1 mbed

Fork of Bluemicrosystem1 by ST Expansion SW Team

BlueMicrosystem application

This application is the mbed equivalent of ST BlueMicrosystem1 and provides an example of motion and environmental data exported via Bluetooth Low Energy to an Android or IOS device.
It runs on a ST NUCLEO-F401RE board connected with a X-NUCLEO-IKS01A1 and a X-NUCLEO-IDB04A1 expansion boards and is compatible with Android and iOS ST BlueMS smartphone applications (based on Android and iOS BlueST SDKs).
By default the application is not providing sensor fusion and activity recognition features. However sensor fusion can be enabled following the steps below:

  • Download and install osxMotionFX library on your PC.
  • Obtain the free license for your board following the instructions
  • Copy the correct license into Middlewares/ST/STM32_OSX_MotionFX_Library/osx_license.h of your mbed program folder
  • Copy Middlewares/ST/STM32_OSX_MotionFX_Library/Inc/osx_motion_fx.h file
  • Rename the provided .lib Keil binary library giving it a .ar extension, then copy it into Middlewares/ST/STM32_OSX_MotionFX_Library/Lib of your mbed program folder
  • Enable USE_SENSOR_FUSION_LIB macro into MotionFX_Manager.h file and recompile.

CustomConsoleService.h@7:34014895dda8, 2015-12-17 (annotated)

Committer:
mapellil
Date:
Thu Dec 17 15:58:35 2015 +0000
Revision:
7:34014895dda8
Parent:
6:c1b8fb74072e
Child:
8:b042fe719f51
Updated BLE stack/API (now BigEndian UUID), set max tx power

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mapellil 6:c1b8fb74072e 1 /**
mapellil 6:c1b8fb74072e 2 ******************************************************************************
mapellil 6:c1b8fb74072e 3 * @file CustomConsoleService.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 console 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
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 0:e93a11b4e044 42
mapellil 7:34014895dda8 43 const LongUUIDBytes_t CONS_SERVICE_UUID_128 = { 0x00,0x00,0x00,0x00,0x00,0x0E,0x11,0xe1,0x9a,0xb4,0x00,0x02,0xa5,0xd5,0xc5,0x1b };
mapellil 7:34014895dda8 44 const LongUUIDBytes_t CONS_TERM_CHAR_UUID_128 = { 0x00,0x00,0x00,0x01,0x00,0x0E,0x11,0xe1,0xac,0x36,0x00,0x02,0xa5,0xd5,0xc5,0x1b };
mapellil 7:34014895dda8 45 const 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 46
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 6:c1b8fb74072e 53 CustomConsoleService(BLE &_ble, CustomBleErrManagement * ErrMgr=NULL ) :
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 6:c1b8fb74072e 78 serviceAdded = true;
mapellil 6:c1b8fb74072e 79 err = ERR_CMD_SUCCESS;
mapellil 0:e93a11b4e044 80 }
mapellil 0:e93a11b4e044 81
mapellil 0:e93a11b4e044 82 tBleStatus updateTerm (uint8_t *data,uint8_t length) {
mapellil 6:c1b8fb74072e 83 tBleStatus err;
mapellil 0:e93a11b4e044 84 uint8_t Offset;
mapellil 0:e93a11b4e044 85 uint8_t DataToSend;
mapellil 2:d61a6f4d9682 86 // uint8_t BufferToWrite[W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 2:d61a6f4d9682 87 // uint8_t BytesToWrite;
mapellil 0:e93a11b4e044 88
mapellil 0:e93a11b4e044 89 if (isEnabledTermNotify && isBTLEConnected==CONNECTED) {
mapellil 6:c1b8fb74072e 90 if (bleErrMgr != NULL) {
mapellil 6:c1b8fb74072e 91 if (!bleErrMgr->isBleTxChannelOk()){
mapellil 6:c1b8fb74072e 92 bleErrMgr->signalBleTxOk(); // skip tx because of previous error
mapellil 6:c1b8fb74072e 93 return;
mapellil 6:c1b8fb74072e 94 }
mapellil 6:c1b8fb74072e 95 }
mapellil 0:e93a11b4e044 96 /* Split the code in packages */
mapellil 0:e93a11b4e044 97 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 98 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 99 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 100
mapellil 0:e93a11b4e044 101 /* keep a copy */
mapellil 0:e93a11b4e044 102 memcpy(LastTermBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 103 LastTermLen = DataToSend;
mapellil 4:007539036889 104 PRINTF("updateTerm handle: %d string: %s\n\r", consTermCharacteristic.getValueAttribute().getHandle(), LastTermBuffer);
mapellil 6:c1b8fb74072e 105 err = ble.gattServer().write(consTermCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0);
mapellil 6:c1b8fb74072e 106 if (!err) {
mapellil 6:c1b8fb74072e 107 bleErrMgr->signalBleTxOk();
mapellil 6:c1b8fb74072e 108 }else{
mapellil 6:c1b8fb74072e 109 bleErrMgr->signalBleTxErr(err);
mapellil 6:c1b8fb74072e 110 }
mapellil 0:e93a11b4e044 111 }
mapellil 0:e93a11b4e044 112 }
mapellil 6:c1b8fb74072e 113 return err;
mapellil 0:e93a11b4e044 114 }
mapellil 0:e93a11b4e044 115
mapellil 0:e93a11b4e044 116 tBleStatus updateStderr (uint8_t *data,uint8_t length) {
mapellil 0:e93a11b4e044 117
mapellil 0:e93a11b4e044 118 uint8_t Offset;
mapellil 0:e93a11b4e044 119 uint8_t DataToSend;
mapellil 0:e93a11b4e044 120
mapellil 0:e93a11b4e044 121 if (isEnabledStderrNotify && isBTLEConnected==CONNECTED) {
mapellil 6:c1b8fb74072e 122 if (bleErrMgr != NULL) {
mapellil 6:c1b8fb74072e 123 if (!bleErrMgr->isBleTxChannelOk()){
mapellil 6:c1b8fb74072e 124 bleErrMgr->signalBleTxOk(); // skip tx because of previous error
mapellil 6:c1b8fb74072e 125 return err;
mapellil 6:c1b8fb74072e 126 }
mapellil 6:c1b8fb74072e 127 }
mapellil 0:e93a11b4e044 128 /* Split the code in packages */
mapellil 0:e93a11b4e044 129 for(Offset =0; Offset<length; Offset +=W2ST_CONSOLE_MAX_CHAR_LEN){
mapellil 0:e93a11b4e044 130 DataToSend = (length-Offset);
mapellil 0:e93a11b4e044 131 DataToSend = (DataToSend>W2ST_CONSOLE_MAX_CHAR_LEN) ? W2ST_CONSOLE_MAX_CHAR_LEN : DataToSend;
mapellil 0:e93a11b4e044 132
mapellil 0:e93a11b4e044 133 /* keep a copy */
mapellil 0:e93a11b4e044 134 memcpy(LastStderrBuffer,data+Offset,DataToSend);
mapellil 0:e93a11b4e044 135 LastStderrLen = DataToSend;
mapellil 4:007539036889 136 PRINTF("updateStderr handle: %d string: %s\n\r", consStderrCharacteristic.getValueAttribute().getHandle(), LastStderrBuffer);
mapellil 6:c1b8fb74072e 137 err = ble.gattServer().write(consStderrCharacteristic.getValueAttribute().getHandle(), data+Offset, DataToSend, 0);
mapellil 6:c1b8fb74072e 138 if (!err) {
mapellil 6:c1b8fb74072e 139 bleErrMgr->signalBleTxOk();
mapellil 6:c1b8fb74072e 140 }else{
mapellil 6:c1b8fb74072e 141 bleErrMgr->signalBleTxErr(err);
mapellil 6:c1b8fb74072e 142 }
mapellil 0:e93a11b4e044 143 }
mapellil 0:e93a11b4e044 144 }
mapellil 6:c1b8fb74072e 145 return err;
mapellil 0:e93a11b4e044 146 }
mapellil 0:e93a11b4e044 147
mapellil 0:e93a11b4e044 148 void updateConnectionStatus (ConnectionStatus_t status){
mapellil 0:e93a11b4e044 149 isBTLEConnected = status;
mapellil 0:e93a11b4e044 150 isEnabledTermNotify = false;
mapellil 6:c1b8fb74072e 151 isEnabledStderrNotify = false;
mapellil 6:c1b8fb74072e 152 err = ERR_CMD_SUCCESS;
mapellil 0:e93a11b4e044 153 }
mapellil 0:e93a11b4e044 154
mapellil 0:e93a11b4e044 155 bool isTermHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 156 if (handle == consTermCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 157 return false;
mapellil 0:e93a11b4e044 158 }
mapellil 0:e93a11b4e044 159
mapellil 0:e93a11b4e044 160 bool isStderrHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 161 if (handle == consStderrCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 162 return false;
mapellil 0:e93a11b4e044 163 }
mapellil 0:e93a11b4e044 164
mapellil 0:e93a11b4e044 165 void enNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 166 if (isTermHandle(handle)) { isEnabledTermNotify = true; return; }
mapellil 0:e93a11b4e044 167 if (isStderrHandle(handle)) { isEnabledStderrNotify = true; return; }
mapellil 0:e93a11b4e044 168 }
mapellil 0:e93a11b4e044 169
mapellil 0:e93a11b4e044 170 void disNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 171 if (isTermHandle(handle)) { isEnabledTermNotify = false; return; }
mapellil 0:e93a11b4e044 172 if (isStderrHandle(handle)) { isEnabledStderrNotify = false; return; }
mapellil 0:e93a11b4e044 173 }
mapellil 0:e93a11b4e044 174
mapellil 0:e93a11b4e044 175
mapellil 0:e93a11b4e044 176 private:
mapellil 6:c1b8fb74072e 177 BLE &ble;
mapellil 6:c1b8fb74072e 178 CustomBleErrManagement *bleErrMgr;
mapellil 0:e93a11b4e044 179 uint8_t LastTermBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 180 uint8_t LastTermLen;
mapellil 0:e93a11b4e044 181 uint8_t LastStderrBuffer [W2ST_CONSOLE_MAX_CHAR_LEN];
mapellil 0:e93a11b4e044 182 uint8_t LastStderrLen;
mapellil 0:e93a11b4e044 183
mapellil 0:e93a11b4e044 184 GattCharacteristic consTermCharacteristic;
mapellil 0:e93a11b4e044 185 GattCharacteristic consStderrCharacteristic;
mapellil 0:e93a11b4e044 186 ConnectionStatus_t isBTLEConnected;
mapellil 0:e93a11b4e044 187 bool isEnabledTermNotify;
mapellil 0:e93a11b4e044 188 bool isEnabledStderrNotify;
mapellil 6:c1b8fb74072e 189 tBleStatus err;
mapellil 0:e93a11b4e044 190 };
mapellil 0:e93a11b4e044 191
mapellil 0:e93a11b4e044 192 #endif /* #ifndef __CUSTOM_BLE_CONSOLE_SERVICE_H__*/