ESP8266_01搭建开发环境
ESP8266_02程序的编译与下载
ESP8266_03SDK与Makefile的基本用法
ESP8266_04管脚控制与软件定时器
ESP8266_05 ESP8266有几个串口?
ESP8266_06硬件定时器与IO中断
ESP8266_07基于PWM的呼吸灯
ESP8266_08基于flash的数据掉电保护
ESP8266_09基于IIC控制的OLED屏幕
ESP8266_10 ESP8266的STATION模式
ESP8266_11 ESP8266的UDP广播
ESP8266_12 ESP8266客户端模式下的TCP通信
ESP8266_13服务器端模式下的TCP通信
ESP8266_14 SOFTAP模式下的服务器端和客户端
ESP8266_15天气预报之TCP的GET操作
ESP8266_16天气预报之JSON数据的生成与解析
ESP8266_17简单网络时间协议-SNTP
ESP8266_18 MQTT协议接入ONENET平台
ESP8266_19MQTT协议接入ONENET平台_订阅主题
ESP8266_20 基于ONENET平台的数据上传之TCP的POST操作
ESP8266_21基于ESP8266的一键配网
ESP8266_22基于自身ADC的电压采样
ESP8266_23基于硬件定时器的红外遥控器解码
上一节说了UDP,这一节就聊聊TCP,毕竟它俩经常同时出现。优缺点上一节也提了一下:安全性好,速度慢。
除了这两点,还有就是:
TCP通信之前是需要建立连接的,如同打电话之前先拨号一样,而UDP无连接;
TCP只能一对一通信,UDP不止一对一,还支持一对多;
TCP对系统资源要求更多,UDP相对少一些。
所以两者各有优缺点,大家在选择通信协议的时候一定要根据自己的实际情况来确定。
然后就是客户端,这是啥?和它伴随的,还有一个词经常出现,就是:服务器端。这两者又是什么关系?
基本上,这两者在TCP通信过程中,都是结伴出现的。以浏览器为例,它就是一个客户端,当我们想上网的时候,输入一个网址。浏览器会根据我们输入的网址向相应的服务器端发出请求,然后服务器端返回相应的网页给浏览器。这就是它们的应用场景之一。
所以,在TCP通信过程中,一般都是由客户端发起请求,服务器端相应请求。
那么,在windows/linux下,是如何进行这方面的编程的?步骤如下(参考百度):
TCP编程的服务器端一般步骤是:
1、创建一个socket,用函数socket();
2、设置socket属性,用函数setsockopt(); * 可选
3、绑定IP地址、端口等信息到socket上,用函数bind();
4、开启监听,用函数listen();
5、接收客户端上来的连接,用函数accept();
6、收发数据,用函数send()和recv(),或者read()和write();
7、关闭网络连接;
8、关闭监听;
TCP编程的客户端一般步骤是:
1、创建一个socket,用函数socket();
2、设置socket属性,用函数setsockopt();* 可选
3、绑定IP地址、端口等信息到socket上,用函数bind();* 可选
4、设置要连接的对方的IP地址和端口等属性;
5、连接服务器,用函数connect();
6、收发数据,用函数send()和recv(),或者read()和write();
7、关闭网络连接;
可以看到,从第四步开始,客户端和服务器端的工作内容有了不一样。
socket是啥?
简单来说,是个函数,用来创建套接字。
那么,套接字又是什么鬼?
为了防止本篇日志闲扯太多,我尽量简单说,根据字面意思,socket字面意思是(电源)插座,而套接字本质上是一种网络编程接口,用来完成两个应用程序之间的数据传输。你把设备插头插到电源插座上,设备通上电了,同理,你把应用程序的端口插到socket里,数据就通上了。
注:因为本人是硬件出身,所以对这些协议的理解全靠百度和工作积累,如果有表达错误的,欢迎指正。
这一节先在8266上面写一个客户端的程序,咱们看一下实现的效果。跟上一节一样,还是要借助一个网络调试助手。同时,本节代码都是在上一节基础上修改来的,所以,如果上一节看懂了,这一节就很好理解,反之,你懂的~
先说步骤,依然很多,参考上面提到的“TCP编程的客户端一般步骤”,这里大致分为7步:
1、包含头文件
#include "espconn.h"
#include "mem.h"
主要是"espconn.h",涉及到TCP通讯所需的各种数据结构。上一节已经包含了,可以略过。
2、设置工作模式为station+ soft-ap模式,并连接到当前环境下的wifi
因为前几步跟上一节一模一样,所以整合了一下:
wifi_set_opmode(0x03); // station+ soft-ap模式
struct softap_config config; //定义AP参数结构体,
wifi_softap_get_config(&config); //获取当前AP模式的参数
os_memcpy(config.ssid,"ESP8266",strlen("ESP8266")); //修改AP名称
os_memcpy(config.password,"123456789",strlen("123456789")); //修改AP密码
config.ssid_len=strlen("ESP8266"); //修改 AP名称的长度
wifi_softap_set_config(&config); //使修改后的参数生效
然后连到我家wifi,你们要改成你们家里或者办公室里的wifi。
3、确定TCP连接的参数
这里要确定几点:你是谁?你要和谁连接?连接的端口是多少?
你是谁——ESP8266,8266连接家里路由成功之后,会自动获得一个IP,这是客户端IP
你要和谁连接——因为是在我电脑上使用网络调试助手模拟TCP服务器端,所以服务器端的IP是我电脑的IP:192.168.1.103
连接的端口——长话短说,TCP连接的端口从0到65535都有,但一般0~1023是公有的,从1024开始往后,可以选为自己的端口。这里选1024.
struct ip_info info;
const char remote_ip[4]={192,168,1,103}; //TCP服务端IP
wifi_get_ip_info(STATION_IF,&info); //获取8266的WIFI信息
tcp_client_init((struct ip_addr *)remote_ip,&info.ip,1024);
4、TCP客户端初始化
其实就是第三步里面的tcp_client_init函数,咱们主要看一下函数内部实现的功能。首先是在client.h文件中定义了一个espconn格式的结构体:
struct espconn user_tcp_conn; //对应网络连接的结构体
然后在tcp_client_init函数中,对结构体的各个部分进行配置:
{
//TCP通信时,对应的espconn参数配置
user_tcp_conn.type=ESPCONN_TCP;
user_tcp_conn.state=ESPCONN_NONE;
user_tcp_conn.proto.tcp=(esp_tcp *)os_zalloc(sizeof(esp_tcp));
os_memcpy(user_tcp_conn.proto.tcp->local_ip,local_ip,4);
os_memcpy(user_tcp_conn.proto.tcp->remote_ip,remote_ip,4);
user_tcp_conn.proto.tcp->local_port=espconn_port();
user_tcp_conn.proto.tcp->remote_port=remote_port;
//注册连接回调函数和重连回调函数
espconn_regist_connectcb(&user_tcp_conn,user_tcp_connect_cb);
espconn_regist_reconcb(&user_tcp_conn,user_tcp_recon_cb);
//启用连接
espconn_connect(&user_tcp_conn);
}
函数中可以看到,espconn的参数设置完成之后,注册了两个回调函数,连接完成回调函数(连接完成以后,你想干嘛?)和重连回调函数(重连的时候,该咋办?):
espconn_regist_connectcb(&user_tcp_conn,user_tcp_connect_cb);
espconn_regist_reconcb(&user_tcp_conn,user_tcp_recon_cb);
最后,开始TCP连接:
espconn_connect(&user_tcp_conn); //连接TCP server,连接成功返回0.
5、定义连接成功的回调函数
void ICACHE_FLASH_ATTR user_tcp_connect_cb(void *arg){
struct espconn *pespconn=arg;
espconn_regist_recvcb(pespconn,user_tcp_recv_cb);
espconn_regist_sentcb(pespconn,user_tcp_sent_cb);
espconn_regist_disconcb(pespconn,user_tcp_discon_cb);
espconn_sent(pespconn,"hello,this is esp8266!",strlen("hello,this is esp8266!"));
}
函数内部进行了几个操作:
注册接收完成的回调函数:接收完成以后,你想做点啥~
注册发送完成的回调函数:发送完成以后,你想做点啥~
注册断开TCP连接的回调函数:断开TCP连接以后,你想做点啥~
TCP连接下,发送数据:hello,this is esp8266!
6、定义user_tcp_connect_cb函数内部注册的回调函数
这里先说一下,基本上从上一节开始,代码的编写就进入了回调函数套回调函数的情形。如果是没接触过回调函数的,刚开始看肯定有些别扭。但如果适应以后,你会发现这样操作还是很方便的。
因为每个回调函数,在手册里都有说明,功能、参数、返回值,都很清晰。基本上只要看着手册和官方SDK里的例程,大部分问题都能解决。
//接收完成回调函数,把收到的数据打印出来,延时,断开连接
void ICACHE_FLASH_ATTR user_tcp_recv_cb(void *arg,
char *pdata,
unsigned short len){
os_printf("receive data:%s\r\n",pdata);
os_delay_us(300);
espconn_disconnect((struct espconn *)arg);
}
//发送完成回调函数,打印发送完成标志
void ICACHE_FLASH_ATTR user_tcp_sent_cb(void *arg){
os_printf("send success!");
}
//断开TCP连接的回调函数,打印相关信息
void ICACHE_FLASH_ATTR user_tcp_discon_cb(void *arg){
os_printf("disconnect success!");
}
7、定义TCP重连的回调函数
在第4步里注册了两个回调函数,一个是连接成功的回调函数,第5步已经说了。另一个就是重连的回调函数:
//如果连接错误,打印一下故障码,然后重新连接
void ICACHE_FLASH_ATTR user_tcp_recon_cb(void *arg, sint8 err){
os_printf("error,error code is%d\r\n",err);
espconn_connect((struct espconn *)arg);
}
好,到此为止,程序修改完毕。
注:本例程里提到的大部分函数,都参照手册2c-esp8266_sdk_api_guide_cn_v1.5.4。
再说一点,很多函数定义的时候,后面会跟一个参数:void *arg,这是什么?
以第5步里注册回调函数为例:
espconn_regist_recvcb(pespconn,user_tcp_recv_cb);
注册了user_tcp_recv_cb函数,这个函数在定义的时候就有如下几个参数
(void *arg,char *pdata,unsigned short len)
从哪来的?
打开手册2c-esp8266_sdk_api_guide_cn_v1.5.4,查找espconn_regist_recvcb函数,可以看到如下说明;
其中的espconn_recv_callback,咱们继续向下找:
至此,可以看到相关参数已经在回调函数的格式里定义好了,咱们只需要照着写就行。
程序修改完成,保存、清理、编译、下载一条龙,然后重新上电。这里,需要借助串口助手和网络调试助手两个工具来查看效果。效果如下所示:
设置网络调试助手:
可以看到,在网络调试助手上,分别显示了client上线的时间和发来的数据。如果这时候咱们手动给client发一个数据:mcu lover。
可以在串口助手上看到:
显示了收到的数据,最后断开TCP连接。
至此,TCP客户端通信说完了。还是希望大家多动手,毕竟这类东西要动手才有收获。后面会说一下TCP服务器端的用法(跟这个差不多),然后是POST和GET的用法,再然后,就可以根据GET,搞一个天气预报的小应用,相信很多人会比较感兴趣。
这篇日志写的比较痛苦,因为我是从一个硬件工程师的视角去说这些东西,所以希望跟我类似的人能比较好的理解日志中出现的这些网络协议。因为通常来说,搞硬件的就是搞硬件,画画PCB、搞搞焊接、给单片机写写程序,甚至再写一写上位机,在linux下写一些应用。至于说整天研究TCP/UDP,或者POST、GET,比较少,或者说不算硬件工程师/单片机工程师的范畴了。
但是物联网芯片的出现打破了这一屏障,它小巧,单片机级别的资源就能应用;但它又强大,可以联网,实现各种网络通信。所以,我们要不停的学习,千万不要自我满足。