Goran Mahovlic / nRF51822_BLE_MIDI

Dependents:   BLE_MIDI

Fork of nRF51822 by Nordic Semiconductor

nRF51822n.h@371:8f7d2137727a, 2015-07-06 (annotated)

Committer:
rgrover1
Date:
Mon Jul 06 10:13:27 2015 +0100
Revision:
371:8f7d2137727a
Parent:
370:295f76db798e 
Synchronized with git rev 2716309c

Author: Rohit Grover

Release 0.4.0

=============



This is a major release which introduces the GATT Client functionality. It

aligns with release 0.4.0 of BLE_API.



Enhancements

~~~~~~~~~~~~



* Introduce GattClient. This includes functionality for service-discovery,

  connections, and attribute-reads and writes. You'll find a demo program for

  LEDBlinker on the mbed.org Bluetooth team page to use the new APIs. Some of

  the GATT client functionality hasn't been implemented yet, but the APIs have

  been added.



* We've added an implementation for the abstract base class for

  SecurityManager. All security related APIs have been moved into that.



* There has been a major cleanup of APIs under BLE. APIs have now been

  categorized as belonging to Gap, GattServer, GattClient, or SecurityManager.

  There are accessors to get references for Gap, GattServer, GattClient, and

  SecurityManager. A former call to ble.setAddress(...) is now expected to be

  achieved with ble.gap().setAddress(...).



* We've cleaned up our APIs, and this has resulted in dropping some APIs like

  BLE::reset().



* We've also dropped GattServer::initializeGattDatabase(). THis was added at

  some point to support controllers where a commit point was needed to

  indicate when the application had finished constructing the GATT database.

  This API would get called internally before Gap::startAdvertising(). We now

  expect the underlying port to do the equivalent of initializeGattDatabase()

  implicitly upon Gap::startAdvertising().



* We've added a version of Gap::disconnect() which takes a connection handle.

  The previous API (which did not take a connection handle) has been

  deprecated; it will still work for situations where there's only a single

  active connection. We hold on to that API to allow existing code to migrate

  to the new API.



Bugfixes

~~~~~~~~



* None.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Rohit Grover 22:c6ee8136847e 1 /* mbed Microcontroller Library
Rohit Grover 22:c6ee8136847e 2 * Copyright (c) 2006-2013 ARM Limited
Rohit Grover 22:c6ee8136847e 3 *
Rohit Grover 22:c6ee8136847e 4 * Licensed under the Apache License, Version 2.0 (the "License");
Rohit Grover 22:c6ee8136847e 5 * you may not use this file except in compliance with the License.
Rohit Grover 22:c6ee8136847e 6 * You may obtain a copy of the License at
Rohit Grover 22:c6ee8136847e 7 *
Rohit Grover 22:c6ee8136847e 8 * http://www.apache.org/licenses/LICENSE-2.0
Rohit Grover 22:c6ee8136847e 9 *
Rohit Grover 22:c6ee8136847e 10 * Unless required by applicable law or agreed to in writing, software
Rohit Grover 22:c6ee8136847e 11 * distributed under the License is distributed on an "AS IS" BASIS,
Rohit Grover 22:c6ee8136847e 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Rohit Grover 22:c6ee8136847e 13 * See the License for the specific language governing permissions and
Rohit Grover 22:c6ee8136847e 14 * limitations under the License.
Rohit Grover 22:c6ee8136847e 15 */
Rohit Grover 22:c6ee8136847e 16
Rohit Grover 22:c6ee8136847e 17 #ifndef __NRF51822_H__
Rohit Grover 22:c6ee8136847e 18 #define __NRF51822_H__
Rohit Grover 22:c6ee8136847e 19
Rohit Grover 22:c6ee8136847e 20 #include "mbed.h"
rgrover1 371:8f7d2137727a 21 #include "ble/blecommon.h"
rgrover1 371:8f7d2137727a 22 #include "ble/BLE.h"
Rohit Grover 22:c6ee8136847e 23 #include "nRF51Gap.h"
Rohit Grover 22:c6ee8136847e 24 #include "nRF51GattServer.h"
rgrover1 371:8f7d2137727a 25 #include "nRF51GattClient.h"
rgrover1 371:8f7d2137727a 26 #include "nRF51SecurityManager.h"
rgrover1 127:bd1e1fe607e0 27 #include "btle.h"
Rohit Grover 22:c6ee8136847e 28
rgrover1 371:8f7d2137727a 29 class nRF51822n : public BLEInstanceBase
Rohit Grover 22:c6ee8136847e 30 {
Rohit Grover 22:c6ee8136847e 31 public:
Rohit Grover 22:c6ee8136847e 32 nRF51822n(void);
Rohit Grover 22:c6ee8136847e 33 virtual ~nRF51822n(void);
Rohit Grover 22:c6ee8136847e 34
rgrover1 371:8f7d2137727a 35 virtual ble_error_t init(void);
rgrover1 371:8f7d2137727a 36 virtual ble_error_t shutdown(void);
Rohit Grover 52:120bd37b9d0d 37 virtual const char *getVersion(void);
Rohit Grover 52:120bd37b9d0d 38
rgrover1 371:8f7d2137727a 39 virtual Gap &getGap() {
rgrover1 371:8f7d2137727a 40 return nRF51Gap::getInstance();
rgrover1 371:8f7d2137727a 41 };
rgrover1 371:8f7d2137727a 42 virtual const Gap &getGap() const {
rgrover1 350:09912ea7cedd 43 return nRF51Gap::getInstance();
rgrover1 350:09912ea7cedd 44 };
Rohit Grover 22:c6ee8136847e 45 virtual GattServer &getGattServer() {
Rohit Grover 22:c6ee8136847e 46 return nRF51GattServer::getInstance();
Rohit Grover 22:c6ee8136847e 47 };
rgrover1 371:8f7d2137727a 48 virtual const GattServer &getGattServer() const {
rgrover1 371:8f7d2137727a 49 return nRF51GattServer::getInstance();
rgrover1 371:8f7d2137727a 50 };
rgrover1 371:8f7d2137727a 51 virtual GattClient &getGattClient() {
rgrover1 371:8f7d2137727a 52 return nRF51GattClient::getInstance();
rgrover1 371:8f7d2137727a 53 }
rgrover1 371:8f7d2137727a 54 virtual const SecurityManager &getSecurityManager() const {
rgrover1 371:8f7d2137727a 55 return nRF51SecurityManager::getInstance();
rgrover1 371:8f7d2137727a 56 }
rgrover1 371:8f7d2137727a 57 virtual SecurityManager &getSecurityManager() {
rgrover1 371:8f7d2137727a 58 return nRF51SecurityManager::getInstance();
rgrover1 151:e093294d98fb 59 }
Rohit Grover 23:cdab28442479 60 virtual void waitForEvent(void);
Rohit Grover 22:c6ee8136847e 61 };
Rohit Grover 22:c6ee8136847e 62
rgrover1 80:cdcc094ab166 63 #endif