Bill Schilit / BLE_API

Improve readability with getHandle inline

Fork of BLE_API by Bluetooth Low Energy

services/URIBeacon2Service.h@166:a03959283d48, 2014-11-28 (annotated)

Committer:
rgrover1
Date:
Fri Nov 28 14:11:21 2014 +0000
Revision:
166:a03959283d48
Parent:
165:ca406c1d0399
Child:
167:8057dc59ac08
Synchronized with git rev bdccaff7

Author: Rohit Grover

adding a few comments.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 147:f772d9b93808 1 /* mbed Microcontroller Library
rgrover1 147:f772d9b93808 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 147:f772d9b93808 3 *
rgrover1 147:f772d9b93808 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 147:f772d9b93808 5 * you may not use this file except in compliance with the License.
rgrover1 147:f772d9b93808 6 * You may obtain a copy of the License at
rgrover1 147:f772d9b93808 7 *
rgrover1 147:f772d9b93808 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 147:f772d9b93808 9 *
rgrover1 147:f772d9b93808 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 147:f772d9b93808 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 147:f772d9b93808 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 147:f772d9b93808 13 * See the License for the specific language governing permissions and
rgrover1 147:f772d9b93808 14 * limitations under the License.
rgrover1 147:f772d9b93808 15 */
rgrover1 147:f772d9b93808 16
rgrover1 147:f772d9b93808 17 #ifndef __BLE_URI_BEACON_2_SERVICE_H__
rgrover1 147:f772d9b93808 18 #define __BLE_URI_BEACON_2_SERVICE_H__
rgrover1 147:f772d9b93808 19
rgrover1 147:f772d9b93808 20 #include "BLEDevice.h"
rgrover1 147:f772d9b93808 21
rgrover1 159:e915a0cebcce 22 #define UUID_INITIALIZER_LIST(FIRST, SECOND) { \
rgrover1 159:e915a0cebcce 23 0xee, 0x0c, FIRST, SECOND, 0x87, 0x86, 0x40, 0xba, \
rgrover1 159:e915a0cebcce 24 0xab, 0x96, 0x99, 0xb9, 0x1a, 0xc9, 0x81, 0xd8, \
rgrover1 159:e915a0cebcce 25 }
rgrover1 159:e915a0cebcce 26 const uint8_t URIBeacon2ControlServiceUUID[] = UUID_INITIALIZER_LIST(0x20, 0x80);
rgrover1 159:e915a0cebcce 27 const uint8_t lockedStateCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x81);
rgrover1 159:e915a0cebcce 28 const uint8_t uriDataCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x84);
rgrover1 162:27a19b0fa40e 29 const uint8_t flagsCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x85);
rgrover1 163:8bd70d17589f 30 const uint8_t txPowerCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x86);
rgrover1 162:27a19b0fa40e 31 const uint8_t beaconPeriodCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x88);
rgrover1 159:e915a0cebcce 32
rgrover1 147:f772d9b93808 33 class URIBeacon2Service {
rgrover1 147:f772d9b93808 34 public:
rgrover1 158:08f609d8a6d4 35 URIBeacon2Service(BLEDevice &ble_, const char *urldata, uint8_t flags_ = 0, uint8_t power_ = 0) :
rgrover1 158:08f609d8a6d4 36 ble(ble_), payloadIndex(0), serviceDataPayload(),
rgrover1 159:e915a0cebcce 37 lockedState(false),
rgrover1 158:08f609d8a6d4 38 uriDataLength(0),
rgrover1 158:08f609d8a6d4 39 uriDataValue(),
rgrover1 158:08f609d8a6d4 40 flags(flags_),
rgrover1 159:e915a0cebcce 41 power(power_),
rgrover1 162:27a19b0fa40e 42 beaconPeriod(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(1000)), /* 1hz */
rgrover1 159:e915a0cebcce 43 lockedStateChar(lockedStateCharUUID, (uint8_t *)&lockedState, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ),
rgrover1 159:e915a0cebcce 44 uriDataChar(uriDataCharUUID,
rgrover1 159:e915a0cebcce 45 uriDataValue,
rgrover1 159:e915a0cebcce 46 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 159:e915a0cebcce 47 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 162:27a19b0fa40e 48 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE),
rgrover1 162:27a19b0fa40e 49 flagsChar(flagsCharUUID, &flags, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE)
rgrover1 163:8bd70d17589f 50 // txPowerChar(txPowerCharUUID, &power, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE)
rgrover1 158:08f609d8a6d4 51 {
rgrover1 158:08f609d8a6d4 52 if ((urldata == NULL) || ((uriDataLength = strlen(urldata)) == 0)) {
rgrover1 158:08f609d8a6d4 53 return;
rgrover1 158:08f609d8a6d4 54 }
rgrover1 158:08f609d8a6d4 55 strncpy(reinterpret_cast<char *>(uriDataValue), urldata, MAX_SIZE_URI_DATA_CHAR_VALUE);
rgrover1 147:f772d9b93808 56
rgrover1 158:08f609d8a6d4 57 setup();
rgrover1 159:e915a0cebcce 58
rgrover1 159:e915a0cebcce 59 static bool serviceAdded = false; /* We should only ever need to add the heart rate service once. */
rgrover1 159:e915a0cebcce 60 if (serviceAdded) {
rgrover1 159:e915a0cebcce 61 return;
rgrover1 159:e915a0cebcce 62 }
rgrover1 159:e915a0cebcce 63
rgrover1 165:ca406c1d0399 64 GattCharacteristic *charTable[] = {&lockedStateChar, &uriDataChar, &flagsChar};
rgrover1 159:e915a0cebcce 65 GattService beaconControlService(URIBeacon2ControlServiceUUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
rgrover1 159:e915a0cebcce 66
rgrover1 159:e915a0cebcce 67 ble.addService(beaconControlService);
rgrover1 159:e915a0cebcce 68 serviceAdded = true;
rgrover1 160:155b28cb0e45 69
rgrover1 160:155b28cb0e45 70 ble.onDataWritten(this, &URIBeacon2Service::onDataWritten);
rgrover1 147:f772d9b93808 71 }
rgrover1 147:f772d9b93808 72
rgrover1 160:155b28cb0e45 73 /**
rgrover1 160:155b28cb0e45 74 * This callback allows the DFU service to receive the initial trigger to
rgrover1 160:155b28cb0e45 75 * handover control to the bootloader; but first the application is given a
rgrover1 160:155b28cb0e45 76 * chance to clean up.
rgrover1 160:155b28cb0e45 77 */
rgrover1 160:155b28cb0e45 78 virtual void onDataWritten(const GattCharacteristicWriteCBParams *params) {
rgrover1 160:155b28cb0e45 79 if (params->charHandle == uriDataChar.getValueAttribute().getHandle()) {
rgrover1 166:a03959283d48 80 if (lockedState) { /* When locked, the device isn't allowed to update the uriData characteristic. */
rgrover1 166:a03959283d48 81 /* Restore GATT database with previous value. */
rgrover1 164:93e52c3861a9 82 ble.updateCharacteristicValue(uriDataChar.getValueAttribute().getHandle(), uriDataValue, uriDataLength);
rgrover1 164:93e52c3861a9 83 return;
rgrover1 164:93e52c3861a9 84 }
rgrover1 164:93e52c3861a9 85
rgrover1 165:ca406c1d0399 86 /* We don't handle very large writes at the moment. */
rgrover1 160:155b28cb0e45 87 if ((params->offset != 0) || (params->len > MAX_SIZE_URI_DATA_CHAR_VALUE)) {
rgrover1 160:155b28cb0e45 88 return;
rgrover1 160:155b28cb0e45 89 }
rgrover1 160:155b28cb0e45 90
rgrover1 160:155b28cb0e45 91 uriDataLength = params->len;
rgrover1 160:155b28cb0e45 92 memcpy(uriDataValue, params->data, uriDataLength);
rgrover1 162:27a19b0fa40e 93 } else if (params->charHandle == flagsChar.getValueAttribute().getHandle()) {
rgrover1 166:a03959283d48 94 if (lockedState) { /* When locked, the device isn't allowed to update the flags characteristic. */
rgrover1 166:a03959283d48 95 /* Restore GATT database with previous value. */
rgrover1 162:27a19b0fa40e 96 ble.updateCharacteristicValue(flagsChar.getValueAttribute().getHandle(), &flags, 1 /* size */);
rgrover1 162:27a19b0fa40e 97 return;
rgrover1 162:27a19b0fa40e 98 } else {
rgrover1 162:27a19b0fa40e 99 flags = *(params->data);
rgrover1 162:27a19b0fa40e 100 }
rgrover1 160:155b28cb0e45 101 }
rgrover1 162:27a19b0fa40e 102 setup();
rgrover1 162:27a19b0fa40e 103 ble.setAdvertisingPayload();
rgrover1 160:155b28cb0e45 104 }
rgrover1 160:155b28cb0e45 105
rgrover1 160:155b28cb0e45 106 /**
rgrover1 161:f17b72db118e 107 * For debugging only.
rgrover1 160:155b28cb0e45 108 */
rgrover1 151:cb5df770f05b 109 void dumpEncodedSeviceData() const {
rgrover1 150:aa2d70369df0 110 printf("encoded: '");
rgrover1 150:aa2d70369df0 111 for (unsigned i = 0; i < payloadIndex; i++) {
rgrover1 151:cb5df770f05b 112 printf(" %02x", serviceDataPayload[i]);
rgrover1 150:aa2d70369df0 113 }
rgrover1 150:aa2d70369df0 114 printf("'\r\n");
rgrover1 150:aa2d70369df0 115 }
rgrover1 150:aa2d70369df0 116
rgrover1 147:f772d9b93808 117 private:
rgrover1 158:08f609d8a6d4 118 void setup(void) {
rgrover1 160:155b28cb0e45 119 const uint8_t BEACON_UUID[] = {0xD8, 0xFE};
rgrover1 148:0072d73e966f 120
rgrover1 160:155b28cb0e45 121 payloadIndex = 0;
rgrover1 158:08f609d8a6d4 122 serviceDataPayload[payloadIndex++] = BEACON_UUID[0];
rgrover1 158:08f609d8a6d4 123 serviceDataPayload[payloadIndex++] = BEACON_UUID[1];
rgrover1 158:08f609d8a6d4 124 serviceDataPayload[payloadIndex++] = flags;
rgrover1 158:08f609d8a6d4 125 serviceDataPayload[payloadIndex++] = power;
rgrover1 158:08f609d8a6d4 126
rgrover1 158:08f609d8a6d4 127 const char *urlData = reinterpret_cast<char *>(uriDataValue);
rgrover1 158:08f609d8a6d4 128 size_t sizeofURLData = uriDataLength;
rgrover1 158:08f609d8a6d4 129 size_t encodedBytes = encodeURISchemePrefix(urlData, sizeofURLData) + encodeURI(urlData, sizeofURLData);
rgrover1 158:08f609d8a6d4 130
rgrover1 160:155b28cb0e45 131 ble.clearAdvertisingPayload();
rgrover1 158:08f609d8a6d4 132 ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LIST_16BIT_SERVICE_IDS, BEACON_UUID, sizeof(BEACON_UUID));
rgrover1 158:08f609d8a6d4 133 ble.accumulateAdvertisingPayload(GapAdvertisingData::SERVICE_DATA, serviceDataPayload, encodedBytes + 4);
rgrover1 160:155b28cb0e45 134
rgrover1 162:27a19b0fa40e 135 ble.setAdvertisingInterval(beaconPeriod);
rgrover1 160:155b28cb0e45 136 ble.setTxPower(power);
rgrover1 149:6a7666d72a83 137 }
rgrover1 149:6a7666d72a83 138
rgrover1 151:cb5df770f05b 139 size_t encodeURISchemePrefix(const char *&urldata, size_t &sizeofURLData) {
rgrover1 148:0072d73e966f 140 const char *prefixes[] = {
rgrover1 148:0072d73e966f 141 "http://www.",
rgrover1 148:0072d73e966f 142 "https://www.",
rgrover1 148:0072d73e966f 143 "http://",
rgrover1 148:0072d73e966f 144 "https://",
rgrover1 148:0072d73e966f 145 "urn:uuid:"
rgrover1 148:0072d73e966f 146 };
rgrover1 149:6a7666d72a83 147
rgrover1 148:0072d73e966f 148 size_t encodedBytes = 0;
rgrover1 148:0072d73e966f 149 const size_t NUM_PREFIXES = sizeof(prefixes) / sizeof(char *);
rgrover1 148:0072d73e966f 150 for (unsigned i = 0; i < NUM_PREFIXES; i++) {
rgrover1 148:0072d73e966f 151 size_t prefixLen = strlen(prefixes[i]);
rgrover1 148:0072d73e966f 152 if (strncmp(urldata, prefixes[i], prefixLen) == 0) {
rgrover1 151:cb5df770f05b 153 serviceDataPayload[payloadIndex++] = i;
rgrover1 149:6a7666d72a83 154 encodedBytes = 1;
rgrover1 148:0072d73e966f 155
rgrover1 148:0072d73e966f 156 urldata += prefixLen;
rgrover1 148:0072d73e966f 157 sizeofURLData -= prefixLen;
rgrover1 148:0072d73e966f 158 break;
rgrover1 148:0072d73e966f 159 }
rgrover1 148:0072d73e966f 160 }
rgrover1 148:0072d73e966f 161
rgrover1 148:0072d73e966f 162 return encodedBytes;
rgrover1 147:f772d9b93808 163 }
rgrover1 147:f772d9b93808 164
rgrover1 151:cb5df770f05b 165 size_t encodeURI(const char *urldata, size_t sizeofURLData) {
rgrover1 150:aa2d70369df0 166 const char *suffixes[] = {
rgrover1 150:aa2d70369df0 167 ".com/",
rgrover1 150:aa2d70369df0 168 ".org/",
rgrover1 150:aa2d70369df0 169 ".edu/",
rgrover1 150:aa2d70369df0 170 ".net/",
rgrover1 150:aa2d70369df0 171 ".info/",
rgrover1 150:aa2d70369df0 172 ".biz/",
rgrover1 150:aa2d70369df0 173 ".gov/",
rgrover1 150:aa2d70369df0 174 ".com",
rgrover1 150:aa2d70369df0 175 ".org",
rgrover1 150:aa2d70369df0 176 ".edu",
rgrover1 150:aa2d70369df0 177 ".net",
rgrover1 150:aa2d70369df0 178 ".info",
rgrover1 150:aa2d70369df0 179 ".biz",
rgrover1 150:aa2d70369df0 180 ".gov"
rgrover1 150:aa2d70369df0 181 };
rgrover1 150:aa2d70369df0 182 const size_t NUM_SUFFIXES = sizeof(suffixes) / sizeof(char *);
rgrover1 150:aa2d70369df0 183
rgrover1 150:aa2d70369df0 184 size_t encodedBytes = 0;
rgrover1 155:a3fafce0bc0b 185 while (sizeofURLData && (payloadIndex < MAX_SIZEOF_SERVICE_DATA_PAYLOAD)) {
rgrover1 150:aa2d70369df0 186 /* check for suffix match */
rgrover1 150:aa2d70369df0 187 unsigned i;
rgrover1 150:aa2d70369df0 188 for (i = 0; i < NUM_SUFFIXES; i++) {
rgrover1 150:aa2d70369df0 189 size_t suffixLen = strlen(suffixes[i]);
rgrover1 150:aa2d70369df0 190 if ((suffixLen == 0) || (sizeofURLData < suffixLen)) {
rgrover1 150:aa2d70369df0 191 continue;
rgrover1 150:aa2d70369df0 192 }
rgrover1 150:aa2d70369df0 193
rgrover1 150:aa2d70369df0 194 if (strncmp(urldata, suffixes[i], suffixLen) == 0) {
rgrover1 151:cb5df770f05b 195 serviceDataPayload[payloadIndex++] = i;
rgrover1 150:aa2d70369df0 196 ++encodedBytes;
rgrover1 150:aa2d70369df0 197 urldata += suffixLen;
rgrover1 150:aa2d70369df0 198 sizeofURLData -= suffixLen;
rgrover1 150:aa2d70369df0 199 break; /* from the for loop for checking against suffixes */
rgrover1 150:aa2d70369df0 200 }
rgrover1 150:aa2d70369df0 201 }
rgrover1 150:aa2d70369df0 202 /* This is the default case where we've got an ordinary character which doesn't match a suffix. */
rgrover1 150:aa2d70369df0 203 if (i == NUM_SUFFIXES) {
rgrover1 151:cb5df770f05b 204 serviceDataPayload[payloadIndex++] = *urldata;
rgrover1 150:aa2d70369df0 205 ++encodedBytes;
rgrover1 150:aa2d70369df0 206 ++urldata;
rgrover1 150:aa2d70369df0 207 --sizeofURLData;
rgrover1 150:aa2d70369df0 208 }
rgrover1 150:aa2d70369df0 209 }
rgrover1 150:aa2d70369df0 210
rgrover1 150:aa2d70369df0 211 return encodedBytes;
rgrover1 150:aa2d70369df0 212 }
rgrover1 150:aa2d70369df0 213
rgrover1 147:f772d9b93808 214 private:
rgrover1 157:8bd620881bc9 215 static const size_t MAX_SIZEOF_SERVICE_DATA_PAYLOAD = 27;
rgrover1 158:08f609d8a6d4 216 static const size_t MAX_SIZE_URI_DATA_CHAR_VALUE = 48;
rgrover1 147:f772d9b93808 217
rgrover1 147:f772d9b93808 218 private:
rgrover1 147:f772d9b93808 219 BLEDevice &ble;
rgrover1 148:0072d73e966f 220
rgrover1 158:08f609d8a6d4 221 size_t payloadIndex;
rgrover1 158:08f609d8a6d4 222 uint8_t serviceDataPayload[MAX_SIZEOF_SERVICE_DATA_PAYLOAD];
rgrover1 161:f17b72db118e 223 bool lockedState;
rgrover1 158:08f609d8a6d4 224 uint16_t uriDataLength;
rgrover1 158:08f609d8a6d4 225 uint8_t uriDataValue[MAX_SIZE_URI_DATA_CHAR_VALUE];
rgrover1 158:08f609d8a6d4 226 uint8_t flags;
rgrover1 158:08f609d8a6d4 227 uint8_t power;
rgrover1 162:27a19b0fa40e 228 uint16_t beaconPeriod;
rgrover1 159:e915a0cebcce 229
rgrover1 159:e915a0cebcce 230 GattCharacteristic lockedStateChar;
rgrover1 159:e915a0cebcce 231 GattCharacteristic uriDataChar;
rgrover1 162:27a19b0fa40e 232 GattCharacteristic flagsChar;
rgrover1 163:8bd70d17589f 233 // GattCharacteristic txPowerChar;
rgrover1 147:f772d9b93808 234 };
rgrover1 147:f772d9b93808 235
rgrover1 147:f772d9b93808 236 #endif /* #ifndef __BLE_URI_BEACON_2_SERVICE_H__*/