Rizky Ardi Maulana / mbed-os

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

features/FEATURE_BLE/ble/services/EnvironmentalService.h@0:f269e3021894, 2016-10-23 (annotated)

Committer:
elessair
Date:
Sun Oct 23 15:10:02 2016 +0000
Revision:
0:f269e3021894
Initial commit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
elessair 0:f269e3021894 1 /* mbed Microcontroller Library
elessair 0:f269e3021894 2 * Copyright (c) 2006-2013 ARM Limited
elessair 0:f269e3021894 3 *
elessair 0:f269e3021894 4 * Licensed under the Apache License, Version 2.0 (the "License");
elessair 0:f269e3021894 5 * you may not use this file except in compliance with the License.
elessair 0:f269e3021894 6 * You may obtain a copy of the License at
elessair 0:f269e3021894 7 *
elessair 0:f269e3021894 8 * http://www.apache.org/licenses/LICENSE-2.0
elessair 0:f269e3021894 9 *
elessair 0:f269e3021894 10 * Unless required by applicable law or agreed to in writing, software
elessair 0:f269e3021894 11 * distributed under the License is distributed on an "AS IS" BASIS,
elessair 0:f269e3021894 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
elessair 0:f269e3021894 13 * See the License for the specific language governing permissions and
elessair 0:f269e3021894 14 * limitations under the License.
elessair 0:f269e3021894 15 */
elessair 0:f269e3021894 16
elessair 0:f269e3021894 17 #ifndef __BLE_ENVIRONMENTAL_SERVICE_H__
elessair 0:f269e3021894 18 #define __BLE_ENVIRONMENTAL_SERVICE_H__
elessair 0:f269e3021894 19
elessair 0:f269e3021894 20 #include "ble/BLE.h"
elessair 0:f269e3021894 21
elessair 0:f269e3021894 22 /**
elessair 0:f269e3021894 23 * @class EnvironmentalService
elessair 0:f269e3021894 24 * @brief BLE Environmental Service. This service provides temperature, humidity and pressure measurement.
elessair 0:f269e3021894 25 * Service: https://developer.bluetooth.org/gatt/services/Pages/ServiceViewer.aspx?u=org.bluetooth.service.environmental_sensing.xml
elessair 0:f269e3021894 26 * Temperature: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.temperature.xml
elessair 0:f269e3021894 27 * Humidity: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.humidity.xml
elessair 0:f269e3021894 28 * Pressure: https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.pressure.xml
elessair 0:f269e3021894 29 */
elessair 0:f269e3021894 30 class EnvironmentalService {
elessair 0:f269e3021894 31 public:
elessair 0:f269e3021894 32 typedef int16_t TemperatureType_t;
elessair 0:f269e3021894 33 typedef uint16_t HumidityType_t;
elessair 0:f269e3021894 34 typedef uint32_t PressureType_t;
elessair 0:f269e3021894 35
elessair 0:f269e3021894 36 /**
elessair 0:f269e3021894 37 * @brief EnvironmentalService constructor.
elessair 0:f269e3021894 38 * @param ble Reference to BLE device.
elessair 0:f269e3021894 39 * @param temperature_en Enable this characteristic.
elessair 0:f269e3021894 40 * @param humidity_en Enable this characteristic.
elessair 0:f269e3021894 41 * @param pressure_en Enable this characteristic.
elessair 0:f269e3021894 42 */
elessair 0:f269e3021894 43 EnvironmentalService(BLE& _ble) :
elessair 0:f269e3021894 44 ble(_ble),
elessair 0:f269e3021894 45 temperatureCharacteristic(GattCharacteristic::UUID_TEMPERATURE_CHAR, &temperature),
elessair 0:f269e3021894 46 humidityCharacteristic(GattCharacteristic::UUID_HUMIDITY_CHAR, &humidity),
elessair 0:f269e3021894 47 pressureCharacteristic(GattCharacteristic::UUID_PRESSURE_CHAR, &pressure)
elessair 0:f269e3021894 48 {
elessair 0:f269e3021894 49 static bool serviceAdded = false; /* We should only ever need to add the information service once. */
elessair 0:f269e3021894 50 if (serviceAdded) {
elessair 0:f269e3021894 51 return;
elessair 0:f269e3021894 52 }
elessair 0:f269e3021894 53
elessair 0:f269e3021894 54 GattCharacteristic *charTable[] = { &humidityCharacteristic,
elessair 0:f269e3021894 55 &pressureCharacteristic,
elessair 0:f269e3021894 56 &temperatureCharacteristic };
elessair 0:f269e3021894 57
elessair 0:f269e3021894 58 GattService environmentalService(GattService::UUID_ENVIRONMENTAL_SERVICE, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
elessair 0:f269e3021894 59
elessair 0:f269e3021894 60 ble.gattServer().addService(environmentalService);
elessair 0:f269e3021894 61 serviceAdded = true;
elessair 0:f269e3021894 62 }
elessair 0:f269e3021894 63
elessair 0:f269e3021894 64 /**
elessair 0:f269e3021894 65 * @brief Update humidity characteristic.
elessair 0:f269e3021894 66 * @param newHumidityVal New humidity measurement.
elessair 0:f269e3021894 67 */
elessair 0:f269e3021894 68 void updateHumidity(HumidityType_t newHumidityVal)
elessair 0:f269e3021894 69 {
elessair 0:f269e3021894 70 humidity = (HumidityType_t) (newHumidityVal * 100);
elessair 0:f269e3021894 71 ble.gattServer().write(humidityCharacteristic.getValueHandle(), (uint8_t *) &humidity, sizeof(HumidityType_t));
elessair 0:f269e3021894 72 }
elessair 0:f269e3021894 73
elessair 0:f269e3021894 74 /**
elessair 0:f269e3021894 75 * @brief Update pressure characteristic.
elessair 0:f269e3021894 76 * @param newPressureVal New pressure measurement.
elessair 0:f269e3021894 77 */
elessair 0:f269e3021894 78 void updatePressure(PressureType_t newPressureVal)
elessair 0:f269e3021894 79 {
elessair 0:f269e3021894 80 pressure = (PressureType_t) (newPressureVal * 10);
elessair 0:f269e3021894 81 ble.gattServer().write(pressureCharacteristic.getValueHandle(), (uint8_t *) &pressure, sizeof(PressureType_t));
elessair 0:f269e3021894 82 }
elessair 0:f269e3021894 83
elessair 0:f269e3021894 84 /**
elessair 0:f269e3021894 85 * @brief Update temperature characteristic.
elessair 0:f269e3021894 86 * @param newTemperatureVal New temperature measurement.
elessair 0:f269e3021894 87 */
elessair 0:f269e3021894 88 void updateTemperature(float newTemperatureVal)
elessair 0:f269e3021894 89 {
elessair 0:f269e3021894 90 temperature = (TemperatureType_t) (newTemperatureVal * 100);
elessair 0:f269e3021894 91 ble.gattServer().write(temperatureCharacteristic.getValueHandle(), (uint8_t *) &temperature, sizeof(TemperatureType_t));
elessair 0:f269e3021894 92 }
elessair 0:f269e3021894 93
elessair 0:f269e3021894 94 private:
elessair 0:f269e3021894 95 BLE& ble;
elessair 0:f269e3021894 96
elessair 0:f269e3021894 97 TemperatureType_t temperature;
elessair 0:f269e3021894 98 HumidityType_t humidity;
elessair 0:f269e3021894 99 PressureType_t pressure;
elessair 0:f269e3021894 100
elessair 0:f269e3021894 101 ReadOnlyGattCharacteristic<TemperatureType_t> temperatureCharacteristic;
elessair 0:f269e3021894 102 ReadOnlyGattCharacteristic<HumidityType_t> humidityCharacteristic;
elessair 0:f269e3021894 103 ReadOnlyGattCharacteristic<PressureType_t> pressureCharacteristic;
elessair 0:f269e3021894 104 };
elessair 0:f269e3021894 105
elessair 0:f269e3021894 106 #endif /* #ifndef __BLE_ENVIRONMENTAL_SERVICE_H__*/