Bluetooth Low Energy
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.
Revision 0:28f095301cb2, committed 2015-02-17
- Comitter:
- rgrover1
- Date:
- Tue Feb 17 16:46:22 2015 +0000
- Child:
- 1:7202df456146
- Commit message:
- BLE_Button
Changed in this revision
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/BLE_API.lib Tue Feb 17 16:46:22 2015 +0000 @@ -0,0 +1,1 @@ +http://mbed.org/teams/Bluetooth-Low-Energy/code/BLE_API/#1956023d42fb
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/ButtonService.h Tue Feb 17 16:46:22 2015 +0000
@@ -0,0 +1,42 @@
+/* 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_BUTTON_SERVICE_H__
+#define __BLE_BUTTON_SERVICE_H__
+
+class ButtonService {
+public:
+ const static uint16_t BUTTON_SERVICE_UUID = 0xA000;
+ const static uint16_t BUTTON_STATE_CHARACTERISTIC_UUID = 0xA000;
+
+ ButtonService(BLEDevice &_ble, bool buttonPressedInitial) :
+ ble(_ble), buttonState(BUTTON_STATE_CHARACTERISTIC_UUID, &buttonPressedInitial, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
+ {
+ GattCharacteristic *charTable[] = {&buttonState};
+ GattService buttonService(ButtonService::BUTTON_SERVICE_UUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
+ ble.addService(buttonService);
+ }
+
+ void updateButtonState(bool newState) {
+ ble.updateCharacteristicValue(buttonState.getValueHandle(), (uint8_t *)&newState, sizeof(bool));
+ }
+
+private:
+ BLEDevice &ble;
+ ReadOnlyGattCharacteristic<bool> buttonState;
+};
+
+#endif /* #ifndef __BLE_BUTTON_SERVICE_H__ */
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp Tue Feb 17 16:46:22 2015 +0000
@@ -0,0 +1,75 @@
+/* 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.
+ */
+
+#include "mbed.h"
+#include "BLEDevice.h"
+#include "ButtonService.h"
+
+BLEDevice ble;
+DigitalOut led1(LED1);
+InterruptIn button(BUTTON1);
+
+const static char DEVICE_NAME[] = "Button";
+static const uint16_t uuid16_list[] = {ButtonService::BUTTON_SERVICE_UUID};
+
+ButtonService *buttonServicePtr;
+
+void buttonPressedCallback(void)
+{
+ buttonServicePtr->updateButtonState(true);
+}
+
+void buttonReleasedCallback(void)
+{
+ buttonServicePtr->updateButtonState(false);
+}
+
+void disconnectionCallback(Gap::Handle_t handle, Gap::DisconnectionReason_t reason)
+{
+ ble.startAdvertising();
+}
+
+void periodicCallback(void)
+{
+ led1 = !led1; /* Do blinky on LED1 to indicate system aliveness. */
+}
+
+int main(void)
+{
+ led1 = 1;
+ Ticker ticker;
+ ticker.attach(periodicCallback, 1);
+ button.fall(buttonPressedCallback);
+ button.rise(buttonReleasedCallback);
+
+ ble.init();
+ ble.onDisconnection(disconnectionCallback);
+
+ ButtonService buttonService(ble, false /* initial value for button pressed */);
+ buttonServicePtr = &buttonService;
+
+ /* setup advertising */
+ ble.accumulateAdvertisingPayload(GapAdvertisingData::BREDR_NOT_SUPPORTED | GapAdvertisingData::LE_GENERAL_DISCOVERABLE);
+ ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LIST_16BIT_SERVICE_IDS, (uint8_t *)uuid16_list, sizeof(uuid16_list));
+ ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LOCAL_NAME, (uint8_t *)DEVICE_NAME, sizeof(DEVICE_NAME));
+ ble.setAdvertisingType(GapAdvertisingParams::ADV_CONNECTABLE_UNDIRECTED);
+ ble.setAdvertisingInterval(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(1000)); /* 1000ms. */
+ ble.startAdvertising();
+
+ while (true) {
+ ble.waitForEvent();
+ }
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mbed.bld Tue Feb 17 16:46:22 2015 +0000 @@ -0,0 +1,1 @@ +http://mbed.org/users/mbed_official/code/mbed/builds/9ad691361fac \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/nRF51822.lib Tue Feb 17 16:46:22 2015 +0000 @@ -0,0 +1,1 @@ +http://mbed.org/teams/Nordic-Semiconductor/code/nRF51822/#0e7a9efee6d7