com.digi.xbee.api

Class DigiPointDevice

java.lang.Object

com.digi.xbee.api.AbstractXBeeDevice

com.digi.xbee.api.XBeeDevice

com.digi.xbee.api.DigiPointDevice

public class DigiPointDevice
extends XBeeDevice

This class represents a local DigiPoint device.

See Also:

XBeeDevice, DigiMeshDevice, Raw802Device, ZigBeeDevice

Constructor Summary

Constructors

Constructor and Description
DigiPointDevice(IConnectionInterface connectionInterface) Class constructor.
DigiPointDevice(String port, int baudRate) Class constructor.
DigiPointDevice(String port, int baudRate, int dataBits, int stopBits, int parity, int flowControl) Class constructor.
DigiPointDevice(String port, SerialPortParameters serialPortParameters) Class constructor.

Method Summary

Modifier and Type	Method and Description
XBeeNetwork	getNetwork() Returns the network associated with this XBee device.
XBeeProtocol	getXBeeProtocol() Returns the XBee Protocol of this XBee device.
void	open() Opens the connection interface associated with this XBee device.
void	sendDataAsync(XBee64BitAddress address64Bit, XBee16BitAddress address16bit, byte[] data) Sends asynchronously the provided data to the XBee device of the network corresponding to the given 64-bit/16-bit address.

Methods inherited from class com.digi.xbee.api.XBeeDevice

addDataListener, addIOSampleListener, addModemStatusListener, addPacketListener, close, getOperatingMode, getReceiveTimeout, isOpen, isRemote, readData, readData, readDataFrom, readDataFrom, removeDataListener, removeIOSampleListener, removeModemStatusListener, removePacketListener, reset, sendBroadcastData, sendData, sendDataAsync, sendPacket, sendPacket, sendPacketAsync, setReceiveTimeout, toString

Methods inherited from class com.digi.xbee.api.AbstractXBeeDevice

applyChanges, enableApplyConfigurationChanges, executeParameter, get16BitAddress, get64BitAddress, getADCValue, getConnectionInterface, getDestinationAddress, getDIOChangeDetection, getDIOValue, getFirmwareVersion, getHardwareVersion, getIOConfiguration, getIOSamplingRate, getNodeID, getPANID, getParameter, getPowerLevel, getPWMDutyCycle, isApplyConfigurationChangesEnabled, readDeviceInfo, readIOSample, setDestinationAddress, setDIOChangeDetection, setDIOValue, setIOConfiguration, setIOSamplingRate, setNodeID, setPANID, setParameter, setPowerLevel, setPWMDutyCycle, updateDeviceDataFrom, writeChanges

Methods inherited from class java.lang.Object

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

Constructor Detail

DigiPointDevice

public DigiPointDevice(IConnectionInterface connectionInterface)

Class constructor. Instantiates a new DigiPointDevice object with the given connection interface.

Parameters:

connectionInterface - The connection interface with the physical point-to-multipoint device.

Throws:

NullPointerException - if connectionInterface == null

See Also:

IConnectionInterface

DigiPointDevice

public DigiPointDevice(String port,
                       int baudRate)

Class constructor. Instantiates a new DigiPointDevice object in the given port name and baud rate.

Parameters:

port - Serial port name where point-to-multipoint device is attached to.

baudRate - Serial port baud rate to communicate with the device. Other connection parameters will be set as default (8 data bits, 1 stop bit, no parity, no flow control).

Throws:

IllegalArgumentException - if baudRate < 0.

NullPointerException - if port == null.

DigiPointDevice

public DigiPointDevice(String port,
                       int baudRate,
                       int dataBits,
                       int stopBits,
                       int parity,
                       int flowControl)

Class constructor. Instantiates a new DigiPointDevice object in the given serial port name and settings.

Parameters:

port - Serial port name where point-to-multipoint device is attached to.

baudRate - Serial port baud rate to communicate with the device.

dataBits - Serial port data bits.

stopBits - Serial port data bits.

parity - Serial port data bits.

flowControl - Serial port data bits.

Throws:

IllegalArgumentException - if baudRate < 0 or if dataBits < 0 or if stopBits < 0 or if parity < 0 or if flowControl < 0.

NullPointerException - if port == null.

DigiPointDevice

public DigiPointDevice(String port,
                       SerialPortParameters serialPortParameters)

Class constructor. Instantiates a new DigiPointDevice object in the given serial port name and parameters.

Parameters:

port - Serial port name where point-to-multipoint device is attached to.

serialPortParameters - Object containing the serial port parameters.

Throws:

NullPointerException - if port == null or if serialPortParameters == null.

See Also:

SerialPortParameters

Method Detail

getNetwork

public XBeeNetwork getNetwork()

Description copied from class: XBeeDevice

Returns the network associated with this XBee device.

Overrides:

getNetwork in class XBeeDevice

Returns:

The XBee network of the device.

See Also:

XBeeNetwork

getXBeeProtocol

public XBeeProtocol getXBeeProtocol()

Description copied from class: AbstractXBeeDevice

Returns the XBee Protocol of this XBee device.

To refresh this value use the AbstractXBeeDevice.readDeviceInfo() method.

Overrides:

getXBeeProtocol in class AbstractXBeeDevice

Returns:

The XBee device protocol.

See Also:

XBeeProtocol

open

public void open()
          throws XBeeException

Description copied from class: XBeeDevice

Opens the connection interface associated with this XBee device.

When opening the device an information reading process is automatically performed. This includes:

• 64-bit address.
• Node Identifier.
• Hardware version.
• Firmware version.
• XBee device protocol.
• 16-bit address (not for DigiMesh modules).

Overrides:

open in class XBeeDevice

Throws:

XBeeException - if there is any problem opening this device connection.

See Also:

XBeeDevice.close(), XBeeDevice.isOpen()

sendDataAsync

public void sendDataAsync(XBee64BitAddress address64Bit,
                          XBee16BitAddress address16bit,
                          byte[] data)
                   throws XBeeException

Description copied from class: XBeeDevice

Sends asynchronously the provided data to the XBee device of the network corresponding to the given 64-bit/16-bit address.

Asynchronous transmissions do not wait for answer from the remote device or for transmit status packet.

Parameters:

address64Bit - The 64-bit address of the XBee that will receive the data.

address16bit - The 16-bit address of the XBee that will receive the data. If it is unknown the XBee16BitAddress.UNKNOWN_ADDRESS must be used.

data - Byte array containing the data to be sent.

Throws:

XBeeException - if a remote device is trying to send data or if there is any other XBee related exception.

See Also:

XBeeDevice.getReceiveTimeout(), XBeeDevice.setReceiveTimeout(int), XBeeDevice.sendData(RemoteXBeeDevice, byte[]), XBeeDevice.sendData(XBee64BitAddress, byte[]), XBeeDevice.sendData(XBee64BitAddress, XBee16BitAddress, byte[]), XBeeDevice.sendDataAsync(RemoteXBeeDevice, byte[]), XBeeDevice.sendDataAsync(XBee64BitAddress, byte[]), XBee16BitAddress, XBee64BitAddress