テスト用
Fork of nRF51822 by
nRF51Gap.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
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_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__ |