Work with networked devices
Test links between adjacent devices
XBee/XBee-PRO DigiMesh 2.4 RF Module User Guide
42
Number of
bytes
Field name
Description
2
Payload size
The size of the test packet device A sent to test the link.
2
Iterations
The number of packets that device A sent.
2
Success
The number of packets that were successfully
acknowledged.
2
Retries
The number of MAC retries used to transfer all the packets.
1
Result
0x00 - the 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 you want to test the link between device A (
SH
/
SL
= 0x0013A200 40521234) and device
B (
SH
/
SL
=0x0013A 200 4052ABCD) by transmitting 1000 40-byte packets:
Send the following API packet to the serial interface of device A.
In the following example packet, whitespace marks fields, 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
When the test is finished, the following API frame may be received:
7E 0027 91 0013A20040521234 FFFE E6 E6 0094 C105 00
0013A2004052ABCD 0028 03E8 03E7 0064
00 0A 50 53 52
9F
This means:
n
999 out of 1000 packets were successful.
n
The device made 100 retries.
n
RR
= 10.
n
maxRSSI = -80 dBm.
n
minRSSI = -83 dBm.
n
avgRSSI = -82 dBm.
If the Result field does not equal zero, an error has occurred. Ignore the other fields in the packet.
If the Success field equals zero, ignore the RSSI fields.
The device that sends the request for initiating the Test link and outputs the result does not need to
be the sender or receiver of the test. It is possible for a third node, "device C", to request device A to
perform a test link against device B and send the results back to device C to be output. It is also
possible for device B to request device A to perform the previously mentioned test. In other words, the
frames can be sent by either device A, device B or device C and in all cases the test is the same: device
A sends data to device B and reports the results.
