Bluetooth Low Energy / Mbed 2 deprecated BLE_Button

A template for applications where some small amount of data needs to be notified to a phone app over BLE. It is a good starting point for notifications.

Dependencies:   BLE_API mbed nRF51822

Demo for an Input Service

To help you create your own BLE services, we've created a series of service templates. The *input service template* demonstrates the use of a simple input (boolean values) from a read-only characteristic.

The template covers:

1. Setting up advertising and connection states.

2. Assigning UUIDs to the service and its characteristic.

3. Creating an input characteristic: read-only, boolean, with notifications. This characteristic is updated according to the button's state.

4. Constructing a service class and adding it to the BLE stack.

ButtonService.h@0:28f095301cb2, 2015-02-17 (annotated)

Committer:
rgrover1
Date:
Tue Feb 17 16:46:22 2015 +0000
Revision:
0:28f095301cb2
Child:
1:7202df456146
BLE_Button

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 0:28f095301cb2 1 /* mbed Microcontroller Library
rgrover1 0:28f095301cb2 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 0:28f095301cb2 3 *
rgrover1 0:28f095301cb2 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 0:28f095301cb2 5 * you may not use this file except in compliance with the License.
rgrover1 0:28f095301cb2 6 * You may obtain a copy of the License at
rgrover1 0:28f095301cb2 7 *
rgrover1 0:28f095301cb2 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 0:28f095301cb2 9 *
rgrover1 0:28f095301cb2 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 0:28f095301cb2 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 0:28f095301cb2 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 0:28f095301cb2 13 * See the License for the specific language governing permissions and
rgrover1 0:28f095301cb2 14 * limitations under the License.
rgrover1 0:28f095301cb2 15 */
rgrover1 0:28f095301cb2 16
rgrover1 0:28f095301cb2 17 #ifndef __BLE_BUTTON_SERVICE_H__
rgrover1 0:28f095301cb2 18 #define __BLE_BUTTON_SERVICE_H__
rgrover1 0:28f095301cb2 19
rgrover1 0:28f095301cb2 20 class ButtonService {
rgrover1 0:28f095301cb2 21 public:
rgrover1 0:28f095301cb2 22 const static uint16_t BUTTON_SERVICE_UUID = 0xA000;
rgrover1 0:28f095301cb2 23 const static uint16_t BUTTON_STATE_CHARACTERISTIC_UUID = 0xA000;
rgrover1 0:28f095301cb2 24
rgrover1 0:28f095301cb2 25 ButtonService(BLEDevice &_ble, bool buttonPressedInitial) :
rgrover1 0:28f095301cb2 26 ble(_ble), buttonState(BUTTON_STATE_CHARACTERISTIC_UUID, &buttonPressedInitial, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
rgrover1 0:28f095301cb2 27 {
rgrover1 0:28f095301cb2 28 GattCharacteristic *charTable[] = {&buttonState};
rgrover1 0:28f095301cb2 29 GattService buttonService(ButtonService::BUTTON_SERVICE_UUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
rgrover1 0:28f095301cb2 30 ble.addService(buttonService);
rgrover1 0:28f095301cb2 31 }
rgrover1 0:28f095301cb2 32
rgrover1 0:28f095301cb2 33 void updateButtonState(bool newState) {
rgrover1 0:28f095301cb2 34 ble.updateCharacteristicValue(buttonState.getValueHandle(), (uint8_t *)&newState, sizeof(bool));
rgrover1 0:28f095301cb2 35 }
rgrover1 0:28f095301cb2 36
rgrover1 0:28f095301cb2 37 private:
rgrover1 0:28f095301cb2 38 BLEDevice &ble;
rgrover1 0:28f095301cb2 39 ReadOnlyGattCharacteristic<bool> buttonState;
rgrover1 0:28f095301cb2 40 };
rgrover1 0:28f095301cb2 41
rgrover1 0:28f095301cb2 42 #endif /* #ifndef __BLE_BUTTON_SERVICE_H__ */