定义¶

涂鸦（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 专用授权码

各平台三元组对比¶

与本项目（Sentino BK7258）三元组口径的差别¶

Sentino BK7258 项目的三元组口径是 PID + UUID + SECRET + MAC——把 PID（产品级，整批共用）也算进"三元组"，更接近"三件套 + MAC"的实际工程口径。涂鸦的口径里 PID 是产品级常量，不在"三元组"之内。这是命名差异不是本质差异——MAC 都由芯片 efuse 出厂烧好（bk7258-firmware BK7258），UUID/SECRET 都是设备级要量产烧的字段。详见 triple-burning 三种烧录范式 + 本项目选型推导。

相关概念¶

• bk7258-firmware
• device-lifecycle
• ble-provisioning
• iot-platform-fundamentals — 三元组在"后台 vs IoT 概念对照"中等价于"账号 username/password"
• triple-burning — 三元组烧录的三种范式（编译期硬编码 / 量产烧录 / 动态注册）+ 阿里一机一密 / 涂鸦 PMS 业界标杆 + Sentino 本项目选型推导
• iot-mass-production — 三元组烧录在产线两个工位的物理位置（PCBA 治具阶段是唯一窗口）
• beken-at-server — 本项目走自定义 AT 命令烧三元组的具体技术通道