68
1 页共 68 AirM2M_ESP8266_WiFi 模块用户手册 V3.3 标准 AT 命令版本

AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

  • Upload
    others

  • View
    25

  • Download
    0

Embed Size (px)

Citation preview

Page 1: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

第 1 页 共 68 页

AirM2M_ESP8266_WiFi模块用户手册 V3.3标准 AT命令版本

Page 2: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 2 页 共 68 页

版本历史

版本号 修改者 修改内容

V1.0 Guowen 初始版本

V1.3 Guowen 修改了几个 AT命令,+CIPSERVER,+CIPSEND,+CIPSTO

增加了几个 AT命令,+IPD,+IPR,+CIPMODE,+CIPQSEND

V1.4 Guowen 增加了透传模式的应用举例

V1.5 Guowen 修改了 +CIPSTATUS这个命令的内容

补充了模块作为 AP和 server的应用举例

V1.6 Guowen 增加公司淘宝店,群,bbs,官网地址

硬件部分增加对 UART流控的描述

V1.7 Guowen 增加应用实例

修改对数据接收的描述

V2.2 Guowen 1)修改 4.1工具使用部分

2)AT命令

增加保存设置命令 AT+CIPSCON

增加查询MAC地址命令 AT+AMMAC

增加暂时退出透传模式命令 +++

修改查询模块 TCPUDP状态命令 AT+CIPSTATUS

补充 AT命令实例部分

V2.3 Guowen 增加如下 AT命令:

设置 TCP链接滑窗大小命令 AT+CIPWND

查询 AP信号强度的命令 AT+CAPR

开始 SMART LINK命令 AT+AMSL

V2.4 Guowen 增加 4.2. 同一局域网内对 AirM2M模块的搜索

修改 1.2.1对 PIN5 heartbeat的描述

增加如下 AT命令:

后台升级命令:AT+CIUPDATE

透传成帧发送命令:AT+CIPCCFG

休眠命令:AT+AMSLEEP

修改如下 AT命令:

串口波特率设置:AT+IPR

V2.5 Guowen 增加对串口配置参数取值范围的描述

增加+CIUPDATE的实例

增加 3.1 固件版本下载方法

增加对 Smartlink的描述

V2.6 Guowen 去掉对公司的宣传

V2.7 Guowen 修改+CWLAP命令为最新的格式

增加+OPENLOG功能

修改+CIPSTATUS C:的格式

修改+CIPSTO 单位为 1s,缺省值和取值范围也做了更改

V2.8 Guowen 增加对网页配置功能的描述

Page 3: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 3 页 共 68 页

V2.9 Guowen 修改 A6501的引脚描述的表格的内容和版式

更正 A6501S的引脚号的错误

+CIPWND窗口大小的最大值改为 1024

增加 ATE,+IFC,+CFGRI命令的描述

V3.0 Guowen 对 4.1和 4.4部分补充了部分内容

增加 ATE,+CFGRI,+CIPSTO,+OPENLOG命令的关机保存功能

增加+IFC,+OPENLOG,+CFGRI的查询和测试命令

+AMSL增加 2种新的方式

+CIPRCON分为异常断链重连和正异常断链都重连

V3.1 Guowen 增加了 UART0 用于生产测试的说明,建议客户预留 UART0 测试点

增加+CWJAP设置命令的错误返回情况

V3.2 Guowen 去掉 A6501S和 A6502的内容

V3.3 Guowen 增加+WEBCFG命令,用于网页配置的账户名和密码的修改

Page 4: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 4 页 共 68 页

目 录

术语和缩写...................................................................................................................................................61. 产品简介.......................................................................................................................................................7

1.1. 概述.......................................................................................................................................................71.1.1 产品特性.......................................................................................................................................71.1.2 模块封装.......................................................................................................................................81.1.3 模块基本参数...............................................................................................................................9

1.2. 硬件介绍.............................................................................................................................................101.2.1 A6501....................................................................................................................................... 10

1.3. 功耗.....................................................................................................................................................141.4. 射频指标.............................................................................................................................................151.5. 尺寸.....................................................................................................................................................161.6. WiFi 天线.......................................................................................................................................... 161.7. 推荐炉温曲线.....................................................................................................................................17

2. 功能描述.....................................................................................................................................................182.1. 主要功能.............................................................................................................................................182.2. 工作模式.............................................................................................................................................182.3. 应用领域.............................................................................................................................................182.4. AirM2M Cloud................................................................................................................................. 18

3. EVB介绍....................................................................................................................................................193.1. 固件下载方法.....................................................................................................................................20

4. 配置工具.....................................................................................................................................................244.1. PC配置工具...................................................................................................................................... 244.2. 同一局域网内对 AirM2M模块的搜索........................................................................................... 304.3. Smartlink功能................................................................................................................................ 304.4. 网页配置.............................................................................................................................................32

5. AT指令介绍...............................................................................................................................................365.1. 基础 AT指令......................................................................................................................................36

5.1.1 重启模块:AT+RST....................................................................................................................365.1.2 设置 TE-TA波特率:AT+IPR................................................................................................... 365.1.3 设置命令回显模式:ATE............................................................................................................ 375.1.4 休眠唤醒指令:AT+AMSLEEP.................................................................................................375.1.5 后台升级:AT+CIUPDATE....................................................................................................... 385.1.6 打开 Log开关:AT+OPENLOG...............................................................................................385.1.7 TE-TA 本地流量控制:AT+IFC................................................................................................395.1.8 唤醒对端MCU:AT+CFGRI.....................................................................................................395.1.9 查询固件版本:AT+VER............................................................................................................40

5.2. WiFi功能 AT指令............................................................................................................................ 405.2.1 选择WiFi应用模式:AT+CWMODE...................................................................................405.2.2 列出当前可用接入点:AT+CWLAP........................................................................................ 425.2.3 加入接入点:AT+CWJAP.........................................................................................................425.2.4 退出接入点:AT+CWQAP....................................................................................................... 43

Page 5: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 5 页 共 68 页

5.2.5 设置 AP模式下的参数:AT+CWSAP.................................................................................... 435.2.6 查询MAC地址:AT+AMMAC................................................................................................ 445.2.7 查询当前加入的 AP的信号强度:AT+CAPR........................................................................ 455.2.8 开始 SMART LINK: AT+AMSL............................................................................................45

5.3. TCPIP AT指令..................................................................................................................................485.3.1 建立 TCP/UDP连接:AT+CIPSTART................................................................................ 485.3.2 获得 TCP/UDP连接状态:AT+CIPSTATUS..................................................................... 495.3.3 启动多连接:AT+CIPMUX.................................................................................................... 515.3.4 发送数据:AT+CIPSEND......................................................................................................515.3.5 设置 TCP链接的窗口大小:AT+CIPWND......................................................................... 525.3.6 配置透传时成帧发送:AT+CIPCCFG.................................................................................. 535.3.7 关闭 TCP/UDP连接:AT+CIPCLOSE................................................................................545.3.8 获取本地 IP地址:AT+CIFSR..............................................................................................545.3.9 配置为服务器:AT+CIPSERVER.........................................................................................555.3.10 模块收到服务器数据:+IPD 和+RECEIVE.....................................................................565.3.11 选择数据发送模式:AT+CIPMODE...................................................................................575.3.12 设置 TCP断链后自动重连次数:AT+CIPRCON............................................................. 575.3.13 设置服务器主动断开的超时时间:AT+CIPSTO.............................................................. 585.3.14 保存透传设置:AT+CIPSCON........................................................................................... 595.3.15 选择非透传数据发送模式:AT+CIPQSEND.................................................................... 615.3.16 网页配置用户名和密码设置:AT+WEBCFG.................................................................... 625.3.17 退出透传模式:+++............................................................................................................ 625.3.18 应用举例.................................................................................................................................. 62

Page 6: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 6 页 共 68 页

术语和缩写

表格 1 术语和缩写

缩写 描述

WiFi Wireless Fidelity

AP Access Point

UART Universal Asynchronous Receiver & Transmitter

DTIM Delivery Traffic Indication Message

SOC System On a Chip

P2P Point to Point

TCP Transmission Control Protocol

IP Internet Protocol

IoT Internet of Things

MCU Microprogrammed Control Unit

IEEE Institute Of Electrical And Electronics Engineers

bps Bits Per Second

CCK Corporate Control Key

QAM Quadrature Amplitude Modulation

OFDM Orthogonal Frequency Division Multiplexing

WPA Wi-Fi Protected Access

TKIP Temporal Key Integrity Protocol

WAPI Wlan Authentication And Privacy Infrastructure

WEP Wired Equivalent Privacy

GPIO General Purpose Input/Output

IIC Inter-Integrated Circuit

PWM Pulse-Width Modulation

ADC Analog-to-Digital Converter

URC Unsolicited Result Code

Page 7: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 7 页 共 68 页

1.产品简介

1.1. 概述

上海合宙通信科技有限公司(AirM2M)旗下目前已推出三款ESP8266 WiFi模块:A6501、A6501S和A6502,未来会持续增加种类,以满足广大企业用户和个人开发者对封装尺寸的不同需求。

A6501系列WiFi透传模块,拥有业内极富竞争力的封装尺寸和超低能耗技术,专为移动设备和物联

网应用设计,可将用户的物理设备连接到WiFi无线网络上,进行互联网或局域网通信,实现联网功能。

A6501系列WiFi透传模块封装方式多样,部分型号的天线更可支持板载PCB天线,IPEX接口和邮票

孔接口三种形式;

A6501系列WiFi透传模块可广泛应用于智能电网、智能交通、智能家具、手持设备、工业控制等领域。

更多资料,请访问合宙开源社区: http://www.luam2m.com/

1.1.1 产品特性

支持无线802.11 b/g/n 标准

支持STA/AP/STA+AP 三种工作模式

内置TCP/IP/HTTP协议栈,支持多路TCP Client连接

支持丰富的Socket AT指令

内置32位MCU,可兼作应用处理器

支持UART/GPIO数据通信接口

支持PWM输出

支持I2C接口

支持WiFi配置参数

支持Smart Link 智能联网功能

支持远程固件升级(OTA) 3.3V 单电源供电

支持Active、Modem sleep、Light sleep、Deep sleep多种功耗模式

超低能耗,适合电池供电应用

ESP8266软件稳定性业界领先

Page 8: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 8 页 共 68 页

1.1.2 模块封装

AirM2M ESP8266 A6501系列WiFi透传模块支持多种封装形式,极大的丰富了用户的选择,方便应

用于各种物联网硬件终端场合。

A6501

图 1 A6501封装形式 俯视图和仰视图

Page 9: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 9 页 共 68 页

1.1.3 模块基本参数

表格 2 模块技术规格

A6501 主芯片 ESP8266

无线参数

无线标准 IEEE 802.11b/g/n

