com.digi.xbee.api

Class DataReader

java.lang.Object

java.lang.Thread

com.digi.xbee.api.DataReader

All Implemented Interfaces:

Runnable

public class DataReader
extends Thread

Thread that constantly reads data from an input stream.

Depending on the XBee operating mode, read data is notified as is to the subscribed listeners or is parsed to a packet using the packet parser and then notified to subscribed listeners.

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
DataReader(IConnectionInterface connectionInterface, OperatingMode mode, AbstractXBeeDevice xbeeDevice) Class constructor.

Method Summary

Modifier and Type	Method and Description
void	addBluetoothDataReceiveListener(IBluetoothDataReceiveListener listener) Adds the given data receive listener to the list of listeners that will be notified when new data from the Bluetooth interface is received in a User Data Relay frame.
void	addDataReceiveListener(IDataReceiveListener listener) Adds the given data receive listener to the list of listeners that will be notified when XBee data packets are received.
void	addExplicitDataReceiveListener(IExplicitDataReceiveListener listener) Adds the given explicit data receive listener to the list of listeners that will be notified when an explicit data packet is received.
void	addIOSampleReceiveListener(IIOSampleReceiveListener listener) Adds the given IO sample receive listener to the list of listeners that will be notified when an IO sample packet is received.
void	addIPDataReceiveListener(IIPDataReceiveListener listener) Adds the given IP data receive listener to the list of listeners that will be notified when a IP data packet is received.
void	addMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener listener) Adds the given data receive listener to the list of listeners that will be notified when new data from the MicroPython interface is received in a User Data Relay frame.
void	addModemStatusReceiveListener(IModemStatusReceiveListener listener) Adds the given Modem Status receive listener to the list of listeners that will be notified when a modem status packet is received.
void	addPacketReceiveListener(IPacketReceiveListener listener) Adds the given packet receive listener to the list of listeners that will be notified when any XBee packet is received.
void	addPacketReceiveListener(IPacketReceiveListener listener, int frameID) Adds the given packet receive listener to the list of listeners that will be notified when an XBee packet with the given frame ID is received.
void	addSerialDataReceiveListener(ISerialDataReceiveListener listener) Adds the given data receive listener to the list of listeners that will be notified when new data from the serial interface is received in a User Data Relay frame.
void	addSMSReceiveListener(ISMSReceiveListener listener) Adds the given SMS receive listener to the list of listeners that will be notified when an SMS packet is received.
void	addUserDataRelayReceiveListener(IUserDataRelayReceiveListener listener) Adds the given User Data Relay receive listener to the list of listeners that will be notified when a User Data Relay packet is received.
RemoteXBeeDevice	getRemoteXBeeDeviceFromPacket(XBeeAPIPacket packet) Returns the remote XBee device from where the given package was sent from.
XBeePacketsQueue	getXBeePacketsQueue() Returns the queue of read XBee packets.
boolean	isRunning() Returns whether this Data reader is running or not.
void	removeBluetoothDataReceiveListener(IBluetoothDataReceiveListener listener) Removes the given data receive listener from the list of data receive listeners for the Bluetooth interface.
void	removeDataReceiveListener(IDataReceiveListener listener) Removes the given data receive listener from the list of data receive listeners.
void	removeExplicitDataReceiveListener(IExplicitDataReceiveListener listener) Removes the given explicit data receive listener from the list of explicit data receive listeners.
void	removeIOSampleReceiveListener(IIOSampleReceiveListener listener) Removes the given IO sample receive listener from the list of IO sample receive listeners.
void	removeIPDataReceiveListener(IIPDataReceiveListener listener) Removes the given IP data receive listener from the list of IP data receive listeners.
void	removeMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener listener) Removes the given data receive listener from the list of data receive listeners for the MicroPython interface.
void	removeModemStatusReceiveListener(IModemStatusReceiveListener listener) Removes the given Modem Status receive listener from the list of Modem Status receive listeners.
void	removePacketReceiveListener(IPacketReceiveListener listener) Removes the given packet receive listener from the list of XBee packet receive listeners.
void	removeSerialDataReceiveListener(ISerialDataReceiveListener listener) Removes the given data receive listener from the list of data receive listeners for the serial interface.
void	removeSMSReceiveListener(ISMSReceiveListener listener) Removes the given SMS receive listener from the list of SMS receive listeners.
void	removeUserDataRelayReceiveListener(IUserDataRelayReceiveListener listener) Removes the given User Data Relay receive listener from the list of User Data Relay receive listeners.
void	run()
void	setXBeeReaderMode(OperatingMode mode) Sets the XBee operating mode of this data reader.
void	stopReader() Stops the Data reader thread.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DataReader

