跳到主要内容

C2 自带 WiFi UDP 通信

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

UDP协议实现简单，有时我们仅需要在网络中和对端建立简单的数据通信，对数据收发的可靠性要求不是太高，或者我们在应用层会保证数据收发的可靠性时，我们可以采用UDP方式进行通信即可。

一、本例程实现功能​

通过UDP和指定的对端进行UDP通信，每5秒向对端发送一个数据包(5字节)，对端每3秒钟向本机发送一个数据包(8字节)。

对端的地址即可以是IP地址也可以是域名。

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

Core已将UDP的操作封装成三个简单的API函数，分别为：LIB_IntWifiUdpConfig()，LIB_IntWifiUdpRecv()，LIB_IntWifiUdpSend()。您只需要调用这三个API即可将Core和对端进行UDP收发数据。并且Core会自动处理通信中的异常情况并尝试重新恢复通信（比如和路由器的连接异常断开，模块自身异常等），您无需考虑这些复杂的情况即可实现WIFI长期稳定的在线通讯。

三、接线图​

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

C2MinI

四、材料清单​

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

五、完整代码（通过IP地址和对端进行UDP通信）​

通过内部WiFi和指定的对端进行UDP通信，每5秒向对端发送一个数据包(5字节)，对端每3秒钟向本机发送一个数据包(8字节)。

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

代码运行结果​

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

（1）电脑端(对端)数据接收如下：

result1

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

result2