【XBEE手册】AT命令

【XBEE手册】AT命令

@(ZigBee)（ZigBee）[ZigBee, XBEE手册]

---

##寻址命令
###DH（Destination address High ）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或读取64位目标地址的高32位。将DH与DL组合使用时，它会定义设备用于数据传输的64位目标地址。

DH和DL的特殊定义包括0x000000000000FFFF（广播）和0x0000000000000000（协调器）。

参数范围
0 - 0xFFFFFFFF

默认
0
###DL（Destination address Low）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示64位目标地址的低32位。将DH与DL组合使用时，它会定义设备在透传模式下用于传输的目标地址。

DH和DL的特殊定义包括0x000000000000FFFF（广播）和0x0000000000000000（协调器）。

保留的Zigbee网络地址：

0x000000000000FFFF是广播地址。
0x0000000000000000对网络协调器进行寻址。
参数范围
0 - 0xFFFFFFFF

默认
为0xFFFF （协调员）

0 （路由器/终端设备）
###MY（16-bit Network Address）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取设备的16位网络地址。

值0xFFFE表示设备尚未加入Zigbee网络。

参数范围
0 - 0xFFFF [只读]

默认
0 - 0xFFFE
###MP（16-bit Parent Address）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

参数范围
0 - 0xFFFE [只读]

默认
0xFFFE
###NC（Number of remaining Children）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取可以加入该设备的剩余终端子设备的数量。如果NC返回0，则设备处于饱和状态，并且不允许任何其他终端设备子项加入。

参数范围
0 - MAX_CHILDREN（最大值可变）[只读]

默认
N / A
###SH（Serial Number High）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

显示出厂时分配给XBee的唯一IEEE 64位扩展地址的高32位。

始终启用64位源地址。该值是只读的，永远不会更改。

参数范围
0 - 0xFFFFFFFF [只读]

默认
在工厂设置
###SL（Serial Number Low）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

显示出厂时分配给XBee的唯一IEEE 64位RF扩展地址的低32位。

始终启用64位源地址。该值是只读的，永远不会更改。

参数范围
0 - 0xFFFFFFFF [只读]

默认
在工厂设置
###NI（Node Identifier）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

存储设备的节点标识符字符串，该设备是用户定义的设备名称或描述。最多可包含20个ASCII字符。

XCTU可防止用户超出此命令的字符串限制20个字符。如果用户使用其他软件应用程序发送字符串，则可以输入更长的字符串，但设备上的软件会返回错误。
使用 ND（网络发现）命令将此字符串作为参数，以便轻松识别网络上的设备。

DN命令也可使用该标识符。

参数范围
一串区分大小写的ASCII可打印字符，长度为0到20个字节。回车符或逗号自动结束命令。

默认
0x20（ASCII空格字符）
###SE（Source Endpoint）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示应用程序层源端点值。该值用作所有数据传输的源端点。SE仅用于透传模式。 默认值（0xE8）是Digi数据端点。

设置或显示用于数据传输的应用程序层源端点值。

此命令仅影响透传模式下的传出传输（AP = 0）。

0xE8是用于传出数据传输的Digi数据端点。

0xE6是用于配置和命令的Digi设备对象端点。

参数范围
0 - 0xFF

默认
0xE8
###DE（Destination Endpoint）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示应用程序层目标ID值。该值用作所有数据传输的目标端点。默认值（0xE8）是Digi数据端点。

参数范围
0 - 0xFF

默认
0xE8
###CI（Cluster ID）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示应用程序层ID值。使用此值作为所有数据传输的群集ID。CI仅用于透传模式。

参数范围
0 - 0xFFFF

默认
0x11（透传数据群集ID）
###TO（Transmit Options）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

用于配置透传模式的传输选项的位域。

设置或显示Zigbee应用程序层源传输选项。使用此值作为透传模式下所有数据传输的传输选项。

参数范围
0 - 0xFF

位域：

未使用的位必须设置为0.这些位可以逻辑或运算在一起：

参数	描述
0x01	禁用重试和路由修复。
0x20	启用APS加密（如果EE = 1）。 注意这会将最大RF有效负载减少4个字节，低于NP报告的值。
0x40	使用此目标的扩展超时。

将BR设置为0时，TO选项会自动禁用DigiMesh和Repeater模式。

默认
为0x00
###NP（maximum Number of Payload bytes）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取可在传输中发送的最大RF有效负载字节数。

使用APS加密（启用API传输选项位），将最大有效负载大小减少9个字节。

使用源路由（AR <0xFF），将进一步减少了最大有效负载大小。

注意 NP返回十六进制值。例如，如果NP返回0x54，则相当于84个字节。

参数范围
0 - 0xFFFF（字节）[只读]

默认
[只读]
###DD（Diji Device type identifier）
DD命令
此命令适用于XBee / XBee-PRO Zigbee RF模块。

存储Digi设备类型标识符值。 使用此值可区分多个XBee设备。

如果更改DD，RE命令将不会恢复默认值。 将DD恢复为默认值的唯一方法是将其显式设置为默认值。

Digi保留范围0 - 0xFFFFFF。 对于XBee ZB SMT器件，器件类型为0xA0000。

参数范围
0 - 0xFFFFFFFF

默认
0xA0000
###CR（pan Conflict Report）
CR（PAN冲突报告）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

网络管理员必须在一分钟内收到的PAN ID冲突报告数，以触发PAN ID更改。

