定义¶

涂鸦（Tuya）生产环节中，三元组指每台设备独有的三个身份字段：MAC 地址 + UUID + AuthKey。设备凭此三元组在涂鸦云完成身份认证，缺一不可。

与阿里云 IoT 三元组（ProductKey / DeviceName / DeviceSecret）不同，涂鸦的 PID（Product Key）是产品级别的常量，不算在"三元组"之内。

关键要点¶

• MAC — 设备物理地址，直接明文存储
• UUID — 设备唯一标识符，文件中以 hex 编码的 ASCII 存储（如 356468... → 5dhe05fCWFzd10tc）
• AuthKey — 设备认证密钥，同样 hex 编码存储（如 3565373965... → 5e79e1ad1dc6394b...）
• PID 不在三元组内 — PID 是产品级共享常量，通常在代码中写死（tuya_config.h 中的 TUYA_PRODUCT_KEY）
• 三元组文件格式：CSV，表头 mac,uuid,key,usb_id,result,time，后三列在烧录过程中由工具回填（USB 口标识、烧录结果、时间戳），用于生产追溯
• 烧录方式：
• tyutool GUI：在 "Device Authorization Information" 区域填入 UUID 和 AuthKey，点击 Write
• 编译写入：修改 tuya_config.h 中的 TUYA_DEVICE_UUID 和 TUYA_DEVICE_AUTHKEY，随固件烧录
• nvram 命令（网关类设备）：nvram set UUID xxx && nvram set AUTHKEY xxx && nvram commit
• 授权码来源：涂鸦 IoT 开发平台 → 硬件开发步骤中获取，必须是 TuyaOpen 专用授权码

各平台三元组对比¶

相关概念¶

• bk7258-firmware
• device-lifecycle
• ble-provisioning
• iot-platform-fundamentals — 三元组在"后台 vs IoT 概念对照"中等价于"账号 username/password"