Class: Toybox.BluetoothLowEnergy.Device

Inherits:

Toybox.Lang.Object

• Toybox.Lang.Object
• Toybox.BluetoothLowEnergy.Device

Overview

Represents a Bluetooth Low Energy Device that has been paired with the system.

This class cannot be instantiated, access to paired system devices is done through the use of BluetoothLowEnergy.getPairedDevices() or by calling BluetoothLowEnergy.pairDevice() after receiving a ScanResult for a device

Since:

API Level 3.1.0

Instance Method Summary

• getName() as Lang.String or Null

  Retrieves the Name of the sensor according to the device name that is available in the GAP Service.

• getService(uuid as BluetoothLowEnergy.Uuid) as BluetoothLowEnergy.Service or Null

  Retrieves the service with a specified UUID If access to a specific service is required, use this function to directly access the service based on a UUID.

• getServices() as BluetoothLowEnergy.Iterator

  Retrieves an Iterator over the services provided by the device.

• isConnected() as Lang.Boolean

  Gets the connected status of the device.

Instance Method Details

getName() as Lang.String or Null

Retrieves the Name of the sensor according to the device name that is available in the GAP Service

Returns:

• Lang.String —

  the name of the device. null if the device is not connected or name has not been received yet.

Since:

API Level 3.1.0

getService(uuid as BluetoothLowEnergy.Uuid) as BluetoothLowEnergy.Service or Null

Retrieves the service with a specified UUID

If access to a specific service is required, use this function to directly access the service based on a UUID.

Parameters:

• uuid — (BluetoothLowEnergy.Uuid) —

  The UUID of the service to search for

Returns:

• BluetoothLowEnergy.Service —

  The service represented by the UUID if the service exists or, null if the service does not exist or the UUID has not been registered

Since:

API Level 3.1.0

getServices() as BluetoothLowEnergy.Iterator

Retrieves an Iterator over the services provided by the device.

This will only provide Services that have been registered using BluetoothLowEnergy.registerProfile()

Returns:

• BluetoothLowEnergy.Iterator —

  Iterator of Service objects provided by a device.

Since:

API Level 3.1.0

isConnected() as Lang.Boolean

Gets the connected status of the device

Returns:

• Lang.Boolean —

  true if the sensor is connected false if sensor is disconnected

Since:

API Level 3.1.0