烧录教程
本文列出浏览器、源码和批量写入入口。合并镜像含文件系统，会影响设备配置；现有设备升级前须核对目标身份、Flash/PSRAM及分区，保全配置并明确授权。烧录前请先阅读 硬件选型指南 确认固件版本。
一、在线烧录（零工具，推荐体验）
打开 在线烧录工具，浏览器直连设备串口即可完成烧录，无需安装任何工具。详细步骤见 在线烧录固件。
二、PlatformIO 单台烧录（日常开发）
- 安装 VSCode + PlatformIO 插件，或 PlatformIO CLI。
- 连接开发板，在设备管理器确认串口号（如
COM6）。 - 在 FastBee-Arduino 仓库根目录执行：
powershell
# Windows
powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32-F4R0 -Port COM6
# Linux / macOS（需 pwsh）
pwsh -File scripts/deploy.ps1 -Env esp32-F4R0 -Port /dev/ttyUSB0常用参数：
| 参数 | 说明 |
|---|---|
-Monitor | 烧录完成后自动打开串口监视器 |
-BuildOnly | 仅编译不烧录 |
-SkipFs | 跳过文件系统上传 |
-SkipDoctor | 跳过环境诊断检查 |
出厂安全模板
发布出厂模板不携带现场身份、STA/MQTT凭据，外设与规则默认停用；默认管理账号/AP口令仍需在现场修改。无需修改代码，但首次启动必须先完成配网，再按实际硬件添加外设，或导入与目标设备匹配的配置样例。详见 网络配置最佳实践。
三、一键批量烧录（多台设备量产）
deploy-all.ps1 可按串口描述筛选候选，量产前逐台核对MAC/芯片与硬件，优先显式指定已授权Ports；脚本，并将固件 + 文件系统合并为单个 factory-with-fs.bin，通过 esptool 从 0x0 整包并行烧录：
powershell
# 自动检测串口，并行烧录所有设备（默认环境 esp32-F4R0）
powershell -ExecutionPolicy Bypass -File scripts\deploy-all.ps1
# 指定环境与串口
powershell -File scripts\deploy-all.ps1 -Env esp32c3-F4R0 -Ports COM5,COM7
# 只看看检测到了哪些串口
powershell -File scripts\deploy-all.ps1 -ListPortsOnly
# 模拟执行（不真正烧录，检查流程）
powershell -File scripts\deploy-all.ps1 -DryRun| 参数 | 默认值 | 说明 |
|---|---|---|
-Env | esp32-F4R0 | 构建环境，见硬件选型指南 |
-Ports | 自动检测 | 指定串口号列表，逗号分隔 |
-MaxParallel | 2 | 并行烧录数量 |
-Baud | 921600 | 烧录波特率，不稳定时降到 460800 |
-SkipBuild | 关 | 跳过构建，使用已有产物 |
自动检测规则：匹配 CP2102 / CH340 / FTDI / ESP32 USB-CDC 描述或常见 VID:PID（10C4:EA60、1A86:7523、303A）。
烧录失败排查
- 端口被占用：关闭串口监视器和其他占用串口的程序
- 写 Flash 失败：降低
-Baud至 460800；S3 板按住 BOOT 键再上电 - 检测不到设备：更换数据线（部分线仅供电），安装 CP210x/CH340 驱动（驱动下载见下载中心）
四、esptool 手动烧录（进阶）
适合 CI 流水线或自定义流程：
powershell
python -m esptool --port COM6 --baud 921600 write_flash 0x0 .pio\build\esp32-F4R0\factory-with-fs.bin五、烧录后验证
- 打开串口监视器（115200 波特率），确认启动日志无异常。
- 设备启动后连接其 AP（默认按
设备名-芯片ID前6位生成；恢复出厂设置后为fastbee-ap），浏览器打开http://192.168.4.1。 - 默认登录：用户名
admin，密码admin123。 - 后续流程见 快速开始。