Rene Miedema / ble_test

abc

Fork of BLE_API by Bluetooth Low Energy

public/BLEDevice.h@290:aafa664ba829, 2015-03-02 (annotated)

Committer:
rgrover1
Date:
Mon Mar 02 11:50:46 2015 +0000
Revision:
290:aafa664ba829
Parent:
289:4e2eac75f101
Child:
292:b5ee2ada4f33
Synchronized with git rev fd762d8e

Author: Jeremy Brodt

Extended attribute length handling to support dynamic length.

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 257:7a50601356cc 23 #include "BLEDeviceInstanceBase.h"
rgrover1 257:7a50601356cc 24
rgrover1 257:7a50601356cc 25 /**
rgrover1 257:7a50601356cc 26 * The base class used to abstract away BLE capable radio transceivers or SOCs,
rgrover1 257:7a50601356cc 27 * to enable this BLE API to work with any radio transparently.
rgrover1 257:7a50601356cc 28 */
rgrover1 257:7a50601356cc 29 class BLEDevice
rgrover1 257:7a50601356cc 30 {
rgrover1 257:7a50601356cc 31 public:
rgrover1 257:7a50601356cc 32 /**
rgrover1 257:7a50601356cc 33 * Initialize the BLE controller. This should be called before using
rgrover1 257:7a50601356cc 34 * anything else in the BLE_API.
rgrover1 257:7a50601356cc 35 */
rgrover1 257:7a50601356cc 36 ble_error_t init();
rgrover1 257:7a50601356cc 37 ble_error_t reset(void);
rgrover1 257:7a50601356cc 38
rgrover1 257:7a50601356cc 39 /**
rgrover1 257:7a50601356cc 40 * Purge the BLE stack of GATT and GAP state. init() must be called afterwards to re-instate services and GAP state.
rgrover1 257:7a50601356cc 41 */
rgrover1 257:7a50601356cc 42 ble_error_t shutdown(void);
rgrover1 257:7a50601356cc 43
rgrover1 257:7a50601356cc 44 /* GAP specific APIs */
rgrover1 257:7a50601356cc 45 public:
rgrover1 257:7a50601356cc 46 /**
rgrover1 257:7a50601356cc 47 * Set the BTLE MAC address and type.
rgrover1 257:7a50601356cc 48 * @return BLE_ERROR_NONE on success.
rgrover1 257:7a50601356cc 49 */
rgrover1 257:7a50601356cc 50 ble_error_t setAddress(Gap::addr_type_t type, const Gap::address_t address);
rgrover1 257:7a50601356cc 51
rgrover1 257:7a50601356cc 52 /**
rgrover1 257:7a50601356cc 53 * Fetch the BTLE MAC address and type.
rgrover1 257:7a50601356cc 54 * @return BLE_ERROR_NONE on success.
rgrover1 257:7a50601356cc 55 */
rgrover1 257:7a50601356cc 56 ble_error_t getAddress(Gap::addr_type_t *typeP, Gap::address_t address);
rgrover1 257:7a50601356cc 57
rgrover1 257:7a50601356cc 58 /**
rgrover1 257:7a50601356cc 59 * @param[in] advType
rgrover1 257:7a50601356cc 60 * The GAP advertising mode to use for this device. Valid
rgrover1 257:7a50601356cc 61 * values are defined in AdvertisingType:
rgrover1 257:7a50601356cc 62 *
rgrover1 257:7a50601356cc 63 * \par ADV_NON_CONNECTABLE_UNDIRECTED
rgrover1 257:7a50601356cc 64 * All connections to the peripheral device will be refused.
rgrover1 257:7a50601356cc 65 *
rgrover1 257:7a50601356cc 66 * \par ADV_CONNECTABLE_DIRECTED
rgrover1 257:7a50601356cc 67 * Only connections from a pre-defined central device will be
rgrover1 257:7a50601356cc 68 * accepted.
rgrover1 257:7a50601356cc 69 *
rgrover1 257:7a50601356cc 70 * \par ADV_CONNECTABLE_UNDIRECTED
rgrover1 257:7a50601356cc 71 * Any central device can connect to this peripheral.
rgrover1 257:7a50601356cc 72 *
rgrover1 257:7a50601356cc 73 * \par ADV_SCANNABLE_UNDIRECTED
rgrover1 290:aafa664ba829 74 * Any central device can connect to this peripheral, and
rgrover1 290:aafa664ba829 75 * the secondary Scan Response payload will be included or
rgrover1 290:aafa664ba829 76 * available to central devices.
rgrover1 257:7a50601356cc 77 *
rgrover1 257:7a50601356cc 78 * \par
rgrover1 257:7a50601356cc 79 * See Bluetooth Core Specification 4.0 (Vol. 3), Part C,
rgrover1 257:7a50601356cc 80 * Section 9.3 and Core Specification 4.0 (Vol. 6), Part B,
rgrover1 257:7a50601356cc 81 * Section 2.3.1 for further information on GAP connection
rgrover1 257:7a50601356cc 82 * modes
rgrover1 257:7a50601356cc 83 */
rgrover1 257:7a50601356cc 84 void setAdvertisingType(GapAdvertisingParams::AdvertisingType);
rgrover1 257:7a50601356cc 85
rgrover1 257:7a50601356cc 86 /**
rgrover1 257:7a50601356cc 87 * @param[in] interval
rgrover1 257:7a50601356cc 88 * Advertising interval between 0x0020 and 0x4000 in 0.625ms
rgrover1 257:7a50601356cc 89 * units (20ms to 10.24s). If using non-connectable mode
rgrover1 257:7a50601356cc 90 * (ADV_NON_CONNECTABLE_UNDIRECTED) this min value is
rgrover1 257:7a50601356cc 91 * 0x00A0 (100ms). To reduce the likelihood of collisions, the
rgrover1 257:7a50601356cc 92 * link layer perturbs this interval by a pseudo-random delay
rgrover1 257:7a50601356cc 93 * with a range of 0 ms to 10 ms for each advertising event.
rgrover1 257:7a50601356cc 94 *
rgrover1 257:7a50601356cc 95 * \par
rgrover1 257:7a50601356cc 96 * Decreasing this value will allow central devices to detect
rgrover1 257:7a50601356cc 97 * your peripheral faster at the expense of more power being
rgrover1 257:7a50601356cc 98 * used by the radio due to the higher data transmit rate.
rgrover1 257:7a50601356cc 99 *
rgrover1 257:7a50601356cc 100 * \par
rgrover1 257:7a50601356cc 101 * This field must be set to 0 if connectionMode is equal
rgrover1 257:7a50601356cc 102 * to ADV_CONNECTABLE_DIRECTED
rgrover1 257:7a50601356cc 103 *
rgrover1 257:7a50601356cc 104 * \par
rgrover1 257:7a50601356cc 105 * See Bluetooth Core Specification, Vol 3., Part C,
rgrover1 257:7a50601356cc 106 * Appendix A for suggested advertising intervals.
rgrover1 257:7a50601356cc 107 */
rgrover1 257:7a50601356cc 108 void setAdvertisingInterval(uint16_t interval);
rgrover1 257:7a50601356cc 109
rgrover1 257:7a50601356cc 110 /**
rgrover1 257:7a50601356cc 111 * @param[in] timeout
rgrover1 257:7a50601356cc 112 * Advertising timeout between 0x1 and 0x3FFF (1 and 16383)
rgrover1 257:7a50601356cc 113 * in seconds. Enter 0 to disable the advertising timeout.
rgrover1 257:7a50601356cc 114 */
rgrover1 257:7a50601356cc 115 void setAdvertisingTimeout(uint16_t timeout);
rgrover1 257:7a50601356cc 116
rgrover1 257:7a50601356cc 117 /**
rgrover1 257:7a50601356cc 118 * Please refer to the APIs above.
rgrover1 257:7a50601356cc 119 */
rgrover1 257:7a50601356cc 120 void setAdvertisingParams(const GapAdvertisingParams &advParams);
rgrover1 257:7a50601356cc 121
rgrover1 257:7a50601356cc 122 /**
rgrover1 257:7a50601356cc 123 * This API is typically used as an internal helper to udpate the transport
rgrover1 257:7a50601356cc 124 * backend with advertising data before starting to advertise. It may also
rgrover1 257:7a50601356cc 125 * be explicity used to dynamically reset the accumulated advertising
rgrover1 257:7a50601356cc 126 * payload and scanResponse; to do this, the application can clear and re-
rgrover1 257:7a50601356cc 127 * accumulate a new advertising payload (and scanResponse) before using this
rgrover1 257:7a50601356cc 128 * API.
rgrover1 257:7a50601356cc 129 */
rgrover1 257:7a50601356cc 130 ble_error_t setAdvertisingPayload(void);
rgrover1 257:7a50601356cc 131
rgrover1 257:7a50601356cc 132 /**
rgrover1 257:7a50601356cc 133 * Reset any advertising payload prepared from prior calls to
rgrover1 257:7a50601356cc 134 * accumulateAdvertisingPayload().
rgrover1 257:7a50601356cc 135 */
rgrover1 257:7a50601356cc 136 void clearAdvertisingPayload(void);
rgrover1 257:7a50601356cc 137
rgrover1 257:7a50601356cc 138 /**
rgrover1 257:7a50601356cc 139 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 140 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 141 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 142 * small.
rgrover1 257:7a50601356cc 143 *
rgrover1 257:7a50601356cc 144 * @param flags
rgrover1 257:7a50601356cc 145 * The flags to be added. Multiple flags may be specified in
rgrover1 257:7a50601356cc 146 * combination.
rgrover1 257:7a50601356cc 147 */
rgrover1 257:7a50601356cc 148 ble_error_t accumulateAdvertisingPayload(uint8_t flags);
rgrover1 257:7a50601356cc 149
rgrover1 257:7a50601356cc 150 /**
rgrover1 257:7a50601356cc 151 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 152 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 153 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 154 * small.
rgrover1 257:7a50601356cc 155 *
rgrover1 257:7a50601356cc 156 * @param app
rgrover1 257:7a50601356cc 157 * The appearance of the peripheral.
rgrover1 257:7a50601356cc 158 */
rgrover1 257:7a50601356cc 159 ble_error_t accumulateAdvertisingPayload(GapAdvertisingData::Appearance app);
rgrover1 257:7a50601356cc 160
rgrover1 257:7a50601356cc 161 /**
rgrover1 257:7a50601356cc 162 * Accumulate an AD structure in the advertising payload. Please note that
rgrover1 257:7a50601356cc 163 * the payload is limited to 31 bytes. The SCAN_RESPONSE message may be used
rgrover1 257:7a50601356cc 164 * as an additional 31 bytes if the advertising payload proves to be too
rgrover1 257:7a50601356cc 165 * small.
rgrover1 257:7a50601356cc 166 *
rgrover1 257:7a50601356cc 167 * @param app
rgrover1 257:7a50601356cc 168 * The max transmit power to be used by the controller. This is
rgrover1 257:7a50601356cc 169 * only a hint.
rgrover1 257:7a50601356cc 170 */
rgrover1 257:7a50601356cc 171 ble_error_t accumulateAdvertisingPayloadTxPower(int8_t power);
rgrover1 257:7a50601356cc 172
rgrover1 257:7a50601356cc 173 /**
rgrover1 257:7a50601356cc 174 * Accumulate a variable length byte-stream as an AD structure in the
rgrover1 257:7a50601356cc 175 * advertising payload. Please note that the payload is limited to 31 bytes.
rgrover1 257:7a50601356cc 176 * The SCAN_RESPONSE message may be used as an additional 31 bytes if the
rgrover1 257:7a50601356cc 177 * advertising payload proves to be too small.
rgrover1 257:7a50601356cc 178 *
rgrover1 257:7a50601356cc 179 * @param type The type which describes the variable length data.
rgrover1 257:7a50601356cc 180 * @param data data bytes.
rgrover1 257:7a50601356cc 181 * @param len length of data.
rgrover1 257:7a50601356cc 182 */
rgrover1 257:7a50601356cc 183 ble_error_t accumulateAdvertisingPayload(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len);
rgrover1 257:7a50601356cc 184
rgrover1 257:7a50601356cc 185 /**
rgrover1 257:7a50601356cc 186 * Accumulate a variable length byte-stream as an AD structure in the
rgrover1 257:7a50601356cc 187 * scanResponse payload.
rgrover1 257:7a50601356cc 188 *
rgrover1 257:7a50601356cc 189 * @param type The type which describes the variable length data.
rgrover1 257:7a50601356cc 190 * @param data data bytes.
rgrover1 257:7a50601356cc 191 * @param len length of data.
rgrover1 257:7a50601356cc 192 */
rgrover1 257:7a50601356cc 193 ble_error_t accumulateScanResponse(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len);
rgrover1 257:7a50601356cc 194
rgrover1 257:7a50601356cc 195 /**
rgrover1 257:7a50601356cc 196 * Start advertising (GAP Discoverable, Connectable modes, Broadcast
rgrover1 257:7a50601356cc 197 * Procedure).
rgrover1 257:7a50601356cc 198 */
rgrover1 257:7a50601356cc 199 ble_error_t startAdvertising(void);
rgrover1 257:7a50601356cc 200
rgrover1 257:7a50601356cc 201 /**
rgrover1 257:7a50601356cc 202 * Stop advertising (GAP Discoverable, Connectable modes, Broadcast
rgrover1 257:7a50601356cc 203 * Procedure).
rgrover1 257:7a50601356cc 204 */
rgrover1 257:7a50601356cc 205 ble_error_t stopAdvertising(void);
rgrover1 257:7a50601356cc 206
rgrover1 257:7a50601356cc 207 ble_error_t disconnect(Gap::DisconnectionReason_t reason);
rgrover1 257:7a50601356cc 208
rgrover1 257:7a50601356cc 209 /* APIs to set GAP callbacks. */
rgrover1 257:7a50601356cc 210 void onTimeout(Gap::EventCallback_t timeoutCallback);
rgrover1 257:7a50601356cc 211
rgrover1 257:7a50601356cc 212 void onConnection(Gap::ConnectionEventCallback_t connectionCallback);
rgrover1 257:7a50601356cc 213 /**
rgrover1 257:7a50601356cc 214 * Used to setup a callback for GAP disconnection.
rgrover1 257:7a50601356cc 215 */
rgrover1 257:7a50601356cc 216 void onDisconnection(Gap::DisconnectionEventCallback_t disconnectionCallback);
rgrover1 257:7a50601356cc 217
rgrover1 257:7a50601356cc 218 /**
rgrover1 257:7a50601356cc 219 * Append to a chain of callbacks to be invoked upon disconnection; these
rgrover1 257:7a50601356cc 220 * callbacks receive no context and are therefore different from the
rgrover1 257:7a50601356cc 221 * onDisconnection callback.
rgrover1 257:7a50601356cc 222 */
rgrover1 257:7a50601356cc 223 template<typename T>
rgrover1 257:7a50601356cc 224 void addToDisconnectionCallChain(T *tptr, void (T::*mptr)(void));
rgrover1 257:7a50601356cc 225
rgrover1 257:7a50601356cc 226 /**
rgrover1 261:b275bfc773b9 227 * Add a callback for the GATT event DATA_SENT (which is triggered when
rgrover1 261:b275bfc773b9 228 * updates are sent out by GATT in the form of notifications).
rgrover1 259:a95264ad705c 229 *
rgrover1 259:a95264ad705c 230 * @Note: it is possible to chain together multiple onDataSent callbacks
rgrover1 259:a95264ad705c 231 * (potentially from different modules of an application) to receive updates
rgrover1 260:ea7f9f14cc15 232 * to characteristics.
rgrover1 259:a95264ad705c 233 *
rgrover1 259:a95264ad705c 234 * @Note: it is also possible to setup a callback into a member function of
rgrover1 259:a95264ad705c 235 * some object.
rgrover1 257:7a50601356cc 236 */
rgrover1 259:a95264ad705c 237 void onDataSent(void (*callback)(unsigned count));
rgrover1 259:a95264ad705c 238 template <typename T> void onDataSent(T * objPtr, void (T::*memberPtr)(unsigned count));
rgrover1 257:7a50601356cc 239
rgrover1 257:7a50601356cc 240 /**
rgrover1 257:7a50601356cc 241 * Setup a callback for when a characteristic has its value updated by a
rgrover1 257:7a50601356cc 242 * client.
rgrover1 257:7a50601356cc 243 *
rgrover1 257:7a50601356cc 244 * @Note: it is possible to chain together multiple onDataWritten callbacks
rgrover1 257:7a50601356cc 245 * (potentially from different modules of an application) to receive updates
rgrover1 257:7a50601356cc 246 * to characteristics. Many services, such as DFU and UART add their own
rgrover1 257:7a50601356cc 247 * onDataWritten callbacks behind the scenes to trap interesting events.
rgrover1 257:7a50601356cc 248 *
rgrover1 257:7a50601356cc 249 * @Note: it is also possible to setup a callback into a member function of
rgrover1 257:7a50601356cc 250 * some object.
rgrover1 257:7a50601356cc 251 */
rgrover1 257:7a50601356cc 252 void onDataWritten(void (*callback)(const GattCharacteristicWriteCBParams *eventDataP));
rgrover1 257:7a50601356cc 253 template <typename T> void onDataWritten(T * objPtr, void (T::*memberPtr)(const GattCharacteristicWriteCBParams *context));
rgrover1 257:7a50601356cc 254
rgrover1 257:7a50601356cc 255 void onUpdatesEnabled(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 256 void onUpdatesDisabled(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 257 void onConfirmationReceived(GattServer::EventCallback_t callback);
rgrover1 257:7a50601356cc 258
rgrover1 257:7a50601356cc 259 /**
rgrover1 257:7a50601356cc 260 * Add a service declaration to the local server ATT table. Also add the
rgrover1 257:7a50601356cc 261 * characteristics contained within.
rgrover1 257:7a50601356cc 262 */
rgrover1 257:7a50601356cc 263 ble_error_t addService(GattService &service);
rgrover1 257:7a50601356cc 264
rgrover1 257:7a50601356cc 265 Gap::GapState_t getGapState(void) const;
rgrover1 257:7a50601356cc 266
rgrover1 257:7a50601356cc 267 /**
rgrover1 257:7a50601356cc 268 * @param[in/out] lengthP
rgrover1 257:7a50601356cc 269 * input: Length in bytes to be read,
rgrover1 257:7a50601356cc 270 * output: Total length of attribute value upon successful return.
rgrover1 257:7a50601356cc 271 */
rgrover1 257:7a50601356cc 272 ble_error_t readCharacteristicValue(uint16_t handle, uint8_t *const buffer, uint16_t *const lengthP);
rgrover1 257:7a50601356cc 273
rgrover1 257:7a50601356cc 274 /**
rgrover1 257:7a50601356cc 275 * @param localOnly
rgrover1 257:7a50601356cc 276 * Only update the characteristic locally regardless of notify/indicate flags in the CCCD.
rgrover1 257:7a50601356cc 277 */
rgrover1 257:7a50601356cc 278 ble_error_t updateCharacteristicValue(uint16_t handle, const uint8_t *value, uint16_t size, bool localOnly = false);
rgrover1 257:7a50601356cc 279
rgrover1 257:7a50601356cc 280 /**
rgrover1 257:7a50601356cc 281 * Yield control to the BLE stack or to other tasks waiting for events. This
rgrover1 257:7a50601356cc 282 * is a sleep function which will return when there is an application
rgrover1 257:7a50601356cc 283 * specific interrupt, but the MCU might wake up several times before
rgrover1 257:7a50601356cc 284 * returning (to service the stack). This is not always interchangeable with
rgrover1 257:7a50601356cc 285 * WFE().
rgrover1 257:7a50601356cc 286 */
rgrover1 257:7a50601356cc 287 void waitForEvent(void);
rgrover1 257:7a50601356cc 288
rgrover1 257:7a50601356cc 289 ble_error_t getPreferredConnectionParams(Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 290 ble_error_t setPreferredConnectionParams(const Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 291 ble_error_t updateConnectionParams(Gap::Handle_t handle, const Gap::ConnectionParams_t *params);
rgrover1 257:7a50601356cc 292
rgrover1 257:7a50601356cc 293 /**
rgrover1 257:7a50601356cc 294 * This call allows the application to get the BLE stack version information.
rgrover1 257:7a50601356cc 295 *
rgrover1 257:7a50601356cc 296 * @return A pointer to a const string representing the version.
rgrover1 257:7a50601356cc 297 * Note: The string is owned by the BLE_API.
rgrover1 257:7a50601356cc 298 */
rgrover1 257:7a50601356cc 299 const char *getVersion(void);
rgrover1 257:7a50601356cc 300
rgrover1 257:7a50601356cc 301 /**
rgrover1 257:7a50601356cc 302 * Set the device name characteristic in the GAP service.
rgrover1 257:7a50601356cc 303 * @param deviceName The new value for the device-name. This is a UTF-8 encoded, <b>NULL-terminated</b> string.
rgrover1 257:7a50601356cc 304 */
rgrover1 257:7a50601356cc 305 ble_error_t setDeviceName(const uint8_t *deviceName);
rgrover1 257:7a50601356cc 306
rgrover1 257:7a50601356cc 307 /**
rgrover1 257:7a50601356cc 308 * Get the value of the device name characteristic in the GAP service.
rgrover1 257:7a50601356cc 309 * @param[out] deviceName Pointer to an empty buffer where the UTF-8 *non NULL-
rgrover1 257:7a50601356cc 310 * terminated* string will be placed. Set this
rgrover1 257:7a50601356cc 311 * value to NULL in order to obtain the deviceName-length
rgrover1 257:7a50601356cc 312 * from the 'length' parameter.
rgrover1 257:7a50601356cc 313 *
rgrover1 257:7a50601356cc 314 * @param[in/out] lengthP (on input) Length of the buffer pointed to by deviceName;
rgrover1 257:7a50601356cc 315 * (on output) the complete device name length (without the
rgrover1 257:7a50601356cc 316 * null terminator).
rgrover1 257:7a50601356cc 317 *
rgrover1 257:7a50601356cc 318 * @note If the device name is longer than the size of the supplied buffer,
rgrover1 257:7a50601356cc 319 * length will return the complete device name length,
rgrover1 257:7a50601356cc 320 * and not the number of bytes actually returned in deviceName.
rgrover1 257:7a50601356cc 321 * The application may use this information to retry with a suitable buffer size.
rgrover1 257:7a50601356cc 322 *
rgrover1 257:7a50601356cc 323 * Sample use:
rgrover1 257:7a50601356cc 324 * uint8_t deviceName[20];
rgrover1 257:7a50601356cc 325 * unsigned length = sizeof(deviceName);
rgrover1 257:7a50601356cc 326 * ble.getDeviceName(deviceName, &length);
rgrover1 257:7a50601356cc 327 * if (length < sizeof(deviceName)) {
rgrover1 257:7a50601356cc 328 * deviceName[length] = 0;
rgrover1 257:7a50601356cc 329 * }
rgrover1 257:7a50601356cc 330 * DEBUG("length: %u, deviceName: %s\r\n", length, deviceName);
rgrover1 257:7a50601356cc 331 */
rgrover1 257:7a50601356cc 332 ble_error_t getDeviceName(uint8_t *deviceName, unsigned *lengthP);
rgrover1 257:7a50601356cc 333
rgrover1 257:7a50601356cc 334 /**
rgrover1 257:7a50601356cc 335 * Set the appearance characteristic in the GAP service.
rgrover1 257:7a50601356cc 336 * @param[in] appearance The new value for the device-appearance.
rgrover1 257:7a50601356cc 337 */
rgrover1 257:7a50601356cc 338 ble_error_t setAppearance(uint16_t appearance);
rgrover1 257:7a50601356cc 339
rgrover1 257:7a50601356cc 340 /**
rgrover1 257:7a50601356cc 341 * Set the appearance characteristic in the GAP service.
rgrover1 257:7a50601356cc 342 * @param[out] appearance The new value for the device-appearance.
rgrover1 257:7a50601356cc 343 */
rgrover1 257:7a50601356cc 344 ble_error_t getAppearance(uint16_t *appearanceP);
rgrover1 257:7a50601356cc 345
rgrover1 257:7a50601356cc 346 /**
rgrover1 257:7a50601356cc 347 * Set the radio's transmit power.
rgrover1 257:7a50601356cc 348 * @param[in] txPower Radio transmit power in dBm.
rgrover1 257:7a50601356cc 349 */
rgrover1 257:7a50601356cc 350 ble_error_t setTxPower(int8_t txPower);
rgrover1 257:7a50601356cc 351
rgrover1 257:7a50601356cc 352 public:
rgrover1 257:7a50601356cc 353 BLEDevice() : transport(createBLEDeviceInstance()), advParams(), advPayload(), scanResponse(), needToSetAdvPayload(true) {
rgrover1 257:7a50601356cc 354 advPayload.clear();
rgrover1 257:7a50601356cc 355 scanResponse.clear();
rgrover1 257:7a50601356cc 356 }
rgrover1 257:7a50601356cc 357
rgrover1 257:7a50601356cc 358 private:
rgrover1 257:7a50601356cc 359 BLEDeviceInstanceBase *const transport; /* the device specific backend */
rgrover1 257:7a50601356cc 360
rgrover1 257:7a50601356cc 361 GapAdvertisingParams advParams;
rgrover1 257:7a50601356cc 362 GapAdvertisingData advPayload;
rgrover1 257:7a50601356cc 363 GapAdvertisingData scanResponse;
rgrover1 257:7a50601356cc 364
rgrover1 257:7a50601356cc 365 /* Accumulation of AD structures in the advertisement payload should
rgrover1 257:7a50601356cc 366 * eventually result in a call to the target's setAdvertisingData() before
rgrover1 257:7a50601356cc 367 * the server begins advertising. This flag marks the status of the pending update.*/
rgrover1 257:7a50601356cc 368 bool needToSetAdvPayload;
rgrover1 257:7a50601356cc 369
rgrover1 257:7a50601356cc 370 /**
rgrover1 257:7a50601356cc 371 * DEPRECATED
rgrover1 257:7a50601356cc 372 */
rgrover1 257:7a50601356cc 373 public:
rgrover1 257:7a50601356cc 374 ble_error_t setAdvertisingData(const GapAdvertisingData &ADStructures, const GapAdvertisingData &scanResponse);
rgrover1 257:7a50601356cc 375 ble_error_t setAdvertisingData(const GapAdvertisingData &ADStructures);
rgrover1 257:7a50601356cc 376
rgrover1 257:7a50601356cc 377 ble_error_t startAdvertising(const GapAdvertisingParams &advParams);
rgrover1 257:7a50601356cc 378 };
rgrover1 257:7a50601356cc 379
rgrover1 257:7a50601356cc 380 /* BLEDevice methods. Most of these simply forward the calls to the underlying
rgrover1 257:7a50601356cc 381 * transport.*/
rgrover1 257:7a50601356cc 382
rgrover1 257:7a50601356cc 383 inline ble_error_t
rgrover1 257:7a50601356cc 384 BLEDevice::reset(void)
rgrover1 257:7a50601356cc 385 {
rgrover1 257:7a50601356cc 386 return transport->reset();
rgrover1 257:7a50601356cc 387 }
rgrover1 257:7a50601356cc 388
rgrover1 257:7a50601356cc 389 inline ble_error_t
rgrover1 257:7a50601356cc 390 BLEDevice::shutdown(void)
rgrover1 257:7a50601356cc 391 {
rgrover1 257:7a50601356cc 392 clearAdvertisingPayload();
rgrover1 257:7a50601356cc 393 return transport->shutdown();
rgrover1 257:7a50601356cc 394 }
rgrover1 257:7a50601356cc 395
rgrover1 257:7a50601356cc 396 inline ble_error_t
rgrover1 257:7a50601356cc 397 BLEDevice::setAddress(Gap::addr_type_t type, const Gap::address_t address)
rgrover1 257:7a50601356cc 398 {
rgrover1 257:7a50601356cc 399 return transport->getGap().setAddress(type, address);
rgrover1 257:7a50601356cc 400 }
rgrover1 257:7a50601356cc 401
rgrover1 257:7a50601356cc 402 inline ble_error_t
rgrover1 257:7a50601356cc 403 BLEDevice::getAddress(Gap::addr_type_t *typeP, Gap::address_t address)
rgrover1 257:7a50601356cc 404 {
rgrover1 257:7a50601356cc 405 return transport->getGap().getAddress(typeP, address);
rgrover1 257:7a50601356cc 406 }
rgrover1 257:7a50601356cc 407
rgrover1 257:7a50601356cc 408 inline void
rgrover1 257:7a50601356cc 409 BLEDevice::setAdvertisingType(GapAdvertisingParams::AdvertisingType advType)
rgrover1 257:7a50601356cc 410 {
rgrover1 257:7a50601356cc 411 advParams.setAdvertisingType(advType);
rgrover1 257:7a50601356cc 412 }
rgrover1 257:7a50601356cc 413
rgrover1 257:7a50601356cc 414 inline void
rgrover1 257:7a50601356cc 415 BLEDevice::setAdvertisingInterval(uint16_t interval)
rgrover1 257:7a50601356cc 416 {
rgrover1 257:7a50601356cc 417 advParams.setInterval(interval);
rgrover1 257:7a50601356cc 418 }
rgrover1 257:7a50601356cc 419
rgrover1 257:7a50601356cc 420 inline void
rgrover1 257:7a50601356cc 421 BLEDevice::setAdvertisingTimeout(uint16_t timeout)
rgrover1 257:7a50601356cc 422 {
rgrover1 257:7a50601356cc 423 advParams.setTimeout(timeout);
rgrover1 257:7a50601356cc 424 }
rgrover1 257:7a50601356cc 425
rgrover1 257:7a50601356cc 426 inline void
rgrover1 257:7a50601356cc 427 BLEDevice::setAdvertisingParams(const GapAdvertisingParams &newAdvParams)
rgrover1 257:7a50601356cc 428 {
rgrover1 257:7a50601356cc 429 advParams = newAdvParams;
rgrover1 257:7a50601356cc 430 }
rgrover1 257:7a50601356cc 431
rgrover1 257:7a50601356cc 432 inline void
rgrover1 257:7a50601356cc 433 BLEDevice::clearAdvertisingPayload(void)
rgrover1 257:7a50601356cc 434 {
rgrover1 257:7a50601356cc 435 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 436 advPayload.clear();
rgrover1 257:7a50601356cc 437 }
rgrover1 257:7a50601356cc 438
rgrover1 257:7a50601356cc 439 inline ble_error_t
rgrover1 257:7a50601356cc 440 BLEDevice::accumulateAdvertisingPayload(uint8_t flags)
rgrover1 257:7a50601356cc 441 {
rgrover1 257:7a50601356cc 442 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 443 return advPayload.addFlags(flags);
rgrover1 257:7a50601356cc 444 }
rgrover1 257:7a50601356cc 445
rgrover1 257:7a50601356cc 446 inline ble_error_t
rgrover1 257:7a50601356cc 447 BLEDevice::accumulateAdvertisingPayload(GapAdvertisingData::Appearance app)
rgrover1 257:7a50601356cc 448 {
rgrover1 257:7a50601356cc 449 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 450 transport->getGap().setAppearance(app);
rgrover1 257:7a50601356cc 451 return advPayload.addAppearance(app);
rgrover1 257:7a50601356cc 452 }
rgrover1 257:7a50601356cc 453
rgrover1 257:7a50601356cc 454 inline ble_error_t
rgrover1 257:7a50601356cc 455 BLEDevice::accumulateAdvertisingPayloadTxPower(int8_t txPower)
rgrover1 257:7a50601356cc 456 {
rgrover1 257:7a50601356cc 457 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 458 return advPayload.addTxPower(txPower);
rgrover1 257:7a50601356cc 459 }
rgrover1 257:7a50601356cc 460
rgrover1 257:7a50601356cc 461 inline ble_error_t
rgrover1 257:7a50601356cc 462 BLEDevice::accumulateAdvertisingPayload(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len)
rgrover1 257:7a50601356cc 463 {
rgrover1 257:7a50601356cc 464 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 465 if (type == GapAdvertisingData::COMPLETE_LOCAL_NAME) {
rgrover1 257:7a50601356cc 466 transport->getGap().setDeviceName(data);
rgrover1 257:7a50601356cc 467 }
rgrover1 257:7a50601356cc 468 return advPayload.addData(type, data, len);
rgrover1 257:7a50601356cc 469 }
rgrover1 257:7a50601356cc 470
rgrover1 257:7a50601356cc 471 inline ble_error_t
rgrover1 257:7a50601356cc 472 BLEDevice::accumulateScanResponse(GapAdvertisingData::DataType type, const uint8_t *data, uint8_t len)
rgrover1 257:7a50601356cc 473 {
rgrover1 257:7a50601356cc 474 needToSetAdvPayload = true;
rgrover1 257:7a50601356cc 475 return scanResponse.addData(type, data, len);
rgrover1 257:7a50601356cc 476 }
rgrover1 257:7a50601356cc 477
rgrover1 257:7a50601356cc 478 inline ble_error_t
rgrover1 257:7a50601356cc 479 BLEDevice::setAdvertisingPayload(void) {
rgrover1 257:7a50601356cc 480 needToSetAdvPayload = false;
rgrover1 257:7a50601356cc 481 return transport->getGap().setAdvertisingData(advPayload, scanResponse);
rgrover1 257:7a50601356cc 482 }
rgrover1 257:7a50601356cc 483
rgrover1 257:7a50601356cc 484 inline ble_error_t
rgrover1 257:7a50601356cc 485 BLEDevice::startAdvertising(void)
rgrover1 257:7a50601356cc 486 {
rgrover1 257:7a50601356cc 487 ble_error_t rc;
rgrover1 257:7a50601356cc 488 if ((rc = transport->getGattServer().initializeGATTDatabase()) != BLE_ERROR_NONE) {
rgrover1 257:7a50601356cc 489 return rc;
rgrover1 257:7a50601356cc 490 }
rgrover1 257:7a50601356cc 491 if (needToSetAdvPayload) {
rgrover1 257:7a50601356cc 492 if ((rc = setAdvertisingPayload()) != BLE_ERROR_NONE) {
rgrover1 257:7a50601356cc 493 return rc;
rgrover1 257:7a50601356cc 494 }
rgrover1 257:7a50601356cc 495 }
rgrover1 257:7a50601356cc 496
rgrover1 257:7a50601356cc 497 return transport->getGap().startAdvertising(advParams);
rgrover1 257:7a50601356cc 498 }
rgrover1 257:7a50601356cc 499
rgrover1 257:7a50601356cc 500 inline ble_error_t
rgrover1 257:7a50601356cc 501 BLEDevice::stopAdvertising(void)
rgrover1 257:7a50601356cc 502 {
rgrover1 257:7a50601356cc 503 return transport->getGap().stopAdvertising();
rgrover1 257:7a50601356cc 504 }
rgrover1 257:7a50601356cc 505
rgrover1 257:7a50601356cc 506 inline ble_error_t
rgrover1 257:7a50601356cc 507 BLEDevice::disconnect(Gap::DisconnectionReason_t reason)
rgrover1 257:7a50601356cc 508 {
rgrover1 257:7a50601356cc 509 return transport->getGap().disconnect(reason);
rgrover1 257:7a50601356cc 510 }
rgrover1 257:7a50601356cc 511
rgrover1 257:7a50601356cc 512 inline void
rgrover1 257:7a50601356cc 513 BLEDevice::onTimeout(Gap::EventCallback_t timeoutCallback)
rgrover1 257:7a50601356cc 514 {
rgrover1 257:7a50601356cc 515 transport->getGap().setOnTimeout(timeoutCallback);
rgrover1 257:7a50601356cc 516 }
rgrover1 257:7a50601356cc 517
rgrover1 257:7a50601356cc 518 inline void
rgrover1 257:7a50601356cc 519 BLEDevice::onConnection(Gap::ConnectionEventCallback_t connectionCallback)
rgrover1 257:7a50601356cc 520 {
rgrover1 257:7a50601356cc 521 transport->getGap().setOnConnection(connectionCallback);
rgrover1 257:7a50601356cc 522 }
rgrover1 257:7a50601356cc 523
rgrover1 257:7a50601356cc 524 inline void
rgrover1 257:7a50601356cc 525 BLEDevice::onDisconnection(Gap::DisconnectionEventCallback_t disconnectionCallback)
rgrover1 257:7a50601356cc 526 {
rgrover1 257:7a50601356cc 527 transport->getGap().setOnDisconnection(disconnectionCallback);
rgrover1 257:7a50601356cc 528 }
rgrover1 257:7a50601356cc 529
rgrover1 257:7a50601356cc 530 template<typename T>
rgrover1 257:7a50601356cc 531 inline void
rgrover1 257:7a50601356cc 532 BLEDevice::addToDisconnectionCallChain(T *tptr, void (T::*mptr)(void)) {
rgrover1 257:7a50601356cc 533 transport->getGap().addToDisconnectionCallChain(tptr, mptr);
rgrover1 257:7a50601356cc 534 }
rgrover1 257:7a50601356cc 535
rgrover1 257:7a50601356cc 536 inline void
rgrover1 259:a95264ad705c 537 BLEDevice::onDataSent(void (*callback)(unsigned count)) {
rgrover1 257:7a50601356cc 538 transport->getGattServer().setOnDataSent(callback);
rgrover1 257:7a50601356cc 539 }
rgrover1 257:7a50601356cc 540
rgrover1 259:a95264ad705c 541 template <typename T> inline void
rgrover1 259:a95264ad705c 542 BLEDevice::onDataSent(T *objPtr, void (T::*memberPtr)(unsigned count)) {
rgrover1 259:a95264ad705c 543 transport->getGattServer().setOnDataSent(objPtr, memberPtr);
rgrover1 259:a95264ad705c 544 }
rgrover1 259:a95264ad705c 545
rgrover1 257:7a50601356cc 546 inline void
rgrover1 257:7a50601356cc 547 BLEDevice::onDataWritten(void (*callback)(const GattCharacteristicWriteCBParams *eventDataP)) {
rgrover1 257:7a50601356cc 548 transport->getGattServer().setOnDataWritten(callback);
rgrover1 257:7a50601356cc 549 }
rgrover1 257:7a50601356cc 550
rgrover1 257:7a50601356cc 551 template <typename T> inline void
rgrover1 257:7a50601356cc 552 BLEDevice::onDataWritten(T *objPtr, void (T::*memberPtr)(const GattCharacteristicWriteCBParams *context)) {
rgrover1 257:7a50601356cc 553 transport->getGattServer().setOnDataWritten(objPtr, memberPtr);
rgrover1 257:7a50601356cc 554 }
rgrover1 257:7a50601356cc 555
rgrover1 257:7a50601356cc 556 inline void
rgrover1 257:7a50601356cc 557 BLEDevice::onUpdatesEnabled(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 558 {
rgrover1 257:7a50601356cc 559 transport->getGattServer().setOnUpdatesEnabled(callback);
rgrover1 257:7a50601356cc 560 }
rgrover1 257:7a50601356cc 561
rgrover1 257:7a50601356cc 562 inline void
rgrover1 257:7a50601356cc 563 BLEDevice::onUpdatesDisabled(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 564 {
rgrover1 257:7a50601356cc 565 transport->getGattServer().setOnUpdatesDisabled(callback);
rgrover1 257:7a50601356cc 566 }
rgrover1 257:7a50601356cc 567
rgrover1 257:7a50601356cc 568 inline void
rgrover1 257:7a50601356cc 569 BLEDevice::onConfirmationReceived(GattServer::EventCallback_t callback)
rgrover1 257:7a50601356cc 570 {
rgrover1 257:7a50601356cc 571 transport->getGattServer().setOnConfirmationReceived(callback);
rgrover1 257:7a50601356cc 572 }
rgrover1 257:7a50601356cc 573
rgrover1 257:7a50601356cc 574 inline ble_error_t
rgrover1 257:7a50601356cc 575 BLEDevice::addService(GattService &service)
rgrover1 257:7a50601356cc 576 {
rgrover1 257:7a50601356cc 577 return transport->getGattServer().addService(service);
rgrover1 257:7a50601356cc 578 }
rgrover1 257:7a50601356cc 579
rgrover1 257:7a50601356cc 580 inline Gap::GapState_t
rgrover1 257:7a50601356cc 581 BLEDevice::getGapState(void) const
rgrover1 257:7a50601356cc 582 {
rgrover1 257:7a50601356cc 583 return transport->getGap().getState();
rgrover1 257:7a50601356cc 584 }
rgrover1 257:7a50601356cc 585
rgrover1 257:7a50601356cc 586 inline ble_error_t BLEDevice::readCharacteristicValue(uint16_t handle, uint8_t *const buffer, uint16_t *const lengthP)
rgrover1 257:7a50601356cc 587 {
rgrover1 257:7a50601356cc 588 return transport->getGattServer().readValue(handle, buffer, lengthP);
rgrover1 257:7a50601356cc 589 }
rgrover1 257:7a50601356cc 590
rgrover1 257:7a50601356cc 591 inline ble_error_t
rgrover1 257:7a50601356cc 592 BLEDevice::updateCharacteristicValue(uint16_t handle, const uint8_t *value, uint16_t size, bool localOnly)
rgrover1 257:7a50601356cc 593 {
rgrover1 257:7a50601356cc 594 return transport->getGattServer().updateValue(handle, const_cast<uint8_t *>(value), size, localOnly);
rgrover1 257:7a50601356cc 595 }
rgrover1 257:7a50601356cc 596
rgrover1 257:7a50601356cc 597 inline void
rgrover1 257:7a50601356cc 598 BLEDevice::waitForEvent(void)
rgrover1 257:7a50601356cc 599 {
rgrover1 257:7a50601356cc 600 transport->waitForEvent();
rgrover1 257:7a50601356cc 601 }
rgrover1 257:7a50601356cc 602
rgrover1 257:7a50601356cc 603 inline ble_error_t
rgrover1 257:7a50601356cc 604 BLEDevice::getPreferredConnectionParams(Gap::ConnectionParams_t *params)
rgrover1 257:7a50601356cc 605 {
rgrover1 257:7a50601356cc 606 return transport->getGap().getPreferredConnectionParams(params);
rgrover1 257:7a50601356cc 607 }
rgrover1 257:7a50601356cc 608
rgrover1 257:7a50601356cc 609 inline ble_error_t
rgrover1 257:7a50601356cc 610 BLEDevice::setPreferredConnectionParams(const Gap::ConnectionParams_t *params)
rgrover1 257:7a50601356cc 611 {
rgrover1 257:7a50601356cc 612 return transport->getGap().setPreferredConnectionParams(params);
rgrover1 257:7a50601356cc 613 }
rgrover1 257:7a50601356cc 614
rgrover1 257:7a50601356cc 615 inline ble_error_t
rgrover1 257:7a50601356cc 616 BLEDevice::updateConnectionParams(Gap::Handle_t handle, const Gap::ConnectionParams_t *params) {
rgrover1 257:7a50601356cc 617 return transport->getGap().updateConnectionParams(handle, params);
rgrover1 257:7a50601356cc 618 }
rgrover1 257:7a50601356cc 619
rgrover1 257:7a50601356cc 620 inline const char *
rgrover1 257:7a50601356cc 621 BLEDevice::getVersion(void)
rgrover1 257:7a50601356cc 622 {
rgrover1 257:7a50601356cc 623 return transport->getVersion();
rgrover1 257:7a50601356cc 624 }
rgrover1 257:7a50601356cc 625
rgrover1 257:7a50601356cc 626 inline ble_error_t
rgrover1 257:7a50601356cc 627 BLEDevice::setDeviceName(const uint8_t *deviceName)
rgrover1 257:7a50601356cc 628 {
rgrover1 257:7a50601356cc 629 return transport->getGap().setDeviceName(deviceName);
rgrover1 257:7a50601356cc 630 }
rgrover1 257:7a50601356cc 631
rgrover1 257:7a50601356cc 632 inline ble_error_t
rgrover1 257:7a50601356cc 633 BLEDevice::getDeviceName(uint8_t *deviceName, unsigned *lengthP)
rgrover1 257:7a50601356cc 634 {
rgrover1 257:7a50601356cc 635 return transport->getGap().getDeviceName(deviceName, lengthP);
rgrover1 257:7a50601356cc 636 }
rgrover1 257:7a50601356cc 637
rgrover1 257:7a50601356cc 638 inline ble_error_t
rgrover1 257:7a50601356cc 639 BLEDevice::setAppearance(uint16_t appearance)
rgrover1 257:7a50601356cc 640 {
rgrover1 257:7a50601356cc 641 return transport->getGap().setAppearance(appearance);
rgrover1 257:7a50601356cc 642 }
rgrover1 257:7a50601356cc 643
rgrover1 257:7a50601356cc 644 inline ble_error_t
rgrover1 257:7a50601356cc 645 BLEDevice::getAppearance(uint16_t *appearanceP)
rgrover1 257:7a50601356cc 646 {
rgrover1 257:7a50601356cc 647 return transport->getGap().getAppearance(appearanceP);
rgrover1 257:7a50601356cc 648 }
rgrover1 257:7a50601356cc 649
rgrover1 257:7a50601356cc 650 inline ble_error_t
rgrover1 257:7a50601356cc 651 BLEDevice::setTxPower(int8_t txPower)
rgrover1 257:7a50601356cc 652 {
rgrover1 257:7a50601356cc 653 return transport->setTxPower(txPower);
rgrover1 257:7a50601356cc 654 }
rgrover1 257:7a50601356cc 655
rgrover1 257:7a50601356cc 656 /*
rgrover1 257:7a50601356cc 657 * ALL OF THE FOLLOWING METHODS ARE DEPRECATED
rgrover1 257:7a50601356cc 658 */
rgrover1 257:7a50601356cc 659
rgrover1 257:7a50601356cc 660 inline ble_error_t
rgrover1 257:7a50601356cc 661 BLEDevice::setAdvertisingData(const GapAdvertisingData &ADStructures, const GapAdvertisingData &scanResponse)
rgrover1 257:7a50601356cc 662 {
rgrover1 257:7a50601356cc 663 needToSetAdvPayload = false;
rgrover1 257:7a50601356cc 664 return transport->getGap().setAdvertisingData(ADStructures, scanResponse);
rgrover1 257:7a50601356cc 665 }
rgrover1 257:7a50601356cc 666
rgrover1 257:7a50601356cc 667 inline ble_error_t
rgrover1 257:7a50601356cc 668 BLEDevice::setAdvertisingData(const GapAdvertisingData &ADStructures)
rgrover1 257:7a50601356cc 669 {
rgrover1 257:7a50601356cc 670 GapAdvertisingData scanResponse;
rgrover1 257:7a50601356cc 671
rgrover1 257:7a50601356cc 672 needToSetAdvPayload = false;
rgrover1 257:7a50601356cc 673 return transport->getGap().setAdvertisingData(ADStructures, scanResponse);
rgrover1 257:7a50601356cc 674 }
rgrover1 257:7a50601356cc 675
rgrover1 257:7a50601356cc 676 inline ble_error_t
rgrover1 257:7a50601356cc 677 BLEDevice::startAdvertising(const GapAdvertisingParams &_advParams)
rgrover1 257:7a50601356cc 678 {
rgrover1 257:7a50601356cc 679 return transport->getGap().startAdvertising(_advParams);
rgrover1 257:7a50601356cc 680 }
rgrover1 257:7a50601356cc 681
rgrover1 257:7a50601356cc 682 #endif // ifndef __BLE_DEVICE__