XBee3 zigbee AT命令集
时间：2022-10-14 04:00:00
AT命令集
（http://www.bitconn.com/form_1/注册后，购买XBee模块，送USB评估底板及相关中文资料，或免费申请借用评估套件)
网络命令
本节列出了在表单和连接试验期间使用的内容AT命令。
注意您所做的任何改变都会导致设备离开，重新加入或建立新网络。.
| AT命令 |
命名和描述 |
参数范围 |
默认值 |
||||||||||||||||||
| CE |
CE (设备角色)确定设备是形成还是添加网络。 设备在形成网络时充当ZigBee除非使用分布式信任中心安全模型(未设置网络协调器)EO位1)型中，设备作为路由形成网络。
|
0-1 |
1 |
||||||||||||||||||
| ID |
ID（扩展PAN ID）在形成或添加网络时使用的预配置扩展PAN ID ID限制只添加匹配OP值的网络。 如果ID如果设置为0，请尝试添加任何打开的网络。形成网络（CE = 1）时，ID用于形成网络扩展的预配置PAN ID。 将ID当设置为0时，会产生随机扩展PAN ID。 |
0 - 0xFFFFFFFFFFFFFFFF |
0 |
||||||||||||||||||
| II |
II（初始16位PAN ID）形成网络时使用的16位预配置PAN ID。 用此命令替换现有网络上的协调节点。II当设置为默认值(推荐)时，模块将在随机的16位PAN ID形成网络。 |
0 - 0xFFFF |
0xFFFF |
||||||||||||||||||
| ZS |
ZS（Zigbee 堆叠配置文件)设置或读取设备使用的初始设置Zigbee堆栈配置文件。 所有添加到同一网络的设备上的参数必须相同。 如果XBee该设备是网络上唯一的无线电类型。ZS保留为默认值0； 非零值允许第三方Zigbee设备加入。 如果在命令模式下运行，则只有在命令模式退出时通过加班或CN(退出命令模式)ZS任何变化。 更改ZS将所有当前参数写入持久存储，模块将重新启动； 这相当于发出WR和FR命令。 因变更而改变设备ZS或BT重新启动时，调制解调器状态不会产生。 CTS断言也将在此期间取消，因此建议控制流量。 如果不使用硬件流控制，退出命令模式后可能需要延迟1秒(或使用)API时应用更改）以避免数据丢失。
|
0 - 2 |
0 |
||||||||||||||||||
| CR |
CR(冲突报告)网络管理员必须在一分钟内收到PAN ID以触发冲突报告数PAN ID更改。 p style="margin-left:0cm;">损坏的信标可能导致报告错误的PAN ID冲突。较高的值可减少错误的PAN ID更改的可能性。 |
1 - 0x3F |
3 |
||||||||||||||||||
| NJ |
NJ（节点加入时间）配置本地设备的加入窗口打开的时间。 NJ指定的连接窗口仅影响本地节点的窗口，不会影响网络其余部分的时间。 可以在运行时更改此值，而无需重新启动协调器或路由器。 Zigbee 3.0不允许网络始终打开加入; 在连接窗口关闭时尝试连接的模块将报告AI值为0x23。 可以选择通过设置NJ = 0xFF来持久打开连接窗口，但这会导致设备在Zigbee 3.0规范之外运行。 在以下条件下打开加入窗口：
如果将NJ设置为0，则将始终关闭连接窗口; 这是安全网络的推荐设置。 使用此设置进行配置时，使用CB2 AT命令或按两次调试按钮可打开连接窗口一分钟。 注意当设备重新加入网络时，不需要打开加入窗口。 但是，如果重新加入尝试失败六次，模块将尝试通过关联加入，这需要一个打开的连接窗口。 |
0 0xFF (秒) |
0xFE （254秒） |
||||||||||||||||||
| DJ |
DJ（禁用加入）防止本地设备加入网络。 这样做的参数不会影响已加入网络的终端设备。 它只会阻止这些设备加入另一个网络。 注意此参数不会使用WR命令写入闪存，并在重新上电后恢复为默认值。
|
0 - 1 |
1 |
||||||||||||||||||
| NW |
NW（网络看门狗超时）设置用于确保协调器在网络上处于活动状态的网络监视程序超时。 如果NW设置为> 0，则路由器监视来自协调器（或数据收集器）的通信，如果它无法与协调器通信3个NW时段，则离开网络。 每次接收或向协调器发送数据时，或者如果接收到多对一广播，设备都会重置定时器。 |
0 - 0x64FF [x 1分钟]（最多约18天） |
0（禁止） |
||||||||||||||||||
| JV |
JV（协调器加入验证）在加入和重新加入期间使用，以确定目标网络上是否存在协调器。 如果JV = 1，则路由器或终端设备在加入或启动电源循环时验证协调器是否在其操作信道上。 如果未检测到协调器，则路由器或终端设备将离开其当前通道并尝试加入新的PAN。 如果JV = 0，即使未检测到协调器，路由器或终端设备也会继续在其当前通道上运行。
|
0 - 1 |
0 |
||||||||||||||||||
| JN |
JN（加入通知）成功加入尝试后，广播加入通知。 如果启用，则设备在加电和加入时发送广播节点标识分组。 此操作会在接收传输的所有设备上快速闪烁Associate LED，并从API设备的串行端口发送API帧。 Digi建议您为大型网络禁用此功能，以防止过度广播。
|
0 - 1 |
0 |
||||||||||||||||||
| DO |
DO（杂项设备选项）包含高级设备选项的位字段，这些选项没有专用于AT命令。 清除未使用的位，以便在固件更新期间不会意外启用未来的设备选项。
|
0 - 0xFF |
0x40 |
||||||||||||||||||
| DC |
DC（加入设备控制）包含没有专用AT命令的高级连接设备控件的位域。 这些选项仅适用于加入设备（CE = 0）。 保留未使用的位，以便在固件更新期间不会无意中启用未来的设备控制。
|
0 - 0xFFFF |
0 |
||||||||||||||||||
| CB |
CB（调试按钮）使用CB模拟软件中的调试按钮按下。 即使已禁用调试按钮功能（D0未设置为1），也可以发出CB。 将参数值设置为要模拟的按钮按下次数。例如，发送CB1执行一次按下调试按钮的操作。
|
1,2,4 |
N/A |
||||||||||||||||||
| NR |
NR（网络重置）在PAN内的一个或多个模块上重置网络层参数。 立即响应，然后导致网络重新启动。 设备丢失所有网络配置和路由信息。 如果NR = 0：在发出命令的节点上重置网络层参数。 如果NR = 1：发送广播传输以重置PAN中所有节点上的网络层参数。 注意NR和NR0都执行相同的功能，可以互换使用。 |
0 - 1 |
N/A |
操作网络参数命令
以下只读AT命令提供有关所连接的Zigbee网络的信息。
| AT命令 |
命名和描述 |
参数范围 |
默认值 |
||||||||||||||||||||||||||||||||
| AI |
AI（关联指示）阅读有关最后一个节点加入请求的信息。在连接尝试识别当前状态期间查询AI。您还可以启用详细连接（DC=4）来实时调试连接尝试。）
|
0-0xFF （只读） |
N/A |
||||||||||||||||||||||||||||||||
| OP |
OP（操作扩展PAN ID）读取连接网络的64位扩展PAN ID。 OP值反映设备运行的64位扩展PAN ID。 |
1 - 0xFFFFFFFFFFFFFFFF |
N/A |
||||||||||||||||||||||||||||||||
| OI |
OI（操作16位PAN ID）读取连接网络的16位PAN ID。 OI值反映设备运行的实际16位PAN ID |
0 - 0xFFFF (只读) |
N/A |
||||||||||||||||||||||||||||||||
| CH |
CH（操作通道）读取连接网络的通道号。 信道表示为IEEE 802.15.4信道号。值为0表示设备尚未加入PAN且未在任何通道上运行。 |
0,0x0B - 0x1A（通道11至26） [只读] |
N/A |
||||||||||||||||||||||||||||||||
| NC |
NC（剩余子节点数）读取可以加入设备的剩余终端设备子级的数量。 如果NC返回0，则设备处于容量状态，并且不允许任何其他终端设备子项加入。 |
0 - 0x14（20个子设备） |
N/A |
安全命令
以下AT命令用于设置初始安全性参数。.
注意 在形成/加入网络之前配置这些参数。 更改这些参数可能会导致节点离开任何当前连接的网络。
| AT命令 |
命名和描述 |
参数范围 |
默认值 |
||||||||||||||
| EE |
EE（加密启用）设置或读取本地设备的加密启用设置。
|
0 - 1 |
0 |
||||||||||||||
| EO |
EO（加密选项）包含没有专用AT命令的高级加密选项的位域。 这些选项仅在启用加密（EE = 1）时适用。 保留未使用的位，以便在固件更新期间不会无意中启用未来的加密选项。
|
1 - 0xFF |
2 |
||||||||||||||
| KY |
KY（链接密钥）在网络形成和加入期间使用的预配置链接密钥。 这是一个只写参数。 在形成节点（CE = 1）上： KY充当信任中心的预配置全局链接密钥。 如果将KY设置为0，将生成随机链接密钥并用于形成网络; 这需要使用0x24注册API帧将加入的设备注册到信任中心。 在加入节点（CE = 0）上： KY是加入时使用的预配置链接密钥; 它必须与信任中心设置的KY值匹配，或者通过0x24注册帧在信任中心注册。 如果在加入节点上将KY设置为0，则将使用不安全的已知默认链接密钥。 对于以这种方式配置的不安全设备，必须在信任中心上设置EO位4才能加入。 |
0 - 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF [只写] |
0 |
||||||||||||||
| NK |
NK（信任中心网络密钥）信任中心用于加密网络流量的网络密钥。 如果将NK设置为0（推荐），则使用随机网络密钥。 加入节点不使用NK，因为网络密钥作为加入过程的一部分安全地获得。 这是一个只写参数。 如果使用集中式信任中心（EE = 1，EO = 2）运行，则可以更改NK以旋转网络密钥，该网络密钥将分发到网络上的每个设备。 在分布式信任中心，每个路由器都有一个网络密钥的副本，因此在网络形成后无法更改。 |
0 - 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF [只写] |
0 |
||||||||||||||
| KT |
KT（信任中心链接密钥注册超时）使用0x24注册API帧注册加入设备时，此参数确定密钥表条目在到期之前保留的时间长度。 此超时与NJ加入时间分开。 当设备注册到信任中心时，联接窗口不会打开。 |
0x1E - 0xFFFF（秒） |
0x12C（500秒） |
||||||||||||||
| I？ |
I?（安装代码）安装代码是在工厂分配给每个Zigbee 3.0设备的随机密钥。 此安装代码可用于使用0x24注册帧和选项位将设备安全地注册到信任中心。 对于连接设备要使用的安装代码，必须在连接器上设置DC位0。 |
0 - 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF |
在工厂设置。 |
ZigBee寻址命令
以下AT命令用于在关联后与Zigbee网络进行通信。
| 命名和描述 |
参数范围 |
默认值 |
|||||||||
| SH |
SH（序列号高）显示出厂时分配给XBee的唯一IEEE 64位扩展地址的高32位。该值是只读的，永远不会更改。 |
0x0013A200 -0x0013A2FF |
在工厂设置 |
||||||||
| SL |
SL（序列号低）显示出厂时分配给XBee的唯一IEEE 64位扩展地址的低32位。该值是只读的，永远不会更改。 |
0x0013A200 -0x0013A2FF |
在工厂设置 |
||||||||
| MY |
MY（16位网络地址）读取设备的16位网络地址，该地址由网络在关联时随机分配。值0xFFFE表示设备尚未加入Zigbee网络。 |
0 - 0xFFFF [只读] |
0 - 0xFFFE |
||||||||
| MP |
MP（16位父网络地址）读取设备父级的16位网络地址。 值0xFFFE表示设备没有父级。 读取设备父级的16位网络地址。 如果MP = 0xFFFE，则设备不是终端设备或当前未与父设备关联。 |
0 - 0xFFFE [只读] |
0 - 0xFFFE |
||||||||
| DH |
DH（目的地址高）设置或读取64位目标地址的高32位。 将DH与DL组合时，它定义了设备用于透明模式（AP = 0）和I / O采样的传出数据传输的64位目标地址。 该目标地址对应于目标设备的序列号（SH + SL）。 保留的Zigbee网络地址：
|
0 - 0xFFFFFFFF |
0 |
||||||||
| DL |
DL（目的地址低）设置或读取64位目标地址的低32位。 将DH与DL组合时，它定义了设备用于透明模式（AP = 0）和I / O采样的传出数据传输的64位目标地址。 该目标地址对应于目标设备的序列号（SH + SL）。 保留的Zigbee网络地址：
|
0 - 0xFFFFFFFF |
0 |
||||||||
| NI |
NI（节点标识符）设备的人性化名称。 将此字符串与网络发现命令一起使用，以便轻松识别网络上的设备。 使用带有此字符串的ND（网络发现）命令作为参数来过滤网络发现结果。使用DN（Discover Node）命令将此字符串作为参数，以解析具有匹配NI字符串的节点的64位地址。 |
一串区分大小写的ASCII可打印字符，长度为0到20个字节。 回车符或逗号自动结束命令。 |
0x20（ASCII空格字符） |
||||||||
| NH |
NH（最大单播跳数）此参数确定用于来自本地设备的单播传输的超时值。 超时计算为（50 * NH）+ 100 ms。 在超时时段内未收到确认的单播传输被报告为传输失败。 默认单播超时1.6秒（NH = 0x1E）足以使数据和确认遍历大约8跳。 如果BH（广播跳数）= 0，则NH用于设置发送广播传输时网络上的最大跳数。 如果BH> NH，NH也用于设置广播的最大跳数。 |
0 - 0xFF |
0x1E |
||||||||
| BH |
BH（广播跳数）广播来自本地设备的传输的跳数。 与NH不同，此参数是固定数量的跃点，不用于超时计算。 |
0 - 0x1E |
0 |
||||||||
| AR |
AR（聚合路由通知）设置或读取广播聚合路由消息的周期时间。 设置AR使用由DO位6确定的集中器模式实现来自广播设备的多对一路由。 将AR设置为0x00以仅发送一个广播。 将AR设置为0xFF以停止发送广播（在发生网络重置之前，仍将启用多对一路由）。 |
0 - 0xFF（x10秒） |
0xFF（禁用） |
||||||||
| DD |
DD（设备类型标识符）存储Digi设备类型标识符值。 使用此值可区分多种类型的设备（例如，传感器或指示灯）。 如果更改DD，则RE（恢复默认值）将不会恢复默认值。 将DD恢复为默认值的唯一方法是将其显式设置为默认值。 通过设置NO的第1位，可以选择将此命令包括在网络发现响应中。 |
0 - 0xFFFFFFFF |
0x120000 （0x120000表示Digi XBee3硬件） |
||||||||
| ND |
ND（网络发现）发现并报告在网络上找到的所有设备。命令在抖动时间延迟后报告以下信息（基于本地设备的NT值）。 PARENT_NETWORK ADDRESS DEVICE_TYPE STATUS PROFILE_ID MANUFACTURER_ID 在（NT * 100）毫秒之后，命令以返回 如果通过本地API帧发送ND，则每个网络节点分别返回单独的本地或远程AT命令响应API数据包。 数据由先前列出的字节组成，没有回车分隔符。 NI字符串以“0x00”空字符结尾，因为它是可变长度。 ND还接受NI（节点标识符）作为参数（可选）。 在这种情况下，只有与提供的标识符匹配的设备在抖动的时间延迟后响应。 如果没有匹配的设备，则该命令返回“ERROR”。 ND命令的半径由BH命令设置。 如果传输队列已满，将返回状态代码1 = ERROR。 这意味着已有四个消息排队等待传输。 应用程序尝试以比设备处理请求更快的速度发送消息。 应用程序可以稍后再次尝试，重新设计以较慢的速率发送消息，或者在尝试发送另一个消息之前等待先前消息的Tx状态响应。 |
20字节可打印的ASCII字符串 |
N/A |
||||||||
| DN |
DN（发现节点）将NI字符串解析为物理地址（区分大小写）。 DN发现目标节点后发生以下事件： 在命令模式下发送DN时： 1.设备将DL和DH设置为具有匹配NI字符串的设备地址。 2.接收设备返回OK（或ERROR）。 3.设备退出命令模式以允许立即通信。 如果收到ERROR，则命令模式不会退出。 当DN作为本地AT命令帧发送时 - 0x08： 1.接收设备在API命令响应帧中返回16位网络和64位扩展地址。 2.如果在（NT * 100）毫秒内没有来自模块的响应，或者您没有指定参数（通过将其留空），则接收设备返回ERROR消息。 |
最多20个字节的可打印ASCII字符串 |
N/A |
||||||||
| NT |
NT（节点发现超时）设置或显示使用ND（节点发现）命令时基节点等待来自其他节点的响应的时间。 发出ND命令时，传输包括NT值，以便为所有远程设备提供响应超时。 远程设备在发送响应之前等待小于NT的随机时间以避免冲突。 |
0x20 - 0xFF（x 100 ms） |
0x3C（6秒） |
||||||||
| NO |
NO（网络发现选项）包含没有专用AT命令的高级网络发现选项的位域。 这些选项仅在发出ND命令或发送节点标识时影响本地设备的行为。
|
0 - 3 |
0 |
||||||||
| NP |
NP（最大数据包有效载荷字节数）根据当前参数设置读取可在传输中发送的最大RF有效负载字节数。 使用APS加密（启用API传输选项位），将最大有效负载大小减少9个字节。 使用源路由（AR <0xFF），进一步减少最大有效负载大小，具体取决于遍历的跳数。 注意 NP返回十六进制值。 例如，如果NP返回0x54，则相当于84个字节。 |
0 - 1 |
N/A |
||||||||
| TO |
TO（传输选项）用于配置以透明模式（AP = 0）运行的设备的传出数据传输的高级选项的位域。 在API模式下运行时，如果API帧中的“传输选项”字段为0，则将使用TO参数值。
|
0 - 0xFF |
0 |
||||||||
| SE |
SE（源端点）设置或显示用于数据传输的应用程序层源端点值。 此命令仅影响透明模式下的传出传输（AP = 0）。 0xE8是用于传出数据传输的Digi数据端点。 0xE6是用于配置和命令的Digi设备对象端点。 |
0 - 0xFF |
0xE8 |
||||||||
| DE |
DE（目标端点）设置或显示用于数据传输的应用程序层目标端点。 此命令仅影响透明模式下的传出传输（AP = 0）。 0xE8是用于传出数据传输的Digi数据端点。 0xE6是用于配置和命令的Digi设备对象端点。 |
0 - 0xFF |
0xE8 |
||||||||
| CI |
CI（簇ID）设置或显示用于数据传输的应用层簇ID值。此命令仅影响透明模式下的传出传输（AP=0）。0x11是透明的数据群集ID。 0x12是环回群集ID。 |
0 - 0xFFFF |
0x11（透明数据簇ID） |
RF接口命令
以下AT命令会影响设备的RF接口。.
| AT命令 |
命名和描述 |
参数范围 |
默认值 |
||||||||||||||||||
| PL |
PL（TX功率等级）设置或显示设备传输传导功率的功率级别。 注意 如果在通道26上运行（CH = 0x1A），无论PL设置如何，输出功率都将被限制并且不能超过8 dBm。
|
0 - 4 |
4 |
||||||||||||||||||
| PP |
PP（PL4的功率）当器件配置为PL = 4时，读取允许的最大dBm功率电平。 使用此命令确定模块是PRO还是非PRO变体。 命令返回的值将以十六进制表示（PRO = 0x14和Non-PRO = 0x8）。 |
0x08 - 0x14 [只读] |
N/A |
||||||||||||||||||
| SC |
SC（扫描通道）本地设备执行主动扫描时使用的通道。 无论何时形成网络或在连接尝试之前执行主动扫描。 您可以通过发出AS命令强制执行主动扫描。
|
