项目简介
本项目是基于Arduino平台的WiFi连接管理工具,专为ESP8266和ESP32等设备打造。它提供简单易用的Captive Portal界面,用户能通过网页配置WiFi网络连接。当设备无法连接已保存的WiFi网络,会自动启动配置门户,用户可通过浏览器输入新的WiFi凭证。此外,该工具支持自定义参数、静态IP配置、调试输出等功能,适用于各类物联网项目。
项目的主要特性和功能
- Captive Portal配置:通过网页界面轻松配置WiFi网络的SSID和密码。
- 自动连接:保存WiFi网络设置,设备启动时自动尝试连接。
- 自定义参数:支持配置额外参数,如MQTT服务器地址、端口等。
- 静态IP配置:允许为AP模式和STA模式设置自定义IP地址。
- 调试输出:提供详细调试信息,帮助开发者排查问题。
- 非阻塞模式:支持非阻塞模式,可在配置门户运行时执行其他任务。
- 多设备支持:兼容ESP8266、ESP32、ESP32 - S2、ESP32 - C3等多种设备。
- 主题定制:支持自定义CSS和HTML,可按需调整界面样式。
安装使用步骤
前提条件
假设用户已经下载了本项目的源码文件,且已安装Arduino IDE。
具体步骤
- 安装库:通过Arduino IDE的库管理器搜索并安装
WiFiManager
库。 - 包含头文件:在Arduino代码中包含
WiFiManager
的头文件: ```cpp
include
3. **初始化WiFiManager**:在`setup()`函数中初始化`WiFiManager`对象:
cpp
WiFiManager wifiManager;
4. **自动连接WiFi**:调用`autoConnect()`函数,提供WiFi网络的SSID和密码(如果需要):
cpp
wifiManager.autoConnect("AP-NAME", "AP-PASSWORD");
5. **设置回调函数(可选)**:可以设置回调函数来处理配置模式进入、保存配置等事件:
cpp
wifiManager.setAPCallback(configModeCallback);
wifiManager.setSaveConfigCallback(saveConfigCallback);
``
6. **上传代码**:将代码上传到ESP8266或ESP32设备,设备启动后会尝试连接WiFi网络,如果连接失败,则会启动配置门户。
7. **配置WiFi**:使用手机或电脑连接到设备创建的AP,打开浏览器访问默认IP(如
192.168.4.1`),输入WiFi凭证并保存。
8. 测试连接:设备将尝试连接到配置的WiFi网络,连接成功后,配置门户将关闭,设备进入正常工作模式。
注意事项
- 确保已安装最新版本的ESP8266或ESP32 Arduino核心库。
- 如果需要配置额外的参数,请参考库文档中的
WiFiManagerParameter
使用方法。 - 调试信息默认通过
Serial
输出,可以通过setDebugOutput(false)
禁用调试输出。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】