This example demonstrates using the GattClient API to control BLE client devices. The canonical source for this example lives at https://github.com/ARMmbed/mbed-os-example-ble/tree/master/BLE_LEDBlinker

Committer:
mbed_official
Date:
Wed Nov 01 15:31:13 2017 +0000
Revision:
45:9fe6d1e21b8a
Parent:
28:64621b6587e1
Child:
75:1a8d19363522
Merge pull request #112 from marcbonnici/master

Add MAC address printouts to examples
.
Commit copied from https://github.com/ARMmbed/mbed-os-example-ble

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Vincent Coubard 0:86bf1d2040b3 1 /* mbed Microcontroller Library
Vincent Coubard 0:86bf1d2040b3 2 * Copyright (c) 2006-2015 ARM Limited
Vincent Coubard 0:86bf1d2040b3 3 *
Vincent Coubard 0:86bf1d2040b3 4 * Licensed under the Apache License, Version 2.0 (the "License");
Vincent Coubard 0:86bf1d2040b3 5 * you may not use this file except in compliance with the License.
Vincent Coubard 0:86bf1d2040b3 6 * You may obtain a copy of the License at
Vincent Coubard 0:86bf1d2040b3 7 *
Vincent Coubard 0:86bf1d2040b3 8 * http://www.apache.org/licenses/LICENSE-2.0
Vincent Coubard 0:86bf1d2040b3 9 *
Vincent Coubard 0:86bf1d2040b3 10 * Unless required by applicable law or agreed to in writing, software
Vincent Coubard 0:86bf1d2040b3 11 * distributed under the License is distributed on an "AS IS" BASIS,
Vincent Coubard 0:86bf1d2040b3 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Vincent Coubard 0:86bf1d2040b3 13 * See the License for the specific language governing permissions and
Vincent Coubard 0:86bf1d2040b3 14 * limitations under the License.
Vincent Coubard 0:86bf1d2040b3 15 */
Vincent Coubard 0:86bf1d2040b3 16
mbed_official 12:059c7b7fb18a 17 #include <events/mbed_events.h>
Vincent Coubard 0:86bf1d2040b3 18 #include <mbed.h>
Vincent Coubard 0:86bf1d2040b3 19 #include "ble/BLE.h"
Vincent Coubard 0:86bf1d2040b3 20 #include "ble/DiscoveredCharacteristic.h"
Vincent Coubard 0:86bf1d2040b3 21 #include "ble/DiscoveredService.h"
Vincent Coubard 0:86bf1d2040b3 22
Vincent Coubard 0:86bf1d2040b3 23 DigitalOut alivenessLED(LED1, 1);
Vincent Coubard 0:86bf1d2040b3 24 static DiscoveredCharacteristic ledCharacteristic;
Vincent Coubard 0:86bf1d2040b3 25 static bool triggerLedCharacteristic;
Vincent Coubard 0:86bf1d2040b3 26 static const char PEER_NAME[] = "LED";
Vincent Coubard 0:86bf1d2040b3 27
mbed_official 28:64621b6587e1 28 static EventQueue eventQueue(/* event count */ 16 * EVENTS_EVENT_SIZE);
Vincent Coubard 0:86bf1d2040b3 29
Vincent Coubard 0:86bf1d2040b3 30 void periodicCallback(void) {
Vincent Coubard 0:86bf1d2040b3 31 alivenessLED = !alivenessLED; /* Do blinky on LED1 while we're waiting for BLE events */
Vincent Coubard 0:86bf1d2040b3 32 }
Vincent Coubard 0:86bf1d2040b3 33
Vincent Coubard 0:86bf1d2040b3 34 void advertisementCallback(const Gap::AdvertisementCallbackParams_t *params) {
Vincent Coubard 0:86bf1d2040b3 35 // parse the advertising payload, looking for data type COMPLETE_LOCAL_NAME
Vincent Coubard 0:86bf1d2040b3 36 // The advertising payload is a collection of key/value records where
Vincent Coubard 0:86bf1d2040b3 37 // byte 0: length of the record excluding this byte
Vincent Coubard 0:86bf1d2040b3 38 // byte 1: The key, it is the type of the data
Vincent Coubard 0:86bf1d2040b3 39 // byte [2..N] The value. N is equal to byte0 - 1
Vincent Coubard 0:86bf1d2040b3 40 for (uint8_t i = 0; i < params->advertisingDataLen; ++i) {
Vincent Coubard 0:86bf1d2040b3 41
Vincent Coubard 0:86bf1d2040b3 42 const uint8_t record_length = params->advertisingData[i];
Vincent Coubard 0:86bf1d2040b3 43 if (record_length == 0) {
Vincent Coubard 0:86bf1d2040b3 44 continue;
Vincent Coubard 0:86bf1d2040b3 45 }
Vincent Coubard 0:86bf1d2040b3 46 const uint8_t type = params->advertisingData[i + 1];
Vincent Coubard 0:86bf1d2040b3 47 const uint8_t* value = params->advertisingData + i + 2;
Vincent Coubard 0:86bf1d2040b3 48 const uint8_t value_length = record_length - 1;
Vincent Coubard 0:86bf1d2040b3 49
Vincent Coubard 0:86bf1d2040b3 50 if(type == GapAdvertisingData::COMPLETE_LOCAL_NAME) {
Vincent Coubard 0:86bf1d2040b3 51 if ((value_length == sizeof(PEER_NAME)) && (memcmp(value, PEER_NAME, value_length) == 0)) {
Vincent Coubard 0:86bf1d2040b3 52 printf(
Vincent Coubard 0:86bf1d2040b3 53 "adv peerAddr[%02x %02x %02x %02x %02x %02x] rssi %d, isScanResponse %u, AdvertisementType %u\r\n",
Vincent Coubard 0:86bf1d2040b3 54 params->peerAddr[5], params->peerAddr[4], params->peerAddr[3], params->peerAddr[2],
Vincent Coubard 0:86bf1d2040b3 55 params->peerAddr[1], params->peerAddr[0], params->rssi, params->isScanResponse, params->type
Vincent Coubard 0:86bf1d2040b3 56 );
Vincent Coubard 0:86bf1d2040b3 57 BLE::Instance().gap().connect(params->peerAddr, Gap::ADDR_TYPE_RANDOM_STATIC, NULL, NULL);
Vincent Coubard 0:86bf1d2040b3 58 break;
Vincent Coubard 0:86bf1d2040b3 59 }
Vincent Coubard 0:86bf1d2040b3 60 }
Vincent Coubard 0:86bf1d2040b3 61 i += record_length;
Vincent Coubard 0:86bf1d2040b3 62 }
Vincent Coubard 0:86bf1d2040b3 63 }
Vincent Coubard 0:86bf1d2040b3 64
Vincent Coubard 0:86bf1d2040b3 65 void serviceDiscoveryCallback(const DiscoveredService *service) {
Vincent Coubard 0:86bf1d2040b3 66 if (service->getUUID().shortOrLong() == UUID::UUID_TYPE_SHORT) {
Vincent Coubard 0:86bf1d2040b3 67 printf("S UUID-%x attrs[%u %u]\r\n", service->getUUID().getShortUUID(), service->getStartHandle(), service->getEndHandle());
Vincent Coubard 0:86bf1d2040b3 68 } else {
Vincent Coubard 0:86bf1d2040b3 69 printf("S UUID-");
Vincent Coubard 0:86bf1d2040b3 70 const uint8_t *longUUIDBytes = service->getUUID().getBaseUUID();
Vincent Coubard 0:86bf1d2040b3 71 for (unsigned i = 0; i < UUID::LENGTH_OF_LONG_UUID; i++) {
Vincent Coubard 0:86bf1d2040b3 72 printf("%02x", longUUIDBytes[i]);
Vincent Coubard 0:86bf1d2040b3 73 }
Vincent Coubard 0:86bf1d2040b3 74 printf(" attrs[%u %u]\r\n", service->getStartHandle(), service->getEndHandle());
Vincent Coubard 0:86bf1d2040b3 75 }
Vincent Coubard 0:86bf1d2040b3 76 }
Vincent Coubard 0:86bf1d2040b3 77
Vincent Coubard 0:86bf1d2040b3 78 void updateLedCharacteristic(void) {
Vincent Coubard 0:86bf1d2040b3 79 if (!BLE::Instance().gattClient().isServiceDiscoveryActive()) {
Vincent Coubard 0:86bf1d2040b3 80 ledCharacteristic.read();
Vincent Coubard 0:86bf1d2040b3 81 }
Vincent Coubard 0:86bf1d2040b3 82 }
Vincent Coubard 0:86bf1d2040b3 83
Vincent Coubard 0:86bf1d2040b3 84 void characteristicDiscoveryCallback(const DiscoveredCharacteristic *characteristicP) {
Vincent Coubard 0:86bf1d2040b3 85 printf(" C UUID-%x valueAttr[%u] props[%x]\r\n", characteristicP->getUUID().getShortUUID(), characteristicP->getValueHandle(), (uint8_t)characteristicP->getProperties().broadcast());
Vincent Coubard 0:86bf1d2040b3 86 if (characteristicP->getUUID().getShortUUID() == 0xa001) { /* !ALERT! Alter this filter to suit your device. */
Vincent Coubard 0:86bf1d2040b3 87 ledCharacteristic = *characteristicP;
Vincent Coubard 0:86bf1d2040b3 88 triggerLedCharacteristic = true;
Vincent Coubard 0:86bf1d2040b3 89 }
Vincent Coubard 0:86bf1d2040b3 90 }
Vincent Coubard 0:86bf1d2040b3 91
Vincent Coubard 0:86bf1d2040b3 92 void discoveryTerminationCallback(Gap::Handle_t connectionHandle) {
Vincent Coubard 0:86bf1d2040b3 93 printf("terminated SD for handle %u\r\n", connectionHandle);
Vincent Coubard 0:86bf1d2040b3 94 if (triggerLedCharacteristic) {
Vincent Coubard 0:86bf1d2040b3 95 triggerLedCharacteristic = false;
mbed_official 12:059c7b7fb18a 96 eventQueue.call(updateLedCharacteristic);
Vincent Coubard 0:86bf1d2040b3 97 }
Vincent Coubard 0:86bf1d2040b3 98 }
Vincent Coubard 0:86bf1d2040b3 99
Vincent Coubard 0:86bf1d2040b3 100 void connectionCallback(const Gap::ConnectionCallbackParams_t *params) {
Vincent Coubard 0:86bf1d2040b3 101 if (params->role == Gap::CENTRAL) {
Vincent Coubard 0:86bf1d2040b3 102 BLE &ble = BLE::Instance();
Vincent Coubard 0:86bf1d2040b3 103 ble.gattClient().onServiceDiscoveryTermination(discoveryTerminationCallback);
Vincent Coubard 0:86bf1d2040b3 104 ble.gattClient().launchServiceDiscovery(params->handle, serviceDiscoveryCallback, characteristicDiscoveryCallback, 0xa000, 0xa001);
Vincent Coubard 0:86bf1d2040b3 105 }
Vincent Coubard 0:86bf1d2040b3 106 }
Vincent Coubard 0:86bf1d2040b3 107
Vincent Coubard 0:86bf1d2040b3 108 void triggerToggledWrite(const GattReadCallbackParams *response) {
Vincent Coubard 0:86bf1d2040b3 109 if (response->handle == ledCharacteristic.getValueHandle()) {
Vincent Coubard 0:86bf1d2040b3 110 printf("triggerToggledWrite: handle %u, offset %u, len %u\r\n", response->handle, response->offset, response->len);
Vincent Coubard 0:86bf1d2040b3 111 for (unsigned index = 0; index < response->len; index++) {
Vincent Coubard 0:86bf1d2040b3 112 printf("%c[%02x]", response->data[index], response->data[index]);
Vincent Coubard 0:86bf1d2040b3 113 }
Vincent Coubard 0:86bf1d2040b3 114 printf("\r\n");
Vincent Coubard 0:86bf1d2040b3 115
Vincent Coubard 0:86bf1d2040b3 116 uint8_t toggledValue = response->data[0] ^ 0x1;
Vincent Coubard 0:86bf1d2040b3 117 ledCharacteristic.write(1, &toggledValue);
Vincent Coubard 0:86bf1d2040b3 118 }
Vincent Coubard 0:86bf1d2040b3 119 }
Vincent Coubard 0:86bf1d2040b3 120
Vincent Coubard 0:86bf1d2040b3 121 void triggerRead(const GattWriteCallbackParams *response) {
Vincent Coubard 0:86bf1d2040b3 122 if (response->handle == ledCharacteristic.getValueHandle()) {
Vincent Coubard 0:86bf1d2040b3 123 ledCharacteristic.read();
Vincent Coubard 0:86bf1d2040b3 124 }
Vincent Coubard 0:86bf1d2040b3 125 }
Vincent Coubard 0:86bf1d2040b3 126
Vincent Coubard 0:86bf1d2040b3 127 void disconnectionCallback(const Gap::DisconnectionCallbackParams_t *) {
Vincent Coubard 0:86bf1d2040b3 128 printf("disconnected\r\n");
Vincent Coubard 0:86bf1d2040b3 129 /* Start scanning and try to connect again */
Vincent Coubard 0:86bf1d2040b3 130 BLE::Instance().gap().startScan(advertisementCallback);
Vincent Coubard 0:86bf1d2040b3 131 }
Vincent Coubard 0:86bf1d2040b3 132
Vincent Coubard 0:86bf1d2040b3 133 void onBleInitError(BLE &ble, ble_error_t error)
Vincent Coubard 0:86bf1d2040b3 134 {
Vincent Coubard 0:86bf1d2040b3 135 /* Initialization error handling should go here */
Vincent Coubard 0:86bf1d2040b3 136 }
Vincent Coubard 0:86bf1d2040b3 137
mbed_official 45:9fe6d1e21b8a 138 void printMacAddress()
mbed_official 45:9fe6d1e21b8a 139 {
mbed_official 45:9fe6d1e21b8a 140 /* Print out device MAC address to the console*/
mbed_official 45:9fe6d1e21b8a 141 Gap::AddressType_t addr_type;
mbed_official 45:9fe6d1e21b8a 142 Gap::Address_t address;
mbed_official 45:9fe6d1e21b8a 143 BLE::Instance().gap().getAddress(&addr_type, address);
mbed_official 45:9fe6d1e21b8a 144 printf("DEVICE MAC ADDRESS: ");
mbed_official 45:9fe6d1e21b8a 145 for (int i = 5; i >= 1; i--){
mbed_official 45:9fe6d1e21b8a 146 printf("%02x:", address[i]);
mbed_official 45:9fe6d1e21b8a 147 }
mbed_official 45:9fe6d1e21b8a 148 printf("%02x\r\n", address[0]);
mbed_official 45:9fe6d1e21b8a 149 }
mbed_official 45:9fe6d1e21b8a 150
Vincent Coubard 0:86bf1d2040b3 151 void bleInitComplete(BLE::InitializationCompleteCallbackContext *params)
Vincent Coubard 0:86bf1d2040b3 152 {
Vincent Coubard 0:86bf1d2040b3 153 BLE& ble = params->ble;
Vincent Coubard 0:86bf1d2040b3 154 ble_error_t error = params->error;
Vincent Coubard 0:86bf1d2040b3 155
Vincent Coubard 0:86bf1d2040b3 156 if (error != BLE_ERROR_NONE) {
Vincent Coubard 0:86bf1d2040b3 157 /* In case of error, forward the error handling to onBleInitError */
Vincent Coubard 0:86bf1d2040b3 158 onBleInitError(ble, error);
Vincent Coubard 0:86bf1d2040b3 159 return;
Vincent Coubard 0:86bf1d2040b3 160 }
Vincent Coubard 0:86bf1d2040b3 161
Vincent Coubard 0:86bf1d2040b3 162 /* Ensure that it is the default instance of BLE */
Vincent Coubard 0:86bf1d2040b3 163 if (ble.getInstanceID() != BLE::DEFAULT_INSTANCE) {
Vincent Coubard 0:86bf1d2040b3 164 return;
Vincent Coubard 0:86bf1d2040b3 165 }
Vincent Coubard 0:86bf1d2040b3 166
Vincent Coubard 0:86bf1d2040b3 167 ble.gap().onDisconnection(disconnectionCallback);
Vincent Coubard 0:86bf1d2040b3 168 ble.gap().onConnection(connectionCallback);
Vincent Coubard 0:86bf1d2040b3 169
Vincent Coubard 0:86bf1d2040b3 170 ble.gattClient().onDataRead(triggerToggledWrite);
Vincent Coubard 0:86bf1d2040b3 171 ble.gattClient().onDataWrite(triggerRead);
Vincent Coubard 0:86bf1d2040b3 172
Vincent Coubard 0:86bf1d2040b3 173 // scan interval: 400ms and scan window: 400ms.
Vincent Coubard 0:86bf1d2040b3 174 // Every 400ms the device will scan for 400ms
Vincent Coubard 0:86bf1d2040b3 175 // This means that the device will scan continuously.
Vincent Coubard 0:86bf1d2040b3 176 ble.gap().setScanParams(400, 400);
Vincent Coubard 0:86bf1d2040b3 177 ble.gap().startScan(advertisementCallback);
mbed_official 45:9fe6d1e21b8a 178
mbed_official 45:9fe6d1e21b8a 179 printMacAddress();
Vincent Coubard 0:86bf1d2040b3 180 }
Vincent Coubard 0:86bf1d2040b3 181
Vincent Coubard 0:86bf1d2040b3 182 void scheduleBleEventsProcessing(BLE::OnEventsToProcessCallbackContext* context) {
Vincent Coubard 0:86bf1d2040b3 183 BLE &ble = BLE::Instance();
mbed_official 12:059c7b7fb18a 184 eventQueue.call(Callback<void()>(&ble, &BLE::processEvents));
Vincent Coubard 0:86bf1d2040b3 185 }
Vincent Coubard 0:86bf1d2040b3 186
Vincent Coubard 0:86bf1d2040b3 187 int main()
Vincent Coubard 0:86bf1d2040b3 188 {
Vincent Coubard 0:86bf1d2040b3 189 triggerLedCharacteristic = false;
mbed_official 12:059c7b7fb18a 190 eventQueue.call_every(500, periodicCallback);
Vincent Coubard 0:86bf1d2040b3 191
Vincent Coubard 0:86bf1d2040b3 192 BLE &ble = BLE::Instance();
Vincent Coubard 0:86bf1d2040b3 193 ble.onEventsToProcess(scheduleBleEventsProcessing);
Vincent Coubard 0:86bf1d2040b3 194 ble.init(bleInitComplete);
Vincent Coubard 0:86bf1d2040b3 195
mbed_official 12:059c7b7fb18a 196 eventQueue.dispatch_forever();
Vincent Coubard 0:86bf1d2040b3 197
Vincent Coubard 0:86bf1d2040b3 198 return 0;
Vincent Coubard 0:86bf1d2040b3 199 }