IoT Morioka private / Mbed OS mbed-os-example-ble-Beacon

This example creates a BLE beacon: a method of advertising a small amount of information to nearby devices. The information doesn't have to be human-readable; it can be in a format that only an application can use. Beacons are very easy to set up: the code for all beacons is the same, and only the information you want to advertise - the beacon payload - needs to change. he canonical source for this example lives at https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_Beacon

source/main.cpp@1:2fd54f1254fe, 2016-07-28 (annotated)

Committer:
mbed_official
Date:
Thu Jul 28 23:14:25 2016 +0100
Revision:
1:2fd54f1254fe
Parent:
0:66b59f6860ed
Child:
2:401488de6e22
Merge branch 'master' of https://github.com/ARMmbed/mbed-os-example-ble





Commit copied from ./src/github.com/ARMmbed/mbed-os-example-ble

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 1:2fd54f1254fe 1 /* mbed Microcontroller Library
mbed_official 1:2fd54f1254fe 2 * Copyright (c) 2006-2015 ARM Limited
mbed_official 1:2fd54f1254fe 3 *
mbed_official 1:2fd54f1254fe 4 * Licensed under the Apache License, Version 2.0 (the "License");
mbed_official 1:2fd54f1254fe 5 * you may not use this file except in compliance with the License.
mbed_official 1:2fd54f1254fe 6 * You may obtain a copy of the License at
mbed_official 1:2fd54f1254fe 7 *
mbed_official 1:2fd54f1254fe 8 * http://www.apache.org/licenses/LICENSE-2.0
mbed_official 1:2fd54f1254fe 9 *
mbed_official 1:2fd54f1254fe 10 * Unless required by applicable law or agreed to in writing, software
mbed_official 1:2fd54f1254fe 11 * distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 1:2fd54f1254fe 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 1:2fd54f1254fe 13 * See the License for the specific language governing permissions and
mbed_official 1:2fd54f1254fe 14 * limitations under the License.
mbed_official 1:2fd54f1254fe 15 */
mbed_official 1:2fd54f1254fe 16
mbed_official 1:2fd54f1254fe 17 #include <mbed-events/events.h>
mbed_official 1:2fd54f1254fe 18 #include <mbed.h>
mbed_official 1:2fd54f1254fe 19 #include "ble/BLE.h"
mbed_official 1:2fd54f1254fe 20 #include "ble/services/iBeacon.h"
mbed_official 1:2fd54f1254fe 21
mbed_official 1:2fd54f1254fe 22 static iBeacon* ibeaconPtr;
mbed_official 1:2fd54f1254fe 23
mbed_official 1:2fd54f1254fe 24 static EventQueue eventQueue(
mbed_official 1:2fd54f1254fe 25 /* event count */ 4 * /* event size */ 32
mbed_official 1:2fd54f1254fe 26 );
mbed_official 1:2fd54f1254fe 27
mbed_official 1:2fd54f1254fe 28 /**
mbed_official 1:2fd54f1254fe 29 * This function is called when the ble initialization process has failled
mbed_official 1:2fd54f1254fe 30 */
mbed_official 1:2fd54f1254fe 31 void onBleInitError(BLE &ble, ble_error_t error)
mbed_official 1:2fd54f1254fe 32 {
mbed_official 1:2fd54f1254fe 33 /* Initialization error handling should go here */
mbed_official 1:2fd54f1254fe 34 }
mbed_official 1:2fd54f1254fe 35
mbed_official 1:2fd54f1254fe 36 /**
mbed_official 1:2fd54f1254fe 37 * Callback triggered when the ble initialization process has finished
mbed_official 1:2fd54f1254fe 38 */
mbed_official 1:2fd54f1254fe 39 void bleInitComplete(BLE::InitializationCompleteCallbackContext *params)
mbed_official 1:2fd54f1254fe 40 {
mbed_official 1:2fd54f1254fe 41 BLE& ble = params->ble;
mbed_official 1:2fd54f1254fe 42 ble_error_t error = params->error;
mbed_official 1:2fd54f1254fe 43
mbed_official 1:2fd54f1254fe 44 if (error != BLE_ERROR_NONE) {
mbed_official 1:2fd54f1254fe 45 /* In case of error, forward the error handling to onBleInitError */
mbed_official 1:2fd54f1254fe 46 onBleInitError(ble, error);
mbed_official 1:2fd54f1254fe 47 return;
mbed_official 1:2fd54f1254fe 48 }
mbed_official 1:2fd54f1254fe 49
mbed_official 1:2fd54f1254fe 50 /* Ensure that it is the default instance of BLE */
mbed_official 1:2fd54f1254fe 51 if(ble.getInstanceID() != BLE::DEFAULT_INSTANCE) {
mbed_official 1:2fd54f1254fe 52 return;
mbed_official 1:2fd54f1254fe 53 }
mbed_official 1:2fd54f1254fe 54
mbed_official 1:2fd54f1254fe 55 /**
mbed_official 1:2fd54f1254fe 56 * The Beacon payload has the following composition:
mbed_official 1:2fd54f1254fe 57 * 128-Bit / 16byte UUID = E2 0A 39 F4 73 F5 4B C4 A1 2F 17 D1 AD 07 A9 61
mbed_official 1:2fd54f1254fe 58 * Major/Minor = 0x1122 / 0x3344
mbed_official 1:2fd54f1254fe 59 * Tx Power = 0xC8 = 200, 2's compliment is 256-200 = (-56dB)
mbed_official 1:2fd54f1254fe 60 *
mbed_official 1:2fd54f1254fe 61 * Note: please remember to calibrate your beacons TX Power for more accurate results.
mbed_official 1:2fd54f1254fe 62 */
mbed_official 1:2fd54f1254fe 63 static const uint8_t uuid[] = {0xE2, 0x0A, 0x39, 0xF4, 0x73, 0xF5, 0x4B, 0xC4,
mbed_official 1:2fd54f1254fe 64 0xA1, 0x2F, 0x17, 0xD1, 0xAD, 0x07, 0xA9, 0x61};
mbed_official 1:2fd54f1254fe 65 uint16_t majorNumber = 1122;
mbed_official 1:2fd54f1254fe 66 uint16_t minorNumber = 3344;
mbed_official 1:2fd54f1254fe 67 uint16_t txPower = 0xC8;
mbed_official 1:2fd54f1254fe 68 ibeaconPtr = new iBeacon(ble, uuid, majorNumber, minorNumber, txPower);
mbed_official 1:2fd54f1254fe 69
mbed_official 1:2fd54f1254fe 70 ble.gap().setAdvertisingInterval(1000); /* 1000ms. */
mbed_official 1:2fd54f1254fe 71 ble.gap().startAdvertising();
mbed_official 1:2fd54f1254fe 72 }
mbed_official 1:2fd54f1254fe 73
mbed_official 1:2fd54f1254fe 74 void scheduleBleEventsProcessing(BLE::OnEventsToProcessCallbackContext* context) {
mbed_official 1:2fd54f1254fe 75 BLE &ble = BLE::Instance();
mbed_official 1:2fd54f1254fe 76 eventQueue.post(Callback<void()>(&ble, &BLE::processEvents));
mbed_official 1:2fd54f1254fe 77 }
mbed_official 1:2fd54f1254fe 78
mbed_official 1:2fd54f1254fe 79 int main()
mbed_official 1:2fd54f1254fe 80 {
mbed_official 1:2fd54f1254fe 81 BLE &ble = BLE::Instance();
mbed_official 1:2fd54f1254fe 82 ble.onEventsToProcess(scheduleBleEventsProcessing);
mbed_official 1:2fd54f1254fe 83 ble.init(bleInitComplete);
mbed_official 1:2fd54f1254fe 84
mbed_official 1:2fd54f1254fe 85 while (true) {
mbed_official 1:2fd54f1254fe 86 eventQueue.dispatch();
mbed_official 1:2fd54f1254fe 87 }
mbed_official 1:2fd54f1254fe 88
mbed_official 1:2fd54f1254fe 89 return 0;
mbed_official 1:2fd54f1254fe 90 }