AT commands
Network and security commands
Digi XBee® 3 802.15.4 RF Module User Guide
130
NI (Node Identifier)
Stores the node identifier string for a device, which is a user-defined name or description of the
device. This can be up to 20 ASCII characters.
Use the
ND
(Network Discovery) command with this string as an argument to easily identify devices
on the network.
The
DN
command also uses this identifier.
Parameter range
A string of case-sensitive ASCII printable characters from 1 to 20 bytes in length. A carriage return
or a comma automatically ends the command.
Default
0x20 (an ASCII space character)
ND (Network Discover)
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
.
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.
