使用AT指令

AT 指令

AT 指令可用来查询、设置参数，本产品支持串口 AT 和网络 AT。

AT 指令格式

AT 指令遵循以下准则:

1. 以 AT+ 开头，以 \r 或 \n 结尾
2. 对指令大小写不敏感，建议使用大写字母
3. 命令行中只能包含一条 AT 指令，单条命令最长 256 字节
4. 多个参数时以英文半角逗号 , 分割
5. 要等待前一条命令返回结果后才能发送新命令（命令最大超时时间 12s）

指令有查询、设置、帮助 3 类形式，每类形式的格式如下:

• 查询
  • 发送: AT+CMD\r\n 或 AT+CMD?\r\n
  • 返回: \r\n+CMD:value\r\nOK\r\n
• 设置
  • 发送: AT+CMD=value1,value2...\r\n
  • 返回: \r\nOK\r\n
• 帮助（对于可设参数的指令才有效，可查询参数取值范围和格式）
  • 发送: AT+CMD=?\r\n
  • 返回: \r\n+CMD:(参数 1:范围),(参数 2:范围)...\r\nOK\r\n

下文中指令的描述如未特殊说明则省略 \r\n。

AT 指令错误码信息

指令执行失败时设备会发出错误码，错误码格式为: \r\n+ERROR:Error_Code\r\n。

错误码

Error Code	错误类型	原因
ARGS	参数不合法	参数长度、大小、格式等不合法
ARGC	参数个数不合法	参数个数不对
CMD_UNKNOWN	未知指令	指令不存在
CMD_FORMAT	格式错误	未以 AT+ 开头
CMD_LENGTH	长度错误	超过最大命令长度
DEV_MEMORY	内存错误	内存错误
DEV_SAVE	保存失败	保存失败

AT 指令快速掌握

产品庞大数量的 AT 指令给用户带来灵活性的同时也增加了用户对 AT 指令的上手难度，本节介绍几条常用指令可让用户在短时间内掌握大部分指令。

• 切换为透传模式: AT+EXIT
• 获取指令列表: AT+LIST
• 重启设备: AT+REBOOT
• 恢复默认参数: AT+RSTCFG
• 查询参数格式: AT+CMD=? 例如: 发送 AT+ECHO=? 返回 +ECHO:(echo:OFF/ON)

AT 指令详解

本节详细介绍设备的 AT 指令。注意指令含有小写字母 n 时表示指令为第 n 路串口所有，发送指令时请将 n 替换为串口号。例如查询串口 2 的参数: AT+UART2。

指令中有小写字母 s 时表示 SocketA 或 SocketB，发送指令时请将 s 替换为 A 或 B。例如设置串口 1 的 SocketA 参数: AT+SOCK1A=TCPC,192.168.1.8,8888。