AT命令集

本章将具体介绍如何使用各类 AT 命令。

强烈建议在使用命令之前先阅读以下内容,了解 AT 命令的一些基本信息。

AT 命令分类

通用 AT 命令有四种类型:

类型

命令格式

说明

测试命令

AT+<命令名称>=?

查询设置命令的内部参数及其取值范围

查询命令

AT+<命令名称>?

返回当前参数值

设置命令

AT+<命令名称>=<…>

设置用户自定义的参数值,并运行命令

执行命令

AT+<命令名称>

运行无用户自定义参数的命令

  • 不是每条 AT 命令都具备上述四种类型的命令。

  • 命令里输入参数,当前只支持字符串参数和整形数字参数。

  • 尖括号 < > 内的参数不可以省略。

  • 方括号 [ ] 内的参数可以省略,省略时使用默认值。例如,运行 AT+WJAP 命令时省略某些参数:

    AT+WJAP="ssid","password"
    AT+WJAP="ssid","password","11:22:33:44:55:66"
    
  • 当省略的参数后仍有参数要填写时,必须使用 ,,以示分隔,如:

    AT+CWJAP="ssid","password",,1
    
  • 使用双引号表示字符串参数,如:

    AT+CWSAP="ESP756290","21030826",1,4
    
  • 特殊字符需作转义处理,如 ,"\ 等。

    • \\:转义反斜杠。

    • \,:转义逗号,分隔参数的逗号无需转义。

    • \":转义双引号,表示字符串参数的双引号无需转义。

    • \<any>:转义 <any> 字符,即只使用 <any> 字符,不使用反斜杠。

  • 只有 AT 命令 中的特殊字符需要转义,其它地方无需转义。例如,AT 命令口打印 > 等待输入数据时,该数据不需要转义。

    AT+WJAP="comma\,backslash\\ssid","1234567890"
    AT+MQTTPUB=0,"topic","\"{\"sensor\":012}\"",1,0
    
  • AT 命令的默认波特率为 115200。

  • 每条 AT 命令的长度不应超过 256 字节。

  • 每条 AT指令接收buff大小最大一包为 1024字节。

  • AT 命令以新行 (CR-LF) 结束,所以串口工具应设置为“新行模式”。

  • AT 命令错误代码的定义请见 响应错误码