public DataReader(IConnectionInterface connectionInterface,
                  OperatingMode mode,
                  AbstractXBeeDevice xbeeDevice)

Class constructor. Instantiates a new DataReader object for the given connection interface using the given XBee operating mode and XBee device.

Parameters:

connectionInterface - Connection interface to read data from.

mode - XBee operating mode.

xbeeDevice - Reference to the XBee device containing this DataReader object.

Throws:

NullPointerException - if connectionInterface == null or mode == null.

IllegalArgumentException - If xbeeDevice.isRemote() == true.

See Also:

IConnectionInterface, XBeeDevice, OperatingMode

Method Detail

addBluetoothDataReceiveListener

public void addBluetoothDataReceiveListener(IBluetoothDataReceiveListener listener)

Adds the given data receive listener to the list of listeners that will be notified when new data from the Bluetooth interface is received in a User Data Relay frame.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new data from the Bluetooth interface is received.

Throws:

NullPointerException - if listener == null.

Since:

1.3.0

See Also:

removeBluetoothDataReceiveListener(IBluetoothDataReceiveListener), IBluetoothDataReceiveListener

addDataReceiveListener

public void addDataReceiveListener(IDataReceiveListener listener)

Adds the given data receive listener to the list of listeners that will be notified when XBee data packets are received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new XBee data packets are received.

Throws:

NullPointerException - if listener == null.

See Also:

removeDataReceiveListener(IDataReceiveListener), IDataReceiveListener

addExplicitDataReceiveListener

public void addExplicitDataReceiveListener(IExplicitDataReceiveListener listener)

Adds the given explicit data receive listener to the list of listeners that will be notified when an explicit data packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new explicit data packets are received.

Throws:

NullPointerException - if listener == null.

See Also:

removeExplicitDataReceiveListener(IExplicitDataReceiveListener), IExplicitDataReceiveListener

addIOSampleReceiveListener

public void addIOSampleReceiveListener(IIOSampleReceiveListener listener)

Adds the given IO sample receive listener to the list of listeners that will be notified when an IO sample packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new IO sample packets are received.

Throws:

NullPointerException - if listener == null.

See Also:

removeIOSampleReceiveListener(IIOSampleReceiveListener), IIOSampleReceiveListener

addIPDataReceiveListener

public void addIPDataReceiveListener(IIPDataReceiveListener listener)

Adds the given IP data receive listener to the list of listeners that will be notified when a IP data packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new IP data packets are received.

Throws:

NullPointerException - if listener == null.

Since:

1.2.0

See Also:

removeIPDataReceiveListener(IIPDataReceiveListener), IIPDataReceiveListener

addMicroPythonDataReceiveListener

public void addMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener listener)

Adds the given data receive listener to the list of listeners that will be notified when new data from the MicroPython interface is received in a User Data Relay frame.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new data from the MicroPython interface is received.

Throws:

NullPointerException - if listener == null.

Since:

1.3.0

See Also:

removeMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener), IMicroPythonDataReceiveListener

addModemStatusReceiveListener

public void addModemStatusReceiveListener(IModemStatusReceiveListener listener)

Adds the given Modem Status receive listener to the list of listeners that will be notified when a modem status packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new modem status packets are received.

