英文 | 中文
该仓库主要是基于 EFR32MG21A020F768IM32 芯片实现的AT命令固件,符合 ZigBee 3.0 标准,该仓库主要包含:
- 固件 (公开版 + 授权版);
- 烧录工具 (含固件烧录说明);
- AT命令说明文档 等。
该仓库中提供的固件总共使用了 EFR32MG21A020F768IM32 芯片的两路串口,分别用于 AT命令交互 和 调试/日志输出 ,具体引脚使用情况如下表所示:
串口功能 | TX | RX | 波特率 |
---|---|---|---|
AT命令交互 | PB0 | PB1 | 115200 |
调试/日志输出 | PD0 | PD1 | 115200 |
注:发送命令需要加上回车和换行,对应两个字节十六进制数为0x0D、0x0A,设置命令只需使用一次,配置会存储到FLASH,重新上电不需要重新配置,配置永久有效。部分AT命令只有在特定模式时有效,如果发送AT命令没有返回,请检查主从机模式。
若发送的AT命令格式错误,会返回错误类型,说明如下
- AT_ILLEGAL_FORMAT:指令格式有错
- AT_UNKNOWN_CMD:未知的指令,无法识别
- AT_LACK_PARA:指令缺少参数
- AT_INVALID_PARA:指令参数无效
- AT_TOO_SHORT:指令参数长度太短
- AT_TOO_LONG:指令参数长度太长
- AT_NO_NETWORK:当前设备未入网(或创建网络),必须在有网络的前提下才可以使用
功能 | 查看当前固件支持的命令 |
---|---|
发送 | AT+HELP |
返回 | <AT command name>......<AT explanation> OK |
说明 | <AT command name>:AT命令 <AT explanation>:AT说明 |
示例 | 【发送】 AT+HELP 【返回】 支持的所有命令 |
功能 | AT测试 |
---|---|
发送 | AT |
返回 | OK |
示例 | 【发送】 AT 【返回】 OK |
功能 | 获取当前设备信息 |
---|---|
发送 | AT+INFO |
返回 | <FIRMWARE_VERSION> <BUILD_TIME> <MFG EUI64> <R&W EUI64> <NODEID> <TX_POWER> <PARENT_ID> <PARENT_RSSI> <PAN_ID> <CHANNEL> OK |
说明 | <FIRMWARE_VERSION>:固件版本 <BUILD_TIME>:编译时间 <MFG EUI64>:IEEE地址(不可修改) <R&W EUI64>: 用户可自定义的IEEE地址(可读可写) <NODEID>:设备自身的网络地址 <TX_POWER>:设备自身的射频发射功率 <PARENT_ID>:父节点的网络地址 <PARENT_RSSI>:设备自身与父节点之间的信号强度指示 <PAN_ID>:ZigBee网络的地址 <CHANNEL>:所在信道 |
示例 | 【发送】 AT+INFO 【返回】 FIRMWARE_VERSION: v2.1 BUILD_TIME: 15:57:26, Sep 21 2022 MFG EUI64: 0x94DEB8FFFE5A1AFE R&W EUI64: 0x94DEB8FFFE5A1AFE NODEID: 0x58C0 TX_POWER: -5 DBM PARENT_ID: 0x0000 PARENT_RSSI: 0 DBM PAN_ID: 0x2C82 CHANNEL: 15 OK |
注意 | 如果您在使用EFR32MG21-AT-OPEN固件上有任何问题,请首先提供AT+INFO 版本信息. |
功能 | 打开/关闭回显 |
---|---|
发送 | AT+ECHO:<value> |
返回 | OK |
说明 | <value>: 0: 关闭回显 1: 打开回显 |
示例 | 【发送】 AT+ECHO:1 【返回】 OK |
功能 | 软件复位 |
---|---|
发送 | AT+RESET |
返回 | OK |
功能 | 恢复出厂设置 |
---|---|
发送 | AT+FACTNEW |
返回 | OK |
功能 | 进入BootLoader模式 |
---|---|
发送 | AT+BLOAD |
返回 | OK |
示例 | 【发送】 AT+BLOAD 【返回】 OK |
注意 | 返回OK后会直接进入BootLoader模式 |
功能 | 创建网络【仅限ZigBee协调器使用】 |
---|---|
发送 | AT+FORMNET |
返回 | OK NETWORK_UP |
示例 | 【发送】 AT+FORMNET 【返回】 OK NETWORK_UP |
注意 | 当创建网络成功后,PC0(LED1)会置高 可以使用 AT+INFO 查询创建的网络标号(PANID) |
功能 | 开放网络【仅限ZigBee协调器使用】 |
---|---|
发送 | AT+OPENNET:<seconds> |
返回 | OK NETWORK_OPENED NETWORK_CLOSED |
说明 | <seconds>:网络开放持续时间,范围(0~254 s) |
示例 | 【发送】 AT+OPENNET:30 【返回】 OK NETWORK_OPENED 【30s过后】 NETWORK_CLOSED |
注意 | 需要先使用AT+FORMNET 创建网络后才能够开放网络 |
功能 | 加入网络 |
---|---|
发送 | AT+JOINNET |
返回 | 【待入网设备返回】 OK NETWORK_UP 【协调器返回】 NETWORK_OPENED [<srcAddr>,<datasize>,<LQI>]ONLINE:<EUI64>,<destAddr> NETWORK_CLOSED |
说明 | <srcAddr>:源地址 <datasize>:数据长度 <LQI>:链路质量(Link quality instruction) <EUI64>:已入网设备的MFG EUI64地址 |
注意 | 需要协调器使用AT+OPENNET 开放网络 |
功能 | 改变信道 |
---|---|
发送 | AT+CHANNEL:<channel> |
返回 | OK |
说明 | <channel>:信道切换,范围(11~26) |
示例 | 【发送】 AT+CHANNEL:11 【返回】 OK |
注意 | 可以使用AT+INFO 查询当前的信道 |
功能 | 修改协调器或路由器发射功率 |
---|---|
发送 | AT+TXPOWER:<dstAddr>,<power> |
返回 | OK NEW_TXPOWER:<power> [<srcAddr>,<datasize>,<LQI>]RSP_TXPOWER_SET_OK |
说明 | <dstAddr>:目标地址,0xFFFF为广播,0xFFFE为自身,其余为单播 <power>:发射功率,范围(-8~20 dBm) <srcAddr>:源地址 <datasize>:数据长度 <LQI>:链路质量(Link quality instruction) |
示例 | 【发送】 AT+TXPOWER:1234,10 【返回】 OK NEW_TXPOWER:10 [0000,18,255]RSP_TXPOWER_SET_OK |
注意 | 可以使用AT+INFO 查询当前的信道 |
功能 | 发送设置协调器或路由器波特率 |
---|---|
发送 | AT+BAUDRATE:<dstAddr>,<baudrate> |
返回 | OK NEW_BAUDRATE:<baudrate> [<srcAddr>,<datasize>,<LQI>]RSP_BAUDRATE_SET_OK |
说明 | <dstAddr>:目标地址,0xFFFF为广播,0xFFFE为自身,其余为单播 <baudrate>:波特率,范围(9600~115200) <srcAddr>:源地址 <datasize>:数据长度 <LQI>:链路质量(Link quality instruction) |
示例 | 【发送】 AT+BAUDRATE:1234,115200 【返回】 OK NEW_BAUDRATE:115200 [1234,19,255]RSP_BAUDRATE_SET_OK |
功能 | 远程开关cluster |
---|---|
发送 | AT+RONOFF:<dstAddr>,<ep>,<on/off> |
返回 | OK |
说明 | <dstAddr>:目标地址,0xFFFF为广播,0xFFFE无效,其余为单播 <ep>:目标端点 <on/off>:1: 打开 0: 关闭 |
示例 | 【发送】 AT+RONOFF:1234,01,1 【返回】 OK |
功能 | 远程翻转cluster |
---|---|
发送 | AT+RTOGGLE:<dstAddr>,<ep> |
返回 | OK |
说明 | <dstAddr>:目标地址,0xFFFF为广播,0xFFFE无效,其余为单播 <ep>:目标端点 |
示例 | 【发送】 AT+RTOGGLE:1234,01 【返回】 OK |
功能 | 透传 |
---|---|
发送 | AT+TSEND:<dstAddr>,<data> |
返回 | OK [<destAddr>,<datasize>,<LQI>]RSP_TSEND_OK |
说明 | <dstAddr>:目标地址,0xFFFF为广播,0xFFFE无效,其余为单播 <data>:透传数据,长度范围(3~80 bytes) <srcAddr>:源地址 <datasize>:数据长度 <LQI>:链路质量(Link quality instruction) |
示例 | 【发送】 AT+TSEND:A018,abcd 【返回】 OK [A018,12,255]RSP_TSEND_OK |
功能 | 获取信任中心的信息 |
---|---|
发送 | AT+TCINFO |
返回 | OK |
任何相关问题,欢迎联系作者,微信/QQ/手机同号:17780724435。