什么是授权码
每一台接入涂鸦云的 TuyaOpen 设备都需要一个授权码 —— 即 UUID（身份）与 AuthKey（密钥），通过与烧录相同的 UART 写入设备。
- 一个授权码授权一台设备，不能在多台设备间复用。
- TuyaOpen 与 TuyaOS 的授权码不能互换 —— 请使用 TuyaOpen 授权码。
- 授权码与固件相互独立：重新烧录固件时无需重写授权码。
获取授权码
你可以领取免费试用授权码用于评估，或批量购买用于量产。授权与价格详情见授权页面。
开始前请准备好 UUID 与 AuthKey —— 稍后会粘贴到 tyutool 中。
将授权码写入设备
最简单的方式是使用 tyutool。用 USB 连接开发板后，选择 GUI 或 CLI 操作。
使用 tyutool GUI
- 打开 tyutool，切换到"授权"标签页。
- 选择目标芯片 —— tyutool 会自动应用对应的串口参数。
- 选择授权串口。
- 粘贴 UUID 和 AuthKey。
- 点击"开始授权"，随后回读状态以确认。
使用 CLI
在终端中完成同样的操作：
# 读取当前授权状态
tyutool authorize -p /dev/ttyUSB0
# 写入新的 UUID + AuthKey（两者都必填）
tyutool authorize -p /dev/ttyUSB0 \
--uuid <UUID> --authkey <AUTHKEY>验证是否成功
先确认授权码已写入，再检查设备能否在云端激活。
- 回读授权状态（GUI 回读，或上面的 CLI 读取命令），确认 UUID 一致。
- 重启设备并观察串口日志 —— 激活成功会提示设备上线。
- 在涂鸦 App 中配网；设备会使用写入的凭据在云端激活。
故障排查
每次更新固件都要重新写入授权码吗？
不需要。授权码保存在设备的 KV 存储中，重新烧录固件不会丢失；只有在整片擦除（full erase）之后才需要重新写入。
授权失败或超时
确认选择的是授权/烧录口（而非日志口），且没有串口监视器占用该串口，然后重试。
固件已烧录但无法接入云端
可能只烧录了固件却没有写入授权码，或用错了授权码类型。请确认写入的是 TuyaOpen（而非 TuyaOS）的 UUID + AuthKey。
已烧录、只需授权的设备
在 tyutool 中使用授权专用的"other"芯片选项 —— 它只写入授权码，不重新烧录固件。