Throws:

NullPointerException - if listener == null.

See Also:

removeModemStatusReceiveListener(IModemStatusReceiveListener), IModemStatusReceiveListener

addPacketReceiveListener

public void addPacketReceiveListener(IPacketReceiveListener listener)

Adds the given packet receive listener to the list of listeners that will be notified when any XBee packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when any XBee packet is received.

Throws:

NullPointerException - if listener == null.

See Also:

addPacketReceiveListener(IPacketReceiveListener, int), removePacketReceiveListener(IPacketReceiveListener), IPacketReceiveListener

addPacketReceiveListener

public void addPacketReceiveListener(IPacketReceiveListener listener,
                                     int frameID)

Adds the given packet receive listener to the list of listeners that will be notified when an XBee packet with the given frame ID is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when an XBee packet with the provided frame ID is received.

frameID - Frame ID for which this listener should be notified and removed after. Using ALL_FRAME_IDS this listener will be notified always and will be removed only by user request.

Throws:

NullPointerException - if listener == null.

See Also:

addPacketReceiveListener(IPacketReceiveListener), removePacketReceiveListener(IPacketReceiveListener), IPacketReceiveListener

addSerialDataReceiveListener

public void addSerialDataReceiveListener(ISerialDataReceiveListener listener)

Adds the given data receive listener to the list of listeners that will be notified when new data from the serial interface is received in a User Data Relay frame.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new data from the serial interface is received.

Throws:

NullPointerException - if listener == null.

Since:

1.3.0

See Also:

removeSerialDataReceiveListener(ISerialDataReceiveListener), ISerialDataReceiveListener

addSMSReceiveListener

public void addSMSReceiveListener(ISMSReceiveListener listener)

Adds the given SMS receive listener to the list of listeners that will be notified when an SMS packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new SMS packet is received.

Throws:

NullPointerException - if listener == null.

Since:

1.2.0

See Also:

removeSMSReceiveListener(ISMSReceiveListener), ISMSReceiveListener

addUserDataRelayReceiveListener

public void addUserDataRelayReceiveListener(IUserDataRelayReceiveListener listener)

Adds the given User Data Relay receive listener to the list of listeners that will be notified when a User Data Relay packet is received.

If the listener has been already added, this method does nothing.

Parameters:

listener - Listener to be notified when new User Data Relay packet is received.

Throws:

NullPointerException - if listener == null.

Since:

1.3.0

See Also:

removeUserDataRelayReceiveListener(IUserDataRelayReceiveListener), IUserDataRelayReceiveListener

getRemoteXBeeDeviceFromPacket

public RemoteXBeeDevice getRemoteXBeeDeviceFromPacket(XBeeAPIPacket packet)
                                               throws XBeeException

Returns the remote XBee device from where the given package was sent from.

This is for internal use only.

If the package does not contain information about the source, this method returns null (for example, ModemStatusPacket).

First the device that sent the provided package is looked in the network of the local XBee device. If the remote device is not in the network, it is automatically added only if the packet contains information about the origin of the package.

Parameters:

packet - The packet sent from the remote device.

Returns:

The remote XBee device that sends the given packet. It may be null if the packet is not a known frame (see APIFrameType) or if it does not contain information of the source device.

Throws:

NullPointerException - if packet == null

XBeeException - if any error occur while adding the device to the network.

getXBeePacketsQueue

public XBeePacketsQueue getXBeePacketsQueue()

Returns the queue of read XBee packets.

Returns:

The queue of read XBee packets.

See Also:

XBeePacketsQueue

isRunning

public boolean isRunning()

Returns whether this Data reader is running or not.

Returns:

true if the Data reader is running, false otherwise.

See Also:

stopReader()

removeBluetoothDataReceiveListener

public void removeBluetoothDataReceiveListener(IBluetoothDataReceiveListener listener)

Removes the given data receive listener from the list of data receive listeners for the Bluetooth interface.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Data receive listener to remove from the list.

