totalcross.io.device.bluetooth

Class RemoteDevice

java.lang.Object

totalcross.io.device.bluetooth.RemoteDevice

public class RemoteDevice
extends java.lang.Object

The RemoteDevice class represents a remote Bluetooth device. It provides basic information about a remote device including the device's Bluetooth address and its friendly name.

Since:

TotalCross 1.15

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RemoteDevice(java.lang.String address) Creates a Bluetooth device based upon its address.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBluetoothAddress() Retrieves the Bluetooth address of this device.
java.lang.String	getFriendlyName() Returns the name of this device.
java.lang.String	toString() Returns a string representation of the object in the format "address - friendlyName".

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RemoteDevice

protected RemoteDevice(java.lang.String address)

Creates a Bluetooth device based upon its address. The Bluetooth address must be 12 hex characters long. Valid characters are 0-9, a-f, and A-F. There is no preceding "0x" in the string. For example, valid Bluetooth addresses include but are not limited to:
008037144297
00af8300cd0b
014bd91DA8FC

Parameters:

address - the address of the Bluetooth device as a 12 character hex string

Since:

TotalCross 1.15

Method Detail

getFriendlyName

public java.lang.String getFriendlyName()
                                 throws IOException

Returns the name of this device. The Bluetooth specification calls this name the "Bluetooth device name" or the "user-friendly name".

Returns:

the name of the device, or null if the Bluetooth system does not support this feature; if the local device is able to contact the remote device, the result will never be null; if the remote device does not have a name then an empty string will be returned

Throws:

IOException

Since:

TotalCross 1.15

getBluetoothAddress

public java.lang.String getBluetoothAddress()

Retrieves the Bluetooth address of this device. The Bluetooth address will be 12 characters long. Valid characters are 0-9 and A-F. This method will never return null.

Returns:

the Bluetooth address of the remote device

Since:

TotalCross 1.15

toString

public java.lang.String toString()

Returns a string representation of the object in the format "address - friendlyName".

Overrides:

toString in class java.lang.Object

Returns:

a string representation of the object in the format "address - friendlyName"

Since:

TotalCross 1.30