Michael Galis / 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

nRFDiscoveredCharacteristic.h@333:8eedcd324853, 2015-06-19 (annotated)

Committer:
rgrover1
Date:
Fri Jun 19 15:55:32 2015 +0100
Revision:
333:8eedcd324853
Parent:
332:b054000833d4
Child:
338:b5ea3c879e6e
Synchronized with git rev f49e3469

Author: Rohit Grover

setup save of GattClient pointer in DiscoveredClient

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 315:044071756a8d 1 /* mbed Microcontroller Library
rgrover1 315:044071756a8d 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 315:044071756a8d 3 *
rgrover1 315:044071756a8d 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 315:044071756a8d 5 * you may not use this file except in compliance with the License.
rgrover1 315:044071756a8d 6 * You may obtain a copy of the License at
rgrover1 315:044071756a8d 7 *
rgrover1 315:044071756a8d 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 315:044071756a8d 9 *
rgrover1 315:044071756a8d 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 315:044071756a8d 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 315:044071756a8d 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 315:044071756a8d 13 * See the License for the specific language governing permissions and
rgrover1 315:044071756a8d 14 * limitations under the License.
rgrover1 315:044071756a8d 15 */
rgrover1 315:044071756a8d 16
rgrover1 315:044071756a8d 17 #ifndef __NRF_DISCOVERED_CHARACTERISTIC_H__
rgrover1 315:044071756a8d 18 #define __NRF_DISCOVERED_CHARACTERISTIC_H__
rgrover1 315:044071756a8d 19
rgrover1 333:8eedcd324853 20 #include "DiscoveredCharacteristic.h"
rgrover1 332:b054000833d4 21 #include "ble_gatt.h"
rgrover1 332:b054000833d4 22
rgrover1 333:8eedcd324853 23 class nRF51GattClient; /* forward declaration */
rgrover1 333:8eedcd324853 24
rgrover1 315:044071756a8d 25 class nRFDiscoveredCharacteristic : public DiscoveredCharacteristic {
rgrover1 315:044071756a8d 26 public:
rgrover1 333:8eedcd324853 27 void setup(nRF51GattClient *gattcIn,
rgrover1 330:0a8ebc25b57c 28 Gap::Handle_t connectionHandleIn,
rgrover1 330:0a8ebc25b57c 29 ble_gatt_char_props_t propsIn,
rgrover1 330:0a8ebc25b57c 30 GattAttribute::Handle_t declHandleIn,
rgrover1 333:8eedcd324853 31 GattAttribute::Handle_t valueHandleIn);
rgrover1 325:eb6914dca928 32
rgrover1 333:8eedcd324853 33 void setup(nRF51GattClient *gattcIn,
rgrover1 330:0a8ebc25b57c 34 Gap::Handle_t connectionHandleIn,
rgrover1 330:0a8ebc25b57c 35 UUID::ShortUUIDBytes_t uuidIn,
rgrover1 330:0a8ebc25b57c 36 ble_gatt_char_props_t propsIn,
rgrover1 330:0a8ebc25b57c 37 GattAttribute::Handle_t declHandleIn,
rgrover1 333:8eedcd324853 38 GattAttribute::Handle_t valueHandleIn);
rgrover1 315:044071756a8d 39
rgrover1 327:0ea2b4d48212 40 #if 0
rgrover1 315:044071756a8d 41 public:
rgrover1 315:044071756a8d 42 /**
rgrover1 315:044071756a8d 43 * Initiate (or continue) a read for the value attribute, optionally at a
rgrover1 315:044071756a8d 44 * given offset. If the Characteristic or Descriptor to be read is longer
rgrover1 315:044071756a8d 45 * than ATT_MTU - 1, this function must be called multiple times with
rgrover1 315:044071756a8d 46 * appropriate offset to read the complete value.
rgrover1 315:044071756a8d 47 *
rgrover1 315:044071756a8d 48 * @return BLE_ERROR_NONE if a read has been initiated, else
rgrover1 315:044071756a8d 49 * BLE_ERROR_INVALID_STATE if some internal state about the connection is invalid, or
rgrover1 326:77dd705571e2 50 * BLE_STACK_BUSY if some client procedure already in progress, or
rgrover1 326:77dd705571e2 51 * BLE_ERROR_OPERATION_NOT_PERMITTED due to the characteristic's properties.
rgrover1 315:044071756a8d 52 */
rgrover1 315:044071756a8d 53 virtual ble_error_t read(uint16_t offset = 0) const {
rgrover1 327:0ea2b4d48212 54
rgrover1 327:0ea2b4d48212 55 printf("in nRFDiscoveredCharacteristic::read\r\n");
rgrover1 327:0ea2b4d48212 56 ble_error_t err = DiscoveredCharacteristic::read(offset);
rgrover1 327:0ea2b4d48212 57 if (err != BLE_ERROR_NONE) {
rgrover1 327:0ea2b4d48212 58 return err;
rgrover1 326:77dd705571e2 59 }
rgrover1 326:77dd705571e2 60
rgrover1 315:044071756a8d 61 uint32_t rc = sd_ble_gattc_read(connHandle, valueHandle, offset);
rgrover1 315:044071756a8d 62 if (rc == NRF_SUCCESS) {
rgrover1 315:044071756a8d 63 return BLE_ERROR_NONE;
rgrover1 315:044071756a8d 64 }
rgrover1 315:044071756a8d 65 switch (rc) {
rgrover1 315:044071756a8d 66 case NRF_ERROR_BUSY:
rgrover1 315:044071756a8d 67 return BLE_STACK_BUSY;
rgrover1 315:044071756a8d 68 case BLE_ERROR_INVALID_CONN_HANDLE:
rgrover1 315:044071756a8d 69 case NRF_ERROR_INVALID_STATE:
rgrover1 315:044071756a8d 70 case NRF_ERROR_INVALID_ADDR:
rgrover1 315:044071756a8d 71 default:
rgrover1 315:044071756a8d 72 return BLE_ERROR_INVALID_STATE;
rgrover1 315:044071756a8d 73 }
rgrover1 315:044071756a8d 74 }
rgrover1 324:1cb5b26ecaca 75
rgrover1 324:1cb5b26ecaca 76 /**
rgrover1 324:1cb5b26ecaca 77 * Perform a write without response procedure.
rgrover1 324:1cb5b26ecaca 78 *
rgrover1 324:1cb5b26ecaca 79 * @param length
rgrover1 324:1cb5b26ecaca 80 * The amount of data being written.
rgrover1 324:1cb5b26ecaca 81 * @param value
rgrover1 324:1cb5b26ecaca 82 * The bytes being written.
rgrover1 324:1cb5b26ecaca 83 *
rgrover1 324:1cb5b26ecaca 84 * @note It is important to note that a write without response will
rgrover1 324:1cb5b26ecaca 85 * <b>consume an application buffer</b>, and will therefore
rgrover1 324:1cb5b26ecaca 86 * generate a onDataWritten() callback when the packet has been
rgrover1 324:1cb5b26ecaca 87 * transmitted. The application should ensure that the buffer is
rgrover1 324:1cb5b26ecaca 88 * valid until the callback.
rgrover1 324:1cb5b26ecaca 89 *
rgrover1 324:1cb5b26ecaca 90 * @retval BLE_ERROR_NONE Successfully started the Write procedure, else
rgrover1 324:1cb5b26ecaca 91 * BLE_ERROR_INVALID_STATE if some internal state about the connection is invalid, or
rgrover1 324:1cb5b26ecaca 92 * BLE_STACK_BUSY if some client procedure already in progress, or
rgrover1 326:77dd705571e2 93 * BLE_ERROR_NO_MEM if there are no available buffers left to process the request or
rgrover1 326:77dd705571e2 94 * BLE_ERROR_OPERATION_NOT_PERMITTED due to the characteristic's properties.
rgrover1 324:1cb5b26ecaca 95 */
rgrover1 324:1cb5b26ecaca 96 virtual ble_error_t writeWoResponse(uint16_t length, const uint8_t *value) const {
rgrover1 327:0ea2b4d48212 97 ble_error_t err = DiscoveredCharacteristic::writeWoResponse(length, value);
rgrover1 327:0ea2b4d48212 98 if (err != BLE_ERROR_NONE) {
rgrover1 327:0ea2b4d48212 99 return err;
rgrover1 326:77dd705571e2 100 }
rgrover1 326:77dd705571e2 101
rgrover1 324:1cb5b26ecaca 102 ble_gattc_write_params_t writeParams = {
rgrover1 324:1cb5b26ecaca 103 .write_op = BLE_GATT_OP_WRITE_CMD,
rgrover1 324:1cb5b26ecaca 104 // .flags = 0,
rgrover1 324:1cb5b26ecaca 105 .handle = valueHandle,
rgrover1 324:1cb5b26ecaca 106 .offset = 0,
rgrover1 324:1cb5b26ecaca 107 .len = length,
rgrover1 324:1cb5b26ecaca 108 .p_value = const_cast<uint8_t *>(value),
rgrover1 324:1cb5b26ecaca 109 };
rgrover1 324:1cb5b26ecaca 110
rgrover1 324:1cb5b26ecaca 111 uint32_t rc = sd_ble_gattc_write(connHandle, &writeParams);
rgrover1 324:1cb5b26ecaca 112 if (rc == NRF_SUCCESS) {
rgrover1 324:1cb5b26ecaca 113 return BLE_ERROR_NONE;
rgrover1 324:1cb5b26ecaca 114 }
rgrover1 324:1cb5b26ecaca 115 switch (rc) {
rgrover1 324:1cb5b26ecaca 116 case NRF_ERROR_BUSY:
rgrover1 324:1cb5b26ecaca 117 return BLE_STACK_BUSY;
rgrover1 324:1cb5b26ecaca 118 case BLE_ERROR_NO_TX_BUFFERS:
rgrover1 324:1cb5b26ecaca 119 return BLE_ERROR_NO_MEM;
rgrover1 324:1cb5b26ecaca 120 case BLE_ERROR_INVALID_CONN_HANDLE:
rgrover1 324:1cb5b26ecaca 121 case NRF_ERROR_INVALID_STATE:
rgrover1 324:1cb5b26ecaca 122 case NRF_ERROR_INVALID_ADDR:
rgrover1 324:1cb5b26ecaca 123 default:
rgrover1 324:1cb5b26ecaca 124 return BLE_ERROR_INVALID_STATE;
rgrover1 324:1cb5b26ecaca 125 }
rgrover1 324:1cb5b26ecaca 126 }
rgrover1 327:0ea2b4d48212 127 #endif
rgrover1 315:044071756a8d 128 };
rgrover1 315:044071756a8d 129
rgrover1 315:044071756a8d 130 #endif /* __NRF_DISCOVERED_CHARACTERISTIC_H__ */