ND (Network Discover)

This command applies to the XBee/XBee-PRO SX RF Module.

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

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

SH<CR> (4 bytes)

SL<CR> (4 bytes)

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

DEVICE_TYPE<CR> (1 byte)

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.)

After (NT * 100) milliseconds, the command ends by returning a <CR>.

If you send ND through a local AT Command (0x08) API frame, each network node returns a separate AT Command Response (0x88) or Remote Command Response (0x97) frame, respectively. The data consists of the bytes listed above without the carriage return delimiters. The NI string ends in a 0x00 null character.

Broadcast an ND command to the network. 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. The NO setting sets options for the Node Discovery.

For more information about options that affect the behavior of the ND command Refer to the description of the NO command for options which affect the behavior of the ND command.

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

N/A

Default

N/A