频率范围 2.412GHz-2.484GHz

发射功率

802.11b: +18.5 +/-1dBm (@11Mbps)

802.11g: +16 +/-1dBm (@54Mbps)

802.11n: +15 +/-1dBm (@HT20, MCS7)

接收灵敏度

802.11b: -91 dBm (@11Mbps ,CCK)

802.11g: -75dBm (@54Mbps, OFDM)

802.11n: -71dBm (@HT20, MCS7)

天线形式外置:邮票孔接口 或 I-PEX 连接器

内置:板载PCB 天线

硬件参数

硬件接口 UART,IIC,PWM,GPIO,ADC

工作电压 3.0V~3.6V(VDD电压)

GPIO驱动能力 Max:15ma

工作电流

Active State,正常模式:平均值:~70mA,峰值: 215mA;

Modem Sleep,关闭Modem,CPU工作:平均值: ~15mA;

Light Sleep,关闭Modem和CPU,中断可唤醒:0.9mA;

Deep Sleep,关闭Modem和CPU,中断不可唤醒:<15uA;

工作温度 -40℃~125℃

存储环境 温度:<40℃,相对湿度:<90%R.H.

尺寸

A6501:板载 PCB天线:16*24*3.3mm;外置天线:16*18.6*3.3mm;

A6501S:板载 PCB天线:16*32*3.3mm;外置天线:16*24.6*3.3mm;

A6502:板载PCB天线:11.8*24*3mm;

串口透传传输速率 9600-921600bps

TCP Client 4个

软件参数

无线网络类型 STA/AP/STA+AP

安全机制 WEP/WPA-PSK/WPA2-PSK

加密类型 WEP64/WEP128/TKIP/AES

固件升级 本地串口,OTA远程升级

网络协议 IPv4, TCP/UDP/HTTP

用户配置

AT+指令集

Web 页面+PC配置工具

Android/iOS 终端 Smart Link 智能配置APP

Page 10: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 10 页 共 68 页

1.2. 硬件介绍

A6501系列模块使用 ESP8266 SOC处理器,硬件接口丰富,可支持 UART,IIC,PWM,GPIO,ADC等,可广泛适用于各种物联网应用场合。

1.2.1 A6501

图 2 A6501管脚排列图

Page 11: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 11 页 共 68 页

PIN Function Description

1 U1CTS

1) UART_CTS(正常工作状态下)

2) GPIO3(开发者可在SDK版本中设置)

3) 固件下载时,用作U0RXD(上电前MODE处下拉状态,则上电后模块进入下载状态)

2 U1RTS

1) UART_RTS(正常工作状态下)

2) GPIO1(开发者可在SDK版本中设置)

3) 固件下载时,用作U0TXD(上电前MODE处下拉状态,则上电后模块进入下载状态)

注:开机上电时必须保持悬空(内部上拉),禁止下拉

3 U1RI1) UART_RI,低电平唤醒对端MCU

2) GPIO5(开发者可在SDK版本中设置)

4 U1DTR1) UART_DTR,低电平唤醒A6501

2) GPIO14(开发者可在SDK版本中设置)

5 HeartBeat

1) Deep Sleep模式:心跳信号,需将该PIN与RESET短接才能唤醒模块

2) GPIO16(开发者可在SDK版本中设置)

3) 开机上电时默认输出高电平

6 RESET1) 非Deep Sleep模式:外部Reset信号,低电平有效

2) Deep Sleep 模式:RESET与HeartBeat短接才能在此模式下唤醒模块

7 GND GND

8 ENABLE1) 模块使能脚,内部10K电阻上拉,默认上电开机

2) 低电平关机,功耗电流小于5uA

9 VDD 3.3V,模块供电

10 ANT WiFi Antenna

11 GND GND

12 MODE

1) Red LED:默认WiFi工作状态指示灯控制信号

2) GPIO0(开发者可在SDK版本中设置)

3) 模式选择:

悬空:Flash Boot,正常工作模式

下拉:UART Download,串口下载模式。若模块上电时此引脚处下拉状态,则模块上电后进

入下载

13 ADC ADC,输入范围:0V-1V

14 U1RXD1) UART_RXD,接收数据

2) GPIO13(开发者可在SDK版本中设置)

15 U1TXD

1) UART_TXD,发送数据

2) GPIO15(开发者可在SDK版本中设置)

注:模块内部10K电阻下拉,开机时禁止硬件上拉

16 nReload

1) 功能按键(“按”指的是下拉)

按键一次:进入Smartlink

按键两次:远程升级固件

长按:恢复出厂设置

2) Debug_TXD,用于输出调试log

输入AT+OPENLOG后,nReload打印log,上述按键功能失效。重启模块后恢复按键功能。

3) GPIO2(开发者可在SDK版本中设置)

注:开机上电时必须为高电平,禁止硬件下拉

Page 12: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 12 页 共 68 页

表格 3 A6501 Pin脚定义

备注:

1)A6501有 3个串口,其中:

UART1(U1RXD、U1TXD、U1CTS、U1RTS、U1DTR、U1RI)为数据串口;

UART0(U0RXD、U0TXD)为下载串口,更新固件使用;

UART0(U0RXD、U0TXD)在生产时可以用来下载配置参数,读取 MAC 地址,建议预留生产测试点;

Debug_UART(Debug_TXD)为调试串口,可输出调试 log;

UART0用红色字体表示,Debug_UART用紫罗兰色标出(debug口只有 TXD)。

2)A6501管脚多为Multi-functional复用关系,使用时一定要注意相应管脚在上电开机时对初始化电平

的要求,以免造成模块不能正常开机或状态不稳定的现象;

上电开机时有初始化电平要求的管脚已用蓝色标出;

以上电进入正常工作模式并使用 AT命令为例:

step1:模块处于下电状态

step2:MODE悬空,AT口(即数据串口,PIN14,PIN15)和MCU连接

step3:模块固件缺省为无流控模式,可以用 AT+IFC命令设置支持硬件流控。

硬件流控模式下,如果客户需要流控,则 PIN1和 PIN2和 MCU接;如果不需要流控,则 PIN1和 PIN2短接。

无流控模式下,PIN1、PIN2悬空。

step4:上电(注意:开机时禁止下拉 PIN2和 PIN16,禁止上拉 PIN15)step5:输入 AT命令(模块 AT口缺省波特率是 921600,慢于这个速率的波特率都可以通过输入几个

AT命令的方式训练过来,详见:5.1.2 设置 TE-TA波特率:AT+IPR)

3)“MODE”信号用于模块模式选择,更新固件前需要将“MODE”与“GND”短接;

4)PIN12,PIN18两个管脚推荐默认功能使用,已用粉红色标出;

5)“Red LED”和“Blue LED”状态说明如下:

Red LED:TCP/UDP连接指示灯,连接成功后闪烁,断开连接后熄灭;

Blue LED:(1)开机常亮 2S,然后关闭;

(2)TCP/UDP数据传输状态指示灯,传输过程中闪烁,传输完成后熄灭;

6)A6501完全不受限制(没有初始化电平要求、没有默认功能或者默认功能可方便修改)使用的 GPIO管脚有 3个,已用绿色标出,推荐优先使用;

7)新版 A6501_A11相对 A6501_A10的区别如下:

17 GPIO4 GPIO4(开发者可在SDK版本中设置)

18 GPIO121) Blue LED:默认TCP/UD数据传输状态指示灯;

2) GPIO12(开发者可在SDK版本中设置)

Page 13: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 13 页 共 68 页

(1)模块改为默认上电开机,关机时将“ENABLE”下拉即可;

(2)将 GPIO12与 GPIO5(U0RI)管脚位置互换,GPIO5定义为 U0RI信号;

(3)优化管脚命名,如将“DEFAULT”更新为“nReload”;(4)重新定义了 UART0、UART1和 Debug_UART。

8)PIN16 (nReload) 的按键功能(按键一次/两次/长按)从 AirM2M_ESP8266_V0009_A6501开始

支持,此前版本不支持。

log输出功能需要 AT命令来打开,也是从 0009版本开始支持,此前版本是直接就可以打印 log。

特别提醒:

在上海合宙 ESP8266 WiFi模块《SW_V0003_A6501_WEB》软件版本之后,固件升级

串口和数据串口将不再使用同一物理管脚,切记!

Page 14: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 14 页 共 68 页

1.3. 功耗

下列功耗数据是基于3.3V的电源、25°的环境温度下测得。

[1] 所有测量均在天线接口处完成。

[2] 所有发射数据是基于 90% 的占空比,在持续发射的模式下测得的。

模式 最小值 通常 最大值 单位

传送 802.11b,CCK 1Mbps,Pout=+19.5dBm 215 mA

传送 802.11b,CCK 11Mbps,Pout=+18.5dBm 197 mA

传送 802.11g,OFDM54 Mbps,Pout=+16dBm 145 mA

传送 802.11n,MCS7,Pout=+14dBm 135 mA

接收 802.11b,包长 1024字节,-80dBm 60 mA

接收 802.11g,包长 1024字节,-70dBm 60 mA

接收 802.11n,包长 1024字节,-65dBm 62 mA

系统待机模式 0.9 mA

深度睡眠 10 μA

节能模式 DTIM1 1.2 mA

节能模式 DTIM3 0.86 mA

关机 0.5 μA

表格 5 功耗数据

Page 15: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 15 页 共 68 页

1.4. 射频指标

以下数据是在室内温度下,电压为 3.3V时测得。

描述 最小值 通常 最大值 单位

输入频率 2412 2484 MHz

输入电阻 50 Ω

输入反射 -10 dB

72.2Mbps下,PA的输出功率 14 15 16 dBm

802.11b模式下,PA的输出功率 17.5 18.5 19.5 dBm

灵敏度

CCK 1Mbps -98 dBm

CCK 11Mbps -91 dBm

6Mbps(1/2BPSK) -93 dBm

54Mbps(3/4 64-QAM) -75 dBm

HT20,MCS7(65Mbps,72.2Mbps) -71 dBm

邻频抑制

OFDM,6Mbps 37 dB

OFDM,54Mbps 21 dB

HT20,MCS0 37 dB

HT20,MCS7 20 dB

表格 6 射频指标

注:

1)72.2Mbps是在802.11n模式下,MCS=7,GI=200uS时测得;

2)802.11b模式下最高可达+19.5dBm的输出功率;

Page 16: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 16 页 共 68 页

1.5. 尺寸

A6501

图 5 A6501模块封装图

1.6. WiFi 天线

A6501系列模块支持三种天线接口形式:板载 PCB天线、IPEX接口和邮票孔接口,板载 PCB天线

和 IPEX接口天线客户可直接使用,无需添加任何匹配电路。如果客户需要在大板上设计天线部分,可使

用 A6501邮票孔天线接口,这种设计时大板需要预留匹配电路,如下:

