ND (Network Discover)

This command applies to the XBee 3 DigiMesh RF Module.

Discovers and reports all of the devices it finds on a network. If you send ND through a local or remote API frame, each network node returns a separate AT Command Response (0x88) or Remote Command Response (0x97) frame, respectively.

The command reports the following information after a jittered time delay.

SH<CR> (4 bytes)

SL<CR> (4 bytes)

DB<CR> (Contains the detected signal strength of the response in negative dBm units)

NI <CR> (variable, 0-20 bytes plus 0x00 character)

DEVICE_TYPE<CR> (1 byte: 0 = Coordinator, 1 = Router, 2 = End Device)

STATUS<CR> (1 byte: reserved)

PROFILE_ID<CR> (2 bytes)

MANUFACTURER_ID<CR> (2 bytes)

DIGI DEVICE TYPE<CR> (4 bytes. Optionally included based on NO settings.)

RSSI OF LAST HOP<CR> (1 byte. Optionally included based on NO settings.)

If you send the ND command in Command mode, after (NT*100) ms + overhead time, the command ends by returning a carriage return, represented by <CR>.

The ND command accepts an NI (Node Identifier) as an argument. For more details, see Directed node discovery.

If the command includes an optional node identifier string parameter, only those devices with a matching NI string respond without a random offset delay. If the command does not include a node identifier string parameter, all devices respond with a random offset delay.

The NT setting determines the range of the random offset delay.

For more information about options that affect the behavior of the ND command Refer to NO (Network Discovery Options) for options which affect the behavior of the ND command.

The ND command cannot be issued from within MicroPython or over BLE.

WARNING! If the NT setting is small relative to the number of devices on the network, responses may be lost due to channel congestion. Regardless of the NT setting, because the random offset only mitigates transmission collisions, getting responses from all devices in the network is not guaranteed.

Parameter range

20-byte printable ASCII string (optional)

Default

N/A