项目简介

WiFiConfigManager 是一个基于 ESP32 设备的 WiFi 配置管理库，为开发者提供了灵活且易用的工具，用于管理 ESP32 设备上的 WiFi 连接。该库支持智能配置、默认凭证回退、持久化存储等功能，能帮助开发者快速集成 WiFi 连接功能。

项目的主要特性和功能

1. 智能配置：用户无需编程经验，通过智能配置选项即可轻松设置 WiFi 连接。
2. 默认凭证回退：若智能配置失败，系统会自动使用默认的 WiFi 凭证进行连接。
3. 持久化存储：利用 Preferences 库持久化存储 WiFi 凭证，保证设备重启后仍能保持连接。
4. 易于集成：与 Arduino 框架兼容，几行代码就能实现 WiFi 连接功能。

安装使用步骤

假设用户已经下载了本项目的源码文件。

1. 使用 PlatformIO 安装

• 打开你的 PlatformIO 项目。
• 在 platformio.ini 文件中添加以下内容： ini lib_deps = WiFiConfigManager
• PlatformIO 会在构建项目时自动安装该库。

2. 示例代码

以下是使用 WiFiConfigManager 库进行 WiFi 连接的简单示例代码： ```cpp

include

include

const String DEFAULT_SSID = "Default_SSID"; const String DEFAULT_PASSWORD = "Default_Password"; const bool SHOULD_CLEAR_PREFERENCES = false;

WiFiConfigManager wifiManager(DEFAULT_SSID, DEFAULT_PASSWORD, SHOULD_CLEAR_PREFERENCES);

void setup() { Serial.begin(115200); wifiManager.begin(); }

void loop() { if (wifiManager.isConnected()) { // 你的代码 } } ```

3. 使用 ESPTouch 应用配置 WiFi

• 在 Android 设备上下载并安装 ESPTouch 应用。
• 确保 Android 设备已连接到目标 WiFi 网络。
• 打开 ESPTouch 应用，输入 WiFi 密码。
• 启动 ESP32 设备并运行 WiFiConfigManager 代码。
• 在 ESPTouch 应用中点击“确认”或“广播”按钮，开始发送 WiFi 凭证。
• ESP32 设备将在一分钟内接收并保存凭证，成功连接后，isConnected() 方法将返回 true。

API 参考

• WiFiConfigManager(const String& defaultSSID, const String& defaultPassword, bool shouldClearPreferences)：构造函数，用于初始化 WiFiConfigManager。
• void begin()：启动 WiFi 连接过程。
• bool isConnected()：返回当前是否已连接到 WiFi。

许可证

该项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

下载地址

点击下载 【提取码: 4003】【解压密码: www.makuang.net】