查看“︁AT模块 1: 简介（Introduction）和 AT 消息格式”︁的源代码

= 模块 1: 简介（Introduction）和 AT 消息 =

== 简介（Introduction） ==

本文主要介绍 AT 命令集及其使用方法。该命令集包括：基础 AT 命令、Wi-Fi 功能 AT 命令、TCP/IP 工具箱 AT 命令和 BLE 相关 AT 命令。

=== 指令类型（Instruction type） ===

{| class="wikitable"
! 类型
! 格式
! 描述
|-
| 查询指令
| AT+<x>?
| 该指令用于返回当前参数的值
|-
| 设置指令
| AT+<x>=<···>
| 该指令用于设置用户定义的参数
|-
| 执行指令
| AT+<x>
| 该指令用于执行模块内参数不可变的功能
|}

'''重要说明：'''

* 并非每个 AT 命令都具有上述三种类型
* 目前，AT 命令中作为输入参数仅支持字符串和整数
* 尖括号 < > 表示不可省略的参数
* 方括号 [ ] 表示可以省略的可选参数。省略时将使用参数的默认值
* 如果要省略的参数后面还有参数，必须使用逗号来表示。例如：AT+CWJAP="ssid","password",,1
* 字符串值需要包含在双引号中，例如：AT+CWSAP="AP-NAME","12345678"
* 每个 AT 命令的长度不应超过 256 字节
* AT 命令以换行符（CR-LF）结束，因此串口工具应设置为"换行模式"

: <small>'''注意：''' AT 命令中的参数存储是通过 EasyFlash 库实现的。</small>

----

== AT 消息（AT Messages） ==

从 AT 命令端口返回的 AT 消息有两种类型：AT 响应消息和 AT 消息报告。

=== 响应消息（Response Messages） ===

每个 AT 命令输入都会返回响应消息，以告知发送者 AT 命令的结果。响应的最后一条消息始终是 "OK" 或 "ERROR"。

{| class="wikitable"
! AT 响应消息
! 描述
|-
| OK
| AT 命令处理完成并返回 OK
|-
| ERROR
| AT 命令错误或执行过程中发生错误
|-
| SEND OK
| 数据已发送到协议栈
|-
| SEND FAIL
| 向协议栈发送数据时发生错误
|-
| +<Command Name>:<code>...</code>
| 向发送者详细描述 AT 命令处理结果的响应
|}

=== 消息报告（Message Reports） ===

AT 将报告系统中的重要状态变化或消息。

