AG Electronica XBee 2 Series Manual page 48

www.agelectronica.com
XBee Series 2 ZigBee OEM RF Modules v1.x2x [2007.07.019]
Identifies the UART data frame for the host to
correlate with a subsequent ACK (acknowledgement).
If set to '0', no response is sent.
Byte 1
0x7E
Start Delimiter
* Length [Bytes] = API Identifier + Frame ID + AT Command + Parameter Value
** "M" value was arbitrarily selected.
Identifies the UART data frame for the host to
correlate with a subsequent ACK (acknowledgement).
If set to '0', no response is sent.
www.agelectronica.com
AT Command
API Identifier Value: (0x08)
Allows for module parameter registers to be queried or set.
Figure 7‐6. AT Command Frames
Start Delimiter Length
0x7E MSB LSB API-specific Structure
API Identifier
0x08
Frame ID (Byte 5)
Figure 7‐7. Example: API frames when reading the NJ parameter value of the module.
Byte 1 Bytes 2-3 Byte 4
0x7E 0x00 0x04
Start Delimiter Length* API Identifier
* Length [Bytes] = API Identifier + Frame ID + AT Command
** "R" value was arbitrarily selected.
Figure 7‐8. Example: API frames when modifying the NJ parameter value of the module.
Bytes 2-3 Byte 4
0x00 0x05 0x08
Length* API Identifier
A string parameter used with the NI (Node Identifier), ND (Node Discover) and DH (Destination
Address High) command is terminated with a 0x00 character.
AT Command - Queue Parameter Value
API Identifier Value: (0x09)
This API type allows module parameters to be queried or set. In contrast to the "AT Command" API
type, new parameter values are queued and not applied until either the "AT Command" (0x08) API
type or the AC (Apply Changes) command is issued. Register queries (reading parameter values)
are returned immediately.
Figure 7‐9. AT Command Frames
(Note that frames are identical to the "AT Command" API type except for the API identifier.)
Start Delimiter Length
0x7E MSB LSB API-specific Structure
API Identifier
0x09
Frame ID (Byte 5)
© 2007 Digi International, Inc.
Frame Data Checksum
1 Byte
Identifier-specific Data
cmdData
AT Command (Bytes 6-7) Parameter Value (Byte(s) 8-n)
Command Name - Two If present, indicates the requested parameter
ASCII characters that value to set the given register.
identify the AT Command. If no characters present, register is queried.
Byte 5 Bytes 6-7
0x08 0x52 (R) 0x4E (N) 0x4A (J)
Frame ID** AT Command
Byte 5 Bytes 6-7
0x4D (M) 0x4E (N) 0x4A (J)
Frame ID** AT Command
Frame Data Checksum
1 Byte
Identifier-specific Data
cmdData
AT Command (Bytes 6-7) Parameter Value (Byte(s) 8-n)
Command Name - Two If present, indicates the requested parameter
ASCII characters that value to set the given register.
identify the AT Command. If no characters present, register is queried.
www.agelectronica.com
Chapter 7 ‐ API Operation
Byte 8
0x0D
Checksum
Bytes 8 Byte 9
0x40 0xD2
Parameter Value Checksum
www.agelectronica.com
47