图 6 WiFi射频参考电路图

Page 17: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 17 页 共 68 页

注:1、以上虚线框的部分需要进行天线匹配,以实际天线匹配的电子元器件参数为准;

2、以上为 RF走线要做 50欧姆阻抗,禁止 90度直角走线,长度不能超过 15mm;

1.7. 推荐炉温曲线

Refer to IPC/JEDEC standard;Peak Temperature : <250°C;Number of Times: ≤2 times;

图 7 推荐回流曲线图

Page 18: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 18 页 共 68 页

2.功能描述

2.1. 主要功能

A6501系列WiFi模块可以实现的主要功能包括:串口透传,PWM 调控,GPIO控制。

串口透传:数据传输,可靠性好、稳定性高,在串口速率 115200kbps下可达 11KByte;PWM 调控:灯光调节,三色 LED 调节,电机调速等。

GPIO控制:控制开关,继电器等。

2.2. 工作模式

A6501模块支持 STA/AP/STA+AP 三种工作模式。

STA 模式:A6501模块通过路由器连接互联网,手机或电脑通过互联网实现对设备的远程控制。

AP 模式:A6501模块作为热点,实现手机或电脑直接与模块通信,实现局域网无线控制。

STA+AP 模式:两种模式的共存模式,即可以通过互联网控制可实现无缝切换,方便操作。

2.3. 应用领域

串口 RS232 转Wi-Fi; 工业透传 DTU; Wi-Fi 远程监控/控制;

玩具领域;

色 LED 控制;

消防、安防智能一体化管理;

智能卡终端,无线 POS 机,Wi-Fi 摄像头,手持设备等。

2.4. AirM2M Cloud

AirM2M Cloud为上海合宙(AirM2M)推出的互联网云平台服务。用户可以在平台上对设备进行监

控和管理,实现大数据管理和分析,使设备真正实现智能化。

AirM2M Cloud可接受客户的定制化需求,Web 页面配置,Android/iOS 平台 App均可支持。

Page 19: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 19 页 共 68 页

3.EVB介绍

AirM2M可提供专门的 UART_WiFi_EVB开发板供客户研发测试 A6501使用,通过该开发板,传统

的串口设备或MCU设备可以方便的接入WiFi网络,通过网络实现对设备的管理与控制。

该开发板可提供 UART串口数据传输解决方案、RGB灯光调节、智能插座等硬件演示方案,同时,

开发板已预留我司 GSM/GPRS标准模块 A2350做主控 MCU与 A6501串口数据传输的硬件电路,既可

支持 GSM/GPRS远距离传输,也可支持近距离WiFi通信;

图 8 EVB板正面视图

Notice:由于本 EVB利用模块的外围管脚兼容设计了不同的应用,故需要通过跳线帽或按键来选择和区分;

1)“下载”按键:下载时需在上电前按住此按键,直至下载开始后松开;

Page 20: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 20 页 共 68 页

2)“开机”跳线:导通时,开机;断开时,关机;

3)“复位”按键:恢复出厂默认设置:AP模式;

4)“重启”按键:模块硬件重启,软件配置参数不变;

3.1. 固件下载方法

下载步骤如下:

1) 升级模块固件版本前,请将模块处于下电状态

2) 模块版本升级是采用下载 UART口(PIN1是下载口 U0RXD,PIN2是下载口 U0TXD),所以在下载

之前请将模块下载 UART口与 PC 相连。如果客户是用我司的 A6501系列 EVB板,则串口线接法如下:

3) 运行下载工具

下载工具无需安装,直接单击 exe文件运行即可

以 1.0.7 版本为例,双击下面的文件:

Page 21: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 21 页 共 68 页

打开工具后,选择对应的 UART口端口号

4) 单击第三个工具按钮:Setup 工具钮

Page 22: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 22 页 共 68 页

5) 选择波特率,并在 download setup这里把固件版本目录中的_cfg.lua文件选进来

然后按 OK 键确认。

6) 点击下载按钮,然后将 PIN 12(MODE) 拉低,并给模块上电,待进入下载状态后再悬空

如果用户是采用我司 A6501 系列 EVB板进行下载,则操作步骤是:

点击下载按钮-> 按住 EVB板上的下载按钮(MODE拉低)->给模块上电->待进入下载过程再松开下载按

钮。

Page 23: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 23 页 共 68 页

7) 下载完毕后,会显示 FINISHED,此时表示下载已经完成了。

Page 24: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 24 页 共 68 页

4.配置工具

4.1. PC配置工具

A6501支持通过 PC工具:AirM2M_ESP8266_CONFIG_TOOL配置相关参数,方便易用。

这里有个应用场景:多链接透传模式(模块工作模式:STA+CLIENT),需要连接的服务器地址为

192.168.4.101,端口号为:8800。建立 2个链接,一个链接是 TCP,本地端口是 1818;另一个链接是 TCP,本地端口是 2020.以此为例,介绍配置步骤:

第一步,A6501无线模块处于上电工作状态,并处于 AP或 AP+STATION模式(缺省就是 AP+STATION模式)。模块要工作在 AP或 AP+STA模式下才可以使用该配置工具。

第二步,打开 AirM2M_WiFi_Tool 配置工具。若被安全软件拦截,请添加信任。

第三步,使模块和电脑处于同一个局域网中。有两种方法:

a) 打开电脑WIFI功能,找到模块(AirM2M WiFi设备 SSID皆以“AirM2M_MAC”的形式来命名,如:

AirM2M_9EABE4),点击连接直连模块;

b) 电脑和模块加入到同一个路由器。可以通过 SMART config 或者 AT+CWJAP命令或配置工具来实现。

→ SMART CONFIG功能请详见本文档:开始 SMART LINK: AT+AMSL→ AT+CWJAP 命令请详见:加入接入点:AT+CWJAP

Page 25: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 25 页 共 68 页

→WIFI config Tool,点击 AT+CWJAP=<sta_param>:

第四步,打开Web Control。点击“SEARCH”,在左侧的显示栏中显示搜索到的模块。若未搜索到模块,

可重复点击“SEARCH”

注:模块和电脑处于同一局域网是 SEARCH和配置功能的前提。SEARCH功能的具体介绍请详见:

同一局域网内对 AirM2M模块的搜索

第五步, “BASE”选项卡中点击“READ”,读取 AirM2M WiFi设备当前的基本信息。

在这选项页,可以设置工作模式,以及 AP模式和 STATION模式下的 IP地址。

设置模块的WIFI层工作模式为 STA模式。

然后配置下图中绿色框部分。

AP部分(下图红色框内)可以设置如下参数(STA模式下,该参数不用配置):SSID,密码,模块 IP地址,子网掩码,网关等。

STA部分(下图绿色框内)可以设置如下参数(AP模式下,该参数不用配置):所要连接的热点信息(ssid,密码),模块 IP地址,子网掩码,网关等。

配置完后,点击“SET”。

注:

1)如果改变了工作模式或 ip地址信息,请在所有配置完成后重启下模块以使配置生效。

2)如果修改了模块 AP下的 ip地址,重启模块后,需要重新搜索并选中模块。否则工具无法使用,因为

工具软件缺省连接的模块 ip地址为 192.168.4.1。

Page 26: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 26 页 共 68 页

第六步,点击“设置 TCPUDP客户端”选项页,配置链接。最多同时支持 4个链接。

每个连接配置四个参数-》Local_port:本地端口

Port:服务器端口

Protocol:TCP 还是 UDPIp:服务器 IP地址

需要几个链接就配置几个,这里以 2个为例,然后点击”POST”

Page 27: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 27 页 共 68 页

注:如果想单链接透传,只需要在这一步配置一个链接就好了。其余的删空。

第七步,点击“设置透传模式”选项页,配置透传模式

Data_mode = 1 ,透传模式

Data_mode = 0 ,非透传模式,即 AT命令模式

这里设置 data_mode=1,然后 POST

<recon_times>重连次数,<recon_status>重连方式,请参考本文档:

设置 TCP断链后自动重连次数:AT+CIPRCON命令。

Page 28: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 28 页 共 68 页

第八步,服务器那边启动,并正常工作。

第九步,重启模块。重启后模块就进入透传状态,从服务器那边看,会有两个链接建立起来。

第十步,打开 AT 选项页,打开端口,在左下角的任意内容输入框输入数据并发送。从服务器观察,会发

现 2个链接都收到了数据”qqqqq”。

Page 29: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 29 页 共 68 页

第十一步,退出透传模式,返回到 AT命令模式。

点击“设置透传模式”选项页,设置 data_mode=0,POST下,重启模块即可。

注:

在透传模式下,有 3种方式退出透传:

1)+++ 退出透传,此时可以输入 AT命令。输入 AT+CIPMODE=1 和 AT+CIPSEND后回到透传模式;直接重

启模块后也回到透传模式;

2)+++,然后 AT+CIPSCON=0,重启模块后进入正常模式,而且不会建立任何连接;

如果想保存连接,只是退出透传模式,则+++后,AT+CIPMODE=0,AT+CIPSCON=1,然后重启模块。

3)在 AirM2M_ESP8266_CONFIG_TOOL ->WEB CONTROL->设置透传模式(set_data_mode) 选项页,

设置 data_mode为 0,然后 POST,重启模块后建立非透传模式连接(按照上次设置的连接参数)。如果连接也想

清除或修改,则需要在重启前也一起设置 CLIENT或 SERVER。

进入透传模式有 2种方法:

1)AT+CIPMODE=1,AT+CIPSERVER配置服务器或 AT+CIPSTART配置客户端,AT+CIPSCON=1,重启模

块后,进入透传,并自动按照最后一次 AT+CIPSCON=1保存的参数建立链接;

2)在 AirM2M_ESP8266_CONFIG_TOOL->WEB CONTROL->设置透传模式(set_data_mode)选项页,设

置 data_mode为 1,然后 POST,在配置 TCPUDP客户端/服务器 选项页配置 CLIENT/SERVER,然后 POST,重启模块后,进入透传,并自动按照配置建立链接。

Page 30: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 30 页 共 68 页

4.2. 同一局域网内对 AirM2M模块的搜索

在实际的WIFI模块应用中,比如智能家居,会经常遇到这种应用:手机 APP或网页找到同一家用路由器

下的所有WIFI模块,并进行控制。这个搜索模块的功能,是通过下面的方式实现的。

具体如下:

通过 udp广播实现设备查找

APP需要搜索的 IP地址:255.255.255.255APP需要搜索的端口:1025APP发出的探测数据包: Are You AirM2M IOT Smart Device?WIFI模块回应的数据包: I'm xxx. MAC地址 IP地址

注:xxx是模块固件版本号。

下图是一个具体实例:

注:我司的WIFI CONFIG TOOL 的搜索功能也是通过这个方式实现的。

