Digi XBee3 802.15.4 User Manual

AT commands Network and security commands
Digi XBee3® 802.15.4 RF Module User Guide
82
NI command
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 command
This command reports the following information after a jittered time delay. Node discover response
when issued in Command mode:
16-bit Short Address (MY command)<CR>
Upper portion of the Long 64-bit Address (SH command)<CR>
Lower portion of the Long 64-bit Address (SL command)<CR>
Signal Strength in -dBm (DB command)<CR>
Node Identifier String (NI command)<CR>
<CR> (This is part of the response and not the end of command indicator.)
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 AT Command Response frame -
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.
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
command.

Digi XBee3 802.15.4 Specifications

General

Brand	Digi
Model	XBee3 802.15.4
Category	Control Unit
Language	English