Class: Toybox.BluetoothLowEnergy.Characteristic

Inherits:

Toybox.Lang.Object

• Toybox.Lang.Object
• Toybox.BluetoothLowEnergy.Characteristic

Overview

Encapsulates a characteristic on a service

Since:

API Level 3.1.0

Instance Method Summary

• getDescriptor(uuid as BluetoothLowEnergy.Uuid) as BluetoothLowEnergy.Descriptor or Null

  Retrieves the Descriptor with a specified UUID.

• getDescriptors() as BluetoothLowEnergy.Iterator

  Retrieves an Iterator over the Descriptors discovered in the Characteristic This will only provide descriptors that have been registered using registerProfile().

• getService() as BluetoothLowEnergy.Service

  Retrieves the Characteristic's Service Retrieve the Service that this characteristic belongs to.

• getUuid() as BluetoothLowEnergy.Uuid

  Return the UUID of the Characteristic.

• requestRead() as Void

  Requests a read operation on the characteristic Once the operation is completed, onCharacteristicRead() will be called on the registered BleDelegate with the status of the operation Support for long reads is not implemented.

• requestWrite(value as Lang.ByteArray, options as { :writeType as BluetoothLowEnergy.WriteType }) as Void

  Requests a write operation Once the operation is completed, onCharacteristicWrite() will be called on the registered BleDelegate with the status of the operation Support for long writes is not implemented.

Instance Method Details

getDescriptor(uuid as BluetoothLowEnergy.Uuid) as BluetoothLowEnergy.Descriptor or Null

Retrieves the Descriptor with a specified UUID

Parameters:

• uuid — (BluetoothLowEnergy.Uuid) —

  the UUID to search for.

Returns:

• BluetoothLowEnergy.Descriptor —

  The Descriptor represented by the UUID provided or, null if the descriptor does not exist or the UUID has not be registered.

Since:

API Level 3.1.0

getDescriptors() as BluetoothLowEnergy.Iterator

Retrieves an Iterator over the Descriptors discovered in the Characteristic

This will only provide descriptors that have been registered using registerProfile()

Returns:

• BluetoothLowEnergy.Iterator —

  Iterator of Descriptor objects for the descriptors discovered in the Characteristic

Since:

API Level 3.1.0

getService() as BluetoothLowEnergy.Service

Retrieves the Characteristic's Service

Retrieve the Service that this characteristic belongs to

Returns:

• BluetoothLowEnergy.Service —

  Parent characteristic object

Since:

API Level 3.1.0

getUuid() as BluetoothLowEnergy.Uuid

Return the UUID of the Characteristic

Returns:

• BluetoothLowEnergy.Uuid —

  The UUID of the Characteristic

Since:

API Level 3.1.0

requestRead() as Void

Requests a read operation on the characteristic

Once the operation is completed, onCharacteristicRead() will be called on the registered BleDelegate with the status of the operation

Support for long reads is not implemented.

Since:

API Level 3.1.0

requestWrite(value as Lang.ByteArray, options as { :writeType as BluetoothLowEnergy.WriteType }) as Void

Requests a write operation

Once the operation is completed, onCharacteristicWrite() will be called on the registered BleDelegate with the status of the operation

Support for long writes is not implemented. Requesting a write on a characteristic longer than 20 bytes will cause an InvalidRequestException

Parameters:

• value — (Lang.ByteArray) —

  New value to store.

• options — (Lang.Dictionary) —

  A Dictionary containing write options

  • :writeType — (BluetoothLowEnergy.WriteType) —

    A WRITE_TYPE_* indicating the write type to use when writing to the characteristic. Cannot be null.

Since:

API Level 3.1.0

Throws:

• (BluetoothLowEnergy.InvalidRequestException) —

  if the request is invalid