4.3. Smartlink功能

模块在使用的过程,需要连接热点。但是由于模块没有接口,没有键盘屏幕,如何让模块连接入用户

Page 31: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 31 页 共 68 页

所指定的热点,成为了一个让人头疼的问题。

有没有简便的方法?答案是 smartconfig 或者 smartlink。 两种说法不同,其实方法一致。是 TI发明的一个方法。 原理如下(前提是手机和模块要离的比较近):

1. 手机 APP连上一个路由器,比如路由器 A;2. 假如希望模块连接路由器 B,在 APP中输入 B的 SSID和密码,点击 APP 的一个按钮,这个 APP向

路由器 A发送一些广播包,这个包里面在某些位置包含了 B的 ssid和密码,这个位置和存放方式模块是

知道的,因为 APP和模块都是一个厂家开发的;

3. 触发模块进入 Smartlink过程(触发方式下面有描述),去抓取广播包,解析出路由器 B的 ssid和密

码,然后去连接路由器 B。注:路由器 A和路由器 B可以是同一个路由器。

上述的过程,手机没有和WIFI模块进行直接的通信,就把密码告诉了模块。

我司的WIFI配置工具可以配置 Smartlink,打开Web Control->设置 smartlink:

smartlink.timeout 的单位是秒,表示 smartlink过程(即上述抓取广播包,解析出路由器 B的 ssid和

密码,然后去连接路由器 B)的超时时间。POST后,重启模块,模块会不停自动重复这个过程,直到成

功加入热点。

这个变量的缺省值是 0,表示不会自动启动 smartlink。

Page 32: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 32 页 共 68 页

那么如何启动 smartlink功能?如果模块固件是标准 AT版本:

可以通过输入 AT+AMSL=1这个命令来开始一次 smartlink过程,输入一次命令,就启动一次 smartlink过程。

或者拉低一次 nReload(PIN16),效果等同于输入 AT+AMSL=1。从 V009版本(含)以后开始支持该

功能。

或将 smartlink.timeout 设置为非 0值。

如果模块固件是 SDK版本:直接调用 airm2m_smartlink_start 这个 API就可以启动一次 smartlink过程。

4.4. 网页配置

我司模块可以用浏览器进行网页配置,实现的功能跟我司的配置工具中的WEB CONTROL是一样的,而

且使用的协议也都是 HTTP协议。

方法如下:

电脑 WIFI 连接模块这个热点,然后在浏览器地址栏输入模块的 AP的 IP地址。缺省是:

http://192.168.4.1用户名和密码都是:admin

登录以后,就可以对模块进行各种配置。

应用场景 1:A6501模块作为 STA+CLIENT,单链接透传。

step1:设置透传。打开透传选项,并配置重连次数和重连方式。

透传设置中,重连次数请参照 AT+CIPRCON命令的<recon_times>参数;重连方式请参照该命令的

<recon_status>参数。

Page 33: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 33 页 共 68 页

step2:配置模块作为 CLIENT所需要链接的服务器地址,端口(6600),以及本地端口(1233)。

需要几个链接,就配置几个链接(最多 4个)。不需要的,使用缺省值。

step3:重启模块,模块就自动建立链接并进入透传模式。

Page 34: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 34 页 共 68 页

应用场景 2:A6501模块作为 AP+SERVER,多链接透传。

step1:设置透传。打开透传选项就好了。其余两个参数是模块作为 CLIENT时需要配置的。模块作为 AP时,不受<recon_times>和<recon_status>控制。

step2:设置 SERVER。建立了两个 port(9788,9999),并且都是永不主动断链(timeout=0)。本操

作步骤功能与 AT+CIPSTO相同,具体请参考:设置服务器主动断开的超时时间:AT+CIPSTO

step3:重启模块,模块就进入透传状态,并监听 9788,9999两个端口。在客户端建立四个链接。通过

串口给模块发数据,这个四个链接同时都能收到。

Page 35: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 35 页 共 68 页

应用场景 3:网页升级

A6501目前支持网页升级,页面会提示当前需使用哪个 bin文件来升级,user1.bin还是 user2.bin。user1.bin和 user2.bin是交替轮换使用的。user1.bin和 user2.bin都放在版本发布包里。

Page 36: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 36 页 共 68 页

5. AT指令介绍

5.1. 基础 AT指令

5.1.1 重启模块:AT+RST

语法规则:

命令类型 语法 返回

执行命令 AT+RST OK

注意事项模块开机后,初始化完毕会打印 ready

如果模块处于透传模式,则开机没有任何打印

5.1.2 设置 TE-TA波特率:AT+IPR

语法规则:

命令类型 语法 返回

设置命令 AT+IPR=<rate> OK

查询命令 AT+IPR?

+IPR: <rate>

OK

测试命令 AT+IPR=?

+IPR: (<rate>取值列表)

OK

注意事项

模块目前缺省就支持自适应波特率。有几个方面需要注意:

1)<rate>适应范围:

BIT_RATE_9600

BIT_RATE_19200

BIT_RATE_38400

BIT_RATE_57600

BIT_RATE_74880

BIT_RATE_115200

BIT_RATE_230400

BIT_RATE_256000

BIT_RATE_460800

BIT_RATE_921600

2)缺省波特率是921600

3)只能适应比当前波特率小的波特率

4)模块第一次开机需要发送几次AT命令才能适应

5)适应好以后重启模块能记录上次自适应的波特率

6)自适应只发生在对方的波特率和当前模块波特率不相同的情况下

Page 37: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 37 页 共 68 页

7)串口支持数据位:5,6,7,8

支持校验位:0-none 1-odd 2-even

支持停止位:1 - 1位 2- 1.5位 3-2位

流控:0-none 1-hw control

举例:模块上设置的波特率为115200,模块只能适应比115200 小的波特率,有9600、19200、38400、

57600、74880。

5.1.3 设置命令回显模式:ATE

执行命令设置 TA 在命令模式下,是否可以回显从 TE 接收到的字符。

语法规则:

命令类型 语法 返回 说明

执行命令 ATE<value>

OK 正常返回

+CME ERROR:The function is already opened 重复输入ATE1

+CME ERROR:The function is already closed 重复输入ATE0

参数定义:

参数 定义 取值 对取值的说明

<value> 是否回显。该参数关机保存。0 回显关闭

1 回显打开

5.1.4 休眠唤醒指令:AT+AMSLEEP

语法规则:

命令类型 语法 返回

设置命令 AT+AMSLEEP=<mode>,<sleep_time> OK

查询命令 AT+AMSLEEP?

+AMSLEEP:<mode>, <sleep_time>

OK

测试命令 AT+AMSLEEP=?

+AMSLEEP:<mode>取值范围,

<sleep_time>取值范围

OK

参数定义:

参数 定义 取值 对取值的说明

<mode> 休眠模式 2 目前只支持2: deep sleep模式

<sleep_time> 休眠时间0~4294

单位:秒 ,休眠时间到,模块自己唤醒

前提条件:PIN5(HEARTBEAT) 跟RESET 短接,才能唤醒模块。

Page 38: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 38 页 共 68 页

举例:

命令(→)

/返回(←)

实例 解释和说明

前提条件:PIN5(HEARTBEAT) 跟RESET 短接

→AT+AMSLEEP=2,300

每输入一次命令,可以让模块休眠一次,设置的休眠时

间(这里是300秒)到时后,模块会自己醒来。

← OK

5.1.5 后台升级:AT+CIUPDATE

语法规则:

命令类型 语法 返回 说明

执行命令 AT+CIUPDATE OK 升级成功后模块会自动重启,运行新的固件版本

举例:

命令(→)

/返回(←)

实例 解释和说明

1)正常升级的情形

AT+CIUPDATE

开始升级

注:升级的必要条件是模块要连接上可上外网的路

由器

← +CIUPDATE: CONNECT OK

+CIUPDATE: A6501,V0008

+CIUPDATE: START UPGRADE

OK

模块自动连接我司升级服务器

A6501是模块型号,V0008是升级后的版本

2)版本已经是最新,无需升级的情形

→ AT+CIUPDATE

← +CIPUPDATE: CONNECT OK

+CIPUPDATE: NO NEW VERSION AVAILABLE

ERROR

模块内部版本已经是最新

5.1.6 打开 Log开关:AT+OPENLOG

标准AT版本的固件从0009开始支持nReload(PIN16)按键功能,按键功能定义如下:

短按(注1)一次:触发合宙smartlink即AirConfig过程(注3)。功能相当于AT+AMSL=1

短按两次:远程升级固件

长按(注2): 恢复出厂设置

Page 39: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 39 页 共 68 页

注:

1)按是指的拉低PIN16

2)长按指的是3秒以上,短按是3秒以下

3)触发 Smartlink过程的前提条件是,模块尚未建立数据连接。

4)输入 AT+OPENLOG=1后,nReload打印 log,上述按键功能失效。如果要恢复按键功能,请设置 AT+OPENLOG=0。

语法规则:

命令类型 语法 返回

设置命令 AT+OPENLOG=<mode> OK

查询命令 AT+OPENLOG?

+OPENLOG:<mode>

OK

测试命令 AT+OPENLOG=?

+OPENLOG:<mode>取值范围

OK

参数定义:

参数 定义 取值 对取值的说明

<mode> 是否打开 log。该参数关机保存。0 关闭log打印,开启按键功能

1 开启log打印,关闭按键功能

5.1.7 TE-TA 本地流量控制:AT+IFC

语法规则:

命令类型 语法 返回

设置命令 AT+IFC=<mode> OK

查询命令 AT+IFC?

+IFC: 1

OK

测试命令 AT+IFC=?

+IFC:(0-1)

OK

参数定义:

参数 定义 取值 对取值的说明

<mode> 流控模式。该参数关机保存。0 无流控,缺省值

1 硬件流控

5.1.8 唤醒对端MCU:AT+CFGRI

使用模块的 PIN3(gpio5)完成低电平唤醒(下降沿唤醒)对端MCU,默认关闭。

Page 40: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 40 页 共 68 页

<enable>设置为 1后,每次模块串口发送数据给对端MCU前,都会先拉低 GPIO5唤醒对端 MCU,隔<time_ms>后,

开始发数据给对端。该命令的参数值关机保存。

语法规则:

命令类型 语法 返回和说明

设置命令 AT+CFGRI=<enable>,<time_ms> OK

查询命令 AT+CFGRI?

+CFGRI:<enable>,<time_ms>

OK

测试命令 AT+CFGRI=?

+CFGRI:<enable>取值范围,<time_ms>取值范围

OK

参数定义:

参数 定义 取值 对取值的说明

<enable> 打开/关闭 RI功能。1 打开RI,关闭GPIO功能。

0 关闭RI,开启GPIO功能。默认值。

<time_ms>表示RI拉低后间隔多长时间串口开始输出

