ScStw/esp-nimble-cpp
2
0
Fork 0
mirror of https://github.com/h2zero/esp-nimble-cpp.git synced 2024-10-22 16:09:44 +02:00
Code Issues Projects Releases Packages Wiki Activity
esp-nimble-cpp/src/NimBLERemoteCharacteristic.h

116 lines
5 KiB
C
Raw Normal View History

Initial commit.
2020-03-30 01:44:20 +02:00
/*
* NimBLERemoteCharacteristic.h
*
* Created: on Jan 27 2020
* Author H2zero
Conditionally compile code for specific roles. This allows NimBLE options in menuconfig to reduce code size based on the roles selected (scan/advertising/central/peripheral). Significant code space can be saved by removing unnecessary roles for the application.
2020-05-14 06:03:56 +02:00
*
Initial commit.
2020-03-30 01:44:20 +02:00
* Originally:
*
* BLERemoteCharacteristic.h
*
* Created on: Jul 8, 2017
* Author: kolban
*/
#ifndef COMPONENTS_NIMBLEREMOTECHARACTERISTIC_H_
#define COMPONENTS_NIMBLEREMOTECHARACTERISTIC_H_
#include "sdkconfig.h"
#if defined(CONFIG_BT_ENABLED)
Conditionally compile code for specific roles. This allows NimBLE options in menuconfig to reduce code size based on the roles selected (scan/advertising/central/peripheral). Significant code space can be saved by removing unnecessary roles for the application.
2020-05-14 06:03:56 +02:00
#include "nimconfig.h"
#if defined( CONFIG_BT_NIMBLE_ROLE_CENTRAL)
Initial commit.
2020-03-30 01:44:20 +02:00
#include "NimBLERemoteService.h"
#include "NimBLERemoteDescriptor.h"
Breaking: Use std::vector instead of std::map in client classes (#46) * Exchange map for vector, saving 1,076 bytes of program memory and 5,024 bytes of heap for a small device (LYWSD03MMC) * Removing m_characteristicMapByHandle (using the handles form m_characteristicVector instead) saving in total (compared to the current master) 1,508 bytes of program memory and 6,500 bytes of heap for a small device (LYWSD03MMC) * Change NimBLEScan container from std::map to std::vector * Add function to get advertised device by address * Update documentation
2020-05-18 04:21:35 +02:00
#include <vector>
Initial commit.
2020-03-30 01:44:20 +02:00
class NimBLERemoteService;
class NimBLERemoteDescriptor;
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
typedef void (*notify_callback)(NimBLERemoteCharacteristic* pBLERemoteCharacteristic,
uint8_t* pData, size_t length, bool isNotify);
Initial commit.
2020-03-30 01:44:20 +02:00
/**
* @brief A model of a remote %BLE characteristic.
*/
class NimBLERemoteCharacteristic {
public:
~NimBLERemoteCharacteristic();
// Public member functions
Add iterators to client remote attributes. Add iterators for NimBLEScan: NimBLEadvertisedDevice, NimBLEClient: NimBLERemoteService, NimBLERemoteService: NimBLERemoteCharacteristic and NimBLERemoteCharacteristic: NimBLERemoteDescriptor This is handy e.g. for showing every address of the advertised devices from a scan. To do so, first get a new scan and next: ``` for(auto pAdvertisedDevice: pBLEScan->getResults()) { Serial.printf("Address is %s\n", std::string(pAdvertisedDevice->getAddress()).c_str()); } ``` Of course any other property of the advertised device can be shown (or looked up, if that is your use case) Also this is handy e.g. for showing every UUID in a peripheral. To do so, first connect to a peripheral and next: ``` for(auto pService: *pClient) { Serial.printf("Service UUID is %s\n", std::string(pService->getUUID()).c_str()); for(auto pCharacteristic: *pService) { Serial.printf("Characteristic UUID is %s\n", std::string(pCharacteristic->getUUID()).c_str()); for(auto pDescriptor: *pCharacteristic) { Serial.printf("Descriptor UUID is %s\n", std::string(pDescriptor->getUUID()).c_str()); } } } ``` Again of course any other property can be shown, or looked up.
2020-05-23 04:13:52 +02:00
bool canBroadcast();
bool canIndicate();
bool canNotify();
bool canRead();
bool canWrite();
bool canWriteNoResponse();
std::vector<NimBLERemoteDescriptor*>::iterator begin();
std::vector<NimBLERemoteDescriptor*>::iterator end();
NimBLERemoteDescriptor* getDescriptor(const NimBLEUUID &uuid);
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
std::vector<NimBLERemoteDescriptor*>* getDescriptors(bool refresh = false);
Add iterators to client remote attributes. Add iterators for NimBLEScan: NimBLEadvertisedDevice, NimBLEClient: NimBLERemoteService, NimBLERemoteService: NimBLERemoteCharacteristic and NimBLERemoteCharacteristic: NimBLERemoteDescriptor This is handy e.g. for showing every address of the advertised devices from a scan. To do so, first get a new scan and next: ``` for(auto pAdvertisedDevice: pBLEScan->getResults()) { Serial.printf("Address is %s\n", std::string(pAdvertisedDevice->getAddress()).c_str()); } ``` Of course any other property of the advertised device can be shown (or looked up, if that is your use case) Also this is handy e.g. for showing every UUID in a peripheral. To do so, first connect to a peripheral and next: ``` for(auto pService: *pClient) { Serial.printf("Service UUID is %s\n", std::string(pService->getUUID()).c_str()); for(auto pCharacteristic: *pService) { Serial.printf("Characteristic UUID is %s\n", std::string(pCharacteristic->getUUID()).c_str()); for(auto pDescriptor: *pCharacteristic) { Serial.printf("Descriptor UUID is %s\n", std::string(pDescriptor->getUUID()).c_str()); } } } ``` Again of course any other property can be shown, or looked up.
2020-05-23 04:13:52 +02:00
uint16_t getHandle();
uint16_t getDefHandle();
NimBLEUUID getUUID();
std::string readValue();
uint8_t readUInt8();
uint16_t readUInt16();
uint32_t readUInt32();
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
bool registerForNotify(notify_callback _callback,
bool notifications = true,
bool response = true);
bool writeValue(const uint8_t* data,
size_t length,
bool response = false);
bool writeValue(const std::string &newValue,
bool response = false);
bool writeValue(uint8_t newValue,
bool response = false);
Add iterators to client remote attributes. Add iterators for NimBLEScan: NimBLEadvertisedDevice, NimBLEClient: NimBLERemoteService, NimBLERemoteService: NimBLERemoteCharacteristic and NimBLERemoteCharacteristic: NimBLERemoteDescriptor This is handy e.g. for showing every address of the advertised devices from a scan. To do so, first get a new scan and next: ``` for(auto pAdvertisedDevice: pBLEScan->getResults()) { Serial.printf("Address is %s\n", std::string(pAdvertisedDevice->getAddress()).c_str()); } ``` Of course any other property of the advertised device can be shown (or looked up, if that is your use case) Also this is handy e.g. for showing every UUID in a peripheral. To do so, first connect to a peripheral and next: ``` for(auto pService: *pClient) { Serial.printf("Service UUID is %s\n", std::string(pService->getUUID()).c_str()); for(auto pCharacteristic: *pService) { Serial.printf("Characteristic UUID is %s\n", std::string(pCharacteristic->getUUID()).c_str()); for(auto pDescriptor: *pCharacteristic) { Serial.printf("Descriptor UUID is %s\n", std::string(pDescriptor->getUUID()).c_str()); } } } ``` Again of course any other property can be shown, or looked up.
2020-05-23 04:13:52 +02:00
std::string toString();
uint8_t* readRawData();
size_t getDataLength();
NimBLERemoteService* getRemoteService();
Initial commit.
2020-03-30 01:44:20 +02:00
private:
NimBLERemoteCharacteristic(NimBLERemoteService *pRemoteservice, const struct ble_gatt_chr *chr);
Conditionally compile code for specific roles. This allows NimBLE options in menuconfig to reduce code size based on the roles selected (scan/advertising/central/peripheral). Significant code space can be saved by removing unnecessary roles for the application.
2020-05-14 06:03:56 +02:00
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
friend class NimBLEClient;
friend class NimBLERemoteService;
friend class NimBLERemoteDescriptor;
Initial commit.
2020-03-30 01:44:20 +02:00
// Private member functions
void removeDescriptors();
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
bool retrieveDescriptors(const NimBLEUUID *uuid_filter = nullptr);
static int onReadCB(uint16_t conn_handle, const struct ble_gatt_error *error,
struct ble_gatt_attr *attr, void *arg);
static int onWriteCB(uint16_t conn_handle, const struct ble_gatt_error *error,
struct ble_gatt_attr *attr, void *arg);
Initial commit.
2020-03-30 01:44:20 +02:00
void releaseSemaphores();
static int descriptorDiscCB(uint16_t conn_handle, const struct ble_gatt_error *error,
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
uint16_t chr_val_handle, const struct ble_gatt_dsc *dsc,
void *arg);
Conditionally compile code for specific roles. This allows NimBLE options in menuconfig to reduce code size based on the roles selected (scan/advertising/central/peripheral). Significant code space can be saved by removing unnecessary roles for the application.
2020-05-14 06:03:56 +02:00
Initial commit.
2020-03-30 01:44:20 +02:00
// Private properties
NimBLEUUID m_uuid;
uint8_t m_charProp;
uint16_t m_handle;
uint16_t m_defHandle;
NimBLERemoteService* m_pRemoteService;
FreeRTOS::Semaphore m_semaphoreGetDescEvt = FreeRTOS::Semaphore("GetDescEvt");
FreeRTOS::Semaphore m_semaphoreReadCharEvt = FreeRTOS::Semaphore("ReadCharEvt");
FreeRTOS::Semaphore m_semaphoreWriteCharEvt = FreeRTOS::Semaphore("WriteCharEvt");
std::string m_value;
Implement client long read / write Client will now read/write long characteristics and descriptors.
2020-05-08 03:47:41 +02:00
uint8_t* m_rawData;
size_t m_dataLen;
Initial commit.
2020-03-30 01:44:20 +02:00
notify_callback m_notifyCallback;
Breaking: Use std::vector instead of std::map in client classes (#46) * Exchange map for vector, saving 1,076 bytes of program memory and 5,024 bytes of heap for a small device (LYWSD03MMC) * Removing m_characteristicMapByHandle (using the handles form m_characteristicVector instead) saving in total (compared to the current master) 1,508 bytes of program memory and 6,500 bytes of heap for a small device (LYWSD03MMC) * Change NimBLEScan container from std::map to std::vector * Add function to get advertised device by address * Update documentation
2020-05-18 04:21:35 +02:00
// We maintain a vector of descriptors owned by this characteristic.
std::vector<NimBLERemoteDescriptor*> m_descriptorVector;
Remove automatic discovery in NimBLEClient::connect(). Instead of discovering the peripheral database on connection and consuming the associated resources this will give the user more control over the discovery operation. * Adds void NimBLEClient::discoverAtrributes() for the user to discover all the peripheral attributes as a replacement for the former functionality. * getServices(), getCharacteristics(), getDescriptors() now take an optional bool parameter (default false). If true it will clear the respective vector and retrieve all the respective attributes from the peripheral. If false it will retrieve the attributes only if the vector is empty, otherwise the vector is returned with the currently stored attributes. * getService(NimBLEUUID), getCharacteristic(NimBLEUUID), getDescriptor(NimBLEUUID) will now check the respective vectors for the attribute object and, if not found, will retrieve (only) the specified attribute from the peripheral.
2020-05-23 18:27:32 +02:00
}; // NimBLERemoteCharacteristic
Conditionally compile code for specific roles. This allows NimBLE options in menuconfig to reduce code size based on the roles selected (scan/advertising/central/peripheral). Significant code space can be saved by removing unnecessary roles for the application.
2020-05-14 06:03:56 +02:00
#endif // #if defined( CONFIG_BT_NIMBLE_ROLE_CENTRAL)
Initial commit.
2020-03-30 01:44:20 +02:00
#endif /* CONFIG_BT_ENABLED */
#endif /* COMPONENTS_NIMBLEREMOTECHARACTERISTIC_H_ */
Reference in a new issue Copy permalink