Giter Club home page Giter Club logo

silicon_labs_at_on_zigbee's Introduction

英文 | 中文

从Gitee访问 | 从GitHub访问

一、介绍

1.1 仓库简介

该仓库主要是基于 EFR32MG21A020F768IM32 芯片实现的AT命令固件,符合 ZigBee 3.0 标准,该仓库主要包含:

  • 固件 (公开版 + 授权版);
  • 烧录工具 (含固件烧录说明);
  • AT命令说明文档 等。

1.2 硬件说明

该仓库中提供的固件总共使用了 EFR32MG21A020F768IM32 芯片的两路串口,分别用于 AT命令交互调试/日志输出 ,具体引脚使用情况如下表所示:

串口功能 TX RX 波特率
AT命令交互 PB0 PB1 115200
调试/日志输出 PD0 PD1 115200

二、通用AT命令

注:发送命令需要加上回车和换行,对应两个字节十六进制数为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:当前设备未入网(或创建网络),必须在有网络的前提下才可以使用

2.1 AT+HELP

功能 查看当前固件支持的命令                                                                                                                                                                        
发送 AT+HELP
返回 <AT command name>......<AT explanation>

OK
说明 <AT command name>:AT命令
<AT explanation>:AT说明
示例 【发送】
AT+HELP

【返回】
支持的所有命令

2.2 AT

功能 AT测试                                                                                                                                                                                   
发送 AT
返回 OK
示例 【发送】
AT

【返回】
OK

2.3 AT+INFO

功能 获取当前设备信息                                                                                                                                                                                               
发送 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版本信息.

2.4 AT+ECHO

功能 打开/关闭回显                                                                                                                                                                                                      
发送 AT+ECHO:<value>
返回 OK
说明 <value>: 0: 关闭回显 1: 打开回显
示例 【发送】
AT+ECHO:1

【返回】
OK

2.5 AT+RESET

功能 软件复位                                                                                                                                                                                                      
发送 AT+RESET
返回 OK

2.6 AT+FACTNEW

功能 恢复出厂设置         
发送 AT+FACTNEW
返回 OK

2.7 AT+BLOAD

功能 进入BootLoader模式         
发送 AT+BLOAD
返回 OK
示例 【发送】
AT+BLOAD

【返回】
OK
注意 返回OK后会直接进入BootLoader模式

2.8 AT+FORMNET

功能 创建网络【仅限ZigBee协调器使用】         
发送 AT+FORMNET
返回 OK

NETWORK_UP
示例 【发送】
AT+FORMNET

【返回】
OK

NETWORK_UP
注意 当创建网络成功后,PC0(LED1)会置高
可以使用AT+INFO查询创建的网络标号(PANID)

2.9 AT+OPENNET

功能 开放网络【仅限ZigBee协调器使用】         
发送 AT+OPENNET:<seconds>
返回 OK

NETWORK_OPENED

NETWORK_CLOSED
说明 <seconds>:网络开放持续时间,范围(0~254 s)
示例 【发送】
AT+OPENNET:30

【返回】
OK

NETWORK_OPENED

【30s过后】

NETWORK_CLOSED
注意 需要先使用AT+FORMNET创建网络后才能够开放网络

2.10 AT+CLOSENET

2.11 AT+JOINNET

功能 加入网络         
发送 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开放网络

2.12 AT+CHANNEL

功能 改变信道         
发送 AT+CHANNEL:<channel>
返回 OK
说明 <channel>:信道切换,范围(11~26)
示例 【发送】
AT+CHANNEL:11

【返回】
OK
注意 可以使用AT+INFO查询当前的信道

2.13 AT+TXPOWER

功能 修改协调器或路由器发射功率         
发送 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查询当前的信道

2.14 AT+BAUDRATE

功能 发送设置协调器或路由器波特率         
发送 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

2.15 AT+RONOFF

功能 远程开关cluster         
发送 AT+RONOFF:<dstAddr>,<ep>,<on/off>
返回 OK
说明 <dstAddr>:目标地址,0xFFFF为广播,0xFFFE无效,其余为单播
<ep>:目标端点
<on/off>:1: 打开 0: 关闭
示例 【发送】
AT+RONOFF:1234,01,1

【返回】
OK

2.16 AT+RTOGGLE

功能 远程翻转cluster         
发送 AT+RTOGGLE:<dstAddr>,<ep>
返回 OK
说明 <dstAddr>:目标地址,0xFFFF为广播,0xFFFE无效,其余为单播
<ep>:目标端点
示例 【发送】
AT+RTOGGLE:1234,01

【返回】
OK

2.17 AT+TSEND

功能 透传         
发送 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命令(仅授权硬件支持)

3.1 AT+DEVLIST

3.2 AT+HEARTBEAT

3.3 AT+ULIMG

3.4 AT+FWQR

3.5 AT+OTANTF

3.6 AT+TCINFO

功能 获取信任中心的信息
发送 AT+TCINFO
返回 OK

四、联系作者

任何相关问题,欢迎联系作者,微信/QQ/手机同号:17780724435。

silicon_labs_at_on_zigbee's People

Contributors

napoleon940911 avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.