com.digi.xbee.api.packet.raw

Class TX64Packet

java.lang.Object

com.digi.xbee.api.packet.XBeePacket

com.digi.xbee.api.packet.XBeeAPIPacket

com.digi.xbee.api.packet.raw.TX64Packet

public class TX64Packet
extends XBeeAPIPacket

This class represents a TX (Transmit) 64 Request packet. Packet is built using the parameters of the constructor or providing a valid API payload.

A TX Request message will cause the module to transmit data as an RF Packet.

See Also:

XBeeAPIPacket

Field Summary

Fields inherited from class com.digi.xbee.api.packet.XBeeAPIPacket

NO_FRAME_ID

Constructor Summary

Constructors

Constructor and Description
TX64Packet(int frameID, XBee64BitAddress destAddress64, int transmitOptions, byte[] rfData) Class constructor.

Method Summary

Modifier and Type	Method and Description
static TX64Packet	createPacket(byte[] payload) Creates a new TX64Packet object from the given payload.
XBee64BitAddress	get64bitDestinationAddress() Returns the 64-bit destination address.
LinkedHashMap<String,String>	getAPIPacketParameters() Returns a map with the XBee packet parameters and their values.
byte[]	getRFData() Returns the RF Data to send.
int	getTransmitOptions() Returns the transmit options bitfield.
boolean	isBroadcast() Returns whether or not the packet is a broadcast packet.
boolean	needsAPIFrameID() Returns whether the API packet needs API Frame ID or not.
void	setRFData(byte[] rfData) Sets the RF data to send.

Methods inherited from class com.digi.xbee.api.packet.XBeeAPIPacket

checkFrameID, getAPIData, getFrameID, getFrameType, getFrameTypeValue, getPacketData, setFrameID

Methods inherited from class com.digi.xbee.api.packet.XBeePacket

generateByteArray, generateByteArrayEscaped, getChecksum, getPacketLength, getParameters, parsePacket, parsePacket, toPrettyString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TX64Packet

public TX64Packet(int frameID,
                  XBee64BitAddress destAddress64,
                  int transmitOptions,
                  byte[] rfData)

Class constructor. Instantiates a new TX64Packet object with the given parameters.

Parameters:

frameID - Frame ID.

destAddress64 - 64-bit address of the destination device.

transmitOptions - Bitfield of supported transmission options.

rfData - RF Data that is sent to the destination device.

Throws:

IllegalArgumentException - if frameID < 0 or if frameID > 255 or if transmitOptions < 0 or if transmitOptions > 255.

NullPointerException - if destAddress64 == null.

See Also:

XBeeTransmitOptions, XBee64BitAddress

Method Detail

createPacket

public static TX64Packet createPacket(byte[] payload)

Creates a new TX64Packet object from the given payload.

Parameters:

payload - The API frame payload. It must start with the frame type corresponding to a TX64 Request packet (0x00). The byte array must be in OperatingMode.API mode.

Returns:

Parsed TX (transmit) 64 Request packet.

Throws:

IllegalArgumentException - if payload[0] != APIFrameType.TX_64.getValue() or if payload.length < or if frameID < 0 or if frameID > 255 or if transmitOptions < 0 or if transmitOptions > 255.

NullPointerException - if payload == null.

get64bitDestinationAddress

public XBee64BitAddress get64bitDestinationAddress()

Returns the 64-bit destination address.

Returns:

The 64-bit destination address.

See Also:

XBee64BitAddress

getAPIPacketParameters

public LinkedHashMap<String,String> getAPIPacketParameters()

Description copied from class: XBeeAPIPacket

Returns a map with the XBee packet parameters and their values.

Returns:

A sorted map containing the XBee packet parameters with their values.

getRFData

public byte[] getRFData()

Returns the RF Data to send.

Returns:

RF data to send.

getTransmitOptions

public int getTransmitOptions()

Returns the transmit options bitfield.

Returns:

Transmit options bitfield.

See Also:

XBeeTransmitOptions

isBroadcast

public boolean isBroadcast()

Description copied from class: XBeeAPIPacket

Returns whether or not the packet is a broadcast packet.

Specified by:

isBroadcast in class XBeeAPIPacket

Returns:

true if the packet is a broadcast packet, false otherwise.

needsAPIFrameID

public boolean needsAPIFrameID()

Description copied from class: XBeeAPIPacket

Returns whether the API packet needs API Frame ID or not.

Specified by:

needsAPIFrameID in class XBeeAPIPacket

Returns:

true if the packet needs API Frame ID, false otherwise.

setRFData

public void setRFData(byte[] rfData)

Sets the RF data to send.

Parameters:

rfData - RF Data to send.