快速开始

名词解释

在开始 TuyaOpen 前，请了解以下相关名词：

授权码（License）是涂鸦统一为设备颁发的安全加密证书，是智能设备运行涂鸦 IoT 操作系统的合法凭证，每台设备都具有唯一的授权码。也就是说，一个授权码代表一个设备接入许可，仅用于一台设备连接和访问云端。

授权码 由 UUID 和 Authkey 组成。

TuyaOpen 专用授权码适用于所有 TuyaOpen Framework 包括：

TuyaOpen Framework 均采用 TuyaOpen 专用授权码，使用其他（包括 TuyaOS）授权码均无法在 TuyaOpen Framework 中用于连接涂鸦云。

UUID，即 Universally Unique Identifier，是涂鸦智能开发智能化产品时设备唯一的识别 ID。UUID 的长度是 20 位，且不会随反复激活配网等操作而更改。

Authkey 是平台为设备颁发的设备密钥，长度是 32 位，和 UUID 是一一匹配的关系，并且和 PID、UUID 强绑定。请注意，该参数很重要，在设备认证时会用到，请妥善保管并且不能泄露。

PID，即 Product ID，是在涂鸦开发者平台创建产品时会生成的唯一的产品编号。PID 关联了产品具体的功能、App 控制面板、出货信息等所有和这个产品相关的信息。如果把产品比喻为人，那么 PID 则是产品的身份证。

通常 PID、UUID、Authkey 被称为设备的三元组。

DeviceID 为设备每次激活配网的时候，云端分配给到的 ID，关联配网后与账号、App 等相关的实际用户设备数据。在某些特定场景下（如在 App 上进入设备面板并点击右上角进入设备属性页面，点击 解绑并清除数据），重新配网激活后，DeviceID 会改变。

方式一：通过生产研发采购购买已烧录了 TuyaOpen 授权码的模组。该授权码已经在出厂时烧录在对应模组中，且不会丢失。TuyaOpen 在启动时会通过 tuya_iot_license_read() 接口读取授权码。请确认当前已购模组是否烧录了 TuyaOpen 授权码。
方式二：如当前模组未烧录 TuyaOpen 授权码：
- 可通过生产研发采购页面购买 TuyaOpen 授权码。
- 可通过购买页面购买 TuyaOpen 授权码。

授权码

在开始快速上手之前，请确保完成以下准备工作：