학습 센터로 돌아가기가이드
라이선스 키 사용하기
TuyaOpen 라이선스 키는 UUID와 AuthKey의 조합입니다. 디바이스에 기록하고 확인하여 Tuya Cloud에 연결하는 방법을 알아봅니다.
라이선스 키란?
Tuya Cloud에 연결되는 모든 TuyaOpen 디바이스에는 UUID(식별자)와 AuthKey(키)로 구성된 라이선스가 필요합니다.
- 一个授权码授权一台设备，不能在多台设备间复用。
- TuyaOpen 与 TuyaOS 的授权码不能互换 —— 请使用 TuyaOpen 授权码。
- 授权码与固件相互独立：重新烧录固件时无需重写授权码。
라이선스 키 받기
평가를 위해 무료 체험 라이선스를 받거나 양산용 라이선스를 구매할 수 있습니다.
라이선스 받기Tuya Developer Platform →
开始前请准备好 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"芯片选项 —— 它只写入授权码，不重新烧录固件。