在线烧录工具

FastBee-Arduino 烧录工具

选择串口、选择设备固件和文件系统镜像后，即可执行擦除或烧录操作，日志会实时显示连接和写入状态。

未连接

连接配置

波特率115200230400460800921600

连接串口

烧录文件

请选择文件FastBee-Arduino ESP32 设备固件示例FastBee-Arduino ESP32 文件系统镜像示例FastBee-Arduino ESP32-S3 设备固件示例FastBee-Arduino ESP32-S3 文件系统镜像示例FastBee-Arduino 通用文件系统镜像示例FastBee-Arduino 合并固件示例

请选择文件FastBee-Arduino ESP32 设备固件示例FastBee-Arduino ESP32 文件系统镜像示例FastBee-Arduino ESP32-S3 设备固件示例FastBee-Arduino ESP32-S3 文件系统镜像示例FastBee-Arduino 通用文件系统镜像示例FastBee-Arduino 合并固件示例

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

高级选项

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

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

执行操作

日志窗口

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

使用说明

1. 使用 USB 数据线连接开发板和电脑。
2. 在“波特率”中选择烧录速度，默认 115200，连接不稳定时优先使用默认值。
3. 点击“选择串口”，在浏览器弹窗中选择开发板对应的串口。
4. 在“烧录文件”底部的“文件来源”中选择文件位置。“内置文件”从 fim 目录读取，“本地文件”则由用户手动选择 .bin 文件。
5. 在“烧录文件”中通过“选择文件”选择需要写入的固件或镜像，并确认同一行中的烧录地址。默认显示两行，代表一次可以烧录两个文件。
6. 如果需要写入更多或更少文件，可点击“增加文件”或删除对应文件行。使用内置文件时，选择设备固件后会自动匹配同一 variant 的文件系统镜像到第二行。
7. FastBee-Arduino 应用固件常用 0x10000，文件系统镜像按当前分区表示例使用 0x300000，合并固件通常为 0x0。
8. 高级选项一般保持默认即可；如果固件编译参数、Flash 容量或板卡下载方式不同，再按实际情况调整。
9. 需要清空历史配置时先点击“擦除”，确认无误后点击“烧录”。

固件目录

编译好的固件放在本页面同级的 fim 目录下，并在 fim/manifest.json 中登记文件名、访问路径、文件类型、匹配标识、默认烧录地址和说明。页面会自动读取清单，并分别显示到“设备固件”和“文件系统镜像”下拉框。

清单中的 role 用于区分 device 设备固件和 filesystem 文件系统镜像；variant 用于自动匹配同一设备类型的两个文件。选择设备固件后，工具会优先选择同一 variant 的文件系统镜像，也可以通过 filesystemPath 指定更精确的默认镜像。

当前 fim 目录已放入设备固件和文件系统镜像的示例占位文件，用于展示下拉选择、自动匹配和地址配置方式。正式发布前请替换为真实编译产物，并将清单里的 sample 改为 false 或删除该字段。

注意事项

1. 示例占位固件和文件系统镜像不可直接用于设备烧录，工具会在烧录前拦截；替换为正式编译产物后再使用。
2. 烧录前请确认设备固件、文件系统镜像、芯片型号、分区表和 Flash 大小匹配。
3. 擦除 Flash 会清空设备原有配置，包括配网、运行参数和历史存储数据。
4. 自动复位默认启用，适合多数带自动下载电路的 ESP32 开发板。若设备已经处于下载模式、使用透传升级，或板卡自动复位电路不兼容，可关闭自动复位并手动按键进入下载模式。
5. 烧录完成后如设备未自动启动，请按 EN 或 RST 重启。

浏览器要求

1. 推荐使用新版 Chrome 或 Edge。
2. 文档需要通过 HTTPS 访问；本地调试时可使用 localhost。
3. 如果浏览器没有弹出串口选择窗口，请检查浏览器权限、USB 驱动和数据线。

常见问题

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

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

找不到串口

检查 USB 线是否支持数据传输，确认串口驱动已安装。Windows 设备管理器中通常会显示为 USB-SERIAL CH340、CP210x USB to UART Bridge 或类似名称。

烧录一直等待同步

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

烧录后设备不上线

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

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

确认文件系统镜像已经烧录，并且镜像地址与分区表一致。FastBee-Arduino 当前分区表示例中 LittleFS 分区地址为 0x300000；如果项目分区表有调整，请同步修改页面中的文件系统镜像烧录地址。