跳到主要内容

基础概念

在动手点击按钮之前,先花几分钟读懂这套词汇表——它能让你在后续每一页都看得明白。本页只讲概念,不涉及具体操作。

tyutool 通过一条串口链路与设备通信:电脑上的 tyutool 发出的指令,经由 USB 转串口适配器,以 UART 电信号的形式送达设备里的 SoC,最终读写那颗 flash 芯片。下图展示了这条链路的完整拓扑。

图 1 · tyutool 到设备的烧录链路拓扑:tyutool → USB → 适配器 → UART(TX/RX/GND) → SoC → Flash 芯片

图 1 · tyutool 到设备的烧录链路拓扑:tyutool → USB → 适配器 → UART(TX/RX/GND) → SoC → Flash 芯片。

阅读建议

第一次接触固件烧录?建议按顺序读完前 6 节;第 7、8 节可作为术语速查表。

什么是固件

固件(firmware)就是存放在设备 flash 芯片里的程序。烧录固件通常是为了升级(增加功能)、修复(修复 bug)或定制(烧入你自己的构建)。固件本质上就是一段字节数据。

什么是烧录 / 刷写

烧录(flashing,也叫刷写/写入)就是把固件字节写入设备 flash 芯片的动作。链路传数据:① tyutool 读固件切块 → ② 经 USB 到适配器转 UART → ③ UART(TX/RX/GND) 到 SoC 写 flash。

注意

烧录是覆盖性写入。重要数据请先读取备份。

擦除 Erase

擦除把 flash 某些区域清空为 0xFF。典型场景:写入前清场 / 整片擦除。擦除预设:

擦除预设含义
authInfo只擦除授权信息区(UUID/AuthKey),保留固件与其他数据
fullChipNoRf整片擦除,但保留射频校准区(RF cal)
fullChip整片完全擦除(含射频校准)
提示

fullChipNoRf 是最常用的"安全彻底擦除"。

读取 Read

读取是烧录的逆操作:把 flash 芯片里的字节读出来,用于备份(整片读取或分段读取)。

授权 Authorize

授权(TuyaOpen UART auth)写入 UUID + AuthKey,让设备能连涂鸦云。授权与固件是两件独立的事。

危险

UUIDAuthKey 是从涂鸦购买来的凭据,写入伪造/重复凭据会污染设备池。

授权分两种操作:授权读取(auth-read)/ 授权写入(auth-write)。

串口 / UART / 波特率

串口、USB 转串口适配器(CH340/CP2102/FT232)、UART 三线(TX/RX/GND,交叉接线)、波特率:

波特率典型用途
115200最通用、最稳定的默认速率
460800较快,稳定性仍较好
921600高速,需芯片与线材支持
提示

115200 开始最稳妥。

芯片型号

芯片型号决定了通信协议、波特率与 Flash 容量。完整列表见固件烧录命令行

TY 工具术语表

术语含义
Flash把固件写入 flash 芯片
Erase把 flash 区域清空为 0xFF
Read把 flash 芯片里的字节读出来
Authorize写入 UUID/AuthKey 凭据
UUID设备唯一标识(凭据)
AuthKey与 UUID 配对的认证密钥
Baud串口通信速率
UART走 TX/RX/GND 线的串口协议
Segment多段烧录里的一段连续块
Erase preset命名的擦除范围(如 authInfo
MAC设备的媒体访问控制地址