Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Fork of nRF51822 by
nRF51GattServer.h@56:a1071b629aa3, 2014-09-02 (annotated)
- Committer:
- Rohit Grover
- Date:
- Tue Sep 02 15:50:05 2014 +0100
- Revision:
- 56:a1071b629aa3
- Parent:
- 52:120bd37b9d0d
- Child:
- 57:2aa01a5008ac
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?
User | Revision | Line number | New 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_GATT_SERVER_H__ |
Rohit Grover |
22:c6ee8136847e | 18 | #define __NRF51822_GATT_SERVER_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" /* nordic ble */ |
Rohit Grover |
22:c6ee8136847e | 23 | #include "GattService.h" |
Rohit Grover |
52:120bd37b9d0d | 24 | #include "public/GattServer.h" |
Rohit Grover |
22:c6ee8136847e | 25 | |
Rohit Grover |
22:c6ee8136847e | 26 | #define BLE_TOTAL_CHARACTERISTICS 10 |
Rohit Grover |
56:a1071b629aa3 | 27 | #define BLE_TOTAL_DESCRIPTORS 10 |
Rohit Grover |
22:c6ee8136847e | 28 | |
Rohit Grover |
22:c6ee8136847e | 29 | class nRF51GattServer : public GattServer |
Rohit Grover |
22:c6ee8136847e | 30 | { |
Rohit Grover |
22:c6ee8136847e | 31 | public: |
Rohit Grover |
22:c6ee8136847e | 32 | static nRF51GattServer &getInstance() { |
Rohit Grover |
22:c6ee8136847e | 33 | static nRF51GattServer m_instance; |
Rohit Grover |
22:c6ee8136847e | 34 | return m_instance; |
Rohit Grover |
22:c6ee8136847e | 35 | } |
Rohit Grover |
22:c6ee8136847e | 36 | |
Rohit Grover |
22:c6ee8136847e | 37 | /* Functions that must be implemented from GattServer */ |
Rohit Grover |
22:c6ee8136847e | 38 | virtual ble_error_t addService(GattService &); |
Rohit Grover |
31:c3ce6ee5d300 | 39 | virtual ble_error_t readValue(uint16_t handle, uint8_t buffer[], uint16_t *const lengthP); |
Rohit Grover |
22:c6ee8136847e | 40 | virtual ble_error_t updateValue(uint16_t, uint8_t[], uint16_t, bool localOnly = false); |
Rohit Grover |
22:c6ee8136847e | 41 | |
Rohit Grover |
22:c6ee8136847e | 42 | /* nRF51 Functions */ |
Rohit Grover |
22:c6ee8136847e | 43 | void eventCallback(void); |
Rohit Grover |
22:c6ee8136847e | 44 | void hwCallback(ble_evt_t *p_ble_evt); |
Rohit Grover |
22:c6ee8136847e | 45 | |
Rohit Grover |
22:c6ee8136847e | 46 | private: |
Rohit Grover |
22:c6ee8136847e | 47 | GattCharacteristic *p_characteristics[BLE_TOTAL_CHARACTERISTICS]; |
Rohit Grover |
22:c6ee8136847e | 48 | ble_gatts_char_handles_t nrfCharacteristicHandles[BLE_TOTAL_CHARACTERISTICS]; |
Rohit Grover |
56:a1071b629aa3 | 49 | GattAttribute *p_descriptors[BLE_TOTAL_DESCRIPTORS]; |
Rohit Grover |
56:a1071b629aa3 | 50 | uint16_t nrfDescriptorHandles[BLE_TOTAL_DESCRIPTORS]; |
Rohit Grover |
22:c6ee8136847e | 51 | |
Rohit Grover |
22:c6ee8136847e | 52 | nRF51GattServer() { |
Rohit Grover |
22:c6ee8136847e | 53 | serviceCount = 0; |
Rohit Grover |
22:c6ee8136847e | 54 | characteristicCount = 0; |
Rohit Grover |
56:a1071b629aa3 | 55 | descriptorCount = 0; |
Rohit Grover |
22:c6ee8136847e | 56 | }; |
Rohit Grover |
22:c6ee8136847e | 57 | |
Rohit Grover |
22:c6ee8136847e | 58 | nRF51GattServer(nRF51GattServer const &); |
Rohit Grover |
22:c6ee8136847e | 59 | void operator=(nRF51GattServer const &); |
Rohit Grover |
22:c6ee8136847e | 60 | }; |
Rohit Grover |
22:c6ee8136847e | 61 | |
Rohit Grover |
22:c6ee8136847e | 62 | #endif |