数据,即RI低脉冲的宽度1~100 单位:ms,默认值是10

5.1.9 查询固件版本:AT+VER

语法规则:

命令类型 语法 返回和说明

执行命令 AT+VER

VER info

OK

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+VER

← AirM2M_ESP8266_V0020_A6501

OK

5.2. WiFi功能 AT指令

5.2.1 选择WiFi应用模式:AT+CWMODE

语法规则:

Page 41: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 41 页 共 68 页

命令类型 语法 返回 说明

设置命令 AT+CWMODE = <mode>

OK 设置成功

ERROR AT命令输入的时候有错误

no change如果输入的<mode>与当前相

查询命令 AT+CWMODE?+CWMODE:<mode>

OK当前处于哪种模式?

测试命令 AT+CWMODE = ?+CWMODE:(<mode>取值列表)

OK当前可支持哪些模式?

注意事项 设置命令关机保存

参数定义:

参数 定义 取值 对取值的说明

<mode> WiFi应用模式

1 Station模式

2 AP模式

3 AP+Station模式

Page 42: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 42 页 共 68 页

5.2.2 列出当前可用接入点:AT+CWLAP

此命令用来扫描周围存在的热点。

语法规则:

命令类型 语法 返回 说明

执行命令 AT+CWLAP

+CWLAP: <ecn>,<ssid>,<rssi>,<mac>,<channel>

……

+CWLAP: <ecn>,<ssid>,<rssi>,<mac>,<channel>OK

ERROR AT命令语法和格式错误

+CME ERROR: mode not support

ERROR

AT+CWMODE=2 时,

不支持此命令

注意事项此命令只支持 AT+CWMODE=<mode> 中mode=1或 3的情况,mode=2是纯 AP模式,不支持周

围热点的扫描。

RE参数定义:

参数 定义 取值 对取值的说明

<ecn> 加密方式

0 OPEN

1 WEP

2 WPA_PSK

3 WPA2_PSK

4 WPA_WPA2_PSK

<ssid> 接入点名称 字符串参数,字符串长度为1~31个字符

<rssi> 信号强度 -128~+127

<mac> MAC地址

<channel> 信道号

5.2.3 加入接入点:AT+CWJAP

语法规则:

命令类型 语法 返回 说明

设置命令AT+CWJAP=<ssid>,<pwd>

OK 加网成功

ERROR AT命令输入有语法错误

+CWJAP:2 加网失败,密码错误

+CWJAP:3 加网失败,找不到目标热点

+CWJAP:4 加网失败,连接失败

查询命令 AT+CWJAP?+CWJAP:<ssid>

OK

Page 43: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 43 页 共 68 页

返回当前选择的AP

参数定义:

参数 定义 取值 对取值的说明

<ssid> 接入点名称 字符串型,需要加双引号

<pwd> 密码 字符串型,需要加双引号。最长64字节,ASCII编码

5.2.4 退出接入点:AT+CWQAP

语法规则:

命令类型 语法 返回 说明

执行命令 AT+CWQAP OK 表示成功退出该AP

测试命令 AT+CWQAP=? OK 查询该命令是否支持

5.2.5 设置 AP模式下的参数:AT+CWSAP

语法规则:

命令类型 语法 返回 说明

设置命令AT+CWSAP=<ssid>,<pwd>,

<chl>, <ecn>

OK 设置参数成功

ERROR AT命令参数错误

+CME ERROR: mode not support

ERROR

当CWMODE=1的时

候,不支持该命令的设置

查询命令 AT+CWSAP?

+CWSAP: <ssid>,<pwd>,<chl>,<ecn>

OK

正常结果

+CME ERROR: mode not support

ERROR

当CWMODE=1的时

候,不支持该命令的查询

注意事项

1) AT+CWMODE=2或3的情况下,模块作为AP有一个缺省的AP名称(名称为AirM2M_******,

******为AP MAC地址的后六位,例如AirM2M_3FA6E7)及相关参数,用AT+CWSAP?可以查询;

2) AT+CWMODE=2或3的情况下,用AT+CWSAP的设置命令修改SSID或其他参数,用AT+CWSAP?

查询会看到新的ssid和参数。

参数定义:

参数 定义 取值 对取值的说明

<ecn> 加密方式

0 OPEN

1 WEP

2 WPA_PSK

3 WPA2_PSK

Page 44: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 44 页 共 68 页

4 WPA_WPA2_PSK

<ssid> 接入点名称 字符串参数

<pwd> 密码 字符串型,最长64字节,ASCII编码

<chl> 通道号 1~13

5.2.6 查询MAC地址:AT+AMMAC

语法规则:

命令类型 语法 返回 说明

执行命令 AT+AMMAC

STATION_MAC:

xx:xx:xx:xx:xx:xx

OK

如果 CWMODE设置为 1(STA模式):

AP_MAC: xx:xx:xx:xx:xx:xx

OK

如果 CWMODE设置为 2(AP模式):

STATION_MAC:

xx:xx:xx:xx:xx:xx

AP_MAC: xx:xx:xx:xx:xx:xx

OK

如果 CWMODE设置为 3(STA+AP模式):

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CWMODE? 查询WIFI层工作模式

← +CWMODE:3

OK

3:AP+STA模式

→ AT+AMMAC 查询MAC地址

← STATION_MAC: 18:fe:34:9e:ab:e4

AP_MAC: 1a:fe:34:9e:ab:e4

OK

→ AT+CWMODE=2 设置工作模式为2,AP模式

← OK

→ AT+AMMAC 查询MAC地址

← AP_MAC: 1a:fe:34:9e:ab:e4

OK

Page 45: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 45 页 共 68 页

5.2.7 查询当前加入的 AP的信号强度:AT+CAPR

语法规则:

命令类型 语法 返回

执行命令 AT+CAPR

+CAPR:<ssid>,<rssi>

OK

参数定义:

参数 定义 取值 对取值的说明

<ssid> AP名称 字符串类型

<rssi> 信号强度

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CAPR 查询当前加入的AP的信号强度

← +CAPR:"AIRM2M", -65

OK

AP的名字是AIRM2M,信号强度是-65

5.2.8 开始 SMART LINK: AT+AMSL

Page 46: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 46 页 共 68 页

语法规则:

命令类型 语法 返回 说明

设置命令 AT+AMSL=<mode>

+AMSL:<ssid>,<password>

OK

SMART LINK过程成功,模块加入

目标热点

+AMSL: <mode>

FAIL

SMART LINK过程失败,模块未能

加入目标热点

ERROR AT命令格式错误

测试命令 AT+AMSL=?

+AMSL:(0-3)

OK

参数定义:

参数 定义 取值 对取值的说明

<ssid> AP热点的名称 注:没有双引号

<password> AP热点的密码 字符和数字 注:没有双引号

<mode> smartlink 类型

0 结束smartlink过程

1 开始AirConfig(合宙smartlink)过程

2 开始EspTouch(乐鑫smartlink)过程

3 开始Airkiss(微信smartlink)过程

举例:

命令(→)

/返回(←)

实例 解释和说明

将手机的WIFI功能打开,并连接到一个路

由器上(为方便理解,称呼该路由器为A)

将我司发布的SMARTLINK Android App打开,输入希望模块连接的路由器(称呼为

B) 的 名 称 和 密 码 , 并 点 击 下 面 的

SMARTLINK键,并一直保持运行状态,直

到配置结束。

注:

1)A和B可以为同一个路由器。也就是说手机可

直接连到希望模块连接的路由器B上,并在APP中配置模块连接的路由器为B。

2)B要在模块可以搜索到的范围内。

→ AT+CWMODE? 查询WIFI层工作模式

← +CWMODE:1 模式1:STA模式

模式3:STA+AP模式

Page 47: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 47 页 共 68 页

OK 模式1和3,都可以使用SMART LINK但是模式2(纯AP模式)下无法进行SMARTLINK配置

AT+AMSL=1

开始AirConfig(合宙SMART LINK)过程.

或 拉 低 一 次 PIN16( nReload) 也 会 开 始

AT+AMSL=1的过程

(从V009版本开始支持)

←+AMSL: yh_taih,qin02666

OK

稍等一会,会出现这样的返回。

表明已经配置成功

Ssid = yh_taihPassword = qin02666

→ AT+CWJAP? 查询当前模块加入到了哪个热点

← +CWJAP:"yh_taih"

OK

表明加入 yh_taih成功

点击STOP,关闭APP

Page 48: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 48 页 共 68 页

5.3. TCPIP AT指令

5.3.1 建立 TCP/UDP连接:AT+CIPSTART

语法规则:

命令类型 语法 返回 说明

设置命令

单 路 连 接 (+CIPMUX=0)时:

AT+CIPSTART=<type>,<addr>,<port>,[local_port]

多路连接(+CIPMUX=1)时:

AT+CIPSTART=<id>,<type>,<addr>,<port>,[local_port]

OK AT命令格式正确时的返回

+CME ERROR: invalid inputvalue AT命令格式错误时的返回

注意事项

+CIPSTART设置命令返回 OK以后,后续会收到如下的 URC:

前提条件 URCs 说明

CPIMUX=0 CONNECT OK 连接成功

CIPMUX=1 <id>, CONNECT OK

CPIMUX=0 CONNECT FAIL 连接服务器失败

CIPMUX=1 <id>, CONNECT FAIL

ALREADY CONNECT 该连接已经是连接状态

参数定义:

参数 定义 取值 对取值的说明

<id> Link No. 0~3

表示连接序号

注:单 路 连 接 (+CIPMUX=0)时,模块建立链接缺

省占用<id>=0<type> 连接类型 “TCP”/”UDP”

<addr>远程服务器 IP 地址

或域名字符串型

<port> 远程服务器端口号

[local_port] 本地端口 数字, 可选参数

Page 49: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 49 页 共 68 页

5.3.2 获得 TCP/UDP连接状态:AT+CIPSTATUS

语法规则:

命令类型 语法 返回 说明

执行命令 AT+CIPSTATUS

OK

STATE: <state>

C:<cid>, <TCP/UDP>, <Local IP address>,

<Local port>, <Remote IP address>, <Remote

port>,<client state>

… …

如 果 是 单 路 连 接

(AT+CIPMUX=0)

OK

STATE:<state>

S:<sid>,<port>,<server state>

C:<cid>, <TCP/UDP>,<Local IP address>,

<Local port>, <Remote IP address>, <Remote

port>,<client state>

… …

如 果 是 多 路 连 接

(AT+CIPMUX=1)

测试命令 AT+CIPSTATUS=? OK

参数定义:

参数 定义 取值 对取值的说明

<state> 单连接状态

IP INITIAL 初始化

IP STATUS 获得本地 IP 状态

TCP

CONNECTING/UDP

CONNECTING

TCP 连接中/UDP 端口注册中

