Online ESP32 Flasher
Online ESP32 Flasher
FastBee-Arduino 烧录工具
选择串口和合并固件后,即可执行擦除或烧录操作,日志会实时显示连接和写入状态。
高级选项
已加载 7 个内置烧录文件。 等待选择串口。
Quick Start
| Step | Action | Details |
|---|---|---|
| 1 | Connect the board | Use a USB data cable (not a charge-only cable) |
| 2 | Select serial port | Click the serial-port button and choose the board port in the browser dialog |
| 3 | Pick firmware & flash | Select the matching merged firmware from the dropdown, then click Flash |
After flashing, the device restarts automatically. If it does not, press
ENorRSTto reboot manually.
Tool Layout
The tool is split into two panels:
Left — Configuration Panel
- Connection: Baud rate selector (default
115200), serial port connect/disconnect button. The top-right corner shows the connection status (Connected / Disconnected). - Flash Files: Firmware source switch (Built-in / Local), firmware dropdown or local
.binfile picker, flash address input (default0x0). In local mode you can add or remove file rows. - Advanced Options (collapsed): Flash mode, Flash frequency, Flash size, and auto-reset toggle.
Right — Execution Panel
- Action Buttons: Erase (clear Flash) and Flash (write firmware).
- Progress Bar: Real-time flash progress percentage.
- Log Window: Connection, write, and verification status with a clear button.
Built-In Firmware Selection
Built-in firmware images are loaded from fim/manifest.json next to this page. Each image is a merged firmware (bootloader + partition table + application + Web filesystem) with flash address 0x0 — a single write covers everything.
| Chip | Firmware | Flash | PSRAM | Typical Board |
|---|---|---|---|---|
| ESP32 | fastbee-esp32-F4R0 | 4 MB | None | ESP32-DevKitC and similar |
| ESP32 | fastbee-esp32-F8R4 | 8 MB | 4 MB | ESP32-WROVER series |
| ESP32-S3 | fastbee-esp32s3-F8R0 | 8 MB | None | 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 | None | ESP32-C3-DevKitM-1 |
| ESP32-C6 | fastbee-esp32c6-F4R0 | 4 MB | None | ESP32-C6-DevKitC-1 |
How to check Flash and PSRAM size? Look at the chip info in Arduino IDE's Tools menu, or inspect the boot log via serial monitor for
chip:andflash:lines.
Firmware Naming Convention
In the filename, F stands for Flash size and R stands for PSRAM size:
F4R0→ 4 MB Flash, no PSRAMF8R4→ 8 MB Flash, 4 MB PSRAMF16R8→ 16 MB Flash, 8 MB PSRAM
Detailed Instructions
Connection
- Connect the development board to your computer with a USB data cable.
- Select the baud rate from the dropdown —
115200,230400,460800, or921600. Keep115200when the connection is unstable. - Click the serial-port button and choose the board port in the browser dialog. The status indicator in the top-right corner changes to "Connected" on success.
Flash Files
- Choose the firmware source:
- Built-in: Reads merged firmware from the
fimdirectory; the dropdown lists all available images. - Local: Manually select
.binfiles; you can add or remove file rows.
- Built-in: Reads merged firmware from the
- In built-in mode, select the merged firmware that matches the chip, Flash size, and PSRAM size. Keep the address at
0x0. - In local mode, click the file button to choose a
.binfile and enter the flash address. Click "Add File" to flash multiple files.
Advanced Options
Advanced options are collapsed by default and usually do not need changes:
| Option | Default | Notes |
|---|---|---|
| Flash Mode | DIO | Keep DIO unless the firmware build explicitly requires QIO, DOUT, or QOUT |
| Flash Frequency | 40 MHz | Keep 40 MHz; 80 MHz requires both board and firmware support |
| Flash Size | Auto-match | Automatically set from the F suffix when using built-in firmware; manual options: 4MB / 8MB / 16MB |
| Auto Reset | Enabled | Enters download mode automatically; disable for transparent upgrades or manual button entry |
Execution
- To clear previous configuration, click Erase first. Erase wipes the entire Flash, including network settings, runtime parameters, and stored data.
- After confirming the firmware selection, click Flash. The progress bar and log window show write status in real time.
- After flashing, the device restarts automatically. If it does not, press
ENorRSTto reboot.
Important Notes
- Firmware matching: Always verify that the chip model, Flash size, and PSRAM size in the merged firmware match the board.
- Merged firmware address: Merged firmware writes from
0x0and includes bootloader, partition table, application, and Web filesystem — no additional images are needed. - Erase impact: Erasing Flash removes all device configuration and data. Back up settings before erasing.
- Auto reset: Enabled by default for boards with auto-download circuits. Disable for transparent upgrades or boards without compatible reset circuitry.
Browser Requirements
- Use a recent Chrome or Edge browser.
- Web Serial API requires HTTPS. Local development can use
localhost. - If the serial-port dialog does not appear, check browser serial permissions, USB drivers, and whether the cable supports data transfer.
Troubleshooting
The Browser Does Not Support Serial Access
Switch to Chrome or Edge and make sure the page is served through HTTPS. Some Chromium-based browsers may have disabled the serial capability.
No Serial Port Is Listed
- Check that the USB cable supports data transfer (not a charge-only cable).
- Confirm the serial driver is installed. On Windows, the device usually appears as
USB-SERIAL CH340,CP210x USB to UART Bridge, or a similar adapter in Device Manager. - Make sure no other program (e.g., Arduino IDE Serial Monitor) is using the same port.
Flashing Keeps Waiting for Sync
If automatic reset does not work, hold BOOT, start flashing, and release after writing begins. If it still fails, press EN or RST and retry.
The Device Does Not Come Online After Flashing
Confirm Wi-Fi, MQTT, product, and credential settings in the firmware. Use serial logs to inspect connection errors. If another firmware was flashed before, erase Flash and write the complete merged image again.
The Web Console Is Missing or Broken
Confirm that the selected file is a complete merged image and that its chip, Flash, and PSRAM profile matches the board. If you use a custom partition layout or build your own package, regenerate the merged image with the Web filesystem resources included.
