High level Bluetooth Low Energy API and radio abstraction layer
Fork of BLE_API by
source/DiscoveredCharacteristic.cpp@931:97e69faa4a5c, 2015-11-26 (annotated)
- Committer:
- rgrover1
- Date:
- Thu Nov 26 12:52:05 2015 +0000
- Revision:
- 931:97e69faa4a5c
- Parent:
- 930:d6883d67fcb3
- Child:
- 933:3ec277a0d780
Synchronized with git rev 381345fe
Author: Vincent Coubard
Allow user of GattClient to call write on a discovered characteristic with
the continuation function
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
rgrover1 | 712:b04b5db36865 | 1 | /* mbed Microcontroller Library |
rgrover1 | 712:b04b5db36865 | 2 | * Copyright (c) 2006-2013 ARM Limited |
rgrover1 | 712:b04b5db36865 | 3 | * |
rgrover1 | 712:b04b5db36865 | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
rgrover1 | 712:b04b5db36865 | 5 | * you may not use this file except in compliance with the License. |
rgrover1 | 712:b04b5db36865 | 6 | * You may obtain a copy of the License at |
rgrover1 | 712:b04b5db36865 | 7 | * |
rgrover1 | 712:b04b5db36865 | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
rgrover1 | 712:b04b5db36865 | 9 | * |
rgrover1 | 712:b04b5db36865 | 10 | * Unless required by applicable law or agreed to in writing, software |
rgrover1 | 712:b04b5db36865 | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
rgrover1 | 712:b04b5db36865 | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
rgrover1 | 712:b04b5db36865 | 13 | * See the License for the specific language governing permissions and |
rgrover1 | 712:b04b5db36865 | 14 | * limitations under the License. |
rgrover1 | 712:b04b5db36865 | 15 | */ |
rgrover1 | 712:b04b5db36865 | 16 | |
rgrover1 | 712:b04b5db36865 | 17 | #include "ble/DiscoveredCharacteristic.h" |
rgrover1 | 712:b04b5db36865 | 18 | #include "ble/GattClient.h" |
rgrover1 | 712:b04b5db36865 | 19 | |
rgrover1 | 712:b04b5db36865 | 20 | ble_error_t |
rgrover1 | 712:b04b5db36865 | 21 | DiscoveredCharacteristic::read(uint16_t offset) const |
rgrover1 | 712:b04b5db36865 | 22 | { |
rgrover1 | 712:b04b5db36865 | 23 | if (!props.read()) { |
rgrover1 | 712:b04b5db36865 | 24 | return BLE_ERROR_OPERATION_NOT_PERMITTED; |
rgrover1 | 712:b04b5db36865 | 25 | } |
rgrover1 | 712:b04b5db36865 | 26 | |
rgrover1 | 712:b04b5db36865 | 27 | if (!gattc) { |
rgrover1 | 712:b04b5db36865 | 28 | return BLE_ERROR_INVALID_STATE; |
rgrover1 | 712:b04b5db36865 | 29 | } |
rgrover1 | 712:b04b5db36865 | 30 | |
rgrover1 | 712:b04b5db36865 | 31 | return gattc->read(connHandle, valueHandle, offset); |
rgrover1 | 712:b04b5db36865 | 32 | } |
rgrover1 | 712:b04b5db36865 | 33 | |
rgrover1 | 929:918d93d409c1 | 34 | struct OneShotReadCallback { |
rgrover1 | 930:d6883d67fcb3 | 35 | static void launch(GattClient* client, Gap::Handle_t connHandle, |
rgrover1 | 930:d6883d67fcb3 | 36 | GattAttribute::Handle_t handle,const GattClient::ReadCallback_t& cb) { |
rgrover1 | 930:d6883d67fcb3 | 37 | OneShotReadCallback* oneShot = new OneShotReadCallback(client, connHandle, handle, cb); |
rgrover1 | 929:918d93d409c1 | 38 | oneShot->attach(); |
rgrover1 | 929:918d93d409c1 | 39 | // delete will be made when this callback is called |
rgrover1 | 929:918d93d409c1 | 40 | } |
rgrover1 | 929:918d93d409c1 | 41 | |
rgrover1 | 929:918d93d409c1 | 42 | private: |
rgrover1 | 930:d6883d67fcb3 | 43 | OneShotReadCallback(GattClient* client, Gap::Handle_t connHandle, |
rgrover1 | 930:d6883d67fcb3 | 44 | GattAttribute::Handle_t handle, const GattClient::ReadCallback_t& cb) : |
rgrover1 | 929:918d93d409c1 | 45 | _client(client), |
rgrover1 | 930:d6883d67fcb3 | 46 | _connHandle(connHandle), |
rgrover1 | 931:97e69faa4a5c | 47 | _handle(handle), |
rgrover1 | 929:918d93d409c1 | 48 | _callback(cb) { } |
rgrover1 | 929:918d93d409c1 | 49 | |
rgrover1 | 929:918d93d409c1 | 50 | void attach() { |
rgrover1 | 929:918d93d409c1 | 51 | _client->onDataRead(makeFunctionPointer(this, &OneShotReadCallback::call)); |
rgrover1 | 929:918d93d409c1 | 52 | } |
rgrover1 | 929:918d93d409c1 | 53 | |
rgrover1 | 930:d6883d67fcb3 | 54 | void call(const GattReadCallbackParams* params) { |
rgrover1 | 930:d6883d67fcb3 | 55 | // verifiy that it is the right characteristic on the right connection |
rgrover1 | 931:97e69faa4a5c | 56 | if (params->connHandle == _connHandle && params->handle == _handle) { |
rgrover1 | 930:d6883d67fcb3 | 57 | _callback(params); |
rgrover1 | 930:d6883d67fcb3 | 58 | _client->onDataRead().detach(makeFunctionPointer(this, &OneShotReadCallback::call)); |
rgrover1 | 930:d6883d67fcb3 | 59 | delete this; |
rgrover1 | 930:d6883d67fcb3 | 60 | } |
rgrover1 | 929:918d93d409c1 | 61 | } |
rgrover1 | 929:918d93d409c1 | 62 | |
rgrover1 | 929:918d93d409c1 | 63 | GattClient* _client; |
rgrover1 | 930:d6883d67fcb3 | 64 | Gap::Handle_t _connHandle; |
rgrover1 | 930:d6883d67fcb3 | 65 | GattAttribute::Handle_t _handle; |
rgrover1 | 929:918d93d409c1 | 66 | GattClient::ReadCallback_t _callback; |
rgrover1 | 929:918d93d409c1 | 67 | }; |
rgrover1 | 929:918d93d409c1 | 68 | |
rgrover1 | 929:918d93d409c1 | 69 | ble_error_t DiscoveredCharacteristic::read(uint16_t offset, const GattClient::ReadCallback_t& onRead) const { |
rgrover1 | 929:918d93d409c1 | 70 | ble_error_t error = read(offset); |
rgrover1 | 931:97e69faa4a5c | 71 | if (error) { |
rgrover1 | 929:918d93d409c1 | 72 | return error; |
rgrover1 | 929:918d93d409c1 | 73 | } |
rgrover1 | 929:918d93d409c1 | 74 | |
rgrover1 | 930:d6883d67fcb3 | 75 | OneShotReadCallback::launch(gattc, connHandle, valueHandle, onRead); |
rgrover1 | 929:918d93d409c1 | 76 | |
rgrover1 | 929:918d93d409c1 | 77 | return error; |
rgrover1 | 929:918d93d409c1 | 78 | } |
rgrover1 | 929:918d93d409c1 | 79 | |
rgrover1 | 712:b04b5db36865 | 80 | ble_error_t |
rgrover1 | 712:b04b5db36865 | 81 | DiscoveredCharacteristic::write(uint16_t length, const uint8_t *value) const |
rgrover1 | 712:b04b5db36865 | 82 | { |
rgrover1 | 712:b04b5db36865 | 83 | if (!props.write()) { |
rgrover1 | 712:b04b5db36865 | 84 | return BLE_ERROR_OPERATION_NOT_PERMITTED; |
rgrover1 | 712:b04b5db36865 | 85 | } |
rgrover1 | 712:b04b5db36865 | 86 | |
rgrover1 | 712:b04b5db36865 | 87 | if (!gattc) { |
rgrover1 | 712:b04b5db36865 | 88 | return BLE_ERROR_INVALID_STATE; |
rgrover1 | 712:b04b5db36865 | 89 | } |
rgrover1 | 712:b04b5db36865 | 90 | |
rgrover1 | 712:b04b5db36865 | 91 | return gattc->write(GattClient::GATT_OP_WRITE_REQ, connHandle, valueHandle, length, value); |
rgrover1 | 712:b04b5db36865 | 92 | } |
rgrover1 | 712:b04b5db36865 | 93 | |
rgrover1 | 712:b04b5db36865 | 94 | ble_error_t |
rgrover1 | 712:b04b5db36865 | 95 | DiscoveredCharacteristic::writeWoResponse(uint16_t length, const uint8_t *value) const |
rgrover1 | 712:b04b5db36865 | 96 | { |
rgrover1 | 712:b04b5db36865 | 97 | if (!props.writeWoResp()) { |
rgrover1 | 712:b04b5db36865 | 98 | return BLE_ERROR_OPERATION_NOT_PERMITTED; |
rgrover1 | 712:b04b5db36865 | 99 | } |
rgrover1 | 712:b04b5db36865 | 100 | |
rgrover1 | 712:b04b5db36865 | 101 | if (!gattc) { |
rgrover1 | 712:b04b5db36865 | 102 | return BLE_ERROR_INVALID_STATE; |
rgrover1 | 712:b04b5db36865 | 103 | } |
rgrover1 | 712:b04b5db36865 | 104 | |
rgrover1 | 712:b04b5db36865 | 105 | return gattc->write(GattClient::GATT_OP_WRITE_CMD, connHandle, valueHandle, length, value); |
rgrover1 | 712:b04b5db36865 | 106 | } |
rgrover1 | 712:b04b5db36865 | 107 | |
rgrover1 | 931:97e69faa4a5c | 108 | struct OneShotWriteCallback { |
rgrover1 | 931:97e69faa4a5c | 109 | static void launch(GattClient* client, Gap::Handle_t connHandle, |
rgrover1 | 931:97e69faa4a5c | 110 | GattAttribute::Handle_t handle,const GattClient::WriteCallback_t& cb) { |
rgrover1 | 931:97e69faa4a5c | 111 | OneShotWriteCallback* oneShot = new OneShotWriteCallback(client, connHandle, handle, cb); |
rgrover1 | 931:97e69faa4a5c | 112 | oneShot->attach(); |
rgrover1 | 931:97e69faa4a5c | 113 | // delete will be made when this callback is called |
rgrover1 | 931:97e69faa4a5c | 114 | } |
rgrover1 | 931:97e69faa4a5c | 115 | |
rgrover1 | 931:97e69faa4a5c | 116 | private: |
rgrover1 | 931:97e69faa4a5c | 117 | OneShotWriteCallback(GattClient* client, Gap::Handle_t connHandle, |
rgrover1 | 931:97e69faa4a5c | 118 | GattAttribute::Handle_t handle, const GattClient::WriteCallback_t& cb) : |
rgrover1 | 931:97e69faa4a5c | 119 | _client(client), |
rgrover1 | 931:97e69faa4a5c | 120 | _connHandle(connHandle), |
rgrover1 | 931:97e69faa4a5c | 121 | _handle(handle), |
rgrover1 | 931:97e69faa4a5c | 122 | _callback(cb) { } |
rgrover1 | 931:97e69faa4a5c | 123 | |
rgrover1 | 931:97e69faa4a5c | 124 | void attach() { |
rgrover1 | 931:97e69faa4a5c | 125 | _client->onDataWritten(makeFunctionPointer(this, &OneShotWriteCallback::call)); |
rgrover1 | 931:97e69faa4a5c | 126 | } |
rgrover1 | 931:97e69faa4a5c | 127 | |
rgrover1 | 931:97e69faa4a5c | 128 | void call(const GattWriteCallbackParams* params) { |
rgrover1 | 931:97e69faa4a5c | 129 | // verifiy that it is the right characteristic on the right connection |
rgrover1 | 931:97e69faa4a5c | 130 | if (params->connHandle == _connHandle && params->handle == _handle) { |
rgrover1 | 931:97e69faa4a5c | 131 | _callback(params); |
rgrover1 | 931:97e69faa4a5c | 132 | _client->onDataWritten().detach(makeFunctionPointer(this, &OneShotWriteCallback::call)); |
rgrover1 | 931:97e69faa4a5c | 133 | delete this; |
rgrover1 | 931:97e69faa4a5c | 134 | } |
rgrover1 | 931:97e69faa4a5c | 135 | } |
rgrover1 | 931:97e69faa4a5c | 136 | |
rgrover1 | 931:97e69faa4a5c | 137 | GattClient* _client; |
rgrover1 | 931:97e69faa4a5c | 138 | Gap::Handle_t _connHandle; |
rgrover1 | 931:97e69faa4a5c | 139 | GattAttribute::Handle_t _handle; |
rgrover1 | 931:97e69faa4a5c | 140 | GattClient::WriteCallback_t _callback; |
rgrover1 | 931:97e69faa4a5c | 141 | }; |
rgrover1 | 931:97e69faa4a5c | 142 | |
rgrover1 | 931:97e69faa4a5c | 143 | ble_error_t DiscoveredCharacteristic::write(uint16_t length, const uint8_t *value, const GattClient::WriteCallback_t& onRead) const { |
rgrover1 | 931:97e69faa4a5c | 144 | ble_error_t error = write(length, value); |
rgrover1 | 931:97e69faa4a5c | 145 | if (error) { |
rgrover1 | 931:97e69faa4a5c | 146 | return error; |
rgrover1 | 931:97e69faa4a5c | 147 | } |
rgrover1 | 931:97e69faa4a5c | 148 | |
rgrover1 | 931:97e69faa4a5c | 149 | OneShotWriteCallback::launch(gattc, connHandle, valueHandle, onRead); |
rgrover1 | 931:97e69faa4a5c | 150 | |
rgrover1 | 931:97e69faa4a5c | 151 | return error; |
rgrover1 | 931:97e69faa4a5c | 152 | } |
rgrover1 | 931:97e69faa4a5c | 153 | |
rgrover1 | 712:b04b5db36865 | 154 | ble_error_t |
rgrover1 | 712:b04b5db36865 | 155 | DiscoveredCharacteristic::discoverDescriptors(DescriptorCallback_t callback, const UUID &matchingUUID) const |
rgrover1 | 712:b04b5db36865 | 156 | { |
rgrover1 | 712:b04b5db36865 | 157 | return BLE_ERROR_NOT_IMPLEMENTED; /* TODO: this needs to be filled in. */ |
rgrover1 | 712:b04b5db36865 | 158 | } |