Microbug / BLE_API_FOTA

Lightly modified version of the BLE stack, that doesn't bring up a DFUService by default... as we have our own.

Fork of BLE_API by Bluetooth Low Energy

services/URIBeaconConfigService.h@211:f181effe5de3, 2014-12-01 (annotated)

Committer:
rgrover1
Date:
Mon Dec 01 14:31:18 2014 +0000
Revision:
211:f181effe5de3
Parent:
210:0c14030d1bd0
Child:
212:852d45a52016
Synchronized with git rev bb041bbb

Author: Rohit Grover

add helper functions to update characteristics.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 171:6092e61690dc 1 /* mbed Microcontroller Library
rgrover1 171:6092e61690dc 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 171:6092e61690dc 3 *
rgrover1 171:6092e61690dc 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 171:6092e61690dc 5 * you may not use this file except in compliance with the License.
rgrover1 171:6092e61690dc 6 * You may obtain a copy of the License at
rgrover1 171:6092e61690dc 7 *
rgrover1 171:6092e61690dc 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 171:6092e61690dc 9 *
rgrover1 171:6092e61690dc 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 171:6092e61690dc 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 171:6092e61690dc 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 171:6092e61690dc 13 * See the License for the specific language governing permissions and
rgrover1 171:6092e61690dc 14 * limitations under the License.
rgrover1 171:6092e61690dc 15 */
rgrover1 171:6092e61690dc 16
rgrover1 207:e88130dc254c 17 #ifndef __BLE_URI_BEACON_CONFIG_SERVICE_H__
rgrover1 207:e88130dc254c 18 #define __BLE_URI_BEACON_CONFIG_SERVICE_H__
rgrover1 171:6092e61690dc 19
rgrover1 171:6092e61690dc 20 #include "BLEDevice.h"
rgrover1 171:6092e61690dc 21
rgrover1 206:49646c933822 22 #define UUID_INITIALIZER_LIST(FIRST, SECOND) { \
rgrover1 206:49646c933822 23 0xee, 0x0c, FIRST, SECOND, 0x87, 0x86, 0x40, 0xba, \
rgrover1 206:49646c933822 24 0xab, 0x96, 0x99, 0xb9, 0x1a, 0xc9, 0x81, 0xd8, \
rgrover1 171:6092e61690dc 25 }
rgrover1 171:6092e61690dc 26 const uint8_t URIBeacon2ControlServiceUUID[] = UUID_INITIALIZER_LIST(0x20, 0x80);
rgrover1 171:6092e61690dc 27 const uint8_t lockedStateCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x81);
rgrover1 171:6092e61690dc 28 const uint8_t uriDataCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x84);
rgrover1 171:6092e61690dc 29 const uint8_t flagsCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x85);
rgrover1 178:b6d6a2a11e86 30 const uint8_t txPowerLevelsCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x86);
rgrover1 171:6092e61690dc 31 const uint8_t beaconPeriodCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x88);
rgrover1 189:a23091b54ab5 32 const uint8_t resetCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x89);
rgrover1 171:6092e61690dc 33
rgrover1 207:e88130dc254c 34 class URIBeaconConfigService {
rgrover1 180:afcd2f9c2ada 35 public:
rgrover1 175:4e85f7225f8f 36 enum TXPowerModes_t {
rgrover1 175:4e85f7225f8f 37 TX_POWER_MODE_LOWEST = 0,
rgrover1 175:4e85f7225f8f 38 TX_POWER_MODE_LOW = 1,
rgrover1 175:4e85f7225f8f 39 TX_POWER_MODE_MEDIUM = 2,
rgrover1 175:4e85f7225f8f 40 TX_POWER_MODE_HIGH = 3,
rgrover1 177:17f4b5924fe9 41 NUM_POWER_MODES
rgrover1 175:4e85f7225f8f 42 };
rgrover1 175:4e85f7225f8f 43
rgrover1 181:bbb6ce1082c3 44 /**
rgrover1 181:bbb6ce1082c3 45 * @param[ref] ble
rgrover1 181:bbb6ce1082c3 46 * BLEDevice object for the underlying controller.
rgrover1 208:88a3a58769bf 47 * @param[in] uridata
rgrover1 181:bbb6ce1082c3 48 * URI as a null-terminated string.
rgrover1 181:bbb6ce1082c3 49 * @param[in] flagsIn
rgrover1 181:bbb6ce1082c3 50 * UriBeacon Flags.
rgrover1 181:bbb6ce1082c3 51 * @param[in] effectiveTxPowerIn
rgrover1 181:bbb6ce1082c3 52 * UriBeacon Tx Power Level in dBm.
rgrover1 181:bbb6ce1082c3 53 * @param[in] beaconPeriodIn
rgrover1 181:bbb6ce1082c3 54 * The period in milliseconds that a UriBeacon packet is
rgrover1 181:bbb6ce1082c3 55 * transmitted. A value of zero disables UriBeacon
rgrover1 181:bbb6ce1082c3 56 * transmissions.
rgrover1 181:bbb6ce1082c3 57 */
rgrover1 207:e88130dc254c 58 URIBeaconConfigService(BLEDevice &bleIn, const char *uriDataIn, uint8_t flagsIn = 0, int8_t effectiveTxPowerIn = 0, uint16_t beaconPeriodIn = 1000) :
rgrover1 192:3fd3dcf49005 59 ble(bleIn),
rgrover1 192:3fd3dcf49005 60 payloadIndex(0),
rgrover1 192:3fd3dcf49005 61 serviceDataPayload(),
rgrover1 192:3fd3dcf49005 62 initSucceeded(false),
rgrover1 192:3fd3dcf49005 63 lockedState(false),
rgrover1 192:3fd3dcf49005 64 uriDataLength(0),
rgrover1 192:3fd3dcf49005 65 uriData(),
rgrover1 192:3fd3dcf49005 66 flags(flagsIn),
rgrover1 200:80dd3e50705c 67 effectiveTxPower(effectiveTxPowerIn),
rgrover1 192:3fd3dcf49005 68 powerLevels(),
rgrover1 201:9bb7b3f45c20 69 beaconPeriod(beaconPeriodIn),
rgrover1 192:3fd3dcf49005 70 lockedStateChar(lockedStateCharUUID, reinterpret_cast<uint8_t *>(&lockedState), 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ),
rgrover1 192:3fd3dcf49005 71 uriDataChar(uriDataCharUUID,
rgrover1 192:3fd3dcf49005 72 uriData,
rgrover1 192:3fd3dcf49005 73 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 192:3fd3dcf49005 74 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 192:3fd3dcf49005 75 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE),
rgrover1 192:3fd3dcf49005 76 flagsChar(flagsCharUUID, &flags, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE),
rgrover1 192:3fd3dcf49005 77 txPowerLevelsChar(txPowerLevelsCharUUID,
rgrover1 192:3fd3dcf49005 78 reinterpret_cast<uint8_t *>(powerLevels),
rgrover1 192:3fd3dcf49005 79 NUM_POWER_MODES * sizeof(int8_t),
rgrover1 192:3fd3dcf49005 80 NUM_POWER_MODES * sizeof(int8_t),
rgrover1 192:3fd3dcf49005 81 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE),
rgrover1 192:3fd3dcf49005 82 beaconPeriodChar(beaconPeriodCharUUID, reinterpret_cast<uint8_t *>(&beaconPeriod), 2, 2,
rgrover1 192:3fd3dcf49005 83 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE),
rgrover1 192:3fd3dcf49005 84 resetChar(resetCharUUID, reinterpret_cast<uint8_t *>(&resetFlag), 1, 1,
rgrover1 192:3fd3dcf49005 85 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE)
rgrover1 192:3fd3dcf49005 86 {
rgrover1 194:669eced4cd5e 87 if ((uriDataIn == NULL) || ((uriDataLength = strlen(uriDataIn)) == 0) || (uriDataLength > MAX_SIZE_URI_DATA_CHAR_VALUE)) {
rgrover1 192:3fd3dcf49005 88 return;
rgrover1 192:3fd3dcf49005 89 }
rgrover1 194:669eced4cd5e 90 strcpy(reinterpret_cast<char *>(uriData), uriDataIn);
rgrover1 192:3fd3dcf49005 91
rgrover1 210:0c14030d1bd0 92 configureGAP();
rgrover1 192:3fd3dcf49005 93 if (initSucceeded) {
rgrover1 205:c957765916e2 94 saveDefaults();
rgrover1 171:6092e61690dc 95 }
rgrover1 171:6092e61690dc 96
rgrover1 192:3fd3dcf49005 97 GattCharacteristic *charTable[] = {&lockedStateChar, &uriDataChar, &flagsChar, &txPowerLevelsChar, &beaconPeriodChar, &resetChar};
rgrover1 192:3fd3dcf49005 98 GattService beaconControlService(URIBeacon2ControlServiceUUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
rgrover1 182:d16f8c11816b 99
rgrover1 192:3fd3dcf49005 100 ble.addService(beaconControlService);
rgrover1 207:e88130dc254c 101 ble.onDataWritten(this, &URIBeaconConfigService::onDataWritten);
rgrover1 192:3fd3dcf49005 102 }
rgrover1 192:3fd3dcf49005 103
rgrover1 193:ac2feceb7e87 104 bool configuredSuccessfully(void) const {
rgrover1 192:3fd3dcf49005 105 return initSucceeded;
rgrover1 171:6092e61690dc 106 }
rgrover1 171:6092e61690dc 107
rgrover1 173:05c4b1cea65f 108 /**
rgrover1 196:febbd68b1095 109 * Please note that the following public APIs are offered to allow modifying
rgrover1 196:febbd68b1095 110 * the service programmatically. It is also possible to do so over BLE GATT
rgrover1 196:febbd68b1095 111 * transactions.
rgrover1 196:febbd68b1095 112 */
rgrover1 196:febbd68b1095 113 public:
rgrover1 196:febbd68b1095 114 /**
rgrover1 173:05c4b1cea65f 115 * Update flags of the URIBeacon dynamically.
rgrover1 173:05c4b1cea65f 116 *
rgrover1 173:05c4b1cea65f 117 * @param[in] flagsIn
rgrover1 173:05c4b1cea65f 118 *
rgrover1 173:05c4b1cea65f 119 * ### UriBeacon Flags
rgrover1 173:05c4b1cea65f 120 * Bit | Description
rgrover1 173:05c4b1cea65f 121 * :---- | :----------
rgrover1 173:05c4b1cea65f 122 * 0 | Invisible Hint
rgrover1 173:05c4b1cea65f 123 * 1..7 | Reserved for future use. Must be zero.
rgrover1 173:05c4b1cea65f 124 *
rgrover1 173:05c4b1cea65f 125 * The `Invisible Hint` flag is a command for the user-agent that tells
rgrover1 173:05c4b1cea65f 126 * it not to access or display the UriBeacon. This is a guideline only,
rgrover1 173:05c4b1cea65f 127 * and is not a blocking method. User agents may, with user approval,
rgrover1 173:05c4b1cea65f 128 * display invisible beacons.
rgrover1 173:05c4b1cea65f 129 */
rgrover1 171:6092e61690dc 130 void setFlags(uint8_t flagsIn) {
rgrover1 171:6092e61690dc 131 flags = flagsIn;
rgrover1 210:0c14030d1bd0 132 configureGAP();
rgrover1 211:f181effe5de3 133 updateFlagsCharacteristic();
rgrover1 171:6092e61690dc 134 }
rgrover1 171:6092e61690dc 135
rgrover1 177:17f4b5924fe9 136 /**
rgrover1 177:17f4b5924fe9 137 * Update the txPower for a particular mode in the powerLevels table.
rgrover1 177:17f4b5924fe9 138 */
rgrover1 177:17f4b5924fe9 139 void setTxPowerLevel(TXPowerModes_t mode, int8_t txPowerIn) {
rgrover1 177:17f4b5924fe9 140 powerLevels[mode] = txPowerIn;
rgrover1 177:17f4b5924fe9 141 }
rgrover1 177:17f4b5924fe9 142
rgrover1 177:17f4b5924fe9 143 /**
rgrover1 177:17f4b5924fe9 144 * Set the effective power mode from one of the values in the powerLevels tables.
rgrover1 177:17f4b5924fe9 145 */
rgrover1 191:6710298104b0 146 void useTxPowerMode(TXPowerModes_t mode) {
rgrover1 200:80dd3e50705c 147 effectiveTxPower = powerLevels[mode];
rgrover1 210:0c14030d1bd0 148 configureGAP();
rgrover1 171:6092e61690dc 149 }
rgrover1 171:6092e61690dc 150
rgrover1 183:41d6ffadba96 151 /**
rgrover1 183:41d6ffadba96 152 * The period in milliseconds that a UriBeacon packet is transmitted.
rgrover1 183:41d6ffadba96 153 *
rgrover1 183:41d6ffadba96 154 * @Note: A value of zero disables UriBeacon transmissions.
rgrover1 183:41d6ffadba96 155 */
rgrover1 171:6092e61690dc 156 void setBeaconPeriod(uint16_t beaconPeriodIn) {
rgrover1 171:6092e61690dc 157 beaconPeriod = beaconPeriodIn;
rgrover1 210:0c14030d1bd0 158 configureGAP();
rgrover1 211:f181effe5de3 159 updateBeaconPeriodCharacteristic();
rgrover1 171:6092e61690dc 160 }
rgrover1 171:6092e61690dc 161
rgrover1 196:febbd68b1095 162 private:
rgrover1 186:ce34008cea95 163 /**
rgrover1 186:ce34008cea95 164 * Setup the advertisement payload and GAP settings.
rgrover1 186:ce34008cea95 165 */
rgrover1 210:0c14030d1bd0 166 void configureGAP(void) {
rgrover1 171:6092e61690dc 167 const uint8_t BEACON_UUID[] = {0xD8, 0xFE};
rgrover1 171:6092e61690dc 168
rgrover1 206:49646c933822 169 payloadIndex = 0;
rgrover1 171:6092e61690dc 170 serviceDataPayload[payloadIndex++] = BEACON_UUID[0];
rgrover1 171:6092e61690dc 171 serviceDataPayload[payloadIndex++] = BEACON_UUID[1];
rgrover1 171:6092e61690dc 172 serviceDataPayload[payloadIndex++] = flags;
rgrover1 200:80dd3e50705c 173 serviceDataPayload[payloadIndex++] = effectiveTxPower;
rgrover1 171:6092e61690dc 174
rgrover1 206:49646c933822 175 const char *urlData = reinterpret_cast<char *>(uriData);
rgrover1 206:49646c933822 176 size_t sizeofURLData = uriDataLength;
rgrover1 206:49646c933822 177 size_t encodedBytes = encodeURISchemePrefix(urlData, sizeofURLData) + encodeURI(urlData, sizeofURLData);
rgrover1 171:6092e61690dc 178
rgrover1 171:6092e61690dc 179 ble.clearAdvertisingPayload();
rgrover1 171:6092e61690dc 180 ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LIST_16BIT_SERVICE_IDS, BEACON_UUID, sizeof(BEACON_UUID));
rgrover1 171:6092e61690dc 181 ble.accumulateAdvertisingPayload(GapAdvertisingData::SERVICE_DATA, serviceDataPayload, encodedBytes + 4);
rgrover1 171:6092e61690dc 182
rgrover1 201:9bb7b3f45c20 183 ble.setAdvertisingInterval(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(beaconPeriod));
rgrover1 200:80dd3e50705c 184 ble.setTxPower(effectiveTxPower);
rgrover1 171:6092e61690dc 185 }
rgrover1 171:6092e61690dc 186
rgrover1 171:6092e61690dc 187 size_t encodeURISchemePrefix(const char *&urldata, size_t &sizeofURLData) {
rgrover1 171:6092e61690dc 188 const char *prefixes[] = {
rgrover1 171:6092e61690dc 189 "http://www.",
rgrover1 171:6092e61690dc 190 "https://www.",
rgrover1 171:6092e61690dc 191 "http://",
rgrover1 171:6092e61690dc 192 "https://",
rgrover1 171:6092e61690dc 193 "urn:uuid:"
rgrover1 171:6092e61690dc 194 };
rgrover1 171:6092e61690dc 195
rgrover1 206:49646c933822 196 size_t encodedBytes = 0;
rgrover1 171:6092e61690dc 197 const size_t NUM_PREFIXES = sizeof(prefixes) / sizeof(char *);
rgrover1 171:6092e61690dc 198 for (unsigned i = 0; i < NUM_PREFIXES; i++) {
rgrover1 171:6092e61690dc 199 size_t prefixLen = strlen(prefixes[i]);
rgrover1 171:6092e61690dc 200 if (strncmp(urldata, prefixes[i], prefixLen) == 0) {
rgrover1 171:6092e61690dc 201 serviceDataPayload[payloadIndex++] = i;
rgrover1 206:49646c933822 202 encodedBytes = 1;
rgrover1 171:6092e61690dc 203
rgrover1 206:49646c933822 204 urldata += prefixLen;
rgrover1 171:6092e61690dc 205 sizeofURLData -= prefixLen;
rgrover1 171:6092e61690dc 206 break;
rgrover1 171:6092e61690dc 207 }
rgrover1 171:6092e61690dc 208 }
rgrover1 171:6092e61690dc 209
rgrover1 171:6092e61690dc 210 return encodedBytes;
rgrover1 171:6092e61690dc 211 }
rgrover1 171:6092e61690dc 212
rgrover1 171:6092e61690dc 213 size_t encodeURI(const char *urldata, size_t sizeofURLData) {
rgrover1 171:6092e61690dc 214 const char *suffixes[] = {
rgrover1 171:6092e61690dc 215 ".com/",
rgrover1 171:6092e61690dc 216 ".org/",
rgrover1 171:6092e61690dc 217 ".edu/",
rgrover1 171:6092e61690dc 218 ".net/",
rgrover1 171:6092e61690dc 219 ".info/",
rgrover1 171:6092e61690dc 220 ".biz/",
rgrover1 171:6092e61690dc 221 ".gov/",
rgrover1 171:6092e61690dc 222 ".com",
rgrover1 171:6092e61690dc 223 ".org",
rgrover1 171:6092e61690dc 224 ".edu",
rgrover1 171:6092e61690dc 225 ".net",
rgrover1 171:6092e61690dc 226 ".info",
rgrover1 171:6092e61690dc 227 ".biz",
rgrover1 171:6092e61690dc 228 ".gov"
rgrover1 171:6092e61690dc 229 };
rgrover1 171:6092e61690dc 230 const size_t NUM_SUFFIXES = sizeof(suffixes) / sizeof(char *);
rgrover1 171:6092e61690dc 231
rgrover1 171:6092e61690dc 232 size_t encodedBytes = 0;
rgrover1 171:6092e61690dc 233 while (sizeofURLData && (payloadIndex < MAX_SIZEOF_SERVICE_DATA_PAYLOAD)) {
rgrover1 171:6092e61690dc 234 /* check for suffix match */
rgrover1 171:6092e61690dc 235 unsigned i;
rgrover1 171:6092e61690dc 236 for (i = 0; i < NUM_SUFFIXES; i++) {
rgrover1 171:6092e61690dc 237 size_t suffixLen = strlen(suffixes[i]);
rgrover1 171:6092e61690dc 238 if ((suffixLen == 0) || (sizeofURLData < suffixLen)) {
rgrover1 171:6092e61690dc 239 continue;
rgrover1 171:6092e61690dc 240 }
rgrover1 171:6092e61690dc 241
rgrover1 171:6092e61690dc 242 if (strncmp(urldata, suffixes[i], suffixLen) == 0) {
rgrover1 171:6092e61690dc 243 serviceDataPayload[payloadIndex++] = i;
rgrover1 171:6092e61690dc 244 ++encodedBytes;
rgrover1 171:6092e61690dc 245 urldata += suffixLen;
rgrover1 171:6092e61690dc 246 sizeofURLData -= suffixLen;
rgrover1 171:6092e61690dc 247 break; /* from the for loop for checking against suffixes */
rgrover1 171:6092e61690dc 248 }
rgrover1 171:6092e61690dc 249 }
rgrover1 171:6092e61690dc 250 /* This is the default case where we've got an ordinary character which doesn't match a suffix. */
rgrover1 171:6092e61690dc 251 if (i == NUM_SUFFIXES) {
rgrover1 171:6092e61690dc 252 serviceDataPayload[payloadIndex++] = *urldata;
rgrover1 171:6092e61690dc 253 ++encodedBytes;
rgrover1 171:6092e61690dc 254 ++urldata;
rgrover1 171:6092e61690dc 255 --sizeofURLData;
rgrover1 171:6092e61690dc 256 }
rgrover1 171:6092e61690dc 257 }
rgrover1 192:3fd3dcf49005 258 if (sizeofURLData == 0) {
rgrover1 192:3fd3dcf49005 259 initSucceeded = true;
rgrover1 182:d16f8c11816b 260 }
rgrover1 171:6092e61690dc 261
rgrover1 171:6092e61690dc 262 return encodedBytes;
rgrover1 171:6092e61690dc 263 }
rgrover1 171:6092e61690dc 264
rgrover1 203:7b5178d2fa03 265 void onDataWritten(const GattCharacteristicWriteCBParams *params) {
rgrover1 185:7cd70497aec8 266 if (params->charHandle == uriDataChar.getValueAttribute().getHandle()) {
rgrover1 185:7cd70497aec8 267 if (lockedState) { /* When locked, the device isn't allowed to update the uriData characteristic. */
rgrover1 185:7cd70497aec8 268 /* Restore GATT database with previous value. */
rgrover1 211:f181effe5de3 269 updateURIDataCharacteristic();
rgrover1 185:7cd70497aec8 270 return;
rgrover1 185:7cd70497aec8 271 }
rgrover1 185:7cd70497aec8 272
rgrover1 185:7cd70497aec8 273 /* We don't handle very large writes at the moment. */
rgrover1 185:7cd70497aec8 274 if ((params->offset != 0) || (params->len > MAX_SIZE_URI_DATA_CHAR_VALUE)) {
rgrover1 185:7cd70497aec8 275 return;
rgrover1 185:7cd70497aec8 276 }
rgrover1 185:7cd70497aec8 277
rgrover1 185:7cd70497aec8 278 uriDataLength = params->len;
rgrover1 187:057c547facd2 279 memcpy(uriData, params->data, uriDataLength);
rgrover1 185:7cd70497aec8 280 } else if (params->charHandle == flagsChar.getValueAttribute().getHandle()) {
rgrover1 185:7cd70497aec8 281 if (lockedState) { /* When locked, the device isn't allowed to update the characteristic. */
rgrover1 185:7cd70497aec8 282 /* Restore GATT database with previous value. */
rgrover1 211:f181effe5de3 283 updateFlagsCharacteristic();
rgrover1 185:7cd70497aec8 284 return;
rgrover1 185:7cd70497aec8 285 } else {
rgrover1 185:7cd70497aec8 286 flags = *(params->data);
rgrover1 185:7cd70497aec8 287 }
rgrover1 185:7cd70497aec8 288 } else if (params->charHandle == txPowerLevelsChar.getValueAttribute().getHandle()) {
rgrover1 185:7cd70497aec8 289 if (lockedState) { /* When locked, the device isn't allowed to update the characteristic. */
rgrover1 185:7cd70497aec8 290 /* Restore GATT database with previous value. */
rgrover1 185:7cd70497aec8 291 ble.updateCharacteristicValue(txPowerLevelsChar.getValueAttribute().getHandle(), reinterpret_cast<uint8_t *>(powerLevels), NUM_POWER_MODES * sizeof(int8_t));
rgrover1 185:7cd70497aec8 292 return;
rgrover1 185:7cd70497aec8 293 } else {
rgrover1 185:7cd70497aec8 294 memcpy(powerLevels, params->data, NUM_POWER_MODES * sizeof(int8_t));
rgrover1 185:7cd70497aec8 295 }
rgrover1 185:7cd70497aec8 296 } else if (params->charHandle == beaconPeriodChar.getValueAttribute().getHandle()) {
rgrover1 185:7cd70497aec8 297 if (lockedState) { /* When locked, the device isn't allowed to update the characteristic. */
rgrover1 185:7cd70497aec8 298 /* Restore GATT database with previous value. */
rgrover1 211:f181effe5de3 299 updateBeaconPeriodCharacteristic();
rgrover1 185:7cd70497aec8 300 return;
rgrover1 185:7cd70497aec8 301 } else {
rgrover1 185:7cd70497aec8 302 beaconPeriod = *((uint16_t *)(params->data));
rgrover1 185:7cd70497aec8 303 }
rgrover1 189:a23091b54ab5 304 } else if (params->charHandle == resetChar.getValueAttribute().getHandle()) {
rgrover1 200:80dd3e50705c 305 resetDefaults();
rgrover1 185:7cd70497aec8 306 }
rgrover1 210:0c14030d1bd0 307 configureGAP();
rgrover1 185:7cd70497aec8 308 ble.setAdvertisingPayload();
rgrover1 185:7cd70497aec8 309 }
rgrover1 185:7cd70497aec8 310
rgrover1 205:c957765916e2 311 /* Preserve the defaults to be able to reset() upon request. */
rgrover1 205:c957765916e2 312 void saveDefaults(void) {
rgrover1 205:c957765916e2 313 memcpy(defaultURIData, uriData, MAX_SIZE_URI_DATA_CHAR_VALUE);
rgrover1 205:c957765916e2 314 defaultFlags = flags;
rgrover1 205:c957765916e2 315 defaultEffectiveTxPower = effectiveTxPower;
rgrover1 205:c957765916e2 316 defaultBeaconPeriod = beaconPeriod;
rgrover1 205:c957765916e2 317 }
rgrover1 205:c957765916e2 318
rgrover1 200:80dd3e50705c 319 void resetDefaults(void) {
rgrover1 200:80dd3e50705c 320 memcpy(uriData, defaultURIData, MAX_SIZE_URI_DATA_CHAR_VALUE);
rgrover1 189:a23091b54ab5 321 memset(powerLevels, 0, sizeof(powerLevels));
rgrover1 200:80dd3e50705c 322 flags = defaultFlags;
rgrover1 200:80dd3e50705c 323 effectiveTxPower = defaultEffectiveTxPower;
rgrover1 200:80dd3e50705c 324 beaconPeriod = defaultBeaconPeriod;
rgrover1 189:a23091b54ab5 325
rgrover1 211:f181effe5de3 326 updateGATT();
rgrover1 211:f181effe5de3 327 }
rgrover1 211:f181effe5de3 328
rgrover1 211:f181effe5de3 329 void updateGATT(void) {
rgrover1 211:f181effe5de3 330 updateURIDataCharacteristic();
rgrover1 211:f181effe5de3 331 updateFlagsCharacteristic();
rgrover1 211:f181effe5de3 332 updateBeaconPeriodCharacteristic();
rgrover1 211:f181effe5de3 333 }
rgrover1 211:f181effe5de3 334
rgrover1 211:f181effe5de3 335 void updateURIDataCharacteristic(void) {
rgrover1 189:a23091b54ab5 336 ble.updateCharacteristicValue(uriDataChar.getValueAttribute().getHandle(), uriData, uriDataLength);
rgrover1 211:f181effe5de3 337 }
rgrover1 211:f181effe5de3 338
rgrover1 211:f181effe5de3 339 void updateFlagsCharacteristic(void) {
rgrover1 189:a23091b54ab5 340 ble.updateCharacteristicValue(flagsChar.getValueAttribute().getHandle(), &flags, 1 /* size */);
rgrover1 211:f181effe5de3 341 }
rgrover1 211:f181effe5de3 342
rgrover1 211:f181effe5de3 343 void updateBeaconPeriodCharacteristic(void) {
rgrover1 189:a23091b54ab5 344 ble.updateCharacteristicValue(beaconPeriodChar.getValueAttribute().getHandle(), reinterpret_cast<uint8_t *>(&beaconPeriod), sizeof(uint16_t));
rgrover1 189:a23091b54ab5 345 }
rgrover1 189:a23091b54ab5 346
rgrover1 185:7cd70497aec8 347 private:
rgrover1 185:7cd70497aec8 348 /**
rgrover1 185:7cd70497aec8 349 * For debugging only.
rgrover1 185:7cd70497aec8 350 */
rgrover1 185:7cd70497aec8 351 void dumpEncodedSeviceData() const {
rgrover1 185:7cd70497aec8 352 printf("encoded: '");
rgrover1 185:7cd70497aec8 353 for (unsigned i = 0; i < payloadIndex; i++) {
rgrover1 185:7cd70497aec8 354 printf(" %02x", serviceDataPayload[i]);
rgrover1 185:7cd70497aec8 355 }
rgrover1 185:7cd70497aec8 356 printf("'\r\n");
rgrover1 185:7cd70497aec8 357 }
rgrover1 185:7cd70497aec8 358
rgrover1 171:6092e61690dc 359 private:
rgrover1 199:6b57874115f6 360 static const size_t MAX_SIZEOF_SERVICE_DATA_PAYLOAD = 18; /* Uri Data must be between 0 and 18 bytes in length. */
rgrover1 204:479f81fd5d3b 361 static const size_t MAX_SIZE_URI_DATA_CHAR_VALUE = 48; /* This is chosen arbitrarily. It should be large enough
rgrover1 204:479f81fd5d3b 362 * to hold any reasonable uncompressed URI. */
rgrover1 171:6092e61690dc 363
rgrover1 171:6092e61690dc 364 private:
rgrover1 206:49646c933822 365 BLEDevice &ble;
rgrover1 171:6092e61690dc 366
rgrover1 206:49646c933822 367 size_t payloadIndex;
rgrover1 206:49646c933822 368 uint8_t serviceDataPayload[MAX_SIZEOF_SERVICE_DATA_PAYLOAD];
rgrover1 206:49646c933822 369 bool initSucceeded;
rgrover1 182:d16f8c11816b 370
rgrover1 206:49646c933822 371 bool lockedState;
rgrover1 206:49646c933822 372 uint16_t uriDataLength;
rgrover1 206:49646c933822 373 uint8_t uriData[MAX_SIZE_URI_DATA_CHAR_VALUE];
rgrover1 206:49646c933822 374 uint8_t flags;
rgrover1 206:49646c933822 375 int8_t effectiveTxPower;
rgrover1 206:49646c933822 376 int8_t powerLevels[NUM_POWER_MODES];
rgrover1 206:49646c933822 377 uint16_t beaconPeriod;
rgrover1 206:49646c933822 378 bool resetFlag;
rgrover1 171:6092e61690dc 379
rgrover1 206:49646c933822 380 uint8_t defaultURIData[MAX_SIZE_URI_DATA_CHAR_VALUE];
rgrover1 206:49646c933822 381 uint8_t defaultFlags;
rgrover1 206:49646c933822 382 int8_t defaultEffectiveTxPower;
rgrover1 206:49646c933822 383 uint16_t defaultBeaconPeriod;
rgrover1 188:9020a5ac80c8 384
rgrover1 206:49646c933822 385 GattCharacteristic lockedStateChar;
rgrover1 206:49646c933822 386 GattCharacteristic uriDataChar;
rgrover1 206:49646c933822 387 GattCharacteristic flagsChar;
rgrover1 206:49646c933822 388 GattCharacteristic txPowerLevelsChar;
rgrover1 206:49646c933822 389 GattCharacteristic beaconPeriodChar;
rgrover1 206:49646c933822 390 GattCharacteristic resetChar;
rgrover1 171:6092e61690dc 391 };
rgrover1 171:6092e61690dc 392
rgrover1 207:e88130dc254c 393 #endif /* #ifndef __BLE_URI_BEACON_CONFIG_SERVICE_H__*/