Lancaster University
Lancaster University's fork of the mbed BLE API. Lives on github, https://github.com/lancaster-university/BLE_API
Dependents: microbit-dal microbit-dal microbit-ble-open microbit-dal ... more
Fork of
BLE_API
by 
Bluetooth Low Energy
Revision 737:79d95f9b93be, committed 2015-07-06
- Comitter:
- rgrover1
- Date:
- Mon Jul 06 10:10:35 2015 +0100
- Parent:
- 736:87c756801625
- Child:
- 738:9c2edf20ea56
- Commit message:
- Synchronized with git rev 0d55096d
Author: Rohit Grover
fix #53: add GattClient::onHVX() and GattHVXCallbackParams
Changed in this revision
--- a/ble/GattCallbackParamTypes.h Mon Jul 06 10:10:35 2015 +0100
+++ b/ble/GattCallbackParamTypes.h Mon Jul 06 10:10:35 2015 +0100
@@ -75,4 +75,12 @@
* request is to proceed; false otherwise. */
};
+/* For encapsulating handle-value update events (notifications or indications) generated at the remote server. */
+struct GattHVXCallbackParams {
+ GattAttribute::Handle_t handle; /**< Attribute Handle to which the HVx operation applies. */
+ HVXType_t type; /**< Indication or Notification, see @ref HVXType_t. */
+ uint16_t len; /**< Attribute data length. */
+ const uint8_t *data; /**< Attribute data, variable length. */
+};
+
#endif /*__GATT_CALLBACK_PARAM_TYPES_H__*/
\ No newline at end of file
--- a/ble/GattClient.h Mon Jul 06 10:10:35 2015 +0100
+++ b/ble/GattClient.h Mon Jul 06 10:10:35 2015 +0100
@@ -34,6 +34,8 @@
typedef void (*WriteCallback_t)(const GattWriteCallbackParams *params);
+ typedef void (*HVXCallback_t)(const GattHVXCallbackParams *params);
+
/*
* The following functions are meant to be overridden in the platform-specific sub-class.
*/
@@ -263,6 +265,15 @@
/* default implementation; override this API if this capability is supported. */
}
+ /**
+ * Setup a callback for when GattClient receives an update event
+ * corresponding to a change in value of a characteristic on the remote
+ * GattServer.
+ */
+ void onHVX(HVXCallback_t callback) {
+ onHVXCallback = callback;
+ }
+
protected:
GattClient() {
/* empty */
@@ -282,9 +293,16 @@
}
}
+ void processHVXEvent(const GattHVXCallbackParams *params) {
+ if (onHVXCallback) {
+ onHVXCallback(params);
+ }
+ }
+
protected:
ReadCallback_t onDataReadCallback;
WriteCallback_t onDataWriteCallback;
+ HVXCallback_t onHVXCallback;
private:
/* disallow copy and assignment */
--- a/ble/blecommon.h Mon Jul 06 10:10:35 2015 +0100
+++ b/ble/blecommon.h Mon Jul 06 10:10:35 2015 +0100
@@ -129,6 +129,11 @@
/** @brief Default MTU size. */
static const unsigned BLE_GATT_MTU_SIZE_DEFAULT = 23;
+enum HVXType_t {
+ BLE_HVX_NOTIFICATION = 0x01, /**< Handle Value Notification. */
+ BLE_HVX_INDICATION = 0x02, /**< Handle Value Indication. */
+};
+
#ifdef __cplusplus
}
#endif