10 - UDP实验

在本章节中，我们将采用 network 与 socket 这两个第三方库来构建UDP网络连接的功能。具体而言，network 库将被应用于WiFi连接的建立，而 socket 库则基于 lwIP 协议栈来实现网络协议的连接。在实验环节，我们将利用 ESP32 开发板与远程网络进行连接，并在此基础上进一步实施 UDP 连接的实现。本次实验的核心目标，在于构建一个基础的 UDP 连接机制，使其能够通过网络调试助手发送数据，并准确无误地将接收到的数据回传至发送端。

本节课目标：

在本次实验中，我们将ESP32开发板与WiFi网络连接，并配置实现UDP连接。核心任务是构建稳固的UDP连接机制，确保通过网络调试助手发送数据，并能准确回传接收数据，验证UDP连接的可靠性和有效性。

本节课内容：

1. network 与 socket 库的简介
2. network库的构造与方法
3. socket 库的构造与方法
4. 硬件设计
5. 软件设计
6. 下载验证

一、network 与 socket 库的简介

MicroPython 的 network 库与 socket 库皆为实现网络连接的重要工具，它们各自拥有独特的功能性并共享某些共通特点。

作为 MicroPython 的一个关键第三方库，network 库专门负责处理 WiFi 和网络连接的各项任务。通过此库，用户能够成功接入无线网络，查询当前网络状态，以及实现数据的收发等功能。在 MicroPython 的架构下，network 库扮演着促进设备间网络连接与通信的核心角色。

至于 network 库与 socket 库之间的主要差异，则体现在它们的应用场景与功能侧重上。具体而言，network 库侧重于设备的 WiFi 和基础网络连接功能的实现，而 socket 库则聚焦于高级网络协议的连接建立与数据传输过程。因此，在实际进行网络连接功能的设计与实施时，需根据具体需求及所依赖的硬件平台，谨慎选择并合理运用相应的库资源。

下面是MicroPython库的network 与 socket 库的链接。

network — 网络配置 — MicroPython latest documentation

socket – 套接字模块 — MicroPython latest documentation

类 WLAN – 控制内置 WiFi 接口 — MicroPython 最新文档

二、network.WLAN类的构造与方法

1. network.WLAN类的构造

构造对象方法如下：

class network.WLAN(interface_id)

使用示例：wlan = network.WLAN(network.STA_IF)

参数描述如下：

参数	描述
interface_id	支持接口 network.STA_IF：作为客户端，连接其他的服务器 network.AP_IF：作为服务器，其他WiFi客户端连接

返回值：WLAN网络接口对象

2. network.WLAN类的方法

（1）激活或停用网络接口

其方法原型如下：

WLAN.active(is_active[ ])

参数描述如下：

参数	描述
is_active	True：激活 False：作为服务器，其他WiFi客户端连接

返回值：无

（2）连接网络

其方法原型如下：

WLAN.connect(ssid=None, password=None)

参数描述如下：

参数	描述
ssid	WiFi账号
password	WiFi密码

返回值：Ture：连接成功；Fail：连接失败。

（3）关闭网络

其方法原型如下：

WLAN.disconnet()

返回值：无

（4）获取或者设置网络参数

其方法原型如下：

WLAN.ifconfig((ip, subnet, gateway, dns)[])

参数描述如下：

参数	描述
ip	IP地址
subnet	子网掩码
gateway	网关
dns	DNS服务器

返回值：若此函数为无参数传入，则返回连接网络的信息，反次，为设置网络参数。

以上是 network.WLAN 类常用的方法，还有其他方法可参考 MicroPython 的在线文档。

三、socket 库的构造与方法

1. socket类的构造

构造对象方法如下：

class socket.socket(af=AF_INET, type=SOCK_STREAM, proto=IPPROTO_TCP, /)

使用示例：socket = socket.socket(socket.AF_INET,socket.SOCK_DGRAM)

参数描述如下：

参数	描述
af	地址族 socket_AF_INET：IPV4 socket_AF_INET6：IPV6
type	socket类型 socket.SOCK_STREAM：TCP类型 socket.SOCK_DGRAM：UDP类型
proto	网络协议 socket.IPPROTO_TCP：TCP协议 socket.IPPROTO_UDP：UDP协议

