端到云通信说明
更新时间：2022-11-24 09:20:23下载pdf
设备要连接涂鸦 IoT 开发平台，实现与 App 和涂鸦云端交互，需要遵循涂鸦设备端到云端的一系列规范，本文主要讲解此部分内容及相关示例。
名词解释
| 名称 | 说明 |
|---|---|
| PID | 产品的唯一标识，产品入网的身份证明，App 和云端的配置信息都绑定在 PID 上 |
| DP | 产品的数据模型，描述产品的功能 |
| 固件 Key | PID 下绑定的固件标识 |
| 授权码 | 也叫做生产凭证，设备与 涂鸦 IoT 开发平台 建立连接传输数据的认证信息 |
| 配网 | 设备连接 App 和涂鸦 IoT 开发平台的交互过程 |
PID
产品的唯一标识，相当于产品的身份证，涂鸦云端通过设备端上报的 PID 信息识别出产品并进行相关的交互显示，PID 是非常重要的信息，在创建产品时产生，通常需要将此信息填写在固件代码中。
DP
产品的数据模型，描述产品的功能，用于设备与 App 和云端通信。在配置产品功能时产生，分为以下两种：
固件 Key
固件的标识信息，在 IoT 开发平台硬件开发步骤选择 新增自定义固件 时产生，绑定在 PID 下，包含固件标识名、固件版本、芯片平台、固件类型和升级通道等信息。
| 固件 Key 数据类型 | 说明 |
|---|---|
| 固件标识名 | 使用脚本编译时写入的固件名称 |
| 固件类型 | 根据产品类型选择，NBIOT 协议选择模组固件 |
| 芯片平台 | 根据选择的模组自动生成 |
| 固件版本 | 使用脚本编译时写入的固件版本，上传生产固件时填写 |
固件 key 包含的固件标识名、固件类型、芯片平台、版本号等信息要与编译固件时保持完全一致，否则使用涂鸦上位记烧录授权时会出现错误，不能完成烧录授权。
授权码
是设备与涂鸦 IoT 开发平台建立连接传输数据的认证信息，需要预先烧录到设备中。
配网时，NB 设备在激活后主动向涂鸦 IoT 开发平台注册时，会将此信息上报给云端，云端通过识别此信息，确认是涂鸦认证的设备，将设备连接到涂鸦 IoT 开发平台。
根据不同产品的烧录需求，涂鸦提供三种类型的授权码供自由选择，在授权码下单页面获取。
| 授权码名称 | 说明 |
|---|---|
| 生产凭证 | 加密后的授权码信息，使用涂鸦上位机通过授权协议烧录到设备内，常用于固件烧录+授权一体方案，会对固件 key 包含的固件标识名、固件版本等信息进行校验，防止出现固件烧录错误、版本错误等现象，是涂鸦标准模组使用的烧录方式 ，也是涂鸦最推荐的烧录方式，不过需要涂鸦生产系统支持相应芯片的烧录，不适用于非涂鸦标准芯片。 |
| 生产凭证-仅授权 | 加密后的授权码信息，使用涂鸦上位机通过授权协议烧录到设备内，用于固件烧录+授权分立方案，不对固件 key 包含的信息做校验，适用于非涂鸦标准芯片的授权。 |
| 授权码清单 | 授权码明文信息，由开发者自行开发上位机烧录到设备内，通常不建议使用。 |
配网
NB 模组的配网方式为扫码配网和直接添加设备编号两种方式，后者适用于开发阶段的调试。
关于设备端配网的代码说明，请参考配网 API 及相关文档，关于 App 端配网操作的说明，请参考 App 操作说明。
该内容对您有帮助吗？
是意见反馈该内容对您有帮助吗？
是意见反馈
关注“涂鸦智能”
涂鸦服务尽在掌握
关注“涂鸦开发者”
获取最新涂鸦开发者信息
