本文将详细描述每个 AT 指令的语法格式，功能及使用。 若无特别说明，某指令仅适用于 Wi-Fi 模式。
所有指令均为立即生效，无需特殊指令进行保存， AT 指令 可以通过超级终端等串口调试程序进行输入，也可以通过编程输入。
AT指令格式
AT+ 指令采用基于 ASCII 码的命令行，格式如下：
说明
- a) <>：表示必须包含的部分
- b) []：表示可选的部分
命令格式
AT+<CMD>[op][para-1,para-2,para-3,......]\r
- a)
AT+: 命令消息前缀 - b)
CMD: 指令字符串 - c)
[op]: 指令操作符。可以是：
- 1、
"=": 表示参数设置，或查询指定参数 - 2、
"?": 表示查询系统参数 - 3、
"无":表示执行指令 - 4、
"=?":表示查询用户设置的参数
- d)
[para-n]: 表示设置的参数值，或指定查询的参数 - e)
\r: 回车结束符，ASCII码 0x0d
回应消息格式
[\r\n][+CMD:][para-1,para-2,para-3,......]<\r\n><STATUS><\r\n>
- a)
\r:：回车结束符，ASCII码： 0x0d - b)
\n ：换行符，ASCII码： 0x0a - c)
[+CMD:] ：相应的命令字符串 - d)
[para-n] ：查询时返回的参数 - e)
[STATUS]：指令执行成功与否，有两种情况：
- （1）
OK： 表示正确执行; - （2）
ERROR： 表示执行出错。
EVENT格式
EVENT 描述当前 Wi-Fi/BT 功能和网络连接状态，例如：STA、AP连接状态，TCP、UDP连接情况，RFCOMM的连接情况等。
事件消息格式：
\r\n+<TYPE>：[para-1,para-2,para-2,...,para-n]\r\n
<TYPE>：事件类型，包括：WEVENT，表示 WiFi功能通知； CIPEVENT，表示网络连接通知，BTEVENT表示BT/RFCOMM的连接通知（仅EMW3239支持）。[para-n]：事件参数，详见 EVENT事件通知\r: 回车符，ASCII码 0x0d\n: 换行符，ASCII码 0x0a
基础版AT指令
AT指令 v2.0 主要包括：
- 基本 AT 指令
- UART 管理指令
- Wi-Fi 管理指令
- TCP/UDP通信指令
- MQTT 通信指令
- 配网管理指令
- SNTP 时间同步指令
- BT 控制指令
- 以太网透传指令
- 固件OTA指令
- 电源管理指令
具体指令及返回的消息格式，请参考上节中：AT 指令格式。以下指令介绍中，不再添加重复的格式内容，如：\r\n
一、System AT command
| Order |
Command |
Description |
| 1 |
AT+FWVER |
Query firmware version number |
| 2 |
AT+SYSTIME |
Query system runtime |
| 3 |
AT+MEMFREE |
Query system remaining space size |
| 4 |
AT+FACTORY |
Restore Module Factory Settings |
| 5 |
AT+REBOOT |
Restart Module |
| 6 |
AT+FLASHLOCK |
Turn FLASH lock on or off |
| 7 |
AT+WEVENT |
Turn on or turn off event message notifications prefixed with +WEVENT |
| 8 |
AT+CIPEVENT |
Turn on or turn off event message notifications prefixed with +CIPEVENT |
| 9 |
AT+STANDBY |
Entering sleep mode |
AT+FWVER
功能：查询固件版本号。
| 指令： |
``AT+FWVER? |
| HEX： |
41 54 2B 46 57 56 45 52 3F 0D |
| 响应： |
``+FWVER: |
| 参数： |
``fwver：固件版本号 |
AT+SYSTIME
功能：查询系统运行时间。
| 指令： |
``AT+SYSTIME? |
| HEX： |
41 54 2B 53 59 53 54 49 4D 45 0D |
| 响应： |
``+SYSTIME: |
|
``OK |
| 参数： |
``systime：系统运行时间，单位：毫秒（ms) |
AT+MEMFREE
功能：查询系统剩余空间大小。
| 指令： |
``AT+MEMFREE? |
| HEX： |
41 54 2B 4D 45 4D 46 52 45 45 3F 0D |
| 响应： |
``+MEMFREE: |
|
``OK |
| 参数： |
``storage：存储空间大小，单位：字节（Byte） |
AT+FACTORY
功能：恢复 模块出厂设置。
| 指令： |
``AT+FACTORY |
|
41 54 2B 46 41 43 54 4F 52 59 0D |
| 响应： |
``OK |
| 参数： |
无 |
| 说明: |
立即重启，生效 |
AT+REBOOT
功能：重启模块。
| 指令： |
``AT+REBOOT |
|
41 54 2B 52 45 42 4F 4F 54 0D |
| 响应： |
``OK |
| 参数： |
无 |
AT+FLASHLOCK
功能：FLASH锁指令
| 查询指令： |
``AT+FLASHLOCK? |
|
41 54 2B 46 4C 41 53 48 4C 4F 43 4B 3F 0D |
| 响应： |
``+FLASHLOCK: |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+FLASHLOCK= |
| 响应： |
``OK |
| 参数： |
mode：ON:开启； OFF：关闭； 开始FLASHLOCK后，参数将不再保存 |
AT+WEVENT
功能：开启或关闭以 +WEVENT 为前缀的事件消息通知。
| 查询指令： |
``AT+WEVENT? |
|
41 54 2B 57 45 56 45 4E 54 3F 0D |
| 响应： |
``+WEVENT= |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+WEVENT= |
| 响应： |
``OK |
| 参数： |
state：ON, 表示开启通知功能； ``OFF，表示关闭通知功能。 |
| 说明： |
立即生效。 |
AT+CIPEVENT
功能：开启或关闭以 +CIPEVENT 为前缀的事件消息通知。
| 查询指令： |
``AT+CIPEVENT? |
|
41 54 2B 43 49 50 45 56 45 4E 54 3F 0D |
| 响应： |
``+CIPEVENT= |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+CIPEVENT= |
| 响应： |
``OK |
| 参数： |
state：ON, 表示开启CIPEVENT通知功能； ``OFF，表示关闭CIPEVENT通知功能。 |
| 说明： |
立即生效。 注意：用户若采用 “透传 工作模式，必须首先关闭该事件通知功能。 |
AT+STANDBY
功能：进入模块休眠工作模式，需 STANDBY 管脚唤醒，可参考相应型号模块的数据手册管脚定义内容。
| 查询指令： |
``AT+STANDBY |
|
41 54 2B 53 54 41 4E 44 42 59 0D |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。必须使用 STANDBY 管脚进行唤醒后，才能响应 AT 指令。 |
二、UART管理指令
| 序号 |
命令 |
描述 |
| 1 |
AT+UART |
查询/设置 UART 串口参数 |
| 2 |
AT+UARTFOMAT |
查询/设置 UART 自动触发长度和触发时间 |
| 3 |
AT+UARTE |
查询/设置 UART 串口回显状态 |
AT+UART
功能：查询/设置 串口参数。
| 查询指令： |
``AT+UART? |
|
41 54 2B 55 41 52 54 3F 0D |
| 响应： |
``+UART:,,,,] |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+UART=,,,, |
| 响应： |
``OK |
| 参数： |
``band_rate：波特率，可以是： 4800，9600，14400，19200， 38400， 57600， 115200， 230400， 460800， 921600 bps |
|
``data_bits：数据位，可以是：7,8 |
|
``stop_bit：停止位，可以是: 1，2 |
|
``parity：校验位，可以是： NONE：无校验； ODD：奇校验； EVEN：偶校验 |
|
``flow_control： 流控，可以是：NONE：无流控； CTS：使能CTS流控； RCS：使能RTS流控； CTSRTS：使能CTSRTS流控 |
| 说明： |
重启生效 |
AT+UARTFOMAT
功能：查询 / 设置 自动成帧触发长度和触发时间（Wi-Fi/BT均支持）
| 查询指令： |
``AT+UARTFOMAT? |
|
41 54 2B 55 41 52 54 46 4F 4D 41 54 3F 0D |
| 响应： |
``+UARTFOMAT:, |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+UARTFOMAT=, |
| 响应： |
``OK |
| 参数： |
``length：自动成帧触发长度，单位: Byte, 范围：1-1024, 默认：1024。 |
|
``time：自动成帧触发时间，单位: ms, 范围：50-500，默认：100。 |
| 说明： |
在命令控制模式下，自动成帧触发长度的最小值是 65，立即生效。 |
AT+UARTE
功能：查询 / 设置 串口指令是否开启回显功能。
| 查询指令： |
``AT+UARTE? |
|
41 54 2B 55 41 52 54 45 3F 0D |
| 响应： |
``+UARTE: |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+UARTE= |
| 响应： |
``OK |
| 参数： |
option：ON, 表示开启回显功能； ``OFF，表示关闭回显功能。 |
| 说明： |
立即生效。 |
三、WiFi管理指令
| 序号 |
命令 |
描述 |
| 1 |
AT+WFVER |
查询射频固件版本号 |
| 2 |
AT+WMAC |
查询 MAC 地址 |
| 3 |
AT+WSCANOPT |
查询/设置 WiFi 扫描类型 |
| 4 |
AT+WSCAN |
启动 WiFi 扫描功能 |
| 5 |
AT+WDHCP |
查询/设置 是否使能 DHCP 功能 |
| 6 |
AT+WSAPIP |
查询/设置 Soft_AP 模式的 IP 地址，子网掩码和网关 |
| 7 |
AT+WSAP |
查询/设置 Soft_AP 模式的名称和密码，并启动AP |
| 8 |
AT+WSAPQ |
关闭 AP |
| 9 |
AT+WSAPS |
查询当前AP状态 |
| 10 |
AT+WJAPIP |
查询/设置 Station 模式的 IP 地址，子网掩码和网关 |
| 11 |
AT+WJAP |
查询/设置 Station 模式 AP 名称和密码，并连接AP |
| 12 |
AT+WJAPQ |
断开 AP 的连接 |
| 13 |
AT+WJAPS |
查询当前 Station 连接状态 |
AT+WFVER
功能：查询 射频驱动版本
| 指令： |
``AT+WFVER? |
|
41 54 2B 57 46 56 45 52 3F 0D |
| 响应： |
``+WFVER: |
|
``OK |
| 参数： |
``fver：射频固件版本 |
| 说明： |
立即生效。 |
AT+WMAC
功能 ：查询 模块 MAC 地址
| 指令： |
``AT+WMAC? |
|
41 54 2B 57 4D 41 43 3F 0D |
| 响应： |
``+WMAC: |
|
``OK |
| 参数： |
``mac：模块的 MAC 地址 |
| 说明： |
``MAC 地址格式：XX:XX:XX:XX:XX:XX。立即生效。 |
AT+WSCANOPT
功能：查询/设置 WiFi 扫描类型
| 查询指令： |
``AT+WSCANOPT?\r |
|
41 54 2B 57 53 43 41 4E 4F 50 54 3F 0D |
| 响应： |
``+WSCANOPT: |
|
``OK |
| 参数： |
请参考设置指令参数说明。 |
| 设置指令： |
``AT+WSCANOPT= |
| 响应： |
``OK |
| 参数： |
``option：0, 表示 normal，普通扫描； 1，表示advanced，高级扫描。 |
| 说明： |
普通扫描结果仅包含ssid和信号强度，高级扫描结果包含ssid, bssid, 加密方式，信道和信号强度 。立即生效。 |
AT+WSCAN
功能：扫描指定 ssid 的或所有的 AP
| 扫描指定ssid的AP的指令： |
``AT+WSCAN= |
|
41 54 2B 57 53 43 41 4E 3D <指定SSID的HEX> 0D |
| 响应： |
若扫描类型为普通扫描，即：option=0，返回： ``+WSCAN:\r\n, |
|
若扫描类型为高级扫描，即：option=1，返回：``+WSCAN:\r\n,,,, |
| 参数： |
请参考扫描所有 AP 指令参数。 |
| 扫描所有AP的指令： |
``AT+WSCAN |
| 响应： |
``+WSCAN: |
|
``,[bssid],[en],[channe], |
| 参数： |
``number:扫描到的 AP 的数目。普通扫描和高级扫描均打印该参数。 |
|
``ssid：扫描到的 AP 的 ssid。普通扫描和高级扫描均打印该参数 |
|
``bssid：扫描到的 AP 的 bssid。当高级扫描时，打印该参数。 |
|
``en：扫描到的 AP 的 加密方式。当高级扫描时，打印该参数。 |
|
``channel：扫描到的 AP 的 信道。当高级扫描时，打印该参数。 |
|
``rssi：扫描到的 AP 的信号强度 |
| 说明 |
立即生效。 |
AT+WDHCP
功能：查询/设置 是否开启 DHCP 功能
| 查询指令： |
``AT+WDHCP? |
|
41 54 2B 57 44 48 43 50 3F 0D |
| 响应： |
``+WDHCP: |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+WDHCP= |
| 响应： |
``OK |
| 参数： |
option：ON，表示启动 DHCP 功能；``OFF，表示关闭 DHCP 功能 |
| 说明： |
立即生效 |
AT+WSAPIP
功能：查询/设置 模块在 Soft_AP模式时 的 IP 地址
| 查询指令： |
``AT+WSAPIP? |
|
41 54 2B 57 53 50 49 50 3F 0D |
| 响应： |
``+WSAPIP:,, |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+WSAPIP=[,,] |
| 响应： |
``OK |
| 参数： |
``ip：Soft_AP 的 IP 地址 |
|
``netmask：子网掩码 |
|
``gateway：网关地址 |
| 说明： |
立即生效。模块出厂各参数默认为0。 |
AT+WSAP
功能：查询/设置 Soft_AP 的名称及密码，并启动。
| 查询指令： |
``AT+WSAP=? |
|
41 54 2B 57 53 41 50 3F 0D |
| 响应： |
``+WSAP:, |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+WSAP=, |
| 响应： |
``OK |
| 参数： |
ssid：Soft_AP 的 ssid 名称，最大 32 位。 |
|
key：Soft_AP 的 密码，最大64位。当长度小于 8 位时，加密方式：OPEN。大于 8 位时，加密方式：WPA。 |
| 说明： |
立即生效。模块出厂参数默认均为 0。 |
AT+WSAPQ
功能：关闭当前的 Soft_AP 模式。
| 指令： |
``AT+WSAPQ |
|
41 54 2B 57 53 41 50 51 |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。 |
AT+WSAPS
功能：查看当前Soft_AP的启动状态。
| 指令： |
``AT+WSAPS |
|
41 54 2B 57 53 41 50 53 |
| 响应： |
``+WSAPS: |
| 参数： |
state:AP_UP, 表示成功创建 Soft_AP；AP_DOWN,表示该 ``Soft_AP 已关闭。 |
| 说明： |
立即生效。 |
AT+WJAPIP
功能：查询/设置 模块在 Station 模式时的 IP 地址。
| 查询指令： |
``AT+WJAPIP? |
|
41 54 2B 57 4A 41 50 49 50 3F 0D |
| 响应： |
``+WJAPIP:,,, |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+WJAPIP=,,[,] |
| 响应： |
``OK |
| 参数： |
``ip： 模块做 Station 时的 IP 地址 |
|
``network：子网掩码 |
|
``gateway: 网关地址 |
|
``dns: 域名 |
| 说明： |
模块重启生效。当模块未成功连接 AP 时，各参数默认为 0。 |
AT+WJAP
功能：查询已设置的，在Station 模式，要接入的 AP 的名称和密码。
| 查询指令： |
``AT+WJAP=? |
|
41 54 2B 57 4A 41 50 3D 3F 0D |
| 响应： |
``+WJAP:, |
| 参数： |
``ssid： Station模式要接入的 AP 名称 |
|
``key：Station模式要接入的 AP 密码 |
功能：查询当前 WiFi 连接状态，包括：接入的 AP 的 SSID，MAC地址，通道号，信号强度。
| 查询指令： |
``AT+WJAP? |
|
41 54 2B 57 4A 41 50 3F 0D |
| 响应： |
``+WJAP:,,, |
| 参数： |
``ssid： 已连接的 AP 的ssid |
|
``bssid： 已连接的 AP 的MAC地址 |
|
``channel：已连接的 AP 的信道号 |
|
``rssi： 已连接的 AP 的信号强度 |
| 说明 |
当模块未成功连接 AP 时，各参数默认为 0。 |
功能：设置 Station模式要接入的 AP 的名称和密码。
| 设置指令： |
``AT+WJAP=, |
| 响应： |
``OK |
| 参数： |
``ssid： Station模式要接入的 AP 名称 |
|
``key：Station模式要接入的 AP 密码 |
| 说明： |
立即生效。 |
AT+WJAPQ
功能：关闭当前的 Station 模式
| 指令： |
``AT+WJAPQ |
|
41 54 2B 57 4A 41 50 51 |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。 |
AT+WJAPS
功能：查看当前 Station 模式的连接状态
| 指令： |
``AT+WJAPS |
|
41 54 2B 57 4A 41 50 53 3F 0D |
| 响应： |
``+WJAPS: |
| 参数： |
state:STATION_UP, 表示成功连接AP； STATION_DOWN,表示连接 AP 失败；CONNECTING,表示正在连接中。 |
|
注意：当未连接成功时，返回错误码。0：代表正常；1：代表密码错误；2：代表找不到SSID；3：代表未知的错误 |
| 说明： |
立即生效。 |
四、TCP和UDP通信指令
| 序号 |
指令 |
功能 |
| 1 |
AT+SSLCERTGET |
获取SSL证书 |
| 2 |
AT+SSLCERTSET |
设置SSL证书 |
| 3 |
AT+CIPDOMAIN |
域名解析 |
| 4 |
AT+CIPAUTOCONN |
查询/设置指定 id 连接是否为自动连接 |
| 5 |
AT+CIPSSLOPT |
设置指定 id 连接的ssl参数 |
| 6 |
AT+CIPSTART |
启动一个指定 id 的连接 |
| 7 |
AT+CIPSTOP |
断开一个指定 id 的连接 |
| 8 |
AT+CIPSTATUS |
查询指定 id 的连接状态 |
| 9 |
AT+CIPSEND |
通过串口向指定 id 的连接发送数据 |
| 10 |
AT+CIPSENDRAW |
指令模式跳转至透传模式 |
| 11 |
AT+CIPRECV |
接收 WiFi 数据至用户串口 |
| 12 |
AT+CIPRECVCFG |
查询/设置 WiFi 数据发送至用户串口，通过指令模式，还是透传模式 |
AT+SSLCERTGET
功能：获取 SSL 证书类型。
| 指令： |
``AT+SSLCERTGET= |
| 响应： |
``+SSLCERTGET:cert |
|
``OK |
| 参数： |
``type：0，代表根证书；1，代表客户端证书；2，代表私钥；3，代表证书吊销列表 |
| 说明： |
立即生效。 |
AT+SSLCERTSET
功能：设置 SSL 证书类型。
| 指令： |
``AT+SSLCERTSET= |
| 响应： |
``> |
| 参数： |
``type:0，代表根证书；1，代表客户端证书；2，代表私钥；3，代表证书吊销列表 |
| 说明： |
立即生效。返回>后，传递证书文件，在证书末尾追加Ctrl+Z(ASCII码是``0x1A，不属于证书的一部分)，作为证书传递结束符。 |
AT+CIPDOMAIN
功能：域名解析。
| 指令： |
``AT+CIPDOMAIN= |
| 响应： |
``+CIPDOMAIN: |
|
`` |
| 参数： |
``number:IP 地址的个数 |
|
``ip：IP 地址 |
| 说明： |
立即生效。 |
AT+CIPAUTOCONN
功能：查询/设置指定 id 连接是否为自动连接。
| 查询指令： |
``AT+CIPAUTOCONN= |
| 响应： |
``+CIPAUTOCONN: |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+CIPAUTOCONN=, |
| 响应： |
``OK |
| 参数： |
``id： 指定连接的 id 号 |
|
``option：0，表示关闭自动连接；1，表示开启自动连接。 |
| 说明： |
立即生效。出厂默认为 1。 |
AT+CIPSSLOPT
功能：设置指定 id 连接的SSL参数。
| 设置指令： |
``AT+CIPSSLOPT=,,[,isSSLCrl] |
| 响应： |
``OK |
| 参数： |
``id： 指定连接的 id 号 |
|
``isSSLRoot：0，不验证根证书；1，验证根根证书 |
|
``isSSLClient：0，不验证客户端证书；1，验证客户端证书 |
|
``isSSLCrl：0，不验证证书吊销列表；1，验证证书吊销列表 |
AT+CIPSTART
功能：启动一个连接
| 指令： |
``AT+CIPSTART=,,[domain],[remote_port],[local_port] |
| 响应： |
``OK |
| 参数： |
``id： 指定连接的 id 号,范围：0 - 4，即 最多可创建 5 个连接。 |
|
tpye：连接类型，包括：tcp_server,tcp_client,ssl_client, udp_broadcast，udp_unicast。分别如下： |
|
—- 1. 当type为tcp_server时，参数为：``id,tcp_server,local_port； |
|
—- 2. 当type为tcp_client时，参数为：``id,tcp_client,domain,remote_port[,local_port]; |
|
—- 3. 当type为ssl_client时，参数为：``id,ssl_client,domain,remote_port[,local_port]; |
|
—- 4. 当type为udp_broadcast时，参数为：``id,udp_broadcast,domain,remote_port,local_port; |
|
—- 5. 当type为udp_unicast时，参数为：``id,udp_unicast,domain,remote_port,local_port。 |
|
``domain：目标服务器的 IP 或域名。当 type 为 tcp_server 时，不需要该参数。 |
|
``remote_port：远程端口。 |
|
``local_port： 本地端口。当type为tcp_client或ssl_client时，该参数为指定本地端口 |
| 说明： |
立即生效。注意：当前 id 的连接，如果不是关闭状态，再次设置并连接时，无法成功执行，返回：ERROR。更改任何一个 id 的参数前，必须要手动关闭，即执行指令：``AT+CIPSTOP=id\r，才能正确设置并连接。 |
AT+CIPSTOP
功能：断开一个指定 id 的连接。
| 指令： |
``AT+CIPSTOP=[,] |
| 响应： |
``OK |
| 参数： |
``id： 指定连接的 id 号。 |
| 说明： |
立即生效。 |
AT+CIPSTATUS
功能：查询指定 id 的连接状态。
| 指令： |
``AT+CIPSTATUS= |
| 响应： |
``+CIPSTATUS:, |
| 参数： |
``type： 指定 id 的连接类型，包括：tcp_server,tcp_client,udp_broadcast,udp_unicast,ssl_client。 |
|
``status:start，初始化;connecting，正在连接;connected，已经连接;disconnected，断开连接；close，停止连接 |
| 说明： |
立即生效。 |
AT+CIPSEND
功能：发送 WiFi 数据至用户串口。
| 指令： |
``AT+CIPSEND=[,],\r |
| 响应： |
``+OK |
| 参数： |
``id： 指定 id 的连接 。 |
|
``remote_port: 连接的远程端口号。仅模块做tcp server时需要指定远程端口号，其它socket类型不需指定。 |
|
``data_length：数据长度。单位：byte字节。 |
|
``data:数据内容。 |
| 说明： |
立即生效。 |
| 示例： |
AT+CIPSEND=0,54590,9\r123456789 |
|
AT+CIPSEND=1,9\r123456789 |
AT+CIPSENDRAW
功能：由 AT 指令模式跳转至透传模式。
| 指令： |
``AT+CIPSENDRAW |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。 |
|
退出透传模式请输入``+++ |
AT+CIPRECV
功能：接收 WiFi 数据至用户串口。
| 指令： |
``AT+CIPRECV=,, |
| 响应： |
``+CIPRECV=, |
|
``OK |
| 参数： |
``id：指定 id 号 的连接 |
|
``port: 指定连接的远程端口号 |
|
``len：指定的数据接收长度，单位：byte字节 |
|
``data：数据 |
| 说明： |
立即生效。 |
AT+CIPRECVCFG
功能：查询/设置 WiFi 数据发送至用户串口的配置参数。
| 查询指令： |
``AT+CIPRECVCFG? |
| 响应： |
``+CIPRECVCFG: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+CIPRECVCFG= |
| 响应： |
``OK |
| 参数： |
recv mode：0，表示cmd指令模式，需通过指令AT+CIPRECV 接收；1，表示raw透传模式，表示自动接收。 |
| 说明： |
立即生效。 |
五、MQTT通信指令
| 序号 |
指令 |
功能 |
| 1 |
AT+MQTTAUTH |
查询/设置MQTT用户授权信息 |
| 2 |
AT+MQTTSOCK |
查询/设置MQTT socket信息 |
| 3 |
AT+MQTTCAVERIFY |
查询/设置MQTT证书认证使能状态 |
| 4 |
AT+MQTTSSL |
查询/设置MQTT SSL使能状态 |
| 5 |
AT+MQTTCID |
查询/设置MQTT客户端标识符 |
| 6 |
AT+MQTTKEEPALIVE |
查询/设置MQTT心跳周期 |
| 7 |
AT+MQTTRECONN |
查询/设置MQTT自动重连使能状态 |
| 8 |
AT+MQTTAUTOSTART |
查询/设置MQTT上电自动连接使能状态 |
| 9 |
AT+MQTTEVENT |
查询/设置MQTT事件推送使能状态 |
| 10 |
AT+MQTTSTART |
启动MQTT服务 |
| 11 |
AT+MQTTSUB |
查询/设置MQTT订阅信息 |
| 12 |
AT+MQTTPUB |
查询/设置MQTT发布信息 |
| 13 |
AT+MQTTSEND |
MQTT发布数据 |
| 14 |
AT+MQTTUNSUB |
MQTT取消订阅 |
| 15 |
AT+MQTTSTATUS |
查询MQTT状态 |
| 16 |
AT+MQTTCLOSE |
关闭MQTT服务 |
AT+MQTTAUTH
功能：查询/设置MQTT用户授权信息。
| 查询指令： |
``AT+MQTTAUTH=? |
| 响应： |
``+MQTTAUTH:, |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTAUTH=, |
| 响应： |
``OK |
| 参数： |
``UserName：用户名 |
|
``PassWord：密码 |
| 说明： |
立即生效。 |
AT+MQTTSOCK
功能：查询/设置MQTT socket信息。
| 查询指令： |
``AT+MQTTSOCK=? |
| 响应： |
``+MQTTSOCK:, |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTSOCK=, |
| 响应： |
``OK |
| 参数： |
``Host：远程URL |
|
``Port：远程端口 |
| 说明： |
立即生效。 |
AT+MQTTCAVERIFY
功能：查询/设置MQTT证书认证使能状态。
| 查询指令： |
``AT+MQTTCAVERIFY=? |
| 响应： |
``+MQTTCAVERIFY:， |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTCAVERIFY=, |
| 响应： |
``OK |
| 参数： |
Status1：是否使能服务器根证书验证，ON： 使能，``OFF： 关闭。 |
|
Status2：是否使能验证客户端证书验证，ON ：使能，``OFF： 关闭。 |
| 说明： |
立即生效。 |
AT+MQTTSSL
功能：查询/设置MQTT SSL使能状态。
| 查询指令： |
``AT+MQTTSSL=? |
| 响应： |
``+MQTTSSL: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTSSL= |
| 响应： |
``OK |
| 参数： |
Status：是否使能SSL加密， ON：使能，OFF：关闭。 |
| 说明： |
立即生效。 |
AT+MQTTCID
功能：查询/设置MQTT客户端标识符。
| 查询指令： |
``AT+MQTTCID=? |
| 响应： |
``+MQTTCID: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTCID= |
| 响应： |
``OK |
| 参数： |
``ClientID：客户端标识符。 |
| 说明： |
立即生效。 |
AT+MQTTKEEPALIVE
功能：查询/设置MQTT心跳周期。
| 查询指令： |
``AT+MQTTKEEPALIVE=? |
| 响应： |
``+MQTTKEEPALIVE: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTKEEPALIVE= |
| 响应： |
``OK |
| 参数： |
``Period：心跳周期，单位：s (秒)。 |
| 说明： |
立即生效。 |
AT+MQTTRECONN
功能：查询/设置MQTT自动重连使能状态。
| 查询指令： |
``AT+MQTTRECONN=? |
| 响应： |
``+MQTTRECONN: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTRECONN= |
| 响应： |
``OK |
| 参数： |
Status：是否使能自动重连。ON:使能， ``OFF:关闭。 |
| 说明： |
立即生效。 |
AT+MQTTAUTOSTART
功能：查询/设置MQTT上电自动连接使能状态。
| 查询指令： |
``AT+MQTTAUTOSTART=? |
| 响应： |
``+MQTTAUTOSTART: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTAUTOSTART= |
| 响应： |
``OK |
| 参数： |
Status：是否使能上电自动连接，ON:使能， ``OFF:关闭。 |
| 说明： |
立即生效。 |
AT+MQTTEVENT
功能：查询/设置MQTT事件推送使能状态。
| 查询指令： |
``AT+MQTTEVENT=? |
| 响应： |
``+MQTTEVENT: |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTEVENT= |
| 响应： |
``OK |
| 参数： |
Status：是否使能事件推送。ON 使能；``OFF 关闭。 |
| 说明： |
立即生效。开启此功能后，所有MQTT的事件，模块会通过串口主动输出，格式如下： ``+MQTTEVENT:。 |
|
``result参数说明详见AT+MQTTSTATUS 指令。 |
AT+MQTTSTART
功能：启动MQTT服务。
| 执行指令： |
``AT+MQTTSTART |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。 |
AT+MQTTSUB
功能：查询/设置MQTT订阅信息。
| 查询指令： |
``AT+MQTTSUB=? |
| 响应： |
``+MQTTSUB: |
|
``,, |
|
… |
|
``,, |
|
``OK |
| 参数： |
``sub_num：查询到的主题列表数，最大为6 |
|
其余参数参考设置指令。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTSUB=,, |
| 响应： |
``OK |
| 参数： |
``id： 为每一个主题分配的id号，取值范围0-5。 |
|
``Topic：订阅的主题。 |
|
``QoS：订阅主题的 QoS，取值范围：0-2。 |
| 说明： |
立即生效。 |
AT+MQTTPUB
功能：查询/设置MQTT发布信息。
| 查询指令： |
``AT+MQTTPUB=? |
| 响应： |
``+MQTTPUB:, |
|
``OK |
| 参数： |
请参考设置指令参数。 |
| 说明： |
立即生效。 |
| 设置指令： |
``AT+MQTTPUB=， |
| 响应： |
``OK |
| 参数： |
``Topic：发布信息的主题。 |
|
``QoS：发布信息的 QoS，范围：0-2。 |
| 说明： |
立即生效。本主题仅用于设置 topic 和 QoS ，使用 AT+MQTTSEND=<len>指令发布数据。向不同的 Topic 发布数据前，需先调用AT+MQTTPUB=, 指令，更换相应的Topic 和 QoS。 |
AT+MQTTSEND
功能：MQTT发布数据
| 执行指令： |
``AT+MQTTSEND= |
| 响应： |
``> |
| 参数： |
``len：发布数据的字节长度。 |
| 说明： |
立即生效。收到 > 后，需向模块发送指定长度的数据，模块会向远端发布数据。 |
AT+MQTTUNSUB
功能： MQTT取消订阅
| 执行指令： |
``AT+MQTTUNSUB= |
| 响应： |
``OK |
| 参数： |
``id: 取消订阅的主题对应的 id 号 |
| 说明： |
立即生效。 |
AT+MQTTSTATUS
功能： 查询MQTT状态。
| 查询指令： |
``AT+MQTTSTATUS=[,id>] |
| 响应： |
``+MQTTSTATUS: |
|
``OK |
| 参数： |
action: 客户端相对于远端的行为，包括3类：connect，subscribe，publish。 |
|
id：可选参数，当action的值为``subscribe时，需指定id号 |
|
result：返回的状态结果。根据不同的action 值，总共包括下面各种不同的结果 |
|
1. action的值为connect时，返回： |
|
``—— CONNECT,SUCCESS 连接成功 |
|
``—— CONNECT,INIT_ERROR 初始化错误 |
|
``—— CONNECT,FAIL 连接失败 |
|
``—— CONNECT,RECONNECTING 正在连接 |
|
``—— CLOSE,SUCCESS 关闭成功 |
|
``—— CLOSE,FAIL 关闭失败 |
|
2. action的值为subscribe时，返回： |
|
``—— SUBSCRIBE,SUCCESS 订阅成功 |
|
``—— SUBSCRIBE,FAIL 订阅失败 |
|
``—— UNSUBSCRIBE,SUCCESS 取消订阅成功 |
|
``—— UNSUBSCRIBE,FAIL 取消订阅失败 |
|
3. action的值为publish时，返回： |
|
``—— PUBLISH,SUCCESS 发布成功 |
|
``—— PUBLISH,FAIL 发布失败 |
| 说明： |
立即生效。 |
AT+MQTTCLOSE
功能：关闭MQTT服务
| 执行指令： |
``AT+MQTTCLOSE |
| 响应： |
``OK |
| 参数： |
无 |
| 说明： |
立即生效。 |
六、配网管理指令
| 序号 |
指令 |
功能 |
| 1 |
AT+SMARTSTART |
设置配网方式，并启动 |
| 2 |
AT+SMARTSTOP |
停止设置的配网方式 |
AT+SMARTSTART
功能：设置配网方式：Easylink或Airkiss，并启动配网。
| 执行指令： |
``AT+SMARTSTART= |
| 响应： |
``OK |
| 参数： |
``type：整数类型。 |
|
1：Easylink配网 |
|
2：Airkiss配网； |
|
3：Easylink AWS配网。 |
|
4: Easylink+Airkiss融合配网; |
|
5:SoftAP配网（只支持 IOS最新版Easylink APP）。 |
| 说明： |
立即生效。 |
AT+SMARTSTOP
功能：停止设置的配网方式。
| 执行指令： |
``AT+SMARTSTOP= |
| 响应： |
``OK |
| 参数： |
``type：1: 表示Easylink配网；2: 表示Airkiss配网;3: 表示Easylink AWS配网。 |
| 说明： |
立即生效。注意： 参数 3: Easylink AWS配网，该指令不适用与 AlinkV3 阿里直连 AT 固件。 |
AT+SMARTCFG
功能：设置 Airkiss 配网参数。
| 设置指令： |
``AT+SMARTCFG=, |
| 响应： |
``OK |
| 参数： |
``device_id：字符串，微信注册时后台提供。 |
|
``original_id：字符串，微信注册时后台提供。 |
| 说明： |
立即生效。 |
七、SNTP时间同步指令
AT+SNTPCFG
功能：设置 NTP 域名。
| 设置指令： |
``AT+SNTPCFG=[,[,]] |
| 响应： |
``OK |
| 参数： |
``time_zone： 时区，如北京：+8 |
|
``domain1: NTP 服务器域名 1 |
|
``domian2: NTP 服务器域名 2 |
| 说明： |
立即生效。 |
AT+SNTPTIME
功能：获取 NTP 时间。
| 执行指令： |
``AT+SNTPTIME |
| 响应： |
``+SNTPTIME: |
|
``OK |
| 参数： |
time:形如2017-09-05T13:34:35.063568，表示：当前 SNTP 时间为 2017 年 9 月 5 日 13 点 34 分 35 秒 63568 微秒。 |
| 说明： |
立即生效。 |
AT+RTCGET
功能：获取 NTP 时间。
| 执行指令： |
``AT+RTCGET |
| 响应： |
``+RTCGET: |
|
``OK |
| 参数： |
time:形如2017-09-05T13:34:35.063568，表示：当前 RTC 时间为 2017 年 9 月 5 日 13 点 34 分 35 秒 63568 微秒。 |
| 说明： |
立即生效。 |
八、EMC系列蓝牙AT配网指令
BLE 指令列表
| 序号 |
指令 |
功能 |
| 1 |
AT+BNAME |
查询/设置 BLE名称 |
| 2 |
AT+BMAC |
查询BLE的MAC地址 |
| 3 |
AT+BLE |
开启或关闭BLE功能 |
| 4 |
AT+BSTATUS |
查询BLE的状态 |
| 5 |
AT+BSEND |
指令模式时发送数据 |
| 6 |
AT+BSERVUUID |
查询/设置 服务的uuid |
| 7 |
AT+BRXUUID |
查询/设置 接收的uuid |
| 8 |
AT+BTXUUID |
查询/设置 发送的uuid |
| 9 |
AT+BEVENT |
设置/查询监听BLE事件 |
| 10 |
AT+BINQ |
开始扫描 |
| 11 |
AT+BSINQ |
停止扫描 |
| 12 |
AT+BCONN |
连接到从设备 |
| 13 |
AT+BROLE |
查询/设置BLE角色 |
AT+BNAME
功能：查询/设置 BLE名称
| 查询指令： |
``AT+BNAME? |
| 响应： |
``+BNAME: |
| 设置指令： |
``AT+BNAME= |
| 响应： |
OK |
AT+BMAC
功能：查询BLE的MAC地址
| 查询指令： |
``AT+BMAC? |
| 响应： |
``+BMAC: |
| 参数： |
mac：设备的MAC地址，格式为 xx:xx:xx:xx:xx:xx |
AT+BLE
功能：查询/设置 开启或关闭BLE功能
| 设置指令： |
AT+BLE= |
| 响应： |
OK |
| 响应： |
AT+BLE? |
| 参数： |
state: 开关状态 |
|
ON ： 开启BLE功能 |
|
OFF : 关闭BLE功能 |
AT+BSTATUS
功能：查询BLE的状态
| 查询指令： |
AT+BSTATUS？ |
| 响应 |
+BSTATUS: |
| 参数 |
status： |
|
DISCONNECTED ：连接断开 |
|
CONNECTED ：已建立连接 |
AT+BSEND
功能： 指令模式时发送数据
| 设置指令 |
AT+BSEND=\r |
| 响应 |
+OK |
| 参数 |
length：将要发送的数据长度 |
| 说明 |
当用户收到>响应时，应该立即将指定长度的数据通过串口发送。BLE设备将会接收并将这些数据透传到已连接的蓝牙主机
注意：设备内部在返回>响应后，会在规定时间内等待用户数据。如果已经超时，那么设备将只发送已经收到的数据。超时时间一般为6s。 |
AT+BSERVUUID
功能：查询/设置 服务的uuid
| 设置指令 |
AT+BSERVUUID= |
| 响应 |
+OK |
| 查询指令 |
AT+BSERVUUID？ |
| 响应 |
+BSERVUUID: |
| 参数 |
uuid : 服务的uuid |
AT+BRXUUID
功能：查询/设置 接收的uuid
| 设置指令 |
AT+BRXUUID= |
| 响应 |
+OK |
| 查询指令 |
AT+BRXUUID？ |
| 响应 |
+BRXUUID: |
|
uuid : 服务接收的uuid |
AT+BTXUUID
功能：查询/设置 发送的uuid
| 设置指令 |
AT+BTXUUID= |
| 响应 |
+OK |
| 查询指令 |
AT+BTXUUID？ |
| 响应 |
+BTXUUID: |
| 参数 |
uuid : 服务发送的uuid |
AT+BEVENT
功能：设置/查询监听BLE事件
| 设置指令 |
AT+BEVENT= |
| 响应 |
+OK |
| 查询指令 |
AT+BEVENT？ |
| 参数 |
state : |
|
ON : 开启事件通知功能 |
|
OFF : 关闭事件通知功能 |
EVENT事件通知
根据不同的功能，EVENT 事件通知包括：
+BEVENT 起始的： 代表与 BLE 通信相关事件消息
| 序号 |
BLE 通知 |
BLE 通信状态 |
| 1 |
+BEVENT:CONNECTION,ON |
与主机连接成功 |
| 2 |
+BEVENT:CONNECTION,OFF |
与主机连接断开 |
| 3 |
+BEVENT: DATA , , |
接收主机透传数据 |
九、BT控制指令
BT控制指令仅支持 Wi-Fi/BT 模块: EMW3239。
本部分描述了实现 BT 模块的蓝牙通信及透传功能的全部 AT 指AT+BTNAME令。
| 序号 |
指令 |
功能 |
| 1 |
AT+BTNAME |
查询/设置经典蓝牙设备名称 |
| 2 |
AT+BTPASSKEY |
查询/设置经典蓝牙配对秘钥 |
| 3 |
AT+BTMAC |
查询经典蓝牙设备地址 |
| 4 |
AT+BTDISCOVERY |
开启/关闭蓝牙可发现可连接模式 |
| 5 |
AT+BTEVENT |
查询/设置监听蓝牙事件 |
| 6 |
AT+BTSTATE |
查询蓝牙状态 |
| 7 |
AT+BTSEND |
发送指定长度数据 |
| 8 |
AT+BTSENDRAW |
进入透传模式 |
AT+BTNAME
功能：查询/设置 经典蓝牙设备名称（BT处于可发现模式时显示的设备名称）。
| 查询指令： |
``AT+BTNAME=? |
| 响应： |
``+BTNAME: |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+BTNAME= |
| 响应： |
``OK |
| 参数： |
``name： BT处于可发现模式时的设备名称 |
| 说明： |
立即生效。 |
AT+BTPASSKEY
功能：查询/设置 经典蓝牙设备配对秘钥
| 查询指令： |
``AT+BTPASSKEY=? |
| 响应： |
``+BTPASSKEY: |
| 参数： |
请参考设置指令参数 |
| 执行指令： |
``AT+BTPASSKEY= |
| 响应： |
``OK |
| 参数： |
``passkey： BT设备配对秘钥（必须为6位数字） |
| 说明： |
立即生效 |
AT+BTMAC
功能：查询 经典蓝牙设备地址
| 查询指令： |
``AT+BTMAC=? |
| 响应： |
``+BTMAC: |
| 参数： |
mac：设备的MAC地址，格式为xx:xx:xx:xx:xx:xx |
| 说明： |
蓝牙地址不支持设置 |
AT+BTDISCOVERY
功能：开启/关闭 经典蓝牙可发现可连接模式
| 执行指令： |
``AT+BTDISCOVERY= |
| 响应： |
``OK |
| 参数： |
``：设备进入可发现可连接模式 |
|
``：设备不可被发现不可被连接 |
| 说明： |
立即生效 |
|
进入透传模式自动开启可发现可连接模式 |
AT+BTEVENT
功能：设置/查询 是否监听蓝牙事件（连接建立，连接断开等）
| 查询指令： |
``AT+BTEVENT? |
| 响应： |
``+BTEVENT: |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+BTEVENT= |
| 参数： |
``EN：使能监听蓝牙事件 |
|
``DN：禁止监听蓝牙事件 |
| 响应： |
``OK |
| 说明： |
立即生效，默认使能 |
|
当处于指令模式时并使能监听事件时，收到透传的数据将以``+BTEVENT:DATA事件发送到串口。 |
|
如果禁止监听事件，收到的数据直接透传到串口。（详细请阅读相应事件类型） |
AT+BTSTATE
功能：查询 当前蓝牙的工作状态
说明：蓝牙工作状态有：已连接，已断开， 可发现三个状态。
| 查询指令： |
``AT+BTSTATE? |
| 响应： |
``+BTSTATE: |
| 参数： |
``CONNECTED：RFCOMM连接已经建立 |
|
``DISCONNECTED：RFCOMM连接不存在或者已断开 |
|
``DISCOVERABLE：BT设备处于可发现模式 |
AT+BTSEND
功能： 指令模式时发送数据
| 执行指令： |
``AT+BTSEND= |
| 响应： |
``> |
| 参数： |
``length：将要发送的数据长度 |
| 说明： |
当用户收到``>响应时，应该立即将指定长度的数据通过串口发送。蓝牙设备将会接收并将这些数据透传到已连接的蓝牙主机 |
| 注意： |
设备内部在返回``>响应后，会在规定时间内等待用户数据。如果已经超时，那么设备将只发送已经收到的数据。超时时间一般为6s。 |
AT+BTSENDRAW
功能：进入BT透传模式
| 执行指令： |
``AT+BTSENDRAW |
| 响应： |
``OK |
| 说明： |
当设备进入透传模式后，如果此时没有建立RFCOMM连接，那么设备自动进入可发现可连接模式。 |
|
退出模式请输入``+++ |
十、以太网透传指令
| 序号 |
指令 |
功能 |
| 1 |
AT+ENETRAWMODE |
设置/查询 以太网透传模式状态 |
| 2 |
AT+ENETRAWSEND |
发送以太网数据 |
AT+ENETRAWMODE
功能：设置/查询 以太网透传模式状态
| 查询指令： |
``AT+ENETRAWMODE? |
| 响应： |
``+ENETRAWMODE: |
|
``OK |
| 参数： |
请参考设置指令参数 |
| 设置指令： |
``AT+ENETRAWMODE= |
| 响应： |
``OK |
| 参数： |
``mode：ON:开启； OFF：关闭； 开始以太网透传模式后，TCP/IP相关功能将失效 |
| 说明： |
立即生效。 |
AT+ENETRAWSEND
功能：发送以太网数据
| 指令： |
``AT+ENETRAWSEND= |
| 响应： |
``> 等待输入指定长度的date数据，1 分钟内输入有效。 |
| 参数： |
``data_length：数据长度。单位：byte字节。 |
| 说明： |
立即生效。 |
十一、固件OTA指令
注意： 所有型号的模块自 ATv2.0.3 版本后 AT 固件支持通过 AT指令实现在线 OTA 功能（注意：直连阿里ilop飞燕平台固件除外，其OTA功能实现请查看具体说明文档）。
AT+OTACHECK
功能：查询云端 AT 固件版本号。
| 查询指令： |
``AT+OTACHECK |
| 响应： |
``+OTACHECK: |
|
``+OK |
| 参数： |
``version：云端的所有 ota 固件的版本号。形如：fog_v3_AT_v2.0.4 。 |
| 说明： |
模块首先需要开启 STATION 模式，并成功连接至 AP，才能执行该指令。 |
| 注意： |
AT2.x固件，自 v2.0.3 开始支持远程联网 OTA 功能。 |
AT+OTASTART
功能：更新指定版本号的 AT 固件。
| 更新指令： |
``AT+OTASTART= |
| 响应： |
``+OK |
|
``+OTAEVENT:START 表示开始 OTA 过程。 |
|
``+OTAEVENT:SUCCESS 表示 OTA 成功。 |
| 参数： |
``version：云端的所有 ota 固件的版本号。形如：fog_v3_AT_v2.0.4 。 |
| 说明 |
用户可根据需要更新指定版本号的固件，可更新至低版本，也可更新至高版本。且 OTA 过程必须保证持续联网不断开，否则可能导致更新失败。 该过程大概持续 几秒到10秒左右。OTA 成功后，设备自动重启。 |
十二、电源管理指令
AT+WLPC
功能：查询/设置WiFi低功耗
| 查询指令： |
AT+WLPC=? |
|
41 54 2B 57 4C 50 43 3F 0D |
| 响应： |
+WLPC=<mode> |
|
``OK |
| 参数： |
mode：ON:表示已开启WiFi低功耗模式； OFF：表示未开启WiFi低功耗模式。 |
| 设置指令： |
AT+WLPC=<mode> |
| 响应： |
OK |
| 参数： |
mode：ON:表示开启WiFi低功耗模式； OFF：表示关闭WiFi低功耗模式。 |
| 说明： |
立即生效，状态掉电保存。 |
直连云AT指令
直连ILOP阿里飞燕云平台指令
特别提醒：本节指令仅适用于 支持直连 ilop 的 AT 固件 且 v2.3.0 版本及以上，固件版本号中含：ILOP.Axxx 字样的固件，否则不支持本节指令。该固件还支持的指令包括：基本AT指令、Uart管理指令、Wi-Fi管理指令。
v2.3.0以下版本AT指令说明，请参考：v2.3.0版本以下的 ilop AT 指令说明。
指令列表
以下指令仅适用于ilop AT固件。
| 序号 |
指令 |
描述 |
| 1 |
AT+ILOPSET |
设置/读取ilop参数 |
| 2 |
AT+ILOPDOMAIN |
设置ilop服务器站点 |
| 3 |
AT+ILOPAWSSTART |
启动awss路由配网模式 |
| 4 |
AT+ILOPAWSSTOP |
停止awss路由配网模式 |
| 5 |
AT+ILOPSTART |
启动ilop服务 |
| 6 |
AT+ILOPSTOP |
结束ilop服务 |
| 7 |
AT+ILOPSTATUS |
ilop服务状态 |
| 8 |
AT+ILOPSENDJSON |
上报透传/JSON协议数据 |
| 9 |
AT+ILOPSENDRAW |
上报透传/自定义协议数据 |
| 10 |
AT+ILOPRESET |
解绑设备 |
指令详细
AT+ILOPSET
功能：查询/设置 ilop 产品信息(可预先烧录)
| 查询指令 |
``AT+ILOPSET? |
| 响应 |
``+ILOPSET:,,, |
|
``OK |
| 设置指令 |
``AT+ILOPSET=,,, |
| 响应 |
``OK |
| 参数 |
``product_key：product key |
|
``product_secret：product secret |
|
``device_secret：device secret |
|
``device_name：device name |
| 说明 |
创建产品后，会自动生成 product_key 和 product secret。新增测试设备后，会生成device secret和device name。 |
AT+ILOPDOMAIN
功能：设置 ilop 服务器站点
| 查询指令 |
``AT+ILOPDOMAIN? |
| 响应 |
``+ILOPDOMAIN: |
|
``OK |
| 设置指令 |
``AT+ILOPDOMAIN= |
| 响应 |
``OK |
| 参数 |
mode:0, 上海站 |
|
mode:1, 新加坡站 |
|
mode:2, 日本站 |
|
mode:3, 美国站 |
|
mode:4, 德国站 |
| 说明 |
目前只支持 上海站 && 新加坡站,需要在启动ilop 服务之前设置 |
AT+ILOPAWSSTART
功能：启动awss路由配网模式
| 设置指令 |
``AT+ILOPAWSSTART |
| 响应 |
``OK |
AT+ILOPAWSSTOP
功能：停止awss路由配网模式
| 设置指令 |
``AT+ILOPAWSSTOP |
| 响应 |
``OK |
AT+ILOPSTART
功能：启动ilop服务
| 设置指令 |
``AT+ILOPSTART |
| 响应 |
``OK |
AT+ILOPSTOP
功能：关闭ilop服务
| 设置指令 |
``AT+ILOPSTOP |
| 响应 |
``OK |
AT+ILOPSTATUS
功能：ILOP服务状态查询
| 查询指令 |
``AT+ILOPSTATUS? |
| 响应 |
``+ILOPSTATUS: |
|
``NONE,未启动 |
|
``CONNECTED,ilop服务连接 |
|
``CONNECTING,ilop服务断开连接并尝试连接 |
AT+ILOPSENDJSON
功能: 上报透传/JSON协议数据
| 设置指令 |
``AT+ILOPSENDJSON=,[,] |
| 响应 |
> 等待输入指定长度的字符串，1s内输入有效。数据上报成功后，返回OK；否则，返回``ERROR |
| 参数 |
method:当为property, 属性时， ``event_id无效 |
|
method:当为event, 事件时，``event_id生效 |
|
``event_id： 事件ID |
|
``data_len：数据长度 |
AT+ILOPSENDRAW
功能: 上报透传/自定义协议数据
| 设置指令 |
``AT+ILOPSENDRAW= |
| 响应 |
> 等待输入指定长度的字符串，1s内输入有效。数据上报成功后，返回OK；否则，返回``ERROR |
AT+ILOPRESET
功能：设备端解绑
| 设置指令 |
``AT+ILOPRESET |
| 响应 |
``OK，现象： APP端 列表中设备消失。 |
直连GOME国美云平台指令
本节描述了： 使用庆科 WiFi 模块的智能设备直连 Gome 云服务器所需的所有 AT 指令。
特别提醒：本节指令仅适用于 支持直连 Gome 的 AT 固件，即固件版本号中含：GOME.Axxx 字样的固件，否则不支持本节指令。
指令列表
| 序号 |
指令 |
描述 |
| 1 |
AT+GOMESET |
设置国美云的产品身份参数 |
| 2 |
AT+GOMESETPROPERTY |
设置国美产品属性信息 |
| 2 |
AT+GOMECONFIGSTART |
启动国美智能一键配网 |
| 3 |
AT+GOMESTART |
启动国美云服务 |
| 4 |
AT+GOMESTOP |
停止国美云服务 |
| 5 |
AT+GOMESEND |
设备上报数据到国美云 |
| 6 |
AT+GOMESENDERRORCODE |
设备上报故障码到国美云 |
| 7 |
AT+GOMESTATUS |
查询与国美云连接状态 |
指令详细
AT+GOMESET
功能：设置国美云产品身份参数。
| 设置指令： |
``AT+GOMESET=, |
| 响应： |
``OK |
| 参数： |
``mode_id：产品 id，创建产品时，云端自动分配 |
|
``model_pin：产品 secret，创建产品时，云端自动分配 |
AT+GOMESETPROPERTY
功能：设置国美云产品属性信息。
| 设置指令： |
``AT+GOMESETPROPERTY=,,,,, |
| 响应： |
``OK |
| 参数： |
``property_num：产品属性number数量 |
|
``property_id1：产品属性id |
|
``property_type1：产品属性类型，0：表示字符串类型；1：表示数值类型。 |
AT+GOMECONFIGSTART
功能：启动国美智能一键配网。
| 设置指令： |
``AT+GOMECONFIGSTART |
| 响应： |
OK，配网成功，返回：+WEVENT:STATION_UP |
| 参数： |
无。 |
AT+GOMESTART
功能：启动国美云服务。
| 设置指令： |
``AT+GOMESTART |
| 响应： |
OK，连接云服务成功，返回：+GOMEEVENT:BOME,CONNECT |
| 参数： |
无。 |
AT+GOMESTOP
功能：停止国美云服务。
| 设置指令： |
``AT+GOMESTOP |
| 响应： |
``OK |
| 参数： |
无。 |
| 说明： |
重启有效。 |
AT+GOMESEND
功能：设备上报数据到国美云。
| 设置指令： |
``AT+GOMESEND=,,,,, |
| 响应： |
``OK，同时可在国美智能APP上看到上报数据。 |
| 参数： |
``property_num：产品属性number数量 |
|
``property_id n：产品属性id |
|
``property_value n：产品属性值。 |
AT+GOMESENDERRORCODE
功能：设备上报故障码到国美云。
| 设置指令： |
``AT+GOMESENDERRORCODE=,,, |
| 响应： |
``OK，同时可在国美智能APP上看到上报数据。 |
| 参数： |
``property_num：产品故障码数量，0：取消故障，此时不上传property_value。 |
|
``property_value n：产品故障码。 |
AT+GOMESTATUS
功能：查询国美云连接状态。
| 设置指令： |
``AT+GOMESTATUS? |
| 响应： |
``+GOMESTATUS:ONLINE:与服务器连接成功。 |
|
``+GOMESTATUS:IDLE:空闲模式，与服务器断开连接。 |
|
``+GOMESTATUS:LS_CONNECTING:登录服务器连接中。 |
|
``+GOMESTATUS:LS_CONNECTED:登录服务器已连接。 |
|
``+GOMESTATUS:CS_CONNECTING:连接服务器连接中。 |
|
``+GOMESTATUS:CS_CONNECTED:连接服务器已连接。 |
|
``OK |
EVENT事件通知
根据不同的功能，EVENT 事件通知包括：
- +WEVNET 起始的： 代表与 WiFi 功能相关的事件消息。
- +CIPEVENT 起始的： 代表与 网络连接 功能相关的事件消息。
- +MQTTEVENT起始的： 代表与 MQTT 通信相关的事件消息。
- +BTEVENT 起始的： 代表与 经典蓝牙透传相关的事件消息。
- +ENETEVENT起始的： 代表与 以太网 功能相关的时间消息。
- +OTA 起始的： 代表与 OTA 过程相关的事件消息。
- +ILOP 起始的： 代表与 ILOP 连接状态相关的事件消息。
- +GOME 起始的： 代表与 GOME 连接状态相关的事件消息。
| 序号 | 事件消息 | 描述 |
| —- | —- | —- |
| 一类 | WiFi 通知 | WiFi 状态 |
| 1 |
+WEVENT：AP_UP | Soft_AP 创建成功 |
| 2 |+WEVENT：AP_DOWN | Soft_AP 创建失败 |
| 3 | +WEVENT：STATION_UP | STATION 连接成功 |
| 4 |+WEVENT：STATION_DOWN | STATION 连接失败 |
| 二类 | 网络 通知 | 网络连接状态 |
| 1 | +CIPEVENT：id,SERVER,CONNECTED | 成功连接到指定 id 链接的 TCP 服务器 |
| 2 |+CIPEVENT：id,SERVER,DISCONNECTED | 与链接号为 id 的 TCP 服务器断开连接 |
| 3 | +CIPEVENT：id,SERVER,CLOSED | 成功停止指定 id 链接的 TCP 服务器 |
| 4 |+CIPEVENT：CLIENT,CONNECTED,ip,port | 成功连接到该 ip 地址和 port 端口的 TCP 客户端 |
| 5 | +CIPEVENT：CLIENT,CLOSED,ip,port | 成功停止该 ip 地址和 port 端口的 TCP 客户端 |
| 6 |+CIPEVENT：id,UDP,CONNECTED | UDP 连接成功 |
| 7 | +CIPEVENT：id,UDP,CLOSED | UDP 连接失败 |
| 8 |+CIPEVENT：SOCKET,id,len,data | 标识网络数据来源 |
| 9 | +CIPEVENT：UDP_BROADCAST,ip,port,id,len,data | UDP 广播数据来源及信息，从ATv2.0.3 版本开始支持。 |
| 三类 | **MQTT通知** | **MQTT通信状态** |
| 1 |+MQTTEVENT:CONNECT,SUCCESS | 与MQTT服务器连接成功 |
| 2 | +MQTTEVENT:CONNECT,INIT_ERROR | 与MQTT服务器连接初始化出错 |
| 3 |+MQTTEVENT:CONNECT,FAIL | 与MQTT服务器连接失败 |
| 4 | +MQTTEVENT:CONNECT,RECONNECTING | 与MQTT服务器重新连接中 |
| 5 |+MQTTEVENT:CLOSE,SUCCESS | MQTT通信关闭成功 |
| 6 | +MQTTEVENT:CLOSE,FAIL | MQTT通信关闭失败 |
| 7 |+MQTTEVENT:SUBSCRIBE,SUCCESS | MQTT订阅成功 |
| 8 | +MQTTEVENT:SBUSCRIBE,FAIL | MQTT订阅失败 |
| 9 |+MQTTEVENT:UNSUBSCRIBE,SUCCESS | MQTT取消订阅成功 |
| 10 | +MQTTEVENT:UNSUBSCRIBE,FAIL | MQTT取消订阅失败 |
| 11 |+MQTTEVENT:PUBLISH,SUCCESS | MQTT发布成功 |
| 12 | +MQTTEVENT:PUBLISH,FAIL | MQTT发布失败 |
| 四类 | **BT通知** | **BT通信状态** |
| 1 |+BTEVENT:CONNECTION,ON | 与RFCOMM远端主机连接成功 |
| 2 | +BTEVENT:CONNECTION,OFF | 与RFCOMM远端主机断开连接 |
| 3 |+BTEVENT:DATA,length | 收到RFCOMM远端主机透传的数据 |
| 五类 | 以太网透传通知 | 以太网透传事件 |
| 1 | +ENETEVENT：len,data | 标识以太网透传数据 |
| 六类 | **OTA通知** | **OTA状态** |
| 1 |+OTAEVENT:START | 开始 OTA 固件更新过程 |
| 2 | +OTAEVENT:SUCCESS | OTA 固件更新成功 |
| 七类 | **ILOP事件通知** | **ILOP连接状态** |
| 1 |+ILOPEVENT:ILOP, | 连接服务器状态。status：CONNECTED:服务器连接成功；CONNECTING:服务器断开连接并尝试连接； |
| 2 | +ILOPEVENT:GETJSON | APP请求设备属性，当MCU收到该通知后，应该上报设备的所有属性 |
| 3 |+ILOPEVENT:SETJSON,,, | 下发JSON格式数据 |
| 4 | +ILOPEVENT:SETRAW,<date_len>,<data> | 下发透传/自定义协议数据 |
| 八类 | **GOME事件通知** | **GOME连接状态** |
| 1 |+GOMEEVENT:GOME,CONNECTING | 服务器连接中 |
| 2 | ``+GOMEEVENT:GOME,CONNECTED | 服务器连接成功 |