{| class="wikitable"
! AT 消息报告
! 描述
|-
| ready
| AT 固件已就绪
|-
| busy p...
| 忙于处理。系统正在处理上一条命令，因此无法接受新输入
|-
| ERR CODE:<code><0x%08x></code>
| 不同命令的错误代码
|-
| +CW:CONNECTING
| Wi-Fi 站点接口正在连接到 AP
|-
| +CW:CONNECTED
| Wi-Fi 站点接口已连接到 AP
|-
| +CW:ERROR
| Wi-Fi 站点接口连接 AP 失败
|-
| +CW:GOTIP
| Wi-Fi 站点接口已获得 IPv4 地址。如果启用 AT+SYSLOG，此消息后将打印额外的网络信息，包括 IP 地址、网关、子网掩码和 DNS 服务器
|-
| +CW:DISCONNECTED
| Wi-Fi 站点接口已与 AP 断开连接
|-
| +CW:STA_CONNECTED <sta_mac>
| 一个站点已连接到 AT 的 Wi-Fi softAP 接口
|-
| +CW:STA_DISCONNECTED <sta_mac>
| 一个站点已与 AT 的 Wi-Fi softAP 接口断开连接
|-
| +CW:DIST_STA_IP <sta_mac>,<sta_ip>
| AT 的 Wi-Fi softAP 接口向站点分配了一个 IP 地址
|-
| +CW:SCAN_DONE
| Wi-Fi 扫描完成事件
|-
| +CIP:[<conn_id>,]CONNECTED
| ID 为 <code><conn_id></code> 的网络连接已建立（默认 ID=0）
|-
| +CIP:[<conn_id>,]DISCONNECTED
| ID 为 <code><conn_id></code> 的网络连接已结束（默认 ID=0）
|-
| +LINK_CONN
| TCP/UDP/SSL 的详细连接信息
|-
| >
| AT 正在等待接收更多数据
|-
| Recv <code><xxx></code> bytes
| AT 已从 AT 命令端口接收到 <code><xxx></code> 字节
|-
| +IPD
| 在非透传模式下，AT 已从网络接收到数据。具体的数据格式如下表所示
|-
| +MQTT:CONNECTED,<linkid>
| MQTT 已连接到 Broker
|-
| +MQTT:DISCONNECTED,<linkid>
| MQTT 已与 Broker 断开连接
|-
| +MQTT:SUBRECV,<LinkID>,<topic_length>,<data_length>,<"topic">,<data>
| 当 AT 收到订阅主题的 MQTT 消息时
|-
| 透传模式下的数据
| 在透传模式下，已从网络或蓝牙接收到数据
|-
| SEND CANCELLED
| 在 Wi-Fi 正常传输模式下取消发送数据
|-
| +BLE:CONNECTED
| 蓝牙 LE 连接已建立
|-
| +BLE:DISCONNECTED
| 蓝牙 LE 连接已结束
|-
| +BLE:CONNPARAM
| 蓝牙 LE 连接参数更新
|-
| +BLE:GATTREAD
| 来自蓝牙 LE 连接的读取操作
|-
| +BLE:GATTWRITE
| 来自蓝牙 LE 连接的写入操作
|-
| +BLE:SRV
| 发现蓝牙 LE 连接服务
|-
| +BLE:SRVCHAR
| 发现蓝牙 LE 连接特征
|-
| +BLE:INDICATION
| 蓝牙服务指示状态：0：禁用，1：启用，2：确认
|-
| +BLE:NOTIFICATION
| 蓝牙服务通知状态
|-
| +BLE:NOTIDATA
| 蓝牙服务接收通知/指示数据
|-
| +BLE:MTUSIZE
| 蓝牙 MTU 大小更新
|-
| +BLE:PAIRINGFAILED
| 蓝牙配对失败
|-
| +BLE:PAIRINGCOMPLETED
| 蓝牙配对完成
|-
| +BLE:PAIRINGCONFIRM
| 蓝牙配对确认通知
|-
| +BLE:PASSKEYENTRY
| 蓝牙配对密钥通知
|-
| +BLE:PASSKEYDISPLAY
| 蓝牙配对密钥显示通知
|-
| +BLE:BASLEVEL
| 蓝牙 BAS 配置文件级别
|-
| +QUITT
| AT 退出 Wi-Fi <code>透传模式</code>
|}

: <small>'''注意：''' 在非透传模式下，AT 从网络接收的数据格式：
:* 如果 AT+CIPMUX=0 且 AT+CIPRECVTYPE=1，打印：+IPD:<length>
:* 如果 AT+CIPMUX=1 且 AT+CIPRECVTYPE=<link_id>,1，打印：+IPD:<link_id>,<length>
:* 如果 AT+CIPMUX=0、AT+CIPRECVTYPE=0 且 AT+CIPDINFO=0，打印：+IPD:<length>,<data>
:* 如果 AT+CIPMUX=1、AT+CIPRECVTYPE=<link_id>,0、AT+CIPDINFO=0，打印：+IPD:<link_id>,<length>,<data>
:* 如果 AT+CIPMUX=0、AT+CIPRECVTYPE=0、AT+CIPDINFO=1，打印：+IPD:<length>,<"remote_ip">,<remote_port>,<data>
:* 如果 AT+CIPMUX=1、AT+CIPRECVTYPE=<link_id>,0、AT+CIPDINFO=1，打印：+IPD:<link_id>,<length>,<"remote_ip">,<remote_port>,<data>
:
: 其中，link_id 指连接 ID，length 表示数据长度，remote_ip 表示远程 IP 地址，remote_port 表示远程端口号，data 表示数据。
:
: 当是 SSL 连接时，在被动接收模式（AT+CIPRECVTYPE=1）下，AT 命令返回的长度可能与实际可读的 SSL 数据长度不匹配。这是因为 AT 优先返回 SSL 层的可读数据长度。如果 SSL 层的可读数据长度为 0，AT 将返回 socket 层的可读数据长度。</small>

----

'''模块 1 结束'''