跳到主要内容

固件烧录

本页是固件烧录页的完整参考：连接栏、Flash / Erase / Read / Authorize 四个标签、芯片清单表、多段烧录、擦除预设，以及右侧的进度与日志面板。

页面总览​

页面分三部分：顶部连接栏 / 左侧操作卡片（四个标签）/ 右侧进度与日志面板。

Flash 页连接栏——串口下拉框、波特率、芯片选择器、状态点

Flash 页连接栏——串口下拉框、波特率、芯片选择器、状态点。

连接栏​

  • 串口（每次展开时重扫）
  • 波特率 —— 115200 / 460800 / 921600 / 1000000 / 1500000 / 2000000，外加自定义（300–4,000,000）。Authorize 标签下为授权波特率。
  • 芯片选择器 —— Authorize 下多出 other 选项。
  • 状态点 —— 绿色 = 已连接就绪；灰/红 = 未连接或握手失败。
自动连接 / 自动释放

操作开始时 tyutool 自动连接，完成后自动释放端口。

选择芯片​

权威芯片清单（来源：chip-manifests.ts）：

芯片(-d)烧录波特率授权波特率Flash 容量擦除预设
esp324608001152004 MiBfullChip
esp32c34608001152004 MiBfullChip
esp32c64608001152008 MiBfullChip
esp32p446080011520016 MiBfullChip
esp32s346080011520016 MiBfullChip
t5ai(别名 t5)9216001152008 MiBauthInfo, fullChipNoRf
t19216001152008 MiBauthInfo, fullChipNoRf
t39216001152004 MiBauthInfo, fullChipNoRf
t29216001152002 MiBauthInfo, fullChipNoRf
bk7231n9216001152002 MiBauthInfo, fullChipNoRf
ln882h1152001152002 MiBfullChip
other(仅授权)—115200—无
备注

默认选中 t5ai；旧版 t5/T5 别名归一化为 t5ai。

提示

烧录波特率可调高，但不建议超过 2000000。

信息

擦除要求 4 KiB 对齐（0x1000 倍数），仅 other 豁免。

Flash 标签 — 烧录​

多段烧录：最多 10 段，每段含固件路径(.bin/.hex/.elf/.img)+起始/结束地址（十六进制）。新段起始默认=上一段结束；选固件后结束地址自动算 = start+文件大小。所有段填好才启用 Flash 按钮。

Flash 标签——多段烧录，含固件路径与起始/结束地址

Flash 标签——多段烧录，含固件路径与起始/结束地址。

提示

典型场景：bootloader + app 一次写入。

Erase 标签 — 擦除​

按地址擦除（实时校验对齐）或用高级擦除预设（含义同基础概念：authInfo / fullChipNoRf / fullChip）。执行前有确认对话框；地址不对齐时提供"对齐"操作。

擦除会破坏数据

擦除不可撤销。整片擦除清空 RF cal 可能导致设备无法连网。请先备份。

Erase 标签——按地址擦除与高级擦除预设

Erase 标签——按地址擦除与高级擦除预设。

Read 标签 — 读取​

用于备份。选择保存目录（Tauri）或让浏览器下载；默认文件名 tyutool_read_<chip>.bin；结束地址默认取芯片完整容量（整片读取）。文件已存在时选覆盖或追加时间戳。

备注

部分芯片不支持读取。

Read 标签——把 flash 读取到文件用于备份

Read 标签——把 flash 读取到文件用于备份。

Authorize 标签 — 授权​

TuyaOpen UART 授权，写 UUID + AuthKey（掩码显示、不可复制）；有 Copy credentials 按钮。外部链接指向 TuyaOpen 授权购买与本地化文档。操作：

  • 读取授权（Read Auth） —— 只读，仅占用串口不写入。
  • 授权（Authorize） —— 写入；需先填好 UUID + AuthKey，并有确认流程。
危险

凭据妥善保管（购买来的）；other 芯片仅授权、无 flash 插件。

Authorize 标签——UUID/AuthKey 输入（掩码），读取授权与授权操作

Authorize 标签——UUID/AuthKey 输入（掩码），读取授权与授权操作。

进度与日志​

右侧常驻面板：分阶段进度条（每阶段主题色/百分比/indeterminate）+ 日志面板（锁定自动滚动/清空/复制）。

进度条与日志面板——分阶段进度与日志条目

进度条与日志面板——分阶段进度与日志条目。

端口占用​

固件烧录页与串口调试页共用同一批串口。

注意

端口被占用时 tyutool 请你先释放；可在串口调试开自动释放（见串口调试）。