btleDescriptorRead()

The function will try to read a descriptor from a service.

Synopsis

int btleDescriptorRead(int serviceId, string characteristicUUID, string uuid, mapping &data);

Parameters

Parameter Description
serviceId The Id of the Service
CharacteristicUUID The uuid of the characteristic.
uuid The uuid of the descriptor.
data The cached descriptor value.

Return Value

Returns 0 on success. On error the return value is one of:

-1 ... illegal arguments passed

1 ... OperationError

4 ... UnknownError

6 ... DescriptorReadError

Description

The function will try to read a descriptor from a characteristic, given by its uuid, from the service, which must be connected by a call to btleServiceConnect().

When the descriptor was read, the mapping contains the data as described in the btleServiceConnect() key "descriptors".

Assignment

Mobile UI control functions

Availability

UI

See also

btleDescriptorWrite(), btleServiceConnect()