缺损的信标可能导致报告错误的PAN ID冲突。

较高的值可减少错误的PAN ID更改的可能性。

将CR设置为0会将阈值设置为默认配置值（3）。

参数范围
1 - 0x3F

默认
3
##网络命令
###CH（operating CHannel）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取用于在RF设备之间传输和接收数据的信道编号，并使用802.15.4信道编号。

值为0表示设备尚未加入PAN且未在任何信道上运行。

参数范围
0,0x0B - 0x1A（XBee）

0,0x0B - 0x19（XBee-PRO，信道11-25）

默认
[只读]
###CE（Coordinator Enable）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示设备是否为协调器。

参数范围

参数	描述
0	不是协调员
1	协调员

（SM必须为0才能将CE设置为1）

默认
0
###ID（extended pan ID）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或读取64位扩展PAN ID。如果设置为0，则协调器选择随机扩展PAN ID，路由器/终端设备加入任何扩展PAN ID。

使用WR命令将ID更改写入非易失性存储器，以便在发生重启电源时保留ID设置。

参数范围
0 - 0xFFFFFFFFFFFFFFFF

默认
0
###II（preconfigured 16-bit pan ID）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

形成网络时使用的预配置16位PAN ID。使用此命令替换现有网络上的协调节点。

将II设置为默认值（推荐）时，模块会在随机的16位PAN ID上形成网络。

范围
0 - 0xFFFF

默认
为0xFFFF
###OP（Operating Pan ID）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取64位扩展PAN ID。OP值反映其中设备运行网络的扩展PAN ID。如果ID > 0，则OP等于ID。

参数范围
0x01 - 0xFFFFFFFFFFFFFFFF

默认
N / A
###NH（maximum uNicast Hops）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示网络中的最大跳数。此命令将限制：设置最大广播跳数值（BH）和确定单播超时。

超时计算为（50 * NH）+ 100 ms。

默认单播超时1.6秒（NH = 0x1E）足以使数据和确认遍历大约8跳。

参数范围
0 - 0xFF

默认
0X1E
###BH（maximum Broadcast Hops）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

广播数据传输的最大传输跳数。

参数范围
0 - 0x1E

默认
0
###OI（Operating pan ID）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

读取16位PAN ID。OI值反映设备即时的16位PAN ID。

参数范围
0 - 0xFFFF

默认
[只读]
###NT（Node discovery Timeout）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示使用ND（节点发现）命令时基节点等待来自其他节点的响应的时间。

发出ND命令时，传输包括NT值，以便为所有远程设备提供响应超时。远程设备在发送响应之前等待一个小于NT的随机时间。

参数范围
0x20 - 0xFF（x 100 ms）

默认
0x3C（6秒）
###NO（Network discovery Options）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

在特定设备上设置或读取ND（网络发现）命令的网络发现选项值。选项位字段值更改ND命令的行为以及本地设备在收到ND命令或API节点标识指示符（0x95）帧时返回的可选值。

参数范围
0 - 0x03（位字段）

位字段

选项	描述
0x01	将DD（Digi设备标识符）值附加到ND响应或API节点标识帧。
0x02	本地设备发送ND 的时响应帧ND被发出。

默认
0x0
###SC（Scan Channel）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或读取要扫描的信道列表。

协调器 - 在组建网络之前可选择的信道的位字段列表。

路由器/终端设备 - 扫描的信道的位字段列表，以查找要加入的协调器/路由器。

如果发生重启电源，则 使用WR命令将更改写入SC以保留SC设置。

参数范围
0 - 0xFFFF（位字段）

位字段掩码：

位	参数
0	0x0B
1	0x0C
2	0X0D
3	0x0E
4	0x0F
5	0x10
6	0x11
7	0x12
8	0x13
9	0x14
10	0x15
11	0x16
12	0x17
13	0x18
14	0x19
15	0x1A

注意当用户在设备上将SC设置为0xFFFF时，不允许信道26以超过3 dBm的速率进行传输。如果信道26存在于搜索掩码（SC）中，则协调器对网络形成的主动搜索（信标）在所有信道上限制为不超过3dBm。
协调器/路由器/终端设备的其他通信，或路由器和终端设备的网络加入（关联）的主动搜索在信道26上限制为不超过3dBm. PL和PM配置设置控制其他信道上的发送功率。

对于XBee-PRO SMT模块，信道26不允许以超过6 dBm的频率进行传输。
对于XBee-PRO TH模块，信道26不允许以超过2 dBm的速率进行传输。
默认
0x7FFF的
###SD（Scan Duration）
此命令适用于XBee / XBee-PRO Zigbee RF模块。

设置或显示扫描持续时间指数。 使用WR命令将更改写入SD。

注意如果在搜索信道掩码（SC）中启用信道26（0x8000），则设备会在网络形成或加入期间以3 dBm的频率在所有信道上传输功率。

协调器 - 活动和能量扫描的持续时间（在每个信道上），用于确定协调器启动的可接受信道和PAN ID。

路由器/终端设备 - 用于在关联期间定位要加入的可用协调器/路由器的主动扫描持续时间（在每个信道上）。

扫描时间测量为：

（[要扫描的信道数] （2 ^ SD） 15.36 ms）+（38 ms * [要扫描的信道数]）+ 20 ms

使用SC（扫描信道）命令设置要扫描的信道数。XBee最多可扫描16个信道（SC = 0xFFFF）。XBee-PRO最多可扫描13个信