abc

Fork of BLE_API by Bluetooth Low Energy

Committer:
rgrover1
Date:
Wed May 13 08:51:09 2015 +0100
Revision:
395:4124520c17fc
Parent:
394:598368c24bbb
Child:
396:039ee79c9924
Synchronized with git rev 68036cd4
Author: Rohit Grover
white space diffs.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 257:7a50601356cc 1 /* mbed Microcontroller Library
rgrover1 257:7a50601356cc 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 257:7a50601356cc 3 *
rgrover1 257:7a50601356cc 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 257:7a50601356cc 5 * you may not use this file except in compliance with the License.
rgrover1 257:7a50601356cc 6 * You may obtain a copy of the License at
rgrover1 257:7a50601356cc 7 *
rgrover1 257:7a50601356cc 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 257:7a50601356cc 9 *
rgrover1 257:7a50601356cc 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 257:7a50601356cc 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 257:7a50601356cc 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 257:7a50601356cc 13 * See the License for the specific language governing permissions and
rgrover1 257:7a50601356cc 14 * limitations under the License.
rgrover1 257:7a50601356cc 15 */
rgrover1 257:7a50601356cc 16
rgrover1 257:7a50601356cc 17 #ifndef __BLE_DEVICE__
rgrover1 257:7a50601356cc 18 #define __BLE_DEVICE__
rgrover1 257:7a50601356cc 19
rgrover1 257:7a50601356cc 20 #include "blecommon.h"
rgrover1 257:7a50601356cc 21 #include "Gap.h"
rgrover1 257:7a50601356cc 22 #include "GattServer.h"
rgrover1 380:2109a08c311c 23 #include "GapScanningParams.h"
rgrover1 257:7a50601356cc 24 #include "BLEDeviceInstanceBase.h"
rgrover1 257:7a50601356cc 25
rgrover1 257:7a50601356cc 26 /**
rgrover1 257:7a50601356cc 27 * The base class used to abstract away BLE capable radio transceivers or SOCs,
rgrover1 257:7a50601356cc 28 * to enable this BLE API to work with any radio transparently.
rgrover1 257:7a50601356cc 29 */
rgrover1 257:7a50601356cc 30 class BLEDevice
rgrover1 257:7a50601356cc 31 {
rgrover1 257:7a50601356cc 32 public:
rgrover1 257:7a50601356cc 33 /**
rgrover1 257:7a50601356cc 34 * Initialize the BLE controller. This should be called before using
rgrover1 257:7a50601356cc 35 * anything else in the BLE_API.
rgrover1 257:7a50601356cc 36 */
rgrover1 257:7a50601356cc 37 ble_error_t init();
rgrover1 257:7a50601356cc 38 ble_error_t reset(void);
rgrover1 257:7a50601356cc 39
rgrover1 257:7a50601356cc 40 /**
rgrover1 257:7a50601356cc 41 * Purge the BLE stack of GATT and GAP state. init() must be called afterwards to re-instate services and GAP state.
rgrover1 257:7a50601356cc 42 */
rgrover1 257:7a50601356cc 43 ble_error_t shutdown(void);
rgrover1 257:7a50601356cc 44
rgrover1 257:7a50601356cc 45 /* GAP specific APIs */
rgrover1 257:7a50601356cc 46 public:
rgrover1 257:7a50601356cc 47 /**
rgrover1 257:7a50601356cc 48 * Set the BTLE MAC address and type.
rgrover1 257:7a50601356cc 49 * @return BLE_ERROR_NONE on success.
rgrover1 257:7a50601356cc 50 */
rgrover1 257:7a50601356cc 51 ble_error_t setAddress(Gap::addr_type_t type, const Gap::address_t address);
rgrover1 257:7a50601356cc 52
rgrover1 257:7a50601356cc 53 /**
rgrover1 257:7a50601356cc 54 * Fetch the BTLE MAC address and type.
rgrover1 257:7a50601356cc 55 * @return BLE_ERROR_NONE on success.
rgrover1 257:7a50601356cc 56 */
rgrover1 257:7a50601356cc 57 ble_error_t getAddress(Gap::addr_type_t *typeP, Gap::address_t address);
rgrover1 257:7a50601356cc 58
rgrover1 257:7a50601356cc 59 /**
rgrover1 257:7a50601356cc 60 * @param[in] advType
rgrover1 257:7a50601356cc 61 * The GAP advertising mode to use for this device. Valid
rgrover1 257:7a50601356cc 62 * values are defined in AdvertisingType:
rgrover1 257:7a50601356cc 63 *
rgrover1 257:7a50601356cc 64 * \par ADV_NON_CONNECTABLE_UNDIRECTED
rgrover1 257:7a50601356cc 65 * All connections to the peripheral device will be refused.
rgrover1 257:7a50601356cc 66 *
rgrover1 257:7a50601356cc 67 * \par ADV_CONNECTABLE_DIRECTED
rgrover1 257:7a50601356cc 68 * Only connections from a pre-defined central device will be
rgrover1 257:7a50601356cc 69 * accepted.
rgrover1 257:7a50601356cc 70 *
rgrover1 257:7a50601356cc 71 * \par ADV_CONNECTABLE_UNDIRECTED
rgrover1 257:7a50601356cc 72 * Any central device can connect to this peripheral.
rgrover1 257:7a50601356cc 73 *
rgrover1 257:7a50601356cc 74 * \par ADV_SCANNABLE_UNDIRECTED
rgrover1 300:d9a39f759a6a 75 * Include support for Scan Response payloads.
rgrover1 257:7a50601356cc 76 *
rgrover1 257:7a50601356cc 77 * \par
rgrover1 257:7a50601356cc 78 * See Bluetooth Core Specification 4.0 (Vol. 3), Part C,
rgrover1 257:7a50601356cc 79 * Section 9.3 and Core Specification 4.0 (Vol. 6), Part B,
rgrover1 257:7a50601356cc 80 * Section 2.3.1 for further information on GAP connection
rgrover1 257:7a50601356cc 81 * modes
rgrover1 257:7a50601356cc 82 */
rgrover1 257:7a50601356cc 83 void setAdvertisingType(GapAdvertisingParams::AdvertisingType);
rgrover1 257:7a50601356cc 84
rgrover1 257:7a50601356cc 85 /**
rgrover1 257:7a50601356cc 86 * @param[in] interval
rgrover1 325:501ad8b8bbe5 87 * Advertising interval in units of milliseconds. Advertising
rgrover1 325:501ad8b8bbe5 88 * is disabled if interval is 0. If interval is smaller than
rgrover1 325:501ad8b8bbe5 89 * the minimum supported value, then the minimum supported
rgrover1 325:501ad8b8bbe5 90 * value is used instead.
rgrover1 257:7a50601356cc 91 *
rgrover1 257:7a50601356cc 92 * \par
rgrover1 257:7a50601356cc 93 * Decreasing this value will allow central devices to detect
rgrover1 257:7a50601356cc 94 * your peripheral faster at the expense of more power being
rgrover1 257:7a50601356cc 95 * used by the radio due to the higher data transmit rate.
rgrover1 257:7a50601356cc 96 *
rgrover1 257:7a50601356cc 97 * \par
rgrover1 257:7a50601356cc 98 * This field must be set to 0 if connectionMode is equal
rgrover1 257:7a50601356cc 99 * to ADV_CONNECTABLE_DIRECTED
rgrover1 257:7a50601356cc 100 *
rgrover1 257:7a50601356cc 101 * \par
rgrover1 257:7a50601356cc 102 * See Bluetooth Core Specification, Vol 3., Part C,
rgrover1 257:7a50601356cc 103 * Appendix A for suggested advertising intervals.
rgrover1 334:6bc1223306b9 104 *
rgrover1 334:6bc1223306b9 105 * @Note: [WARNING] This API previously used 0.625ms as the unit for its
rgrover1 334:6bc1223306b9 106 * 'interval' argument. That required an explicit conversion from
rgrover1 334:6bc1223306b9 107 * milliseconds using Gap::MSEC_TO_GAP_DURATION_UNITS(). This conversion is
rgrover1 334:6bc1223306b9 108 * no longer required as the new units are milliseconds. Any application
rgrover1 334:6bc1223306b9 109 * code depending on the old semantics would need to be updated accordingly.
rgrover1 257:7a50601356cc 110 */
rgrover1 257:7a50601356cc 111 void setAdvertisingInterval(uint16_t interval);
rgrover1 257:7a50601356cc 112
rgrover1 257:7a50601356cc 113 /**
rgrover1 325:501ad8b8bbe5 114 * @return Minimum Advertising interval in milliseconds.
rgrover1 325:501ad8b8bbe5 115 */
rgrover1 325:501ad8b8bbe5 116 uint16_t getMinAdvertisingInterval(void) const;
rgrover1 325:501ad8b8bbe5 117 /**
rgrover1 325:501ad8b8bbe5 118 * @return Minimum Advertising interval in milliseconds for non connectible mode.
rgrover1 325:501ad8b8bbe5 119 */
rgrover1 325:501ad8b8bbe5 120 uint16_t getMinNonConnectableAdvertisingInterval(void) const;
rgrover1 325:501ad8b8bbe5 121 /**
rgrover1 325:501ad8b8bbe5 122 * @return Maximum Advertising interval in milliseconds.
rgrover1 325:501ad8b8bbe5 123 */
rgrover1 325:501ad8b8bbe5 124 uint16_t getMaxAdvertisingInterval(void) const;
rgrover1 325:501ad8b8bbe5 125
rgrover1 325:501ad8b8bbe5 126 /**
rgrover1 257:7a50601356cc 127 * @param[in] timeout
rgrover1 257:7a50601356cc 128 * Advertising timeout between 0x1 and 0x3FFF (1 and 16383)
rgrover1 257:7a50601356cc 129 * in seconds. Enter 0 to disable the advertising timeout.
rgrover1 257:7a50601356cc 130 */
rgrover1 257:7a50601356cc 131 void setAdvertisingTimeout(uint16_t timeout);
rgrover1 257:7a50601356cc 132
rgrover1 257:7a50601356cc 133 /**
rgrover1 257:7a50601356cc 134 * Please refer to the APIs above.
rgrover1 257:7a50601356cc 135 */
rgrover1 257:7a50601356cc 136 void setAdvertisingParams(const GapAdvertisingParams &advParams);
rgrover1 257:7a50601356cc 137
rgrover1 257:7a50601356cc 138 /**
rgrover1 257:7a50601356cc 139 * This API is typically used as an internal helper to udpate the transport
rgrover1 257:7a50601356cc 140 * backend with advertising data before starting to advertise. It may also
rgrover1 257:7a50601356cc 141 * be explicity used to dynamically reset the accumulated advertising
rgrover1 257:7a50601356cc 142 * payload and scanResponse; to do this, the application can clear and re-
rgrover1 257:7a50601356cc 143 * accumulate a new advertising payload (and scanResponse) before using this
rgrover1 257:7a50601356cc 144 * API.
rgrover1 257:7a50601356cc 145 */
rgrover1 257:7a50601356cc 146 ble_error_t setAdvertisingPayload(void);
rgrover1 257:7a50601356cc 147
rgrover1 257:7a50601356cc 148 /**
rgrover1 257:7a50601356cc 149 * Reset any advertising payload prepared from prior calls to
rgrover1 257:7a50601356cc 150 * accumulateAdvertisingPayload().
rgrover1 343:4d2576324b62 151 *
rgrover1 343:4d2576324b62 152 * Note: This should be followed by a call to setAdvertisingPayload() or
rgrover1 343:4d2576324b62 153 * startAdvertising() before the update takes effect.
rgrover1 257:7a50601356cc 154 */
rgrover1 257:7a50601356cc 155 void clearAdvertisingPayload(void);
rgrover1 257:7a50601356cc 156
rgrover1 257:7a50601356cc 157 /**
rgrover1 257:7a50601356cc 158 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 159 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 160 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 161 * small.
rgrover1 257:7a50601356cc 162 *
rgrover1 257:7a50601356cc 163 * @param flags
rgrover1 257:7a50601356cc 164 * The flags to be added. Multiple flags may be specified in
rgrover1 257:7a50601356cc 165 * combination.
rgrover1 257:7a50601356cc 166 */
rgrover1 257:7a50601356cc 167 ble_error_t accumulateAdvertisingPayload(uint8_t flags);
rgrover1 257:7a50601356cc 168
rgrover1 257:7a50601356cc 169 /**
rgrover1 257:7a50601356cc 170 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 171 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 172 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 173 * small.
rgrover1 257:7a50601356cc 174 *
rgrover1 257:7a50601356cc 175 * @param app
rgrover1 257:7a50601356cc 176 * The appearance of the peripheral.
rgrover1 257:7a50601356cc 177 */
rgrover1 257:7a50601356cc 178 ble_error_t accumulateAdvertisingPayload(GapAdvertisingData::Appearance app);
rgrover1 257:7a50601356cc 179
rgrover1 257:7a50601356cc 180 /**
rgrover1 257:7a50601356cc 181 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 182 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 183 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 184 * small.
rgrover1 257:7a50601356cc 185 *
rgrover1 257:7a50601356cc 186 * @param app
rgrover1 257:7a50601356cc 187 * The max transmit power to be used by the controller. This is
rgrover1 257:7a50601356cc 188 * only a hint.
rgrover1 257:7a50601356cc 189 */
rgrover1 257:7a50601356cc 190 ble_error_t accumulateAdvertisingPayloadTxPower(int8_t power);
rgrover1 257:7a50601356cc 191
rgrover1 257:7a50601356cc 192 /**
rgrover1 257:7a50601356cc 193 * Accumulate a variable length byte-stream as an AD structure in the
rgrover1 257:7a50601356cc 194 * advertising payload. Please note that the payload is limited to 31 bytes.
rgrover1 257:7a50601356cc 195 * The SCAN_RESPONSE message may be used as an additional 31 bytes if the
rgrover1 257:7a50601356cc 196 * advertising payload proves to be too small.
rgrover1 257:7a50601356cc 197 *
rgrover1 257:7a50601356cc 198 * @param type The type which describes the variable length data.
rgrover1 257:7a50601356cc 199 * @param data data bytes.
rgrover1 257:7a50601356cc 200 * @param len length of data.
rgrover1 257:7a50601356cc 201 */
rgrover1 257:7a50601356cc 202 ble_error_t accumulateAdvertisingPayload(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len);
rgrover1 257:7a50601356cc 203
rgrover1 257:7a50601356cc 204 /**
rgrover1 257:7a50601356cc 205 * Accumulate a variable length byte-stream as an AD structure in the
rgrover1 257:7a50601356cc 206 * scanResponse payload.
rgrover1 257:7a50601356cc 207 *
rgrover1 257:7a50601356cc 208 * @param type The type which describes the variable length data.
rgrover1 257:7a50601356cc 209 * @param data data bytes.
rgrover1 257:7a50601356cc 210 * @param len length of data.
rgrover1 257:7a50601356cc 211 */
rgrover1 257:7a50601356cc 212 ble_error_t accumulateScanResponse(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len);
rgrover1 257:7a50601356cc 213
rgrover1 257:7a50601356cc 214 /**
rgrover1 343:4d2576324b62 215 * Reset any scan response prepared from prior calls to
rgrover1 343:4d2576324b62 216 * accumulateScanResponse().
rgrover1 343:4d2576324b62 217 *
rgrover1 343:4d2576324b62 218 * Note: This should be followed by a call to setAdvertisingPayload() or
rgrover1 343:4d2576324b62 219 * startAdvertising() before the update takes effect.
rgrover1 343:4d2576324b62 220 */
rgrover1 343:4d2576324b62 221 void clearScanResponse(void);
rgrover1 343:4d2576324b62 222
rgrover1 343:4d2576324b62 223 /**
rgrover1 257:7a50601356cc 224 * Start advertising (GAP Discoverable, Connectable modes, Broadcast
rgrover1 257:7a50601356cc 225 * Procedure).
rgrover1 257:7a50601356cc 226 */
rgrover1 257:7a50601356cc 227 ble_error_t startAdvertising(void);
rgrover1 257:7a50601356cc 228
rgrover1 257:7a50601356cc 229 /**
rgrover1 257:7a50601356cc 230 * Stop advertising (GAP Discoverable, Connectable modes, Broadcast
rgrover1 257:7a50601356cc 231 * Procedure).
rgrover1 257:7a50601356cc 232 */
rgrover1 257:7a50601356cc 233 ble_error_t stopAdvertising(void);
rgrover1 257:7a50601356cc 234
rgrover1 335:dea9e14b7ddc 235 /**
rgrover1 380:2109a08c311c 236 * Setup parameters for GAP scanning--i.e. observer mode.
rgrover1 380:2109a08c311c 237 * @param interval Scan interval (in milliseconds) [valid values lie between 2.5ms and 10.24s].
rgrover1 380:2109a08c311c 238 * @param window Scan Window (in milliseconds) [valid values lie between 2.5ms and 10.24s].
rgrover1 380:2109a08c311c 239 * @param timeout Scan timeout (in seconds) between 0x0001 and 0xFFFF, 0x0000 disables timeout.
rgrover1 390:4bf41689c7f9 240 *
rgrover1 390:4bf41689c7f9 241 * The scanning window divided by the interval determines the duty cycle for
rgrover1 390:4bf41689c7f9 242 * scanning. For example, if the interval is 100ms and the window is 10ms,
rgrover1 390:4bf41689c7f9 243 * then the controller will scan for 10 percent of the time. It is possible
rgrover1 390:4bf41689c7f9 244 * to have the interval and window set to the same value. In this case,
rgrover1 390:4bf41689c7f9 245 * scanning is continuous, with a change of scanning frequency once every
rgrover1 390:4bf41689c7f9 246 * interval.
rgrover1 390:4bf41689c7f9 247 *
rgrover1 390:4bf41689c7f9 248 * Once the scanning parameters have been configured, scanning can be
rgrover1 390:4bf41689c7f9 249 * enabled by using startScan().
rgrover1 390:4bf41689c7f9 250 *
rgrover1 390:4bf41689c7f9 251 * @Note: The scan interval and window are recommendations to the BLE stack.
rgrover1 380:2109a08c311c 252 */
rgrover1 394:598368c24bbb 253 ble_error_t setScanParams(uint16_t interval = GapScanningParams::SCAN_INTERVAL_MAX,
rgrover1 394:598368c24bbb 254 uint16_t window = GapScanningParams::SCAN_WINDOW_MAX,
rgrover1 394:598368c24bbb 255 uint16_t timeout = 0,
rgrover1 394:598368c24bbb 256 bool activeScanning = false);
rgrover1 392:3201f029c2eb 257 ble_error_t setScanInterval(uint16_t interval);
rgrover1 392:3201f029c2eb 258 ble_error_t setScanWindow (uint16_t window);
rgrover1 392:3201f029c2eb 259 ble_error_t setScanTimeout (uint16_t timeout);
rgrover1 395:4124520c17fc 260 void setActiveScan (bool activeScanning);
rgrover1 380:2109a08c311c 261
rgrover1 380:2109a08c311c 262 /**
rgrover1 380:2109a08c311c 263 * Start scanning (Observer Procedure) based on the scan-params currently
rgrover1 380:2109a08c311c 264 * in effect.
rgrover1 380:2109a08c311c 265 *
rgrover1 380:2109a08c311c 266 * @param callback The application callback to be invoked upon receiving
rgrover1 380:2109a08c311c 267 * every advertisement report. Can be passed in as NULL, in which case
rgrover1 380:2109a08c311c 268 * scanning may not be enabled at all.
rgrover1 380:2109a08c311c 269 */
rgrover1 392:3201f029c2eb 270 ble_error_t startScan(Gap::AdvertisementReportCallback_t callback);
rgrover1 380:2109a08c311c 271
rgrover1 380:2109a08c311c 272 /**
rgrover1 380:2109a08c311c 273 * Stop scanning. The current scanning parameters remain in effect.
rgrover1 380:2109a08c311c 274 *
rgrover1 380:2109a08c311c 275 * @retval BLE_ERROR_NONE if successfully stopped scanning procedure.
rgrover1 380:2109a08c311c 276 */
rgrover1 392:3201f029c2eb 277 ble_error_t stopScan(void);
rgrover1 380:2109a08c311c 278
rgrover1 380:2109a08c311c 279 /**
rgrover1 335:dea9e14b7ddc 280 * This call initiates the disconnection procedure, and its completion will
rgrover1 335:dea9e14b7ddc 281 * be communicated to the application with an invocation of the
rgrover1 335:dea9e14b7ddc 282 * onDisconnection callback.
rgrover1 335:dea9e14b7ddc 283 *
rgrover1 335:dea9e14b7ddc 284 * @param reason
rgrover1 335:dea9e14b7ddc 285 * The reason for disconnection to be sent back to the peer.
rgrover1 335:dea9e14b7ddc 286 */
rgrover1 257:7a50601356cc 287 ble_error_t disconnect(Gap::DisconnectionReason_t reason);
rgrover1 257:7a50601356cc 288
rgrover1 257:7a50601356cc 289 /* APIs to set GAP callbacks. */
rgrover1 257:7a50601356cc 290 void onTimeout(Gap::EventCallback_t timeoutCallback);
rgrover1 257:7a50601356cc 291
rgrover1 257:7a50601356cc 292 void onConnection(Gap::ConnectionEventCallback_t connectionCallback);
rgrover1 257:7a50601356cc 293 /**
rgrover1 257:7a50601356cc 294 * Used to setup a callback for GAP disconnection.
rgrover1 257:7a50601356cc 295 */
rgrover1 257:7a50601356cc 296 void onDisconnection(Gap::DisconnectionEventCallback_t disconnectionCallback);
rgrover1 257:7a50601356cc 297
rgrover1 257:7a50601356cc 298 /**
rgrover1 257:7a50601356cc 299 * Append to a chain of callbacks to be invoked upon disconnection; these
rgrover1 257:7a50601356cc 300 * callbacks receive no context and are therefore different from the
rgrover1 257:7a50601356cc 301 * onDisconnection callback.
rgrover1 257:7a50601356cc 302 */
rgrover1 257:7a50601356cc 303 template<typename T>
rgrover1 257:7a50601356cc 304 void addToDisconnectionCallChain(T *tptr, void (T::*mptr)(void));
rgrover1 257:7a50601356cc 305
rgrover1 257:7a50601356cc 306 /**
rgrover1 261:b275bfc773b9 307 * Add a callback for the GATT event DATA_SENT (which is triggered when
rgrover1 261:b275bfc773b9 308 * updates are sent out by GATT in the form of notifications).
rgrover1 259:a95264ad705c 309 *
rgrover1 259:a95264ad705c 310 * @Note: it is possible to chain together multiple onDataSent callbacks
rgrover1 259:a95264ad705c 311 * (potentially from different modules of an application) to receive updates
rgrover1 260:ea7f9f14cc15 312 * to characteristics.
rgrover1 259:a95264ad705c 313 *
rgrover1 259:a95264ad705c 314 * @Note: it is also possible to setup a callback into a member function of
rgrover1 259:a95264ad705c 315 * some object.
rgrover1 257:7a50601356cc 316 */
rgrover1 259:a95264ad705c 317 void onDataSent(void (*callback)(unsigned count));
rgrover1 259:a95264ad705c 318 template <typename T> void onDataSent(T * objPtr, void (T::*memberPtr)(unsigned count));
rgrover1 257:7a50601356cc 319
rgrover1 257:7a50601356cc 320 /**
rgrover1 257:7a50601356cc 321 * Setup a callback for when a characteristic has its value updated by a
rgrover1 257:7a50601356cc 322 * client.
rgrover1 257:7a50601356cc 323 *
rgrover1 257:7a50601356cc 324 * @Note: it is possible to chain together multiple onDataWritten callbacks
rgrover1 257:7a50601356cc 325 * (potentially from different modules of an application) to receive updates
rgrover1 257:7a50601356cc 326 * to characteristics. Many services, such as DFU and UART add their own
rgrover1 257:7a50601356cc 327 * onDataWritten callbacks behind the scenes to trap interesting events.
rgrover1 257:7a50601356cc 328 *
rgrover1 257:7a50601356cc 329 * @Note: it is also possible to setup a callback into a member function of
rgrover1 257:7a50601356cc 330 * some object.
rgrover1 257:7a50601356cc 331 */
rgrover1 257:7a50601356cc 332 void onDataWritten(void (*callback)(const GattCharacteristicWriteCBParams *eventDataP));
rgrover1 257:7a50601356cc 333 template <typename T> void onDataWritten(T * objPtr, void (T::*memberPtr)(const GattCharacteristicWriteCBParams *context));
rgrover1 257:7a50601356cc 334
rgrover1 300:d9a39f759a6a 335 /**
rgrover1 300:d9a39f759a6a 336 * Setup a callback for when a characteristic is being read by a client.
rgrover1 300:d9a39f759a6a 337 *
rgrover1 300:d9a39f759a6a 338 * @Note: this functionality may not be available on all underlying stacks.
rgrover1 300:d9a39f759a6a 339 * You could use GattCharacteristic::setReadAuthorizationCallback() as an
rgrover1 300:d9a39f759a6a 340 * alternative.
rgrover1 300:d9a39f759a6a 341 *
rgrover1 300:d9a39f759a6a 342 * @Note: it is possible to chain together multiple onDataRead callbacks
rgrover1 300:d9a39f759a6a 343 * (potentially from different modules of an application) to receive updates
rgrover1 300:d9a39f759a6a 344 * to characteristics. Services may add their own onDataRead callbacks
rgrover1 300:d9a39f759a6a 345 * behind the scenes to trap interesting events.
rgrover1 300:d9a39f759a6a 346 *
rgrover1 300:d9a39f759a6a 347 * @Note: it is also possible to setup a callback into a member function of
rgrover1 300:d9a39f759a6a 348 * some object.
rgrover1 300:d9a39f759a6a 349 *
rgrover1 300:d9a39f759a6a 350 * @return BLE_ERROR_NOT_IMPLEMENTED if this functionality isn't available;
rgrover1 300:d9a39f759a6a 351 * else BLE_ERROR_NONE.
rgrover1 300:d9a39f759a6a 352 */
rgrover1 300:d9a39f759a6a 353 ble_error_t onDataRead(void (*callback)(const GattCharacteristicReadCBParams *eventDataP));
rgrover1 300:d9a39f759a6a 354 template <typename T> ble_error_t onDataRead(T * objPtr, void (T::*memberPtr)(const GattCharacteristicReadCBParams *context));
rgrover1 300:d9a39f759a6a 355
rgrover1 257:7a50601356cc 356 void onUpdatesEnabled(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 357 void onUpdatesDisabled(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 358 void onConfirmationReceived(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 359
rgrover1 257:7a50601356cc 360 /**
rgrover1 341:8a104d9d80c1 361 * Radio Notification is a feature that enables ACTIVE and INACTIVE
rgrover1 341:8a104d9d80c1 362 * (nACTIVE) signals from the stack that notify the application when the
rgrover1 341:8a104d9d80c1 363 * radio is in use. The signal is sent using software interrupt.
rgrover1 341:8a104d9d80c1 364 *
rgrover1 341:8a104d9d80c1 365 * The ACTIVE signal is sent before the Radio Event starts. The nACTIVE
rgrover1 341:8a104d9d80c1 366 * signal is sent at the end of the Radio Event. These signals can be used
rgrover1 341:8a104d9d80c1 367 * by the application programmer to synchronize application logic with radio
rgrover1 341:8a104d9d80c1 368 * activity. For example, the ACTIVE signal can be used to shut off external
rgrover1 341:8a104d9d80c1 369 * devices to manage peak current drawn during periods when the radio is on,
rgrover1 341:8a104d9d80c1 370 * or to trigger sensor data collection for transmission in the Radio Event.
rgrover1 341:8a104d9d80c1 371 *
rgrover1 341:8a104d9d80c1 372 * @param callback
rgrover1 341:8a104d9d80c1 373 * The application handler to be invoked in response to a radio
rgrover1 341:8a104d9d80c1 374 * ACTIVE/INACTIVE event.
rgrover1 341:8a104d9d80c1 375 */
rgrover1 341:8a104d9d80c1 376 void onRadioNotification(Gap::RadioNotificationEventCallback_t callback);
rgrover1 341:8a104d9d80c1 377
rgrover1 341:8a104d9d80c1 378 /**
rgrover1 257:7a50601356cc 379 * Add a service declaration to the local server ATT table. Also add the
rgrover1 257:7a50601356cc 380 * characteristics contained within.
rgrover1 257:7a50601356cc 381 */
rgrover1 257:7a50601356cc 382 ble_error_t addService(GattService &service);
rgrover1 257:7a50601356cc 383
rgrover1 336:896e159d3af6 384 /**
rgrover1 336:896e159d3af6 385 * Returns the current GAP state of the device using a bitmask which
rgrover1 336:896e159d3af6 386 * describes whether the device is advertising and/or connected.
rgrover1 336:896e159d3af6 387 */
rgrover1 257:7a50601356cc 388 Gap::GapState_t getGapState(void) const;
rgrover1 257:7a50601356cc 389
rgrover1 257:7a50601356cc 390 /**
rgrover1 257:7a50601356cc 391 * @param[in/out] lengthP
rgrover1 257:7a50601356cc 392 * input: Length in bytes to be read,
rgrover1 257:7a50601356cc 393 * output: Total length of attribute value upon successful return.
rgrover1 257:7a50601356cc 394 */
rgrover1 328:1fd12f67ed7a 395 ble_error_t readCharacteristicValue(GattAttribute::Handle_t attributeHandle, uint8_t *buffer, uint16_t *lengthP);
rgrover1 342:152bd9c825d6 396 /**
rgrover1 342:152bd9c825d6 397 * A version of the same as above with connection handle parameter to allow fetches for connection-specific multivalued attribtues (such as the CCCDs).
rgrover1 342:152bd9c825d6 398 */
rgrover1 342:152bd9c825d6 399 ble_error_t readCharacteristicValue(Gap::Handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, uint8_t *buffer, uint16_t *lengthP);
rgrover1 257:7a50601356cc 400
rgrover1 257:7a50601356cc 401 /**
rgrover1 257:7a50601356cc 402 * @param localOnly
rgrover1 257:7a50601356cc 403 * Only update the characteristic locally regardless of notify/indicate flags in the CCCD.
rgrover1 257:7a50601356cc 404 */
rgrover1 328:1fd12f67ed7a 405 ble_error_t updateCharacteristicValue(GattAttribute::Handle_t attributeHandle, const uint8_t *value, uint16_t size, bool localOnly = false);
rgrover1 342:152bd9c825d6 406 /**
rgrover1 342:152bd9c825d6 407 * A version of the same as above with connection handle parameter to allow updates for connection-specific multivalued attribtues (such as the CCCDs).
rgrover1 342:152bd9c825d6 408 */
rgrover1 342:152bd9c825d6 409 ble_error_t updateCharacteristicValue(Gap::Handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, const uint8_t *value, uint16_t size, bool localOnly = false);
rgrover1 257:7a50601356cc 410
rgrover1 257:7a50601356cc 411 /**
rgrover1 257:7a50601356cc 412 * Yield control to the BLE stack or to other tasks waiting for events. This
rgrover1 257:7a50601356cc 413 * is a sleep function which will return when there is an application
rgrover1 257:7a50601356cc 414 * specific interrupt, but the MCU might wake up several times before
rgrover1 257:7a50601356cc 415 * returning (to service the stack). This is not always interchangeable with
rgrover1 257:7a50601356cc 416 * WFE().
rgrover1 257:7a50601356cc 417 */
rgrover1 257:7a50601356cc 418 void waitForEvent(void);
rgrover1 257:7a50601356cc 419
rgrover1 257:7a50601356cc 420 ble_error_t getPreferredConnectionParams(Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 421 ble_error_t setPreferredConnectionParams(const Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 422 ble_error_t updateConnectionParams(Gap::Handle_t handle, const Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 423
rgrover1 257:7a50601356cc 424 /**
rgrover1 257:7a50601356cc 425 * This call allows the application to get the BLE stack version information.
rgrover1 257:7a50601356cc 426 *
rgrover1 257:7a50601356cc 427 * @return A pointer to a const string representing the version.
rgrover1 257:7a50601356cc 428 * Note: The string is owned by the BLE_API.
rgrover1 257:7a50601356cc 429 */
rgrover1 257:7a50601356cc 430 const char *getVersion(void);
rgrover1 257:7a50601356cc 431
rgrover1 257:7a50601356cc 432 /**
rgrover1 257:7a50601356cc 433 * Set the device name characteristic in the GAP service.
rgrover1 257:7a50601356cc 434 * @param deviceName The new value for the device-name. This is a UTF-8 encoded, <b>NULL-terminated</b> string.
rgrover1 257:7a50601356cc 435 */
rgrover1 257:7a50601356cc 436 ble_error_t setDeviceName(const uint8_t *deviceName);
rgrover1 257:7a50601356cc 437
rgrover1 257:7a50601356cc 438 /**
rgrover1 257:7a50601356cc 439 * Get the value of the device name characteristic in the GAP service.
rgrover1 257:7a50601356cc 440 * @param[out] deviceName Pointer to an empty buffer where the UTF-8 *non NULL-
rgrover1 257:7a50601356cc 441 * terminated* string will be placed. Set this
rgrover1 257:7a50601356cc 442 * value to NULL in order to obtain the deviceName-length
rgrover1 257:7a50601356cc 443 * from the 'length' parameter.
rgrover1 257:7a50601356cc 444 *
rgrover1 257:7a50601356cc 445 * @param[in/out] lengthP (on input) Length of the buffer pointed to by deviceName;
rgrover1 257:7a50601356cc 446 * (on output) the complete device name length (without the
rgrover1 257:7a50601356cc 447 * null terminator).
rgrover1 257:7a50601356cc 448 *
rgrover1 257:7a50601356cc 449 * @note If the device name is longer than the size of the supplied buffer,
rgrover1 257:7a50601356cc 450 * length will return the complete device name length,
rgrover1 257:7a50601356cc 451 * and not the number of bytes actually returned in deviceName.
rgrover1 257:7a50601356cc 452 * The application may use this information to retry with a suitable buffer size.
rgrover1 257:7a50601356cc 453 *
rgrover1 257:7a50601356cc 454 * Sample use:
rgrover1 257:7a50601356cc 455 * uint8_t deviceName[20];
rgrover1 257:7a50601356cc 456 * unsigned length = sizeof(deviceName);
rgrover1 257:7a50601356cc 457 * ble.getDeviceName(deviceName, &length);
rgrover1 257:7a50601356cc 458 * if (length < sizeof(deviceName)) {
rgrover1 257:7a50601356cc 459 * deviceName[length] = 0;
rgrover1 257:7a50601356cc 460 * }
rgrover1 257:7a50601356cc 461 * DEBUG("length: %u, deviceName: %s\r\n", length, deviceName);
rgrover1 257:7a50601356cc 462 */
rgrover1 257:7a50601356cc 463 ble_error_t getDeviceName(uint8_t *deviceName, unsigned *lengthP);
rgrover1 257:7a50601356cc 464
rgrover1 257:7a50601356cc 465 /**
rgrover1 257:7a50601356cc 466 * Set the appearance characteristic in the GAP service.
rgrover1 257:7a50601356cc 467 * @param[in] appearance The new value for the device-appearance.
rgrover1 257:7a50601356cc 468 */
rgrover1 257:7a50601356cc 469 ble_error_t setAppearance(uint16_t appearance);
rgrover1 257:7a50601356cc 470
rgrover1 257:7a50601356cc 471 /**
rgrover1 257:7a50601356cc 472 * Set the appearance characteristic in the GAP service.
rgrover1 257:7a50601356cc 473 * @param[out] appearance The new value for the device-appearance.
rgrover1 257:7a50601356cc 474 */
rgrover1 257:7a50601356cc 475 ble_error_t getAppearance(uint16_t *appearanceP);
rgrover1 257:7a50601356cc 476
rgrover1 257:7a50601356cc 477 /**
rgrover1 257:7a50601356cc 478 * Set the radio's transmit power.
rgrover1 257:7a50601356cc 479 * @param[in] txPower Radio transmit power in dBm.
rgrover1 257:7a50601356cc 480 */
rgrover1 257:7a50601356cc 481 ble_error_t setTxPower(int8_t txPower);
rgrover1 257:7a50601356cc 482
rgrover1 305:71367f7cd078 483 /**
rgrover1 305:71367f7cd078 484 * Query the underlying stack for permitted arguments for setTxPower().
rgrover1 305:71367f7cd078 485 *
rgrover1 305:71367f7cd078 486 * @param[out] valueArrayPP
rgrover1 305:71367f7cd078 487 * Out parameter to receive the immutable array of Tx values.
rgrover1 305:71367f7cd078 488 * @param[out] countP
rgrover1 305:71367f7cd078 489 * Out parameter to receive the array's size.
rgrover1 305:71367f7cd078 490 */
rgrover1 305:71367f7cd078 491 void getPermittedTxPowerValues(const int8_t **valueArrayPP, size_t *countP);
rgrover1 305:71367f7cd078 492
rgrover1 347:20be4234c6fe 493 /**
rgrover1 347:20be4234c6fe 494 * Enable the BLE stack's Security Manager. The Security Manager implements
rgrover1 347:20be4234c6fe 495 * the actual cryptographic algorithms and protocol exchanges that allow two
rgrover1 347:20be4234c6fe 496 * devices to securely exchange data and privately detect each other.
rgrover1 347:20be4234c6fe 497 * Calling this API is a prerequisite for encryption and pairing (bonding).
rgrover1 357:d4bb5d2b837a 498 *
rgrover1 357:d4bb5d2b837a 499 * @param[in] enableBonding Allow for bonding.
rgrover1 357:d4bb5d2b837a 500 * @param[in] requireMITM Require protection for man-in-the-middle attacks.
rgrover1 357:d4bb5d2b837a 501 * @param[in] iocaps To specify IO capabilities of this peripheral,
rgrover1 357:d4bb5d2b837a 502 * such as availability of a display or keyboard to
rgrover1 357:d4bb5d2b837a 503 * support out-of-band exchanges of security data.
rgrover1 357:d4bb5d2b837a 504 * @param[in] passkey To specify a static passkey.
rgrover1 357:d4bb5d2b837a 505 *
rgrover1 357:d4bb5d2b837a 506 * @return BLE_ERROR_NONE on success.
rgrover1 347:20be4234c6fe 507 */
rgrover1 357:d4bb5d2b837a 508 ble_error_t initializeSecurity(bool enableBonding = true,
rgrover1 357:d4bb5d2b837a 509 bool requireMITM = true,
rgrover1 357:d4bb5d2b837a 510 Gap::SecurityIOCapabilities_t iocaps = Gap::IO_CAPS_NONE,
rgrover1 357:d4bb5d2b837a 511 const Gap::Passkey_t passkey = NULL);
rgrover1 347:20be4234c6fe 512
rgrover1 368:89726b616c1b 513 /**
rgrover1 368:89726b616c1b 514 * Setup a callback for when the security setup procedure (key generation
rgrover1 368:89726b616c1b 515 * and exchange) for a link has started. This will be skipped for bonded
rgrover1 368:89726b616c1b 516 * devices. The callback is passed in parameters received from the peer's
rgrover1 368:89726b616c1b 517 * security request: bool allowBonding, bool requireMITM, and
rgrover1 368:89726b616c1b 518 * SecurityIOCapabilities_t.
rgrover1 368:89726b616c1b 519 */
rgrover1 368:89726b616c1b 520 void onSecuritySetupInitiated(Gap::SecuritySetupInitiatedCallback_t callback);
rgrover1 368:89726b616c1b 521
rgrover1 368:89726b616c1b 522 /**
rgrover1 368:89726b616c1b 523 * Setup a callback for when the security setup procedure (key generation
rgrover1 368:89726b616c1b 524 * and exchange) for a link has completed. This will be skipped for bonded
rgrover1 368:89726b616c1b 525 * devices. The callback is passed in the success/failure status of the
rgrover1 368:89726b616c1b 526 * security setup procedure.
rgrover1 368:89726b616c1b 527 */
rgrover1 368:89726b616c1b 528 void onSecuritySetupCompleted(Gap::SecuritySetupCompletedCallback_t callback);
rgrover1 368:89726b616c1b 529
rgrover1 368:89726b616c1b 530 /**
rgrover1 368:89726b616c1b 531 * Setup a callback for when a link with the peer is secured. For bonded
rgrover1 368:89726b616c1b 532 * devices, subsequent reconnections with bonded peer will result only in
rgrover1 368:89726b616c1b 533 * this callback when the link is secured and setup procedures will not
rgrover1 368:89726b616c1b 534 * occur unless the bonding information is either lost or deleted on either
rgrover1 368:89726b616c1b 535 * or both sides. The callback is passed in a Gap::SecurityMode_t according
rgrover1 368:89726b616c1b 536 * to the level of security in effect for the secured link.
rgrover1 368:89726b616c1b 537 */
rgrover1 368:89726b616c1b 538 void onLinkSecured(Gap::LinkSecuredCallback_t callback);
rgrover1 368:89726b616c1b 539
rgrover1 368:89726b616c1b 540 /**
rgrover1 368:89726b616c1b 541 * Setup a callback for successful bonding; i.e. that link-specific security
rgrover1 368:89726b616c1b 542 * context is stored persistently for a peer device.
rgrover1 368:89726b616c1b 543 */
rgrover1 368:89726b616c1b 544 void onSecurityContextStored(Gap::HandleSpecificEvent_t callback);
rgrover1 368:89726b616c1b 545
rgrover1 368:89726b616c1b 546 /**
rgrover1 369:9a76cc068644 547 * Setup a callback for when the passkey needs to be displayed on a
rgrover1 369:9a76cc068644 548 * peripheral with DISPLAY capability. This happens when security is
rgrover1 369:9a76cc068644 549 * configured to prevent Man-In-The-Middle attacks, and a PIN (or passkey)
rgrover1 369:9a76cc068644 550 * needs to be exchanged between the peers to authenticate the connection
rgrover1 369:9a76cc068644 551 * attempt.
rgrover1 369:9a76cc068644 552 */
rgrover1 369:9a76cc068644 553 void onPasskeyDisplay(Gap::PasskeyDisplayCallback_t callback);
rgrover1 369:9a76cc068644 554
rgrover1 369:9a76cc068644 555 /**
rgrover1 368:89726b616c1b 556 * Get the security status of a connection.
rgrover1 368:89726b616c1b 557 *
rgrover1 368:89726b616c1b 558 * @param[in] connectionHandle Handle to identify the connection.
rgrover1 368:89726b616c1b 559 * @param[out] securityStatusP security status.
rgrover1 368:89726b616c1b 560 *
rgrover1 368:89726b616c1b 561 * @return BLE_SUCCESS Or appropriate error code indicating reason for failure.
rgrover1 368:89726b616c1b 562 */
rgrover1 368:89726b616c1b 563 ble_error_t getLinkSecurity(Gap::Handle_t connectionHandle, Gap::LinkSecurityStatus_t *securityStatusP);
rgrover1 368:89726b616c1b 564
rgrover1 371:6c73b5970f2d 565 /**
rgrover1 371:6c73b5970f2d 566 * Delete all peer device context and all related bonding information from
rgrover1 371:6c73b5970f2d 567 * the database within the security manager.
rgrover1 371:6c73b5970f2d 568 *
rgrover1 371:6c73b5970f2d 569 * @retval BLE_ERROR_NONE On success, else an error code indicating reason for failure.
rgrover1 371:6c73b5970f2d 570 * @retval BLE_ERROR_INVALID_STATE If the API is called without module initialization and/or
rgrover1 371:6c73b5970f2d 571 * application registration.
rgrover1 371:6c73b5970f2d 572 */
rgrover1 371:6c73b5970f2d 573 ble_error_t purgeAllBondingState(void);
rgrover1 371:6c73b5970f2d 574
rgrover1 257:7a50601356cc 575 public:
rgrover1 383:7bd527ea7280 576 BLEDevice() : transport(createBLEDeviceInstance()), advParams(), advPayload(), scanResponse(), needToSetAdvPayload(true), scanningParams() {
rgrover1 257:7a50601356cc 577 advPayload.clear();
rgrover1 257:7a50601356cc 578 scanResponse.clear();
rgrover1 257:7a50601356cc 579 }
rgrover1 257:7a50601356cc 580
rgrover1 257:7a50601356cc 581 private:
rgrover1 257:7a50601356cc 582 BLEDeviceInstanceBase *const transport; /* the device specific backend */
rgrover1 257:7a50601356cc 583
rgrover1 257:7a50601356cc 584 GapAdvertisingParams advParams;
rgrover1 257:7a50601356cc 585 GapAdvertisingData advPayload;
rgrover1 257:7a50601356cc 586 GapAdvertisingData scanResponse;
rgrover1 257:7a50601356cc 587
rgrover1 257:7a50601356cc 588 /* Accumulation of AD structures in the advertisement payload should
rgrover1 257:7a50601356cc 589 * eventually result in a call to the target's setAdvertisingData() before
rgrover1 257:7a50601356cc 590 * the server begins advertising. This flag marks the status of the pending update.*/
rgrover1 257:7a50601356cc 591 bool needToSetAdvPayload;
rgrover1 380:2109a08c311c 592
rgrover1 380:2109a08c311c 593 GapScanningParams scanningParams;
rgrover1 257:7a50601356cc 594 };
rgrover1 257:7a50601356cc 595
rgrover1 257:7a50601356cc 596 /* BLEDevice methods. Most of these simply forward the calls to the underlying
rgrover1 257:7a50601356cc 597 * transport.*/
rgrover1 257:7a50601356cc 598
rgrover1 257:7a50601356cc 599 inline ble_error_t
rgrover1 257:7a50601356cc 600 BLEDevice::reset(void)
rgrover1 257:7a50601356cc 601 {
rgrover1 257:7a50601356cc 602 return transport->reset();
rgrover1 257:7a50601356cc 603 }
rgrover1 257:7a50601356cc 604
rgrover1 257:7a50601356cc 605 inline ble_error_t
rgrover1 257:7a50601356cc 606 BLEDevice::shutdown(void)
rgrover1 257:7a50601356cc 607 {
rgrover1 257:7a50601356cc 608 clearAdvertisingPayload();
rgrover1 257:7a50601356cc 609 return transport->shutdown();
rgrover1 257:7a50601356cc 610 }
rgrover1 257:7a50601356cc 611
rgrover1 257:7a50601356cc 612 inline ble_error_t
rgrover1 257:7a50601356cc 613 BLEDevice::setAddress(Gap::addr_type_t type, const Gap::address_t address)
rgrover1 257:7a50601356cc 614 {
rgrover1 257:7a50601356cc 615 return transport->getGap().setAddress(type, address);
rgrover1 257:7a50601356cc 616 }
rgrover1 257:7a50601356cc 617
rgrover1 257:7a50601356cc 618 inline ble_error_t
rgrover1 257:7a50601356cc 619 BLEDevice::getAddress(Gap::addr_type_t *typeP, Gap::address_t address)
rgrover1 257:7a50601356cc 620 {
rgrover1 257:7a50601356cc 621 return transport->getGap().getAddress(typeP, address);
rgrover1 257:7a50601356cc 622 }
rgrover1 257:7a50601356cc 623
rgrover1 257:7a50601356cc 624 inline void
rgrover1 257:7a50601356cc 625 BLEDevice::setAdvertisingType(GapAdvertisingParams::AdvertisingType advType)
rgrover1 257:7a50601356cc 626 {
rgrover1 257:7a50601356cc 627 advParams.setAdvertisingType(advType);
rgrover1 257:7a50601356cc 628 }
rgrover1 257:7a50601356cc 629
rgrover1 257:7a50601356cc 630 inline void
rgrover1 257:7a50601356cc 631 BLEDevice::setAdvertisingInterval(uint16_t interval)
rgrover1 257:7a50601356cc 632 {
rgrover1 325:501ad8b8bbe5 633 if (interval == 0) {
rgrover1 325:501ad8b8bbe5 634 stopAdvertising();
rgrover1 325:501ad8b8bbe5 635 } else if (interval < getMinAdvertisingInterval()) {
rgrover1 325:501ad8b8bbe5 636 interval = getMinAdvertisingInterval();
rgrover1 325:501ad8b8bbe5 637 }
rgrover1 325:501ad8b8bbe5 638 advParams.setInterval(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(interval));
rgrover1 325:501ad8b8bbe5 639 }
rgrover1 325:501ad8b8bbe5 640
rgrover1 325:501ad8b8bbe5 641 inline uint16_t
rgrover1 325:501ad8b8bbe5 642 BLEDevice::getMinAdvertisingInterval(void) const {
rgrover1 325:501ad8b8bbe5 643 return transport->getGap().getMinAdvertisingInterval();
rgrover1 325:501ad8b8bbe5 644 }
rgrover1 325:501ad8b8bbe5 645
rgrover1 325:501ad8b8bbe5 646 inline uint16_t
rgrover1 325:501ad8b8bbe5 647 BLEDevice::getMinNonConnectableAdvertisingInterval(void) const {
rgrover1 325:501ad8b8bbe5 648 return transport->getGap().getMinNonConnectableAdvertisingInterval();
rgrover1 325:501ad8b8bbe5 649 }
rgrover1 325:501ad8b8bbe5 650
rgrover1 325:501ad8b8bbe5 651 inline uint16_t
rgrover1 325:501ad8b8bbe5 652 BLEDevice::getMaxAdvertisingInterval(void) const {
rgrover1 325:501ad8b8bbe5 653 return transport->getGap().getMaxAdvertisingInterval();
rgrover1 257:7a50601356cc 654 }
rgrover1 257:7a50601356cc 655
rgrover1 257:7a50601356cc 656 inline void
rgrover1 257:7a50601356cc 657 BLEDevice::setAdvertisingTimeout(uint16_t timeout)
rgrover1 257:7a50601356cc 658 {
rgrover1 257:7a50601356cc 659 advParams.setTimeout(timeout);
rgrover1 257:7a50601356cc 660 }
rgrover1 257:7a50601356cc 661
rgrover1 257:7a50601356cc 662 inline void
rgrover1 257:7a50601356cc 663 BLEDevice::setAdvertisingParams(const GapAdvertisingParams &newAdvParams)
rgrover1 257:7a50601356cc 664 {
rgrover1 257:7a50601356cc 665 advParams = newAdvParams;
rgrover1 257:7a50601356cc 666 }
rgrover1 257:7a50601356cc 667
rgrover1 257:7a50601356cc 668 inline void
rgrover1 257:7a50601356cc 669 BLEDevice::clearAdvertisingPayload(void)
rgrover1 257:7a50601356cc 670 {
rgrover1 257:7a50601356cc 671 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 672 advPayload.clear();
rgrover1 257:7a50601356cc 673 }
rgrover1 257:7a50601356cc 674
rgrover1 257:7a50601356cc 675 inline ble_error_t
rgrover1 257:7a50601356cc 676 BLEDevice::accumulateAdvertisingPayload(uint8_t flags)
rgrover1 257:7a50601356cc 677 {
rgrover1 257:7a50601356cc 678 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 679 return advPayload.addFlags(flags);
rgrover1 257:7a50601356cc 680 }
rgrover1 257:7a50601356cc 681
rgrover1 257:7a50601356cc 682 inline ble_error_t
rgrover1 257:7a50601356cc 683 BLEDevice::accumulateAdvertisingPayload(GapAdvertisingData::Appearance app)
rgrover1 257:7a50601356cc 684 {
rgrover1 257:7a50601356cc 685 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 686 transport->getGap().setAppearance(app);
rgrover1 257:7a50601356cc 687 return advPayload.addAppearance(app);
rgrover1 257:7a50601356cc 688 }
rgrover1 257:7a50601356cc 689
rgrover1 257:7a50601356cc 690 inline ble_error_t
rgrover1 257:7a50601356cc 691 BLEDevice::accumulateAdvertisingPayloadTxPower(int8_t txPower)
rgrover1 257:7a50601356cc 692 {
rgrover1 257:7a50601356cc 693 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 694 return advPayload.addTxPower(txPower);
rgrover1 257:7a50601356cc 695 }
rgrover1 257:7a50601356cc 696
rgrover1 257:7a50601356cc 697 inline ble_error_t
rgrover1 257:7a50601356cc 698 BLEDevice::accumulateAdvertisingPayload(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len)
rgrover1 257:7a50601356cc 699 {
rgrover1 257:7a50601356cc 700 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 701 if (type == GapAdvertisingData::COMPLETE_LOCAL_NAME) {
rgrover1 257:7a50601356cc 702 transport->getGap().setDeviceName(data);
rgrover1 257:7a50601356cc 703 }
rgrover1 257:7a50601356cc 704 return advPayload.addData(type, data, len);
rgrover1 257:7a50601356cc 705 }
rgrover1 257:7a50601356cc 706
rgrover1 257:7a50601356cc 707 inline ble_error_t
rgrover1 257:7a50601356cc 708 BLEDevice::accumulateScanResponse(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len)
rgrover1 257:7a50601356cc 709 {
rgrover1 257:7a50601356cc 710 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 711 return scanResponse.addData(type, data, len);
rgrover1 257:7a50601356cc 712 }
rgrover1 257:7a50601356cc 713
rgrover1 343:4d2576324b62 714 inline void
rgrover1 343:4d2576324b62 715 BLEDevice::clearScanResponse(void)
rgrover1 343:4d2576324b62 716 {
rgrover1 343:4d2576324b62 717 needToSetAdvPayload = true;
rgrover1 343:4d2576324b62 718 scanResponse.clear();
rgrover1 343:4d2576324b62 719 }
rgrover1 343:4d2576324b62 720
rgrover1 257:7a50601356cc 721 inline ble_error_t
rgrover1 257:7a50601356cc 722 BLEDevice::setAdvertisingPayload(void) {
rgrover1 257:7a50601356cc 723 needToSetAdvPayload = false;
rgrover1 257:7a50601356cc 724 return transport->getGap().setAdvertisingData(advPayload, scanResponse);
rgrover1 257:7a50601356cc 725 }
rgrover1 257:7a50601356cc 726
rgrover1 257:7a50601356cc 727 inline ble_error_t
rgrover1 257:7a50601356cc 728 BLEDevice::startAdvertising(void)
rgrover1 257:7a50601356cc 729 {
rgrover1 257:7a50601356cc 730 ble_error_t rc;
rgrover1 257:7a50601356cc 731 if ((rc = transport->getGattServer().initializeGATTDatabase()) != BLE_ERROR_NONE) {
rgrover1 257:7a50601356cc 732 return rc;
rgrover1 257:7a50601356cc 733 }
rgrover1 257:7a50601356cc 734 if (needToSetAdvPayload) {
rgrover1 257:7a50601356cc 735 if ((rc = setAdvertisingPayload()) != BLE_ERROR_NONE) {
rgrover1 257:7a50601356cc 736 return rc;
rgrover1 257:7a50601356cc 737 }
rgrover1 257:7a50601356cc 738 }
rgrover1 257:7a50601356cc 739
rgrover1 257:7a50601356cc 740 return transport->getGap().startAdvertising(advParams);
rgrover1 257:7a50601356cc 741 }
rgrover1 257:7a50601356cc 742
rgrover1 257:7a50601356cc 743 inline ble_error_t
rgrover1 257:7a50601356cc 744 BLEDevice::stopAdvertising(void)
rgrover1 257:7a50601356cc 745 {
rgrover1 257:7a50601356cc 746 return transport->getGap().stopAdvertising();
rgrover1 257:7a50601356cc 747 }
rgrover1 257:7a50601356cc 748
rgrover1 257:7a50601356cc 749 inline ble_error_t
rgrover1 394:598368c24bbb 750 BLEDevice::setScanParams(uint16_t interval, uint16_t window, uint16_t timeout, bool activeScanning) {
rgrover1 384:48412313df56 751 ble_error_t rc;
rgrover1 384:48412313df56 752 if (((rc = scanningParams.setInterval(interval)) == BLE_ERROR_NONE) &&
rgrover1 384:48412313df56 753 ((rc = scanningParams.setWindow(window)) == BLE_ERROR_NONE) &&
rgrover1 384:48412313df56 754 ((rc = scanningParams.setTimeout(timeout)) == BLE_ERROR_NONE)) {
rgrover1 394:598368c24bbb 755 scanningParams.setActiveScanning(activeScanning);
rgrover1 384:48412313df56 756 return BLE_ERROR_NONE;
rgrover1 384:48412313df56 757 }
rgrover1 384:48412313df56 758
rgrover1 384:48412313df56 759 return rc;
rgrover1 384:48412313df56 760 }
rgrover1 384:48412313df56 761
rgrover1 384:48412313df56 762 inline ble_error_t
rgrover1 392:3201f029c2eb 763 BLEDevice::setScanInterval(uint16_t interval) {
rgrover1 384:48412313df56 764 return scanningParams.setInterval(interval);
rgrover1 384:48412313df56 765 }
rgrover1 384:48412313df56 766
rgrover1 384:48412313df56 767 inline ble_error_t
rgrover1 392:3201f029c2eb 768 BLEDevice::setScanWindow(uint16_t window) {
rgrover1 384:48412313df56 769
rgrover1 384:48412313df56 770 return scanningParams.setWindow(window);
rgrover1 384:48412313df56 771 }
rgrover1 384:48412313df56 772
rgrover1 384:48412313df56 773 inline ble_error_t
rgrover1 392:3201f029c2eb 774 BLEDevice::setScanTimeout(uint16_t timeout) {
rgrover1 384:48412313df56 775 return scanningParams.setTimeout(timeout);
rgrover1 384:48412313df56 776 }
rgrover1 384:48412313df56 777
rgrover1 394:598368c24bbb 778 inline void
rgrover1 394:598368c24bbb 779 BLEDevice::setActiveScan(bool activeScanning) {
rgrover1 394:598368c24bbb 780 return scanningParams.setActiveScanning(activeScanning);
rgrover1 394:598368c24bbb 781 }
rgrover1 394:598368c24bbb 782
rgrover1 384:48412313df56 783 inline ble_error_t
rgrover1 392:3201f029c2eb 784 BLEDevice::startScan(Gap::AdvertisementReportCallback_t callback) {
rgrover1 392:3201f029c2eb 785 return transport->getGap().startScan(scanningParams, callback);
rgrover1 385:6e66d1c6de00 786 }
rgrover1 385:6e66d1c6de00 787
rgrover1 385:6e66d1c6de00 788 inline ble_error_t
rgrover1 392:3201f029c2eb 789 BLEDevice::stopScan(void) {
rgrover1 392:3201f029c2eb 790 return transport->getGap().stopScan();
rgrover1 387:7faa54079669 791 }
rgrover1 387:7faa54079669 792
rgrover1 387:7faa54079669 793
rgrover1 387:7faa54079669 794 inline ble_error_t
rgrover1 257:7a50601356cc 795 BLEDevice::disconnect(Gap::DisconnectionReason_t reason)
rgrover1 257:7a50601356cc 796 {
rgrover1 257:7a50601356cc 797 return transport->getGap().disconnect(reason);
rgrover1 257:7a50601356cc 798 }
rgrover1 257:7a50601356cc 799
rgrover1 257:7a50601356cc 800 inline void
rgrover1 257:7a50601356cc 801 BLEDevice::onTimeout(Gap::EventCallback_t timeoutCallback)
rgrover1 257:7a50601356cc 802 {
rgrover1 257:7a50601356cc 803 transport->getGap().setOnTimeout(timeoutCallback);
rgrover1 257:7a50601356cc 804 }
rgrover1 257:7a50601356cc 805
rgrover1 257:7a50601356cc 806 inline void
rgrover1 257:7a50601356cc 807 BLEDevice::onConnection(Gap::ConnectionEventCallback_t connectionCallback)
rgrover1 257:7a50601356cc 808 {
rgrover1 257:7a50601356cc 809 transport->getGap().setOnConnection(connectionCallback);
rgrover1 257:7a50601356cc 810 }
rgrover1 257:7a50601356cc 811
rgrover1 257:7a50601356cc 812 inline void
rgrover1 257:7a50601356cc 813 BLEDevice::onDisconnection(Gap::DisconnectionEventCallback_t disconnectionCallback)
rgrover1 257:7a50601356cc 814 {
rgrover1 257:7a50601356cc 815 transport->getGap().setOnDisconnection(disconnectionCallback);
rgrover1 257:7a50601356cc 816 }
rgrover1 257:7a50601356cc 817
rgrover1 257:7a50601356cc 818 template<typename T>
rgrover1 257:7a50601356cc 819 inline void
rgrover1 257:7a50601356cc 820 BLEDevice::addToDisconnectionCallChain(T *tptr, void (T::*mptr)(void)) {
rgrover1 257:7a50601356cc 821 transport->getGap().addToDisconnectionCallChain(tptr, mptr);
rgrover1 257:7a50601356cc 822 }
rgrover1 257:7a50601356cc 823
rgrover1 257:7a50601356cc 824 inline void
rgrover1 259:a95264ad705c 825 BLEDevice::onDataSent(void (*callback)(unsigned count)) {
rgrover1 257:7a50601356cc 826 transport->getGattServer().setOnDataSent(callback);
rgrover1 257:7a50601356cc 827 }
rgrover1 257:7a50601356cc 828
rgrover1 259:a95264ad705c 829 template <typename T> inline void
rgrover1 259:a95264ad705c 830 BLEDevice::onDataSent(T *objPtr, void (T::*memberPtr)(unsigned count)) {
rgrover1 259:a95264ad705c 831 transport->getGattServer().setOnDataSent(objPtr, memberPtr);
rgrover1 259:a95264ad705c 832 }
rgrover1 259:a95264ad705c 833
rgrover1 257:7a50601356cc 834 inline void
rgrover1 257:7a50601356cc 835 BLEDevice::onDataWritten(void (*callback)(const GattCharacteristicWriteCBParams *eventDataP)) {
rgrover1 257:7a50601356cc 836 transport->getGattServer().setOnDataWritten(callback);
rgrover1 257:7a50601356cc 837 }
rgrover1 257:7a50601356cc 838
rgrover1 257:7a50601356cc 839 template <typename T> inline void
rgrover1 257:7a50601356cc 840 BLEDevice::onDataWritten(T *objPtr, void (T::*memberPtr)(const GattCharacteristicWriteCBParams *context)) {
rgrover1 257:7a50601356cc 841 transport->getGattServer().setOnDataWritten(objPtr, memberPtr);
rgrover1 257:7a50601356cc 842 }
rgrover1 257:7a50601356cc 843
rgrover1 300:d9a39f759a6a 844 inline ble_error_t
rgrover1 300:d9a39f759a6a 845 BLEDevice::onDataRead(void (*callback)(const GattCharacteristicReadCBParams *eventDataP)) {
rgrover1 300:d9a39f759a6a 846 return transport->getGattServer().setOnDataRead(callback);
rgrover1 300:d9a39f759a6a 847 }
rgrover1 300:d9a39f759a6a 848
rgrover1 300:d9a39f759a6a 849 template <typename T> inline ble_error_t
rgrover1 300:d9a39f759a6a 850 BLEDevice::onDataRead(T *objPtr, void (T::*memberPtr)(const GattCharacteristicReadCBParams *context)) {
rgrover1 300:d9a39f759a6a 851 return transport->getGattServer().setOnDataRead(objPtr, memberPtr);
rgrover1 300:d9a39f759a6a 852 }
rgrover1 300:d9a39f759a6a 853
rgrover1 257:7a50601356cc 854 inline void
rgrover1 257:7a50601356cc 855 BLEDevice::onUpdatesEnabled(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 856 {
rgrover1 257:7a50601356cc 857 transport->getGattServer().setOnUpdatesEnabled(callback);
rgrover1 257:7a50601356cc 858 }
rgrover1 257:7a50601356cc 859
rgrover1 257:7a50601356cc 860 inline void
rgrover1 257:7a50601356cc 861 BLEDevice::onUpdatesDisabled(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 862 {
rgrover1 257:7a50601356cc 863 transport->getGattServer().setOnUpdatesDisabled(callback);
rgrover1 257:7a50601356cc 864 }
rgrover1 257:7a50601356cc 865
rgrover1 257:7a50601356cc 866 inline void
rgrover1 257:7a50601356cc 867 BLEDevice::onConfirmationReceived(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 868 {
rgrover1 257:7a50601356cc 869 transport->getGattServer().setOnConfirmationReceived(callback);
rgrover1 257:7a50601356cc 870 }
rgrover1 257:7a50601356cc 871
rgrover1 341:8a104d9d80c1 872 inline void
rgrover1 341:8a104d9d80c1 873 BLEDevice::onRadioNotification(Gap::RadioNotificationEventCallback_t callback)
rgrover1 341:8a104d9d80c1 874 {
rgrover1 341:8a104d9d80c1 875 transport->getGap().setOnRadioNotification(callback);
rgrover1 341:8a104d9d80c1 876 }
rgrover1 341:8a104d9d80c1 877
rgrover1 353:5ed63cda3038 878 inline ble_error_t
rgrover1 257:7a50601356cc 879 BLEDevice::addService(GattService &service)
rgrover1 257:7a50601356cc 880 {
rgrover1 257:7a50601356cc 881 return transport->getGattServer().addService(service);
rgrover1 257:7a50601356cc 882 }
rgrover1 257:7a50601356cc 883
rgrover1 257:7a50601356cc 884 inline Gap::GapState_t
rgrover1 257:7a50601356cc 885 BLEDevice::getGapState(void) const
rgrover1 257:7a50601356cc 886 {
rgrover1 257:7a50601356cc 887 return transport->getGap().getState();
rgrover1 257:7a50601356cc 888 }
rgrover1 257:7a50601356cc 889
rgrover1 328:1fd12f67ed7a 890 inline ble_error_t BLEDevice::readCharacteristicValue(GattAttribute::Handle_t attributeHandle, uint8_t *buffer, uint16_t *lengthP)
rgrover1 257:7a50601356cc 891 {
rgrover1 328:1fd12f67ed7a 892 return transport->getGattServer().readValue(attributeHandle, buffer, lengthP);
rgrover1 257:7a50601356cc 893 }
rgrover1 257:7a50601356cc 894
rgrover1 342:152bd9c825d6 895 inline ble_error_t BLEDevice::readCharacteristicValue(Gap::Handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, uint8_t *buffer, uint16_t *lengthP)
rgrover1 342:152bd9c825d6 896 {
rgrover1 342:152bd9c825d6 897 return transport->getGattServer().readValue(connectionHandle, attributeHandle, buffer, lengthP);
rgrover1 342:152bd9c825d6 898 }
rgrover1 342:152bd9c825d6 899
rgrover1 257:7a50601356cc 900 inline ble_error_t
rgrover1 328:1fd12f67ed7a 901 BLEDevice::updateCharacteristicValue(GattAttribute::Handle_t attributeHandle, const uint8_t *value, uint16_t size, bool localOnly)
rgrover1 257:7a50601356cc 902 {
rgrover1 328:1fd12f67ed7a 903 return transport->getGattServer().updateValue(attributeHandle, const_cast<uint8_t *>(value), size, localOnly);
rgrover1 257:7a50601356cc 904 }
rgrover1 257:7a50601356cc 905
rgrover1 342:152bd9c825d6 906 inline ble_error_t
rgrover1 342:152bd9c825d6 907 BLEDevice::updateCharacteristicValue(Gap::Handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, const uint8_t *value, uint16_t size, bool localOnly)
rgrover1 342:152bd9c825d6 908 {
rgrover1 342:152bd9c825d6 909 return transport->getGattServer().updateValue(connectionHandle, attributeHandle, const_cast<uint8_t *>(value), size, localOnly);
rgrover1 342:152bd9c825d6 910 }
rgrover1 342:152bd9c825d6 911
rgrover1 257:7a50601356cc 912 inline void
rgrover1 257:7a50601356cc 913 BLEDevice::waitForEvent(void)
rgrover1 257:7a50601356cc 914 {
rgrover1 257:7a50601356cc 915 transport->waitForEvent();
rgrover1 257:7a50601356cc 916 }
rgrover1 257:7a50601356cc 917
rgrover1 257:7a50601356cc 918 inline ble_error_t
rgrover1 257:7a50601356cc 919 BLEDevice::getPreferredConnectionParams(Gap::ConnectionParams_t *params)
rgrover1 257:7a50601356cc 920 {
rgrover1 257:7a50601356cc 921 return transport->getGap().getPreferredConnectionParams(params);
rgrover1 257:7a50601356cc 922 }
rgrover1 257:7a50601356cc 923
rgrover1 257:7a50601356cc 924 inline ble_error_t
rgrover1 257:7a50601356cc 925 BLEDevice::setPreferredConnectionParams(const Gap::ConnectionParams_t *params)
rgrover1 257:7a50601356cc 926 {
rgrover1 257:7a50601356cc 927 return transport->getGap().setPreferredConnectionParams(params);
rgrover1 257:7a50601356cc 928 }
rgrover1 257:7a50601356cc 929
rgrover1 257:7a50601356cc 930 inline ble_error_t
rgrover1 257:7a50601356cc 931 BLEDevice::updateConnectionParams(Gap::Handle_t handle, const Gap::ConnectionParams_t *params) {
rgrover1 257:7a50601356cc 932 return transport->getGap().updateConnectionParams(handle, params);
rgrover1 257:7a50601356cc 933 }
rgrover1 257:7a50601356cc 934
rgrover1 257:7a50601356cc 935 inline const char *
rgrover1 257:7a50601356cc 936 BLEDevice::getVersion(void)
rgrover1 257:7a50601356cc 937 {
rgrover1 257:7a50601356cc 938 return transport->getVersion();
rgrover1 257:7a50601356cc 939 }
rgrover1 257:7a50601356cc 940
rgrover1 257:7a50601356cc 941 inline ble_error_t
rgrover1 257:7a50601356cc 942 BLEDevice::setDeviceName(const uint8_t *deviceName)
rgrover1 257:7a50601356cc 943 {
rgrover1 257:7a50601356cc 944 return transport->getGap().setDeviceName(deviceName);
rgrover1 257:7a50601356cc 945 }
rgrover1 257:7a50601356cc 946
rgrover1 257:7a50601356cc 947 inline ble_error_t
rgrover1 257:7a50601356cc 948 BLEDevice::getDeviceName(uint8_t *deviceName, unsigned *lengthP)
rgrover1 257:7a50601356cc 949 {
rgrover1 257:7a50601356cc 950 return transport->getGap().getDeviceName(deviceName, lengthP);
rgrover1 257:7a50601356cc 951 }
rgrover1 257:7a50601356cc 952
rgrover1 257:7a50601356cc 953 inline ble_error_t
rgrover1 257:7a50601356cc 954 BLEDevice::setAppearance(uint16_t appearance)
rgrover1 257:7a50601356cc 955 {
rgrover1 257:7a50601356cc 956 return transport->getGap().setAppearance(appearance);
rgrover1 257:7a50601356cc 957 }
rgrover1 257:7a50601356cc 958
rgrover1 257:7a50601356cc 959 inline ble_error_t
rgrover1 257:7a50601356cc 960 BLEDevice::getAppearance(uint16_t *appearanceP)
rgrover1 257:7a50601356cc 961 {
rgrover1 257:7a50601356cc 962 return transport->getGap().getAppearance(appearanceP);
rgrover1 257:7a50601356cc 963 }
rgrover1 257:7a50601356cc 964
rgrover1 257:7a50601356cc 965 inline ble_error_t
rgrover1 257:7a50601356cc 966 BLEDevice::setTxPower(int8_t txPower)
rgrover1 257:7a50601356cc 967 {
rgrover1 257:7a50601356cc 968 return transport->setTxPower(txPower);
rgrover1 257:7a50601356cc 969 }
rgrover1 257:7a50601356cc 970
rgrover1 305:71367f7cd078 971 inline void
rgrover1 305:71367f7cd078 972 BLEDevice::getPermittedTxPowerValues(const int8_t **valueArrayPP, size_t *countP)
rgrover1 305:71367f7cd078 973 {
rgrover1 305:71367f7cd078 974 transport->getPermittedTxPowerValues(valueArrayPP, countP);
rgrover1 305:71367f7cd078 975 }
rgrover1 305:71367f7cd078 976
rgrover1 347:20be4234c6fe 977 inline ble_error_t
rgrover1 357:d4bb5d2b837a 978 BLEDevice::initializeSecurity(bool enableBonding,
rgrover1 357:d4bb5d2b837a 979 bool requireMITM,
rgrover1 357:d4bb5d2b837a 980 Gap::SecurityIOCapabilities_t iocaps,
rgrover1 357:d4bb5d2b837a 981 const Gap::Passkey_t passkey)
rgrover1 347:20be4234c6fe 982 {
rgrover1 357:d4bb5d2b837a 983 return transport->initializeSecurity(enableBonding, requireMITM, iocaps, passkey);
rgrover1 347:20be4234c6fe 984 }
rgrover1 347:20be4234c6fe 985
rgrover1 369:9a76cc068644 986 inline void
rgrover1 370:678fdba95a62 987 BLEDevice::onSecuritySetupInitiated(Gap::SecuritySetupInitiatedCallback_t callback)
rgrover1 370:678fdba95a62 988 {
rgrover1 370:678fdba95a62 989 transport->getGap().setOnSecuritySetupInitiated(callback);
rgrover1 370:678fdba95a62 990 }
rgrover1 370:678fdba95a62 991
rgrover1 370:678fdba95a62 992 inline void
rgrover1 370:678fdba95a62 993 BLEDevice::onSecuritySetupCompleted(Gap::SecuritySetupCompletedCallback_t callback)
rgrover1 370:678fdba95a62 994 {
rgrover1 370:678fdba95a62 995 transport->getGap().setOnSecuritySetupCompleted(callback);
rgrover1 370:678fdba95a62 996 }
rgrover1 370:678fdba95a62 997
rgrover1 370:678fdba95a62 998 inline void
rgrover1 370:678fdba95a62 999 BLEDevice::onLinkSecured(Gap::LinkSecuredCallback_t callback)
rgrover1 370:678fdba95a62 1000 {
rgrover1 370:678fdba95a62 1001 transport->getGap().setOnLinkSecured(callback);
rgrover1 370:678fdba95a62 1002 }
rgrover1 370:678fdba95a62 1003
rgrover1 370:678fdba95a62 1004 inline void
rgrover1 370:678fdba95a62 1005 BLEDevice::onSecurityContextStored(Gap::HandleSpecificEvent_t callback)
rgrover1 370:678fdba95a62 1006 {
rgrover1 370:678fdba95a62 1007 transport->getGap().setOnSecurityContextStored(callback);
rgrover1 370:678fdba95a62 1008 }
rgrover1 370:678fdba95a62 1009
rgrover1 370:678fdba95a62 1010 inline void
rgrover1 369:9a76cc068644 1011 BLEDevice::onPasskeyDisplay(Gap::PasskeyDisplayCallback_t callback)
rgrover1 369:9a76cc068644 1012 {
rgrover1 369:9a76cc068644 1013 return transport->getGap().setOnPasskeyDisplay(callback);
rgrover1 369:9a76cc068644 1014 }
rgrover1 369:9a76cc068644 1015
rgrover1 370:678fdba95a62 1016 inline ble_error_t
rgrover1 370:678fdba95a62 1017 BLEDevice::getLinkSecurity(Gap::Handle_t connectionHandle, Gap::LinkSecurityStatus_t *securityStatusP)
rgrover1 370:678fdba95a62 1018 {
rgrover1 370:678fdba95a62 1019 return transport->getGap().getLinkSecurity(connectionHandle, securityStatusP);
rgrover1 370:678fdba95a62 1020 }
rgrover1 370:678fdba95a62 1021
rgrover1 371:6c73b5970f2d 1022 inline ble_error_t
rgrover1 371:6c73b5970f2d 1023 BLEDevice::purgeAllBondingState(void)
rgrover1 371:6c73b5970f2d 1024 {
rgrover1 371:6c73b5970f2d 1025 return transport->getGap().purgeAllBondingState();
rgrover1 371:6c73b5970f2d 1026 }
rgrover1 371:6c73b5970f2d 1027
rgrover1 257:7a50601356cc 1028 #endif // ifndef __BLE_DEVICE__