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更改。 损坏的信标可能导致报告错误的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<CR> (2 Bytes) (always 0xFFFE) 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) <CR> 在(NT * 100)毫秒之后,命令以返回<CR>结束。 如果通过本地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命令强制执行主动扫描。
注意 避免使用通道26.此通道的输出功率上限为8 dBm。 | 1 - 0xFFFF(位字段) | 0x7FFF(通道11到25) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SD | SD(扫描持续时间)设置或显示设备在活动扫描期间在通道上停留的时间长度。 扫描时间测量为: ([要扫描的通道数] *(2 ^ SD)* 15.36 ms)+(38 ms * [要扫描的通道数])+ 20 ms 使用SC(扫描通道)命令设置要扫描的通道数。 注意 SD会影响MAC侦听信标或在给定通道上运行能量扫描的时间。 SD时间不是路由器/终端设备加入时间要求的准确估计。 Zigbee加入包括额外的开销,包括每个信道上的信标处理,以及发送延长实际加入时间的加入请求。 | 0 - 7(指数) | 3 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AS | AS(主动扫描)强制对邻域进行主动扫描以获得信标响应。 AS命令无法远程发出。 主动扫描返回多行响应,每个字段由回车符分隔: AS_type – unsigned byte = 始终返回2,表示协议为zigbee Channel – 无符号字节 PAN – 大端格式的无符号字 Extended PAN – 8个无符号字节,采用位尾格式 Allow Join – unsigned byte – 1表示联接已启用,0表示联接已禁用 Stack Profile – 无符号字节 LQI – 链路质量指示器-无符号字节,值越大越好 RSSI – 相对信号强度指示器有符号字节,值越小越好 AS响应中的每个字段由回车符(0x0D字符)分隔。 额外的回车分隔多个信标。 另外两次回车表示活动扫描结束。 如果使用API模式,则不返回<CR>,并为每个PanDescriptor生成单独的响应帧。 有关更多信息,请参阅在API模式下操作。 | N/A | N/A | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ED | ED(能量检测)测量每个IEEE 802.15.4信道上检测到的能量。 在透明模式(AP = 0)中,逗号跟随每个值,列表以回车结尾。 返回的值反映了检测到的能量水平,单位为-dBm。 将49,3A等ED响应转换为十进制,变为-73 dBm,-58 dBm,依此类推。 | 1 - 0xFF | 0x10 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DB | DB命令 该命令报告最后接收的RF数据包或APS确认的接收信号强度。 DB命令仅指示最后一跳的信号强度。 它不能为多跳链路提供准确的质量测量。 DB命令值以-dBm为单位。 例如,如果DB返回0x50,则接收的最后一个数据包的RSSI为-80 dBm。 将DB设置为0以清除当前值。 | 0 - 0xFF | N/A |
串行接口命令
以下命令会影响UART串行接口。
命名和描述 | 参数范围 | 默认值 | |||||||||||||||||||||||||
BD | BD(UART波特率)此命令配置设备的UART端口与主机之间的通信的串行接口波特率。 器件将0x12C和0x0EC400之间的任何值解释为自定义波特率。 无法保证自定义波特率,设备会尝试找到最接近的可实现波特率。 设置非标准波特率后,查询BD以在应用更改之前查找实际操作波特率。 下表提供了一些示例BD参数与存储的参数的比较。
| 标准波特率:0x0 - 0x0A 非标准波特率:0x12C - 0x0EC400 | 0x03(9600波特) | ||||||||||||||||||||||||
NB |
NB(奇偶校)设或读取UART通信的串行奇偶校验设置。
| 0 - 2 | 0 | ||||||||||||||||||||||||
SB | SB(停止位)设置或显示UART通信的停止位数。 无论何时形成网络或在连接尝试之前执行主动扫描。 您可以通过发出AS命令强制执行主动扫描。
| 0 - 1 | 0 | ||||||||||||||||||||||||
AP | AP(API启用)确定UART接口的API模式。
| 0 - 2 | 0 | ||||||||||||||||||||||||
AO | AO(API选项)为接收的API帧配置串行输出选项。 当前选项选择接收API帧的类型,以发送UART以接收RF数据包。
| 0 - 0xFF | 0 | ||||||||||||||||||||||||
RO | RO(分组超时)在透明模式下操作时,设置或读取传输开始前所需的字符间静默次数。仅当设备在透明模式(AP=0)下运行时才使用RO。 将RO设置为0以在字符到达时传输字符,而不是将它们缓冲到一个射频包中。 RO命令只适用于透明模式,不适用于API模式。 | 0 - 0xFF(x字符时间) | 3 | ||||||||||||||||||||||||
D6 | D6 (DIO6/RTS) 设置或显示DIO6 / RTS配置(MMT引脚27 / SMT引脚29 / TH引脚16)。
| 0,2, 3-5 | 0 | ||||||||||||||||||||||||
D7 | D7(DIO7/CTS) 设置或显示DIO7 / CTS配置(MMT引脚24 / SMT引脚25 / TH引脚12)。
| 0,2, 3-7 | 1 | ||||||||||||||||||||||||
P3 | P3(DIO13 / DOUT配置) 设置或显示DIO13 / DOUT配置(MMT引脚3 / SMT引脚3 / TH引脚2)。
| 0,1, 3-5 | 1 | ||||||||||||||||||||||||
P4 | P4(DIO14 / DOUT配置) 设置或显示DIO14 / DOUT配置(MMT引脚4 / SMT引脚4 / TH引脚3)。
| 0,1, 3-5 | 1 |
命令模式选项
以下命令会影响命令模式的运行方式。
AT命令 | 命名和描述 | 参数范围 | 默认值 |
CN | CN(退出命令模式)可执行命令。 CN立即退出命令模式并应用挂起的更改。 | N/A | N/A |
CT | CT(命令模式超时)设置或显示命令模式超时参数。 如果本地设备进入命令模式并且在此时间段内未收到任何有效的AT命令,则命令模式将以静默方式退出。 | 2 - 0x28F | 0x64(10秒) |
GT | GT(警戒时间)在命令模式序列GT + CC + GT(包括空格)的命令序列字符之前和之后设置所需的静音时段。 如果透明模式下的数据流包含CC字符,则静默期可防止无意中进入命令模式。 有关更多信息,请参阅进入命令模式。 | 0x2 - 0xCE4(x 1 ms) | 0x3E8(1秒) |
CC | CC(命令字符)设置或显示用于从数据模式中断到命令模式的字符值。 必须连续三次发送命令字符,同时观察此序列之前和之后的最小静音保护时间(GT)。 默认值(0x2B)是加号(+)字符的ASCII代码。 您必须在保护时间内输入三次才能进入命令模式。 要进入命令模式,在命令模式序列(GT + CC + GT)的命令序列字符之前和之后还需要一段静音。 沉默期可防止无意中进入命令模式。 有关更多信息,请参阅进入命令模式。 | 0 - 0xFF | 0x2B(ASCII加字符:+) |
BLE 命令
以下AT命令是BLE命令。
AT命令 | 命名和描述 | 参数范围 | 默认值 | ||||||
BL | BL(蓝牙地址)BL报告EUI-48蓝牙设备地址。 由于标准的XBee AT命令处理,在命令模式下,响应中不包括前导零。 | N/A | N/A | ||||||
BT | BT(蓝牙启用)BT启用或禁用蓝牙功能。 注意 启用蓝牙后,XBee3 Zigbee RF模块不能处于睡眠模式。 如果设备配置为允许睡眠模式并启用蓝牙,则XBee3 Zigbee RF模块将不会进入睡眠状态。
| 0,1 | 0 | ||||||
$S | $S (SRP Salt) 注意如果您已在XBee设备上配置了密码且salt对应于密码,则只应使用此命令。 安全远程密码(SRP)Salt是一个32位数字,用于为XBee3 Zigbee RF模块创建加密密码。 将$S命令与$V,$W,$X和$Y验证器结合使用。 命令和验证器一起验证BLE API服务的客户端,而不将XBee密码存储在XBee3 Zigbee RF模块上。 在$S命令中配置salt。 在$V,$W,$X和$Y验证程序中,指定128字节的验证程序值,其中每个命令代表总128字节验证程序值的32个字节。 | 0 - 0xFFFFFFFF | 0 | ||||||
$V,$W,$X,$Y | $V,$W,$X,$Y命令(SRP盐验证程序)将$V,$W,$X和$Y验证器与$S(SRP Salt)结合使用,为XBee3 Zigbee RF模块创建加密密码。 $S和验证者一起验证BLE API服务的客户端,而不在XBee设备上存储XBee密码。 使用$S命令配置销售。 在$V,$W,$X和$Y验证程序中,指定128字节的验证程序值,其中每个命令代表总128字节验证程序值的32个字节。 | 0 - 0xFFFFFFFF | 0 |
备注:SALT值属于随机值。用户注册时,系统用来和用户密码进行组合而生成的随机数值,称作salt值,通称为加盐值。
MicroPython命令
以下命令与在XBee3 Zigbee RF模块上使用MicroPython有关。.
AT命令 | 命名和描述 | 参数范围 | 默认值 | ||||||
PS | PS(Python启动)设置XBee3 Zigbee RF模块是否在启动时运行存储的Python代码。
| 0-1 | 0 | ||||||
PY | PY(MicroPython 命令)使用MicroPython与XBee3 Zigbee RF模块交互。 PY是带子命令的命令。 这些子命令是PY的参数。 PYC(代码报告) 您可以使用MicroPython REPL中的Ctrl-F命令将已编译的代码存储在闪存中; 请参阅Digi MicroPython编程指南。 PYC子命令报告存储代码的详细信息。 在命令模式下,它返回三行文本,例如: source: 1662 bytes (hash=0xC3B3A813) bytecode: 619 bytes (hash=0x0900DBCE) compiled: 2017-05-09T15:49:44 意思是:
在API模式下,PYC返回五个32位大端值:
PYD(删除代码) PYD中断任何正在运行的代码,擦除任何存储的代码,然后在MicroPython子系统上进行软重启。 PYV(版本报告) 报告MicroPython版本。 PY ^(中断程序) 将KeyboardInterrupt发送到MicroPython。 如果有一个失控的MicroPython程序并且您已经填充了stdin缓冲区,这将非常有用。 您可以进入命令模式(+++)并发送ATPY ^来中断程序。 | N/A | N/A |
睡眠命令
以下命令启用和配置设备的低功耗睡眠模式。
AT命令 | 命名和描述 | 参数范围 | 默认值 | ||||||||||||||
SM | SM(睡眠模式)设置或显示设备的睡眠模式。 当SM> 0时,设备作为终端设备运行。 但是,在将SM设置为大于0的值之前,CE必须为0才能将设备更改为终端设备。 将设备从路由器更改为终端设备(反之亦然)会强制设备离开网络,并在应用更改时尝试作为新设备类型加入。
| 0,1,4,5 | 0 | ||||||||||||||
SP | SP(睡眠周期)设置终端设备的休眠时间,最长为28秒。 使用SN命令将睡眠时间延长超过28秒。 在父级上,此值确定父级缓冲睡眠终端设备的消息的时间。 将值设置为至少等于任何子终端设备的最长SP时间。 | 0x20 - 0xAF0 x 10 ms(1/4秒分辨率) | 0x20 | ||||||||||||||
ST | ST(周期睡眠唤醒时间)接收串行或RF数据后,设置或显示周期休眠终端设备的唤醒时间。 每次设备接收串行或RF数据时,唤醒定时器都会复位。 一旦定时器到期,终端设备可以进入低功率操作。 | 1 - 0xFFFF(x 1 ms) | 0x1388 (5秒) | ||||||||||||||
SN | SN(ON_SLEEP之间的周期数)设置或读取睡眠周期数值。 如果没有RF数据正在等待终端设备,则此命令控制在唤醒时间内ON_SLEEP线路置位之间必须经过的休眠周期数。 如果没有RF数据,此命令允许主机应用程序长时间休眠。 | 1 - 0xFFFF | 1 | ||||||||||||||
SO | SO(睡眠选项)包含没有专用AT命令的高级睡眠选项的位域。 保留未使用的位,以便在固件更新期间不会无意中启用未来的睡眠选项。
| 0 - 0xFF | 0 | ||||||||||||||
WH | WH(唤醒主机延迟)设置或显示唤醒主机计时器值。 在设备置位ON_SLEEP线路后,您可以使用WH为睡眠主机处理器提供足够的时间来启动。 如果将WH设置为非零值,则此计时器指定设备在从UART发送数据或发送I / O样本之前从睡眠状态唤醒后延迟的时间(以毫秒为单位)。 如果设备接收到串行字符,则WH计时器立即停止。 | 0 - 0xFFFF(x 1 ms) | 0 | ||||||||||||||
PO | PO命令 设置或读取终端设备轮询速率。 将此值设置为0(默认值)可启用100 ms(默认速率)轮询,以10 ms为增量前进。 自适应轮询可以允许终端设备在接收RF数据时在短时间内更快地轮询。 | 0-0x3E8(x 10 ms) | 0 | ||||||||||||||
SI | SI命令 可执行命令。 使循环睡眠设备立即睡眠而不是等待ST计时器到期。 注意 如果在命令模式下发出此命令,模块将保持在命令模式,直到CT计时器到期或您发出CN命令。 | N/A | N/A |
I/O设置命令
以下命令配置XBee3 Zigbee RF模块上可用的各种I / O线。
AT命令 | 命名和描述 | 参数范围 | 默认值 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D0 | D0(DIO0 / AD0 /调试按钮配置)设置或显示DIO0 / AD0 / CB配置(MMT引脚31 / SMT引脚33 / TH引脚20)。
| 0-5 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D1 | D1(DIO1/ AD1/TH_SPI_ATTN配置)设置或显示DIO2 / AD2配置(MMT引脚29 / SMT引脚31 / TH引脚18)。
| SMT/MMT:0,2 - 5 TH:0 - 5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D2 | D2(DIO2/ AD2/TH_SPI_CLK配置)设置或显示DIO1 / AD1配置(MMT引脚30 / SMT引脚32 / TH引脚19)。
| SMT/MMT:0,2-5 TH:0-5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D3 | D3(DIO3/ AD3/TH_SPI_SSEL配置)设置或显示DIO3 / AD3配置(MMT针脚28 / SMT针脚30 / TH针脚17)。
| SMT/MMT:0,2-5 TH:0-5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D4 | D4(DIO4/TH_SPI_MOSI配置)设置或显示DIO4配置(MMT针脚23 / SMT针脚24 / TH针脚11)。。
| SMT/MMT:0,3-5 TH:0,1,3-5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D5 | D5(DIO5 / Associate配置)设置或显示DIO5配置(MMT针脚26 / SMT针脚28 / TH针脚15)。
| 0,1,3-5 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D8 | D8 (DIO8/DTR/SLP_RQ) 设置或显示DIO8 / DTR / SLP_RQ配置(MMT引脚9 / SMT引脚10 / TH引脚9)。
| 0,1,3-5 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
D9 | D9 (DIO9/ON_SLEEP) 设置或显示DIO9 / ON_SLEEP配置(MMT引脚25 / SMT引脚26 / TH引脚13)。
| 0,1,3-5 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P0 | P0 (DIO10/RSSI 配置) 设置或显示DIO10 / RSSI配置(MMT引脚7 / SMT引脚7 / TH引脚6)。
| 0-5 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P1 | P1 (DIO11配置) 设置或显示DIO11配置(MMT引脚8 / SMT引脚8 / TH引脚7)。
| 0,2-5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P2 | P2(DIO12 / TH_SPI_MISO配置)设置或显示DIO12配置(MMT引脚5 / SMT引脚5 / TH引脚4)。
| SMT/MMT:0,3-5 TH:0,1,3-5 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P5 | P5(DIO15 / SPI_MISO配置)设置或显示DIO15配置(MMT引脚16 / SMT引脚17 / TH引脚N / A)。 注意: XBee3通孔模块不提供DIO15配置。
| SMT/MMT:0,1,4-5
| 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P6 | P6(DIO16 / SPI_MOSI配置)设置或显示DIO16配置(MMT引脚15 / SMT引脚16 / TH引脚N / A)。 注意: XBee3通孔模块不提供DIO16配置。。
| SMT/MMT:0,1,4-5
| 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P7 | P7(DIO17 / SPI_SSEL配置)设置或显示DIO17配置(MMT引脚14 / SMT引脚15 / TH引脚N / A)。 注意: XBee3通孔模块不提供DIO17配置。。
| SMT/MMT:0,1,4-5
| 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P8 | P8(DIO18 / SPI_CLK配置)设置或显示DIO18配置(MMT引脚13 / SMT引脚14 / TH引脚N / A)。 注意: XBee3通孔模块不提供DIO18配置。。
| SMT/MMT:0,1,4-5
| 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
P9 | P9(DIO19 / SPI_ATTN配置)设置或显示DIO18配置(MMT引脚11 / SMT引脚12 / TH引脚N / A)。 注意: XBee3通孔模块不提供DIO19配置。。
| SMT/MMT:0,1,4-5
| 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PR | PR(上拉/下拉电阻使能)用于配置I / O线的内部上拉电阻状态的位域。
PR和PD仅影响配置为数字输入(3)或禁用(0)的线路。 下表定义了PR和PD命令的位域映射。
| SMT/MMT:0 - 0xFFFFF(位域) TH: 0 - 0x7FFFF(位域) | SMT/MMT:0xFFFFF TH: 0x7FFFF | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PD | PD(上拉/下拉方向)对于由PR命令设置的相应I / O线,电阻器拉出方向位域(1 =上拉,0 =下拉)。 如果该位置1,则器件使用内部上拉电阻。 如果清楚,该器件使用内部下拉电阻。 有关位顺序,请参阅PR命令。 请参见PR(上拉/下拉电阻使能)位映射。 | SMT/MMT:0 - 0xFFFFF(位域) TH: 0 - 0x7FFFF(位域) | SMT/MMT:0xFFFFF TH: 0x7FFFF | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
M0 | M0(PWM0占空比)PWM0线的占空比(MMT引脚7 / SMT引脚7 / TH引脚6)。 如果正确设置IA(I / O输入地址)并将P0(DIO10 / RSSI配置)配置为PWM0输出,则输入AD0采样会自动修改PWM0值。 请参见PT(PWM输出超时)。 配置PWM0的占空比: 1.使能PWM0输出(P0 = 2)。 2.将M0更改为所需的值。 3.应用设置(使用CN或AC)。 PWM周期为64μs,在此期间内有0x03FF(十进制1023)步。 当M0 = 0(0%PWM),0x01FF(50%PWM),0x03FF(100%PWM)等时。 | 0 - 0x3FF | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
M1 | M1(PWM1占空比)PWM1线的占空比(MMT引脚8/ SMT引脚8 / TH引脚7)。 如果IA(I / O输入地址)设置正确且P1(DIO11配置)配置为PWM1输出,则输入AD0采样会自动修改PWM1值。 请参见PT(PWM输出超时)。 配置PWM1的占空比: 1.使能PWM1输出(P1 = 2)。 2.将M1更改为所需的值。 3.应用设置(使用CN或AC)。 PWM周期为64μs,在此期间内有0x03FF(十进制1023)步。 当M1 = 0(0%PWM),0x01FF(50%PWM),0x03FF(100%PWM)等时。 | 0 - 0x3FF | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LT | LT(关联LED闪烁时间)设置或读取关联LED闪烁时间。 如果使用D5(DIO5 /关联配置)启用关联LED功能(DIO5 /关联引脚),此值将确定设备加入网络时LED的开启和关闭闪烁时间。 如果LT = 0,则设备使用默认闪烁速率:睡眠协调器为500 ms,所有其他节点为250 ms。 如果LT = 0,则设备使用250 ms的默认闪烁速率。 对于所有其他LT值,固件以10 ms为增量测量LT。 | 0,0xA - 0xFF(x 10 ms) | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RP | RP(RSSI PWM定时器)PWM定时器在0.1秒内到期。 RP设置RSSI引脚上脉冲宽度调制(PWM)信号输出的持续时间。 信号占空比随每个接收的数据包更新,并在定时器到期时关闭。 当RP = 0xFF时,输出始终打开。 | 0 - 0xFF(x 100 ms),0xFF | 0x28 (4秒) |
I/O采样命令
以下AT命令启用或调整本地设备的I / O采样.
AT命令 | 命名和描述 | 参数范围 | 默认值 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IR | IR(I/O采样率)确定用于生成传出I/O示例数据的I/O采样率。 当IR值大于0时,器件每IR毫秒采样并发送所有使能的数字I/O和ADC。 I/O样本传输到DH + DL指定的地址。 必须将至少一个I/O线配置为要生成的样本的输入或显式输出。 | 0,0x32 - 0xFFFF(ms) | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IC | IC(数字变化检测)用于配置哪些数字I/O引脚应进行数字变化检测的位域。 如果器件检测到使能的数字I/O引脚发生了变化,它会立即将数字I/O样本发送到DH + DL指定的地址。 更改检测是边沿触发的,必须在设备唤醒时发生。 如果在睡眠期间发生电平转换,则设备将不会看到更改。
| 0-0xFFFF | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AV | AV(模拟电压参考)用于A/D采样的模拟电压基准。
| 0 - 2 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IS | IS(强制采样)立即强制生成I/O采样。如果向本地设备发出命令,则采样数据将从本地串行接口发送。如果远程发送,则采样数据作为AT命令响应帧-0x88返回。 如果设备接收到错误作为对IS查询的响应,则没有要采样的有效I/O行。 | N/A | N/A | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
V+ | V+ 电源电压阈值)定义将电源电压附加到输出I/O采样帧的电源电压阈值。 如果测得的电源电压低于或等于此阈值,则电源电压将附加到输出I/O采样帧,并设置模拟通道掩码的第7位。 将V+设置为0不包括电源电压。将V+设置为1,以始终包括电源电压。 例子: 要包括电源电压低于2.7 V时的测量值,请将V+设置为2700=0xA8A。 | 0-0xFFFF(in mV) | 0 |
诊断命令
以下只读命令是诊断程序,提供有关设备的更多信息.
AT命令 | 命名和描述 | 参数范围 | 默认值 |
VR | VR(固件版本)以4位十六进制数读取设备上的固件版本。
| 0 - 0xFFFF [只读] | 在固件中设置 |
VL | VL(版本详情)显示详细的版本信息,包括应用程序构建日期和时间。 | 多行字符串 [只读] | N/A |
VH | VH(Bootloader版本)读取设备的引导加载程序版本。 | N/A | N/A |
HV | HV(硬件版本)显示设备的硬件版本号。 | 0 - 0xFFFF [只读] | 在固件中设置 |
%C | %C(硬件/软件兼容性)指定与此设备的硬件兼容的固件。 将%C与固件配置xml文件的“compatibility_number”字段进行比较。 兼容性编号低于%C返回值的固件无法加载到主板上。 如果加载了无效的固件,则在重新加载有效固件之前,设备将无法启动。 | [只读] | N/A |
%V | %V(电源监控)以毫伏为单位读取VCC针脚上的电压。 | 0 - 0xFFFF(mV) | N/A |
EA | EA(MAC ACK故障计数) 超时等待MAC ACK的单播传输的数量。 当RR> 0时,每个单播可以达到RR +1超时。 只要在MAC级单播上发生MAC ACK超时,该计数就会递增。 当数字达到0xFFFF时,固件不会计算更多事件。 要将计数器重置为任何16位无符号值,请在命令中附加十六进制参数。 该值是易失性的(在上电序列后,该值不会在器件的存储器中持续存在)。 | 0-0xFFFF | 0 |
TP | TP(温度) 当前模块温度以摄氏度为单位。 温度用二进制表示,如下例所示: 1°C = 0x0001和-1°C = 0xFFFF | 0 - 0xFFFF(摄氏度)[只读] | N/A |
CK | CK(配置校验和)读取当前AT命令配置设置的循环冗余校验(CRC)以确定配置是否已更改。固件更新后,此命令可能返回不同的值。 | 0 - 0xFFFF | N/A |
FR | FR(软件复位)重置设备。 设备立即响应,并在100 ms后执行复位。 如果在设备处于命令模式时发出FR,则重置将有效退出命令模式。 | N/A | N/A |
内存访问命令
本节详细介绍了为设备提供内存访问的可执行命令.
AT命令 | 命名和描述 | 参数范围 | 默认值 |
AC | AC(应用更改)此命令将更改应用于在命令模式下配置的所有命令参数,并应用用0x09 API排队命令帧设置的排队命令参数值。 以下任何一项也适用于与发出AC命令相同的更改:
示例:使用BD命令更改UART波特率不会改变操作波特率,直到收到AC命令为止; 此时,接口会立即改变波特率。 | N/A | N/A |
WR | WR(写入)立即将参数值写入非易失性闪存,以便它们在电源循环中持续存在。 操作网络参数是持久的,并且不需要WR命令来使设备重新连接到网络。 | N/A | N/A |
RE | RE(恢复默认值)将所有设备参数恢复为出厂默认值,但不应用这些参数。 | N/A | N/A |
自定义默认命令
以下命令用于为设备分配自定义默认值。 发送RE(恢复默认值)以恢复自定义默认值。 必须将这些命令作为本地AT命令发送,不能使用远程AT命令请求帧 - 0x17设置它们。
AT命令 | 命名和描述 | 参数范围 | 默认值 |
%F | %F(设置自定义默认值)当收到%F时,XBee3 Zigbee RF模块接收下一个收到的命令,并将其应用于当前配置和自定义默认值,这样当使用RE(恢复默认值)恢复默认值时,将使用自定义值。 | N/A | N/A |
!C | !C(清除自定义默认值)清除所有自定义默认值。 此命令不会更改当前设置,但仅更改默认值,以便RE(恢复默认值)将设置恢复为出厂值。 | N/A | N/A |
R1 | R1(恢复出厂默认值)恢复出厂默认设置,忽略使用%F(设置自定义默认值)设置的任何自定义默认值。 | N/A | N/A |