WiFi开发|ESP8266模组AT指令开发一

ESP8266模组AT指令开发一

1. 烧录AT固件

安信可官方网站（或其他途径）获取AT固件，本文中使用的是安信可默认的合成AT固件，使用ESP8266 DOWNLOAD TOOL将AT固件烧录到ESP8266中

2. 常用AT指令

每条指令可以细分为以下四种命令，但不是所有的指令都具备下属四类指令

命令类型	指令格式	说明
测试命令	AT+< CMD >=?	用于查询设置命令或内部查询设置的参数及其取值范围
查询命令	AT+< CMD >?	用于返回参数的当前值
设置命令	AT+< CMD >=< … >	用于设置用户自定义的参数值
执行命令	AT+< CMD	用于执行受模块内部程序控制的变参数不可变的功能

基础AT指令

指令	说明	返回值	参数
AT	测试指令	OK	无
AT+RST	重启模块	OK	无
AT+GMR	查看版本信息	版本信息	无
ATE	开关回显功能	OK	ATE0关闭；ATE1开启
AT+RESTORE	恢复出厂设置	OK	无
AT+UART	设置串口配置	OK	？查询；=br,dt,sb,pa,fc配置串口

WiFi功能AT指令

指令	说明	返回值	参数
AT+CWMODE=？	查询应用模式取值范围	+CWMODE(1-3)	无
AT+CWMODE？	查询当前模式	+CWMODE:< mode >	无
AT+CWMODE=<…>	设置WIFI应用模式	OK	1(STA),2(AP),3(STA+AP)
AT+CWJAP	加入AP	OK	?查询，=< ssid>,< pwd > 加入
AT+CWLAP	列出当前可用AP	可用的AP列表	无
AT+CWQAP	退出与AP的连接	OK	无
AT+CWSAP	设置AP模式下的参数	OK	?查询，=< ssid>,< pwd > ,< ch>,< ecn>
AT+CWLIF	查看已接入设备的IP	已接入设备的IP和MAC	无
AT+CWDHCP	设置DHCP开关	OK	=< mode>,< en >
AT+CWAUTOCONN	设置STA开机自动连接到WIFI	OK	=< en>,0失能,1使能
AT+CIPSTAMAC	设置STA的MAC地址	OK	?查询，=< mac>设置
AT+CIPAPMAC	设置AP的MAC地址	OK	?查询，=< mac>设置
AT+CIPSTA	设置STA的IP地址	OK	?查询，=< ip>设置
AT+CIPAP	设置AP的IP地址	OK	?查询，=< ip>设置
AT+CWSTARTSMART	启动智能连接	OK	可加参数=1/2/3
AT+CWSTOPSMART	停止智能连接	OK	无
AT+WPS	设置WPS功能	OK	=< en>,0失能,1使能
AT+MDNS	设置MDNS功能	OK	=< en>, < hostname>,< servername>,< serverport>,
AT+CWHOSTNAME	设置ESP8266 Station的主机名字	OK	?查询，=< name>设置

TCP/IP功能AT指令

指令	说明	返回值	参数
AT+CIPSTATUS	获得连接状态	STATUS:2/3/4/5	无
AT+CIPDOMAIN	域名解析	+CIPDOMAIN: IP address	=< domain name> 待解析的域名
AT+CIPSTART	建立TCP连接或注册UDP端口号	OK	=< link ID多连接需要>,< TCP/UDP/SSL>,< remote IP>,< remote PORT>
AT+CIPSSLSIZE	设置SSL Buffer容量	OK	=< size> 取值范围2048~4096
AT+CIPSEND	发送数据	OK	?测试，=< length>或=< id>,< length>
AT+CIPCLOSE	关闭TCP或UDP	OK	?测试，=< id>多连接时需要
AT+CIFSR	获取本地IP地址	OK	?测试
AT+CIPMUX	启动多连接	OK	?测试，=< mode>0单路,1多路
AT+CIPSERVER	配置为服务器	OK	=< mode>,< port>0关闭,1开启
AT+CIPMODE	设置模块传输模式	OK	?测试，=< mode>0关闭透传,1开启透传
AT+SAVETRANSLINK	保存透传到FLASH	OK	=< en>,< remote IP>,< remote PORT>
AT+CIPSTO	设置服务器超时时间	OK	?查询，=< time>设置
AT+PING	PING命令	OK	=< IP>字符串形式的IP或域名
AT+CIPDINFO	接收网络数据时是否提示对端IP和端口	OK	=< mode>0不显示,1显示
AT+CIPSNTPCFG	设置时域和SNTP服务器	OK	?查询，=< en>,< timezone>,< SNTP server0>…
AT+CIPSNTPTIME	查询SNTP时间	OK	?查询