CONNECT OK 连接建立成功

TCP CLOSING/UDP

CLOSING正在关闭 TCP 连接,正在注销 UDP 端口

<sid> 服务器 id 0 或1 取值为{0,1}

<server state> 服务器状态

OPENING 正在打开

LISTENING 正在监听

CLOSING 正在关闭

<cid> 客户端 id 0~3 取值范围为{0,1,2,3}

<Local IP address> 本地 IP地址 - 字符串参数(字符串需要加引号)

<Local port> 本地端口号 - 整数型

<Remote IP address> 对端 IP 地址 字符串参数(字符串需要加引号)

<Remote port> 对端端口号 整数型

<client state> 客户端状态 INITIAL 关闭状态

Page 50: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 50 页 共 68 页

CONNECTING 正在连接

CONNECTED 已连接

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CWMODE? 查询WIFI层工作模式

← +CWMODE:3

OK

3:AP+STA模式

→ AT+CIPMUX?

← +CIPMUX:0

OK

单链接模式

→ AT+CIPSTATUS

← OK

STATE:IP STATUS

C:0,"","",,"",,"INITIAL"

C:1,"","",,"",,"INITIAL"

C:2,"","",,"",,"INITIAL"

C:3,"","",,"",,"INITIAL"

→ AT+CIPSTART="TCP","192.168.1.51",6800 模块做为CLIENT,建立一个链接

← OK

CONNECT OK

→ AT+CIPSTATUS

← OK

STATE:CONNECT OK

C:0,"TCP",”192.168.1.52”,38330,"192.168.1.51",6

800,"CONNECTED"

C:1,"","",,””,,"INITIAL"

C:2,"","",,””,,"INITIAL"

C:3,"","",,””,,"INITIAL"

→ AT+CIPCLOSE 关闭链接

← CLOSE OK

→ AT+CIPMUX=1 设置多链接前,必须事先关闭所有链接

← OK

→ AT+CIPSERVER=1,7777

← OK

←(URC) 0,CONNECT OK 模块接入一个链接

→ AT+CIPSTATUS

← OK

STATE:IP STATUS

S:0,7777,LISTENING

Page 51: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 51 页 共 68 页

C:0,"TCP","192.168.4.1",7777,"192.168.4.101",59

319,"CONNECTED"

C:1,"","",,"",,"INITIAL"

C:2,"","",,"",,"INITIAL"

C:3,"","",,"",,"INITIAL"

5.3.3 启动多连接:AT+CIPMUX

语法规则:

命令类型 语法 返回和说明

设置命令AT+CIPMUX=<mode>

OK 设置成功

+CME ERROR: The socket is alreadyconnected

如果已经处于连接模式(请看注意事项)

查询命令 AT+CIPMUX?+CIPMUX:<mode>

OK

查询当前是否处在多连接模

注意事项当模块已经有链接存在时,无法修改<mode>值,会返回:+CME ERROR: The socket is already

connected。只有用 AT+CIPCLOSE把所有链接都关闭时,才能修改<mode>.

参数定义:

参数 定义 取值 对取值的说明

<mode> 是否启动多连接模式0 设置为单连接模式

1 设置为多连接模式

5.3.4 发送数据:AT+CIPSEND

语法规则:

命令类型 语法 返回 说明

设置命令

单 路 连 接 (+CIPMUX=0)时:

AT+CIPSEND=<length>

多路连接(+CIPMUX=1)时:

AT+CIPSEND=<id>,<length>

+CME ERROR: invalid input

value 参数错误

+CME ERROR: The socket

is not connected没有建立连接

Page 52: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 52 页 共 68 页

>$$$$$$

SEND OK

模块先返回>

$$$$$表示实际输入的数据,当

数据达到<length>长度后自己

发送出去。

SEND OK表示发送成功

>$$$$$$

ERROR

同上,ERROR表示发送数据的时

候链接断掉

测试指令 AT+CIPSEND=?

+CIPSEND: <length>

OK

单路连接(AT+CIPMUX=0)

+CIPSEND:<0-3>,<length>

OK

多路连接(AT+CIPMUX=1)

执行命令 AT+CIPSEND

OK

AT+CIPMODE=1 且 建 立

TCP/UDP单链接后,此命令可进

入透传模式

+CME ERROR: mode not

support其他使用场景下

参数定义:

参数 定义 取值 对取值的说明

<length> 数据长度 1~2048 单位:字节

<id> Link No. 0~3 连接序号

5.3.5 设置 TCP链接的窗口大小:AT+CIPWND

TCP sliding window是为了进行流量控制:接收方通过窗口大小来告诉发送方自己目前的接收能力,发方发送的数据大小

不能超过收方的窗口大小这样就能防止发方和收方的速度不同步,达到流量控制的目的。

语法规则:

命令类型 语法 返回

设置命令AT+CIPWND=<linkid>,<tcp_

window_size>OK

查询命令 AT+CIPWND?+CIPWND:<linkid>,<tcp_window_size>

OK

测试命令 AT+CIPWND=?

+CIPWND:(<linkid>取值范围), (<tcp_window_size>取值范围)

OK

Page 53: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 53 页 共 68 页

参数定义:

参数 定义 取值 对取值的说明

<linkid> 链接序号 0~3

<tcp_window_size> TCP窗口大小 0~1024

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CIPWND=?

← +CIPWND:(0-4),(0-1024)

OK

→ AT+CIPSTART="TCP","192.168.1.51",6800 建立一个单链接

← OK

CONNECT OK

连接上了

→ AT+CIPWND?

← +CIPWND:

C:0,1024

C:1,

C:2,

C:3,

OK

→ AT+CIPWND=0,100

← +CIPWND:

C:0,100

C:1,

C:2,

C:3,

OK

5.3.6 配置透传时成帧发送:AT+CIPCCFG

透传时,超时或者达到设置的帧大小,都会启动发送。

语法规则:

命令类型 语法 返回

设置命令 AT+CIPCCFG=<wait_time>,<frame_size> OK

查询命令 AT+CIPCCFG?+CIPCCFG:<wait_time>,<frame_size>

OK

Page 54: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 54 页 共 68 页

测试命令 AT+CIPCCFG=?

+CIPCCFG:<wait_time>取值范围,<frame_size>取值范围

OK

参数定义:

参数 定义 取值 对取值的说明

<wait_time> 等待时间 1~65535 单位是ms,缺省值是100

<frame_size> 帧大小 1~65535 单位是字节,缺省值是2048

5.3.7 关闭 TCP/UDP连接:AT+CIPCLOSE

语法规则:

命令类型 语法 返回 说明

设置命令

单路连接时

AT+CIPCLOSE=<id>CLOSE OK

关闭成功

多路连接时

AT+CIPCLOSE=<id><id>,CLOSE OK

关闭成功

执行命令 AT+CIPCLOSE

CLOSE OK关闭成功

ERROR关闭失败

测试命令 AT+CIPCLOSE=? OK

注意事项

单路连接时,AT+CIPCLOSE=<id>中的<id> 只可能为0 执行命令只对单链接有效,多链接模式下返回ERROR 执行命令和设置命令只有在CONNECT OK状态下才能关闭连接,其余状态关闭连接会返回ERROR。

事实上在非CONNECT OK状态下不需要关闭连接,如果想重新建立链接直接用AT+CIPSTART即可。

单连接模式下,关闭后的状态为IP CLOSE

参数定义:

参数 定义 取值 对取值的说明

<id> Link No. 0~3 整数型,表示连接序号

5.3.8 获取本地 IP地址:AT+CIFSR

设置命令可以自己选定模块的 IP地址;

查询命令可以查询当前模块的 IP地址,包括 STA模式下的 IP地址和 AP模式下的 IP地址。

语法规则:

Page 55: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 55 页 共 68 页

命令类型 语法 返回 说明

设置命令AT+CIFSR=<mode>,<ip_addr>,<netmask>,<gateway>

OK 设置成功

+CME ERROR: invalid input value 当输入参数错误时

查询命令 AT+CIFSR

<sta_IP address>

OK当 CWMODE=1

<ap_IP address>

OK 当CWMODE=2

<sta_IP address><ap_IP address>

OK

当CWMODE=3

ERROR 没有 IP地址

测试命令 AT+CIFSR=? OK

参数定义:

参数 定义 取值 对取值的说明

<mode> 设置 IP地址的类型1 Station模式

2 AP模式

<ip_addr> 设置的 IP地址 格式为”xx.xx.xx.xx”

<netmask> 子网掩码 格式为”xx.xx.xx.xx”

<gateway> 网关 格式为”xx.xx.xx.xx”

<sta_IP address> 本机 STA模式下当前的 IP地址 格式为”xx.xx.xx.xx”

<ap_IP address> 本机 AP 模式下当前的 IP地址 格式为 xx.xx.xx.xx

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CIFSR 查询当前IP地址

← 192.168.1.160

192.168.4.1

OK

上面是STA IP地址

下面是AP IP地址

→ AT+CIFSR=1,”192.168.1.161”,”255.255.255.0”,”192.168.1.1” 修改STA IP

← OK

5.3.9 配置为服务器:AT+CIPSERVER

需要先执行 AT+CIPMUX=1,打开多连接模式。

最多支持监听共两个端口,每个端口 TCP和 UDP都监听,2个端口加起来一共能支持 4个链接(这四个链接中 TCP个数

和UDP个数可任意分配)。

语法规则:

Page 56: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 56 页 共 68 页

命令类型 语法 响应 说明

设置命令 AT+CIPSERVER=<mode>[,<port>]

OK开启 server成功,开始监听

<port>

+CME ERROR: no change 端口号被占用则

注意事项

用 AT+CIPSERVER=0关闭 server后需要重启

如果有 CLIENT连接上模块这个 SERVER,则返回:

<linkid>,CONNECT OK

参数定义:

参数 定义 取值 对取值的说明

<mode> 是否开启服务器模式0 关闭服务器模式

1 开启服务器模式

<port> 端口号 1~65535 缺省值为 333

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CIPSERVER=1,9900 设置一个服务器监听端口号为9900

← OK

→ AT+CIPSERVER=1,5678 设置另外一个服务器监听端口号为5678

← OK

5.3.10 模块收到服务器数据:+IPD 和+RECEIVE

此指令是模块上报到串口的URC(Unsolicited Result Code),当模块接收到网络数据时向串口发送以+IPD 和+RECEIVE

为 header的数据.

语法规则:

命令类型 语法 响应和说明

非透传时

+IPD,<len>:<data> 单路连接时 (+CIPMUX=0) ,数据接收,数据头以+IPD开头

+RECEIVE,<id>,<len>:

<data>

多路连接时 (+CIPMUX=1) ,<data> 是接收到的数据,和

+RECEIVE, <id>,<len>:之间间隔一个\r\n

