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