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.
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 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 7:34014895dda8 49 const LongUUIDBytes_t CONFIG_SERVICE_UUID_128 = {0x00,0x00,0x00,0x00,0x00,0x0F,0x11,0xe1,0x9a,0xb4,0x00,0x02,0xa5,0xd5,0xc5,0x1b};
mapellil 7:34014895dda8 50 const LongUUIDBytes_t CONFIG_W2ST_CHAR_UUID = {0x00,0x00,0x00,0x02,0x00,0x0F,0x11,0xe1,0xac,0x36,0x00,0x02,0xa5,0xd5,0xc5,0x1b};
mapellil 0:e93a11b4e044 51
mapellil 0:e93a11b4e044 52 /* Custom Config Service */
mapellil 0:e93a11b4e044 53 class CustomConfigService {
mapellil 0:e93a11b4e044 54 public:
mapellil 6:c1b8fb74072e 55 CustomConfigService(BLE &_ble, CustomBleErrManagement * ErrMgr=NULL ) :
mapellil 0:e93a11b4e044 56 ble(_ble),
mapellil 0:e93a11b4e044 57 configw2stCharacteristic(CONFIG_W2ST_CHAR_UUID, configData, SIZEOF_CONFIG_DATA_LEN, SIZEOF_CONFIG_DATA_LEN,
mapellil 0:e93a11b4e044 58 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY |
mapellil 0:e93a11b4e044 59 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE
mapellil 0:e93a11b4e044 60 ) {
mapellil 0:e93a11b4e044 61
mapellil 0:e93a11b4e044 62 static bool serviceAdded = false; /* We should only ever need to add the heart rate service once. */
mapellil 0:e93a11b4e044 63 if (serviceAdded) {
mapellil 0:e93a11b4e044 64 return;
mapellil 0:e93a11b4e044 65 }
mapellil 0:e93a11b4e044 66
mapellil 0:e93a11b4e044 67 GattCharacteristic *charTable[] = {&configw2stCharacteristic};
mapellil 0:e93a11b4e044 68
mapellil 0:e93a11b4e044 69 GattService configService(CONFIG_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
mapellil 0:e93a11b4e044 70
mapellil 0:e93a11b4e044 71 ble.gattServer().addService(configService);
mapellil 0:e93a11b4e044 72
mapellil 0:e93a11b4e044 73 isEnabledConfNotify = false;
mapellil 0:e93a11b4e044 74 memset (configData, 0, SIZEOF_CONFIG_DATA_LEN);
mapellil 0:e93a11b4e044 75 serviceAdded = true;
mapellil 0:e93a11b4e044 76 }
mapellil 0:e93a11b4e044 77
mapellil 0:e93a11b4e044 78
mapellil 6:c1b8fb74072e 79 void sendConfigState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
mapellil 6:c1b8fb74072e 80 if (bleErrMgr != NULL) {
mapellil 6:c1b8fb74072e 81 if (!bleErrMgr->isBleTxChannelOk()){
mapellil 6:c1b8fb74072e 82 bleErrMgr->signalBleTxOk(); // skip tx because of previous error
mapellil 6:c1b8fb74072e 83 return;
mapellil 6:c1b8fb74072e 84 }
mapellil 6:c1b8fb74072e 85 }
mapellil 0:e93a11b4e044 86 STORE_LE_16(configData ,TimeStamp);
mapellil 0:e93a11b4e044 87 STORE_BE_32(configData+2,Feature);
mapellil 0:e93a11b4e044 88 configData[6] = Command;
mapellil 0:e93a11b4e044 89 configData[7] = (val==0x01) ? 100: val;
mapellil 6:c1b8fb74072e 90 uint32_t err = ble.gattServer().write(configw2stCharacteristic.getValueAttribute().getHandle(), configData, SIZEOF_CONFIG_DATA_LEN, 0);
mapellil 6:c1b8fb74072e 91 if (!err) {
mapellil 6:c1b8fb74072e 92 bleErrMgr->signalBleTxOk();
mapellil 6:c1b8fb74072e 93 }else{
mapellil 6:c1b8fb74072e 94 bleErrMgr->signalBleTxErr(err);
mapellil 6:c1b8fb74072e 95 }
mapellil 0:e93a11b4e044 96 }
mapellil 0:e93a11b4e044 97
mapellil 0:e93a11b4e044 98 void updateConfigState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
mapellil 0:e93a11b4e044 99 if (ble.getGapState().connected && isEnabledConfNotify ) {
mapellil 0:e93a11b4e044 100 sendConfigState(Feature, Command, val, TimeStamp);
mapellil 0:e93a11b4e044 101 }
mapellil 0:e93a11b4e044 102 }
mapellil 0:e93a11b4e044 103
mapellil 0:e93a11b4e044 104 void updateConnectionStatus(ConnectionStatus_t status) {
mapellil 0:e93a11b4e044 105 isEnabledConfNotify = false;
mapellil 0:e93a11b4e044 106 memset (configData, 0, SIZEOF_CONFIG_DATA_LEN);
mapellil 0:e93a11b4e044 107 }
mapellil 0:e93a11b4e044 108
mapellil 0:e93a11b4e044 109 bool isConfHandle (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 110 if (handle == configw2stCharacteristic.getValueAttribute().getHandle()) return true;
mapellil 0:e93a11b4e044 111 return false;
mapellil 0:e93a11b4e044 112 }
mapellil 0:e93a11b4e044 113
mapellil 0:e93a11b4e044 114 void enNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 115 if (isConfHandle(handle)) {
mapellil 5:c3ba16d6612d 116 PRINTF("enNotify! %d\n\r", handle); isEnabledConfNotify = true; return; }
mapellil 0:e93a11b4e044 117 }
mapellil 0:e93a11b4e044 118
mapellil 0:e93a11b4e044 119 void disNotify (Gap::Handle_t handle) {
mapellil 0:e93a11b4e044 120 if (isConfHandle(handle)) {
mapellil 0:e93a11b4e044 121 isEnabledConfNotify = false; return; }
mapellil 0:e93a11b4e044 122 }
mapellil 0:e93a11b4e044 123
mapellil 0:e93a11b4e044 124 private:
mapellil 6:c1b8fb74072e 125 BLE &ble;
mapellil 6:c1b8fb74072e 126 CustomBleErrManagement *bleErrMgr;
mapellil 6:c1b8fb74072e 127 uint8_t configData[SIZEOF_CONFIG_DATA_LEN];
mapellil 6:c1b8fb74072e 128 uint8_t configState;
mapellil 6:c1b8fb74072e 129 GattCharacteristic configw2stCharacteristic;
mapellil 6:c1b8fb74072e 130 bool isEnabledConfNotify;
mapellil 0:e93a11b4e044 131
mapellil 0:e93a11b4e044 132 };
mapellil 0:e93a11b4e044 133
mapellil 0:e93a11b4e044 134 #endif /* #ifndef __CUSTOM_BLE_CONFIG_SERVICE_H__*/