Sergey Solodunov / nRF51822

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.

Dependencies:   nrf51-sdk

Fork of nRF51822 by Nordic Semiconductor

source/nRF51Gap.h@391:8cc3528a1233, 2015-07-21 (annotated)

Committer:
rgrover1
Date:
Tue Jul 21 13:23:45 2015 +0100
Revision:
391:8cc3528a1233
Parent:
389:5982ee136c47 
Synchronized with git rev 4ec44d75

Author: Andrew Fernandes

Change DiscoveredCharacteristic API to return long or short UUIDs.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 389:5982ee136c47 1 /* mbed Microcontroller Library
rgrover1 389:5982ee136c47 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 389:5982ee136c47 3 *
rgrover1 389:5982ee136c47 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 389:5982ee136c47 5 * you may not use this file except in compliance with the License.
rgrover1 389:5982ee136c47 6 * You may obtain a copy of the License at
rgrover1 389:5982ee136c47 7 *
rgrover1 389:5982ee136c47 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 389:5982ee136c47 9 *
rgrover1 389:5982ee136c47 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 389:5982ee136c47 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 389:5982ee136c47 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 389:5982ee136c47 13 * See the License for the specific language governing permissions and
rgrover1 389:5982ee136c47 14 * limitations under the License.
rgrover1 389:5982ee136c47 15 */
rgrover1 389:5982ee136c47 16
rgrover1 389:5982ee136c47 17 #ifndef __NRF51822_GAP_H__
rgrover1 389:5982ee136c47 18 #define __NRF51822_GAP_H__
rgrover1 389:5982ee136c47 19
rgrover1 389:5982ee136c47 20 #include "mbed.h"
rgrover1 389:5982ee136c47 21 #include "ble/blecommon.h"
rgrover1 389:5982ee136c47 22 #include "ble.h"
rgrover1 389:5982ee136c47 23 #include "ble/GapAdvertisingParams.h"
rgrover1 389:5982ee136c47 24 #include "ble/GapAdvertisingData.h"
rgrover1 389:5982ee136c47 25 #include "ble/Gap.h"
rgrover1 389:5982ee136c47 26 #include "ble/GapScanningParams.h"
rgrover1 389:5982ee136c47 27
rgrover1 389:5982ee136c47 28 #include "nrf_soc.h"
rgrover1 389:5982ee136c47 29 #include "ble_radio_notification.h"
rgrover1 389:5982ee136c47 30 #include "btle_security.h"
rgrover1 389:5982ee136c47 31
rgrover1 389:5982ee136c47 32 /**************************************************************************/
rgrover1 389:5982ee136c47 33 /*!
rgrover1 389:5982ee136c47 34 \brief
rgrover1 389:5982ee136c47 35
rgrover1 389:5982ee136c47 36 */
rgrover1 389:5982ee136c47 37 /**************************************************************************/
rgrover1 389:5982ee136c47 38 class nRF51Gap : public Gap
rgrover1 389:5982ee136c47 39 {
rgrover1 389:5982ee136c47 40 public:
rgrover1 389:5982ee136c47 41 static nRF51Gap &getInstance();
rgrover1 389:5982ee136c47 42
rgrover1 389:5982ee136c47 43 /* Functions that must be implemented from Gap */
rgrover1 389:5982ee136c47 44 virtual ble_error_t setAddress(AddressType_t type, const Address_t address);
rgrover1 389:5982ee136c47 45 virtual ble_error_t getAddress(AddressType_t *typeP, Address_t address);
rgrover1 389:5982ee136c47 46 virtual ble_error_t setAdvertisingData(const GapAdvertisingData &, const GapAdvertisingData &);
rgrover1 389:5982ee136c47 47
rgrover1 389:5982ee136c47 48 virtual uint16_t getMinAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_INTERVAL_MIN);}
rgrover1 389:5982ee136c47 49 virtual uint16_t getMinNonConnectableAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_NONCON_INTERVAL_MIN);}
rgrover1 389:5982ee136c47 50 virtual uint16_t getMaxAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_INTERVAL_MAX);}
rgrover1 389:5982ee136c47 51
rgrover1 389:5982ee136c47 52 virtual ble_error_t startAdvertising(const GapAdvertisingParams &);
rgrover1 389:5982ee136c47 53 virtual ble_error_t stopAdvertising(void);
rgrover1 389:5982ee136c47 54 virtual ble_error_t connect(const Address_t, Gap::AddressType_t peerAddrType, const ConnectionParams_t *connectionParams, const GapScanningParams *scanParams);
rgrover1 389:5982ee136c47 55 virtual ble_error_t disconnect(Handle_t connectionHandle, DisconnectionReason_t reason);
rgrover1 389:5982ee136c47 56 virtual ble_error_t disconnect(DisconnectionReason_t reason);
rgrover1 389:5982ee136c47 57
rgrover1 389:5982ee136c47 58 virtual ble_error_t setDeviceName(const uint8_t *deviceName);
rgrover1 389:5982ee136c47 59 virtual ble_error_t getDeviceName(uint8_t *deviceName, unsigned *lengthP);
rgrover1 389:5982ee136c47 60 virtual ble_error_t setAppearance(GapAdvertisingData::Appearance appearance);
rgrover1 389:5982ee136c47 61 virtual ble_error_t getAppearance(GapAdvertisingData::Appearance *appearanceP);
rgrover1 389:5982ee136c47 62
rgrover1 389:5982ee136c47 63 virtual ble_error_t setTxPower(int8_t txPower);
rgrover1 389:5982ee136c47 64 virtual void getPermittedTxPowerValues(const int8_t **valueArrayPP, size_t *countP);
rgrover1 389:5982ee136c47 65
rgrover1 389:5982ee136c47 66 void setConnectionHandle(uint16_t con_handle);
rgrover1 389:5982ee136c47 67 uint16_t getConnectionHandle(void);
rgrover1 389:5982ee136c47 68
rgrover1 389:5982ee136c47 69 virtual ble_error_t getPreferredConnectionParams(ConnectionParams_t *params);
rgrover1 389:5982ee136c47 70 virtual ble_error_t setPreferredConnectionParams(const ConnectionParams_t *params);
rgrover1 389:5982ee136c47 71 virtual ble_error_t updateConnectionParams(Handle_t handle, const ConnectionParams_t *params);
rgrover1 389:5982ee136c47 72
rgrover1 389:5982ee136c47 73 virtual void onRadioNotification(RadioNotificationEventCallback_t callback) {
rgrover1 389:5982ee136c47 74 Gap::onRadioNotification(callback);
rgrover1 389:5982ee136c47 75 ble_radio_notification_init(NRF_APP_PRIORITY_HIGH, NRF_RADIO_NOTIFICATION_DISTANCE_800US, radioNotificationCallback);
rgrover1 389:5982ee136c47 76 }
rgrover1 389:5982ee136c47 77
rgrover1 389:5982ee136c47 78 virtual ble_error_t startRadioScan(const GapScanningParams &scanningParams) {
rgrover1 389:5982ee136c47 79 ble_gap_scan_params_t scanParams = {
rgrover1 389:5982ee136c47 80 .active = scanningParams.getActiveScanning(), /**< If 1, perform active scanning (scan requests). */
rgrover1 389:5982ee136c47 81 .selective = 0, /**< If 1, ignore unknown devices (non whitelisted). */
rgrover1 389:5982ee136c47 82 .p_whitelist = NULL, /**< Pointer to whitelist, NULL if none is given. */
rgrover1 389:5982ee136c47 83 .interval = scanningParams.getInterval(), /**< Scan interval between 0x0004 and 0x4000 in 0.625ms units (2.5ms to 10.24s). */
rgrover1 389:5982ee136c47 84 .window = scanningParams.getWindow(), /**< Scan window between 0x0004 and 0x4000 in 0.625ms units (2.5ms to 10.24s). */
rgrover1 389:5982ee136c47 85 .timeout = scanningParams.getTimeout(), /**< Scan timeout between 0x0001 and 0xFFFF in seconds, 0x0000 disables timeout. */
rgrover1 389:5982ee136c47 86 };
rgrover1 389:5982ee136c47 87
rgrover1 389:5982ee136c47 88 if (sd_ble_gap_scan_start(&scanParams) != NRF_SUCCESS) {
rgrover1 389:5982ee136c47 89 return BLE_ERROR_PARAM_OUT_OF_RANGE;
rgrover1 389:5982ee136c47 90 }
rgrover1 389:5982ee136c47 91
rgrover1 389:5982ee136c47 92 return BLE_ERROR_NONE;
rgrover1 389:5982ee136c47 93 }
rgrover1 389:5982ee136c47 94
rgrover1 389:5982ee136c47 95 virtual ble_error_t stopScan(void) {
rgrover1 389:5982ee136c47 96 if (sd_ble_gap_scan_stop() == NRF_SUCCESS) {
rgrover1 389:5982ee136c47 97 return BLE_ERROR_NONE;
rgrover1 389:5982ee136c47 98 }
rgrover1 389:5982ee136c47 99
rgrover1 389:5982ee136c47 100 return BLE_STACK_BUSY;
rgrover1 389:5982ee136c47 101 }
rgrover1 389:5982ee136c47 102
rgrover1 389:5982ee136c47 103 private:
rgrover1 389:5982ee136c47 104 uint16_t m_connectionHandle;
rgrover1 389:5982ee136c47 105 nRF51Gap() {
rgrover1 389:5982ee136c47 106 m_connectionHandle = BLE_CONN_HANDLE_INVALID;
rgrover1 389:5982ee136c47 107 }
rgrover1 389:5982ee136c47 108
rgrover1 389:5982ee136c47 109 nRF51Gap(nRF51Gap const &);
rgrover1 389:5982ee136c47 110 void operator=(nRF51Gap const &);
rgrover1 389:5982ee136c47 111 };
rgrover1 389:5982ee136c47 112
rgrover1 389:5982ee136c47 113 #endif // ifndef __NRF51822_GAP_H__