跳到主要内容

C2 自带 WiFi TCP Client 通信

注意：仅 C2 内部自带Wifi功能，C1内部自带的是蓝牙功能所以不适合本教程。

一、本例程实现功能​

通过内部WiFi和指定的服务器建立TCP连接，内部WiFi每5秒向服务器发送一个数据包(5字节)，服务器每1秒钟向内部WiFi发送一个数据包(10字节)。

本例程只是一个简单的示例，开发者可以基于本例程提供的代码做一些简单的修改，实现自己的TCP通。

二、 Core提供的TCP功能介绍​

Core已将TCP的操作封装成三个简单的API函数，分别为：LIB_IntWifiTcpConfig()，LIB_IntWifiTcpRecv()，LIB_IntWifiTcpSend()。您只需要调用这三个API即可将内部WiFi连接上路由器并实现和server端的收发数据。并且Core会自动处理通信中的异常情况并尝试重新恢复通信（比如和路由器的连接异常断开，和server的tcp连接异常断开，网络异常等），您无需考虑这些复杂的情况即可实现WIFI长期稳定的在线通讯。

三、接线图​

无需任何接线图，ShineBlink C2 Mini开发板上的C2芯片自带Wifi功能。

C2MinI

四、材料清单​

名称推荐购买链接（或者您可以自己制作）模块/芯片硬件资料下载
路由器Ap无无
声明：这里推荐的购买链接仅供参考，您完全可以去其他商家或渠道购买，只要功能相似即可。

五、完整代码（通过IP地址和服务器建立连接）​

通过内部WiFi和指定的服务器建立TCP连接，内部WiFi每5秒向服务器发送一个数据包(5字节)，服务器每1秒钟向内部WiFi发送一个数据包(10字节)。

server_addr = "192.168.1.101" --这里也可以直接写服务器的域名，比如"www.shineblink.com"等
server_port = 8080
ap_ssid = "mywifi" --路由器账号
ap_passwd = "abc123" --路由器密码
--配置USB以虚拟串口模式工作，这样调用print()函数就会在电脑串口终端打印输出
LIB_UsbConfig("CDC")
--使能系统10毫秒定时器开始工作
LIB_10msTimerConfig("ENABLE")
--设置内部WiFi以TCP Client模式工作
--路由器账号:mywifi 路由器密码:abc123，服务器ip:192.168.1.101 端口号:8080
--心跳包间隔时间0秒(不使用心跳机制)。如果需要使用请在ApiDoc文档中查阅关于LIB_IntWifiTcpConfig函数的p5参数详细介绍
LIB_IntWifiTcpConfig(ap_ssid,ap_passwd,server_addr,server_port,0)
--变量初始化
cnt_10ms = 0
send_tab = {1,2,3,4,5} --需要发送给server端的数据
--定义10ms中断回调函数
function LIB_10msTimerCallback()
    cnt_10ms = cnt_10ms + 1
end
--开始大循环
while(GC(1) == true)
do
	--查询是否收到server下发的数据，如果收到就print输出收到的数据
	recv_flag,recv_tab = LIB_IntWifiTcpRecv()
	if recv_flag == 1 then
		print(string.format("tcp client receive %d bytes", #recv_tab))
		for k,v in ipairs(recv_tab) do
			print(k,v)
		end
	end
	--每5秒发送一包数据给server
	if cnt_10ms >= 500 then  --5000ms
		cnt_10ms = 0
		LIB_IntWifiTcpSend(send_tab)
	end
end
如果感兴趣，上面代码中出现的LIB开头的库函数可以在 API文档 中通过Ctrl+F查询。

代码运行结果​

这里我们在局域网内的一台电脑(192.168.1.101)上运行《网络调试助手》软件模拟Tcp Server端进行调试。

（1）Server端数据接收如下：

result1

（2）Client端(Core)数据接收如下：

result2

六、外网TCP测试​

47.92.146.210, 端口号：8888

以上地址运行着一个简单的TCP服务，通过和它建立TCP连接后，向它发送什么它就回复什么，开发者可以用来测试自己的TCP代码，该服务器仅用来测试用，不保证其一直可靠可用。