nochanges
Dependents: BLE_Acceleration_Statejudging
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 |