NimBLEDescriptor.h

/*
 * NimBLEDescriptor.h
 *
 *  Created: on March 10, 2020
 *      Author H2zero
 *
 * Originally:
 *
 * BLEDescriptor.h
 *
 *  Created on: Jun 22, 2017
 *      Author: kolban
 */
 
#ifndef MAIN_NIMBLEDESCRIPTOR_H_
#define MAIN_NIMBLEDESCRIPTOR_H_
 
#include "nimconfig.h"
#if defined(CONFIG_BT_ENABLED) && defined(CONFIG_BT_NIMBLE_ROLE_PERIPHERAL)
 
#include "NimBLECharacteristic.h"
#include "NimBLEUUID.h"
#include "NimBLEAttValue.h"
 
#include <string>
 
class NimBLEService;
class NimBLECharacteristic;
class NimBLEDescriptorCallbacks;
 
 
class NimBLEDescriptor {
public:
    NimBLEDescriptor(const char* uuid, uint16_t properties,
                     uint16_t max_len,
                     NimBLECharacteristic* pCharacteristic = nullptr);
 
    NimBLEDescriptor(NimBLEUUID uuid, uint16_t properties,
                     uint16_t max_len,
                     NimBLECharacteristic* pCharacteristic = nullptr);
 
    ~NimBLEDescriptor();
 
    uint16_t              getHandle();
    NimBLEUUID            getUUID();
    std::string           toString();
    void                  setCallbacks(NimBLEDescriptorCallbacks* pCallbacks);
    NimBLECharacteristic* getCharacteristic();
 
    size_t                getLength();
    NimBLEAttValue        getValue(time_t *timestamp = nullptr);
    std::string           getStringValue();
 
    void                  setValue(const uint8_t* data, size_t size);
    void                  setValue(const std::vector<uint8_t>& vec);
 
    /*********************** Template Functions ************************/
 
    template<typename T>
    void setValue(const T &s) { m_value.setValue<T>(s); }
 
    template<typename T>
    T getValue(time_t *timestamp = nullptr, bool skipSizeCheck = false) {
        return m_value.getValue<T>(timestamp, skipSizeCheck);
    }
 
private:
    friend class NimBLECharacteristic;
    friend class NimBLEService;
    friend class NimBLE2904;
 
    static int handleGapEvent(uint16_t conn_handle, uint16_t attr_handle,
                              struct ble_gatt_access_ctxt *ctxt, void *arg);
    void       setHandle(uint16_t handle);
    void       setCharacteristic(NimBLECharacteristic* pChar);
 
    NimBLEUUID                 m_uuid;
    uint16_t                   m_handle;
    NimBLEDescriptorCallbacks* m_pCallbacks;
    NimBLECharacteristic*      m_pCharacteristic;
    uint8_t                    m_properties;
    NimBLEAttValue             m_value;
    uint8_t                    m_removed;
}; // NimBLEDescriptor
 
 
class NimBLEDescriptorCallbacks {
public:
    virtual ~NimBLEDescriptorCallbacks();
    virtual void onRead(NimBLEDescriptor* pDescriptor);
    virtual void onWrite(NimBLEDescriptor* pDescriptor);
};
 
#include "NimBLE2904.h"
 
#endif /* CONFIG_BT_ENABLED && CONFIG_BT_NIMBLE_ROLE_PERIPHERAL */
#endif /* MAIN_NIMBLEDESCRIPTOR_H_ */