Advanced application features
Network commissioning and diagnostics
XBee 868LP RF Modules User Guide
103
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)
If the result field is not equal to zero then an error occurred. Ignore the other fields in the packet. If
the Success field is equal to zero then ignore the RSSI fields.
Trace routing
Determining the route a DigiMesh unicast takes to its destination is useful when setting up a network
or diagnosing problems within a network. Use the Trace Route API option of Tx Request Packets to
transmit routing information packets to the originator of a DigiMesh unicast by the intermediate
nodes. For a description of the API frames, see
.
