Mbed OS Reference
Loading...
Searching...
No Matches
DiscoveredCharacteristicDescriptor Class Reference

Representation of a characteristic descriptor discovered. More...

#include <DiscoveredCharacteristicDescriptor.h>

Public Member Functions

 DiscoveredCharacteristicDescriptor (ble::GattClient *client, ble::connection_handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, const UUID &uuid)
 Construct a new instance of a DiscoveredCharacteristicDescriptor. More...
 
ble::GattClientgetGattClient ()
 Return the ble::GattClient, which can operate on this descriptor. More...
 
const ble::GattClientgetGattClient () const
 Return the ble::GattClient, which can operate on this descriptor. More...
 
ble::connection_handle_t getConnectionHandle () const
 Return the connection handle to the GattServer containing this descriptor. More...
 
const UUIDgetUUID () const
 Return the UUID of this descriptor. More...
 
GattAttribute::Handle_t getAttributeHandle () const
 Return the attribute handle of this descriptor. More...
 

Detailed Description

Representation of a characteristic descriptor discovered.

Characteristic descriptors can be seen as the metadata of the characteristic. They can contain things such as the unit of the characteristic value, extra permission informations or the Client Configuration state in regard to notification or indication.

The descriptors of a characterstic are discovered by a Characteristic Descriptor Discovery Procedure, which can be initiated by either ble::GattClient::discoverCharacteristicDescriptors() or DiscoveredCharacteristic::discoverDescriptors().

The discovery procedure returns the UUID of the descriptor (its type) and its handle.

Read and write of the descriptor value can be initiated by ble::GattClient::read and ble::GattClient::write.

Definition at line 63 of file gatt/DiscoveredCharacteristicDescriptor.h.

Constructor & Destructor Documentation

◆ DiscoveredCharacteristicDescriptor()

DiscoveredCharacteristicDescriptor ( ble::GattClient client,
ble::connection_handle_t  connectionHandle,
GattAttribute::Handle_t  attributeHandle,
const UUID uuid 
)

Construct a new instance of a DiscoveredCharacteristicDescriptor.

Parameters
[in]clientThe client that has discovered the descriptor.
[in]connectionHandleHandle of the connection to the GATT server containing the descriptor.
[in]attributeHandleGATT attribute handle of the descriptor.
[in]uuidUUID of the descriptor.
Note
This constructor is not meant to be called directly by application code. The ble::GattClient class generates descriptors discovered.

Definition at line 79 of file gatt/DiscoveredCharacteristicDescriptor.h.

Member Function Documentation

◆ getGattClient() [1/2]

ble::GattClient * getGattClient ( )

Return the ble::GattClient, which can operate on this descriptor.

Returns
ble::GattClient, which can operate on this descriptor.

Definition at line 95 of file gatt/DiscoveredCharacteristicDescriptor.h.

◆ getGattClient() [2/2]

const ble::GattClient * getGattClient ( ) const

Return the ble::GattClient, which can operate on this descriptor.

Returns
ble::GattClient, which can operate on this descriptor.

Definition at line 105 of file gatt/DiscoveredCharacteristicDescriptor.h.

◆ getConnectionHandle()

ble::connection_handle_t getConnectionHandle ( ) const

Return the connection handle to the GattServer containing this descriptor.

Returns
the connection handle to the GattServer containing this descriptor.

Definition at line 117 of file gatt/DiscoveredCharacteristicDescriptor.h.

◆ getUUID()

const UUID & getUUID ( ) const

Return the UUID of this descriptor.

Returns
UUID of this descriptor.

Definition at line 127 of file gatt/DiscoveredCharacteristicDescriptor.h.

◆ getAttributeHandle()

GattAttribute::Handle_t getAttributeHandle ( ) const

Return the attribute handle of this descriptor.

This attribute handle can be used to interact with the descriptor on its gatt server.

Returns
Attribute handle of the descriptor

Definition at line 140 of file gatt/DiscoveredCharacteristicDescriptor.h.