WiFiManager项目：自定义AP热点名称与配置门户实践指南

概述

WiFiManager是一个流行的ESP8266/ESP32库，用于简化WiFi网络配置过程。本文将深入探讨如何自定义该库创建的接入点(AP)名称(SSID)，并分享配置门户的最佳实践。

自定义AP热点名称

在WiFiManager中，默认情况下创建的AP热点名称格式为"ESP32_XXXX"或类似形式。开发者可以通过以下两种方式自定义这个名称：

1. 直接修改启动参数： 在调用startConfigPortal()或autoConnect()时，直接传入自定义的SSID和密码：

   const char* customSSID = "MyDeviceAP";
   const char* customPassword = "12345678";
   wm.startConfigPortal(customSSID, customPassword);
   

2. 修改库源代码（不推荐）： 在WiFiManager.cpp文件中，可以找到默认AP名称生成的代码位置，直接修改为固定值。但这种方式不利于代码维护和升级。

配置门户的非阻塞实现

WiFiManager支持两种运行模式：

1. 阻塞模式：配置门户会阻止程序继续执行，直到完成配置或超时
2. 非阻塞模式：配置门户在后台运行，主循环继续执行

启用非阻塞模式的正确方法：

wm.setConfigPortalBlocking(false);

实用的配置门户管理技巧

1. 超时控制：

   wm.setConfigPortalTimeout(120); // 设置120秒超时
   

2. 检测门户状态：

   if(wm.getConfigPortalActive()) {
     // 配置门户正在运行
   }
   

3. 手动停止门户：

   wm.stopConfigPortal();
   

完整的实践示例

以下是一个结合按钮触发、LED状态指示和超时控制的完整实现：

#include <WiFiManager.h>

#define TRIGGER_PIN 0
#define LED_PIN 2

WiFiManager wm;

void setup() {
  pinMode(TRIGGER_PIN, INPUT_PULLUP);
  pinMode(LED_PIN, OUTPUT);
  
  wm.setConfigPortalTimeout(120);
  wm.setConfigPortalBlocking(false);
  wm.autoConnect("MyDeviceAP", "12345678");
}

void loop() {
  static uint32_t lastTrigger = 0;
  
  // 检测长按15秒触发配置门户
  if(digitalRead(TRIGGER_PIN) == LOW) {
    if(millis() - lastTrigger > 15000) {
      wm.resetSettings();
      wm.startConfigPortal("MyDeviceAP", "12345678");
    }
  } else {
    lastTrigger = millis();
  }
  
  // LED状态指示
  if(wm.getConfigPortalActive()) {
    // 快速闪烁表示门户激活
    digitalWrite(LED_PIN, millis()%500 < 250);
  } else {
    // 慢速闪烁表示正常运行
    digitalWrite(LED_PIN, millis()%2000 < 100);
  }
  
  // 必须调用process()以处理门户请求
  wm.process();
}

安全建议

1. 始终为配置门户设置足够强度的密码（至少8个字符）
2. 考虑实现门户访问的身份验证机制
3. 限制配置门户的活动时间，避免长期暴露
4. 对于生产设备，建议添加HTTPS支持

总结

通过合理配置WiFiManager，开发者可以创建既用户友好又安全可靠的物联网设备网络配置方案。自定义AP名称、非阻塞操作和适当的超时控制是构建专业级设备的关键要素。