创建产品完成后,需在产品下注册并烧录设备,获取设备认证证书并烧录至设备本地,设备才能具备合法接入设备平台的前提条件。本文介绍目前注册烧录设备的途径与相关接口。
前提条件
已在设备平台完成 创建产品。
量产场景
设备在工厂 / 代工厂进行量产的场景。
在 PLM系统 完成 物料编码与ProductID、烧录国家关系配置;
在 SAP系统 下对应物料编码的 生产订单;
在 MES系统 根据生产订单基于 SN生成规则配置 生成SN;
通过 工厂上位机 请求 『设备注册烧录接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的写入,将烧录信息写入至设备本地的文件路径内。
通过 工厂上位机 请求 『更新设备初始固件版本接口』 初始化设备的出厂固件版本号。
(可选)通过 工厂上位机/MES系统 请求 『添加/更新设备标签接口』,以便灵活根据业务所需从工厂完成数据采集。例如:设备外壳颜色的采集、设备样件阶段的采集等。
设备翻新场景
在工厂 / 代工厂对设备进行翻新。
在 MES系统 完成翻新流程的 SN生成规则配置;
通过 工厂上位机 请求 『翻新机烧录注册接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的接入,将烧录信息写入至设备本地的文件路径内。
翻新机烧录注册接口将 解绑SN 与 DeviceID的关系并生成新的DeviceID,云端将视该设备为新的设备。
研发调试场景(试产/内部开发)
在 公司内部 进行设备开发、功能调试。与量产的设备不同在于:SN随机生成、设备均打标签
origin: import
,用以标记该设备为研发调试设备,而非量产设备。
存在的问题:目前这个链路注册的设备未单独提供接口进行打标区分,完全依赖业务自行按照规则做,会比较影响后续数据分析。
通过 内部上位机 进行注册烧录
优点:无需经过MES系统,可以快速完成烧录动作。
通过 工厂上位机 请求 『设备注册烧录接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的接入,将烧录信息写入至设备本地的文件路径内。
通过 工厂上位机 请求 『更新设备初始固件版本接口』 初始化设备的出厂固件版本号。
(可选)通过 工厂上位机 请求 『添加/更新设备标签接口』,以便灵活根据业务所需从工厂完成数据采集。
通过 管控平台申请调试设备 进行手动烧录
前提条件:您的域账号具备相应功能菜单的权限,并至少拥有一个产品的授权。
登录 设备平台。依次点击 设备管理 > 生成设备,进入页面。
选择产品并设置参数后,点击 生成 即可完成注册。
点击 下载 可下载对应批次的注册烧录信息压缩包,解压后将设备烧录信息的json文件通过您的烧录工具写入至设备内进行持久化存储。
📢 注意:通过手动烧录时,需自行确认烧录路径与固件代码读取路径/逻辑是一致的,避免烧录后其他业务功能不正确。
- 单次操作最多生成50个设备的烧录信息文件(json格式),仍需您手动解压后通过烧录软件进行烧录,烧录字段及用途请参见 烧录信息说明。
- 通过该功能生成的设备,也不会上报出厂固件版本。
通过 PC虚拟机 进行设备注册
通过 PC虚拟机程序,走开放平台接口请求『设备注册烧录接口』 获取烧录信息,其中打印了两个设备标签country:cntest
、origin: import
,在国内生产环境注册后默认分发至国内测试环境。
仅 扫地机 采用该方案。
常见问题
1. 如何区分量产设备、内测设备、研发调试设备?
还在梳理的过程中,暂时没有标准。
2. 设备注册后默认加入哪个分组?
若没有设置动态分组规则,设备注册后自动添加进default分组,设备分组相关概念详见设备分组。
相关接口
接口名称 | 接口文档 | 接口用途 |
---|---|---|
设备注册烧录 | http://aiot-automate.narwal.com/document?shareId=ed107ef8-7f49-4143-85ad-033f517ec87f#/setting | 量产、研发调试设备注册烧录 |
获取产品列表 | https://open-api.narwaltech.com/m/preview/33 | 获取对应环境内设备平台的全量产品列表 |
获取国家列表 | http://aiot-automate.narwal.com/document?shareId=270daf55-1e9a-4a55-b379-01f9349f1c92#/setting | 获取全量的国家名称及国家码 |
翻新机烧录注册接口 | http://aiot-automate.narwal.com/document?shareId=142cd5b6-c01e-45c8-8519-63d14054b69f#/setting | 仅用于翻新场景 |
更新设备初始固件版本 | http://aiot-automate.narwal.com/document?shareId=c5902a74-5e65-4e25-a091-14254db8ccc5#/setting | 初始化设备出厂固件版本号 |
添加/更新设备标签 | http://aiot-automate.narwal.com/document?shareId=f4798657-e941-4c76-b476-b403f7805b0a#/setting | 添加额外的设备标签信息 |
最后编辑:陈勇琦 更新时间:2024-10-18 10:58