Patched version of nrf51822 FOTA compatible driver, with GPTIO disabled, as it clashed with the mbed definitions...

Fork of nRF51822 by Nordic Semiconductor

Committer:
Rohit Grover
Date:
Tue Sep 02 15:50:05 2014 +0100
Revision:
56:a1071b629aa3
Parent:
52:120bd37b9d0d
Child:
69:61da91a52bd6
Release 0.1.0
=============

We've achieved significant gains in power consumption: the BLE_Beacon demo now
runs at around 35uA of average current broadcasting once a second at 0dB; when
not using the radio, this demo consumes around 7uA.

Features
~~~~~~~~

- Replace initialization of high-frequency external crystal clock-source with
the use of low-frequency clock. This brings in significant gains in power
consumption.

- Re-implement the micro-second timer on nRF51 using the app_timer module
(which internally uses RTC). This limits the precision of the us_Timer to
30uS; but brings in significant gains in power consumption.

- Reduce the number of available app_timers and the event depths for app-timer
events; this will reduce memory consumption for zero-initialized data by
around 1K.

- Remove the call to conn_params_init() at startup. This is not mandatory; and
was causing an unnecessary re-negotiation of connection parameters a few
seconds into every connection.

- Reduce default transmission power level to 0dbB (was 4dbB before).

- Reduce min connection interval to 50ms and max to 500ms (previous values
were much larger).

- Replace a few instances of use of wait() with nrf_delay_us().

- onConnection() callback now receives connection-parameters applicable to the
new connection.

- onDataSent() callback now receives a count parameter containing the number of
times notifications were sent out since the last callback.

- A 'reason' parameter has been added to Gap::disconnect() to indicate the
reason for disconnection; and also to the onDisconnection callback to
receive a reason from the remote host.

- disable the app_gpiote module by default.

Bugfixes
~~~~~~~~

- onDataWritten() callback now passes an additional parameter
(GattServer::WriteEventCallback_t) encapsulating the update. This avoids
having to re-fetch the updated characteristic's value attribute. It also
fixes a bug where multiple updates to the characteristic's value-attribute
could get clobbered if they occurred in quick succession before the
callbacks could be processed.


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

Compatible with revision 0.1.0 of the BLE_API.

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_GAP_H__
Rohit Grover 22:c6ee8136847e 18 #define __NRF51822_GAP_H__
Rohit Grover 22:c6ee8136847e 19
Rohit Grover 22:c6ee8136847e 20 #include "mbed.h"
Rohit Grover 22:c6ee8136847e 21 #include "blecommon.h"
Rohit Grover 22:c6ee8136847e 22 #include "ble.h"
Rohit Grover 22:c6ee8136847e 23 #include "GapAdvertisingParams.h"
Rohit Grover 22:c6ee8136847e 24 #include "GapAdvertisingData.h"
Rohit Grover 52:120bd37b9d0d 25 #include "public/Gap.h"
Rohit Grover 22:c6ee8136847e 26
Rohit Grover 22:c6ee8136847e 27 /**************************************************************************/
Rohit Grover 22:c6ee8136847e 28 /*!
Rohit Grover 22:c6ee8136847e 29 \brief
Rohit Grover 22:c6ee8136847e 30
Rohit Grover 22:c6ee8136847e 31 */
Rohit Grover 22:c6ee8136847e 32 /**************************************************************************/
Rohit Grover 22:c6ee8136847e 33 class nRF51Gap : public Gap
Rohit Grover 22:c6ee8136847e 34 {
Rohit Grover 22:c6ee8136847e 35 public:
Rohit Grover 22:c6ee8136847e 36 static nRF51Gap &getInstance() {
Rohit Grover 22:c6ee8136847e 37 static nRF51Gap m_instance;
Rohit Grover 22:c6ee8136847e 38 return m_instance;
Rohit Grover 22:c6ee8136847e 39 }
Rohit Grover 22:c6ee8136847e 40
Rohit Grover 22:c6ee8136847e 41 /* Functions that must be implemented from Gap */
Rohit Grover 22:c6ee8136847e 42 virtual ble_error_t setAddress(addr_type_t type,
Rohit Grover 22:c6ee8136847e 43 const uint8_t address[6]);
Rohit Grover 22:c6ee8136847e 44 virtual ble_error_t setAdvertisingData(const GapAdvertisingData &,
Rohit Grover 22:c6ee8136847e 45 const GapAdvertisingData &);
Rohit Grover 22:c6ee8136847e 46 virtual ble_error_t startAdvertising(const GapAdvertisingParams &);
Rohit Grover 22:c6ee8136847e 47 virtual ble_error_t stopAdvertising(void);
Rohit Grover 56:a1071b629aa3 48 virtual ble_error_t disconnect(DisconnectionReason_t reason);
Rohit Grover 56:a1071b629aa3 49
Rohit Grover 56:a1071b629aa3 50 virtual ble_error_t setDeviceName(const uint8_t *deviceName);
Rohit Grover 56:a1071b629aa3 51 virtual ble_error_t getDeviceName(uint8_t *deviceName, unsigned *lengthP);
Rohit Grover 56:a1071b629aa3 52 virtual ble_error_t setAppearance(uint16_t appearance);
Rohit Grover 56:a1071b629aa3 53 virtual ble_error_t getAppearance(uint16_t *appearanceP);
Rohit Grover 22:c6ee8136847e 54
Rohit Grover 22:c6ee8136847e 55 void setConnectionHandle(uint16_t con_handle);
Rohit Grover 22:c6ee8136847e 56 uint16_t getConnectionHandle(void);
Rohit Grover 22:c6ee8136847e 57
Rohit Grover 44:47da5c62e067 58 virtual ble_error_t getPreferredConnectionParams(ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 59 virtual ble_error_t setPreferredConnectionParams(const ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 60 virtual ble_error_t updateConnectionParams(Handle_t handle, const ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 61
Rohit Grover 22:c6ee8136847e 62 private:
Rohit Grover 22:c6ee8136847e 63 uint16_t m_connectionHandle;
Rohit Grover 22:c6ee8136847e 64 nRF51Gap() {
Rohit Grover 22:c6ee8136847e 65 m_connectionHandle = BLE_CONN_HANDLE_INVALID;
Rohit Grover 22:c6ee8136847e 66 }
Rohit Grover 22:c6ee8136847e 67
Rohit Grover 22:c6ee8136847e 68 nRF51Gap(nRF51Gap const &);
Rohit Grover 22:c6ee8136847e 69 void operator=(nRF51Gap const &);
Rohit Grover 22:c6ee8136847e 70 };
Rohit Grover 22:c6ee8136847e 71
Rohit Grover 22:c6ee8136847e 72 #endif // ifndef __NRF51822_GAP_H__