BLE EddystoneService example
This example is a fork of the following mbed-os example:
https://developer.mbed.org/teams/mbed-os-examples/code/mbed-os-example-ble-EddystoneService/
Please read the documentation in this page.
source/EddystoneService.h@1:9db4d46bb63f, 2016-07-28 (annotated)
- Committer:
- mbed_official
- Date:
- Thu Jul 28 23:14:36 2016 +0100
- Revision:
- 1:9db4d46bb63f
- Parent:
- 0:4c8f8bf32a99
- Child:
- 2:9ee673e0b86a
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?
User | Revision | Line number | New contents of line |
---|---|---|---|
mbed_official | 1:9db4d46bb63f | 1 | /* mbed Microcontroller Library |
mbed_official | 1:9db4d46bb63f | 2 | * Copyright (c) 2006-2015 ARM Limited |
mbed_official | 1:9db4d46bb63f | 3 | * |
mbed_official | 1:9db4d46bb63f | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
mbed_official | 1:9db4d46bb63f | 5 | * you may not use this file except in compliance with the License. |
mbed_official | 1:9db4d46bb63f | 6 | * You may obtain a copy of the License at |
mbed_official | 1:9db4d46bb63f | 7 | * |
mbed_official | 1:9db4d46bb63f | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
mbed_official | 1:9db4d46bb63f | 9 | * |
mbed_official | 1:9db4d46bb63f | 10 | * Unless required by applicable law or agreed to in writing, software |
mbed_official | 1:9db4d46bb63f | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
mbed_official | 1:9db4d46bb63f | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
mbed_official | 1:9db4d46bb63f | 13 | * See the License for the specific language governing permissions and |
mbed_official | 1:9db4d46bb63f | 14 | * limitations under the License. |
mbed_official | 1:9db4d46bb63f | 15 | */ |
mbed_official | 1:9db4d46bb63f | 16 | |
mbed_official | 1:9db4d46bb63f | 17 | #ifndef __EDDYSTONESERVICE_H__ |
mbed_official | 1:9db4d46bb63f | 18 | #define __EDDYSTONESERVICE_H__ |
mbed_official | 1:9db4d46bb63f | 19 | |
mbed_official | 1:9db4d46bb63f | 20 | #include <mbed-events/events.h> |
mbed_official | 1:9db4d46bb63f | 21 | #include "ble/BLE.h" |
mbed_official | 1:9db4d46bb63f | 22 | #include "EddystoneTypes.h" |
mbed_official | 1:9db4d46bb63f | 23 | #include "URLFrame.h" |
mbed_official | 1:9db4d46bb63f | 24 | #include "UIDFrame.h" |
mbed_official | 1:9db4d46bb63f | 25 | #include "TLMFrame.h" |
mbed_official | 1:9db4d46bb63f | 26 | #include <string.h> |
mbed_official | 1:9db4d46bb63f | 27 | #ifdef YOTTA_CFG_MBED_OS |
mbed_official | 1:9db4d46bb63f | 28 | #include <mbed.h> |
mbed_official | 1:9db4d46bb63f | 29 | #include "mbed-drivers/CircularBuffer.h" |
mbed_official | 1:9db4d46bb63f | 30 | #else |
mbed_official | 1:9db4d46bb63f | 31 | #include "mbed.h" |
mbed_official | 1:9db4d46bb63f | 32 | #include "CircularBuffer.h" |
mbed_official | 1:9db4d46bb63f | 33 | #endif |
mbed_official | 1:9db4d46bb63f | 34 | |
mbed_official | 1:9db4d46bb63f | 35 | #ifndef YOTTA_CFG_EDDYSTONE_DEFAULT_URL_FRAME_INTERVAL |
mbed_official | 1:9db4d46bb63f | 36 | #define YOTTA_CFG_EDDYSTONE_DEFAULT_URL_FRAME_INTERVAL 700 |
mbed_official | 1:9db4d46bb63f | 37 | #endif |
mbed_official | 1:9db4d46bb63f | 38 | |
mbed_official | 1:9db4d46bb63f | 39 | #ifndef YOTTA_CFG_EDDYSTONE_DEFAULT_UID_FRAME_INTERVAL |
mbed_official | 1:9db4d46bb63f | 40 | #define YOTTA_CFG_EDDYSTONE_DEFAULT_UID_FRAME_INTERVAL 300 |
mbed_official | 1:9db4d46bb63f | 41 | #endif |
mbed_official | 1:9db4d46bb63f | 42 | |
mbed_official | 1:9db4d46bb63f | 43 | #ifndef YOTTA_CFG_EDDYSTONE_DEFAULT_TLM_FRAME_INTERVAL |
mbed_official | 1:9db4d46bb63f | 44 | #define YOTTA_CFG_EDDYSTONE_DEFAULT_TLM_FRAME_INTERVAL 2000 |
mbed_official | 1:9db4d46bb63f | 45 | #endif |
mbed_official | 1:9db4d46bb63f | 46 | |
mbed_official | 1:9db4d46bb63f | 47 | #ifndef YOTTA_CFG_EDDYSTONE_DEFAULT_EDDYSTONE_URL_CONFIG_ADV_INTERVAL |
mbed_official | 1:9db4d46bb63f | 48 | #define YOTTA_CFG_EDDYSTONE_DEFAULT_EDDYSTONE_URL_CONFIG_ADV_INTERVAL 1000 |
mbed_official | 1:9db4d46bb63f | 49 | #endif |
mbed_official | 1:9db4d46bb63f | 50 | |
mbed_official | 1:9db4d46bb63f | 51 | /** |
mbed_official | 1:9db4d46bb63f | 52 | * This class implements the Eddystone-URL Config Service and the Eddystone |
mbed_official | 1:9db4d46bb63f | 53 | * Protocol Specification as defined in the publicly available specification at |
mbed_official | 1:9db4d46bb63f | 54 | * https://github.com/google/eddystone/blob/master/protocol-specification.md. |
mbed_official | 1:9db4d46bb63f | 55 | */ |
mbed_official | 1:9db4d46bb63f | 56 | class EddystoneService |
mbed_official | 1:9db4d46bb63f | 57 | { |
mbed_official | 1:9db4d46bb63f | 58 | public: |
mbed_official | 1:9db4d46bb63f | 59 | /** |
mbed_official | 1:9db4d46bb63f | 60 | * Total number of GATT Characteristics in the Eddystonei-URL Configuration |
mbed_official | 1:9db4d46bb63f | 61 | * Service. |
mbed_official | 1:9db4d46bb63f | 62 | */ |
mbed_official | 1:9db4d46bb63f | 63 | static const uint16_t TOTAL_CHARACTERISTICS = 9; |
mbed_official | 1:9db4d46bb63f | 64 | |
mbed_official | 1:9db4d46bb63f | 65 | /** |
mbed_official | 1:9db4d46bb63f | 66 | * Default interval for advertising packets for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 67 | * Configuration Service. |
mbed_official | 1:9db4d46bb63f | 68 | */ |
mbed_official | 1:9db4d46bb63f | 69 | static const uint32_t DEFAULT_CONFIG_PERIOD_MSEC = YOTTA_CFG_EDDYSTONE_DEFAULT_EDDYSTONE_URL_CONFIG_ADV_INTERVAL; |
mbed_official | 1:9db4d46bb63f | 70 | /** |
mbed_official | 1:9db4d46bb63f | 71 | * Recommended interval for advertising packets containing Eddystone URL |
mbed_official | 1:9db4d46bb63f | 72 | * frames. |
mbed_official | 1:9db4d46bb63f | 73 | */ |
mbed_official | 1:9db4d46bb63f | 74 | static const uint16_t DEFAULT_URL_FRAME_PERIOD_MSEC = YOTTA_CFG_EDDYSTONE_DEFAULT_URL_FRAME_INTERVAL; |
mbed_official | 1:9db4d46bb63f | 75 | /** |
mbed_official | 1:9db4d46bb63f | 76 | * Recommended interval for advertising packets containing Eddystone UID |
mbed_official | 1:9db4d46bb63f | 77 | * frames. |
mbed_official | 1:9db4d46bb63f | 78 | */ |
mbed_official | 1:9db4d46bb63f | 79 | static const uint16_t DEFAULT_UID_FRAME_PERIOD_MSEC = YOTTA_CFG_EDDYSTONE_DEFAULT_UID_FRAME_INTERVAL; |
mbed_official | 1:9db4d46bb63f | 80 | /** |
mbed_official | 1:9db4d46bb63f | 81 | * Recommended interval for advertising packets containing Eddystone TLM |
mbed_official | 1:9db4d46bb63f | 82 | * frames. |
mbed_official | 1:9db4d46bb63f | 83 | */ |
mbed_official | 1:9db4d46bb63f | 84 | static const uint16_t DEFAULT_TLM_FRAME_PERIOD_MSEC = YOTTA_CFG_EDDYSTONE_DEFAULT_TLM_FRAME_INTERVAL; |
mbed_official | 1:9db4d46bb63f | 85 | |
mbed_official | 1:9db4d46bb63f | 86 | /** |
mbed_official | 1:9db4d46bb63f | 87 | * Enumeration that defines the various operation modes of the |
mbed_official | 1:9db4d46bb63f | 88 | * EddystoneService. |
mbed_official | 1:9db4d46bb63f | 89 | * |
mbed_official | 1:9db4d46bb63f | 90 | * @note The main app can change the mode of EddystoneService at any point |
mbed_official | 1:9db4d46bb63f | 91 | * of time by calling startConfigService() or startBeaconService(). |
mbed_official | 1:9db4d46bb63f | 92 | * Resources from the previous mode will be freed. |
mbed_official | 1:9db4d46bb63f | 93 | * |
mbed_official | 1:9db4d46bb63f | 94 | * @note It is currently NOT possible to force EddystoneService back into |
mbed_official | 1:9db4d46bb63f | 95 | * EDDYSTONE_MODE_NONE. |
mbed_official | 1:9db4d46bb63f | 96 | */ |
mbed_official | 1:9db4d46bb63f | 97 | enum OperationModes { |
mbed_official | 1:9db4d46bb63f | 98 | /** |
mbed_official | 1:9db4d46bb63f | 99 | * NONE: EddystoneService has been initialized but no memory has been |
mbed_official | 1:9db4d46bb63f | 100 | * dynamically allocated. Additionally, no services are running |
mbed_official | 1:9db4d46bb63f | 101 | * nothing is being advertised. |
mbed_official | 1:9db4d46bb63f | 102 | */ |
mbed_official | 1:9db4d46bb63f | 103 | EDDYSTONE_MODE_NONE, |
mbed_official | 1:9db4d46bb63f | 104 | /** |
mbed_official | 1:9db4d46bb63f | 105 | * CONFIG: EddystoneService has been initialized, the configuration |
mbed_official | 1:9db4d46bb63f | 106 | * service started and memory has been allocated for BLE |
mbed_official | 1:9db4d46bb63f | 107 | * characteristics. Memory consumption peaks during CONFIG |
mbed_official | 1:9db4d46bb63f | 108 | * mode. |
mbed_official | 1:9db4d46bb63f | 109 | */ |
mbed_official | 1:9db4d46bb63f | 110 | EDDYSTONE_MODE_CONFIG, |
mbed_official | 1:9db4d46bb63f | 111 | /** |
mbed_official | 1:9db4d46bb63f | 112 | * BEACON: Eddystone service is running as a beacon advertising URL, |
mbed_official | 1:9db4d46bb63f | 113 | * UID and/or TLM frames depending on how it is configured. |
mbed_official | 1:9db4d46bb63f | 114 | */ |
mbed_official | 1:9db4d46bb63f | 115 | EDDYSTONE_MODE_BEACON |
mbed_official | 1:9db4d46bb63f | 116 | }; |
mbed_official | 1:9db4d46bb63f | 117 | |
mbed_official | 1:9db4d46bb63f | 118 | /** |
mbed_official | 1:9db4d46bb63f | 119 | * Structure that encapsulates the Eddystone configuration parameters. This |
mbed_official | 1:9db4d46bb63f | 120 | * structure is particularly useful when storing the parameters to |
mbed_official | 1:9db4d46bb63f | 121 | * persistent storage. |
mbed_official | 1:9db4d46bb63f | 122 | */ |
mbed_official | 1:9db4d46bb63f | 123 | struct EddystoneParams_t { |
mbed_official | 1:9db4d46bb63f | 124 | /** |
mbed_official | 1:9db4d46bb63f | 125 | * The value of the Eddystone-URL Configuration Service Lock State |
mbed_official | 1:9db4d46bb63f | 126 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 127 | */ |
mbed_official | 1:9db4d46bb63f | 128 | bool lockState; |
mbed_official | 1:9db4d46bb63f | 129 | /** |
mbed_official | 1:9db4d46bb63f | 130 | * The value of the Eddystone-URL Configuration Service Lock |
mbed_official | 1:9db4d46bb63f | 131 | * characteristic that can be used to lock the beacon and set the |
mbed_official | 1:9db4d46bb63f | 132 | * single-use lock-code. |
mbed_official | 1:9db4d46bb63f | 133 | */ |
mbed_official | 1:9db4d46bb63f | 134 | Lock_t lock; |
mbed_official | 1:9db4d46bb63f | 135 | /** |
mbed_official | 1:9db4d46bb63f | 136 | * The value of the Eddystone-URL Configuration Service Unlock |
mbed_official | 1:9db4d46bb63f | 137 | * characteristic that can be used to unlock the beacon and clear the |
mbed_official | 1:9db4d46bb63f | 138 | * single-use lock-code. |
mbed_official | 1:9db4d46bb63f | 139 | */ |
mbed_official | 1:9db4d46bb63f | 140 | Lock_t unlock; |
mbed_official | 1:9db4d46bb63f | 141 | /** |
mbed_official | 1:9db4d46bb63f | 142 | * The value of the Eddystone-URL Configuration Service Flags |
mbed_official | 1:9db4d46bb63f | 143 | * characteristic. This value is currently fixed to 0x10. |
mbed_official | 1:9db4d46bb63f | 144 | */ |
mbed_official | 1:9db4d46bb63f | 145 | uint8_t flags; |
mbed_official | 1:9db4d46bb63f | 146 | /** |
mbed_official | 1:9db4d46bb63f | 147 | * The value of the Eddystone-URL Configuration Service Advertised TX |
mbed_official | 1:9db4d46bb63f | 148 | * Power Levels characteristic that is an array of bytes whose values |
mbed_official | 1:9db4d46bb63f | 149 | * are put into the advertising packets when in EDDYSTONE_BEACON_MODE. |
mbed_official | 1:9db4d46bb63f | 150 | * |
mbed_official | 1:9db4d46bb63f | 151 | * @note These are not the same values set internally into the radio tx |
mbed_official | 1:9db4d46bb63f | 152 | * power. |
mbed_official | 1:9db4d46bb63f | 153 | */ |
mbed_official | 1:9db4d46bb63f | 154 | PowerLevels_t advPowerLevels; |
mbed_official | 1:9db4d46bb63f | 155 | /** |
mbed_official | 1:9db4d46bb63f | 156 | * The value of the Eddystone-URL Configuration Service TX Power Mode |
mbed_official | 1:9db4d46bb63f | 157 | * characteristic. This value is an index into the |
mbed_official | 1:9db4d46bb63f | 158 | * EddystoneParams_t::advPowerLevels array. |
mbed_official | 1:9db4d46bb63f | 159 | */ |
mbed_official | 1:9db4d46bb63f | 160 | uint8_t txPowerMode; |
mbed_official | 1:9db4d46bb63f | 161 | /** |
mbed_official | 1:9db4d46bb63f | 162 | * The value of the Eddystone-URL Configuration Service Beacon Period |
mbed_official | 1:9db4d46bb63f | 163 | * characteristic that is the interval (in milliseconds) of the |
mbed_official | 1:9db4d46bb63f | 164 | * Eddystone-URL frames. |
mbed_official | 1:9db4d46bb63f | 165 | * |
mbed_official | 1:9db4d46bb63f | 166 | * @note A value of zero disables Eddystone-URL frame trasmissions. |
mbed_official | 1:9db4d46bb63f | 167 | */ |
mbed_official | 1:9db4d46bb63f | 168 | uint16_t urlFramePeriod; |
mbed_official | 1:9db4d46bb63f | 169 | /** |
mbed_official | 1:9db4d46bb63f | 170 | * The configured interval (in milliseconds) of the Eddystone-UID |
mbed_official | 1:9db4d46bb63f | 171 | * frames. |
mbed_official | 1:9db4d46bb63f | 172 | * |
mbed_official | 1:9db4d46bb63f | 173 | * @note A value of zero disables Eddystone-UID frame transmissions. |
mbed_official | 1:9db4d46bb63f | 174 | * |
mbed_official | 1:9db4d46bb63f | 175 | * @note Currently it is only possible to modify this value by using |
mbed_official | 1:9db4d46bb63f | 176 | * the setUIDFrameAdvertisingInterval() API. |
mbed_official | 1:9db4d46bb63f | 177 | */ |
mbed_official | 1:9db4d46bb63f | 178 | uint16_t uidFramePeriod; |
mbed_official | 1:9db4d46bb63f | 179 | /** |
mbed_official | 1:9db4d46bb63f | 180 | * The configured interval (in milliseconds) of the Eddystone-TLM |
mbed_official | 1:9db4d46bb63f | 181 | * frames. |
mbed_official | 1:9db4d46bb63f | 182 | * |
mbed_official | 1:9db4d46bb63f | 183 | * @note A value of zero disables Eddystone-TLM frame transmissions. |
mbed_official | 1:9db4d46bb63f | 184 | * |
mbed_official | 1:9db4d46bb63f | 185 | * @note Currently it is only possible to modify this value by using |
mbed_official | 1:9db4d46bb63f | 186 | * the setTLMFrameAdvertisingInterval() API. |
mbed_official | 1:9db4d46bb63f | 187 | */ |
mbed_official | 1:9db4d46bb63f | 188 | uint16_t tlmFramePeriod; |
mbed_official | 1:9db4d46bb63f | 189 | /** |
mbed_official | 1:9db4d46bb63f | 190 | * The configured version of the Eddystone-TLM frames. |
mbed_official | 1:9db4d46bb63f | 191 | */ |
mbed_official | 1:9db4d46bb63f | 192 | uint8_t tlmVersion; |
mbed_official | 1:9db4d46bb63f | 193 | /** |
mbed_official | 1:9db4d46bb63f | 194 | * The length of the encoded URL in EddystoneParams_t::urlData used |
mbed_official | 1:9db4d46bb63f | 195 | * within Eddystone-URL frames. |
mbed_official | 1:9db4d46bb63f | 196 | */ |
mbed_official | 1:9db4d46bb63f | 197 | uint8_t urlDataLength; |
mbed_official | 1:9db4d46bb63f | 198 | /** |
mbed_official | 1:9db4d46bb63f | 199 | * The value of the Eddystone-URL Configuration Service URI Data |
mbed_official | 1:9db4d46bb63f | 200 | * characteristic that contains an encoded URL as described in the |
mbed_official | 1:9db4d46bb63f | 201 | * Eddystone Specification at |
mbed_official | 1:9db4d46bb63f | 202 | * https://github.com/google/eddystone/blob/master/eddystone-url/README.md#eddystone-url-http-url-encoding. |
mbed_official | 1:9db4d46bb63f | 203 | */ |
mbed_official | 1:9db4d46bb63f | 204 | UrlData_t urlData; |
mbed_official | 1:9db4d46bb63f | 205 | /** |
mbed_official | 1:9db4d46bb63f | 206 | * The configured 10-byte namespace ID in Eddystone-UID frames that may |
mbed_official | 1:9db4d46bb63f | 207 | * be used to group a particular set of beacons. |
mbed_official | 1:9db4d46bb63f | 208 | */ |
mbed_official | 1:9db4d46bb63f | 209 | UIDNamespaceID_t uidNamespaceID; |
mbed_official | 1:9db4d46bb63f | 210 | /** |
mbed_official | 1:9db4d46bb63f | 211 | * The configured 6-byte instance ID that may be used to uniquely |
mbed_official | 1:9db4d46bb63f | 212 | * identify individual devices in a group. |
mbed_official | 1:9db4d46bb63f | 213 | */ |
mbed_official | 1:9db4d46bb63f | 214 | UIDInstanceID_t uidInstanceID; |
mbed_official | 1:9db4d46bb63f | 215 | }; |
mbed_official | 1:9db4d46bb63f | 216 | |
mbed_official | 1:9db4d46bb63f | 217 | /** |
mbed_official | 1:9db4d46bb63f | 218 | * Enumeration that defines the various error codes for EddystoneService. |
mbed_official | 1:9db4d46bb63f | 219 | */ |
mbed_official | 1:9db4d46bb63f | 220 | enum EddystoneError_t { |
mbed_official | 1:9db4d46bb63f | 221 | /** |
mbed_official | 1:9db4d46bb63f | 222 | * No error occurred. |
mbed_official | 1:9db4d46bb63f | 223 | */ |
mbed_official | 1:9db4d46bb63f | 224 | EDDYSTONE_ERROR_NONE, |
mbed_official | 1:9db4d46bb63f | 225 | /** |
mbed_official | 1:9db4d46bb63f | 226 | * The supplied advertising interval is invalid. The interval may be |
mbed_official | 1:9db4d46bb63f | 227 | * too short/long for the type of advertising packets being broadcast. |
mbed_official | 1:9db4d46bb63f | 228 | * |
mbed_official | 1:9db4d46bb63f | 229 | * @note For the acceptable range of advertising interval refer to the |
mbed_official | 1:9db4d46bb63f | 230 | * following functions in mbed BLE API: |
mbed_official | 1:9db4d46bb63f | 231 | * - Gap::getMinNonConnectableAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 232 | * - Gap::getMinAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 233 | * - Gap::getMaxAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 234 | */ |
mbed_official | 1:9db4d46bb63f | 235 | EDDYSTONE_ERROR_INVALID_ADVERTISING_INTERVAL, |
mbed_official | 1:9db4d46bb63f | 236 | /** |
mbed_official | 1:9db4d46bb63f | 237 | * The result of executing a call when the the EddystoneService is in |
mbed_official | 1:9db4d46bb63f | 238 | * the incorrect operation mode. |
mbed_official | 1:9db4d46bb63f | 239 | */ |
mbed_official | 1:9db4d46bb63f | 240 | EDDYSTONE_ERROR_INVALID_STATE |
mbed_official | 1:9db4d46bb63f | 241 | }; |
mbed_official | 1:9db4d46bb63f | 242 | |
mbed_official | 1:9db4d46bb63f | 243 | /** |
mbed_official | 1:9db4d46bb63f | 244 | * Enumeration that defines the available frame types within Eddystone |
mbed_official | 1:9db4d46bb63f | 245 | * advertising packets. |
mbed_official | 1:9db4d46bb63f | 246 | */ |
mbed_official | 1:9db4d46bb63f | 247 | enum FrameType { |
mbed_official | 1:9db4d46bb63f | 248 | /** |
mbed_official | 1:9db4d46bb63f | 249 | * The Eddystone-URL frame. Refer to |
mbed_official | 1:9db4d46bb63f | 250 | * https://github.com/google/eddystone/tree/master/eddystone-url. |
mbed_official | 1:9db4d46bb63f | 251 | */ |
mbed_official | 1:9db4d46bb63f | 252 | EDDYSTONE_FRAME_URL, |
mbed_official | 1:9db4d46bb63f | 253 | /** |
mbed_official | 1:9db4d46bb63f | 254 | * The Eddystone-URL frame. Refer to |
mbed_official | 1:9db4d46bb63f | 255 | * https://github.com/google/eddystone/tree/master/eddystone-uid. |
mbed_official | 1:9db4d46bb63f | 256 | */ |
mbed_official | 1:9db4d46bb63f | 257 | EDDYSTONE_FRAME_UID, |
mbed_official | 1:9db4d46bb63f | 258 | /** |
mbed_official | 1:9db4d46bb63f | 259 | * The Eddystone-URL frame. Refer to |
mbed_official | 1:9db4d46bb63f | 260 | * https://github.com/google/eddystone/tree/master/eddystone-tlm. |
mbed_official | 1:9db4d46bb63f | 261 | */ |
mbed_official | 1:9db4d46bb63f | 262 | EDDYSTONE_FRAME_TLM, |
mbed_official | 1:9db4d46bb63f | 263 | /** |
mbed_official | 1:9db4d46bb63f | 264 | * The total number Eddystone frame types. |
mbed_official | 1:9db4d46bb63f | 265 | */ |
mbed_official | 1:9db4d46bb63f | 266 | NUM_EDDYSTONE_FRAMES |
mbed_official | 1:9db4d46bb63f | 267 | }; |
mbed_official | 1:9db4d46bb63f | 268 | |
mbed_official | 1:9db4d46bb63f | 269 | /** |
mbed_official | 1:9db4d46bb63f | 270 | * The size of the advertising frame queue. |
mbed_official | 1:9db4d46bb63f | 271 | * |
mbed_official | 1:9db4d46bb63f | 272 | * @note [WARNING] If the advertising rate for any of the frames is higher |
mbed_official | 1:9db4d46bb63f | 273 | * than 100ms then frames will be dropped, this value must be |
mbed_official | 1:9db4d46bb63f | 274 | * increased. |
mbed_official | 1:9db4d46bb63f | 275 | */ |
mbed_official | 1:9db4d46bb63f | 276 | static const uint16_t ADV_FRAME_QUEUE_SIZE = NUM_EDDYSTONE_FRAMES; |
mbed_official | 1:9db4d46bb63f | 277 | |
mbed_official | 1:9db4d46bb63f | 278 | |
mbed_official | 1:9db4d46bb63f | 279 | /** |
mbed_official | 1:9db4d46bb63f | 280 | * Constructor that Initializes the EddystoneService using parameters from |
mbed_official | 1:9db4d46bb63f | 281 | * the supplied EddystoneParams_t. This constructor is particularly useful |
mbed_official | 1:9db4d46bb63f | 282 | * for configuring the EddystoneService with parameters fetched from |
mbed_official | 1:9db4d46bb63f | 283 | * persistent storage. |
mbed_official | 1:9db4d46bb63f | 284 | * |
mbed_official | 1:9db4d46bb63f | 285 | * @param[in] bleIn |
mbed_official | 1:9db4d46bb63f | 286 | * The BLE instance. |
mbed_official | 1:9db4d46bb63f | 287 | * @param[in] paramIn |
mbed_official | 1:9db4d46bb63f | 288 | * The input Eddystone configuration parameters. |
mbed_official | 1:9db4d46bb63f | 289 | * @param[in] radioPowerLevelsIn |
mbed_official | 1:9db4d46bb63f | 290 | * The value set internally into the radion tx power. |
mbed_official | 1:9db4d46bb63f | 291 | * @param[in] advConfigIntervalIn |
mbed_official | 1:9db4d46bb63f | 292 | * The advertising interval for advertising packets of the |
mbed_official | 1:9db4d46bb63f | 293 | * Eddystone-URL Configuration Service. |
mbed_official | 1:9db4d46bb63f | 294 | */ |
mbed_official | 1:9db4d46bb63f | 295 | EddystoneService(BLE &bleIn, |
mbed_official | 1:9db4d46bb63f | 296 | EddystoneParams_t ¶msIn, |
mbed_official | 1:9db4d46bb63f | 297 | const PowerLevels_t &radioPowerLevelsIn, |
mbed_official | 1:9db4d46bb63f | 298 | events::EventQueue& eventQueue, |
mbed_official | 1:9db4d46bb63f | 299 | uint32_t advConfigIntervalIn = DEFAULT_CONFIG_PERIOD_MSEC); |
mbed_official | 1:9db4d46bb63f | 300 | |
mbed_official | 1:9db4d46bb63f | 301 | /** |
mbed_official | 1:9db4d46bb63f | 302 | * Constructor to initialize the EddystoneService to default values. |
mbed_official | 1:9db4d46bb63f | 303 | * |
mbed_official | 1:9db4d46bb63f | 304 | * @param[in] bleIn |
mbed_official | 1:9db4d46bb63f | 305 | * The BLE instance. |
mbed_official | 1:9db4d46bb63f | 306 | * @param[in] advPowerLevelsIn |
mbed_official | 1:9db4d46bb63f | 307 | * The value of the Eddystone-URL Configuration Service TX |
mbed_official | 1:9db4d46bb63f | 308 | * Power Mode characteristic. |
mbed_official | 1:9db4d46bb63f | 309 | * @param[in] radioPowerLevelsIn |
mbed_official | 1:9db4d46bb63f | 310 | * The value set internally into the radion tx power. |
mbed_official | 1:9db4d46bb63f | 311 | * @param[in] advConfigIntervalIn |
mbed_official | 1:9db4d46bb63f | 312 | * The advertising interval for advertising packets of the |
mbed_official | 1:9db4d46bb63f | 313 | * Eddystone-URL Configuration Service. |
mbed_official | 1:9db4d46bb63f | 314 | * |
mbed_official | 1:9db4d46bb63f | 315 | * @note When using this constructor the setURLData(), setTMLData() and |
mbed_official | 1:9db4d46bb63f | 316 | * setUIDData() functions must be called to initialize |
mbed_official | 1:9db4d46bb63f | 317 | * EddystoneService manually. |
mbed_official | 1:9db4d46bb63f | 318 | */ |
mbed_official | 1:9db4d46bb63f | 319 | EddystoneService(BLE &bleIn, |
mbed_official | 1:9db4d46bb63f | 320 | const PowerLevels_t &advPowerLevelsIn, |
mbed_official | 1:9db4d46bb63f | 321 | const PowerLevels_t &radioPowerLevelsIn, |
mbed_official | 1:9db4d46bb63f | 322 | EventQueue &eventQueue, |
mbed_official | 1:9db4d46bb63f | 323 | uint32_t advConfigIntervalIn = DEFAULT_CONFIG_PERIOD_MSEC); |
mbed_official | 1:9db4d46bb63f | 324 | |
mbed_official | 1:9db4d46bb63f | 325 | /** |
mbed_official | 1:9db4d46bb63f | 326 | * Setup callback to update BatteryVoltage in Eddystone-TLM frames |
mbed_official | 1:9db4d46bb63f | 327 | * |
mbed_official | 1:9db4d46bb63f | 328 | * @param[in] tlmBatteryVoltageCallbackIn |
mbed_official | 1:9db4d46bb63f | 329 | * The callback being registered. |
mbed_official | 1:9db4d46bb63f | 330 | */ |
mbed_official | 1:9db4d46bb63f | 331 | void onTLMBatteryVoltageUpdate(TlmUpdateCallback_t tlmBatteryVoltageCallbackIn); |
mbed_official | 1:9db4d46bb63f | 332 | |
mbed_official | 1:9db4d46bb63f | 333 | /** |
mbed_official | 1:9db4d46bb63f | 334 | * Setup callback to update BeaconTemperature in Eddystone-TLM frames |
mbed_official | 1:9db4d46bb63f | 335 | * |
mbed_official | 1:9db4d46bb63f | 336 | * @param[in] tlmBeaconTemperatureCallbackIn |
mbed_official | 1:9db4d46bb63f | 337 | * The callback being registered. |
mbed_official | 1:9db4d46bb63f | 338 | */ |
mbed_official | 1:9db4d46bb63f | 339 | void onTLMBeaconTemperatureUpdate(TlmUpdateCallback_t tlmBeaconTemperatureCallbackIn); |
mbed_official | 1:9db4d46bb63f | 340 | |
mbed_official | 1:9db4d46bb63f | 341 | /** |
mbed_official | 1:9db4d46bb63f | 342 | * Set the Eddystone-TLM frame version. The other components of |
mbed_official | 1:9db4d46bb63f | 343 | * Eddystone-TLM frames are updated just before the frame is broadcast |
mbed_official | 1:9db4d46bb63f | 344 | * since information such as beacon temperature and time since boot changes |
mbed_official | 1:9db4d46bb63f | 345 | * relatively quickly. |
mbed_official | 1:9db4d46bb63f | 346 | * |
mbed_official | 1:9db4d46bb63f | 347 | * @param[in] tlmVersionIn |
mbed_official | 1:9db4d46bb63f | 348 | * The Eddyston-TLM version to set. |
mbed_official | 1:9db4d46bb63f | 349 | */ |
mbed_official | 1:9db4d46bb63f | 350 | void setTLMData(uint8_t tlmVersionIn = 0); |
mbed_official | 1:9db4d46bb63f | 351 | |
mbed_official | 1:9db4d46bb63f | 352 | /** |
mbed_official | 1:9db4d46bb63f | 353 | * Set the Eddystone-URL frame URL data. |
mbed_official | 1:9db4d46bb63f | 354 | * |
mbed_official | 1:9db4d46bb63f | 355 | * @param[in] urlDataIn |
mbed_official | 1:9db4d46bb63f | 356 | * A pointer to the plain null terminated string representing |
mbed_official | 1:9db4d46bb63f | 357 | * a URL to be encoded. |
mbed_official | 1:9db4d46bb63f | 358 | */ |
mbed_official | 1:9db4d46bb63f | 359 | void setURLData(const char *urlDataIn); |
mbed_official | 1:9db4d46bb63f | 360 | |
mbed_official | 1:9db4d46bb63f | 361 | /** |
mbed_official | 1:9db4d46bb63f | 362 | * Set the Eddystone-UID namespace and instance IDs. |
mbed_official | 1:9db4d46bb63f | 363 | * |
mbed_official | 1:9db4d46bb63f | 364 | * @param[in] uidNamespaceIDIn |
mbed_official | 1:9db4d46bb63f | 365 | * The new Eddystone-UID namespace ID. |
mbed_official | 1:9db4d46bb63f | 366 | * @param[in] uidInstanceIDIn |
mbed_official | 1:9db4d46bb63f | 367 | * The new Eddystone-UID instance ID. |
mbed_official | 1:9db4d46bb63f | 368 | */ |
mbed_official | 1:9db4d46bb63f | 369 | void setUIDData(const UIDNamespaceID_t &uidNamespaceIDIn, const UIDInstanceID_t &uidInstanceIDIn); |
mbed_official | 1:9db4d46bb63f | 370 | |
mbed_official | 1:9db4d46bb63f | 371 | /** |
mbed_official | 1:9db4d46bb63f | 372 | * Set the interval of the Eddystone-URL frames. |
mbed_official | 1:9db4d46bb63f | 373 | * |
mbed_official | 1:9db4d46bb63f | 374 | * @param[in] urlFrameIntervalIn |
mbed_official | 1:9db4d46bb63f | 375 | * The new frame interval in milliseconds. The default is |
mbed_official | 1:9db4d46bb63f | 376 | * DEFAULT_URL_FRAME_PERIOD_MSEC. |
mbed_official | 1:9db4d46bb63f | 377 | * |
mbed_official | 1:9db4d46bb63f | 378 | * @note A value of zero disables Eddystone-URL frame transmissions. |
mbed_official | 1:9db4d46bb63f | 379 | */ |
mbed_official | 1:9db4d46bb63f | 380 | void setURLFrameAdvertisingInterval(uint16_t urlFrameIntervalIn = DEFAULT_URL_FRAME_PERIOD_MSEC); |
mbed_official | 1:9db4d46bb63f | 381 | |
mbed_official | 1:9db4d46bb63f | 382 | /** |
mbed_official | 1:9db4d46bb63f | 383 | * Set the interval of the Eddystone-UID frames. |
mbed_official | 1:9db4d46bb63f | 384 | * |
mbed_official | 1:9db4d46bb63f | 385 | * @param[in] uidFrameIntervalIn |
mbed_official | 1:9db4d46bb63f | 386 | * The new frame interval in milliseconds. The default is |
mbed_official | 1:9db4d46bb63f | 387 | * DEFAULT_UID_FRAME_PERIOD_MSEC. |
mbed_official | 1:9db4d46bb63f | 388 | * |
mbed_official | 1:9db4d46bb63f | 389 | * @note A value of zero disables Eddystone-UID frame transmissions. |
mbed_official | 1:9db4d46bb63f | 390 | */ |
mbed_official | 1:9db4d46bb63f | 391 | void setUIDFrameAdvertisingInterval(uint16_t uidFrameIntervalIn = DEFAULT_UID_FRAME_PERIOD_MSEC); |
mbed_official | 1:9db4d46bb63f | 392 | |
mbed_official | 1:9db4d46bb63f | 393 | /** |
mbed_official | 1:9db4d46bb63f | 394 | * Set the interval for the Eddystone-TLM frames. |
mbed_official | 1:9db4d46bb63f | 395 | * |
mbed_official | 1:9db4d46bb63f | 396 | * @param[in] tlmFrameIntervalIn |
mbed_official | 1:9db4d46bb63f | 397 | * The new frame interval in milliseconds. The default is |
mbed_official | 1:9db4d46bb63f | 398 | * DEFAULT_TLM_FRAME_PERIOD_MSEC. |
mbed_official | 1:9db4d46bb63f | 399 | * |
mbed_official | 1:9db4d46bb63f | 400 | * @note A value of zero desables Eddystone-TLM frames. |
mbed_official | 1:9db4d46bb63f | 401 | */ |
mbed_official | 1:9db4d46bb63f | 402 | void setTLMFrameAdvertisingInterval(uint16_t tlmFrameIntervalIn = DEFAULT_TLM_FRAME_PERIOD_MSEC); |
mbed_official | 1:9db4d46bb63f | 403 | |
mbed_official | 1:9db4d46bb63f | 404 | /** |
mbed_official | 1:9db4d46bb63f | 405 | * Change the EddystoneService OperationMode to EDDYSTONE_MODE_CONFIG. |
mbed_official | 1:9db4d46bb63f | 406 | * |
mbed_official | 1:9db4d46bb63f | 407 | * @retval EDDYSTONE_ERROR_NONE if the operation succeeded. |
mbed_official | 1:9db4d46bb63f | 408 | * @retval EDDYSONE_ERROR_INVALID_ADVERTISING_INTERVAL if the configured |
mbed_official | 1:9db4d46bb63f | 409 | * advertising interval is zero. |
mbed_official | 1:9db4d46bb63f | 410 | * |
mbed_official | 1:9db4d46bb63f | 411 | * @note If EddystoneService was previously in EDDYSTONE_MODE_BEACON, then |
mbed_official | 1:9db4d46bb63f | 412 | * the resources allocated to that mode of operation such as memory |
mbed_official | 1:9db4d46bb63f | 413 | * are freed and the BLE instance shutdown before the new operation |
mbed_official | 1:9db4d46bb63f | 414 | * mode is configured. |
mbed_official | 1:9db4d46bb63f | 415 | */ |
mbed_official | 1:9db4d46bb63f | 416 | EddystoneError_t startConfigService(void); |
mbed_official | 1:9db4d46bb63f | 417 | |
mbed_official | 1:9db4d46bb63f | 418 | /** |
mbed_official | 1:9db4d46bb63f | 419 | * Change the EddystoneService OperationMode to EDDYSTONE_MODE_BEACON. |
mbed_official | 1:9db4d46bb63f | 420 | * |
mbed_official | 1:9db4d46bb63f | 421 | * @retval EDDYSTONE_ERROR_NONE if the operation succeeded. |
mbed_official | 1:9db4d46bb63f | 422 | * @retval EDDYSONE_ERROR_INVALID_ADVERTISING_INTERVAL if the configured |
mbed_official | 1:9db4d46bb63f | 423 | * advertising interval is zero. |
mbed_official | 1:9db4d46bb63f | 424 | * |
mbed_official | 1:9db4d46bb63f | 425 | * @note If EddystoneService was previously in EDDYSTONE_MODE_CONFIG, then |
mbed_official | 1:9db4d46bb63f | 426 | * the resources allocated to that mode of operation such as memory |
mbed_official | 1:9db4d46bb63f | 427 | * are freed and the BLE instance shutdown before the new operation |
mbed_official | 1:9db4d46bb63f | 428 | * mode is configured. |
mbed_official | 1:9db4d46bb63f | 429 | */ |
mbed_official | 1:9db4d46bb63f | 430 | EddystoneError_t startBeaconService(void); |
mbed_official | 1:9db4d46bb63f | 431 | |
mbed_official | 1:9db4d46bb63f | 432 | /** |
mbed_official | 1:9db4d46bb63f | 433 | * Change the EddystoneService OperationMode to EDDYSTONE_MODE_NONE. |
mbed_official | 1:9db4d46bb63f | 434 | * |
mbed_official | 1:9db4d46bb63f | 435 | * @retval EDDYSTONE_ERROR_NONE if the operation succeeded. |
mbed_official | 1:9db4d46bb63f | 436 | * @retval EDDYSTONE_ERROR_INVALID_STATE if the state of the |
mbed_official | 1:9db4d46bb63f | 437 | * EddystoneService already is EDDYSTONE_MODE_NONE. |
mbed_official | 1:9db4d46bb63f | 438 | * |
mbed_official | 1:9db4d46bb63f | 439 | * @note If EddystoneService was previously in EDDYSTONE_MODE_CONFIG or |
mbed_official | 1:9db4d46bb63f | 440 | * EDDYSTONE_MODE_BEACON, then the resources allocated to that mode |
mbed_official | 1:9db4d46bb63f | 441 | * of operation such as memory are freed and the BLE instance |
mbed_official | 1:9db4d46bb63f | 442 | * shutdown before the new operation mode is configured. |
mbed_official | 1:9db4d46bb63f | 443 | */ |
mbed_official | 1:9db4d46bb63f | 444 | EddystoneError_t stopCurrentService(void); |
mbed_official | 1:9db4d46bb63f | 445 | |
mbed_official | 1:9db4d46bb63f | 446 | /** |
mbed_official | 1:9db4d46bb63f | 447 | * Set the Comple Local Name for the BLE device. This not only updates |
mbed_official | 1:9db4d46bb63f | 448 | * the value of the Device Name Characteristic, it also updates the scan |
mbed_official | 1:9db4d46bb63f | 449 | * response payload if the EddystoneService is currently in |
mbed_official | 1:9db4d46bb63f | 450 | * EDDYSTONE_MODE_CONFIG. |
mbed_official | 1:9db4d46bb63f | 451 | * |
mbed_official | 1:9db4d46bb63f | 452 | * @param[in] deviceNameIn |
mbed_official | 1:9db4d46bb63f | 453 | * A pointer to a null terminated string containing the new |
mbed_official | 1:9db4d46bb63f | 454 | * device name. |
mbed_official | 1:9db4d46bb63f | 455 | * |
mbed_official | 1:9db4d46bb63f | 456 | * @return BLE_ERROR_NONE if the name was successfully set. Otherwise an |
mbed_official | 1:9db4d46bb63f | 457 | * appropriate error. |
mbed_official | 1:9db4d46bb63f | 458 | * |
mbed_official | 1:9db4d46bb63f | 459 | * @note EddystoneService does not make an internal copy of the string |
mbed_official | 1:9db4d46bb63f | 460 | * pointed to by @p deviceNameIn. Therefore, the user is responsible |
mbed_official | 1:9db4d46bb63f | 461 | * for ensuring that the string persists in memory as long as it is |
mbed_official | 1:9db4d46bb63f | 462 | * in use by the EddystoneService. |
mbed_official | 1:9db4d46bb63f | 463 | * |
mbed_official | 1:9db4d46bb63f | 464 | * @note The device name is not considered an Eddystone configuration |
mbed_official | 1:9db4d46bb63f | 465 | * parameter; therefore, it is not contained within the |
mbed_official | 1:9db4d46bb63f | 466 | * EddystoneParams_t structure and must be stored to persistent |
mbed_official | 1:9db4d46bb63f | 467 | * storage separately. |
mbed_official | 1:9db4d46bb63f | 468 | */ |
mbed_official | 1:9db4d46bb63f | 469 | ble_error_t setCompleteDeviceName(const char *deviceNameIn); |
mbed_official | 1:9db4d46bb63f | 470 | |
mbed_official | 1:9db4d46bb63f | 471 | /** |
mbed_official | 1:9db4d46bb63f | 472 | * Get the Eddystone Configuration parameters. This is particularly useful |
mbed_official | 1:9db4d46bb63f | 473 | * for storing the configuration parameters in persistent storage. |
mbed_official | 1:9db4d46bb63f | 474 | * It is not the responsibility of the Eddystone implementation to store |
mbed_official | 1:9db4d46bb63f | 475 | * the configured parameters in persistent storage since this is |
mbed_official | 1:9db4d46bb63f | 476 | * platform-specific. |
mbed_official | 1:9db4d46bb63f | 477 | * |
mbed_official | 1:9db4d46bb63f | 478 | * @param[out] params |
mbed_official | 1:9db4d46bb63f | 479 | * A reference to an EddystoneParams_t structure with the |
mbed_official | 1:9db4d46bb63f | 480 | * configured parameters of the EddystoneService. |
mbed_official | 1:9db4d46bb63f | 481 | */ |
mbed_official | 1:9db4d46bb63f | 482 | void getEddystoneParams(EddystoneParams_t ¶ms); |
mbed_official | 1:9db4d46bb63f | 483 | |
mbed_official | 1:9db4d46bb63f | 484 | private: |
mbed_official | 1:9db4d46bb63f | 485 | /** |
mbed_official | 1:9db4d46bb63f | 486 | * Helper function used only once during construction of an |
mbed_official | 1:9db4d46bb63f | 487 | * EddystoneService object to avoid duplicated code. |
mbed_official | 1:9db4d46bb63f | 488 | * |
mbed_official | 1:9db4d46bb63f | 489 | * @param[in] advPowerLevelsIn |
mbed_official | 1:9db4d46bb63f | 490 | * The value of the Eddystone-URL Configuration Service TX |
mbed_official | 1:9db4d46bb63f | 491 | * Power Mode characteristic. |
mbed_official | 1:9db4d46bb63f | 492 | * @param[in] radioPowerLevelsIn |
mbed_official | 1:9db4d46bb63f | 493 | * The value set internally into the radion tx power. |
mbed_official | 1:9db4d46bb63f | 494 | * @param[in] advConfigIntervalIn |
mbed_official | 1:9db4d46bb63f | 495 | * The advertising interval for advertising packets of the |
mbed_official | 1:9db4d46bb63f | 496 | * Eddystone-URL Configuration Service. |
mbed_official | 1:9db4d46bb63f | 497 | */ |
mbed_official | 1:9db4d46bb63f | 498 | void eddystoneConstructorHelper(const PowerLevels_t &advPowerLevelsIn, |
mbed_official | 1:9db4d46bb63f | 499 | const PowerLevels_t &radioPowerLevelsIn, |
mbed_official | 1:9db4d46bb63f | 500 | uint32_t advConfigIntervalIn); |
mbed_official | 1:9db4d46bb63f | 501 | |
mbed_official | 1:9db4d46bb63f | 502 | /** |
mbed_official | 1:9db4d46bb63f | 503 | * Helper funtion that will be registered as an initialization complete |
mbed_official | 1:9db4d46bb63f | 504 | * callback when BLE::shutdown() is called. This is necessary when changing |
mbed_official | 1:9db4d46bb63f | 505 | * Eddystone OperationModes. Once the BLE initialization is complete, this |
mbed_official | 1:9db4d46bb63f | 506 | * callback will initialize all the necessary resource to operate |
mbed_official | 1:9db4d46bb63f | 507 | * Eddystone service in the selected mode. |
mbed_official | 1:9db4d46bb63f | 508 | * |
mbed_official | 1:9db4d46bb63f | 509 | * @param[in] initContext |
mbed_official | 1:9db4d46bb63f | 510 | * The context provided by BLE API when initialization |
mbed_official | 1:9db4d46bb63f | 511 | * completes. |
mbed_official | 1:9db4d46bb63f | 512 | */ |
mbed_official | 1:9db4d46bb63f | 513 | void bleInitComplete(BLE::InitializationCompleteCallbackContext* initContext); |
mbed_official | 1:9db4d46bb63f | 514 | |
mbed_official | 1:9db4d46bb63f | 515 | /** |
mbed_official | 1:9db4d46bb63f | 516 | * When in EDDYSTONE_MODE_BEACON this function is called to update the |
mbed_official | 1:9db4d46bb63f | 517 | * advertising payload to contain the information related to the specified |
mbed_official | 1:9db4d46bb63f | 518 | * FrameType. |
mbed_official | 1:9db4d46bb63f | 519 | * |
mbed_official | 1:9db4d46bb63f | 520 | * @param[in] frameType |
mbed_official | 1:9db4d46bb63f | 521 | * The frame to populate the advertising payload with. |
mbed_official | 1:9db4d46bb63f | 522 | */ |
mbed_official | 1:9db4d46bb63f | 523 | void swapAdvertisedFrame(FrameType frameType); |
mbed_official | 1:9db4d46bb63f | 524 | |
mbed_official | 1:9db4d46bb63f | 525 | /** |
mbed_official | 1:9db4d46bb63f | 526 | * Helper function that manages the BLE radio that is used to broadcast |
mbed_official | 1:9db4d46bb63f | 527 | * advertising packets. To advertise frames at the configured intervals |
mbed_official | 1:9db4d46bb63f | 528 | * the actual advertising interval of the BLE instance is set to the value |
mbed_official | 1:9db4d46bb63f | 529 | * returned by Gap::getMaxAdvertisingInterval() from the BLE API. When a |
mbed_official | 1:9db4d46bb63f | 530 | * frame needs to be advertised, the enqueueFrame() callbacks add the frame |
mbed_official | 1:9db4d46bb63f | 531 | * type to the advFrameQueue and post a manageRadio() callback. When the |
mbed_official | 1:9db4d46bb63f | 532 | * callback is executed, the frame is dequeued and advertised using the |
mbed_official | 1:9db4d46bb63f | 533 | * radio (by updating the advertising payload). manageRadio() also posts a |
mbed_official | 1:9db4d46bb63f | 534 | * callback to itself Gap::getMinNonConnectableAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 535 | * milliseconds later. In this callback, manageRadio() will advertise the |
mbed_official | 1:9db4d46bb63f | 536 | * next frame in the queue, yet if there is none it calls |
mbed_official | 1:9db4d46bb63f | 537 | * Gap::stopAdvertising() and does not post any further callbacks. |
mbed_official | 1:9db4d46bb63f | 538 | */ |
mbed_official | 1:9db4d46bb63f | 539 | void manageRadio(void); |
mbed_official | 1:9db4d46bb63f | 540 | |
mbed_official | 1:9db4d46bb63f | 541 | /** |
mbed_official | 1:9db4d46bb63f | 542 | * Regular callbacks posted at the rate of urlFramePeriod, uidFramePeriod |
mbed_official | 1:9db4d46bb63f | 543 | * and tlmFramePeriod milliseconds enqueue frames to be advertised. If the |
mbed_official | 1:9db4d46bb63f | 544 | * frame queue is currently empty, then this function directly calls |
mbed_official | 1:9db4d46bb63f | 545 | * manageRadio() to broadcast the required FrameType. |
mbed_official | 1:9db4d46bb63f | 546 | * |
mbed_official | 1:9db4d46bb63f | 547 | * @param[in] frameType |
mbed_official | 1:9db4d46bb63f | 548 | * The FrameType to enqueue for broadcasting. |
mbed_official | 1:9db4d46bb63f | 549 | */ |
mbed_official | 1:9db4d46bb63f | 550 | void enqueueFrame(FrameType frameType); |
mbed_official | 1:9db4d46bb63f | 551 | |
mbed_official | 1:9db4d46bb63f | 552 | /** |
mbed_official | 1:9db4d46bb63f | 553 | * Helper function that updates the advertising payload when in |
mbed_official | 1:9db4d46bb63f | 554 | * EDDYSTONE_MODE_BEACON to contain a new frame. |
mbed_official | 1:9db4d46bb63f | 555 | * |
mbed_official | 1:9db4d46bb63f | 556 | * @param[in] rawFrame |
mbed_official | 1:9db4d46bb63f | 557 | * The raw bytes of the frame to advertise. |
mbed_official | 1:9db4d46bb63f | 558 | * @param[in] rawFrameLength |
mbed_official | 1:9db4d46bb63f | 559 | * The length in bytes of the array pointed to by @p rawFrame. |
mbed_official | 1:9db4d46bb63f | 560 | */ |
mbed_official | 1:9db4d46bb63f | 561 | void updateAdvertisementPacket(const uint8_t* rawFrame, size_t rawFrameLength); |
mbed_official | 1:9db4d46bb63f | 562 | |
mbed_official | 1:9db4d46bb63f | 563 | /** |
mbed_official | 1:9db4d46bb63f | 564 | * Helper function that updates the information in the Eddystone-TLM frames |
mbed_official | 1:9db4d46bb63f | 565 | * Internally, this function executes the registered callbacks to update |
mbed_official | 1:9db4d46bb63f | 566 | * beacon Battery Voltage and Temperature (if available). Furthermore, this |
mbed_official | 1:9db4d46bb63f | 567 | * function updates the raw frame data. This operation must be done fairly |
mbed_official | 1:9db4d46bb63f | 568 | * often because the Eddystone-TLM frame Time Since Boot must have a 0.1 |
mbed_official | 1:9db4d46bb63f | 569 | * seconds resolution according to the Eddystone specification. |
mbed_official | 1:9db4d46bb63f | 570 | */ |
mbed_official | 1:9db4d46bb63f | 571 | void updateRawTLMFrame(void); |
mbed_official | 1:9db4d46bb63f | 572 | |
mbed_official | 1:9db4d46bb63f | 573 | /** |
mbed_official | 1:9db4d46bb63f | 574 | * Initialize the resources required when switching to |
mbed_official | 1:9db4d46bb63f | 575 | * EDDYSTONE_MODE_BEACON. |
mbed_official | 1:9db4d46bb63f | 576 | */ |
mbed_official | 1:9db4d46bb63f | 577 | void setupBeaconService(void); |
mbed_official | 1:9db4d46bb63f | 578 | |
mbed_official | 1:9db4d46bb63f | 579 | /** |
mbed_official | 1:9db4d46bb63f | 580 | * Initialize the resources required when switching to |
mbed_official | 1:9db4d46bb63f | 581 | * EDDYSTONE_MODE_CONFIG. This includes the GATT services and |
mbed_official | 1:9db4d46bb63f | 582 | * characteristics required by the Eddystone-URL Configuration Service. |
mbed_official | 1:9db4d46bb63f | 583 | */ |
mbed_official | 1:9db4d46bb63f | 584 | void setupConfigService(void); |
mbed_official | 1:9db4d46bb63f | 585 | |
mbed_official | 1:9db4d46bb63f | 586 | /** |
mbed_official | 1:9db4d46bb63f | 587 | * Free the resources acquired by a call to setupConfigService(). |
mbed_official | 1:9db4d46bb63f | 588 | */ |
mbed_official | 1:9db4d46bb63f | 589 | void freeConfigCharacteristics(void); |
mbed_official | 1:9db4d46bb63f | 590 | |
mbed_official | 1:9db4d46bb63f | 591 | /** |
mbed_official | 1:9db4d46bb63f | 592 | * Free the resources acquired by a call to setupBeaconService() and |
mbed_official | 1:9db4d46bb63f | 593 | * cancel all pending callbacks that operate the radio and frame queue. |
mbed_official | 1:9db4d46bb63f | 594 | * |
mbed_official | 1:9db4d46bb63f | 595 | * @note This call will not modify the current state of the BLE device. |
mbed_official | 1:9db4d46bb63f | 596 | * EddystoneService::stopBeaconService should only be called after |
mbed_official | 1:9db4d46bb63f | 597 | * a call to BLE::shutdown(). |
mbed_official | 1:9db4d46bb63f | 598 | */ |
mbed_official | 1:9db4d46bb63f | 599 | void stopBeaconService(void); |
mbed_official | 1:9db4d46bb63f | 600 | |
mbed_official | 1:9db4d46bb63f | 601 | /** |
mbed_official | 1:9db4d46bb63f | 602 | * Helper function used to update the GATT database following any |
mbed_official | 1:9db4d46bb63f | 603 | * change to the internal state of the service object. |
mbed_official | 1:9db4d46bb63f | 604 | */ |
mbed_official | 1:9db4d46bb63f | 605 | void updateCharacteristicValues(void); |
mbed_official | 1:9db4d46bb63f | 606 | |
mbed_official | 1:9db4d46bb63f | 607 | /** |
mbed_official | 1:9db4d46bb63f | 608 | * Setup the payload of advertising packets for Eddystone-URL Configuration |
mbed_official | 1:9db4d46bb63f | 609 | * Service. |
mbed_official | 1:9db4d46bb63f | 610 | */ |
mbed_official | 1:9db4d46bb63f | 611 | void setupEddystoneConfigAdvertisements(void); |
mbed_official | 1:9db4d46bb63f | 612 | |
mbed_official | 1:9db4d46bb63f | 613 | /** |
mbed_official | 1:9db4d46bb63f | 614 | * Helper function to setup the payload of scan response packets for |
mbed_official | 1:9db4d46bb63f | 615 | * Eddystone-URL Configuration Service. |
mbed_official | 1:9db4d46bb63f | 616 | */ |
mbed_official | 1:9db4d46bb63f | 617 | void setupEddystoneConfigScanResponse(void); |
mbed_official | 1:9db4d46bb63f | 618 | |
mbed_official | 1:9db4d46bb63f | 619 | /** |
mbed_official | 1:9db4d46bb63f | 620 | * Callback registered to the BLE API to authorize write operations to the |
mbed_official | 1:9db4d46bb63f | 621 | * Eddystone-URL Configuration Service Lock characteristic. |
mbed_official | 1:9db4d46bb63f | 622 | * |
mbed_official | 1:9db4d46bb63f | 623 | * @param[in] authParams |
mbed_official | 1:9db4d46bb63f | 624 | * Write authentication information. |
mbed_official | 1:9db4d46bb63f | 625 | */ |
mbed_official | 1:9db4d46bb63f | 626 | void lockAuthorizationCallback(GattWriteAuthCallbackParams *authParams); |
mbed_official | 1:9db4d46bb63f | 627 | |
mbed_official | 1:9db4d46bb63f | 628 | /** |
mbed_official | 1:9db4d46bb63f | 629 | * Callback registered to the BLE API to authorize write operations to the |
mbed_official | 1:9db4d46bb63f | 630 | * Eddystone-URL Configuration Service Unlock characteristic. |
mbed_official | 1:9db4d46bb63f | 631 | * |
mbed_official | 1:9db4d46bb63f | 632 | * @param[in] authParams |
mbed_official | 1:9db4d46bb63f | 633 | * Write authentication information. |
mbed_official | 1:9db4d46bb63f | 634 | */ |
mbed_official | 1:9db4d46bb63f | 635 | void unlockAuthorizationCallback(GattWriteAuthCallbackParams *authParams); |
mbed_official | 1:9db4d46bb63f | 636 | |
mbed_official | 1:9db4d46bb63f | 637 | /** |
mbed_official | 1:9db4d46bb63f | 638 | * Callback registered to the BLE API to authorize write operations to the |
mbed_official | 1:9db4d46bb63f | 639 | * Eddystone-URL Configuration Service URI Data characteristic. |
mbed_official | 1:9db4d46bb63f | 640 | * |
mbed_official | 1:9db4d46bb63f | 641 | * @param[in] authParams |
mbed_official | 1:9db4d46bb63f | 642 | * Write authentication information. |
mbed_official | 1:9db4d46bb63f | 643 | */ |
mbed_official | 1:9db4d46bb63f | 644 | void urlDataWriteAuthorizationCallback(GattWriteAuthCallbackParams *authParams); |
mbed_official | 1:9db4d46bb63f | 645 | |
mbed_official | 1:9db4d46bb63f | 646 | void powerModeAuthorizationCallback(GattWriteAuthCallbackParams *authParams); |
mbed_official | 1:9db4d46bb63f | 647 | |
mbed_official | 1:9db4d46bb63f | 648 | /** |
mbed_official | 1:9db4d46bb63f | 649 | * Callback registered to the BLE API to authorize write operations to the |
mbed_official | 1:9db4d46bb63f | 650 | * following Eddystone-URL Configuration Service characteristics: |
mbed_official | 1:9db4d46bb63f | 651 | * - Flags |
mbed_official | 1:9db4d46bb63f | 652 | * - Beacon Period |
mbed_official | 1:9db4d46bb63f | 653 | * - Reset |
mbed_official | 1:9db4d46bb63f | 654 | * |
mbed_official | 1:9db4d46bb63f | 655 | * @param[in] authParams |
mbed_official | 1:9db4d46bb63f | 656 | * Write authentication information. |
mbed_official | 1:9db4d46bb63f | 657 | */ |
mbed_official | 1:9db4d46bb63f | 658 | template <typename T> |
mbed_official | 1:9db4d46bb63f | 659 | void basicAuthorizationCallback(GattWriteAuthCallbackParams *authParams); |
mbed_official | 1:9db4d46bb63f | 660 | |
mbed_official | 1:9db4d46bb63f | 661 | /** |
mbed_official | 1:9db4d46bb63f | 662 | * This callback is invoked when a GATT client attempts to modify any of the |
mbed_official | 1:9db4d46bb63f | 663 | * characteristics of this service. Attempts to do so are also applied to |
mbed_official | 1:9db4d46bb63f | 664 | * the internal state of this service object. |
mbed_official | 1:9db4d46bb63f | 665 | * |
mbed_official | 1:9db4d46bb63f | 666 | * @param[in] writeParams |
mbed_official | 1:9db4d46bb63f | 667 | * Information about the values that are being written. |
mbed_official | 1:9db4d46bb63f | 668 | */ |
mbed_official | 1:9db4d46bb63f | 669 | void onDataWrittenCallback(const GattWriteCallbackParams *writeParams); |
mbed_official | 1:9db4d46bb63f | 670 | |
mbed_official | 1:9db4d46bb63f | 671 | /** |
mbed_official | 1:9db4d46bb63f | 672 | * Correct the advertising interval for non-connectable packets. |
mbed_official | 1:9db4d46bb63f | 673 | * |
mbed_official | 1:9db4d46bb63f | 674 | * @param[in] beaconPeriodIn |
mbed_official | 1:9db4d46bb63f | 675 | * The input interval in milliseconds. |
mbed_official | 1:9db4d46bb63f | 676 | * |
mbed_official | 1:9db4d46bb63f | 677 | * @return The corrected interval in milliseconds. |
mbed_official | 1:9db4d46bb63f | 678 | * |
mbed_official | 1:9db4d46bb63f | 679 | * @note For the acceptable range of advertising interval refer to the |
mbed_official | 1:9db4d46bb63f | 680 | * following functions in mbed BLE API: |
mbed_official | 1:9db4d46bb63f | 681 | * - Gap::getMinNonConnectableAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 682 | * - Gap::getMaxAdvertisingInterval() |
mbed_official | 1:9db4d46bb63f | 683 | */ |
mbed_official | 1:9db4d46bb63f | 684 | uint16_t correctAdvertisementPeriod(uint16_t beaconPeriodIn) const; |
mbed_official | 1:9db4d46bb63f | 685 | |
mbed_official | 1:9db4d46bb63f | 686 | /** |
mbed_official | 1:9db4d46bb63f | 687 | * BLE instance that EddystoneService will operate on. |
mbed_official | 1:9db4d46bb63f | 688 | */ |
mbed_official | 1:9db4d46bb63f | 689 | BLE &ble; |
mbed_official | 1:9db4d46bb63f | 690 | /** |
mbed_official | 1:9db4d46bb63f | 691 | * The advertising interval for Eddystone-URL Config Service advertising |
mbed_official | 1:9db4d46bb63f | 692 | * packets. |
mbed_official | 1:9db4d46bb63f | 693 | */ |
mbed_official | 1:9db4d46bb63f | 694 | uint32_t advConfigInterval; |
mbed_official | 1:9db4d46bb63f | 695 | /** |
mbed_official | 1:9db4d46bb63f | 696 | * Current EddystoneServce operation mode. |
mbed_official | 1:9db4d46bb63f | 697 | */ |
mbed_official | 1:9db4d46bb63f | 698 | uint8_t operationMode; |
mbed_official | 1:9db4d46bb63f | 699 | |
mbed_official | 1:9db4d46bb63f | 700 | /** |
mbed_official | 1:9db4d46bb63f | 701 | * Encapsulation of a URL frame. |
mbed_official | 1:9db4d46bb63f | 702 | */ |
mbed_official | 1:9db4d46bb63f | 703 | URLFrame urlFrame; |
mbed_official | 1:9db4d46bb63f | 704 | /** |
mbed_official | 1:9db4d46bb63f | 705 | * Encapsulation of a UID frame. |
mbed_official | 1:9db4d46bb63f | 706 | */ |
mbed_official | 1:9db4d46bb63f | 707 | UIDFrame uidFrame; |
mbed_official | 1:9db4d46bb63f | 708 | /** |
mbed_official | 1:9db4d46bb63f | 709 | * Encapsulation of a TLM frame. |
mbed_official | 1:9db4d46bb63f | 710 | */ |
mbed_official | 1:9db4d46bb63f | 711 | TLMFrame tlmFrame; |
mbed_official | 1:9db4d46bb63f | 712 | |
mbed_official | 1:9db4d46bb63f | 713 | /** |
mbed_official | 1:9db4d46bb63f | 714 | * The value set internally into the radion tx power. |
mbed_official | 1:9db4d46bb63f | 715 | */ |
mbed_official | 1:9db4d46bb63f | 716 | PowerLevels_t radioPowerLevels; |
mbed_official | 1:9db4d46bb63f | 717 | /** |
mbed_official | 1:9db4d46bb63f | 718 | * An array containing possible values for advertised tx power in Eddystone |
mbed_official | 1:9db4d46bb63f | 719 | * frames. Also, the value of the Eddystone-URL Configuration Service |
mbed_official | 1:9db4d46bb63f | 720 | * Advertised TX Power Levels characteristic. |
mbed_official | 1:9db4d46bb63f | 721 | */ |
mbed_official | 1:9db4d46bb63f | 722 | PowerLevels_t advPowerLevels; |
mbed_official | 1:9db4d46bb63f | 723 | /** |
mbed_official | 1:9db4d46bb63f | 724 | * The value of the Eddystone-URL Configuration Service Lock State |
mbed_official | 1:9db4d46bb63f | 725 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 726 | */ |
mbed_official | 1:9db4d46bb63f | 727 | bool lockState; |
mbed_official | 1:9db4d46bb63f | 728 | /** |
mbed_official | 1:9db4d46bb63f | 729 | * The value of the Eddystone-URL Configuration Service reset |
mbed_official | 1:9db4d46bb63f | 730 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 731 | */ |
mbed_official | 1:9db4d46bb63f | 732 | bool resetFlag; |
mbed_official | 1:9db4d46bb63f | 733 | /** |
mbed_official | 1:9db4d46bb63f | 734 | * The value of the Eddystone-URL Configuration Service Lock |
mbed_official | 1:9db4d46bb63f | 735 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 736 | */ |
mbed_official | 1:9db4d46bb63f | 737 | Lock_t lock; |
mbed_official | 1:9db4d46bb63f | 738 | /** |
mbed_official | 1:9db4d46bb63f | 739 | * The value of the Eddystone-URL Configuration Service Unlock |
mbed_official | 1:9db4d46bb63f | 740 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 741 | */ |
mbed_official | 1:9db4d46bb63f | 742 | Lock_t unlock; |
mbed_official | 1:9db4d46bb63f | 743 | /** |
mbed_official | 1:9db4d46bb63f | 744 | * The value of the Eddystone-URL Configuration Service Flags |
mbed_official | 1:9db4d46bb63f | 745 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 746 | */ |
mbed_official | 1:9db4d46bb63f | 747 | uint8_t flags; |
mbed_official | 1:9db4d46bb63f | 748 | /** |
mbed_official | 1:9db4d46bb63f | 749 | * The value of the Eddystone-URL Configuration Service TX Power Mode |
mbed_official | 1:9db4d46bb63f | 750 | * characteristic. |
mbed_official | 1:9db4d46bb63f | 751 | */ |
mbed_official | 1:9db4d46bb63f | 752 | uint8_t txPowerMode; |
mbed_official | 1:9db4d46bb63f | 753 | /** |
mbed_official | 1:9db4d46bb63f | 754 | * The value of the Eddystone-URL Configuration Service Beacon Period |
mbed_official | 1:9db4d46bb63f | 755 | * characteristic. Also, the advertising interval (in milliseconds) of |
mbed_official | 1:9db4d46bb63f | 756 | * Eddystone-URL frames. |
mbed_official | 1:9db4d46bb63f | 757 | */ |
mbed_official | 1:9db4d46bb63f | 758 | uint16_t urlFramePeriod; |
mbed_official | 1:9db4d46bb63f | 759 | /** |
mbed_official | 1:9db4d46bb63f | 760 | * The advertising interval (in milliseconds) of Eddystone-UID frames. |
mbed_official | 1:9db4d46bb63f | 761 | */ |
mbed_official | 1:9db4d46bb63f | 762 | uint16_t uidFramePeriod; |
mbed_official | 1:9db4d46bb63f | 763 | /** |
mbed_official | 1:9db4d46bb63f | 764 | * The advertising interval (in milliseconds) of Eddystone-TLM frames. |
mbed_official | 1:9db4d46bb63f | 765 | */ |
mbed_official | 1:9db4d46bb63f | 766 | uint16_t tlmFramePeriod; |
mbed_official | 1:9db4d46bb63f | 767 | |
mbed_official | 1:9db4d46bb63f | 768 | /** |
mbed_official | 1:9db4d46bb63f | 769 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 770 | * Configuration Service Lock State characteristic. |
mbed_official | 1:9db4d46bb63f | 771 | */ |
mbed_official | 1:9db4d46bb63f | 772 | ReadOnlyGattCharacteristic<bool> *lockStateChar; |
mbed_official | 1:9db4d46bb63f | 773 | /** |
mbed_official | 1:9db4d46bb63f | 774 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 775 | * Configuration Service Lock characteristic. |
mbed_official | 1:9db4d46bb63f | 776 | */ |
mbed_official | 1:9db4d46bb63f | 777 | WriteOnlyArrayGattCharacteristic<uint8_t, sizeof(Lock_t)> *lockChar; |
mbed_official | 1:9db4d46bb63f | 778 | /** |
mbed_official | 1:9db4d46bb63f | 779 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 780 | * Configuration Service Unlock characteristic. |
mbed_official | 1:9db4d46bb63f | 781 | */ |
mbed_official | 1:9db4d46bb63f | 782 | WriteOnlyArrayGattCharacteristic<uint8_t, sizeof(Lock_t)> *unlockChar; |
mbed_official | 1:9db4d46bb63f | 783 | /** |
mbed_official | 1:9db4d46bb63f | 784 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 785 | * Configuration Service URI Data characteristic. |
mbed_official | 1:9db4d46bb63f | 786 | */ |
mbed_official | 1:9db4d46bb63f | 787 | GattCharacteristic *urlDataChar; |
mbed_official | 1:9db4d46bb63f | 788 | /** |
mbed_official | 1:9db4d46bb63f | 789 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 790 | * Configuration Service Flags characteristic. |
mbed_official | 1:9db4d46bb63f | 791 | */ |
mbed_official | 1:9db4d46bb63f | 792 | ReadWriteGattCharacteristic<uint8_t> *flagsChar; |
mbed_official | 1:9db4d46bb63f | 793 | /** |
mbed_official | 1:9db4d46bb63f | 794 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 795 | * Configuration Service Advertised TX Power Levels characteristic. |
mbed_official | 1:9db4d46bb63f | 796 | */ |
mbed_official | 1:9db4d46bb63f | 797 | ReadWriteArrayGattCharacteristic<int8_t, sizeof(PowerLevels_t)> *advPowerLevelsChar; |
mbed_official | 1:9db4d46bb63f | 798 | /** |
mbed_official | 1:9db4d46bb63f | 799 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 800 | * Configuration Service TX Power Mode characteristic. |
mbed_official | 1:9db4d46bb63f | 801 | */ |
mbed_official | 1:9db4d46bb63f | 802 | ReadWriteGattCharacteristic<uint8_t> *txPowerModeChar; |
mbed_official | 1:9db4d46bb63f | 803 | /** |
mbed_official | 1:9db4d46bb63f | 804 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 805 | * Configuration Service Beacon Period characteristic. |
mbed_official | 1:9db4d46bb63f | 806 | */ |
mbed_official | 1:9db4d46bb63f | 807 | ReadWriteGattCharacteristic<uint16_t> *beaconPeriodChar; |
mbed_official | 1:9db4d46bb63f | 808 | /** |
mbed_official | 1:9db4d46bb63f | 809 | * Pointer to the BLE API characteristic encapsulation for the Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 810 | * Configuration Service Reset characteristic. |
mbed_official | 1:9db4d46bb63f | 811 | */ |
mbed_official | 1:9db4d46bb63f | 812 | WriteOnlyGattCharacteristic<bool> *resetChar; |
mbed_official | 1:9db4d46bb63f | 813 | |
mbed_official | 1:9db4d46bb63f | 814 | /** |
mbed_official | 1:9db4d46bb63f | 815 | * Pointer to the raw bytes that will be used to populate Eddystone-URL |
mbed_official | 1:9db4d46bb63f | 816 | * frames. |
mbed_official | 1:9db4d46bb63f | 817 | */ |
mbed_official | 1:9db4d46bb63f | 818 | uint8_t *rawUrlFrame; |
mbed_official | 1:9db4d46bb63f | 819 | /** |
mbed_official | 1:9db4d46bb63f | 820 | * Pointer to the raw bytes that will be used to populate Eddystone-UID |
mbed_official | 1:9db4d46bb63f | 821 | * frames. |
mbed_official | 1:9db4d46bb63f | 822 | */ |
mbed_official | 1:9db4d46bb63f | 823 | uint8_t *rawUidFrame; |
mbed_official | 1:9db4d46bb63f | 824 | /** |
mbed_official | 1:9db4d46bb63f | 825 | * Pointer to the raw bytes that will be used to populate Eddystone-TLM |
mbed_official | 1:9db4d46bb63f | 826 | * frames. |
mbed_official | 1:9db4d46bb63f | 827 | */ |
mbed_official | 1:9db4d46bb63f | 828 | uint8_t *rawTlmFrame; |
mbed_official | 1:9db4d46bb63f | 829 | |
mbed_official | 1:9db4d46bb63f | 830 | /** |
mbed_official | 1:9db4d46bb63f | 831 | * Circular buffer that represents of Eddystone frames to be advertised. |
mbed_official | 1:9db4d46bb63f | 832 | */ |
mbed_official | 1:9db4d46bb63f | 833 | CircularBuffer<FrameType, ADV_FRAME_QUEUE_SIZE> advFrameQueue; |
mbed_official | 1:9db4d46bb63f | 834 | |
mbed_official | 1:9db4d46bb63f | 835 | /** |
mbed_official | 1:9db4d46bb63f | 836 | * The registered callback to update the Eddystone-TLM frame Battery |
mbed_official | 1:9db4d46bb63f | 837 | * Voltage. |
mbed_official | 1:9db4d46bb63f | 838 | */ |
mbed_official | 1:9db4d46bb63f | 839 | TlmUpdateCallback_t tlmBatteryVoltageCallback; |
mbed_official | 1:9db4d46bb63f | 840 | /** |
mbed_official | 1:9db4d46bb63f | 841 | * The registered callback to update the Eddystone-TLM frame Beacon |
mbed_official | 1:9db4d46bb63f | 842 | * Temperature. |
mbed_official | 1:9db4d46bb63f | 843 | */ |
mbed_official | 1:9db4d46bb63f | 844 | TlmUpdateCallback_t tlmBeaconTemperatureCallback; |
mbed_official | 1:9db4d46bb63f | 845 | |
mbed_official | 1:9db4d46bb63f | 846 | /** |
mbed_official | 1:9db4d46bb63f | 847 | * Timer that keeps track of the time since boot. |
mbed_official | 1:9db4d46bb63f | 848 | */ |
mbed_official | 1:9db4d46bb63f | 849 | Timer timeSinceBootTimer; |
mbed_official | 1:9db4d46bb63f | 850 | |
mbed_official | 1:9db4d46bb63f | 851 | /** |
mbed_official | 1:9db4d46bb63f | 852 | * Callback handle to keep track of periodic |
mbed_official | 1:9db4d46bb63f | 853 | * enqueueFrame(EDDYSTONE_FRAME_UID) callbacks that populate the |
mbed_official | 1:9db4d46bb63f | 854 | * advFrameQueue. |
mbed_official | 1:9db4d46bb63f | 855 | */ |
mbed_official | 1:9db4d46bb63f | 856 | int uidFrameCallbackHandle; |
mbed_official | 1:9db4d46bb63f | 857 | /** |
mbed_official | 1:9db4d46bb63f | 858 | * Minar callback handle to keep track of periodic |
mbed_official | 1:9db4d46bb63f | 859 | * enqueueFrame(EDDYSTONE_FRAME_URL) callbacks that populate the |
mbed_official | 1:9db4d46bb63f | 860 | * advFrameQueue. |
mbed_official | 1:9db4d46bb63f | 861 | */ |
mbed_official | 1:9db4d46bb63f | 862 | int urlFrameCallbackHandle; |
mbed_official | 1:9db4d46bb63f | 863 | /** |
mbed_official | 1:9db4d46bb63f | 864 | * Minar callback handle to keep track of periodic |
mbed_official | 1:9db4d46bb63f | 865 | * enqueueFrame(EDDYSTONE_FRAME_TLM) callbacks that populate the |
mbed_official | 1:9db4d46bb63f | 866 | * advFrameQueue. |
mbed_official | 1:9db4d46bb63f | 867 | */ |
mbed_official | 1:9db4d46bb63f | 868 | int tlmFrameCallbackHandle; |
mbed_official | 1:9db4d46bb63f | 869 | /** |
mbed_official | 1:9db4d46bb63f | 870 | * Minar callback handle to keep track of manageRadio() callbacks. |
mbed_official | 1:9db4d46bb63f | 871 | */ |
mbed_official | 1:9db4d46bb63f | 872 | int radioManagerCallbackHandle; |
mbed_official | 1:9db4d46bb63f | 873 | |
mbed_official | 1:9db4d46bb63f | 874 | /** |
mbed_official | 1:9db4d46bb63f | 875 | * GattCharacteristic table used to populate the BLE ATT table in the |
mbed_official | 1:9db4d46bb63f | 876 | * GATT Server. |
mbed_official | 1:9db4d46bb63f | 877 | */ |
mbed_official | 1:9db4d46bb63f | 878 | GattCharacteristic *charTable[TOTAL_CHARACTERISTICS]; |
mbed_official | 1:9db4d46bb63f | 879 | |
mbed_official | 1:9db4d46bb63f | 880 | /** |
mbed_official | 1:9db4d46bb63f | 881 | * Pointer to the device name currently being used. |
mbed_official | 1:9db4d46bb63f | 882 | */ |
mbed_official | 1:9db4d46bb63f | 883 | const char *deviceName; |
mbed_official | 1:9db4d46bb63f | 884 | |
mbed_official | 1:9db4d46bb63f | 885 | /** |
mbed_official | 1:9db4d46bb63f | 886 | * Event queue used to post callbacks s |
mbed_official | 1:9db4d46bb63f | 887 | */ |
mbed_official | 1:9db4d46bb63f | 888 | EventQueue& eventQueue; |
mbed_official | 1:9db4d46bb63f | 889 | }; |
mbed_official | 1:9db4d46bb63f | 890 | |
mbed_official | 1:9db4d46bb63f | 891 | #endif /* __EDDYSTONESERVICE_H__ */ |