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

创建配网页面

创建配网页面

首次使用设备时,用户往往不知道如何把 Wi-Fi 凭据写进固件。本课让 ESP32 同时开启热点和网页服务器,手机先连接设备热点,再通过表单提交目标 Wi-Fi 的 SSID 与密码,ESP32 收到后立即尝试加入该网络。

学习目标

  • 使用 WIFI_AP_STA 同时保留配置热点和站点连接能力
  • 用 WebServer 提供 Wi-Fi 配置表单并接收 POST 数据
  • 验证用户提交配置后 ESP32 能尝试连接目标网络

设计配网链路

最小配网方案包含四个对象:手机、ESP32 热点、ESP32 网页服务器和目标无线路由器。手机只负责把凭据提交给 ESP32;真正加入目标 Wi-Fi 的动作由 ESP32 的 STA 接口完成。

ESP32 热点配网页面的网络链路

本课先不实现自动跳转的强制门户,因为不同手机系统的网络探测规则不同。直接访问 ESP32 热点默认地址 192.168.4.1 更容易验证核心链路,也便于排查问题。

提供网页表单并接收配置

下面是一个完整 Arduino 示例。设备热点密码必须至少 8 个字符;提交表单后,ESP32 保持热点在线,同时使用 STA 接口尝试连接用户输入的网络。

cpp
#include <WiFi.h>
#include <WebServer.h>

const char* AP_SSID = "ESP32-Setup";
const char* AP_PASSWORD = "configure123";

WebServer server(80);
bool reportedConnected = false;

void handleRoot() {
  const char page[] =
      "<!doctype html><html><head>"
      "<meta charset='utf-8'>"
      "<meta name='viewport' content='width=device-width,initial-scale=1'>"
      "<title>ESP32 Wi-Fi 配置</title></head><body>"
      "<h2>连接 Wi-Fi</h2>"
      "<form method='POST' action='/save'>"
      "<label>SSID</label><br>"
      "<input name='ssid' maxlength='32' required><br><br>"
      "<label>密码</label><br>"
      "<input name='password' type='password' maxlength='64'><br><br>"
      "<button type='submit'>保存并连接</button>"
      "</form></body></html>";

  server.send(200, "text/html; charset=utf-8", page);
}

void handleSave() {
  String ssid = server.arg("ssid");
  String password = server.arg("password");

  if (ssid.length() == 0) {
    server.send(400, "text/plain; charset=utf-8", "缺少 SSID");
    return;
  }

  server.send(
      200,
      "text/html; charset=utf-8",
      "<h3>已接收配置,ESP32 正在连接目标 Wi-Fi。</h3>");

  // 不打印密码;热点继续工作,连接失败时用户仍可重新配置。
  Serial.print("[STA] connecting to ");
  Serial.println(ssid);
  reportedConnected = false;
  WiFi.begin(ssid.c_str(), password.c_str());
}

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_AP_STA);

  if (!WiFi.softAP(AP_SSID, AP_PASSWORD)) {
    Serial.println("[AP] start failed");
    return;
  }

  Serial.print("[AP] started, open http://");
  Serial.println(WiFi.softAPIP());

  server.on("/", HTTP_GET, handleRoot);
  server.on("/save", HTTP_POST, handleSave);
  server.begin();
}

void loop() {
  server.handleClient();

  if (WiFi.status() == WL_CONNECTED && !reportedConnected) {
    reportedConnected = true;
    Serial.print("[STA] connected, IP=");
    Serial.println(WiFi.localIP());
  }

  delay(2);
}

预期输出

text
[AP] started, open http://192.168.4.1
[STA] connecting to <SSID>
[STA] connected, IP=<IP>

<SSID> 是用户提交的网络名称,<IP> 是目标路由器分配给 ESP32 的地址,实际值会不同。浏览器首次打开页面时应看到 SSID、密码输入框和“保存并连接”按钮,提交后显示已接收配置的提示。

按步骤完成一次配网

烧录程序并打开串口监视器后,用手机搜索并连接 ESP32-Setup,密码为示例中的 configure123。浏览器访问 192.168.4.1,填写一个可用的 2.4 GHz Wi-Fi 网络并提交。串口出现 connected 和新的局域网地址,即说明表单到 STA 连接的链路已经打通。

如果表单能打开但连接失败,先确认目标网络名称和密码,再检查路由器是否提供 2.4 GHz 网络。配置热点仍然保留,因此可以直接重新提交,不必重新烧录固件。

处理凭据与产品化边界

示例只把凭据保存在内存中,设备重启后会丢失,这有利于先验证配网链路。产品中通常还要把配置安全地持久化,并提供清除配置和重新配网入口。

当你准备进一步提升体验时,可以增加扫描附近网络、连接结果查询和超时提示;只有需要手机自动弹出页面时,再引入 DNS 重定向与 captive portal 兼容逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建配网页面

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

登录哪都通