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

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

-1 ... illegal arguments passed

1 ... OperationError

4 ... UnknownError

5 ... CharacteristicReadError

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".

Mobile UI control functions