com.tacttiles.api

Class Device

java.lang.Object

com.tacttiles.api.Device

public class Device
extends java.lang.Object

A Device is a hardware abstraction that handles the low level communication protocol used in devices compatibles with the Tact-Tiles platform.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Device.DeviceListener A device listener receives notifications of new data available in the Device object.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	D_DRAW_GESTURE
static java.lang.String	D_MESSAGE_RECEIVED
static java.lang.String	D_OUTPUT_STATE
static java.lang.String	D_START_DRAW
static java.lang.String	D_STATE_ADDRESS
static byte	DEVICE_INFO_NAME
static byte	DEVICE_INFO_TYPE
static java.lang.String	G_BUTTON_PRESS
static java.lang.String	G_DOUBLE_TOUCH
static java.lang.String	G_ID
static java.lang.String	G_SINGLE_TOUCH
static char	M_DEBUG
static char	M_ERROR
static char	M_GESTURE
static char	M_SYSTEM
static java.lang.String	S_ANALOG_READ
static java.lang.String	S_CHARGER_CONNECTED
static java.lang.String	S_DIGITAL_READ
static java.lang.String	S_DRAW_FINISHED
static java.lang.String	S_EEPROM_DUMP
static java.lang.String	S_FREE_RAM
static java.lang.String	S_PONG_MESSAGE
static java.lang.String	S_POWER_OFF
static java.lang.String	S_SYSTEM_VOLTAGE

Constructor Summary

Constructors

Constructor and Description
Device()

Method Summary

Modifier and Type	Method and Description
void	addListener(Device.DeviceListener deviceListener) Adds a listener to the current set of event listeners of this adapter.
void	connect(Context appContext) Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access.
RuntimeConnection	getServiceConnection() Returns the service connection of this device.
protected void	onDeviceFound() Called when the bluetooth device is connected.
protected void	onDeviceLost() Called when the bluetooth device connection is lost or the device is not connected.
protected void	onMessage(java.lang.String msg) Called when a bluetooth message is received by the runtime service and this device is properly connected.
void	powerOff() Power the connected device off.
void	removeListener(Device.DeviceListener deviceListener) Removes a listener from the set listening to this adapter.
void	requestBatteryStatus() Request the battery status.
void	send(byte[] msg) Send a low level message to the physical device.
void	send(java.lang.String msg) Send a low level message to the physical device in a more human readable form.
void	setTouchSensibility(int sensibility) Sets the touch sensibility of the device's tiles.
void	vibrateDevice(int times, int duration) Vibrates the physical device.

Methods inherited from class java.lang.Object

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

Field Detail

M_SYSTEM

public static final char M_SYSTEM

See Also:

Constant Field Values

M_ERROR

public static final char M_ERROR

See Also:

Constant Field Values

M_DEBUG

public static final char M_DEBUG

See Also:

Constant Field Values

M_GESTURE

public static final char M_GESTURE

See Also:

Constant Field Values

S_PONG_MESSAGE

public static final java.lang.String S_PONG_MESSAGE

See Also:

Constant Field Values

S_POWER_OFF

public static final java.lang.String S_POWER_OFF

See Also:

Constant Field Values

S_CHARGER_CONNECTED

public static final java.lang.String S_CHARGER_CONNECTED

See Also:

Constant Field Values

S_DRAW_FINISHED

public static final java.lang.String S_DRAW_FINISHED

See Also:

Constant Field Values

S_EEPROM_DUMP

public static final java.lang.String S_EEPROM_DUMP

See Also:

Constant Field Values

S_ANALOG_READ

public static final java.lang.String S_ANALOG_READ

See Also:

Constant Field Values

S_DIGITAL_READ

public static final java.lang.String S_DIGITAL_READ

See Also:

Constant Field Values

S_FREE_RAM

public static final java.lang.String S_FREE_RAM

See Also:

Constant Field Values

S_SYSTEM_VOLTAGE

public static final java.lang.String S_SYSTEM_VOLTAGE

See Also:

Constant Field Values

G_ID

public static final java.lang.String G_ID

See Also:

Constant Field Values

G_DOUBLE_TOUCH

public static final java.lang.String G_DOUBLE_TOUCH

See Also:

Constant Field Values

G_SINGLE_TOUCH

public static final java.lang.String G_SINGLE_TOUCH

See Also:

Constant Field Values

G_BUTTON_PRESS

public static final java.lang.String G_BUTTON_PRESS

See Also:

Constant Field Values

D_DRAW_GESTURE

public static final java.lang.String D_DRAW_GESTURE

See Also:

Constant Field Values

D_MESSAGE_RECEIVED

public static final java.lang.String D_MESSAGE_RECEIVED

See Also:

Constant Field Values

D_OUTPUT_STATE

public static final java.lang.String D_OUTPUT_STATE

See Also:

Constant Field Values

D_START_DRAW

public static final java.lang.String D_START_DRAW

See Also:

Constant Field Values

D_STATE_ADDRESS

public static final java.lang.String D_STATE_ADDRESS

See Also:

Constant Field Values

DEVICE_INFO_NAME

public static byte DEVICE_INFO_NAME

DEVICE_INFO_TYPE

public static byte DEVICE_INFO_TYPE

Constructor Detail

Device

public Device()

Method Detail

getServiceConnection

public RuntimeConnection getServiceConnection()

Returns the service connection of this device.

Returns:

The service connection of this device.

addListener

public void addListener(Device.DeviceListener deviceListener)

Adds a listener to the current set of event listeners of this adapter. Events can be system status or user interaction related events.

Parameters:

deviceListener - The listener to be added to the current set of listeners on this adapter.

removeListener

public void removeListener(Device.DeviceListener deviceListener)

Removes a listener from the set listening to this adapter.

Parameters:

deviceListener - The listener to be removed to the current set of listeners on this adapter.

connect

public void connect(Context appContext)

Connects this adapter to the Tact-Tiles runtime service, which handles the bluetooth communication and device access.

Parameters:

appContext - The current context of this application.

onMessage

protected void onMessage(java.lang.String msg)

Called when a bluetooth message is received by the runtime service and this device is properly connected.

Parameters:

msg - Message contents.

onDeviceFound

protected void onDeviceFound()

Called when the bluetooth device is connected.

onDeviceLost

protected void onDeviceLost()

Called when the bluetooth device connection is lost or the device is not connected.

powerOff

public void powerOff()

Power the connected device off.

requestBatteryStatus

public void requestBatteryStatus()

Request the battery status.

vibrateDevice

public void vibrateDevice(int times,
                          int duration)

Vibrates the physical device.

Parameters:

times - Number of pulses.

duration - Duration in milliseconds of the on and off state.

setTouchSensibility

public void setTouchSensibility(int sensibility)

Sets the touch sensibility of the device's tiles. The value passed is proportional to the sensibility.

Parameters:

sensibility - Integer in the range [0, 16].

send

public void send(byte[] msg)

Send a low level message to the physical device.

Parameters:

msg - Message to be sent.

send

public void send(java.lang.String msg)

Send a low level message to the physical device in a more human readable form.

Parameters:

msg - Message to be sent.