TuyaOpen 授权是什么？
TuyaOpen 授权是让一台设备接入涂鸦 IoT 云的凭据。它由两段字符串组成，由涂鸦签发并与你的产品绑定：
- UUID —— 20 位标识符，每台设备唯一。
- AuthKey —— 32 位密钥，与 UUID 一一对应。
仅当你的应用使用涂鸦云服务时 —— 云连接、App 控制、OTA 或 AI。纯本地与离线项目（蓝牙、Wi-Fi、第三方 API）在免费开源框架上运行，完全无需授权。
TuyaOpen 需要 TuyaOpen 专用的 UUID + AuthKey。来自 TuyaOS（或其他来源）的授权无法在 TuyaOpen 框架内接入云端。
你的设备需要哪个档位？
根据设备的功能匹配档位。你可以先免费起步，之后再写入付费授权 —— 框架与代码保持不变。
本地控制、蓝牙/Wi-Fi、传感器、第三方 API。无云、无授权。
涂鸦云连接、智能生活 App 控制、数据点与 OTA 升级。
在 IoT 之上，增加语音（ASR/TTS）、大模型、视觉与 AI 智能体平台。
获取授权
开发阶段可领取免费授权码；量产时按设备购买授权。
领取 2 个免费开发者授权
开发阶段可在涂鸦开发者平台领取 2 个免费设备授权（价值 ¥20）：
- 登录涂鸦开发者平台并创建产品 —— 任选一个品类（它只是起始模板）。需要 AI-Agent 能力时，选择带 AI 标签的模板。
- 选择 T5 模组，点击「添加自定义固件」，上传任意占位文件作为占位。
- 在产品页面，点击领取 2 个免费授权码。
- 打开授权列表，即可查看你的 UUID 与 AuthKey。
购买量产授权
准备量产时，按设备购买授权（¥5 IoT / ¥12 AI + IoT）。也可订购出厂即预烧录授权的涂鸦模组。
购买授权将授权写入设备
拿到 UUID + AuthKey 后，用适合你工作流的任一方式写入。四种方式效果相同。
头文件（编入固件）
在 tuya_config.h（位于项目的 src 或 include 目录）设置宏，然后重新编译并烧录。适合永久、按构建配置。
// tuya_config.h
#define TUYA_OPENSDK_UUID "uuidxxxxxxxxxxxxxxxx" // 你的 UUID
#define TUYA_OPENSDK_AUTHKEY "keyxxxxxxxxxxxxxxxxxx" // 你的 AuthKey
# 然后：
tos.py build && tos.py flashauth 命令经串口写入
适用于支持 auth CLI 的固件。在烧录串口上打开串口监视器，写入这对值，然后重启。
tos.py monitor -b 115200
tuya> auth uuid9f6a6... cGuDnU2Yxj...
Authorization write succeeds.在 MCU 上，授权写入一次即可 —— 它存于非应用区的键值区，固件升级不会丢失，仅在整片擦除或写入新密钥时清除。
在带文件系统的 SoC（Linux、树莓派）上，授权可编入头文件，或保存为文件在运行时加载。
校验并为设备配网
确认授权已存储、重启，然后在 App 中让设备上线。
- 用 auth-read 命令回读已存授权，确认 UUID 与 AuthKey 为真实值（而非 xxxx）。
- 重启设备使授权生效。
- 在涂鸦智能生活 App 中为设备配网，设备即以该凭据向云端激活。
tuya> auth-read
uuid9f6a6xxxxxxxxxxx
cGuDnU2YxjHJldjxxxxxxxxxxxxxxxxx每个 UUID 同一时间仅能让一台设备上线。要在另一块板子上复用 AuthKey，请先在涂鸦 App 中解绑原设备（设备面板 →「解除绑定并清除数据」）。
故障排查
启动日志显示「Authorization read failure」
授权从未写入，或写入有误。用上述任一方式重新写入 UUID + AuthKey，然后重启。
auth-read 显示 xxxxxxxx 而非真实值
尚未存储授权。用 auth 命令或头文件写入，重启后回读确认。
设备无法配网 / App 中找不到
用 auth-read 确认已存真实 UUID/AuthKey，且为 TuyaOpen（非 TuyaOS）授权、PID 正确。如有需要重新写入、复位设备后重试。Linux 上可删除 tuyadb 文件夹后重新运行。
可以把授权迁到另一台设备吗？
可以，但需先在涂鸦 App 中解绑原设备。一个 UUID 同一时间仅能有一台设备在线。
烧录新固件会清除授权吗？
不会。在 MCU 上授权位于受保护的键值区，固件升级不会丢失，仅整片擦除才会清除。
更多帮助
以下文档对每一步有更深入说明：
企业、批量或定制价格，请联系 service@tuya.com.