注册烧录的业务场景说明

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

前提条件

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

量产场景

设备在工厂 / 代工厂进行量产的场景。

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

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

3. 在 MES系统 根据生产订单基于 SN生成规则配置 生成SN；

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

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

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

设备翻新场景

在工厂 / 代工厂对设备进行翻新。

1. 在 MES系统 完成翻新流程的 SN生成规则配置；

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

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

研发调试场景（试产/内部开发）

在 公司内部 进行设备开发、功能调试。与量产的设备不同在于：SN随机生成、设备均打标签 origin: import，用以标记该设备为研发调试设备，而非量产设备。

存在的问题：目前这个链路注册的设备未单独提供接口进行打标区分，完全依赖业务自行按照规则做，会比较影响后续数据分析。

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

优点：无需经过MES系统，可以快速完成烧录动作。

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

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

3. （可选）通过 工厂上位机 请求 『添加/更新设备标签接口』，以便灵活根据业务所需从工厂完成数据采集。

通过 管控平台申请调试设备 进行手动烧录

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

1. 登录 设备平台。依次点击 设备管理 > 生成设备，进入页面。

2. 选择产品并设置参数后，点击 生成 即可完成注册。

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

📢 注意：通过手动烧录时，需自行确认烧录路径与固件代码读取路径/逻辑是一致的，避免烧录后其他业务功能不正确。

• 单次操作最多生成50个设备的烧录信息文件（json格式），仍需您手动解压后通过烧录软件进行烧录，烧录字段及用途请参见 烧录信息说明。
• 通过该功能生成的设备，也不会上报出厂固件版本。

通过 PC虚拟机 进行设备注册

通过 PC虚拟机程序，走开放平台接口请求『设备注册烧录接口』 获取烧录信息，其中打印了两个设备标签country：cntest、origin: import，在国内生产环境注册后默认分发至国内测试环境。

仅 扫地机 采用该方案。

常见问题

1. 如何区分量产设备、内测设备、研发调试设备？

还在梳理的过程中，暂时没有标准。

2. 设备注册后默认加入哪个分组？

若没有设置动态分组规则，设备注册后自动添加进default分组，设备分组相关概念详见设备分组。

相关接口