Interactive Device Design / simpleBLEControl

mediCAL's first BLE project

Dependents:   BLE_mediCAL

Fork of nRF51822 by Nordic Semiconductor

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?

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_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