Advanced application features Network commissioning and diagnostics
XBee®-PRO 900HP/XSC RF Modules
164
Number of
bytes Field name Description
8 Destination
address
The address the device tests its link with.
2 Payload size The size of the test packet. Use the MP command to query the
maximum payload size for this device.
2 Iterations The number of packets to send. Use a number between 1 and 4000.
After completing the transmissions of the test link packets, the executing device sends the following
data packet to the requesting device's Test Link Result Cluster (0x0094) on endpoint (0xE6). If the
requesting device is operating in API mode, the device outputs the following information as an API
Explicit RX Indicator Frame:
Number of
bytes Field name Description
8 Destination
address
The address where the device tested its link.
2 Payload size The size of the test packet sent to test the link.
2 Iterations The number of packets sent.
2 Success The number of packets successfully acknowledged.
2 Retries The total number of MAC retries to transfer all the
packets.
1 Result 0x00 - command was successful.
0x03 - invalid parameter used.
1 RR The maximum number of MAC retries allowed.
1 maxRSSI The strongest RSSI reading observed during the test.
1 minRSSI The weakest RSSI reading observed during the test.
1 avgRSSI The average RSSI reading observed during the test.
Example
Suppose that the link between device A (SH/SL = 0x0013a20040521234) and device B
(SH/SL=0x0013a2004052abcd) is being tested by transmitting 1,000 40 byte packets. Send the
following API packet to the serial interface of the device outputting the results, device C. Note that
device C can be the same device as device A or B (Whitespace delineates fields and bold text is the
payload portion of the packet):
7E 0020 11 01 0013A20040521234 FFFE E6 E6 0014 C105 00 00 0013A2004052ABCD 0028 03E8 EB
And the following is a possible packet returned:
7E 0027 91 0013A20040521234 FFFE E6 E6 0094 C105 00 0013A2004052ABCD 0028 03E8 03E7 0064
00 0A 50 53 52 9F
(999 out of 1000 packets successful, 100 retries used, RR=10, maxRSSI= - 80 dBm, minRSSI= - 83 dBm,
avgRSSI= - 82 dBm)