数据证书下载

!
!
版本1.
3版权2017ESP8266AT指令使用示例关于本手册本文档提供ESP8266_NONOS_SDK的AT指令使用示例.
文档结构如下:发布说明文档变更通知用户可通过乐鑫官网订阅技术文档变更的电子邮件通知.
证书下载用户可通过乐鑫官网下载产品证书.
章标题内容第1章概述介绍AT固件及使用配置第2章单连接TCPClient示例ESP8266作为TCPClient建立单连接通信第3章UDP传输示例如何建立UDP通信第4章透传示例如何进行透传通信第5章多连接TCPServer示例ESP8266作为TCPServer通信第6章问题反馈AT指令相关问题的反馈途径与方式.
日期版本发布说明2017.
08V1.
3文档格式更新.
目录1.
概述12.
单连接TCPClient23.
UDP传输43.
1.
固定远端的UDP通信43.
2.
远端可变的UDP通信64.
透传84.
1.
TCPClient单连接透传84.
2.
UDP透传105.
多连接TCPServer126.
问题反馈14!
1.
概述1.
概述本文档提供ESP8266_NONOS_SDK的AT指令的几种常见使用示例,更多AT指令说明请参考文档ESP8266_AT_Instruction_Set.
下载ESP8266ATBin:http://www.
espressif.
com/en/support/download/at-参考README.
md进行烧录PC串口工具,用于向ESP8266发送AT指令-波特率设置为115200-AT指令要求以新行(CRLF)结尾,串口工具应支持"新行模式"注意:AT指令必须为大写英文字母.
Espressif!
/!
1152017.
08!
2.
单连接TCPClient2.
单连接TCPClient1.
配置WiFi模式AT+CWMODE=3softAP+stationmode响应:OK2.
连接路由器AT+CWJAP="SSID","password"SSIDandpasswordofrouter响应:OK3.
查询ESP8266设备的IP地址AT+CIFSR响应:+CIFSR:APIP,"192.
168.
4.
1"+CIFSR:APMAC,"1a:fe:34:a5:8d:c6"+CIFSR:STAIP,"192.
168.
3.
133"+CIFSR:STAMAC,"18:fe:34:a5:8d:c6"OK4.
PC与ESP8266设备连接同一路由器,在PC端使用网络调试工具,建立一个TCP服务器.
-假设,PC创建的服务器IP地址为192.
168.
3.
116,端口为8080.
5.
ESP8266设备作为TCPclient连接到上述服务器AT+CIPSTART="TCP","192.
168.
3.
116",8080//protocol,serverIPandport响应:OK6.
ESP8266设备向服务器发送数据AT+CIPSEND=4//setdatelengthwhichwillbesent,suchas4bytes>testenterthedata,noCR响应:Recv4bytesEspressif!
/!
2152017.
08!
2.
单连接TCPClientSENDOK7.
当ESP8266设备接收到服务器发来的数据,将提示如下信息:+IPD,n:xxxxxxxxxx//receivednbytes,data=xxxxxxxxxxx注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
Espressif!
/!
3152017.
08!
3.
UDP传输3.
UDP传输UDP传输不区分server或者client,由指令AT+CIPSTART建立传输.
1.
配置WiFi模式AT+CWMODE=3softAP+stationmode响应:OK2.
连接路由器AT+CWJAP="SSID","password"SSIDandpasswordofrouter响应:OK3.
查询ESP8266设备的IP地址AT+CIFSR响应:+CIFSR:APIP,"192.
168.
4.
1"+CIFSR:APMAC,"1a:fe:34:a5:8d:c6"+CIFSR:STAIP,"192.
168.
101.
133"+CIFSR:STAMAC,"18:fe:34:a5:8d:c6"OK4.
PC与ESP8266设备连接同一路由器,在PC端使用网络调试工具,建立一个UDP传输.
-假设,PC创建的UDP自身IP地址为192.
168.
101.
116,端口为8080.
5.
后文将基于前述步骤,介绍两种UDP通信的示例.
3.
1.
固定远端的UDP通信UDP通信的远端固定,由AT+CIPSTART指令的最后一个参数设置为0决定.
系统将分配一个连接号给这个固定连接,UDP通信双方不会被其他设备替代.
1.
使能多连接AT+CIPMUX=1响应:Espressif!
/!
4152017.
08!
3.
UDP传输OK2.
创建UDP传输.
例如,分配连接号为4,指令如下:AT+CIPSTART=4,"UDP","192.
168.
101.
110",8080,1112,0响应:4,CONNNECTOK3.
发送数据AT+CIPSEND=4,7//Send7bytestotransmissionNO.
4>UDPtestenterthedata,noCR响应:Recv7bytesSENDOK4.
接收数据.
当ESP8266设备接收到服务器发来的数据,将提示如下信息:+IPD,4,n:xxxxxxxxxx//receivednbytes,data=xxxxxxxxxxx5.
断开UDP传输AT+CIPCLOSE=4响应:4,CLOSEDOK说明:示例指令中的参数说明如下:"192.
168.
101.
110",8080为UDP传输的远端IP和端口,即前文步骤4中PC建立的UDP端口;1112为ESP8266本地的UDP端口,用户可自行设置,如不设置则为随机值;0表示当前UDP传输建立后,UDP远端不会被其他设备更改;即使有其他设备通过UDP协议发数据到ESP8266UDP端口1112,ESP8266的第4号UDP传输的远端也不会被替换,使用指令"AT+CIPSEND=4,X"发送数据,仍然是当前固定的PC端收到.
注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
Espressif!
/!
5152017.
08!
3.
UDP传输3.
2.
远端可变的UDP通信当使用AT+CIPSTART指令创建UDP通信,将最后一个参数设置为2时,UDP通信的远端可改变.
1.
创建UDP传输.
AT+CIPSTART="UDP","192.
168.
101.
110",8080,1112,2响应:CONNNECTOK2.
发送数据AT+CIPSEND=7//Send7bytes>UDPtestenterthedata,noCR响应:Recv7bytesSENDOK3.
发送数据到其他指定远端.
例如,发数据到192.
168.
101.
111,端口1000.
AT+CIPSEND=7,"192.
168.
101.
111",1000//Send7bytes>UDPtestenterthedata,noCR响应:Recv7bytesSENDOK说明:示例指令中的参数说明如下:"192.
168.
101.
110",8080为UDP传输的远端IP和端口,即前文PC建立的UDP端口;1112为ESP8266本地的UDP端口,用户可自行设置,如不设置则为随机值;2表示当前UDP传输建立后,UDP传输远端仍然会更改;UDP传输远端会自动更改为最近一个与ESP8266UDP通信的远端.
注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
Espressif!
/!
6152017.
08!
3.
UDP传输4.
接收数据.
当ESP8266设备接收到服务器发来的数据,将提示如下信息:+IPD,n:xxxxxxxxxx//receivednbytes,data=xxxxxxxxxxx5.
断开UDP传输AT+CIPCLOSE响应:CLOSEDOKEspressif!
/!
7152017.
08!
4.
透传4.
透传ESP8266AT默认仅在TCPclient单连接或UDP传输模式时,支持透传.
4.
1.
TCPClient单连接透传以下为ESP8266作为station实现TCPclient单连接透传的举例,ESP8266作为softAP可同理实现透传.
1.
配置WiFi模式AT+CWMODE=3softAP+stationmode响应:OK2.
连接路由器AT+CWJAP="SSID","password"SSIDandpasswordofrouter响应:OK3.
查询ESP8266设备的IP地址AT+CIFSR响应:+CIFSR:APIP,"192.
168.
4.
1"+CIFSR:APMAC,"1a:fe:34:a5:8d:c6"+CIFSR:STAIP,"192.
168.
3.
133"+CIFSR:STAMAC,"18:fe:34:a5:8d:c6"OK4.
PC与ESP8266设备连接同一路由器,在PC端使用网络调试工具,建立一个TCP服务器.
-假设,PC创建的服务器IP地址为192.
168.
3.
116,端口为8080.
5.
ESP8266设备作为TCPclient连接到上述服务器AT+CIPSTART="TCP","192.
168.
3.
116",8080//protocol,serverIPandport响应:OKEspressif!
/!
8152017.
08!
4.
透传6.
使能透传模式AT+CIPMODE=1响应:OK7.
ESP8266设备向服务器发送数据AT+CIPSEND>//Fromnowon,datareceivedfromUARTwillbetransmittedtoserverautomatically.
8.
退出发送数据:在透传发送数据过程中,若识别到单独的一包数据"+++",则退出透传发送.
-如果使用键盘打字输入"+++",可能耗时太长,不被认为是连续的三个"+",建议使用串口工具一次性发送"+++",并请注意不要携带空格或换行符等不可见字符.
-之后,请至少间隔1秒,再发下一条AT指令.
9.
退出透传模式AT+CIPMODE=0响应:OK10.
断开TCP连接AT+CIPCLOSE响应:CLOSEDOK注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
注意:"+++"退出透传发送数据,回到正常AT指令模式.
此时,TCP连接仍然是保持的,可以再发AT+CIPSEND指令,重新开始透传.
Espressif!
/!
9152017.
08!
4.
透传4.
2.
UDP透传以下为ESP8266作为softAP实现UDP透传的举例,ESP8266作为station可同理实现透传.
1.
配置WiFi模式AT+CWMODE=3softAP+stationmode响应:OK2.
PC连入ESP8266softAP3.
在PC端使用网络调试工具,建立一个UDP传输.
-假设,PC创建的UDP自身IP地址为192.
168.
4.
2,端口为1001.
4.
ESP8266与PC对应端口建立固定对端的UDP传输AT+CIPSTART="UDP","192.
168.
4.
2",1001,2233,0响应:OK5.
使能透传模式AT+CIPMODE=1响应:OK6.
ESP8266设备向服务器发送数据AT+CIPSEND>//Fromnowon,datareceivedfromUARTwillbetransmittedtoserverautomatically.
Espressif!
/!
10152017.
08!
4.
透传7.
退出发送数据:在透传发送数据过程中,若识别到单独的一包数据"+++",则退出透传发送.
-如果使用键盘打字输入"+++",可能耗时太长,不被认为是连续的三个"+",建议使用串口工具一次性发送"+++",并请注意不要携带空格或换行符等不可见字符.
-之后,请至少间隔1秒,再发下一条AT指令.
8.
退出透传模式AT+CIPMODE=0响应:OK9.
断开TCP连接AT+CIPCLOSE响应:CLOSEDOK注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
注意:"+++"退出透传发送数据,回到正常AT指令模式.
此时,TCP连接仍然是保持的,可以再发AT+CIPSEND指令,重新开始透传.
Espressif!
/!
11152017.
08!
5.
多连接TCPServer5.
多连接TCPServerESP8266AT仅支持建立一个TCP服务器,且必须使能多连接,即允许连接多个TCPclient.
以下为ESP8266作为softAP,建立TCP服务器的举例;如果是ESP8266作为station,可在连接路由后,同理建立服务器.
1.
配置WiFi模式AT+CWMODE=3softAP+stationmode响应:OK2.
使能多连接AT+CIPMUX=1响应:OK3.
建立TCPserverAT+CIPSERVER=1//defaultport=333响应:OK4.
PC连入ESP8266softAP5.
在PC端使用网络调试工具,建立一个TCPclient,连接ESP8266的TCPserver.
Espressif!
/!
12152017.
08!
5.
多连接TCPServer6.
发送数据//IDnumberofconnectionisdefaultedtobe0.
AT+CIPSEND=0,4//send4bytestoconnectionNO.
0>testenterthedata,noCR响应:Recv4bytesSENDOK7.
接收数据.
当ESP8266设备接收到服务器发来的数据,将提示如下信息:+IPD,0,n:xxxxxxxxxx//receivednbytes,data=xxxxxxxxxxx8.
断开UDP传输AT+CIPCLOSE=0响应:0,CLOSEDOK注意:ESP8266作为TCPserver有超时机制,如果连接建立后,一段时间内无数据来往,ESP8266TCPserver会将TCPclient踢掉.
因此,请在PCTCPclient连上ESP8266TCPserver后建立一个2s的循环数据发送,用于保持连接.
注意:发送数据时,如果输入的字节数超过了设置长度(n):-系统将提示busy,并发送数据的前n个字节,发送完成后响应SENDOK.
-超出长度的部分数据被认为是无效数据,不被接受.
Espressif!
/!
13152017.
08!
6.
问题反馈6.
问题反馈如遇到AT使用异常,请发邮件至乐鑫技术支持,附上如下信息:AT软件的版本号,指令AT+GMR可获取版本信息;硬件模块的信息,例如:ESP-WROOM-02;详细的测试步骤说明,例如:AT+CWMODE_CUR=1OKAT+GMRATversion:0.
23.
0.
0(Apr24201521:11:01)SDKversion:1.
0.
1compiletime:Apr24201521:19:31OKAT+CIPSTAMAC_DEF="14:CF:11:22:33:05"OK如能提供log打印信息,请附上异常log信息,例如以下截屏:etsJan82013,rstcause:1,bootmode:(3,3)load0x40100000,len26336,room16tail0chksum0xdeload0x3ffe8000,len5672,room8tail0chksum0x69load0x3ffe9630,len8348,room8tail4chksum0xcbcsum0xcbSDKversion:0.
9.
1addrnotackwhentxwritecmdmode:sta(18:fe:34:97:d5:7b)+softAP(1a:fe:34:97:d5:7b)Espressif!
/!
14152017.
08!
Espressif!
/!
15152017.
08免责申明和版权公告本文中的信息,包括供参考的URL地址,如有变更,恕不另行通知.
文档"按现状"提供,不负任何担保责任,包括对适销性、适用于特定用途或非侵权性的任何担保,和任何提案、规格或样品在他处提到的任何担保.
本文档不负任何责任,包括使用本文档内信息产生的侵犯任何专利权行为的责任.
本文档在此未以禁止反言或其他方式授予任何知识产权使用许可,不管是明示许可还是暗示许可.
Wi-Fi联盟成员标志归Wi-Fi联盟所有.
蓝牙标志是BluetoothSIG的注册商标.
文中提到的所有商标名称、商标和注册商标均属其各自所有者的财产,特此声明.
版权归2017乐鑫所有.
保留所有权利.
乐鑫IoT团队www.
espressif.
com