Lancaster University / 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

Dependents:   microbit-dal microbit-ble-open microbit-dal-eddystone microbit-dal-ble-accelerometer-example ... more

nRF51GattServer.cpp@8:2214f1df6a6a, 2014-05-28 (annotated)

Committer:
Rohit Grover
Date:
Wed May 28 17:27:23 2014 +0100
Revision:
8:2214f1df6a6a
Parent:
7:dd6465921aaa
Child:
11:6277845e1cc5
convert_to_transport_uuid() now works with 128bit uuids

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:eff01767de02 1 /* mbed Microcontroller Library
bogdanm 0:eff01767de02 2 * Copyright (c) 2006-2013 ARM Limited
bogdanm 0:eff01767de02 3 *
bogdanm 0:eff01767de02 4 * Licensed under the Apache License, Version 2.0 (the "License");
bogdanm 0:eff01767de02 5 * you may not use this file except in compliance with the License.
bogdanm 0:eff01767de02 6 * You may obtain a copy of the License at
bogdanm 0:eff01767de02 7 *
bogdanm 0:eff01767de02 8 * http://www.apache.org/licenses/LICENSE-2.0
bogdanm 0:eff01767de02 9 *
bogdanm 0:eff01767de02 10 * Unless required by applicable law or agreed to in writing, software
bogdanm 0:eff01767de02 11 * distributed under the License is distributed on an "AS IS" BASIS,
bogdanm 0:eff01767de02 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bogdanm 0:eff01767de02 13 * See the License for the specific language governing permissions and
bogdanm 0:eff01767de02 14 * limitations under the License.
bogdanm 0:eff01767de02 15 */
Rohit Grover 6:bbb4357dc135 16
bogdanm 0:eff01767de02 17 #include "nRF51GattServer.h"
bogdanm 0:eff01767de02 18 #include "mbed.h"
bogdanm 0:eff01767de02 19
bogdanm 0:eff01767de02 20 #include "common/common.h"
bogdanm 0:eff01767de02 21 #include "btle/custom/custom_helper.h"
bogdanm 0:eff01767de02 22
mbed_official 2:49e7ee9e88ab 23 #include "nRF51Gap.h"
mbed_official 1:f84abedbf4fb 24
bogdanm 0:eff01767de02 25 /**************************************************************************/
bogdanm 0:eff01767de02 26 /*!
bogdanm 0:eff01767de02 27 @brief Adds a new service to the GATT table on the peripheral
Rohit Grover 6:bbb4357dc135 28
bogdanm 0:eff01767de02 29 @returns ble_error_t
Rohit Grover 6:bbb4357dc135 30
bogdanm 0:eff01767de02 31 @retval BLE_ERROR_NONE
bogdanm 0:eff01767de02 32 Everything executed properly
Rohit Grover 6:bbb4357dc135 33
bogdanm 0:eff01767de02 34 @section EXAMPLE
bogdanm 0:eff01767de02 35
bogdanm 0:eff01767de02 36 @code
bogdanm 0:eff01767de02 37
bogdanm 0:eff01767de02 38 @endcode
bogdanm 0:eff01767de02 39 */
bogdanm 0:eff01767de02 40 /**************************************************************************/
bogdanm 0:eff01767de02 41 ble_error_t nRF51GattServer::addService(GattService & service)
bogdanm 0:eff01767de02 42 {
bogdanm 0:eff01767de02 43 /* ToDo: Make sure we don't overflow the array, etc. */
bogdanm 0:eff01767de02 44 /* ToDo: Make sure this service UUID doesn't already exist (?) */
bogdanm 0:eff01767de02 45 /* ToDo: Basic validation */
Rohit Grover 6:bbb4357dc135 46
bogdanm 0:eff01767de02 47 /* Add the service to the nRF51 */
bogdanm 0:eff01767de02 48 ble_uuid_t uuid;
bogdanm 0:eff01767de02 49
Rohit Grover 6:bbb4357dc135 50 if (service.primaryServiceID.type == UUID::UUID_TYPE_SHORT) {
Rohit Grover 6:bbb4357dc135 51 /* 16-bit BLE UUID */
Rohit Grover 6:bbb4357dc135 52 uuid.type = BLE_UUID_TYPE_BLE;
Rohit Grover 6:bbb4357dc135 53 } else {
Rohit Grover 6:bbb4357dc135 54 /* 128-bit Custom UUID */
Rohit Grover 6:bbb4357dc135 55 uuid.type = custom_add_uuid_base( service.primaryServiceID.base );
bogdanm 0:eff01767de02 56 }
bogdanm 0:eff01767de02 57
bogdanm 0:eff01767de02 58 uuid.uuid = service.primaryServiceID.value;
bogdanm 0:eff01767de02 59
Rohit Grover 6:bbb4357dc135 60 ASSERT( ERROR_NONE ==
Rohit Grover 6:bbb4357dc135 61 sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY,
Rohit Grover 6:bbb4357dc135 62 &uuid,
Rohit Grover 6:bbb4357dc135 63 &service.handle),
Rohit Grover 6:bbb4357dc135 64 BLE_ERROR_PARAM_OUT_OF_RANGE );
bogdanm 0:eff01767de02 65
bogdanm 0:eff01767de02 66 /* Add characteristics to the service */
Rohit Grover 6:bbb4357dc135 67 for (uint8_t i = 0; i < service.characteristicCount; i++) {
Rohit Grover 6:bbb4357dc135 68 GattCharacteristic *p_char = service.characteristics[i];
bogdanm 0:eff01767de02 69
Rohit Grover 7:dd6465921aaa 70 uuid = custom_convert_to_transport_uuid(p_char->uuid);
Rohit Grover 7:dd6465921aaa 71
Rohit Grover 6:bbb4357dc135 72 ASSERT ( ERROR_NONE ==
Rohit Grover 6:bbb4357dc135 73 custom_add_in_characteristic(service.handle,
Rohit Grover 6:bbb4357dc135 74 &uuid,
Rohit Grover 6:bbb4357dc135 75 p_char->properties,
Rohit Grover 6:bbb4357dc135 76 NULL,
Rohit Grover 6:bbb4357dc135 77 p_char->lenMin,
Rohit Grover 6:bbb4357dc135 78 p_char->lenMax,
Rohit Grover 6:bbb4357dc135 79 &nrfCharacteristicHandles[
Rohit Grover 6:bbb4357dc135 80 characteristicCount]),
Rohit Grover 6:bbb4357dc135 81 BLE_ERROR_PARAM_OUT_OF_RANGE );
Rohit Grover 6:bbb4357dc135 82
Rohit Grover 6:bbb4357dc135 83 /* Update the characteristic handle */
Rohit Grover 6:bbb4357dc135 84 p_char->handle = characteristicCount;
Rohit Grover 6:bbb4357dc135 85 p_characteristics[characteristicCount++] = p_char;
bogdanm 0:eff01767de02 86 }
bogdanm 0:eff01767de02 87
bogdanm 0:eff01767de02 88 serviceCount++;
Rohit Grover 6:bbb4357dc135 89
bogdanm 0:eff01767de02 90 return BLE_ERROR_NONE;
bogdanm 0:eff01767de02 91 }
bogdanm 0:eff01767de02 92
bogdanm 0:eff01767de02 93 /**************************************************************************/
bogdanm 0:eff01767de02 94 /*!
bogdanm 0:eff01767de02 95 @brief Reads the value of a characteristic, based on the service
bogdanm 0:eff01767de02 96 and characteristic index fields
bogdanm 0:eff01767de02 97
bogdanm 0:eff01767de02 98 @param[in] charHandle
bogdanm 0:eff01767de02 99 The handle of the GattCharacteristic to read from
bogdanm 0:eff01767de02 100 @param[in] buffer
bogdanm 0:eff01767de02 101 Buffer to hold the the characteristic's value
bogdanm 0:eff01767de02 102 (raw byte array in LSB format)
bogdanm 0:eff01767de02 103 @param[in] len
bogdanm 0:eff01767de02 104 The number of bytes read into the buffer
Rohit Grover 6:bbb4357dc135 105
bogdanm 0:eff01767de02 106 @returns ble_error_t
Rohit Grover 6:bbb4357dc135 107
bogdanm 0:eff01767de02 108 @retval BLE_ERROR_NONE
bogdanm 0:eff01767de02 109 Everything executed properly
Rohit Grover 6:bbb4357dc135 110
bogdanm 0:eff01767de02 111 @section EXAMPLE
bogdanm 0:eff01767de02 112
bogdanm 0:eff01767de02 113 @code
bogdanm 0:eff01767de02 114
bogdanm 0:eff01767de02 115 @endcode
bogdanm 0:eff01767de02 116 */
bogdanm 0:eff01767de02 117 /**************************************************************************/
Rohit Grover 6:bbb4357dc135 118 ble_error_t nRF51GattServer::readValue(uint16_t charHandle,
Rohit Grover 6:bbb4357dc135 119 uint8_t buffer[],
Rohit Grover 6:bbb4357dc135 120 uint16_t len)
bogdanm 0:eff01767de02 121 {
Rohit Grover 6:bbb4357dc135 122 ASSERT( ERROR_NONE ==
Rohit Grover 6:bbb4357dc135 123 sd_ble_gatts_value_get(nrfCharacteristicHandles[charHandle].
Rohit Grover 6:bbb4357dc135 124 value_handle, 0,
Rohit Grover 6:bbb4357dc135 125 &len, buffer), BLE_ERROR_PARAM_OUT_OF_RANGE);
Rohit Grover 6:bbb4357dc135 126
bogdanm 0:eff01767de02 127 return BLE_ERROR_NONE;
bogdanm 0:eff01767de02 128 }
bogdanm 0:eff01767de02 129
bogdanm 0:eff01767de02 130 /**************************************************************************/
bogdanm 0:eff01767de02 131 /*!
bogdanm 0:eff01767de02 132 @brief Updates the value of a characteristic, based on the service
bogdanm 0:eff01767de02 133 and characteristic index fields
bogdanm 0:eff01767de02 134
bogdanm 0:eff01767de02 135 @param[in] charHandle
bogdanm 0:eff01767de02 136 The handle of the GattCharacteristic to write to
bogdanm 0:eff01767de02 137 @param[in] buffer
bogdanm 0:eff01767de02 138 Data to use when updating the characteristic's value
bogdanm 0:eff01767de02 139 (raw byte array in LSB format)
bogdanm 0:eff01767de02 140 @param[in] len
bogdanm 0:eff01767de02 141 The number of bytes in buffer
Rohit Grover 6:bbb4357dc135 142
bogdanm 0:eff01767de02 143 @returns ble_error_t
Rohit Grover 6:bbb4357dc135 144
bogdanm 0:eff01767de02 145 @retval BLE_ERROR_NONE
bogdanm 0:eff01767de02 146 Everything executed properly
Rohit Grover 6:bbb4357dc135 147
bogdanm 0:eff01767de02 148 @section EXAMPLE
bogdanm 0:eff01767de02 149
bogdanm 0:eff01767de02 150 @code
bogdanm 0:eff01767de02 151
bogdanm 0:eff01767de02 152 @endcode
bogdanm 0:eff01767de02 153 */
bogdanm 0:eff01767de02 154 /**************************************************************************/
Rohit Grover 6:bbb4357dc135 155 ble_error_t nRF51GattServer::updateValue(uint16_t charHandle,
Rohit Grover 6:bbb4357dc135 156 uint8_t buffer[],
Rohit Grover 6:bbb4357dc135 157 uint16_t len,
Rohit Grover 6:bbb4357dc135 158 bool localOnly)
bogdanm 0:eff01767de02 159 {
Rohit Grover 6:bbb4357dc135 160 uint16_t gapConnectionHandle =
Rohit Grover 6:bbb4357dc135 161 nRF51Gap::getInstance().getConnectionHandle();
Rohit Grover 6:bbb4357dc135 162
Rohit Grover 6:bbb4357dc135 163 if (localOnly) {
Rohit Grover 6:bbb4357dc135 164 /* Only update locally regardless of notify/indicate */
Rohit Grover 6:bbb4357dc135 165 ASSERT_INT( ERROR_NONE,
Rohit Grover 6:bbb4357dc135 166 sd_ble_gatts_value_set(nrfCharacteristicHandles[charHandle].
Rohit Grover 6:bbb4357dc135 167 value_handle,
Rohit Grover 6:bbb4357dc135 168 0,
Rohit Grover 6:bbb4357dc135 169 &len,
Rohit Grover 6:bbb4357dc135 170 buffer),
Rohit Grover 6:bbb4357dc135 171 BLE_ERROR_PARAM_OUT_OF_RANGE );
Rohit Grover 6:bbb4357dc135 172 }
Rohit Grover 6:bbb4357dc135 173
Rohit Grover 6:bbb4357dc135 174 if ((p_characteristics[charHandle]->properties &
Rohit Grover 6:bbb4357dc135 175 (GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_INDICATE |
Rohit Grover 6:bbb4357dc135 176 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)) &&
Rohit Grover 6:bbb4357dc135 177 (gapConnectionHandle != BLE_CONN_HANDLE_INVALID)) {
Rohit Grover 6:bbb4357dc135 178 /* HVX update for the characteristic value */
Rohit Grover 6:bbb4357dc135 179 ble_gatts_hvx_params_t hvx_params;
bogdanm 0:eff01767de02 180
Rohit Grover 6:bbb4357dc135 181 hvx_params.handle = nrfCharacteristicHandles[charHandle].value_handle;
Rohit Grover 6:bbb4357dc135 182 hvx_params.type =
Rohit Grover 6:bbb4357dc135 183 (p_characteristics[charHandle]->properties &
Rohit Grover 6:bbb4357dc135 184 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY) ?
Rohit Grover 6:bbb4357dc135 185 BLE_GATT_HVX_NOTIFICATION : BLE_GATT_HVX_INDICATION;
Rohit Grover 6:bbb4357dc135 186 hvx_params.offset = 0;
Rohit Grover 6:bbb4357dc135 187 hvx_params.p_data = buffer;
Rohit Grover 6:bbb4357dc135 188 hvx_params.p_len = &len;
bogdanm 0:eff01767de02 189
Rohit Grover 6:bbb4357dc135 190 error_t error = (error_t) sd_ble_gatts_hvx(gapConnectionHandle,
Rohit Grover 6:bbb4357dc135 191 &hvx_params);
bogdanm 0:eff01767de02 192
Rohit Grover 6:bbb4357dc135 193 /* ERROR_INVALID_STATE, ERROR_BUSY, ERROR_GATTS_SYS_ATTR_MISSING and
Rohit Grover 6:bbb4357dc135 194 *ERROR_NO_TX_BUFFERS the ATT table has been updated. */
Rohit Grover 6:bbb4357dc135 195 if ((error != ERROR_NONE) && (error != ERROR_INVALID_STATE) &&
Rohit Grover 6:bbb4357dc135 196 (error != ERROR_BLE_NO_TX_BUFFERS) && (error != ERROR_BUSY) &&
Rohit Grover 6:bbb4357dc135 197 (error != ERROR_BLEGATTS_SYS_ATTR_MISSING)) {
Rohit Grover 6:bbb4357dc135 198 ASSERT_INT( ERROR_NONE,
Rohit Grover 6:bbb4357dc135 199 sd_ble_gatts_value_set(nrfCharacteristicHandles[
Rohit Grover 6:bbb4357dc135 200 charHandle].
Rohit Grover 6:bbb4357dc135 201 value_handle,
Rohit Grover 6:bbb4357dc135 202 0,
Rohit Grover 6:bbb4357dc135 203 &len,
Rohit Grover 6:bbb4357dc135 204 buffer),
Rohit Grover 6:bbb4357dc135 205 BLE_ERROR_PARAM_OUT_OF_RANGE );
Rohit Grover 6:bbb4357dc135 206 }
Rohit Grover 6:bbb4357dc135 207 } else {
Rohit Grover 6:bbb4357dc135 208 ASSERT_INT( ERROR_NONE,
Rohit Grover 6:bbb4357dc135 209 sd_ble_gatts_value_set(nrfCharacteristicHandles[charHandle].
Rohit Grover 6:bbb4357dc135 210 value_handle,
Rohit Grover 6:bbb4357dc135 211 0,
Rohit Grover 6:bbb4357dc135 212 &len,
Rohit Grover 6:bbb4357dc135 213 buffer),
Rohit Grover 6:bbb4357dc135 214 BLE_ERROR_PARAM_OUT_OF_RANGE );
bogdanm 0:eff01767de02 215 }
Rohit Grover 6:bbb4357dc135 216
Rohit Grover 6:bbb4357dc135 217 return BLE_ERROR_NONE;
bogdanm 0:eff01767de02 218 }
bogdanm 0:eff01767de02 219
bogdanm 0:eff01767de02 220 /**************************************************************************/
bogdanm 0:eff01767de02 221 /*!
bogdanm 0:eff01767de02 222 @brief Callback handler for events getting pushed up from the SD
bogdanm 0:eff01767de02 223 */
bogdanm 0:eff01767de02 224 /**************************************************************************/
Rohit Grover 6:bbb4357dc135 225 void nRF51GattServer::hwCallback(ble_evt_t *p_ble_evt)
bogdanm 0:eff01767de02 226 {
Rohit Grover 6:bbb4357dc135 227 uint16_t handle_value;
Rohit Grover 6:bbb4357dc135 228 GattServerEvents::gattEvent_t event;
bogdanm 0:eff01767de02 229
Rohit Grover 6:bbb4357dc135 230 switch (p_ble_evt->header.evt_id) {
bogdanm 0:eff01767de02 231 case BLE_GATTS_EVT_WRITE:
Rohit Grover 6:bbb4357dc135 232 /* There are 2 use case here: Values being updated & CCCD
Rohit Grover 6:bbb4357dc135 233 *(indicate/notify) enabled */
Rohit Grover 6:bbb4357dc135 234
Rohit Grover 6:bbb4357dc135 235 /* 1.) Handle CCCD changes */
Rohit Grover 6:bbb4357dc135 236 handle_value = p_ble_evt->evt.gatts_evt.params.write.handle;
Rohit Grover 6:bbb4357dc135 237 for (uint8_t i = 0; i<characteristicCount; i++) {
Rohit Grover 6:bbb4357dc135 238 if ((p_characteristics[i]->properties &
Rohit Grover 6:bbb4357dc135 239 (GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_INDICATE |
Rohit Grover 6:bbb4357dc135 240 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)) &&
Rohit Grover 6:bbb4357dc135 241 (nrfCharacteristicHandles[i].cccd_handle == handle_value)) {
Rohit Grover 6:bbb4357dc135 242 uint16_t cccd_value =
Rohit Grover 6:bbb4357dc135 243 (p_ble_evt->evt.gatts_evt.params.write.data[1] <<
Rohit Grover 6:bbb4357dc135 244 8) | p_ble_evt->evt.gatts_evt.params.write.data[0]; /*
Rohit Grover 6:bbb4357dc135 245 * Little Endian but M0 may
Rohit Grover 6:bbb4357dc135 246 * be mis-aligned */
bogdanm 0:eff01767de02 247
Rohit Grover 6:bbb4357dc135 248 if (((p_characteristics[i]->properties &
Rohit Grover 6:bbb4357dc135 249 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_INDICATE) &&
Rohit Grover 6:bbb4357dc135 250 (cccd_value & BLE_GATT_HVX_INDICATION)) ||
Rohit Grover 6:bbb4357dc135 251 ((p_characteristics[i]->properties &
Rohit Grover 6:bbb4357dc135 252 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY) &&
Rohit Grover 6:bbb4357dc135 253 (cccd_value & BLE_GATT_HVX_NOTIFICATION))) {
Rohit Grover 6:bbb4357dc135 254 event = GattServerEvents::GATT_EVENT_UPDATES_ENABLED;
Rohit Grover 6:bbb4357dc135 255 } else {
Rohit Grover 6:bbb4357dc135 256 event = GattServerEvents::GATT_EVENT_UPDATES_DISABLED;
Rohit Grover 6:bbb4357dc135 257 }
bogdanm 0:eff01767de02 258
Rohit Grover 6:bbb4357dc135 259 handleEvent(event, i);
Rohit Grover 6:bbb4357dc135 260 return;
Rohit Grover 6:bbb4357dc135 261 }
bogdanm 0:eff01767de02 262 }
bogdanm 0:eff01767de02 263
Rohit Grover 6:bbb4357dc135 264 /* 2.) Changes to the characteristic value will be handled with other
Rohit Grover 6:bbb4357dc135 265 *events below */
Rohit Grover 6:bbb4357dc135 266 event = GattServerEvents::GATT_EVENT_DATA_WRITTEN;
Rohit Grover 6:bbb4357dc135 267 break;
bogdanm 0:eff01767de02 268
bogdanm 0:eff01767de02 269 case BLE_GATTS_EVT_HVC:
Rohit Grover 6:bbb4357dc135 270 /* Indication confirmation received */
Rohit Grover 6:bbb4357dc135 271 event = GattServerEvents::GATT_EVENT_CONFIRMATION_RECEIVED;
Rohit Grover 6:bbb4357dc135 272 handle_value = p_ble_evt->evt.gatts_evt.params.hvc.handle;
Rohit Grover 6:bbb4357dc135 273 break;
bogdanm 0:eff01767de02 274
Rohit Grover 6:bbb4357dc135 275 default:
Rohit Grover 6:bbb4357dc135 276 return;
Rohit Grover 6:bbb4357dc135 277 }
bogdanm 0:eff01767de02 278
Rohit Grover 6:bbb4357dc135 279 /* Find index (charHandle) in the pool */
Rohit Grover 6:bbb4357dc135 280 for (uint8_t i = 0; i<characteristicCount; i++) {
Rohit Grover 6:bbb4357dc135 281 if (nrfCharacteristicHandles[i].value_handle == handle_value) {
Rohit Grover 6:bbb4357dc135 282 handleEvent(event, i);
Rohit Grover 6:bbb4357dc135 283 break;
Rohit Grover 6:bbb4357dc135 284 }
bogdanm 0:eff01767de02 285 }
bogdanm 0:eff01767de02 286 }