BLEDescriptor.h

/*
 * BLEDescriptor.h
 *
 *  Created on: Jun 22, 2017
 *      Author: kolban
 */

#ifndef COMPONENTS_CPP_UTILS_BLEDESCRIPTOR_H_
#define COMPONENTS_CPP_UTILS_BLEDESCRIPTOR_H_
#include "sdkconfig.h"
#if defined(CONFIG_BT_ENABLED)
#include <string>
#include "BLEUUID.h"
#include "BLECharacteristic.h"
#include <esp_gatts_api.h>
#include "FreeRTOS.h"

class BLEService;
class BLECharacteristic;
class BLEDescriptorCallbacks;

class BLEDescriptor {
public:
    BLEDescriptor(const char* uuid, uint16_t max_len = 100);
    BLEDescriptor(BLEUUID uuid, uint16_t max_len = 100);
    virtual ~BLEDescriptor();

    uint16_t getHandle();                                   // Get the handle of the descriptor.
    size_t   getLength();                                   // Get the length of the value of the descriptor.
    BLEUUID  getUUID();                                     // Get the UUID of the descriptor.
    uint8_t* getValue();                                    // Get a pointer to the value of the descriptor.
    void handleGATTServerEvent(
            esp_gatts_cb_event_t      event,
            esp_gatt_if_t             gatts_if,
            esp_ble_gatts_cb_param_t* param);

    void setAccessPermissions(esp_gatt_perm_t perm);          // Set the permissions of the descriptor.
    void setCallbacks(BLEDescriptorCallbacks* pCallbacks);  // Set callbacks to be invoked for the descriptor.
    void setValue(uint8_t* data, size_t size);              // Set the value of the descriptor as a pointer to data.
    void setValue(std::string value);                       // Set the value of the descriptor as a data buffer.

    std::string toString();                                 // Convert the descriptor to a string representation.

private:
    friend class BLEDescriptorMap;
    friend class BLECharacteristic;
    BLEUUID                 m_bleUUID;
    uint16_t                m_handle;
    BLEDescriptorCallbacks* m_pCallback;
    BLECharacteristic*      m_pCharacteristic;
    esp_gatt_perm_t               m_permissions = ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE;
    FreeRTOS::Semaphore     m_semaphoreCreateEvt = FreeRTOS::Semaphore("CreateEvt");
    esp_attr_value_t        m_value;

    void executeCreate(BLECharacteristic* pCharacteristic);
    void setHandle(uint16_t handle);
}; // BLEDescriptor


class BLEDescriptorCallbacks {
public:
    virtual ~BLEDescriptorCallbacks();
    virtual void onRead(BLEDescriptor* pDescriptor);
    virtual void onWrite(BLEDescriptor* pDescriptor);
};
#endif /* CONFIG_BT_ENABLED */
#endif /* COMPONENTS_CPP_UTILS_BLEDESCRIPTOR_H_ */