注:冒号是英文的冒号

透传时

<data>

透传状态下接收数据,没有数据头,数据直接从串口上来

注:

多链接的透传方式是:往模块串口发送的每笔数据都会自动被模

块发送到当前处于 CONNECTED状态下的所有链接。用户可以

通过应用层的协议来保证数据的针对性。

Page 57: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 57 页 共 68 页

参数定义:

参数 定义 取值 对取值的说明

<id> Link No. 0~3 连接序号

<len> <data>的长度单位:字节

注:长度是<data>的长度,不包括数据头

<data> Character string

数据接收示例(以接收数据“TEST123”为例):

非透传 透传

单链接 +IPD,7:TEST123 TEST123

多链接 +RECEIVE,1,7:

TEST123 TEST123(在每个 CONNECTED状态的链接上)

5.3.11 选择数据发送模式:AT+CIPMODE

语法规则:

命令类型 语法 返回

设置命令 AT+CIPMODE=<mode> OK

查询命令 AT+CIPMODE?

+CIPMODE: <mode>

OK

测试命令 AT+CIPMODE=?

+CIPMODE: (0-NORMAL MODE,1-TRANSPARENT MODE)

OK

参数定义:

参数 定义 取值 对取值的说明

<mode> TCPIP应用模式0 非透明传输模式,即AT命令模式。缺省模式

1 透明传输模式

5.3.12 设置 TCP断链后自动重连次数:AT+CIPRCON

不管是透传还是非透传模式,TCP链接上,模块作为 CLIENT,只要发送数据,哪怕是只有一次,就能判断出来链接

处于连接还是断连状态。断连情况有两种:

1)正常断连。此时模块收到了服务器发送的断连请求

2)异常断连。此时模块未收到服务器发送的断连请求,但是发送数据却发送不出去。

本命令可以让模块作为 CLIENT在 TCP断链的情况下自动发起重连。

在异常断链情况下重连,还是异常断链和正常断链情况下都重连,由<recon_status>来设定。

设置命令的参数关机保存。

Page 58: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 58 页 共 68 页

语法规则:

命令类型 语法 返回

设置命令AT+CIPRCON=<recon_times>,<recon_status> OK

查询命令 AT+CIPRCON?+CIPRCON:<recon_times>,<recon_status>

OK

测试命令 AT+CIPRCON=?

+CIPRCON:<recon_times>取值范围,<recon_status>取值范围

OK

参数定义:

参数 定义 取值 对取值的说明

<recon_times>TCP断链后的自动重

连次数0~65535

单位是次。默认值为3次0表示不重连,65535表示一直重连

每次重连的间隔时间根据网络情况定,如果网络有响应,就

间隔1s。如果网络没有反应就间隔5*RTO时间,RTO默认

为3s,实际值需要根据TCP协议计算。

<recon_status> 在什么情况下重连

0 只在异常断链的情况下模块主动发起重连,缺省值。

1正常断链和异常断链的情况下模块都主动发起重连。取值为

1的时候,不受<recon_times>参数控制,会一直重连,直

到成功。

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CIPRCON=65535,0 设置模块在判断为异常断链后一直重连

← OK前提条件:把连接服务器的网线拔掉或把服务器网卡禁用

1)非透传模式下断链重连

→ AT+CIPSEND=0,5 非透传模式下在链接0上发送数据,个数是5

>TEST1

发现数据发不出去

注:只要有一次AT+CIPSEND失败,就能判断异常断链,

然后会一直重连。

把网线接上,过一会发现重新建立了链接

2)透传模式下断链重连

1234567888模块处于透传模式下,MCU给串口发一串数据,比如

1234567888,长度和内容不限。此时肯定是发不出去的。

把网线接上,过一会发现重新建立了链接

5.3.13 设置服务器主动断开的超时时间:AT+CIPSTO

命令类型 语法 返回和说明

Page 59: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 59 页 共 68 页

设置命令 AT+CIPSTO=<s_id>,<s_timeout > OK

查询命令 AT+CIPSTO?

+ S:<s_id1>,<s_timeout1>

……

+ S:<s_idn>,<s_timeoutn>

OK

参数定义:

参数 定义 取值 对取值的说明

<s_id1>~

<s_idn>

服务器监听端口的 id,也叫服务器

编号。目前支持 0和 1。

0

1

<s_timeout >用来设置多少时间内服务器收不到

数据就主动断开。该参数关机保存。0~4294967295

单位为1s。默认值为180s0表示永不断开

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CIPSTO=0,120 设置服务器0 timeout 值为120秒

← OK

→ AT+CIPSTO?

← S:0,120

S:1,180

模块默认有2个服务器

5.3.14 保存透传设置:AT+CIPSCON

AT+CIPSCON=1将最近一次的+CIPSTART,+CIPMODE,+CIPSERVER,+CIPRCON的设置命令参数关机保存。

AT+CIPSCON=0将这些参数清空或恢复成缺省值并关机保存。

语法规则:

命令类型 语法 返回

设置命令 AT+CIPSCON=<action> OK

查询命令 AT+CIPSCON

C:<id>,<protocol>,<ip>,<remotePort>,<localPort>

S:<id>,<localPort>,<timeout>

DATA_MODE:<d_mode>

CIPRCON:<recon_times>,<recon_status>

OK

测试命令 AT+CIPSCON=?

+CIPSCON:(0,1)

OK

参数定义:

Page 60: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 60 页 共 68 页

参数 定义 取值 对取值的说明

<action> 保存/清除透传参数

1

保存透传参数

开机后模块进行以下动作:1)按照+CWJAP的参数加入热点

2)按照+CIPSTART 的参数建立TCP/UDP链接,

同时按照+CIPSERVER的参数监听端口

3)按照DATA_MODE所示的方式建立传输模式:

透传还是非透传

4)有断链时,会按照+CIPRCON的设置命令参数

进行重连

0清除透传参数

S和C的数据被清空,同时模块恢复成非透传模式。

<id> 链接标识

<protocol> 网络协议TCP

UDP

<ip> Ip地址 x.x.x.x

<remotePort> 对端端口 指的是服务器端口

<localPort> 本地端口对C来说,就是模块本地CLIENT端口

对S来说,就是模块本地SERVER端口

<timeout> Server连接超时时间 0~65535 请参考AT+CIPSTO。缺省为180

<d_mode>

透传模式,即+CIPMODE的设置

参数<mode>的关机保存值。

AT+CIPMODE=<mode>

后,再 AT+CIPSCON=1,就可

以将<mode>参数关机保存。

0 普通AT模式,即非透传模式

1 透传模式

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+CWMODE?

← +CWMODE:1

OK

→ AT+CIPMODE=1

← OK

→ AT+CIPMUX=1 多连接模式

← OK

→ AT+CWJAP="ChinaNet-hXug","5qsqruiv"

← OK

→ AT+CIPSTART=0,"TCP","192.168.1.51",6800 多连接模式下需要id,这里id=0

← OK

0,CONNECT OK

→ AT+CIPSCON=1

← OK

→ AT+CIPSCON

← C:0,"TCP","192.168.1.51",6800,43888

C:1,"","", ,

Page 61: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 61 页 共 68 页

C:2,"","", ,

C:3,"","", ,

S:0, ,

S:1, ,

DATA_MODE:1

CIPRCON:3

OK然后重启模块。

模块重启后,会进入透传模式,并自动建立linkid=0,protocol="TCP",服务器ip="192.168.1.51",服务器端口=6800 的链接

AT+CIPSTATUS

OK

STATE:IP STATUS

C:0,"TCP","192.168.4.1",43888,"192.168.1.51",

6800,"CONNECTED"

C:1,"",””,,"",,"INITIAL"

C:2,"",””,,"",,"INITIAL"

C:3,"",””,,"",,"INITIAL"

5.3.15 选择非透传数据发送模式:AT+CIPQSEND

在非透传数据发送模式下,也有快发和慢发两种发送模式,用+CIPQSEND来设置。

语法规则:

命令类型 语法 返回

设置命令 AT+CIPQSEND=<n> OK

查询命令 AT+CIPQSEND?

+CIPQSEND: <n>

OK

测试命令 AT+CIPQSEND=?

+CIPQSEND: (0,1)

OK

参数定义:

参数 定义 取值 对取值的说明

<n> 非透传数据发送模式

0普通模式 ,也叫慢发模式– 当服务器接收 TCP 数据,模块返回 SENDOK。缺省值。

1

快 发 模 式 – 当 数 据 发 送 到 模 块 , 模块返回

单链接:DATA ACCEP:<length>多链接:DATA ACCEPT:<id>,<length>而不是 SEND OK

Page 62: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 62 页 共 68 页

5.3.16 网页配置用户名和密码设置:AT+WEBCFG

语法规则:

命令类型 语法 返回

设置命令 AT+WEBCFG=<old ssid>,<old pwd>,<new ssid>,<new pwd> OK

举例:

命令(→)

/返回(←)

实例 解释和说明

→ AT+WEBCFG="admin","admin","GSSGAS-AP","Air8888"← OK

5.3.17 退出透传模式:+++

语法规则:

命令类型 语法 返回

执行命令 +++ 注意:+++ 前后不能有别的字符

5.3.18应用举例

模块在WIFI这个层次上可以作为 STATION,也可以做 AP,也可以做 AP+STATION;而从传输层而言可以作为

SERVER,也可以做 CLIENT;而从应用层而言,可以做非透传数据传输,也可以做透传数据传输。

举例:

命令(→)

/返回(←)

实例 解释和说明

1)模块工作在STATION模式(AT+CWMODE=1):

以下绿色部分是此模式下共同的前提步骤:

→ AT+CWMODE? 步骤1:查询WIFI层工作模式

← +CWMODE:3

OK

缺省模式为3:AP+STA模式

→ AT+CWMODE=1 步骤2:设为Station模式

← OK

→ AT+RST 步骤3:设置完工作模式后需要重启

← OK注:如果开机AT+CWMODE?查询到的

模式已经是1,步骤2和步骤3可省略

→ AT+CWLAP 步骤4:查询当前可用接入点

Page 63: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 63 页 共 68 页

← +CWLAP:(3,"yh_taihdhad",-45,"54:e6:fc:52:36:e6"

,9)

+CWLAP:(4,"lemon",-86,"6c:e8:73:69:4b:76",10)

+CWLAP:(4,"Xiaomi_yu",-85,"8c:be:be:2c:46:ea",

11)

OK

查询结果

→ AT+CWJAP="yh_taihdhad","UUU02339" 步骤5:加入到一个AP

← OK注:完成本步骤后,模块重启会自动保存

现在的模式和AP,重启后也可以生效

1.1)模块做为CLIENT,单链接,非透传:

→ AT+CWJAP? 查询当前加入的那个AP

← +CWJAP:"yh_taihdhad"

OK

