Jason Garner / 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.

Fork of nRF51822 by Nordic Semiconductor

nRF51Gap.h@177:e0397a086ff5, 2015-05-18 (annotated)

Committer:
rgrover1
Date:
Mon May 18 09:53:05 2015 +0100
Revision:
177:e0397a086ff5
Parent:
174:555dc8af9269
Child:
178:3b34428e80ea
Synchronized with git rev b87dd448

Author: Rohit Grover

reimplement nRF51Gap::startScan() in terms of AdvertisementCallbackParams.

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_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"
rgrover1 172:57c4a91ff825 25 #include "Gap.h"
rgrover1 174:555dc8af9269 26 #include "GapScanningParams.h"
Rohit Grover 22:c6ee8136847e 27
rgrover1 105:7404a5b1b72f 28 #include "nrf_soc.h"
rgrover1 105:7404a5b1b72f 29 #include "ble_radio_notification.h"
rgrover1 137:aafab7b0a8bd 30 #include "btle_security.h"
rgrover1 105:7404a5b1b72f 31
Rohit Grover 22:c6ee8136847e 32 /**************************************************************************/
Rohit Grover 22:c6ee8136847e 33 /*!
Rohit Grover 22:c6ee8136847e 34 \brief
Rohit Grover 22:c6ee8136847e 35
Rohit Grover 22:c6ee8136847e 36 */
Rohit Grover 22:c6ee8136847e 37 /**************************************************************************/
Rohit Grover 22:c6ee8136847e 38 class nRF51Gap : public Gap
Rohit Grover 22:c6ee8136847e 39 {
Rohit Grover 22:c6ee8136847e 40 public:
Rohit Grover 22:c6ee8136847e 41 static nRF51Gap &getInstance() {
Rohit Grover 22:c6ee8136847e 42 static nRF51Gap m_instance;
Rohit Grover 22:c6ee8136847e 43 return m_instance;
Rohit Grover 22:c6ee8136847e 44 }
Rohit Grover 22:c6ee8136847e 45
Rohit Grover 22:c6ee8136847e 46 /* Functions that must be implemented from Gap */
rgrover1 77:9886b2865631 47 virtual ble_error_t setAddress(addr_type_t type, const address_t address);
rgrover1 77:9886b2865631 48 virtual ble_error_t getAddress(addr_type_t *typeP, address_t address);
Rohit Grover 69:61da91a52bd6 49 virtual ble_error_t setAdvertisingData(const GapAdvertisingData &, const GapAdvertisingData &);
rgrover1 102:bdc690669431 50
rgrover1 173:a0b18206029a 51 virtual uint16_t getMinAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_INTERVAL_MIN);}
rgrover1 173:a0b18206029a 52 virtual uint16_t getMinNonConnectableAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_NONCON_INTERVAL_MIN);}
rgrover1 173:a0b18206029a 53 virtual uint16_t getMaxAdvertisingInterval(void) const {return ADVERTISEMENT_DURATION_UNITS_TO_MS(BLE_GAP_ADV_INTERVAL_MAX);}
rgrover1 102:bdc690669431 54
Rohit Grover 22:c6ee8136847e 55 virtual ble_error_t startAdvertising(const GapAdvertisingParams &);
Rohit Grover 22:c6ee8136847e 56 virtual ble_error_t stopAdvertising(void);
Rohit Grover 56:a1071b629aa3 57 virtual ble_error_t disconnect(DisconnectionReason_t reason);
Rohit Grover 56:a1071b629aa3 58
rgrover1 140:3a5282e3f30c 59 virtual ble_error_t purgeAllBondingState(void) {return btle_purgeAllBondingState();}
rgrover1 138:750eca573e18 60 virtual ble_error_t getLinkSecurity(Handle_t connectionHandle, LinkSecurityStatus_t *securityStatusP) {
rgrover1 138:750eca573e18 61 return btle_getLinkSecurity(connectionHandle, securityStatusP);
rgrover1 138:750eca573e18 62 }
rgrover1 137:aafab7b0a8bd 63
Rohit Grover 56:a1071b629aa3 64 virtual ble_error_t setDeviceName(const uint8_t *deviceName);
Rohit Grover 56:a1071b629aa3 65 virtual ble_error_t getDeviceName(uint8_t *deviceName, unsigned *lengthP);
Rohit Grover 56:a1071b629aa3 66 virtual ble_error_t setAppearance(uint16_t appearance);
Rohit Grover 56:a1071b629aa3 67 virtual ble_error_t getAppearance(uint16_t *appearanceP);
Rohit Grover 22:c6ee8136847e 68
Rohit Grover 22:c6ee8136847e 69 void setConnectionHandle(uint16_t con_handle);
Rohit Grover 22:c6ee8136847e 70 uint16_t getConnectionHandle(void);
Rohit Grover 22:c6ee8136847e 71
Rohit Grover 44:47da5c62e067 72 virtual ble_error_t getPreferredConnectionParams(ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 73 virtual ble_error_t setPreferredConnectionParams(const ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 74 virtual ble_error_t updateConnectionParams(Handle_t handle, const ConnectionParams_t *params);
Rohit Grover 44:47da5c62e067 75
rgrover1 105:7404a5b1b72f 76 virtual void setOnRadioNotification(RadioNotificationEventCallback_t callback) {
rgrover1 105:7404a5b1b72f 77 Gap::setOnRadioNotification(callback);
rgrover1 111:be2a122ed2f7 78 ble_radio_notification_init(NRF_APP_PRIORITY_HIGH, NRF_RADIO_NOTIFICATION_DISTANCE_800US, onRadioNotification);
rgrover1 105:7404a5b1b72f 79 }
rgrover1 105:7404a5b1b72f 80
rgrover1 177:e0397a086ff5 81 virtual ble_error_t startScan(const GapScanningParams &scanningParams, void (*callback)(const AdvertisementCallbackParams_t *params)) {
rgrover1 177:e0397a086ff5 82 if (callback != NULL) {
rgrover1 166:fa0e88cac390 83 ble_gap_scan_params_t scanParams = {
rgrover1 170:d886f281ead7 84 .active = scanningParams.getActiveScanning(), /**< If 1, perform active scanning (scan requests). */
rgrover1 171:6f80bdd27157 85 .selective = 0, /**< If 1, ignore unknown devices (non whitelisted). */
rgrover1 171:6f80bdd27157 86 .p_whitelist = NULL, /**< Pointer to whitelist, NULL if none is given. */
rgrover1 166:fa0e88cac390 87 .interval = scanningParams.getInterval(), /**< Scan interval between 0x0004 and 0x4000 in 0.625ms units (2.5ms to 10.24s). */
rgrover1 166:fa0e88cac390 88 .window = scanningParams.getWindow(), /**< Scan window between 0x0004 and 0x4000 in 0.625ms units (2.5ms to 10.24s). */
rgrover1 166:fa0e88cac390 89 .timeout = scanningParams.getTimeout(), /**< Scan timeout between 0x0001 and 0xFFFF in seconds, 0x0000 disables timeout. */
rgrover1 166:fa0e88cac390 90 };
rgrover1 166:fa0e88cac390 91
rgrover1 166:fa0e88cac390 92 if (sd_ble_gap_scan_start(&scanParams) != NRF_SUCCESS) {
rgrover1 166:fa0e88cac390 93 return BLE_ERROR_PARAM_OUT_OF_RANGE;
rgrover1 166:fa0e88cac390 94 }
rgrover1 177:e0397a086ff5 95
rgrover1 177:e0397a086ff5 96 onAdvertisementReport.attach(callback);
rgrover1 166:fa0e88cac390 97 }
rgrover1 166:fa0e88cac390 98
rgrover1 166:fa0e88cac390 99 return BLE_ERROR_NONE;
rgrover1 166:fa0e88cac390 100 }
rgrover1 166:fa0e88cac390 101
rgrover1 169:93cc9241d748 102 virtual ble_error_t stopScan(void) {
rgrover1 168:a24112aa18a1 103 if (sd_ble_gap_scan_stop() == NRF_SUCCESS) {
rgrover1 168:a24112aa18a1 104 return BLE_ERROR_NONE;
rgrover1 168:a24112aa18a1 105 }
rgrover1 168:a24112aa18a1 106
rgrover1 168:a24112aa18a1 107 return BLE_STACK_BUSY;
rgrover1 168:a24112aa18a1 108 }
rgrover1 168:a24112aa18a1 109
Rohit Grover 22:c6ee8136847e 110 private:
Rohit Grover 22:c6ee8136847e 111 uint16_t m_connectionHandle;
Rohit Grover 22:c6ee8136847e 112 nRF51Gap() {
Rohit Grover 22:c6ee8136847e 113 m_connectionHandle = BLE_CONN_HANDLE_INVALID;
Rohit Grover 22:c6ee8136847e 114 }
Rohit Grover 22:c6ee8136847e 115
Rohit Grover 22:c6ee8136847e 116 nRF51Gap(nRF51Gap const &);
Rohit Grover 22:c6ee8136847e 117 void operator=(nRF51Gap const &);
Rohit Grover 22:c6ee8136847e 118 };
Rohit Grover 22:c6ee8136847e 119
rgrover1 77:9886b2865631 120 #endif // ifndef __NRF51822_GAP_H__