项目简介
WiFiManager是一个专为ESP8266和ESP32设计的Arduino库,其主要目的是简化WiFi连接的配置与管理。该库提供了基于Web的配置门户,让用户能通过浏览器轻松完成WiFi网络的配置。当设备无法连接已知WiFi网络时,会自动开启配置门户,方便用户输入新的WiFi凭据。
项目的主要特性和功能
- 自动WiFi连接:设备启动自动尝试连接已知WiFi网络,连接失败则进入配置模式。
- Web配置门户:通过浏览器输入WiFi凭据的Web配置页面。
- 自定义参数:可添加如MQTT服务器地址、端口等自定义参数,并在配置门户显示。
- 静态IP配置:支持为AP模式和STA模式设置静态IP地址。
- 回调函数:提供多种回调函数,可在特定事件时执行自定义操作。
- 调试输出:支持多级调试输出,便于开发和故障排查。
- 非阻塞模式:允许在配置门户运行时继续执行其他任务。
- OTA更新:支持通过Web界面进行OTA固件更新。
安装使用步骤
假设用户已经下载了本项目的源码文件。
1. 安装库:在Arduino IDE中,通过库管理器搜索并安装WiFiManager
库。
2. 导入库:在Arduino IDE中,使用#include <WiFiManager.h>
引入WiFiManager库。
3. 初始化库:在setup
函数中初始化WiFiManager库,调用autoConnect
函数启动自动连接和配置门户。
cpp
WiFiManager wifiManager;
wifiManager.autoConnect("AP-NAME", "AP-PASSWORD");
4. 添加自定义参数(可选):初始化后使用addParameter
函数添加自定义参数。
cpp
WiFiManagerParameter custom_mqtt_server("server", "mqtt server", mqtt_server, 40);
wifiManager.addParameter(&custom_mqtt_server);
5. 处理回调函数(可选):设置回调函数处理特定事件。
cpp
wifiManager.setAPCallback(configModeCallback);
wifiManager.setSaveConfigCallback(saveConfigCallback);
6. 编译并上传:编译代码并上传到ESP8266或ESP32设备。
7. 使用配置门户:设备无法连接已知WiFi网络时,会启动配置门户,用户通过浏览器连接设备热点并输入新的WiFi凭据。
注意事项
- 确保使用最新版本的ESP8266/ESP32核心库,避免兼容性问题。
- 开发中建议启用调试输出以排查问题。
- 若保存自定义参数,需在回调函数中正确处理参数的保存和加载。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】