BLE_Button is a BLE service template. It handles a read-only characteristic with a simple input (boolean values). The input's source is the button on the board itself - the characteristic's value changes when the button is pressed or released. The canonical source for this example lives at https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_Button

Embed: (wiki syntax)

« Back to documentation index

Show/hide line numbers <title>ButtonService.h Source File</title>

ButtonService.h

00001 /* mbed Microcontroller Library
00002  * Copyright (c) 2006-2013 ARM Limited
00003  *
00004  * Licensed under the Apache License, Version 2.0 (the "License");
00005  * you may not use this file except in compliance with the License.
00006  * You may obtain a copy of the License at
00007  *
00008  *     http://www.apache.org/licenses/LICENSE-2.0
00009  *
00010  * Unless required by applicable law or agreed to in writing, software
00011  * distributed under the License is distributed on an "AS IS" BASIS,
00012  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
00013  * See the License for the specific language governing permissions and
00014  * limitations under the License.
00015  */
00016 
00017 #ifndef __BLE_BUTTON_SERVICE_H__
00018 #define __BLE_BUTTON_SERVICE_H__
00019 
00020 class ButtonService {
00021 public:
00022     const static uint16_t BUTTON_SERVICE_UUID              = 0xA000;
00023     const static uint16_t BUTTON_STATE_CHARACTERISTIC_UUID = 0xA001;
00024 
00025     ButtonService(BLE &_ble, bool buttonPressedInitial) :
00026         ble(_ble), buttonState(BUTTON_STATE_CHARACTERISTIC_UUID, &buttonPressedInitial, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
00027     {
00028         GattCharacteristic *charTable[] = {&buttonState};
00029         GattService         buttonService(ButtonService::BUTTON_SERVICE_UUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
00030         ble.gattServer().addService(buttonService);
00031     }
00032 
00033     void updateButtonState(bool newState) {
00034         ble.gattServer().write(buttonState.getValueHandle(), (uint8_t *)&newState, sizeof(bool));
00035     }
00036 
00037 private:
00038     BLE                              &ble;
00039     ReadOnlyGattCharacteristic<bool>  buttonState;
00040 };
00041 
00042 #endif /* #ifndef __BLE_BUTTON_SERVICE_H__ */