Network commissioning and diagnostics
Node discovery
Digi XBee® 3 802.15.4 RF Module User Guide
121
Commands Syntax Description
ND
Seeks to discover all nodes in the network (on the current PAN ID).
ND
<NI
String>
Seeks to discover if a particular node named <NI String> is found in the
network.
DN
<NI
String>
Sets
DH
/
DL
to point to the address (64-bit or 16-bit depending on the
MY
value of the matching node) of the node whose <NI String> matches.
The node discovery command (without an
NI
string designated) sends out a broadcast to every node
in the PAN ID. Each node in the PAN sends a response back to the requesting node after a jittered
time delay to ensure reliable delivery.
About node discovery
The node discovery command (without an NI string designated) sends out a broadcast to every node
in the PAN ID. Each node in the PAN sends a response back to the requesting node.
When the node discovery command is issued in AT command mode, all other AT commands are
inhibited until the node discovery command times out, as specified by the
NT
parameter. After the
timeout, an extra CRLF is output to the terminal window, indicating that new AT commands can be
entered. This is the behavior whether or not there were any nodes that responded to the broadcast.
When the node discovery command is issued in API mode, the behavior is the same except that the
response is output in API mode. If no nodes respond, there will be no responses at all to the node
discover command. The requesting node is not able to process a new AT command until
NT
times out.
Node discovery in compatibility mode
Node discovery (without an
NI
string parameter) in compatibility mode operates the same in
compatibility mode as it does outside of compatibility mode with one minor exception:
If
C8
bit 1 is set and if requesting node is operating in API mode and if no responses are received by
the time
NT
times out, then an API AT command response of OK (API frame type 0x88) is sent out the
serial port rather than giving no response at all, which would happen if
C8
bit 1 is not set.
Directed node discovery
The directed node discovery command (
ND
with an
NI
string parameter) sends out a broadcast to find
a node in the network with a matching
NI
string. If such a node exists, it sends a response with its
information back to the requesting node.
In Transparent mode, the requesting node will output an extra CRLF following the response from the
designated node and the command will terminate, being ready to accept a new AT command. In the
event that the requested node does not exist or is too slow to respond, the requesting node outputs
an
ERROR
response after
NT
expires.
In API mode, the response from the requesting node will be output in API mode and the command will
terminate immediately. If no response comes from the requested node, the requesting node outputs
an error response in API mode after
NT
expires.
