当前位置：首页 > news >正文

ESP32S3 链接到 WiFi

news 来源：原创 2025/6/17 16:02:25

以下是关于如何让 ESP32S3 连接到 WiFi 的完整流程和代码示例：

ESP32S3 链接到 WiFi

1. 设置工作模式

ESP32 可以工作在两种模式下：

Station (STA) 模式：作为无线终端连接到无线接入点（AP），类似于手机或电脑。
Access Point (AP) 模式：作为无线接入点，允许其他设备连接到它。

在本例中，我们将使用 Station 模式，让 ESP32 连接到无线路由器。

2. 查看官方文档

官方文档提供了详细的 WiFi 连接方法，文档地址：
Quick reference for the ESP32 — MicroPython latest documentation

3. SSID 和 BSSID

SSID：无线路由器的名称（手机上搜索到的 WiFi 名字）。
BSSID：无线路由器的 MAC 地址。
ESSID：与 SSID 类似，但可以有多个无线路由器共享同一个 ESSID。

4. 链接 WiFi 路由器

以下是官方提供的 WiFi 连接代码示例：

import network

# 创建 Station 模式的 WLAN 接口
wlan = network.WLAN(network.STA_IF)

# 激活接口
wlan.active(True)

# 扫描可用的无线接入点
print("Available networks:", wlan.scan())

# 连接到指定的 WiFi
wlan.connect('your_wifi_ssid', 'your_wifi_password')

# 等待连接成功
while not wlan.isconnected():
    pass

# 打印连接状态和 IP 地址
print('Connected to WiFi!')
print('Network config:', wlan.ifconfig())

注意：

当前的 ESP32S3 不支持 5G 路由器，建议使用 2.4G 路由器或手机热点。
如果连接失败，请检查 WiFi 名称和密码是否正确。

5. 测试网络连接

连接成功后，可以使用网络调试助手或简单的 UDP 示例代码测试网络连接。

5.1 网络调试助手

下载地址：
网络调试助手

5.2 UDP 示例代码

以下是一个简单的 UDP 客户端代码，用于测试网络连接：

from socket import *

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

# 设置目标地址（替换为你的目标 IP 和端口）
dest_addr = ('目标 IP 地址', 8080)

# 从键盘获取要发送的数据
send_data = "Hello from ESP32!"

# 发送数据
udp_socket.sendto(send_data.encode('utf-8'), dest_addr)

# 关闭套接字
udp_socket.close()

6. 调试和注意事项

检查 WiFi 名称和密码：确保输入的 SSID 和密码正确。
检查路由器支持的频段：ESP32S3 不支持 5G 路由器，建议使用 2.4G。
查看 IP 地址：连接成功后，可以通过 wlan.ifconfig() 查看 ESP32S3的 IP 地址。
网络调试助手：使用网络调试助手可以快速验证网络连接是否正常。

通过以上步骤，你可以成功让 ESP32S3 连接到 WiFi 并进行网络通信。如果需要更复杂的网络功能（如 HTTP 请求或 TCP 通信），可以参考 MicroPython 的官方文档或相关教程。

完整代码：

import network
import time
from socket import *

# 创建 Station 模式的 WLAN 接口
wlan = network.WLAN(network.STA_IF)

# 激活接口
wlan.active(True)

# 扫描可用的无线接入点
print("Available networks:", wlan.scan())

# 连接到指定的 WiFi
wlan.connect('CMCC-imYC', 'xkq6jrnd')

# 等待连接成功
while not wlan.isconnected():
    print('.',end = '')
    pass

# 打印连接状态和 IP 地址
print('Connected to WiFi!')
print('Network config:', wlan.ifconfig())

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

# 设置目标地址（替换为你的目标 IP 和端口）
dest_addr = ('192.168.1.28', 8080)

# 从键盘获取要发送的数据
send_data = "Hello from ESP32!"

# 发送数据
while True:
    time.sleep(0.5)  # 等待0.5秒
    udp_socket.sendto(send_data.encode('utf-8'), dest_addr)

# 关闭套接字
udp_socket.close()