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 13:53:13 2015 +0000
Revision:
6:c1b8fb74072e
Parent:
3:a24a30b28dd7
Child:
8:b042fe719f51
I2C@400KHz, BLE app congestion management, license disclaimer

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 __MAIN_H__
mapellil 0:e93a11b4e044 18 #define __MAIN_H__
mapellil 0:e93a11b4e044 19
mapellil 0:e93a11b4e044 20 /* Enable the following define for printout the calibration value
mapellil 0:e93a11b4e044 21 read/written from/to Memory */
mapellil 0:e93a11b4e044 22
mapellil 0:e93a11b4e044 23 //#define BLUEMSYS_DEBUG_CALIB
mapellil 6:c1b8fb74072e 24 #define CUST_BLEERR_MNGT // Uncomment to enable application BLE error management (congestion control)
mapellil 0:e93a11b4e044 25
mapellil 0:e93a11b4e044 26 #define CUST_CONS_SERV // Uncomment to enable console service
mapellil 0:e93a11b4e044 27
mapellil 0:e93a11b4e044 28 //#define CUST_BATT_SERV // Uncomment to enable battery service /** FIXME tb implemented **/
mapellil 0:e93a11b4e044 29
mapellil 0:e93a11b4e044 30 #define CUST_SENS_SERV // Uncomment to enable env/MEMS sensor service
mapellil 0:e93a11b4e044 31 #define DS3_ONBOARD false // deft DS3 module NOT plugged onto MEMS exp board
mapellil 0:e93a11b4e044 32 //#define DS3_ONBOARD true // Uncomment if DS3 module is plugged onto MEMS exp board
mapellil 0:e93a11b4e044 33
mapellil 0:e93a11b4e044 34 #ifdef USE_SENSOR_FUSION_LIB // if sensor fusion lib present enable calibration service and quaternion service
mapellil 0:e93a11b4e044 35 #define CUST_CONFIG_SERV // enable magnetometer calibration service
mapellil 1:5fb861c45605 36 #define BLUEMSYS_STORE_CALIB_FLASH // enable flash storage of calibration data
mapellil 0:e93a11b4e044 37 #define CUST_SW_SERV // enable quaternion service
mapellil 0:e93a11b4e044 38 #endif
mapellil 0:e93a11b4e044 39
mapellil 0:e93a11b4e044 40 /*************** Debug Defines ******************/
mapellil 0:e93a11b4e044 41 /* For enabling connection and notification subscriptions debug */
mapellil 0:e93a11b4e044 42 //#define BLUEMSYS_DEBUG_CONNECTION
mapellil 0:e93a11b4e044 43
mapellil 0:e93a11b4e044 44 /* For enabling trasmission for notified services (except for quaternions) */
mapellil 0:e93a11b4e044 45 //#define BLUEMSYS_DEBUG_NOTIFY_TRAMISSION
mapellil 0:e93a11b4e044 46
mapellil 0:e93a11b4e044 47 #define MAX_I2C_SPEED 400000
mapellil 6:c1b8fb74072e 48 #define NUCLEO_I2C_SHIELDS_SPEED MAX_I2C_SPEED // I2C speed in Hz
mapellil 0:e93a11b4e044 49 //#define NUCLEO_I2C_SHIELDS_SPEED 150000 // I2C speed in Hz. Max Speed 400KHz now limited because of MEMS board
mapellil 0:e93a11b4e044 50
mapellil 0:e93a11b4e044 51 #define ENV_TIMER 500000 // 500 mSec
mapellil 0:e93a11b4e044 52 #define CALIB_TIMER 40000 // 40mS
mapellil 0:e93a11b4e044 53 #define MEMS_TIMER 10000 // 10mS
mapellil 0:e93a11b4e044 54
mapellil 0:e93a11b4e044 55 /*************** Don't Change the following defines *************/
mapellil 0:e93a11b4e044 56 /* Calibration mask for Sensor fusion short precision */
mapellil 0:e93a11b4e044 57 #define MASK_CALIB_SENSORFUSION_SHORT 0x00000100
mapellil 0:e93a11b4e044 58 /* Calibration mask for Sensor fusion float precision */
mapellil 0:e93a11b4e044 59 #define MASK_CALIB_SENSORFUSION_FLOAT 0x00000080
mapellil 0:e93a11b4e044 60 /* W2ST command for asking the calibration status */
mapellil 0:e93a11b4e044 61 #define W2ST_COMMAND_CAL_STATUS 0xFF
mapellil 0:e93a11b4e044 62 /* W2ST command for resetting the calibration */
mapellil 0:e93a11b4e044 63 #define W2ST_COMMAND_CAL_RESET 0x00
mapellil 0:e93a11b4e044 64 /* W2ST command for stopping the calibration process */
mapellil 0:e93a11b4e044 65 #define W2ST_COMMAND_CAL_STOP 0x01
mapellil 0:e93a11b4e044 66 /****************************************************************/
mapellil 0:e93a11b4e044 67
mapellil 3:a24a30b28dd7 68 #define BLE_DEV_NAME "BlueMbed"
mapellil 0:e93a11b4e044 69 #define BLE_DEV_MAC 0xFF,0x00,0x25,0xAA,0x02,0x04
mapellil 0:e93a11b4e044 70 #define QUAT_FLOAT_UPDATE_MUL_10MS 2
mapellil 0:e93a11b4e044 71 #define ACC_GYRO_MAG_UPDATE_MUL_10MS 10
mapellil 0:e93a11b4e044 72
mapellil 0:e93a11b4e044 73 #define BLUEMSYS_CHECK_CALIBRATION ((uint32_t)0x12345678)
mapellil 0:e93a11b4e044 74
mapellil 0:e93a11b4e044 75 #define BUTTON_TIME 1.0 // 1.0Sec
mapellil 0:e93a11b4e044 76 #define BLUEMSYS_N_BUTTON_PRESS 3 // n push button in BUTTON_TIME
mapellil 0:e93a11b4e044 77
mapellil 0:e93a11b4e044 78 #ifdef BLUEMSYS_STORE_CALIB_FLASH
mapellil 0:e93a11b4e044 79 #define BLUEMSYS_FLASH_ADD ((uint32_t)0x08060000)
mapellil 0:e93a11b4e044 80 #define BLUEMSYS_FLASH_SECTOR FLASH_SECTOR_7
mapellil 0:e93a11b4e044 81 #else /* BLUEMSYS_STORE_CALIB_FLASH */
mapellil 0:e93a11b4e044 82 #if defined (__IAR_SYSTEMS_ICC__)
mapellil 0:e93a11b4e044 83 __no_init uint32_t CalibrationStructureRAM[8];
mapellil 0:e93a11b4e044 84 #elif defined (__CC_ARM)
mapellil 0:e93a11b4e044 85 uint32_t *CalibrationStructureRAM=(uint32_t *)0x20017FC0;
mapellil 0:e93a11b4e044 86 #elif defined (__GNUC__)
mapellil 0:e93a11b4e044 87 uint32_t CalibrationStructureRAM[8] __attribute__ ((section (".noinit")));
mapellil 0:e93a11b4e044 88 #else
mapellil 0:e93a11b4e044 89 #error "Toolchain not supported"
mapellil 0:e93a11b4e044 90 #endif
mapellil 0:e93a11b4e044 91 #endif /* BLUEMSYS_STORE_CALIB_FLASH */
mapellil 0:e93a11b4e044 92
mapellil 0:e93a11b4e044 93 #define BLE_ADVERTISING_INTERVAL 1000
mapellil 0:e93a11b4e044 94 //#define BLE_ADVERTISING_INTERVAL 160 /* 100ms; in multiples of 0.625ms. */
mapellil 0:e93a11b4e044 95
mapellil 0:e93a11b4e044 96 typedef enum ConnectionStatus_t {
mapellil 0:e93a11b4e044 97 DISCONNECTED =0,
mapellil 0:e93a11b4e044 98 CONNECTED =1
mapellil 0:e93a11b4e044 99 }cns_t;
mapellil 0:e93a11b4e044 100
mapellil 0:e93a11b4e044 101 const unsigned LENGTH_OF_LONG_UUID = 16;
mapellil 0:e93a11b4e044 102 typedef uint16_t ShortUUIDBytes_t;
mapellil 0:e93a11b4e044 103 typedef uint8_t LongUUIDBytes_t[LENGTH_OF_LONG_UUID];
mapellil 0:e93a11b4e044 104
mapellil 0:e93a11b4e044 105 #ifdef __cplusplus
mapellil 0:e93a11b4e044 106 extern "C" {
mapellil 0:e93a11b4e044 107 #endif
mapellil 0:e93a11b4e044 108
mapellil 0:e93a11b4e044 109 #ifdef __cplusplus
mapellil 0:e93a11b4e044 110 }
mapellil 0:e93a11b4e044 111 #endif
mapellil 0:e93a11b4e044 112
mapellil 0:e93a11b4e044 113 #endif // ifndef __MAIN_H__