com.openxc.interfaces.bluetooth

Class DeviceManager

java.lang.Object

com.openxc.interfaces.bluetooth.DeviceManager

public class DeviceManager
extends java.lang.Object

The DeviceManager collects the functions required to connect to and open a socket to the Bluetooth device.

The device must be previously bonded, as this class does not initiate discovery.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	KNOWN_BLUETOOTH_DEVICE_PREF_KEY
static java.lang.String	KNOWN_BLUETOOTH_DEVICE_PREFERENCES
static java.lang.String	LAST_CONNECTED_BLUETOOTH_DEVICE_PREF_KEY
static int	MAX_WRITE_BUFFER_CAPACITY
static int	PACKET_SENDING_WAIT_TIME_MS
static java.util.UUID	RFCOMM_UUID

Constructor Summary

Constructors

Constructor and Description
DeviceManager(android.content.Context context) The DeviceManager requires an Android Context in order to send the intent to enable Bluetooth if it isn't already on.

Method Summary

Modifier and Type	Method and Description
android.bluetooth.BluetoothSocket	connect(android.bluetooth.BluetoothDevice device)
android.bluetooth.BluetoothSocket	connect(java.lang.String targetAddress) Connect to the target device and open a socket.
android.bluetooth.BluetoothGatt	connectBLE(android.bluetooth.BluetoothDevice device)
android.bluetooth.BluetoothGatt	connectBLE(java.lang.String address)
java.util.Set<android.bluetooth.BluetoothDevice>	getCandidateDevices()
android.bluetooth.BluetoothDevice	getLastConnectedDevice()
java.util.Set<android.bluetooth.BluetoothDevice>	getPairedDevices()
boolean	isBLEConnected() This is used to get the connection status using gatt callback
boolean	isBLEDevice(android.bluetooth.BluetoothDevice device)
boolean	isBLEDevice(java.lang.String address)
boolean	isBLEDisconnected()
boolean	isConnecting()
android.bluetooth.BluetoothServerSocket	listen()
void	startDiscovery()
void	stop() Immediately cancel any pending Bluetooth operations.
void	storeLastConnectedDevice(android.bluetooth.BluetoothDevice device)
boolean	writeCharacteristicToBLE(byte[] bytes)

Methods inherited from class java.lang.Object

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

Field Detail

KNOWN_BLUETOOTH_DEVICE_PREFERENCES

public static final java.lang.String KNOWN_BLUETOOTH_DEVICE_PREFERENCES

See Also:

Constant Field Values

KNOWN_BLUETOOTH_DEVICE_PREF_KEY

public static final java.lang.String KNOWN_BLUETOOTH_DEVICE_PREF_KEY

See Also:

Constant Field Values

LAST_CONNECTED_BLUETOOTH_DEVICE_PREF_KEY

public static final java.lang.String LAST_CONNECTED_BLUETOOTH_DEVICE_PREF_KEY

See Also:

Constant Field Values

RFCOMM_UUID

public static final java.util.UUID RFCOMM_UUID

MAX_WRITE_BUFFER_CAPACITY

public static final int MAX_WRITE_BUFFER_CAPACITY

See Also:

Constant Field Values

PACKET_SENDING_WAIT_TIME_MS

public static final int PACKET_SENDING_WAIT_TIME_MS

See Also:

Constant Field Values

Constructor Detail

DeviceManager

public DeviceManager(android.content.Context context)
              throws BluetoothException

The DeviceManager requires an Android Context in order to send the intent to enable Bluetooth if it isn't already on.

Throws:

BluetoothException

Method Detail

startDiscovery

public void startDiscovery()

listen

public android.bluetooth.BluetoothServerSocket listen()

connect

public android.bluetooth.BluetoothSocket connect(java.lang.String targetAddress)
                                          throws BluetoothException

Connect to the target device and open a socket. This method will block while waiting for the device.

Returns a socket connected to the device.

Throws:

BluetoothException

connect

public android.bluetooth.BluetoothSocket connect(android.bluetooth.BluetoothDevice device)
                                          throws BluetoothException

Throws:

BluetoothException

stop

public void stop()

Immediately cancel any pending Bluetooth operations.

The BluetoothSocket.connect() function blocks while waiting for a connection, but it's thread safe and we can cancel that by calling close() on it at any time.

Importantly we don't want to close the socket any other time, because we want to leave that up to the user of the socket - if you call close() twice, or close Input/Output streams associated with the socket simultaneously, it can cause a segfault due to a bug in some Android Bluetooth stacks. Awesome!

getPairedDevices

public java.util.Set<android.bluetooth.BluetoothDevice> getPairedDevices()

storeLastConnectedDevice

public void storeLastConnectedDevice(android.bluetooth.BluetoothDevice device)

getLastConnectedDevice

public android.bluetooth.BluetoothDevice getLastConnectedDevice()

getCandidateDevices

public java.util.Set<android.bluetooth.BluetoothDevice> getCandidateDevices()

isConnecting

public boolean isConnecting()

isBLEDevice

public boolean isBLEDevice(java.lang.String address)

isBLEDevice

public boolean isBLEDevice(android.bluetooth.BluetoothDevice device)

connectBLE

public android.bluetooth.BluetoothGatt connectBLE(java.lang.String address)
                                           throws BluetoothException

Throws:

BluetoothException

connectBLE

public android.bluetooth.BluetoothGatt connectBLE(android.bluetooth.BluetoothDevice device)
                                           throws BluetoothException

Throws:

BluetoothException

isBLEConnected

public boolean isBLEConnected()

This is used to get the connection status using gatt callback

Returns:

boolean value indicating

isBLEDisconnected

public boolean isBLEDisconnected()

writeCharacteristicToBLE

public boolean writeCharacteristicToBLE(byte[] bytes)