ble/Gap.h@1062:a3fd424b73ca, 2016-01-11 (annotated)

Committer:

vcoubard

Date:

Mon Jan 11 08:51:37 2016 +0000

Revision:

1062:a3fd424b73ca

Parent:

1056:ce2fb3d09929

Child:

1063:187f9929cb60

Synchronized with git rev b817cf3e

Author: Andres Amaya Garcia

Improve API to facilitate full shutdown procedure



The BLE API exposes a shutdown() function in BLE.h. This function is meant to

be overwridden by platform-specific sub-classes to clear all GAP and GATT

state. However, from the platform-specific implementation it is dificult to

achieve this because the Gap, GattClient, GattServer and SecurityManager

components of the API do not expose any functionality to shutdown.



This commit introduces the following changes:



* Add a static member pointer to Gap, GattClient, GattServer and

SecurityManager that is used to keep track of the initialized objects.

* Add a function member cleanup() to Gap, GattClient, GattServer and

SecurityManager to allow easy reset of the instance's state. This function

is meant to be overriden and called from the derived classes to fully clear the

state of the BLE API and the platform-specific implementation.

* Add a static member function shutdown() to Gap, GattClient, GattServer and

SecurityManager. This function shall be called from the shutdown()

overriding BLE::shutdown() for Gap, GattClient, GattServer and SecurityManager

that will in-turn clear the state of each of the components.



**NOTE:** Platform-specific implementations of this API must be modified to

this changes into account.

Who changed what in which revision?