Bluetooth Low Energy
BLE demo for the Health-Thermometer service.
Dependencies: BLE_API mbed nRF51822 X_NUCLEO_IDB0XA1
This example demonstrates how to use the Health Thermometer Service. The Health Thermometer service reports two pieces of information, Temperature and Sensor Location.
API
Import library
Public Types |
|
| enum |
SensorLocation_t
{
LOCATION_ARMPIT = 1, LOCATION_BODY , LOCATION_EAR , LOCATION_FINGER , LOCATION_GI_TRACT , LOCATION_MOUTH , LOCATION_RECTUM , LOCATION_TOE , LOCATION_EAR_DRUM } |
Public Member Functions |
|
| HealthThermometerService ( BLE &_ble, float initialTemp, uint8_t _location) | |
|
Add the Health Thermometer Service to an existing
BLE
object, initialize with temperature and location.
|
|
| void | updateTemperature (float temperature) |
|
Update the temperature being broadcast.
|
|
| void | updateLocation ( SensorLocation_t loc) |
|
Update the location.
|
|
Technical Details
Further Technical Details can be found at the following links
- Temperature Service : Gatt profile details from bluetooth.org
- Temperature Measurement : Gatt Characteristic details
- Temperature Type : Gatt Characteristic details
Revision 4:83c07b0e93d6, committed 2014-09-22
- Comitter:
- rgrover1
- Date:
- Mon Sep 22 10:47:20 2014 +0000
- Parent:
- 3:8733f3e50c84
- Child:
- 5:349c49d015f5
- Commit message:
- updating to 0.2.0 of the BLE_API
Changed in this revision
--- a/BLE_API.lib Thu Sep 04 07:14:25 2014 +0000 +++ b/BLE_API.lib Mon Sep 22 10:47:20 2014 +0000 @@ -1,1 +1,1 @@ -http://mbed.org/teams/Bluetooth-Low-Energy/code/BLE_API/#ca826083980e +http://mbed.org/teams/Bluetooth-Low-Energy/code/BLE_API/#620d28e7a1ba
--- a/HealthThermometerService.h Thu Sep 04 07:14:25 2014 +0000
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,130 +0,0 @@
-/* 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 __BLE_HEALTH_THERMOMETER_SERVICE_H__
-#define __BLE_HEALTH_THERMOMETER_SERVICE_H__
-
-#include "BLEDevice.h"
-
-/* Health Thermometer Service */
-/* Service: https://developer.bluetooth.org/gatt/profiles/Pages/ProfileViewer.aspx?u=org.bluetooth.profile.health_thermometer.xml */
-/* Temperature Measurement: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_measurement.xml */
-/* Temperature Type: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_type.xml */
-class HealthThermometerService {
-public:
- enum {
- LOCATION_ARMPIT = 1,
- LOCATION_BODY,
- LOCATION_EAR,
- LOCATION_FINGER,
- LOCATION_GI_TRACT,
- LOCATION_MOUTH,
- LOCATION_RECTUM,
- LOCATION_TOE,
- LOCATION_EAR_DRUM,
- };
-
-public:
-
- /**
- * @param[in] _ble reference to the BLE device
- * @param[in] initialTemp initial value in celsius
- * @param[in] _location
- */
- HealthThermometerService(BLEDevice &_ble, float initialTemp, uint8_t _location) :
- ble(_ble),
- valueBytes(initialTemp),
- tempMeasurement(GattCharacteristic::UUID_TEMPERATURE_MEASUREMENT_CHAR, valueBytes.getPointer(),
- sizeof(TemperatureValueBytes), sizeof(TemperatureValueBytes),
- GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY),
- tempLocation(GattCharacteristic::UUID_TEMPERATURE_TYPE_CHAR, (uint8_t *)&_location, sizeof(_location), sizeof(_location),
- GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ) {
-
- GattCharacteristic *hrmChars[] = {&tempMeasurement, &tempLocation, };
- GattService hrmService(GattService::UUID_HEALTH_THERMOMETER_SERVICE, hrmChars, sizeof(hrmChars) / sizeof(GattCharacteristic *));
-
- ble.addService(hrmService);
- }
-
- void updateTemperature(float temperature) {
- if (ble.getGapState().connected) {
- valueBytes.updateTemperature(temperature);
- ble.updateCharacteristicValue(tempMeasurement.getValueAttribute().getHandle(), valueBytes.getPointer(), sizeof(TemperatureValueBytes));
- }
- }
-
-private:
- /* Private internal representation for the bytes used to work with the vaulue of the heart-rate characteristic. */
- struct TemperatureValueBytes {
- static const unsigned OFFSET_OF_FLAGS = 0;
- static const unsigned OFFSET_OF_VALUE = OFFSET_OF_FLAGS + sizeof(uint8_t);
- static const unsigned SIZEOF_VALUE_BYTES = sizeof(uint8_t) + sizeof(float);
-
- static const unsigned TEMPERATURE_UNITS_FLAG_POS = 0;
- static const unsigned TIMESTAMP_FLAG_POS = 1;
- static const unsigned TEMPERATURE_TYPE_FLAG_POS = 2;
-
- static const uint8_t TEMPERATURE_UNITS_CELSIUS = 0;
- static const uint8_t TEMPERATURE_UNITS_FAHRENHEIT = 1;
-
- TemperatureValueBytes(float initialTemperature) : bytes() {
- /* assumption: temperature values are expressed in Celsius */
- bytes[OFFSET_OF_FLAGS] = (TEMPERATURE_UNITS_CELSIUS << TEMPERATURE_UNITS_FLAG_POS) |
- (false << TIMESTAMP_FLAG_POS) |
- (false << TEMPERATURE_TYPE_FLAG_POS);
- updateTemperature(initialTemperature);
- }
-
- void updateTemperature(float temp) {
- uint32_t temp_ieee11073 = quick_ieee11073_from_float(temp);
- memcpy(&bytes[OFFSET_OF_VALUE], &temp_ieee11073, sizeof(float));
- }
-
- uint8_t *getPointer(void) {
- return bytes;
- }
-
- const uint8_t *getPointer(void) const {
- return bytes;
- }
-
- private:
- /**
- * @brief A very quick conversion between a float temperature and 11073-20601 FLOAT-Type.
- * @param temperature The temperature as a float.
- * @return The temperature in 11073-20601 FLOAT-Type format.
- */
- uint32_t quick_ieee11073_from_float(float temperature) {
- uint8_t exponent = 0xFE; //exponent is -2
- uint32_t mantissa = (uint32_t)(temperature * 100);
-
- return (((uint32_t)exponent) << 24) | mantissa;
- }
-
- private:
- /* First byte = 8-bit flags, Second field is a float holding the temperature value. */
- /* See --> https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature_measurement.xml */
- uint8_t bytes[SIZEOF_VALUE_BYTES];
- };
-
-private:
- BLEDevice &ble;
- TemperatureValueBytes valueBytes;
- GattCharacteristic tempMeasurement;
- GattCharacteristic tempLocation;
-};
-
-#endif /* #ifndef __BLE_HEALTH_THERMOMETER_SERVICE_H__*/
--- a/main.cpp Thu Sep 04 07:14:25 2014 +0000
+++ b/main.cpp Mon Sep 22 10:47:20 2014 +0000
@@ -20,9 +20,10 @@
#include "DHT.h"
BLEDevice ble;
+DigitalOut led1(LED1);
DHT sensor(D10, DHT11);
-#define NEED_CONSOLE_OUTPUT 1 /* Set this if you need debug messages on the console;
+#define NEED_CONSOLE_OUTPUT 0 /* Set this if you need debug messages on the console;
* it will have an impact on code-size and power consumption. */
#if NEED_CONSOLE_OUTPUT
@@ -45,6 +46,8 @@
void periodicCallback(void)
{
+ led1 = !led1; /* Do blinky on LED1 while we're waiting for BLE events */
+
/* Note that the periodicCallback() executes in interrupt context, so it is safer to do
* heavy-weight sensor polling from the main thread. */
triggerSensorPolling = true;
@@ -52,8 +55,9 @@
int main(void)
{
+ led1 = 1;
Ticker ticker;
- ticker.attach(periodicCallback, 3);
+ ticker.attach(periodicCallback, 1);
DEBUG("Initialising the nRF51822\n\r");
ble.init();
@@ -71,18 +75,19 @@
float initialTemperature = 39.6;
HealthThermometerService thermometerService(ble, initialTemperature, HealthThermometerService::LOCATION_EAR);
+ int error = 0;
+ float c = 0.0f;
+
while (true) {
if (triggerSensorPolling) {
triggerSensorPolling = false;
- wait(2);
-
/* Do blocking calls or whatever is necessary for sensor polling. */
/* In our case, we simply update the dummy HRM measurement. */
- int error = sensor.readData();
- DEBUG("sensor read returned %d\r\n", error);
+ error = sensor.readData();
if (!error) {
- thermometerService.updateTemperature(sensor.ReadTemperature(CELCIUS));
+ c = sensor.ReadTemperature(CELCIUS);
+ thermometerService.updateTemperature(c);
}
} else {
ble.waitForEvent();
--- a/mbed-src.lib Thu Sep 04 07:14:25 2014 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -http://mbed.org/users/mbed_official/code/mbed-src/#1f0269907d8b
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mbed.bld Mon Sep 22 10:47:20 2014 +0000 @@ -0,0 +1,1 @@ +http://mbed.org/users/mbed_official/code/mbed/builds/552587b429a1 \ No newline at end of file
--- a/nRF51822.lib Thu Sep 04 07:14:25 2014 +0000 +++ b/nRF51822.lib Mon Sep 22 10:47:20 2014 +0000 @@ -1,1 +1,1 @@ -http://mbed.org/teams/Nordic-Semiconductor/code/nRF51822/#e861f2041469 +http://mbed.org/teams/Nordic-Semiconductor/code/nRF51822/#b3680699d9a4