UDP 客户端

UIFLOW2 应用示例

简单客户端

在 UiFlow2 中打开 cores3_udp_client_example.m5f2 项目。

此示例创建一个向服务器发送数据的 UDP 客户端。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

简单客户端

此示例创建一个向服务器发送数据的 UDP 客户端。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import network
import socket
import time


title0 = None
label0 = None
label1 = None
label2 = None
label3 = None
label4 = None
label5 = None
label6 = None
label7 = None
label8 = None
label9 = None
wlan = None
udpc = None


count = None
resp = None


def setup():
    global \
        title0, \
        label0, \
        label1, \
        label2, \
        label3, \
        label4, \
        label5, \
        label6, \
        label7, \
        label8, \
        label9, \
        wlan, \
        udpc, \
        count, \
        resp

    M5.begin()
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title("UDP Clinet", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu24)
    label0 = Widgets.Label("Local IP:", 4, 32, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label1 = Widgets.Label("Server IP:", 4, 60, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label2 = Widgets.Label("Server Port:", 4, 88, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label3 = Widgets.Label("Send:", 4, 116, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label4 = Widgets.Label("Recv:", 4, 144, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label5 = Widgets.Label("label5", 136, 32, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label6 = Widgets.Label("label6", 136, 60, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label7 = Widgets.Label("label7", 136, 88, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label8 = Widgets.Label("label8", 136, 118, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label9 = Widgets.Label("label9", 136, 144, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    wlan = network.WLAN(network.STA_IF)
    wlan.active(True)
    udpc = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
    udpc.connect(("192.168.8.236", 8000))
    count = 0
    label5.setText(str(wlan.ifconfig()[0]))
    label6.setText(str("192.168.8.236"))
    label7.setText(str("8000"))


def loop():
    global \
        title0, \
        label0, \
        label1, \
        label2, \
        label3, \
        label4, \
        label5, \
        label6, \
        label7, \
        label8, \
        label9, \
        wlan, \
        udpc, \
        count, \
        resp
    M5.update()
    udpc.send(str(count))
    time.sleep_ms(100)
    resp = udpc.recv(1024)
    label8.setText(str(count))
    label9.setText(str(resp))
    count = (count if isinstance(count, (int, float)) else 0) + 1
    time.sleep(1)


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

socket.socket()

socket.connect(address)

创建一个套接字对象并连接到服务器。

参数:: address (tuple) – 包含服务器 IP 地址和端口号的元组。
返回:: 一个套接字对象。
返回类型:: socket.socket

UiFlow2 代码块：

MicroPython 代码块：

import socket

udpc = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
udpc.connect(('192.168.8.236', 8000))

socket.close()

关闭套接字连接。

UiFlow2 代码块：

MicroPython 代码块：

udpc.close()

socket.recv(bufsize)

从套接字接收数据。

参数:: bufsize (int) – 一次可接收的最大数据量。
返回:: 接收到的数据。
返回类型:: bytes

UiFlow2 代码块：

MicroPython 代码块：

data = udpc.recv(1024)
print(data)

socket.read()

Read data from the socket.

返回:: 接收到的数据。
返回类型:: bytes

UiFlow2 代码块：

MicroPython 代码块：

data = udpc.read()
print(data)

socket.send(data)

向套接字发送数据。该套接字必须连接到远程套接字。

参数:: data (bytes | str) – The data to be sent.
返回:: 已发送的字节数。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

udpc.send(b'Hello, World!')
udpc.send('Hello, World!')

socket.write(data)

将字节缓冲区写入套接字。此函数将尝试将所有数据写入套接字（无“短写入”）。不过，对于非阻塞套接字，这可能无法实现，并且返回的值将小于 buf 的长度。

参数:: data (bytes | str) – The data to be sent.
返回:: 已发送的字节数。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

udpc.write(b'Hello, World!')
udpc.write('Hello, World!')

socket.setsockopt(level, optname, value)

设置给定套接字选项的值。所需的符号常量在套接字模块中定义（SO_* 等）。该值可以是整数或表示缓冲区的字节类对象。

参数:

level (int) – 定义选项的级别。
optname (int) – 要设置的选项的名称。
value – 为选项设置的值。

UiFlow2 代码块：

MicroPython 代码块：

udpc.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 0)
udpc.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)