ST
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.
CustomSensorsService.h
- Committer:
- mapellil
- Date:
- 2015-11-20
- Revision:
- 4:007539036889
- Parent:
- 0:e93a11b4e044
- Child:
- 6:c1b8fb74072e
File content as of revision 4:007539036889:
/* mbed Microcontroller Library
* Copyright (c) 2006-2013 ARM Limited
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __CUSTOM_BLE_SENSORS_SERVICE_H__
#define __CUSTOM_BLE_SENSORS_SERVICE_H__
#include "BLE.h"
const LongUUIDBytes_t SENS_SERVICE_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0xb4,0x9a,0xe1,0x11,0x01,0x00,0x00,0x00,0x00,0x00}; // temp, pressure, humidity,
const LongUUIDBytes_t SENS_TEMP_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x04,0x00 };
const LongUUIDBytes_t SENS_HUMI_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x08,0x00};
const LongUUIDBytes_t SENS_PRES_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x10,0x00};
const LongUUIDBytes_t SENS_MAGN_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x20,0x00};
const LongUUIDBytes_t SENS_GYRO_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x40,0x00};
const LongUUIDBytes_t SENS_ACCE_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0x80,0x00};
const LongUUIDBytes_t SENS_ACC_GYRO_MAG_CHAR_UUID_128 = { 0x1b,0xc5,0xa5,0xd5,0x02,0x00,0x36,0xac,0xe1,0x11,0x01,0x00,0x00,0x00,0xE0,0x00};
#define TEMP_DATA_LEN 2+2
#define HUM_DATA_LEN 2+2
#define PRES_DATA_LEN 2+4
#define ACC_DATA_LEN 6+2
#define MAG_DATA_LEN 6+2
#define GYRO_DATA_LEN 6+2
#define ACCGYROMAG_DATA_LEN 2+3*3*2
/* Custom Sensors Service */
class CustomSensorService {
public:
CustomSensorService(BLEDevice &_ble) :
ble(_ble),
envTemperatureCharacteristic(SENS_TEMP_CHAR_UUID_128,envTemperature, TEMP_DATA_LEN, TEMP_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envHumidityCharacteristic(SENS_HUMI_CHAR_UUID_128, envHumidity, HUM_DATA_LEN, HUM_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envPressureCharacteristic(SENS_PRES_CHAR_UUID_128, envPressure, PRES_DATA_LEN, PRES_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envMagnetometerCharacteristic(SENS_MAGN_CHAR_UUID_128,envMagn, MAG_DATA_LEN, MAG_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envAccelerometerCharacteristic(SENS_ACCE_CHAR_UUID_128,envAcce, ACC_DATA_LEN, ACC_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envGyroCharacteristic(SENS_GYRO_CHAR_UUID_128,envGyro, GYRO_DATA_LEN, GYRO_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
envAccGyroMagCharacteristic(SENS_ACC_GYRO_MAG_CHAR_UUID_128,envAccGyroMag, ACCGYROMAG_DATA_LEN, ACCGYROMAG_DATA_LEN,
GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
{
static bool serviceAdded = false; /* We should only ever need to add the env service once. */
if (serviceAdded) {
return;
}
GattCharacteristic *charTable[] = {&envTemperatureCharacteristic, &envHumidityCharacteristic, &envPressureCharacteristic, &envMagnetometerCharacteristic,
&envAccelerometerCharacteristic, &envGyroCharacteristic, &envAccGyroMagCharacteristic};
GattService envService(SENS_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
ble.gattServer().addService(envService);
isEnabledTempNotify = false;
isEnabledHumNotify = false;
isEnabledPresNotify = false;
isEnabledGyroNotify = false;
isEnabledAccNotify = false;
isEnabledMagNotify = false;
isEnabledAccGyroMagNotify = false;
isTempCalibrated = false;
isHumCalibrated = false;
isPresCalibrated = false;
isMagCalibrated = false;
isAccCalibrated = false;
isAGyroCalibrated = false;
memset (pastenvTemperature, 0, TEMP_DATA_LEN);
memset (pastenvHumidity, 0, HUM_DATA_LEN);
memset (pastenvPressure, 0, PRES_DATA_LEN);
isBTLEConnected = DISCONNECTED;
serviceAdded = true;
}
void sendEnvTemperature (int16_t Temp, uint16_t TimeStamp) {
STORE_LE_16(envTemperature,TimeStamp);
STORE_LE_16(envTemperature+2,Temp);
PRINTF("sendEnvTemperature!! handle: %d\n\r", envTemperatureCharacteristic.getValueAttribute().getHandle());
memcpy (pastenvTemperature, envTemperature, TEMP_DATA_LEN);
ble.gattServer().write(envTemperatureCharacteristic.getValueAttribute().getHandle(), envTemperature, TEMP_DATA_LEN, 0);
}
/**
* Update the temperature with a new value. Valid values range from
* 0..100. Anything outside this range will be ignored.
* @param newLevel New level. */
void updateEnvTemperature (int16_t Temp, uint16_t TimeStamp) {
if (memcmp (&pastenvTemperature[2], &Temp, 2) != 0) {
sendEnvTemperature (Temp, TimeStamp);
}
}
void sendEnvHumidity(uint16_t Hum, uint16_t TimeStamp) {
STORE_LE_16(envHumidity,TimeStamp);
STORE_LE_16(envHumidity+2,Hum);
memcpy (pastenvHumidity, envHumidity, HUM_DATA_LEN);
ble.gattServer().write(envHumidityCharacteristic.getValueAttribute().getHandle(), envHumidity, HUM_DATA_LEN, 0);
}
void updateEnvHumidity(uint16_t Hum, uint16_t TimeStamp) {
if (memcmp (&pastenvHumidity[2], &Hum, 2) != 0) {
sendEnvHumidity(Hum, TimeStamp);
}
}
void sendEnvPressure(uint32_t Press, uint16_t TimeStamp) {
STORE_LE_16(envPressure,TimeStamp);
STORE_LE_32(envPressure+2,Press);
memcpy (pastenvPressure, envPressure, PRES_DATA_LEN);
ble.gattServer().write(envPressureCharacteristic.getValueAttribute().getHandle(), envPressure, PRES_DATA_LEN, 0);
}
void updateEnvPressure(uint32_t Press, uint16_t TimeStamp) {
if (memcmp (&pastenvPressure[2], &Press, 2) != 0) {
sendEnvPressure(Press, TimeStamp);
}
}
void sendEnvMagnetometer(AxesRaw_TypeDef *Magn, uint16_t TimeStamp, osxMFX_calibFactor magOffset) {
STORE_LE_16(envMagn,TimeStamp);
STORE_LE_16(envMagn+2,(Magn->AXIS_X - magOffset.magOffX));
STORE_LE_16(envMagn+4,(Magn->AXIS_Y - magOffset.magOffY));
STORE_LE_16(envMagn+6,(Magn->AXIS_Z - magOffset.magOffZ));
ble.gattServer().write(envMagnetometerCharacteristic.getValueAttribute().getHandle(), envMagn, MAG_DATA_LEN, 0);
}
void updateEnvMagnetometer(AxesRaw_TypeDef *Magn, uint16_t TimeStamp, osxMFX_calibFactor magOffset) {
if (isMagNotificationEn()) sendEnvMagnetometer(Magn, TimeStamp, magOffset);
}
void sendEnvAccelerometer (AxesRaw_TypeDef *Acc, uint16_t TimeStamp) {
STORE_LE_16(envAcce,TimeStamp);
STORE_LE_16(envAcce+2,Acc->AXIS_X);
STORE_LE_16(envAcce+4,Acc->AXIS_Y);
STORE_LE_16(envAcce+6,Acc->AXIS_Z);
ble.gattServer().write(envAccelerometerCharacteristic.getValueAttribute().getHandle(), envAcce, ACC_DATA_LEN, 0);
}
void updateEnvAccelerometer (AxesRaw_TypeDef *Acc, uint16_t TimeStamp) {
if (isAccNotificationEn()) sendEnvAccelerometer (Acc, TimeStamp);
}
void sendEnvGyroscope (AxesRaw_TypeDef *Gyro, uint16_t TimeStamp) {
STORE_LE_16(envGyro,TimeStamp);
STORE_LE_16(envGyro+2,Gyro->AXIS_X);
STORE_LE_16(envGyro+4,Gyro->AXIS_Y);
STORE_LE_16(envGyro+6,Gyro->AXIS_Z);
ble.gattServer().write(envGyroCharacteristic.getValueAttribute().getHandle(), envGyro, GYRO_DATA_LEN, 0);
}
void updateEnvGyroscope (AxesRaw_TypeDef *Gyro, uint16_t TimeStamp) {
if (isGyroNotificationEn()) sendEnvGyroscope (Gyro, TimeStamp);
}
void sendEnvAccGyroMag (AxesRaw_TypeDef *Acc, AxesRaw_TypeDef *Gyro, AxesRaw_TypeDef *Magn, uint16_t TimeStamp, osxMFX_calibFactor magOffset) {
STORE_LE_16(envAccGyroMag,TimeStamp);
STORE_LE_16(envAccGyroMag+2,Acc->AXIS_X);
STORE_LE_16(envAccGyroMag+4,Acc->AXIS_Y);
STORE_LE_16(envAccGyroMag+6,Acc->AXIS_Z);
STORE_LE_16(envAccGyroMag+8,Gyro->AXIS_X);
STORE_LE_16(envAccGyroMag+10,Gyro->AXIS_Y);
STORE_LE_16(envAccGyroMag+12,Gyro->AXIS_Z);
STORE_LE_16(envAccGyroMag+14,(Magn->AXIS_X - magOffset.magOffX));
STORE_LE_16(envAccGyroMag+16,(Magn->AXIS_Y - magOffset.magOffY));
STORE_LE_16(envAccGyroMag+18,(Magn->AXIS_Z - magOffset.magOffZ));
ble.gattServer().write(envAccGyroMagCharacteristic.getValueAttribute().getHandle(), envAccGyroMag, ACCGYROMAG_DATA_LEN, 0);
}
void updateEnvAccGyroMag (AxesRaw_TypeDef *Acc, AxesRaw_TypeDef *Gyro, AxesRaw_TypeDef *Magn, uint16_t TimeStamp, osxMFX_calibFactor magOffset) {
if (isAccGyroMagNotificationEn())sendEnvAccGyroMag (Acc, Gyro, Magn, TimeStamp, magOffset);
}
void enNotify (Gap::Handle_t handle) {
if (isTempHandle(handle)) { isEnabledTempNotify = true; memset(pastenvTemperature,0,TEMP_DATA_LEN); return; }
if (isHumHandle(handle)) { isEnabledHumNotify = true; memset(pastenvHumidity,0,HUM_DATA_LEN); return; }
if (isPresHandle(handle)) { isEnabledPresNotify = true; memset(pastenvPressure,0,PRES_DATA_LEN); return; }
if (isGyroHandle(handle)) { isEnabledGyroNotify = true; return; }
if (isAccHandle(handle)) { isEnabledAccNotify = true; return; }
if (isMagHandle(handle)) { isEnabledMagNotify = true; return; }
if (isAccGyroMagHandle(handle)) { isEnabledAccGyroMagNotify = true; return; }
}
void disNotify (Gap::Handle_t handle) {
if (isTempHandle(handle)) { isEnabledTempNotify = false; memset(pastenvTemperature,0,TEMP_DATA_LEN); return; }
if (isHumHandle(handle)) { isEnabledHumNotify = false; memset(pastenvHumidity,0,HUM_DATA_LEN); return; }
if (isPresHandle(handle)) { isEnabledPresNotify = false; memset(pastenvPressure,0,PRES_DATA_LEN); return; }
if (isGyroHandle(handle)) { isEnabledGyroNotify = false; return; }
if (isAccHandle(handle)) { isEnabledAccNotify = false; return; }
if (isMagHandle(handle)) { isEnabledMagNotify = false; return; }
if (isAccGyroMagHandle(handle)) { isEnabledAccGyroMagNotify = false; return; }
}
bool isTempNotificationEn (void) {
return isEnabledTempNotify;
}
bool isHumNotificationEn (void) {
return isEnabledHumNotify;
}
bool isPresNotificationEn (void) {
return isEnabledPresNotify;
}
bool isGyroNotificationEn (void) {
return isEnabledGyroNotify;
}
bool isAccNotificationEn (void) {
return isEnabledAccNotify;
}
bool isMagNotificationEn (void) {
return isEnabledMagNotify;
}
bool isAccGyroMagNotificationEn (void) {
return isEnabledAccGyroMagNotify;
}
bool isTempHandle (Gap::Handle_t handle) {
if (handle == envTemperatureCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isHumHandle (Gap::Handle_t handle) {
if (handle == envHumidityCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isPresHandle (Gap::Handle_t handle) {
if (handle == envPressureCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isMagHandle (Gap::Handle_t handle) {
if (handle == envMagnetometerCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isAccHandle (Gap::Handle_t handle) {
if (handle == envAccelerometerCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isGyroHandle (Gap::Handle_t handle) {
if (handle == envGyroCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
bool isAccGyroMagHandle (Gap::Handle_t handle) {
if (handle == envAccGyroMagCharacteristic.getValueAttribute().getHandle()) return true;
return false;
}
void updateConnectionStatus(ConnectionStatus_t status) {
isEnabledTempNotify = false;
isEnabledHumNotify = false;
isEnabledPresNotify = false;
isEnabledGyroNotify = false;
isEnabledAccNotify = false;
isEnabledMagNotify = false;
isEnabledAccGyroMagNotify = false;
isTempCalibrated = false;
isHumCalibrated = false;
isPresCalibrated = false;
isMagCalibrated = false;
isAccCalibrated = false;
isAGyroCalibrated = false;
memset (pastenvTemperature, 0, TEMP_DATA_LEN);
memset (pastenvHumidity, 0, HUM_DATA_LEN);
memset (pastenvPressure, 0, PRES_DATA_LEN);
isBTLEConnected = status;
}
private:
BLEDevice &ble;
uint8_t envTemperature [TEMP_DATA_LEN]; /* in C */
uint8_t pastenvTemperature [TEMP_DATA_LEN];
uint8_t envHumidity [HUM_DATA_LEN]; /* in % */
uint8_t pastenvHumidity [HUM_DATA_LEN];
uint8_t envPressure [PRES_DATA_LEN]; /* in mBar */
uint8_t pastenvPressure [PRES_DATA_LEN];
uint8_t envMagn [MAG_DATA_LEN];
uint8_t envGyro [GYRO_DATA_LEN];
uint8_t envAcce [ACC_DATA_LEN];
uint8_t envAccGyroMag [ACCGYROMAG_DATA_LEN];
GattCharacteristic envTemperatureCharacteristic;
GattCharacteristic envHumidityCharacteristic;
GattCharacteristic envPressureCharacteristic;
GattCharacteristic envMagnetometerCharacteristic;
GattCharacteristic envAccelerometerCharacteristic;
GattCharacteristic envGyroCharacteristic;
GattCharacteristic envAccGyroMagCharacteristic;
ConnectionStatus_t isBTLEConnected;
bool isEnabledTempNotify;
bool isEnabledHumNotify;
bool isEnabledPresNotify;
bool isEnabledGyroNotify;
bool isEnabledAccNotify;
bool isEnabledMagNotify;
bool isEnabledAccGyroMagNotify;
bool isTempCalibrated;
bool isHumCalibrated;
bool isPresCalibrated;
bool isMagCalibrated;
bool isAccCalibrated;
bool isAGyroCalibrated;
};
#endif /* #ifndef __CUSTOM_BLE_SENSORS_SERVICE_H__*/