AT指令
本文将详细描述每个 AT 指令的语法格式,功能及使用。
所有指令均为立即生效, AT 指令 可以通过超级终端等串口程序进行输入,也可以通过编程输入。
AT指令格式
AT+
指令采用基于 ASCII 码的命令行,格式如下:
说明
- a) <>:表示必须包含的部分
- b) []:表示可选的部分
命令格式
AT[+CMD][op][para-1,para-2,para-3,......]\r
a) AT: 命令消息前缀
b) +CMD: 指令字符串
c) [op]: 指令操作符。可以是:
1. "=": 表示执行指令,或参数设置,或查询
3. "无":表示执行指令,或查询
d) [para-n]: 表示设置的参数值,或指定查询的参数,或设置的参数值并执行
e) \r: 回车结束符,ASCII码值为0x0d
消息格式
[\r\n][MSGTYPE:][para-1,para-2,para-3,......]<\r\n>
a) \r::回车结束符,ASCII码值为0x0d
b) \n :换行符,ASCII码值为0x0a
c) [MSGTYPE:] :相关消息的前缀,如CMDRSP:、EVT:
d) [para-n] :具体的消息
命令响应格式
任何命令的执行均由所响应,任何无效的数据输入也将进行响应的响应,消息将在收到\r\n、\r或\n三个中的一个之后被执行。
若输入数据为非数据,其第一个字符为非‘A’,第二个字符为非'T',则将响应错误[\r\n]CMDRSP:ERROR\r\n。
命令响应的格式:
[\r\n]<CMDRSP:>[para-1,para-2,para-3,......]<\r\n>
a) \r::回车结束符,ASCII码值为0x0d
b) \n :换行符,ASCII码值为0x0a
c) ”CMDRSP:“:命令的响应前缀
d) [para-n] :具体的命令执行的相关信息的
命令执行结束消息
任何命令的执行结束由下面两条消息中的一个指示。
CMDRSP:ERROR\r\n :命令执行失败或者发生了错误
CMDRSP:OK\r\n :命令执行成功并且结束,可进行下一条执行的执行
EVENT格式
EVENT描述当前的状态,如 WiFi/BT/BLE 功能及其状态、网络连接状态、TCP/UDP等网络的状态。
例如:STATION、SOFTAP连接状态,TCP、UDP连接情况等等。
事件消息格式:
[\r\n]<EVENT>[para-1,para-2,para-2,...,para-n]\r\n
• <EVENT>:事件消息
• [para-n]:具体事件消息,详见EVENT事件的描述
• \r: 回车符,ASCII码值为0x0d
• \n: 换行符,ASCII码值为0x0a
事件主要有以下几个分类:
1. 上电是就绪的 \r\nready\r\n
2. 运行时的具体事件: [\r\n]<EVT:>[para-1,para-2,para-2,...,para-n]<\r\n>
AT指令集
AT指令集 “ATSVR-01.01” 主要包括:
基础AT指令集
下表列举了支持的相关AT命令。
表1 基础AT指令集
Order | Command | Description |
---|---|---|
1 | AT | Used to verify that the command response is normal |
2 | AT+HELP | Query supported directives |
3 | AT+VERSION | Query the version of AT |
4 | AT+ECHO | Configure input data echo |
5 | AT+RST | Restart the system |
wifi指令集
表2 wifi指令集
Order | Command | Description |
---|---|---|
1 | AT+WLMAC | Gets the MAC address of the station |
2 | AT+STADHCP | |
3 | AT+STAAPINFO | |
4 | AT+STASTOP | |
5 | AT+STASTATIC | |
6 | AT+STAST | |
7 | AT+WSCAN | |
8 | AT+SOFTAP | |
9 | SOFTAPSTOP | |
10 | AT+APSTATIC | |
11 | AT+APSTATE | |
TCP/UDP通信指令集
表3 TCP/UDP通信指令集
Order | Command | Description |
---|---|---|
1 | AT+CIPSTART | AT+CIPSTART=,,[domain],[remote_port],[local_port] |
2 | AT+CIPSTOP | AT+CIPSTOP=[,<remote_port>] |
3 | ||
4 | ||
EVENT事件
根据不同的功能,EVENT 事件通知包括:
表 EVENT事件集
Order | Command | Description |
---|---|---|
1 | \r\nready\r\n | Notification system ready |
2 | EVT:WLAN DISCONNECTED\r\n | Notification station role was disconnected |
3 | EVT:WLAN CONNECTED | Notification station role was connected |
4 | EVT:GOT-IP | Notification station role was got ip |