Advanced application features Network commissioning and diagnostics
XBee® SX 868 RF Module User Guide
65
to the address of the remote. After exiting command mode, the source device transmits any received
serial characters to the remote device, and returned to the sender.
API configuration (AP=1 or AP=2)
Send an Explicit Addressing Command API frame (0x11) using 0x12 as the cluster ID and 0xE8 as the
source and destination endpoint. The remote device echoes any data packets it receives to the
sender.
Link testing between adjacent devices
To test the quality of a link between two adjacent nodes in a network, use the Test Link Request
Cluster ID send a number of test packets between any two nodes in a network.
Initiate a link test using an Explicit TX Request frame. Address the command frame to the Test Link
Request Cluster ID (0x0014) on destination endpoint 0xE6 on the device to execute the test link. The
Explicit TX Request frame contains a 12 byte payload with the following format:
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.