单片机与物联网 / 系统课时
连接 Wi-Fi
连接 Wi-Fi
ESP32 连接无线网络时,最重要的是把“发起连接、等待状态、处理超时、读取 IP”连成一个可验证流程。本课使用 Arduino 的 WiFi API 建立 STA 连接,并通过串口确认连接结果和 DHCP 分配到的设备地址。
学习目标
- 配置 Wi-Fi 名称与密码并发起 STA 连接
- 使用
WiFi.status()判断是否已成功联网 - 读取本机 IP,并为连接超时保留失败处理路径
准备网络参数
连接前先确认所用 ESP32 型号支持目标无线网络的频段与安全方式,SSID 和密码也必须与接入点完全一致。示例把凭据写成占位符,实际开发时应替换为本地配置;如果项目进入版本控制,不要把真实密码提交到公共仓库。
串口监视器使用 115200 波特率。网络地址默认由路由器的 DHCP 服务分配,因此每次连接得到的 IP 可能不同。
建立 STA 连接
WiFi.mode(WIFI_STA) 把设备设为站点模式,WiFi.begin() 发起连接。不能只写一个无限 while 等待,因为密码错误、AP 不可达或信号过弱时,程序会永远卡在启动阶段。下面的完整示例给连接过程设置 15 秒超时。
#include <WiFi.h>
const char *WIFI_SSID = "<SSID>";
const char *WIFI_PASSWORD = "<PASSWORD>";
const unsigned long CONNECT_TIMEOUT_MS = 15000;
void connectWiFi() {
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
unsigned long startedAt = millis();
Serial.print("Connecting");
// 等待连接,但保留超时出口,避免启动流程永久阻塞。
while (WiFi.status() != WL_CONNECTED &&
millis() - startedAt < CONNECT_TIMEOUT_MS) {
delay(500);
Serial.print(".");
}
Serial.println();
if (WiFi.status() == WL_CONNECTED) {
Serial.println("Wi-Fi connected");
Serial.print("IP address: ");
Serial.println(WiFi.localIP());
} else {
Serial.printf(
"Wi-Fi connect timeout, status=%d\n",
(int)WiFi.status());
}
}
void setup() {
Serial.begin(115200);
delay(500);
connectWiFi();
}
void loop() {
}预期输出
Connecting.....
Wi-Fi connected
IP address: <IP><IP> 由当前网络分配,实际值可能不同。若 15 秒内没有连上,则程序会输出 Wi-Fi connect timeout, status=<VALUE>,其中 <VALUE> 是当时的连接状态码,而不是继续无限等待。
读取连接状态与地址
连接成功的判定条件是 WiFi.status() == WL_CONNECTED。取得这个状态后,再调用 WiFi.localIP() 读取本机地址,才能确认设备不仅完成了无线关联,而且已经获得可用于局域网通信的 IP。
后续如果 HTTP、MQTT 或 Socket 请求失败,应先重新检查 WiFi.status(),不要只依据之前打印过的 IP 判断“网络一定还在线”。无线连接可能因 AP 重启、距离变化或路由器切换而中断,联网功能应把连接状态视为动态条件。
处理连接失败
超时后先核对 SSID、密码和信号覆盖,再确认接入点没有启用当前设备不支持的认证方式。若串口一直进入超时分支,优先修正网络条件,而不是不断延长等待时间。
在需要长期运行的物联网设备中,可以把“重连”放到独立状态机或定时检查逻辑中,并限制重试频率,避免断网时形成高频循环。完成本课的最低验收标准是:串口明确显示连接成功,WiFi.status() 为已连接状态,并能打印一个有效的本机 IP 地址。