Since:

1.3.0

See Also:

addBluetoothDataReceiveListener(IBluetoothDataReceiveListener), IBluetoothDataReceiveListener

removeDataReceiveListener

public void removeDataReceiveListener(IDataReceiveListener listener)

Removes the given data receive listener from the list of data receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Data receive listener to be remove from the list.

See Also:

addDataReceiveListener(IDataReceiveListener), IDataReceiveListener

removeExplicitDataReceiveListener

public void removeExplicitDataReceiveListener(IExplicitDataReceiveListener listener)

Removes the given explicit data receive listener from the list of explicit data receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Explicit data receive listener to remove from the list.

See Also:

addExplicitDataReceiveListener(IExplicitDataReceiveListener), IExplicitDataReceiveListener

removeIOSampleReceiveListener

public void removeIOSampleReceiveListener(IIOSampleReceiveListener listener)

Removes the given IO sample receive listener from the list of IO sample receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - IO sample receive listener to remove from the list.

See Also:

addIOSampleReceiveListener(IIOSampleReceiveListener), IIOSampleReceiveListener

removeIPDataReceiveListener

public void removeIPDataReceiveListener(IIPDataReceiveListener listener)

Removes the given IP data receive listener from the list of IP data receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - IP data receive listener to remove from the list.

Since:

1.2.0

See Also:

addIPDataReceiveListener(IIPDataReceiveListener), IIPDataReceiveListener

removeMicroPythonDataReceiveListener

public void removeMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener listener)

Removes the given data receive listener from the list of data receive listeners for the MicroPython interface.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Data receive listener to remove from the list.

Since:

1.3.0

See Also:

addMicroPythonDataReceiveListener(IMicroPythonDataReceiveListener), IMicroPythonDataReceiveListener

removeModemStatusReceiveListener

public void removeModemStatusReceiveListener(IModemStatusReceiveListener listener)

Removes the given Modem Status receive listener from the list of Modem Status receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Modem Status receive listener to remove from the list.

See Also:

addModemStatusReceiveListener(IModemStatusReceiveListener), IModemStatusReceiveListener

removePacketReceiveListener

public void removePacketReceiveListener(IPacketReceiveListener listener)

Removes the given packet receive listener from the list of XBee packet receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Packet receive listener to remove from the list.

See Also:

addPacketReceiveListener(IPacketReceiveListener), addPacketReceiveListener(IPacketReceiveListener, int), IPacketReceiveListener

removeSerialDataReceiveListener

public void removeSerialDataReceiveListener(ISerialDataReceiveListener listener)

Removes the given data receive listener from the list of data receive listeners for the serial interface.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - Data receive listener to remove from the list.

Since:

1.3.0

See Also:

addSerialDataReceiveListener(ISerialDataReceiveListener), ISerialDataReceiveListener

removeSMSReceiveListener

public void removeSMSReceiveListener(ISMSReceiveListener listener)

Removes the given SMS receive listener from the list of SMS receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - SMS receive listener to remove from the list.

Since:

1.2.0

See Also:

addSMSReceiveListener(ISMSReceiveListener), ISMSReceiveListener

removeUserDataRelayReceiveListener

public void removeUserDataRelayReceiveListener(IUserDataRelayReceiveListener listener)

Removes the given User Data Relay receive listener from the list of User Data Relay receive listeners.

If the listener is not included in the list, this method does nothing.

Parameters:

listener - User Data Relay receive listener to remove from the list.

Since:

1.3.0

See Also:

addUserDataRelayReceiveListener(IUserDataRelayReceiveListener), IUserDataRelayReceiveListener

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

setXBeeReaderMode

public void setXBeeReaderMode(OperatingMode mode)

Sets the XBee operating mode of this data reader.

Parameters:

mode - New XBee operating mode.

Throws:

NullPointerException - if mode == null.

See Also:

OperatingMode

stopReader

public void stopReader()

Stops the Data reader thread.

See Also:

isRunning()