单片机与物联网 / 系统课时

连接 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 秒超时。

cpp
#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() {
}

预期输出

text
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 地址。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

连接 Wi-Fi

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通