add API BLEDevice::shutdown() to purge the BLE stack of GATT and GAP …

…state. init() should be called before restoring state. fixes #15.
ARMmbed · Dec 3, 2014 · 7e9f9a0 · 7e9f9a0
1 parent ac3a548
commit 7e9f9a0
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/common/BLEDeviceInstanceBase.h b/common/BLEDeviceInstanceBase.h
@@ -28,6 +28,7 @@ class BLEDeviceInstanceBase
     virtual Gap&        getGap()                   = 0;
     virtual GattServer& getGattServer()            = 0;
     virtual ble_error_t init(void)                 = 0;
+    virtual ble_error_t shutdown(void)             = 0;
     virtual ble_error_t reset(void)                = 0;
     virtual ble_error_t setTxPower(int8_t txPower) = 0;
     virtual void        waitForEvent(void)         = 0;

diff --git a/public/BLEDevice.h b/public/BLEDevice.h
@@ -36,6 +36,11 @@ class BLEDevice
     ble_error_t init();
     ble_error_t reset(void);
 
+    /**
+     * Purge the BLE stack of GATT and GAP state. init() must be called afterwards to re-instate services and GAP state.
+     */
+    ble_error_t shutdown(void);
+
     /* GAP specific APIs */
 public:
     /**
@@ -364,6 +369,13 @@ BLEDevice::reset(void)
     return transport->reset();
 }
 
+inline ble_error_t
+BLEDevice::shutdown(void)
+{
+    clearAdvertisingPayload();
+    return transport->shutdown();
+}
+
 inline ble_error_t
 BLEDevice::setAddress(Gap::addr_type_t type, const Gap::address_t address)
 {