Class ATCommandQueuePacket

This class represents an AT Command Queue XBee packet. Packet is built using the parameters of the constructor or providing a valid API payload.

Inheritance
System.Object
XBeePacket
XBeeAPIPacket
ATCommandQueuePacket
Inherited Members
System.Object.Equals(System.Object, System.Object)
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
Namespace: XBeeLibrary.Core.Packet.Common
Assembly: XBeeLibrary.Core.dll
Syntax
public class ATCommandQueuePacket : XBeeAPIPacket
Remarks

Used to query or set module parameters on the local device. In contrast to the ATCommandPacket API packet, new parameter values are queued and not applied until either an ATCommandPacket is sent or the ApplyChanges() method is issued.

Register queries (reading parameter values) are returned immediately.

Command response is received as an ATCommandResponsePacket.

Constructors

ATCommandQueuePacket(Byte, String, Byte[])

Class constructor. Instantiates a ATCommandQueuePacket with the given parameters.

Declaration
public ATCommandQueuePacket(byte frameID, string command, byte[] parameter)
Parameters
Type Name Description
System.Byte frameID

The XBee API frame ID.
System.String command

The AT command.
System.Byte[] parameter

The AT command parameter, null if it is not required.
Exceptions
Type Condition
System.ArgumentException

If frameID < 0 or if frameID > 255.
System.ArgumentNullException

If command is null.

ATCommandQueuePacket(Byte, String, String)

Class constructor. Instantiates a ATCommandQueuePacket with the given parameters.

Declaration
public ATCommandQueuePacket(byte frameID, string command, string parameter)
Parameters
Type Name Description
System.Byte frameID

The XBee API frame ID.
System.String command

The AT command.
System.String parameter

AT command parameter as string, null if it is not required.
Exceptions
Type Condition
System.ArgumentException

If frameID < 0 or if frameID > 255.
System.ArgumentNullException

If command is null.

Properties

APIPacketParameters

A sorted dictionary with the packet parameters and their values.

Declaration
protected override LinkedDictionary<string, string> APIPacketParameters { get; }
Property Value
Type Description
LinkedDictionary<System.String, System.String>
Overrides

APIPacketSpecificData

Gets the XBee API packet specific data.

Declaration
protected override byte[] APIPacketSpecificData { get; }
Property Value
Type Description
System.Byte[]
Overrides
Remarks

This does not include the frame ID if it is needed.

Command

The AT command.

Declaration
public string Command { get; }
Property Value
Type Description
System.String

IsBroadcast

Indicates whether the packet is a broadcast packet.

Declaration
public override bool IsBroadcast { get; }
Property Value
Type Description
System.Boolean
Overrides

NeedsAPIFrameID

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

Declaration
public override bool NeedsAPIFrameID { get; }
Property Value
Type Description
System.Boolean
Overrides

Parameter

The AT command parameter.

Declaration
public byte[] Parameter { get; set; }
Property Value
Type Description
System.Byte[]

StringParameter

The AT command parameter as string.

Declaration
public string StringParameter { get; set; }
Property Value
Type Description
System.String

Methods

CreatePacket(Byte[])

Creates a new ATCommandQueuePacket object from the given payload.

Declaration
public static ATCommandQueuePacket CreatePacket(byte[] payload)
Parameters
Type Name Description
System.Byte[] payload

The API frame payload. It must start with the frame type corresponding to an AT Command Queue packet (0x09). The byte array must be in API mode.
Returns
Type Description
ATCommandQueuePacket

Parsed AT Command Queue packet.
Exceptions
Type Condition
System.ArgumentException

If payload[0] != APIFrameType.AT_COMMAND_QUEUE.GetValue() or if payload.Length < XBeeLibrary.Core.Packet.Common.ATCommandQueuePacket.MIN_API_PAYLOAD_LENGTH.
System.ArgumentNullException

If payload == null.

See Also