186 lines
6.0 KiB
Markdown
Executable File
186 lines
6.0 KiB
Markdown
Executable File
# 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” 主要包括：
|
||
|
||
1. [基础AT指令集](###基础AT指令集)
|
||
2. [wifi指令集](###wifi指令集)
|
||
3. [TCP/UDP通信指令集](###TCP/UDP通信指令集)
|
||
|
||
|
||
|
||
### 基础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=<id>,<type>,[domain],[remote_port],[local_port] |
|
||
| 2 | AT+CIPSTOP | AT+CIPSTOP=<id>[,<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 |
|
||
| | | |
|
||
| | | |
|
||
|
||
|
||
|
||
|
||
|
||
|