端到云通信说明

更新时间: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 操作说明