# ESP32和ESP8266系列开发板控制中心

**Repository Path**: starry123/ESPConnect

## Basic Information

- **Project Name**: ESP32和ESP8266系列开发板控制中心
- **Description**: ESPConnect 是一个基于浏览器的 ESP32 和 ESP8266 系列开发板控制中心。它完全在现代 Chromium 浏览器内运行，因此您可以检查硬件详细信息、管理 SPIFFS 文件、备份 Flash，并在无需安装桌面软件的情况下部署固件。它基于 Jason2866 的 WebSerial ESPTool。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[<img src="https://github.com/thelastoutpostworkshop/images/blob/main/ESPConnect-github.png">](https://youtu.be/-nhDKzBxHiI)

# ESPConnect

<a href="https://www.buymeacoffee.com/thelastoutpostworkshop" target="_blank">
<img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee">
</a>

ESPConnect 是一个基于浏览器的 ESP32 和 ESP8266 系列开发板控制中心。它完全在现代 Chromium 浏览器内运行，因此您可以检查硬件详细信息、管理 SPIFFS 文件、备份 Flash，并在无需安装桌面软件的情况下部署固件。它基于 Jason2866 的 [WebSerial ESPTool](https://github.com/Jason2866/WebSerial_ESPTool/tree/development)。

- [教程](https://youtu.be/-nhDKzBxHiI)

## 您需要什么

- Chrome、Edge、Brave、Arc 或其他基于版本 89 或更新版本的 Chromium 浏览器。
- 通过 USB 连接的 ESP32、ESP32-C3、ESP32-S2、ESP32-S3、ESP32-C6、ESP32-H2、ESP32-C5、ESP32-P4 或 ESP8266 开发板。
- 带数据线的 USB 线缆。如果您的开发板没有自动复位布线，应用程序会引导您手动进入引导加载程序。

## 快速开始

1. 打开 [ESPConnect](https://thelastoutpostworkshop.github.io/ESPConnect/)。
2. 单击 **连接** 并在浏览器请求权限时选择您的设备。
3. 握手完成后，导航抽屉解锁所有工具：设备信息、分区、SPIFFS、应用程序、Flash、控制台和日志。
4. 当您想要释放 USB 端口供其他应用程序使用时，请使用 **断开连接**。

## 功能概述

### 设备和 Flash 意识

- **设备信息标签** – 芯片系列、版本、MAC 地址、Flash 大小、晶体频率、功能和精选事实组的实时摘要。当没有连接设备时，会自动显示"未连接设备"卡片。
- **分区标签** – 图形映射加上每个分区条目的详细表格，包括大小、偏移量和未使用的 Flash，以便您在烧录前仔细检查布局决策。

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

- 使用即时文本过滤和分页控件浏览文件。
- 通过文件选择器或拖放上传；应用程序检查可用空间并在传输前阻止过大的文件。
- 运行完整的文件系统备份、恢复映像或格式化分区（在确认您有备份后）。
- 在本地暂存编辑，然后在您满意时使用 **保存到 Flash** 将其推送下去。
- 预览 UTF‑8 文本（JSON、HTML、日志等）、内联渲染图像，并播放 MP3、WAV、OGG/Opus、AAC/M4A、FLAC 和 WebM 等音频格式 - 所有这些都不需要离开浏览器。
- 下载或删除单个文件，并密切关注显示已用、可用和总字节的使用量表。

### OTA 槽位洞察

- **应用程序标签** – 检查应用程序槽位/OTA 分区。查看哪个槽位处于活动状态以及构建元数据、大小和其他识别详细信息，因此您始终知道当前运行的固件和下一个待命的固件。

### Flash 和维护工作区

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

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

- **串行监控标签** – 流式传输 UART 输出、发送命令、清除控制台、更改波特率或直接从浏览器重置开发板。
- **会话日志标签** – 连接、烧录、下载和警告的时间顺序分类账。随时清除以获得一个干净的界面。

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

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

它可以做什么

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

限制

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

状态

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

非常欢迎反馈和测试报告。

## 稳定版与预览版

ESPConnect 以两种变体发布：

- **稳定版（推荐）**
  👉 https://thelastoutpostworkshop.github.io/ESPConnect/
  此版本从标记的发布版本构建，适用于日常使用。

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

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

## 提示和故障排除

- 如果自动引导条目失败，请按住 **BOOT**，点击 **RESET**，在单击 **连接** 时继续按住 **BOOT**，然后在看到 ESP-ROM 横幅时释放。
- 一次只能有一个应用程序使用 USB 串行桥。连接前请关闭 Arduino IDE、PlatformIO 或其他工具。
- 即使在连接后也可以更改波特率。如果传输停滞，请降至 460800 或 115200 bps。
- 取消 Flash 或下载会安全暂停。准备好时再次运行即可。

### ESP8266 兼容性

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

## 贡献

ESPConnect 是开源的，欢迎贡献。
如果您想在本地运行 ESPConnect、处理代码库或提交拉取请求，请参阅：

➡️ **[CONTRIBUTING.md](./CONTRIBUTING.md)**

该文档包含开发设置说明、项目约定和贡献指南。

## 在本地运行 ESPConnect

ESPConnect 是一个**纯浏览器内网络应用程序** — 无后端，无需安装，所有操作都直接在您的浏览器中使用 Web Serial / WebUSB 进行。

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

按照 [最新发布](https://github.com/thelastoutpostworkshop/ESPConnect/releases/latest) 中您平台的安装说明

### 2. 通过 Docker 运行 ESPConnect

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

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

按照 [最新发布](https://github.com/thelastoutpostworkshop/ESPConnect/releases/latest) 中的说明

## 隐私和安全

ESPConnect 完全在您的浏览器中运行 — 没有后端、账户或遥测。固件文件、备份和诊断信息保留在本地，只有在您自己下载时才会移动。始终从可信来源刷固件。

## 许可证

ESPConnect 根据 MIT 许可证发布。请参阅 [LICENSE](LICENSE) 以获取完整文本。