# ESPConnect

**Repository Path**: eegithub/espconnect

## Basic Information

- **Project Name**: ESPConnect
- **Description**: Esp32 烧录高度工具集
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESPConnect

<a href="https://esp32.taobao.com" target="_blank">
<img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="购买验证模块">
</a>

ESPConnect 是一款基于浏览器的 ESP32 和 ESP8266 系列开发板控制中心。它完全运行在现代 Chromium 浏览器中，无需安装桌面软件，即可查看硬件详情、管理 SPIFFS/Fat/LittleFS 文件、备份闪存以及部署固件。本项目基于 Jason2866 的 [WebSerial ESPTool](https://github.com/Jason2866/WebSerial_ESPTool/tree/development)。

- [教程](https://blog.csdn.net/cos12a/article/details/156298530?fromshare=blogdetail&sharetype=blogdetail&sharerId=156298530&sharerefer=PC&sharesource=cos12a&sharefrom=from_link)

## 环境要求

- Chrome、Edge、Brave、Arc 或其他基于 Chromium 89 及以上版本的浏览器。
- 通过 USB 连接的 ESP32、ESP32-C3、ESP32-S2、ESP32-S3、ESP32-C6、ESP32-H2、ESP32-C5、ESP32-P4 或 ESP8266 开发板。
- 一根带数据线的 USB 线。如果你的开发板缺少自动复位电路，应用程序会引导你手动进入引导加载程序。

## 快速开始

1. 打开 [ESPConnect](https://esp.unito.top/)。
2. 点击**连接**，在浏览器请求权限时选择你的设备。
3. 握手完成后，导航抽屉将解锁所有工具：设备信息、分区表、SPIFFS、应用、烧录、控制台和日志。
4. 想释放 USB 端口给其他应用使用时，点击**断开连接**即可。

## 功能概览

### 设备与闪存感知

- **设备信息选项卡** – 实时显示芯片系列、版本、MAC 地址、闪存大小、晶振频率、功能特性和精选参数组的摘要信息。未连接设备时自动显示"未连接设备"提示卡片。
- **分区表选项卡** – 图形化分区映射图及每个分区条目的详细表格，包括大小、偏移量和未使用闪存区域，方便在烧录前确认分区布局。

### 文件系统管理器（支持 SPIFFS、LittleFS 和 FATFS）

- 支持即时文本过滤和分页浏览文件。
- 通过文件选择器或拖放上传文件；应用程序会检查可用空间并在传输前阻止超大文件。
- 执行完整文件系统备份、恢复镜像或格式化分区（在确认已有备份后）。
- 本地暂存编辑内容，确认后点击**保存到闪存**即可写入。
- 预览 UTF-8 文本（JSON、HTML、日志等）、内联渲染图片，以及播放 MP3、WAV、OGG/Opus、AAC/M4A、FLAC 和 WebM 等音频格式——无需离开浏览器。
- 下载或删除单个文件，并通过用量指示器监控已用、可用和总字节数。

### OTA 槽位洞察

- **应用选项卡** – 查看应用程序槽位/OTA 分区信息。显示哪个槽位处于活动状态，以及构建元数据、大小和其他识别详情，让你始终了解当前运行的固件和下次启动的固件。

### 烧录与维护工作区

- **烧录固件** – 加载任意 `.bin` 文件，选择常用偏移量预设，可选择擦除整个芯片，并通过详细对话框观察烧录进度。
- **备份与下载** – 捕获单个分区、整个分区表、仅闪存已使用区域或指定的任意区域。
- **完整性校验** – 提供偏移量和长度以计算 MD5 哈希值，快速验证设备上的存储内容。
- **寄存器访问** – 使用集成的地址与描述指南直接读写硬件寄存器。
- **控制操作** – 取消长时间传输、停止备份、擦除闪存或保存暂存的 SPIFFS 更改，均有清晰的确认提示和进度指示。

### 实时监控与历史记录

- **串口监视器选项卡** – 流式传输 UART 输出，发送命令（包括 Ctrl+C），清空控制台，更改波特率或直接从浏览器复位开发板。
- **会话日志选项卡** – 按时间顺序记录连接、烧录、下载和警告事件。随时可清空以获得全新记录。

### NVS 检查器（🧪 实验性功能）

ESPConnect 包含一个**实验性 NVS 检查器**，可直接从浏览器**读取和可视化** ESP32 的 NVS（非易失性存储）分区内容。

功能包括：

- 自动检测 NVS 格式（**v1 / v2**）
- 列出命名空间和键
- 解码常见值类型（整数、字符串、二进制数据）
- 启发式解码浮点数和双精度数
- 显示页面状态、序列号、CRC 状态和条目使用情况
- 可视化页面布局和占用情况

限制：

- **只读**（不支持编辑或写入）
- 解析基于对 ESP-IDF 行为的逆向工程，可能无法处理所有边缘情况
- 某些值类型可能显示为原始二进制数据
- 损坏或部分擦除的页面可能产生警告

状态：

> ⚠️ 此功能为**实验性**，仅供**检查和调试**使用。  
> 输出内容不应被视为恢复或取证分析的权威依据。

欢迎提供反馈和测试报告。

## 稳定版 vs 预览版

ESPConnect 提供两种发布版本：

- **稳定版（推荐）**  
  👉 https://esp.unito.top/  
  此版本从带标签的发布版本构建，适合日常使用。

- **预览版（开发构建）**  
  👉 https://gitee.com/eegithub/espconnect
  此版本从 `main` 分支自动构建，可能包含新的修复、功能、实验性特性或破坏性更改。[查看当前预览版变更](CHANGELOG.md)

> ⚠️ 预览版仅供测试和反馈使用。  
> 如果遇到问题，请报告并说明问题发生在**稳定版**还是**预览版**。

## 提示与故障排除

- 如果自动进入引导模式失败，按住 **BOOT** 键，点按 **RESET** 键，继续按住 **BOOT** 键同时点击**连接**，看到 ESP-ROM 横幅后松开。
- 同一时间只能有一个应用程序使用 USB 串口桥接。连接前请关闭 Arduino IDE、PlatformIO 或其他工具。
- 连接后仍可更改波特率。如果传输停滞，请降至 460800 或 115200 bps。
- 取消烧录或下载操作会安全暂停。准备好后重新运行即可。

### ESP8266 兼容性

> ESP8266 设备可以连接，但支持非常有限。
> 该工具无法读取分区表或访问 SPIFFS/LittleFS，ESP32 上的高级功能未在 ESP8266 上实现。

## 参与贡献

ESPConnect 是开源项目，欢迎贡献。
如果你想在本地运行 ESPConnect、参与代码开发或提交 Pull Request，请参阅：

➡️ **[CONTRIBUTING.md](./CONTRIBUTING.md)**
该文档包含开发环境搭建说明、项目规范和贡献指南。

## 本地运行 ESPConnect

ESPConnect 是一个**纯浏览器端 Web 应用**——无需后端，无需安装，所有操作均通过 Web Serial / WebUSB 直接在浏览器中完成。

### 1. 作为桌面应用运行（Electron）

请按照[最新发布版](https://gitee.com/eegithub/espconnect/releases/latest)中对应平台的安装说明进行操作。

### 2. 通过 Docker 运行 ESPConnect

```bash
docker build -t espconnect .
docker run --rm -p 8080:80 espconnect
```

### 3. 本地运行构建版本（静态服务器）

请按照[最新发布版](https://gitee.com/eegithub/espconnect/releases/latest)中的说明进行操作。

## 隐私与安全

ESPConnect 完全在你的浏览器中运行——没有后端、账户或遥测。固件文件、备份和诊断数据仅保存在本地，只有在你主动下载时才会离开你的设备。请始终从可信来源烧录固件。

## 许可证

ESPConnect 基于 MIT 许可证发布。详见 [LICENSE](LICENSE)。

# Esp32Tool