在线烧录工具

FastBee-Arduino 烧录工具

选择串口和合并固件后，即可执行擦除或烧录操作，日志会实时显示连接和写入状态。

未连接

连接配置

波特率115200230400460800921600

连接串口

烧录文件

请选择合并固件ESP32 / 4MB Flash / 0MB PSRAM - fastbee-esp32-F4R0.binESP32 / 8MB Flash / 4MB PSRAM - fastbee-esp32-F8R4.binESP32S3 / 8MB Flash / 0MB PSRAM - fastbee-esp32s3-F8R0.binESP32S3 / 8MB Flash / 4MB PSRAM - fastbee-esp32s3-F8R4.binESP32S3 / 16MB Flash / 8MB PSRAM - fastbee-esp32s3-F16R8.binESP32C3 / 4MB Flash / 0MB PSRAM - fastbee-esp32c3-F4R0.binESP32C6 / 4MB Flash / 0MB PSRAM - fastbee-esp32c6-F4R0.bin

固件来源内置文件本地文件

高级选项

Flash 模式DIOQIODOUTQOUT建议保持 DIO；只有固件编译配置明确要求时再改为 QIO、DOUT 或 QOUT。Flash 频率40 MHz80 MHz26 MHz20 MHz建议保持 40 MHz；80 MHz 需要板卡和固件配置同时支持。Flash 大小自动检测4MB8MB16MB优先使用自动检测；检测失败或分区表固定时选择实际 Flash 容量。

自动复位默认启用，便于自动进入下载模式；透传升级或需手动按键下载时可关闭。

执行操作

日志窗口

已加载 7 个内置烧录文件。
等待选择串口。

三步上手

步骤	操作	说明
1	USB 连接开发板	使用数据线（非纯充电线）连接开发板和电脑
2	选择串口	点击"选择串口"，在浏览器弹窗中选择开发板对应的串口
3	选择固件并烧录	从下拉框选择与芯片匹配的合并固件，点击"烧录"

烧录完成后设备会自动重启。如果未自动启动，按 EN 或 RST 键手动重启。

工具界面概览

工具分为左右两个面板：

左侧——配置面板

• 连接配置：波特率选择（默认 115200）、串口连接/断开按钮。页面右上角显示连接状态（已连接 / 未连接）。
• 烧录文件：固件来源切换（内置文件 / 本地文件）、固件选择下拉框或本地 .bin 文件选择、烧录地址输入（默认 0x0）。本地文件模式下支持增加/删除文件行。
• 高级选项（折叠）：Flash 模式、Flash 频率、Flash 大小和自动复位开关。

右侧——执行面板

• 操作按钮："擦除"（清空 Flash）和"烧录"（写入固件）。
• 进度条：实时显示烧录进度百分比。
• 日志窗口：输出连接、写入和校验状态，支持一键清空。

内置固件选型

内置固件从本页同级 fim/manifest.json 加载，均为合并固件（bootloader + 分区表 + 应用 + Web 文件系统），烧录地址 0x0，一次写入即可。

芯片	固件名称	Flash	PSRAM	典型开发板
ESP32	fastbee-esp32-F4R0	4 MB	无	ESP32-DevKitC 等基础款
ESP32	fastbee-esp32-F8R4	8 MB	4 MB	ESP32-WROVER 系列
ESP32-S3	fastbee-esp32s3-F8R0	8 MB	无	ESP32-S3-DevKitC-1 (N8)
ESP32-S3	fastbee-esp32s3-F8R4	8 MB	4 MB	ESP32-S3-WROOM-1 (N8R4)
ESP32-S3	fastbee-esp32s3-F16R8	16 MB	8 MB	ESP32-S3-WROOM-1 (N16R8)
ESP32-C3	fastbee-esp32c3-F4R0	4 MB	无	ESP32-C3-DevKitM-1
ESP32-C6	fastbee-esp32c6-F4R0	4 MB	无	ESP32-C6-DevKitC-1

如何确认 Flash 和 PSRAM 大小？ 在 Arduino IDE 的"工具"菜单中查看芯片信息，或使用串口监视器查看启动日志中的 chip: 和 flash: 信息。

固件命名规则

文件名中 F 代表 Flash 容量，R 代表 PSRAM 容量：