3. 常用AT指令测试

测试工具：ESP8266开发板（v1.5.4.1 AT固件）、串口助手、网络调试助手、手机端网络调试助手

3.1 TCP相关测试

• STA模式，ESP8266作为TCP客户端： ESP8266设为STA模式，连接到无线路由器（AT+CWJAP）；手机连上相同的路由器，使用网络调试APP创建TCP服务器；ESP8266连接TCP服务器（AT_CIPSTART）；ESP8266启动发送后，即可给手机发送消息，手机端也可以给ESP8266发送消息

• STA模式，ESP8266作为TCP服务器： ESP8266设为STA模式，连接到无线路由器（AT+CWJAP），开启多连接，设置ESP8266为服务器，查看MAC/IP，启动发送；手机连上相同的路由器，使用网络调试APP创建TCP客户端，连接对应的IP/PORT，即可发送接收消息

• AP模式，ESP8266作为TCP客户端： ESP8266设为AP模式，开启WiFi热点；手机连上ESP8266的热点后，使用网络调试APP创建TCP服务器；ESP8266连接服务器，启动发送

• AP模式，ESP8266作为TCP服务器： ESP8266设为AP模式，开启WiFi热点，开启多连接，开启服务端，查看MAC/IP，启动发送；手机连上ESP8266的热点后，使用网络调试APP创建TCP客户端，连接对应的IP/PORT，即可发送接收消息

• STA+AP模式，ESP8266作为TCP客户端： ESP8266设为STA+AP模式，连接到无线路由器；手机连上相同的路由器，使用网络调试APP创建TCP服务器；ESP8266连接TCP服务器，进入透传模式，保存透传设置，启动发送

透传模式中，若识别到单独的“+++”且取消发送新行，则退出透传模式

• STA+AP模式，ESP8266作为TCP服务器： ESP8266设为STA+AP模式，连接到无线路由器，开启WiFi热点，开启多连接，开启服务器，查看MAC/IP；PC连上相同的无线路由器，使用网络调试助手开启一个客户端；手机连上ESP8266的热点，使用网络调试APP创建一个客户端；可以向客户端0/1发送数据

3.2 UDP相关测试

• 固定远端： ESP8266设为STA+AP模式，连接到无线路由器，查询设备IP地址，使能多连接；PC连上相同的无线路由器，使用网络调试助手开启一个UDP客户端（端口8080）；创建UDP固定远端连接（AT+CIPSTART），启动发送

AT+CIPSTART=4,“UDP”,“192.168.254.88”,8080,1112,0 //4为分配的连接号；类型；远端IP；远端端口；0表示当前UDP传输建立后，远端不会被其他设备更改

• 可变远端： ESP8266设为STA+AP模式，连接到无线路由器，查询设备IP地址；PC连上相同的无线路由器，使用网络调试助手开启两个UDP客户端（端口8080和8090）；创建UDP可变远端连接（AT+CIPSTART），启动发送，可通过指定IP/PORT向需要的远端发送消息

AT+CIPSTART=“UDP”,“192.168.254.88”,8080,1112,2 //类型；远端IP；远端端口；2表示当前UDP创传输建立后，远端仍然会更改

3.3 HTTP相关测试

ESP8266设为STA模式，连接到无线路由器，连接网络，设置透传，启动发送，之后就可以使用GET/POST方法；“+++”（取消发送新行）可退出透传模式

3.4 Smartconfig配网测试

• 使用 ESP Touch 进行配网： ESP8266设为STA模式，开启智能配网（=3表示支持ESP-Touch和Airkiss智能配网）；手机连接到需要的无线网，下载安装安信可 SocketAssistant，进入ESP Touch后输入密码，选择组播，确认即可；ESP8266配网成功，输出相关信息，之后需要关闭智能配网，释放内存，查看网络连接状态

• 使用微信 Airkiss 进行配网： ESP8266设为STA模式，开启智能配网（=3表示支持ESP-Touch和Airkiss智能配网）；手机连接到需要的无线网，关注“安信可科技”公众号，选择微信配网后输入密码；ESP8266配网成功，输出相关信息，之后需要关闭智能配网，释放内存，查看网络连接状态