Synchronized with git rev 80f44173

Author: Rohit Grover
Release 0.2.4
=============

Features
~~~~~~~~

* Introduce GattServer::initializeGattDatabase(). This populates the GATT
  server with added services.

* Add helper funcs: Gap::MSEC_TO_GAP_DURATION_UNITS() to ease setting up of
  connection parameters.

* Enhance connectionEventCallback() to take in peer addr information.

* Minor cleanup of a few public API classes and removal of unnecessary header-file includes.

Bugfixes
~~~~~~~~

* Increase GAP_ADV_PARAMS_INTERVAL_MAX to 0x4000. This addresses ARMmbed/ble/issues/2.

Compatibility
~~~~~~~~~~~~~

One new API has been added (GattServer::initializeGattDatabase()) and
Gap::ConnectionEventCallback_t has been extended. Applications depending on
these should be updated.

README.md

@@ -0,0 +1,18 @@
+# mbed Bluetooth Low Energy Stack
+This is the github repo for the BLE_API used by developer.mbed.org .  The BLE stack is under development and constantly evolving. For up to date documentation please see [the mbed BLE Documentation page](http://developer.mbed.org/teams/Bluetooth-Low-Energy/code/BLE_API/docs/tip/).  
+
+# Supported Services
+Supported GATT services and constantly being added and can be found in the /services folder.
+Currently supported  services include:
+* Battery 
+* Device Firmware Update (DFU)
+* Device Information 
+* Health Thermometer
+* Heart Rate
+* UART
+
+# Getting Started 
+The mbed BLE API is meant to be used in projects on developer.mbed.org. Please see examples and sample project files there. 
+A good starting point are these pages:
+* [mbed BLE API](developer.mbed.org/teams/Bluetooth-Low-Energy/)
+* [mbed BLE Getting Started Guide](http://developer.mbed.org/forum/team-63-Bluetooth-Low-Energy-community/topic/5262/)

common/blecommon.h

@@ -27,6 +27,7 @@ extern "C" {
 #endif
 
 #include <stdint.h>
+#include <stddef.h>
 
 /** @defgroup BLE_UUID_VALUES Assigned Values for BLE UUIDs
  * @{ */

public/BLEDevice.h

@@ -17,7 +17,6 @@
 #ifndef __BLE_DEVICE__
 #define __BLE_DEVICE__
 
-#include "mbed.h"
 #include "blecommon.h"
 #include "Gap.h"
 #include "GattServer.h"

public/CallChainOfFunctionPointersWithContext.h

@@ -19,15 +19,13 @@
 #include <string.h>
 #include "FunctionPointerWithContext.h"
 
-namespace mbed {
 
 /** Group one or more functions in an instance of a CallChainOfFunctionPointersWithContext, then call them in
  * sequence using CallChainOfFunctionPointersWithContext::call(). Used mostly by the interrupt chaining code,
  * but can be used for other purposes.
  *
  * Example:
  * @code
- * #include "mbed.h"
  *
  * CallChainOfFunctionPointersWithContext<void *> chain;
  *
@@ -148,6 +146,4 @@ class CallChainOfFunctionPointersWithContext {
     CallChainOfFunctionPointersWithContext & operator = (const CallChainOfFunctionPointersWithContext &);
 };
 
-} // namespace mbed
-
-#endif
+#endif

public/FunctionPointerWithContext.h

@@ -19,7 +19,6 @@
 
 #include <string.h>
 
-namespace mbed {
 
 /** A class for storing and calling a pointer to a static or member void function
  *  which takes a context.
@@ -126,6 +125,5 @@ class FunctionPointerWithContext {
                                                          *   external memory to manage the chain. Also refer to
                                                          *   'CallChain' as an alternative. */
 };
-} // namespace mbed
 
 #endif // ifndef MBED_FUNCTIONPOINTER_WITH_CONTEXT_H

public/GapEvents.h

@@ -18,7 +18,6 @@
 #define __GAP_EVENTS_H__
 
 #include "blecommon.h"
-#include "mbed.h"
 
 /**************************************************************************/
 /*!

public/GattServerEvents.h

@@ -18,7 +18,6 @@
 #define __GATT_SERVER_EVENTS_H__
 
 #include "blecommon.h"
-#include "mbed.h"
 
 /**************************************************************************/
 /*!

services/UARTService.h

@@ -17,6 +17,7 @@
 #ifndef __BLE_UART_SERVICE_H__
 #define __BLE_UART_SERVICE_H__
 
+#include "mbed.h"
 #include "Stream.h"
 
 #include "UUID.h"