创建产品完成后,需在产品下注册并烧录设备,获取设备认证证书并烧录至设备本地,设备才能具备合法接入设备平台的前提条件。本文介绍目前注册烧录设备的途径与相关接口。

前提条件

已在设备平台完成 创建产品

量产场景

设备在工厂 / 代工厂进行量产的场景,关键流程如下:

1、在 PLM系统 完成 物料编码与ProductID、烧录国家关系配置

2、在 SAP系统 下对应物料编码的 生产订单

3、在 MES系统 根据生产订单完成 SN生成规则配置

4、通过 工厂上位机 请求 『设备注册烧录接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的接入,将烧录信息写入至设备本地的文件路径内。

5、通过 工厂上位机 请求 『更新设备初始固件版本接口』 初始化设备的出厂固件版本号。

6、(可选)通过 工厂上位机/MES系统解析 请求 『添加/更新设备标签接口』,以便灵活根据业务所需从工厂完成数据采集。例如:设备外壳颜色的采集、设备样件阶段的采集等。

设备翻新场景

仅限翻新场景使用。

前置条件:在 MES系统完成 SN生成规则配置

1、通过 工厂上位机 请求 『翻新机烧录注册接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的接入,将烧录信息写入至设备本地的文件路径内。

2、翻新机烧录注册接口将 解绑SN 与 DeviceID的关系并生成新的DeviceID,云端将视该设备为新的设备。

研发调试场景

仅开发阶段调试用,请勿用于量产设备烧录。

研发调试场景目前有 内部上位机手动烧录 两个途径可以进行注册烧录。

通过 内部上位机 进行注册烧录

1、通过 工厂上位机 请求 『设备注册烧录接口』 获取烧录信息,根据 设备端提供的烧录脚本 完成烧录信息的接入,将烧录信息写入至设备本地的文件路径内。

2、通过 工厂上位机 请求 『更新设备初始固件版本接口』 初始化设备的出厂固件版本号。

3、(可选)通过 工厂上位机/MES系统解析 请求 『添加/更新设备标签接口』,以便灵活根据业务所需从工厂完成数据采集。

通过 手动烧录程序 进行注册烧录

前提条件:您的域账号具备相应功能菜单的权限,并至少拥有一个产品的授权。

1、登录 设备平台

2、依次点击 设备管理 > 生成设备,进入页面。

3、选择产品并设置参数后,点击 生成 即可完成注册。

4、点击 下载 可下载对应批次的注册烧录信息压缩包,解压后将设备烧录信息的json文件通过您的烧录工具写入至设备内进行持久化存储。

  1. 单次操作最多生成50个设备的烧录信息文件(json格式),仍需您手动解压后通过烧录软件进行烧录,烧录字段及用途请参见 烧录信息说明
  2. 通过该功能生成的设备,也不会上报出厂固件版本。
  3. 与量产的设备不同在于:SN随机生成、设备均打标签 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-07-15 20:37
最后编辑:陈勇琦  更新时间:2024-10-18 10:58