项目简介
本项目是基于Arduino框架开发的ESP32以太网配置管理系统,提供ESP32_SC_Ethernet_Manager
库。该库可配置ESP32以太网的静态或动态(DHCP)IP地址及相关凭证,支持运行时设置。备用的Web配置门户方便用户通过网络设备浏览器动态配置ESP32网络参数,适用于ESP32_S2/S3/C3系列开发板搭配LwIP W5500或ENC28J60以太网模块的场景。
项目的主要特性和功能
- 多模式支持:支持STA模式下的DHCP和静态IP配置,可在配置门户灵活切换。
- 参数可定制:允许指定静态DNS服务器、个性化主机名,支持CORS功能。
- 动态参数配置:可通过配置门户动态添加和配置自定义参数,如传感器引脚、API密钥等。
- 时间同步功能:支持NTP进行时间同步,有配置选项避免兼容性问题。
- 配置门户管理:配置门户可设置密码保护、超时时间,支持按需打开。
- 数据持久化:支持将配置数据保存到非易失性存储器,重启后自动加载。
安装使用步骤
前提条件
确保已安装以下依赖:
1. Arduino IDE 1.8.19+
2. ESP32 Core 2.0.5+
3. ESP_DoubleResetDetector v1.3.2+
(若使用DRD功能)
4. WebServer_ESP32_SC_W5500 library v1.0.1+
(若使用LwIP W5500以太网模块)
5. WebServer_ESP32_SC_ENC library v1.0.0+
(若使用LwIP ENC28J60以太网模块)
安装步骤
使用Arduino库管理器
打开Arduino IDE,点击“工具” -> “管理库”,搜索“ESP32_SC_Ethernet_Manager”,选择并安装最新版本。
手动安装
- 解压文件到
ESP32_SC_Ethernet_Manager-main
目录。 - 将整个
ESP32_SC_Ethernet_Manager-main
文件夹复制到Arduino库目录,如~/Arduino/libraries/
。
使用VS Code和PlatformIO
- 安装VS Code和PlatformIO。
- 打开PlatformIO,使用库管理器搜索并安装
ESP32_SC_Ethernet_Manager
库。 - 使用示例中的
platformio.ini
文件确保所有依赖库自动安装。
使用步骤
- 基本配置:在代码中包含
ESP32_SC_Ethernet_Manager.h
头文件,按需进行基本配置,如选择文件系统、设置LED引脚等。 - 打开配置门户:创建
ESP32_SC_Ethernet_Manager
对象,可指定个性化主机名,调用startConfigPortal()
函数打开配置门户。 - 配置参数:用有浏览器的网络设备连接到新创建的接入点,访问配置门户的IP地址,在门户中配置网络参数和自定义参数。
- 保存配置:在配置门户输入并保存参数后,设置将保存到非易失性存储器,ESP32将重启并自动连接到网络。
- 读取配置数据:在代码中通过相应函数读取保存的配置数据,如从JSON文件中解析参数。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】