ND (Network Discover)

This command applies to the XBee 3 802.15.4 RF Module.

This command reports the following information after a jittered time delay. Node discover response when issued in Command mode:

MY<CR> (2 bytes) (always 0xFFFE)

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)

PARENT_NETWORK ADDRESS<CR> (2 bytes)

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

A second carriage return indicates the network discovery timeout (NT) has expired.

When operating in API mode and a Network Discovery is issued as a 0x08 or 0x09 frame, the response contains binary data except for the NI string in the following format:

2 bytes for Short Source Address

4 bytes for Upper Long Address

4 bytes for Lower Long Address

1 byte for the signal strength in -dBm (two's complement representation)

NULL-terminated string for NI (Node Identifier) value (maximum 20 bytes without NULL terminator)

Each device that responds to the request will generate a separate Local AT Command Response - 0x88.

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. If there are no matching devices to the string identifier parameter, the command returns an “ERROR” if the device is in Transparent mode.

The NT setting determines the maximum timeout (13 seconds by default), this value is sent along with the discovery broadcast and determines the random delay the remote nodes use to prevent the responses from colliding.

For more information about the options that affect the behavior of the ND command, see NO (Network Discovery Options).

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.

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

Parameter range

20-byte printable ASCII string (optional)

Default

N/A