→ AT+CIFSR 查询模块当前IP地址

← 172.168.1.114

→ AT+CIPSTART="TCP","172.168.1.119",4321 建立一个TCP链接

← OK

← CONNECT OK 表示连接成功

→ AT+CIPSEND=5设置发送长度为5,模块收到数据满5个后,

会自动发送出去

→ >hello出现>后,发送5个字符hello到串口,模块

会自动发送数据

← SEND OK 表示发送成功

← +IPD,14:hello,thisispc 模块收到服务器数据,直接送到串口

→ AT+CIPCLOSE 关闭连接

← OK1.2)模块做为CLIENT,单链接,数据透传:

→ AT+CIPMODE=1 设置模块为透传模式

← OK

→ AT+CIPSTART="TCP","172.168.1.119",4321 连接一个服务器

← OK

CONNECT OK

表示连接成功

→ AT+CIPSCON=1 保存参数(链接参数以及透传模式)

← OK

→ AT+CIPSEND进入透传

不重启模块的情况下直接进入透传

←>

AT+CIPSEND回车后,会返回个>, 此时

上位机就可以从串口发数据给模块了,模块

会将数据自动发送出去

←SSSSAAAAAAAA

服务器发来 “SSSSAAAAAAAA”这串数

据,模块直接显示

注:透传接收时,没有数据头

重启模块

重启后,模块直接进入透传,并按照

"TCP","172.168.1.119",4321建立链接

Page 64: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 64 页 共 68 页

→ +++暂时退出透传状态,进入AT命令模式

注意:+++前后不能有字符

→ AT+CIPSCON 查询透传参数和状态

← C:0,"TCP","172.168.1.119",4321,35330

C:1,"","", ,

C:2,"","", ,

C:3,"","", ,

S:0, ,

S:1, ,

DATA_MODE:1

CIPRCON:3

OK

查询出的是最后一次AT+CIPSCON=1时

的状态和参数

→ AT+CIPSTATUS

← OK

STATE:CONNECT OK

C:0,"TCP",”172.168.1.121”,35330,"172.168.1.119",

4321,"CONNECTED"

C:1,"","",,””,,"INITIAL"

C:2,"","",,””,,"INITIAL"

C:3,"","",,””,,"INITIAL"

重启模块,重启后重新进入透传,并自动建立 1个链接,链

接参数与最后一次保存的相同

1.3)模块做为 CLIENT,多链接,数据透传:

→ AT+CIPMUX=1 启动多链接模式

← OK

→ AT+CIPMODE=1 透传模式

← OK

→ AT+CIPSTART=0,"TCP","172.168.1.119",4321 这个是外网服务器

← OK

CONNECT OK

→AT+CIPSTART=1,"TCP","192.168.1.51",1111

这是跟模块连接同一个路由器的内网服务

← OK

CONNECT OK

→ AT+CIPSCON=1 保存参数(链接参数以及透传模式)

← OK

重启模块,重启后重新进入透传,并自动建立2个链接,链接

参数与最后一次+CIPSCON保存的相同

1.4)模块做为SERVER,多链接,非透传

→ AT+CIPMUX=1

← OK

→ AT+CIPSERVER=1,8800 模块做为SERVER

← OK设置成功

可同时监听TCP和UDP连接

Page 65: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 65 页 共 68 页

→ AT+CIPSTATUS

← OK

STATE:IP STATUS

S:0,8800,LISTENING

C:0,"","",,””,,"INITIAL"

C:1,"","",,””,,"INITIAL"

C:3,"","",,””,,"INITIAL"

← 0,CONNECT OK CLIENT连接上模块(TCP),linkid = 0

1,CONNECT OK

CLIENT连接上模块(UDP),linkid = 1

注:不管TCP还是UDP,最多可以建4个链接

→ AT+CIPSTATUS 查询TCPIP层状态

← OK

STATE:IP STATUS

S:0,8800,LISTENING

C:0,UDP,”192.168.4.1”,8800,”192.168.4.112”,650

74,CONNECTED

C:1,TCP,”192.168.4.1”,8800,”192.168.4.112”,5011

4,CONNECTED

C:2,"","",,””,,"INITIAL"

C:3,"","",,””,,"INITIAL"

← +RECEIVE,0,10:

0123456789

收到 CLIENT发来的数据,内容为:

0123456789

→ AT+CIPSEND=0,6 发送数据

← >此时可以输入数据了,输入6个字符后,数

据会自动发送

← 0,SEND OK 数据发送成功

← 0,CLOSE OK 对端(CLIENT)主动断开链接

→ AT+CIPSERVER=0

← OK

we must restart

关闭服务器后需要重启模块

1.5)模块做为SERVER,单链接和多链接,透传数据

→ AT+CIPMUX=1

← OK

→ AT+CIPSERVER=1,8800 模块做为SERVER

← OK设置成功

可同时监听TCP和UDP连接

→ AT+CIPMODE=1

← OK

→ AT+CIPSCON=1

← OK

重启模块,进入透传模式,并等待CLIENT链接的建立。链接

建立成功,不会有任何提示。此时可以双向数据透传。

模块作为SERVER可最多同时监听4条链

接(TCP+UDP)

2)模块工作在AP模式:

Page 66: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 66 页 共 68 页

以下绿色部分是此模式下共同的前提步骤:

→ AT+CWMODE? 步骤1:查询WIFI层工作模式

← +CWMODE:3

OK

缺省模式为3:AP+STA模式

→ AT+CWMODE=2 步骤2:设为AP模式

← OK

→ AT+RST 步骤3:设置完模式后需要重启

←OK

注:如果开机AT+CWMODE?查询到的模

式已经是2,则步骤2和3可省略

→ AT+CWSAP="aptest","123456",1,0 步骤4:设置模块为AP,以及配置AP参数

OK

注:完成本步骤后,模块重启会自动保存

原来的模式,如果重启前是AP模式,则重

启后仍为AP模式,并保持重启前的AP参数(SSID,密码等)

STATION接入aptest这个AP2.1)CLIENT,单链接,非透传数据:

请参考1.1)部分的实例

2.2)CLIENT,单链接,透传数据:

请参考1.2)部分的实例

2.3)CLIENT,多链接,透传数据:

请参考1.3)部分的实例,不同的部分是此应用下所有连接都

是内网链接

2.4)SERVER,多链接,非透传数据:

请参考1.4)部分的实例

2.5)SERVER,单链接和多链接,透传数据:

请参考1.5)部分的实例

3)模块工作在AP+STATION模式:

以下绿色部分是此模式下共同的前提步骤:

→ AT+CWMODE=3 设为AP+STA模式

← OK

→ AT+RST 设置完模式后需要重启

← OK

→ AT+CWJAP="yh_taihdhad","UUU02339"加入到一个AP,这个AP是可上外网的路由

← OK

→ AT+CWSAP="aptest","123456",1,0设置模块为AP(名称为aptest),并配置

AP参数

← OK

有一个电脑(命名为USER)用WIFI接入aptest这个AP

→ AT+CIPMUX=1 开启多链接模式

← OK

→ AT+CIPSTART=1,"TCP","120.209.197.145",8000 跟外网的一个SERVER建立TCP链接,链接

Page 67: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 67 页 共 68 页

号是1

← OK

1,CONNECT OK

连接外网SERVER成功

3.1)模块除连接外网服务器外,还作为CLIENT连接本地服务器

业务类型:多链接,非透传

→ AT+CIFSR

← 192.168.4.1

192.168.2.110

OK

192.168.2.110是加入可上外网的路由器

时分配的ip地址

192.168.4.1模块本身作为AP的ip地址

→ AT+CIPSTART=2,"TCP","192.168.4.100",7777跟USER上的服务器建立一个链接,连接号

是2← OK

2,CONNECT OK

← +RECEIVE,2,11:

hhhhhhfdddd

从USER收到一包数据

→ AT+CIPSEND=1,11 从USER服务器上收到的数据(链接2),

再发到外网服务器上去(链接1)← > 输入hhhhhhfdddd

← 1,SEND OK 字符个数到了11个,会自己发送出去

3.2)模块除连接外网服务器外,还作为CLIENT连接本地服务器

业务类型:多链接,透传

→ AT+CIPSTART=2,"TCP","192.168.1.100",7777跟USER上的服务器建立一个链接,连接号

是2← OK

2,CONNECT OK

→ AT+CIPMODE=1

← OK

→ AT+CIPSCON=1

← OK

重启模块,重启后,模块进入透传,同时自动建立1,2两个

连接:

→ +++

→ AT+CIPSTATUS 退出透传模式可查询当前链接状态

← STATE:IP STATUS

C:0,"","",,””,,"INITIAL"

C:1,"TCP",”192.168.1.119”,12363,"120.209.197.14

5",8000,"CONNECTED"

C:2,"TCP",”192.168.1.119”,36890,"192.168.1.100"

,7777,"CONNECTED"

C:3,"","",,””,,"INITIAL"3.3)模块除连接外网服务器外,还作为服务器监听本地连接

业务类型:多链接,非透传

→ AT+CIPSERVER=1,3366

← OK

← 0,CONNECT OKUSER做为CLIENT建立一个UDP链接接入

模块这个AP,链接号为0

Page 68: AirM2M ESP8266 WiFi 模块用户手册 V3aftabcdn.s3.amazonaws.com/aftab/2939-120-4767/AirM2M... · 2017-05-21 · 第1页共68页 AirM2M_ESP8266_WiFi模块用户手册V3.3 标准AT命令版本

AirM2M_ESP8266_WiFi模块用户手册 V3.3

上海合宙通信科技有限公司 http://www.openluat.com 第 68 页 共 68 页

← 2,CONNECT OKUSER做为CLIENT建立一个TCP链接接入

模块这个AP,链接号为2→ AT+CIPSEND=0,8

← > 输入12345678,然后数据会自己发出去

← 0,SEND OK

→ AT+CIPSTATUS 查询TCPIP状态

← OK

STATE:IP STATUS

S:0,3366,LISTENING

C:0,UDP,”192.168.4.1”,3366,”192.168.4.100”,517

33,CONNECTED

C:1,TCP,”192.168.1.119”,35669,”120.209.197.156

”,8000,CONNECTED

C:2,TCP,”192.168.4.1”,3366,”192.168.4.100”,5795

7,CONNECTED

C:3,"","",,””,,"INITIAL"3.4)模块除连接外网服务器外,还作为服务器监听本地连接

业务类型:多链接,透传

→ AT+CIPSERVER=1,3366

← OK

→ AT+CIPMODE=1

← OK

→ AT+CIPSCON=1

← OK

重 启 模 块 , 自 动 进 入 透 传 模 式 , 并 自 动 建 立

1,"TCP","120.209.197.145",8000这个链接

同时作为SERVER,监听3366这个端口,等待连接的建立