涂鸦端云逻辑

更新时间：2024-11-20 08:51:23下载pdf

设备要连接涂鸦开发者平台，实现与 App 和涂鸦云端交互，需要遵循涂鸦设备端到云端的一系列规范，本文主要讲解此部分内容及相关示例。

本文涉及的概念如下表所示：

名称	说明
PID	产品的唯一标识，产品入网的身份证明。 App 和云端的配置信息都绑定在 PID 上。
DP	产品的数据模型，用来描述产品的功能。
固件 Key	PID 下绑定的固件标识。
授权码	也称为生产凭证，是设备与涂鸦开发者平台建立连接传输数据的认证信息。

PID

产品的唯一标识，相当于产品的身份证，涂鸦云端通过设备端上报的 PID 信息识别出产品并进行相关的交互显示。PID 是非常重要的信息，在创建产品时产生，通常需要填写在固件代码中。

涂鸦端云逻辑

产品的数据模型，描述产品的功能，用于设备与 App 和云端进行通信。在配置产品功能时产生，分为以下两种：

固件的标识信息，在开发者平台硬件开发步骤选择 新增自定义固件 时产生，绑定在 PID 下，包含固件标识名、固件版本、芯片平台、固件类型和升级通道等信息。详情可查看选择和管理固件版本。

涂鸦端云逻辑

填写说明：

固件 Key 数据类型	说明
固件标识名	使用脚本编译时写入的固件名称。
固件类型	根据产品类型选择，Tuya Beacon 协议选择蓝牙固件。
芯片平台	根据选择的模组自动生成。
固件版本	使用脚本编译时写入的固件版本，上传生产固件时填写。

固件 key 包含的固件标识名、固件类型、芯片平台、版本号等信息要与编译固件时保持完全一致，否则使用涂鸦上位记烧录授权时会出现错误，不能完成烧录授权。

授权码是设备与涂鸦开发者平台建立连接与传输数据的认证信息。授权码需要预先烧录到设备中。

配网时，设备连接到手机蓝牙，在涂鸦开发者平台注册时，会将此信息上报给云端，云端通过识别此信息，确认是涂鸦认证的设备，将设备连接到涂鸦开发者平台。

根据不同产品的烧录需求，在授权码提货时，您可以选择生产凭证、授权码清单，或生产凭证—仅授权的方式进行授权码提货。

涂鸦端云逻辑

授权码说明：

授权码名称	说明
生产凭证	加密后的授权码信息。使用涂鸦上位机通过授权协议烧录到设备内，常用于固件烧录+授权一体方案，会对固件 key 包含的固件标识名、固件版本等信息进行校验，防止出现固件烧录错误、版本错误等现象。是涂鸦标准模组使用的烧录方式，也是涂鸦最推荐的烧录方式。适用范围：需要涂鸦生产系统支持相应芯片的烧录，不适用于非涂鸦标准芯片。
生产凭证-仅授权	加密后的授权码信息。使用涂鸦上位机通过授权协议烧录到设备内，用于固件烧录+授权分立方案，不对固件 key 包含的信息做校验。适用范围：适用于非涂鸦标准芯片的授权。
授权码清单	授权码明文信息。适用范围：由开发者自行开发上位机烧录到设备内，通常不建议使用。