ESPConnect是一个基于现代浏览器的管理器,在你需要快速验证、调试、管理文件、检查状态的时候,它能帮你省下大量打开和切换重型工具的时间。
ESPConnect 是一个基于浏览器的控制中心,适用于 ESP32 和 ESP8266 级板子。它完全运行在现代 Chromium 浏览器中,因此你可以检查硬件细节、管理 SPIFFS 文件、备份闪存和部署固件,而无需安装桌面软件。该库基于 Jason2866 的 WebSerial ESPTool。
你需要什么
- Chrome、Edge、Brave、Arc,或者基于 89 版及以上的其他 Chromium 浏览器。
- 通过 USB 连接 ESP32、ESP32-C3、ESP32-S2、ESP32-S3、ESP32-C6、ESP32-H2、ESP32-C5、ESP32-P4 或 ESP8266 板。
- 一根带数据线的 USB 线。如果你的主板没有自动复位布线,应用会引导你手动进入引导加载程序。
快速入门
- 打开 ESPConnect。
- 点击连接 ,浏览器请求许可时选择你的设备。
- 握手完成后,导航抽屉会解锁所有工具:设备信息、分区、SPIFFS、应用、Flash、控制台和日志。
- 想腾出 USB 接口给其他应用时用断开 。
功能概述
Device & flash awareness 设备与闪存意识
- 设备信息标签—— 实时总结芯片系列、版本、MAC 地址、闪存大小、晶体频率、功能及精选事实组。当没有连接任何设备时,会自动弹出“无设备连接”卡。
- 分区标签 ——图形地图,附有每个分区条目的详细表格,包括尺寸、偏移量和未用闪存,方便你在刷屏前仔细核对布局决策。
文件系统管理器(支持 SPIFFS、LittleFS 和 FATFS)
- 浏览文件时可即时文本过滤,页码控制。
- 通过文件选择器或拖放上传;应用会检查可用空间,并在传输前屏蔽超大文件。
- 运行完整的文件系统备份,恢复镜像,或者格式化分区(确认有备份后)。
- 先在本地编辑关卡,满意后用 “保存到闪存”(Save to Flash)把它们推下去。
- 预览 UTF-8 文本(JSON、HTML、日志等)、内联渲染图像,以及聆听 MP3、WAV、OGG/Opus、AAC/M4A、FLAC 和 WebM 等音频格式——全部无需离开浏览器。
- 下载或删除单个文件,并关注显示已用、免费和总字节的使用量表。
OTA 分区洞察
- 应用标签页 ——检查应用槽/OTA 分区。查看哪个插槽处于激活状态,以及构建元数据、大小和其他识别细节,这样你总是知道当前运行的固件和接下来要部署的固件。
闪存与维护工作区
- 闪存固件 ——加载任意 .bin,选择常见偏移预设,可选地擦除整颗芯片,并通过详细对话观看进度。
- 备份和下载——可以捕获单个分区、整个分区表、仅使用闪存区域或你指定的任意区域。
- 完整性检查 ——提供偏移量和长度以计算 MD5 哈希值,以便快速验证设备存储内容。
- 寄存器访问 ——直接通过集成的地址和描述指南读写硬件寄存器。
- 控制作 ——取消长传输、停止备份、擦除闪存,或保存带有清晰确认和进度指示的分阶段 SPIFFS 变更。
实时监测与历史
- 串行监听器标签 ——从浏览器中流式传输 UART 输出、发送命令、清除控制台、更改波特率或重置电路板。
- 会话日志标签—— 按时间顺序记录连接、闪存、下载和警告。想重新开始就清理。
NVS 检查(🧪实验型)
ESPConnect 包含一个实验性的 NVS 检查器 ,可以让你直接从浏览器读取和可视化 ESP32 的 NVS(非易失性存储)分区内容。
它能做什么
- 自动检测 NVS 格式(v1 / v2)
- 列表命名空间与键
- 解码常见的值类型(整数、字符串、斑点)
- 启发式解码浮点数和双元数
- S显示页面状态、序列号、CRC 状态及条目使用
- 可视化页面布局和占用情况
局限性
- 只读 (无编辑或写入)
- 解析基于对 ESP-IDF 行为的逆向工程,可能无法处理所有边缘情况
- 某些值类型可能以原始斑点表示
- 损坏或部分被删除的页面可能会提示警告
现状
⚠️ 此功能为实验性 , 仅用于检查和调试 。
输出不应被视为恢复或法医用途的权威。
非常欢迎反馈和测试报告。
提示与故障排除
- 如果自动启动失败,按住 BOOT,点击 RESET,继续按住 BOOT 键并点击连接 ,看到 ESP-ROM 横边后松开。
- 一次只能有一个应用程序使用 USB 串口。连接前请关闭 Arduino IDE、PlatformIO 或其他工具。
- 即使连接后,你也可以更改波特率。如果转移停滞,降到 460800 或 115200 bps。
- 取消闪存或下载会安全暂停。准备好了再跑一遍。
ESP8266 兼容性
ESP8266 设备可以连接,但支持非常有限。该工具无法读取分区表或访问 SPIFFS/LittleFS,ESP32 上的高级功能也未为 ESP8266 实现。
项目地址:https://github.com/thelastoutpostworkshop/ESPConnect