btleCharacteristicRead()

The function tries to read a characteristic from the service.

Synopsis

int btleCharacteristicRead(int serviceId, string uuid, mapping &data);

Parameters

Parameter Description
serviceId The Id of the service.
uuid The UUID of the characteristic.
data Mapping to save the received data. This is dependent on the characteristic addressed

Return Value

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

-1 ... illegal arguments passed

1 ... OperationError

4 ... UnknownError

5 ... CharacteristicReadError

Description

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

When the characteristic was read, the mapping contains the data as described in the btleServiceConnect().callback key "characteristics".

Assignment

Mobile UI control functions

Availability

UI