WIFIMANAGER-ESP32 开源项目安装与使用指南
WIFIMANAGER-ESP32wifimanager-esp32项目地址:https://gitcode.com/gh_mirrors/wi/WIFIMANAGER-ESP32
目录结构及介绍
在下载并解压 WIFIMANAGER-ESP32
项目之后,你会看到以下主要的目录和文件:
- examples: 示例代码目录,包含了使用此库进行网络管理的各种实例。
- BasicConnect: 展示了如何让 ESP32 连接预设的 WiFi 网络。
- ConfigPortal: 示例展示了当 ESP32 需要配置网络参数时,怎样自动开启配置门户。
- ...(其它示例)
- src: 库源码所在目录,这里包含了所有实现功能的核心代码。
- WiFiManager.cpp: 主要的类和方法实现。
- WiFiManager.h: 类声明以及公共接口定义。
- lib: 第三方依赖库,如用于处理 web 请求或 DNS 请求的库。
- README.md: 包含项目的简介、特性、使用说明等。
启动文件介绍
在 examples
目录下,你可以找到 .ino
文件作为启动文件,其中以 BasicConnect.ino
和 ConfigPortal.ino
最具代表性。
BasicConnect.ino
此示例展示了一个简单的程序流程:
- 设备尝试连接已存储的 WiFi 资质。
- 如果资质无效或者不存在,则设备转而启用接入点模式。
- 用户通过访问设备自建的热点完成网络设置。
核心函数是 wifiManager.autoConnect("AP_NAME", "PASSWORD");
,用于设定接入点名称及其密码,并触发自动连接过程。
ConfigPortal.ino
该示例专注于展示配置门户的使用,允许动态修改 ESP32 的网络参数。它的工作原理类似于前面描述的 BasicConnect
,但在找不到有效 WiFi 设置时,它将创建一个临时网络供用户输入新的 WiFi 凭证。
配置文件介绍
由于 WIFIMANAGER-ESP32
不直接提供配置文件编辑的功能,其设置主要是在代码层面进行。然而,在某些情况下,可能会有默认值保存到 ESP32 内存中,以便于下次开机时直接加载先前设置的网络参数。
- 在运行
autoConnect()
方法之前,你可以调用setConfigPortalTimeout(int seconds);
来调整配置门户开放的时间长度。 - 若要更改默认 SSID 或者密码,可以调用
setAPCallback(callback_function);
,并在提供的回调函数中定制你的设置。 - 更改初始状态检查方式,可以调用
setSaveConfigCallback(callback_function);
来指定一个函数决定何时保存配置。
总体来说,WIFIMANAGER-ESP32
并没有传统的配置文件概念,而是将大部分可定制选项封装进了一系列易于理解的方法中。这些方法使得开发者能够灵活地控制无线网络的行为,同时也简化了最终产品部署的过程。
以上介绍了 WIFIMANAGER-ESP32
的基本架构和关键组件,包括目录、启动文件、以及常见的配置操作。希望这份指南能帮助你在开发基于 ESP32 的物联网应用时更加得心应手。
WIFIMANAGER-ESP32wifimanager-esp32项目地址:https://gitcode.com/gh_mirrors/wi/WIFIMANAGER-ESP32