라이선스 키란?
Tuya Cloud에 연결할 때 필요한 UUID와 AuthKey를 디바이스에 기록합니다.
- 一个授权码授权一台设备，不能在多台设备间复用。
- TuyaOpen 与 TuyaOS 的授权码不能互换 —— 请使用 TuyaOpen 授权码。
- 授权码与固件相互独立：重新烧录固件时无需重写授权码。
라이선스 키 받기
무료 체험 라이선스를 받거나 양산용 라이선스를 구매할 수 있습니다.
开始前请准备好 UUID 与 AuthKey —— 稍后会粘贴到 tyutool 中。
디바이스에 기록
USB로 보드를 연결하고 tyutool 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"芯片选项 —— 它只写入授权码，不重新烧录固件。