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

.. toctree::
   :maxdepth: 1
   :glob:

   * 

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

AT 命令分类
------------------

通用 AT 命令有四种类型：

.. list-table::
   :header-rows: 1
   :widths: 20 30 55

   * - 类型 
     - 命令格式 
     - 说明
   * - 测试命令
     - 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 命令错误代码的定义请见 :doc:`../instruction/other/error_code_`。