返回值：socket对象

2. socket类的方法

（1）关闭socket接口

其方法原型如下：

socket.close()

返回值：无

（2）socket绑定到地址

其方法原型如下：

socket.bind(address)

参数描述如下：

参数	描述
address	IP地址（字符串形式输入，如‘192.168.1.100’）

返回值：无

（3）监听连接

用作于 TCPServer 连接。

其方法原型如下：

socket.listen(backlog[])

参数描述如下：

参数	描述
backlog	监听连接数量

返回值：无

（4）接受连接

用作于 TCPServer 连接。注：在此之前，需监听连接

其方法原型如下：

socket.accept()

返回值：conn：新的套接字对象，用来收发消息；address：连接到服务器的客户端地址。

（5）连接远程IP地址

其方法原型如下：

socket.connect(address)

参数描述如下：

参数	描述
address	IP地址（字符串形式输入，如‘192.168.1.100’）

返回值：无

（6）发送数据，返回发送的字节数

其方法原型如下：

socket.send(bytes)

参数描述如下：

参数	描述
bytes	需发送的字节数据

返回值：发送的数据字节数。

（7）接收数据，返回值是一个字节对象

其方法原型如下：

socket.recv(bufsize)

参数描述如下：

参数	描述
bufsize	接收数据的存储区

返回值：接收数据字节对象。

（8）接收数据，返回值是一个字节对象

其方法原型如下：

socket.recvfrom(bufsize)

参数描述如下：

参数	描述
bufsize	接收数据的存储区

返回值：bytes：接收数据字节对象；addressa：套接字发送的地址数据。

（9）UDP发送数据，一般用于UDP连接

其方法原型如下：

socket.sendto(bytes, address)

参数描述如下：

参数	描述
bytes	发送的数据
address	发送至哪个远程IP地址

返回值：发送的数据字节数。

以上方法列出了本书中常用的套接字方法，对于剩余的套接字方法，请参考MicroPython最新的在线文档。

四、硬件设计

例程功能

在本次实验中，我们将ESP32开发板与WiFi网络连接，并配置实现UDP连接。核心任务是构建稳固的UDP连接机制，确保通过网络调试助手发送数据，并能准确回传接收数据，验证UDP连接的可靠性和有效性。

硬件资源

• WIFI ：ESP32内部自带WIFI模块

四、软件设计

程序流程图

程序

import network
import socket


def do_connect():
    """
    WIFI 连接函数
    """
    wlan = network.WLAN(network.STA_IF)  # 构建 wlan 对象
    wlan.active(True)  # 开启WIFI

    if not wlan.isconnected():
        print('connecting to network...')
        wlan.connect('OrayBox-zsf', '123456789')          # 连接到WIFI路由器上
        while not wlan.isconnected():
            pass

    print('network config:', wlan.ifconfig())                           # 打印网络参数


# 1、WIFI 网络连接
do_connect()

# 2、创建 UDP 套接字
udp_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

# 3、UDP【查看自己测试电脑在同一 WIFI 下的地址，本测试电脑 IP 为'10.168.1.164'】
# 10.168.1.164

# 4、发送实验信息，通过UDP协议，与电脑的网络助手通信， 网络助手UDP配置参数为：IP：'10.168.1.164'  端口：8080
udp_socket.sendto('**************** UDP CONNECT TEST******************\r\n'.encode("utf-8"), ('10.168.1.164', 8080))


# 5、循环发送接收到的服务器数据
while True:
    # UDP 接收到的数据，及服务器 IP 和 端口号
    data, addr = udp_socket.recvfrom(4096)
    print(data, addr)
    udp_socket.sendto(data, (addr[0], addr[1]))

五、下载验证

将ESP32开发板与电脑通过WIFI路由器，连接在同一WiFi网络中，配置电脑上的网络调试助手UDP参数，如下图所示，并打开网络。

注意：ESP32程序中UDP发送目标IP和端口信息，按网络调试助手输入，如下图所示。

运行ESP32程序，网络调试助手会接收到ESP32的网络信息【10.168.1.139:50367】，设备网络调试助手远程主机地址信息，如下图所示。

与ESP32通过UDP协议相互通信。【UDP 通信有丢包的现象】