Microbug / BLE_API_FOTA

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

Fork of BLE_API by Bluetooth Low Energy

Files at this revision

API Documentation at this revision

Revision 297:7036ac0bd496, committed 2015-03-02

Comitter:
rgrover1
Date:
Mon Mar 02 11:50:47 2015 +0000
Parent:
296:931da9973b89
Child:
298:8785a8af8106
Commit message:
Synchronized with git rev 616a43e1
Author: Rohit Grover
update comment header for onDataRead()

Changed in this revision

public/BLEDevice.h Show annotated file Show diff for this revision Revisions of this file 
--- a/public/BLEDevice.h	Mon Mar 02 11:50:47 2015 +0000
+++ b/public/BLEDevice.h	Mon Mar 02 11:50:47 2015 +0000
@@ -253,6 +253,10 @@
     /**
      * Setup a callback for when a characteristic is being read by a client.
      *
+     * @Note: this functionality may not be available on all underlying stacks.
+     * You could use GattCharacteristic::setReadAuthorizationCallback() as an
+     * alternative.
+     *
      * @Note: it is possible to chain together multiple onDataRead callbacks
      * (potentially from different modules of an application) to receive updates
      * to characteristics. Services may add their own onDataRead callbacks
@@ -260,6 +264,9 @@
      *
      * @Note: it is also possible to setup a callback into a member function of
      * some object.
+     *
+     * @return BLE_ERROR_NOT_IMPLEMENTED if this functionality isn't available;
+     *         else BLE_ERROR_NONE.
      */
     ble_error_t onDataRead(void (*callback)(const GattCharacteristicReadCBParams *eventDataP));
     template <typename T> ble_error_t onDataRead(T * objPtr, void (T::*memberPtr)(const GattCharacteristicReadCBParams *context));