• F4R0 → 4 MB Flash、无 PSRAM
• F8R4 → 8 MB Flash、4 MB PSRAM
• F16R8 → 16 MB Flash、8 MB PSRAM

详细使用说明

连接配置

1. 使用 USB 数据线连接开发板和电脑。
2. 在"波特率"下拉框中选择烧录速度，可选 115200、230400、460800、921600。默认 115200，连接不稳定时优先使用默认值。
3. 点击"选择串口"，在浏览器弹窗中选择开发板对应的串口。连接成功后页面右上角状态变为"已连接"。

烧录文件

4. 在"固件来源"中选择文件位置：
   • 内置文件：从 fim 目录读取合并固件，下拉框自动列出所有可用固件。
   • 本地文件：手动选择 .bin 文件，支持增加或删除文件行。
5. 内置文件模式下，从下拉框选择与设备芯片、Flash 和 PSRAM 匹配的合并固件，烧录地址保持 0x0。
6. 本地文件模式下，点击文件按钮选择 .bin 文件，手动输入烧录地址。如需写入多个文件，点击"增加文件"添加新行。

高级选项

高级选项默认折叠，通常保持默认即可：

选项	默认值	说明
Flash 模式	DIO	建议保持 DIO；只有固件编译配置明确要求时再改为 QIO、DOUT 或 QOUT
Flash 频率	40 MHz	建议保持 40 MHz；80 MHz 需要板卡和固件同时支持
Flash 大小	自动匹配	选择内置固件时自动从文件名 F 后缀匹配；也可手动选择 4MB / 8MB / 16MB
自动复位	启用	自动进入下载模式；透传升级或手动按键下载时可关闭

执行操作

7. 如需清空设备历史配置，先点击"擦除"。擦除会清空整个 Flash，包括配网、运行参数和存储数据。
8. 确认固件选择无误后，点击"烧录"。进度条和日志窗口会实时显示写入状态。
9. 烧录完成后设备自动重启。如未自动启动，按 EN 或 RST 键手动重启。

注意事项

1. 固件匹配：烧录前务必确认合并固件的芯片型号、Flash 大小和 PSRAM 大小与开发板一致。
2. 合并固件地址：合并固件从 0x0 写入，包含 bootloader、分区表、应用和 Web 文件系统，通常不需要再单独选择其他镜像。
3. 擦除影响：擦除 Flash 会清空设备全部配置和数据，操作前请做好备份。
4. 自动复位：默认启用，适合多数带自动下载电路的 ESP32 开发板。若设备已处于下载模式、使用透传升级或自动复位电路不兼容，可关闭并手动按键进入下载模式。

浏览器要求

1. 推荐使用新版 Chrome 或 Edge。
2. Web Serial API 要求页面通过 HTTPS 访问；本地调试可使用 localhost。
3. 如果浏览器没有弹出串口选择窗口，请检查：浏览器串口权限、USB 驱动安装、数据线是否支持数据传输。

常见问题

浏览器提示不支持串口访问

换用 Chrome 或 Edge，并确认当前页面是 HTTPS。部分国产浏览器即使基于 Chromium 也可能关闭了串口能力。

找不到串口

• 检查 USB 线是否支持数据传输（非纯充电线）。
• 确认串口驱动已安装。Windows 设备管理器中通常显示为 USB-SERIAL CH340、CP210x USB to UART Bridge 或类似名称。
• 确认没有其他程序（如 Arduino IDE 串口监视器）正在占用该串口。

烧录一直等待同步

如果启用自动复位后仍无法同步，说明板卡可能没有自动下载电路或进入下载模式失败。按住 BOOT 键后点击"烧录"，看到开始写入后松开；如果仍失败，按一下 EN 或 RST 后重试。

烧录后设备不上线

先确认固件中的 Wi-Fi、MQTT、产品信息和设备认证参数配置正确；再通过串口日志查看连接错误。如果此前烧录过其他固件，可以先擦除 Flash 后重新写入完整固件。

页面资源缺失或 Web 页面异常

确认选择的是完整合并固件，并且固件对应的芯片、Flash 和 PSRAM 规格与开发板一致。如果使用自定义分区或自行打包固件，请重新生成包含 Web 文件系统资源的合并镜像。