Oscar Ariza / nRF51822

nordic

Fork of nRF51822 by Nordic Semiconductor

btle/btle_discovery.cpp@275:f82e0ecba699, 2015-06-19 (annotated)

Committer:
rgrover1
Date:
Fri Jun 19 15:55:25 2015 +0100
Revision:
275:f82e0ecba699
Parent:
274:8ada9e8111a3
Child:
276:fd709cd8b1b2
Synchronized with git rev be10d09d

Author: Rohit Grover

add a couple of comment blocks.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 244:a966506d1e5b 1 /* mbed Microcontroller Library
rgrover1 244:a966506d1e5b 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 244:a966506d1e5b 3 *
rgrover1 244:a966506d1e5b 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 244:a966506d1e5b 5 * you may not use this file except in compliance with the License.
rgrover1 244:a966506d1e5b 6 * You may obtain a copy of the License at
rgrover1 244:a966506d1e5b 7 *
rgrover1 244:a966506d1e5b 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 244:a966506d1e5b 9 *
rgrover1 244:a966506d1e5b 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 244:a966506d1e5b 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 244:a966506d1e5b 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 244:a966506d1e5b 13 * See the License for the specific language governing permissions and
rgrover1 244:a966506d1e5b 14 * limitations under the License.
rgrover1 244:a966506d1e5b 15 */
rgrover1 244:a966506d1e5b 16
rgrover1 240:693a1f145b5a 17 #include "blecommon.h"
rgrover1 240:693a1f145b5a 18 #include "UUID.h"
rgrover1 240:693a1f145b5a 19 #include "Gap.h"
rgrover1 240:693a1f145b5a 20 #include "nrf_error.h"
rgrover1 240:693a1f145b5a 21 #include "btle_discovery.h"
rgrover1 240:693a1f145b5a 22 #include "ble_err.h"
rgrover1 244:a966506d1e5b 23
rgrover1 244:a966506d1e5b 24 static NordicServiceDiscovery discoverySingleton;
rgrover1 240:693a1f145b5a 25
rgrover1 240:693a1f145b5a 26 ble_error_t
rgrover1 274:8ada9e8111a3 27 ServiceDiscovery::launch(Gap::Handle_t connectionHandle,
rgrover1 274:8ada9e8111a3 28 ServiceCallback_t sc,
rgrover1 274:8ada9e8111a3 29 CharacteristicCallback_t cc,
rgrover1 274:8ada9e8111a3 30 UUID matchingServiceUUIDIn,
rgrover1 274:8ada9e8111a3 31 UUID matchingCharacteristicUUIDIn)
rgrover1 240:693a1f145b5a 32 {
rgrover1 274:8ada9e8111a3 33 discoverySingleton.serviceCallback = sc;
rgrover1 274:8ada9e8111a3 34 discoverySingleton.characteristicCallback = cc;
rgrover1 274:8ada9e8111a3 35 discoverySingleton.matchingServiceUUID = matchingServiceUUIDIn;
rgrover1 274:8ada9e8111a3 36 discoverySingleton.matchingCharacteristicUUID = matchingCharacteristicUUIDIn;
rgrover1 274:8ada9e8111a3 37
rgrover1 244:a966506d1e5b 38 discoverySingleton.serviceDiscoveryStarted(connectionHandle);
rgrover1 240:693a1f145b5a 39
rgrover1 240:693a1f145b5a 40 uint32_t rc;
rgrover1 249:71ef03789dd3 41 if ((rc = sd_ble_gattc_primary_services_discover(connectionHandle, NordicServiceDiscovery::SRV_DISC_START_HANDLE, NULL)) != NRF_SUCCESS) {
rgrover1 249:71ef03789dd3 42 discoverySingleton.terminate();
rgrover1 240:693a1f145b5a 43 switch (rc) {
rgrover1 240:693a1f145b5a 44 case NRF_ERROR_INVALID_PARAM:
rgrover1 240:693a1f145b5a 45 case BLE_ERROR_INVALID_CONN_HANDLE:
rgrover1 240:693a1f145b5a 46 return BLE_ERROR_INVALID_PARAM;
rgrover1 240:693a1f145b5a 47 case NRF_ERROR_BUSY:
rgrover1 240:693a1f145b5a 48 return BLE_STACK_BUSY;
rgrover1 240:693a1f145b5a 49 default:
rgrover1 240:693a1f145b5a 50 case NRF_ERROR_INVALID_STATE:
rgrover1 240:693a1f145b5a 51 return BLE_ERROR_INVALID_STATE;
rgrover1 240:693a1f145b5a 52 }
rgrover1 240:693a1f145b5a 53 }
rgrover1 240:693a1f145b5a 54
rgrover1 240:693a1f145b5a 55 return BLE_ERROR_NONE;
rgrover1 240:693a1f145b5a 56 }
rgrover1 240:693a1f145b5a 57
rgrover1 249:71ef03789dd3 58 void
rgrover1 249:71ef03789dd3 59 ServiceDiscovery::terminate(void)
rgrover1 249:71ef03789dd3 60 {
rgrover1 249:71ef03789dd3 61 discoverySingleton.terminateServiceDiscovery();
rgrover1 249:71ef03789dd3 62 }
rgrover1 249:71ef03789dd3 63
rgrover1 244:a966506d1e5b 64 ble_error_t
rgrover1 253:4b3f294415f5 65 NordicServiceDiscovery::launchCharacteristicDiscovery(Gap::Handle_t connectionHandle,
rgrover1 253:4b3f294415f5 66 Gap::Handle_t startHandle,
rgrover1 253:4b3f294415f5 67 Gap::Handle_t endHandle)
rgrover1 253:4b3f294415f5 68 {
rgrover1 244:a966506d1e5b 69 discoverySingleton.characteristicDiscoveryStarted(connectionHandle);
rgrover1 240:693a1f145b5a 70
rgrover1 240:693a1f145b5a 71 ble_gattc_handle_range_t handleRange = {
rgrover1 240:693a1f145b5a 72 .start_handle = startHandle,
rgrover1 240:693a1f145b5a 73 .end_handle = endHandle
rgrover1 240:693a1f145b5a 74 };
rgrover1 240:693a1f145b5a 75 uint32_t rc;
rgrover1 240:693a1f145b5a 76 if ((rc = sd_ble_gattc_characteristics_discover(connectionHandle, &handleRange)) != NRF_SUCCESS) {
rgrover1 244:a966506d1e5b 77 discoverySingleton.terminateCharacteristicDiscovery();
rgrover1 240:693a1f145b5a 78 switch (rc) {
rgrover1 240:693a1f145b5a 79 case BLE_ERROR_INVALID_CONN_HANDLE:
rgrover1 240:693a1f145b5a 80 case NRF_ERROR_INVALID_ADDR:
rgrover1 240:693a1f145b5a 81 return BLE_ERROR_INVALID_PARAM;
rgrover1 240:693a1f145b5a 82 case NRF_ERROR_BUSY:
rgrover1 240:693a1f145b5a 83 return BLE_STACK_BUSY;
rgrover1 240:693a1f145b5a 84 default:
rgrover1 240:693a1f145b5a 85 case NRF_ERROR_INVALID_STATE:
rgrover1 240:693a1f145b5a 86 return BLE_ERROR_INVALID_STATE;
rgrover1 240:693a1f145b5a 87 }
rgrover1 240:693a1f145b5a 88 }
rgrover1 240:693a1f145b5a 89
rgrover1 240:693a1f145b5a 90 return BLE_ERROR_NONE;
rgrover1 240:693a1f145b5a 91 }
rgrover1 240:693a1f145b5a 92
rgrover1 240:693a1f145b5a 93 void
rgrover1 241:75b69581d1dd 94 NordicServiceDiscovery::setupDiscoveredServices(const ble_gattc_evt_prim_srvc_disc_rsp_t *response)
rgrover1 240:693a1f145b5a 95 {
rgrover1 243:73fc02cc20b1 96 serviceIndex = 0;
rgrover1 243:73fc02cc20b1 97 numServices = response->count;
rgrover1 240:693a1f145b5a 98
rgrover1 240:693a1f145b5a 99 /* Account for the limitation on the number of discovered services we can handle at a time. */
rgrover1 243:73fc02cc20b1 100 if (numServices > BLE_DB_DISCOVERY_MAX_SRV) {
rgrover1 243:73fc02cc20b1 101 numServices = BLE_DB_DISCOVERY_MAX_SRV;
rgrover1 240:693a1f145b5a 102 }
rgrover1 240:693a1f145b5a 103
rgrover1 243:73fc02cc20b1 104 for (unsigned serviceIndex = 0; serviceIndex < numServices; serviceIndex++) {
rgrover1 240:693a1f145b5a 105 services[serviceIndex].setup(response->services[serviceIndex].uuid.uuid,
rgrover1 240:693a1f145b5a 106 response->services[serviceIndex].handle_range.start_handle,
rgrover1 240:693a1f145b5a 107 response->services[serviceIndex].handle_range.end_handle);
rgrover1 240:693a1f145b5a 108 }
rgrover1 240:693a1f145b5a 109 }
rgrover1 240:693a1f145b5a 110
rgrover1 240:693a1f145b5a 111 void
rgrover1 241:75b69581d1dd 112 NordicServiceDiscovery::setupDiscoveredCharacteristics(const ble_gattc_evt_char_disc_rsp_t *response)
rgrover1 240:693a1f145b5a 113 {
rgrover1 243:73fc02cc20b1 114 characteristicIndex = 0;
rgrover1 243:73fc02cc20b1 115 numCharacteristics = response->count;
rgrover1 240:693a1f145b5a 116
rgrover1 240:693a1f145b5a 117 /* Account for the limitation on the number of discovered characteristics we can handle at a time. */
rgrover1 243:73fc02cc20b1 118 if (numCharacteristics > BLE_DB_DISCOVERY_MAX_CHAR_PER_SRV) {
rgrover1 243:73fc02cc20b1 119 numCharacteristics = BLE_DB_DISCOVERY_MAX_CHAR_PER_SRV;
rgrover1 240:693a1f145b5a 120 }
rgrover1 240:693a1f145b5a 121
rgrover1 243:73fc02cc20b1 122 for (unsigned charIndex = 0; charIndex < numCharacteristics; charIndex++) {
rgrover1 240:693a1f145b5a 123 characteristics[charIndex].setup(response->chars[charIndex].uuid.uuid,
rgrover1 240:693a1f145b5a 124 *(const uint8_t *)(&response->chars[charIndex].char_props),
rgrover1 240:693a1f145b5a 125 response->chars[charIndex].handle_decl,
rgrover1 240:693a1f145b5a 126 response->chars[charIndex].handle_value);
rgrover1 240:693a1f145b5a 127 }
rgrover1 244:a966506d1e5b 128 }
rgrover1 244:a966506d1e5b 129
rgrover1 252:d4e0cf5e8751 130 void
rgrover1 252:d4e0cf5e8751 131 NordicServiceDiscovery::progressCharacteristicDiscovery(void)
rgrover1 252:d4e0cf5e8751 132 {
rgrover1 252:d4e0cf5e8751 133 while (cDiscoveryActive && (characteristicIndex < numCharacteristics)) {
rgrover1 256:d228656b0cd1 134 if (characteristicCallback) {
rgrover1 256:d228656b0cd1 135 characteristicCallback(characteristics[characteristicIndex]);
rgrover1 256:d228656b0cd1 136 }
rgrover1 252:d4e0cf5e8751 137
rgrover1 252:d4e0cf5e8751 138 characteristicIndex++;
rgrover1 252:d4e0cf5e8751 139 }
rgrover1 252:d4e0cf5e8751 140
rgrover1 252:d4e0cf5e8751 141 if (cDiscoveryActive) {
rgrover1 265:5533ac0adf4b 142 Gap::Handle_t startHandle = characteristics[characteristicIndex - 1].getValueHandle() + 1;
rgrover1 265:5533ac0adf4b 143 Gap::Handle_t endHandle = services[serviceIndex].getEndHandle();
rgrover1 275:f82e0ecba699 144 resetDiscoveredCharacteristics(); /* Note: resetDiscoveredCharacteristics() must come after fetching start and end Handles. */
rgrover1 252:d4e0cf5e8751 145
rgrover1 252:d4e0cf5e8751 146 if (startHandle < endHandle) {
rgrover1 252:d4e0cf5e8751 147 ble_gattc_handle_range_t handleRange = {
rgrover1 252:d4e0cf5e8751 148 .start_handle = startHandle,
rgrover1 252:d4e0cf5e8751 149 .end_handle = endHandle
rgrover1 252:d4e0cf5e8751 150 };
rgrover1 259:62d6bf03e6a4 151 if (sd_ble_gattc_characteristics_discover(connHandle, &handleRange) != NRF_SUCCESS) {
rgrover1 259:62d6bf03e6a4 152 terminateCharacteristicDiscovery();
rgrover1 259:62d6bf03e6a4 153 }
rgrover1 252:d4e0cf5e8751 154 } else {
rgrover1 252:d4e0cf5e8751 155 terminateCharacteristicDiscovery();
rgrover1 252:d4e0cf5e8751 156 }
rgrover1 252:d4e0cf5e8751 157 }
rgrover1 252:d4e0cf5e8751 158 }
rgrover1 252:d4e0cf5e8751 159
rgrover1 252:d4e0cf5e8751 160 void
rgrover1 252:d4e0cf5e8751 161 NordicServiceDiscovery::progressServiceDiscovery(void)
rgrover1 252:d4e0cf5e8751 162 {
rgrover1 252:d4e0cf5e8751 163 while (sDiscoveryActive && (serviceIndex < numServices)) {
rgrover1 255:c14e1d09f197 164 if (serviceCallback) {
rgrover1 255:c14e1d09f197 165 serviceCallback(services[serviceIndex]);
rgrover1 255:c14e1d09f197 166 }
rgrover1 252:d4e0cf5e8751 167
rgrover1 273:c918f8a73f3f 168 if (sDiscoveryActive && characteristicCallback) { /* characteristic discovery is optional. */
rgrover1 265:5533ac0adf4b 169 launchCharacteristicDiscovery(connHandle, services[serviceIndex].getStartHandle(), services[serviceIndex].getEndHandle());
rgrover1 252:d4e0cf5e8751 170 } else {
rgrover1 252:d4e0cf5e8751 171 serviceIndex++; /* Progress service index to keep discovery alive. */
rgrover1 252:d4e0cf5e8751 172 }
rgrover1 252:d4e0cf5e8751 173 }
rgrover1 252:d4e0cf5e8751 174 if (sDiscoveryActive && (numServices > 0) && (serviceIndex > 0)) {
rgrover1 265:5533ac0adf4b 175 Gap::Handle_t endHandle = services[serviceIndex - 1].getEndHandle();
rgrover1 275:f82e0ecba699 176 resetDiscoveredServices(); /* Note: resetDiscoveredServices() must come after fetching endHandle. */
rgrover1 252:d4e0cf5e8751 177
rgrover1 259:62d6bf03e6a4 178 if (sd_ble_gattc_primary_services_discover(connHandle, endHandle, NULL) != NRF_SUCCESS) {
rgrover1 259:62d6bf03e6a4 179 terminateServiceDiscovery();
rgrover1 259:62d6bf03e6a4 180 }
rgrover1 252:d4e0cf5e8751 181 }
rgrover1 252:d4e0cf5e8751 182 }
rgrover1 252:d4e0cf5e8751 183
rgrover1 244:a966506d1e5b 184 void bleGattcEventHandler(const ble_evt_t *p_ble_evt)
rgrover1 244:a966506d1e5b 185 {
rgrover1 244:a966506d1e5b 186 switch (p_ble_evt->header.evt_id) {
rgrover1 244:a966506d1e5b 187 case BLE_GATTC_EVT_PRIM_SRVC_DISC_RSP:
rgrover1 244:a966506d1e5b 188 switch (p_ble_evt->evt.gattc_evt.gatt_status) {
rgrover1 244:a966506d1e5b 189 case BLE_GATT_STATUS_SUCCESS:
rgrover1 244:a966506d1e5b 190 discoverySingleton.setupDiscoveredServices(&p_ble_evt->evt.gattc_evt.params.prim_srvc_disc_rsp);
rgrover1 244:a966506d1e5b 191 break;
rgrover1 244:a966506d1e5b 192
rgrover1 244:a966506d1e5b 193 case BLE_GATT_STATUS_ATTERR_ATTRIBUTE_NOT_FOUND:
rgrover1 244:a966506d1e5b 194 default:
rgrover1 244:a966506d1e5b 195 discoverySingleton.terminate();
rgrover1 244:a966506d1e5b 196 break;
rgrover1 244:a966506d1e5b 197 }
rgrover1 244:a966506d1e5b 198 break;
rgrover1 244:a966506d1e5b 199
rgrover1 244:a966506d1e5b 200 case BLE_GATTC_EVT_CHAR_DISC_RSP:
rgrover1 244:a966506d1e5b 201 switch (p_ble_evt->evt.gattc_evt.gatt_status) {
rgrover1 244:a966506d1e5b 202 case BLE_GATT_STATUS_SUCCESS:
rgrover1 244:a966506d1e5b 203 discoverySingleton.setupDiscoveredCharacteristics(&p_ble_evt->evt.gattc_evt.params.char_disc_rsp);
rgrover1 244:a966506d1e5b 204 break;
rgrover1 244:a966506d1e5b 205
rgrover1 244:a966506d1e5b 206 case BLE_GATT_STATUS_ATTERR_ATTRIBUTE_NOT_FOUND:
rgrover1 244:a966506d1e5b 207 default:
rgrover1 244:a966506d1e5b 208 discoverySingleton.terminateCharacteristicDiscovery();
rgrover1 244:a966506d1e5b 209 break;
rgrover1 244:a966506d1e5b 210 }
rgrover1 244:a966506d1e5b 211 break;
rgrover1 244:a966506d1e5b 212 }
rgrover1 244:a966506d1e5b 213
rgrover1 244:a966506d1e5b 214 discoverySingleton.progressCharacteristicDiscovery();
rgrover1 244:a966506d1e5b 215 discoverySingleton.progressServiceDiscovery();
rgrover1 240:693a1f145b5a 216 }