使用自定义方案生产设备
本文介绍如何通过面向设备开发,通过中科物栖提供的自定义方案模式,实现接入物栖 OS 的整体操作。同时,介绍了如何使设备具有 OTA 固件升级能力。
前提条件
开发者已在物栖开放平台完成注册和资质认证。开发者应具备 MCU 开发能力,熟悉固件开发流程。
背景信息
本示例的开发环境为 Ubuntu 18.04,开发工具为 GCC Make,以智能插座(BK7231 开发板)为例,通过配置 SDK,接入物栖物联网平台。
设备接入的原理
第一步:在设备接入开放平台完成物模型设计工作
在物栖开放平台管理中心创建产品,具体步骤如下:
- 登录"物栖开放平台管理中心",点击 “产品开发” 菜单项,进入产品开发流程。
- 点击【创建产品】。
- 选择 "自定义方案",单击【去创建】按钮。
- 在创建产品页面,输入产品信息:
- 输入产品名称 "智能插座7231"
- 选择产品品牌 "中科物栖(北京)"
- 输入产品型号 "Jeejio7231"
- 选择通讯类型 "Wi-Fi"
- 选择操作系统 "MCU"
- 选择品类 “智能插座”
- 选择接入方式 "直接接入"
- 选择产品方案 "自定义"
- 选择供电类型 "非电池"
- 输入 "产品描述"
功能定义:
- 单击【创建产品】按钮,进入产品详情页面。
- 单击 "功能定义" 导航,进入功能定义页面。
- 在标准功能页签,点击【添加功能】按钮,在弹窗中选择适用的标准功能。
- 如果需要新增更多功能,则在自定义功能页签,进行功能设计。更多信息请参考:功能设计指导说明
- 在拓展功能页签,点击【添加功能】按钮,在弹窗中选择使用的小应用。
控制设计:
- 单击 “控制设计” 导航,进入控制设计页面
- 点击【选择面板】,选择适用的面板。
- 点击 【引用命令】,在页面中引用适用的命令。
- 点击【新增命令】,可以进行自定义命令的设计。更多信息请参考:命令设计指导说明
硬件开发:
- 单击 "硬件开发" 导航,进入硬件开发页面。
- 根据实际选用的芯片类型,在 “芯片平台” 列表中选择确认。
- 输入该设备所使用模组的名称。
- 点击【确定】按钮可在下方获得对应固件的信息登记入口 和 SDK 的下载链接。
- 请登记初始固件信息,以便后续可正常使用物栖 OS 提供的 OTA 功能。
- 请下载 SDK, 进行线下的设备端开发工作。
产品配置:
- 单击 "产品配置" 导航,进入产品配置页面。
- 点击配网信息的【设置】按钮
- 在配网信息页面完成本设备的配网信息,包括:配网模式和配网引导文案。
测试服务:
- 到此阶段,物模型的设计已完成。请对以上设计进行检查,并提供正式的设计规自测报告。
- 确认物模型设计无误后,请在 “测试服务” 页面上传相关自测报告。
产品发布
单击 "产品发布" 导航,进入产品发布页面。输入对应的信息,并上传必要的文件,点击【发布】将所有设计提交物栖 OS 进行审核确认。
当产品发布审核通过后,产品状态变更为 “开发完成”,即可进入下一个步骤。
第二步:在设备接入开放平台获取到接入云端所需要的密钥
- 登录"物栖开放平台管理中心",点击 “设备管理” 菜单项,进入密钥获取流程。
- 选择要生成密钥的产品,并点击【批量添加】按钮。
- 输入要获取的密钥数量,选择 “设备密钥”选项,输入证书密码。点击【确定】按钮。
- 系统自动生成对应数量的密钥,点击【下载凭证】即可获得对应的密钥文件包。
第三步:为调试设备烧写序列号及密钥
每个设备烧录其唯一的设备证书ProductKey(产品ID)、DeviceKey(设备ID) 和 DeviceSecret(设备密钥)。当设备与物栖 OS建立连接时,物栖 OS 对其携带的设备证书信息进行认证。
- 将证书烧写到设备。
- 下载解密工具压缩文件:http://devdoc.jeejio.com/download/JKeyDecrypt.rar
- 解压后获得解密工具:JKeyDecrypt
- 运行解密工具
- 导入密钥文件包,并填写密钥创建时设置的密码。
- 点击【解密】。
- 解密完成,可获得密钥压缩文件。
- 解压缩文件,获得密钥文件。
- 使用对应的烧录工具,将这些证书烧录到设备上。
- 将证书烧写到设备。
- 密钥使用示例 与配网时的例子相同,调用jeesdk_init ()函数即可启动SDK核心服务,并将相关密钥数据传入即可。
第四步:设备端 SDK 开发指导
进行基于 JeeIM SDK 的开发,请确保已经获取了 JeeIM SDK 和 设备密钥文件包,并将密钥已烧录至设备中。
JeeIM SDK 和 设备密钥文件包需要通过在物栖开放平台管理中心创建产品,才能够获得。具体操作请参考:在设备接入开放平台完成物模型设计工作
设备密钥文件包为加密模式,需要使用解密工具进行解密。解密时需要输入创建密钥文件包时输入的证书密码
点击可下载:解密工具
密钥烧录方法,具体操作参见:为调试设备烧写序列号及密钥。
具体 SDK 的开发流程如下:
第五步:设备调试和商品量产
将开发完成的固件烧录至设备上,即可进行设备调试。
调试成功后,可按照市场需要批量生成密钥文件证书。
获取到密钥证书后,即可进行商品量产。