如何在 OnBoard™ IoT Security 中配置产品

本文将指导你如何在 OnBoard™ IoT Security (OBIS) 中完成以下操作从而配置产品物料，为后续创建版本做准备：

• 配置资源池
• 设定配置项
• 上传烧录站文件

前提条件

在开始之前，请确保：

• 你已拥有对应产品的产品角色权限：Product Owner，Product Manager 或 Resource Manager。
• 已完成证书和密钥的创建。

产品物料分类

每个产品均拥有独立的物料管理系统，用于统一管理各类产品物料。用户可上传固件，配置文件，烧录文件，关联密钥与证书模板，并预先配置产品参数。产品物料分为三个大类并包含不同的类型：

分类	物料类型	说明
资源池	Key	将 KMS 中的密钥添加到该产品。
	Certificate	将 PKI 中的 CA 模板添加到该产品。
	Firmware List	上传该产品需要烧录的固件文件，支持上传 .bin, .hex 和 .s37 格式的固件。
	File List	上传除固件外，创建版本所需的其他文件（支持上传任意格式的文件）。
配置项	Chip Config	选择并设定产品所使用的芯片型号和安全选项。
	Matter Config	选择并设定 Matter 协议相关的设置。
	Factory Data	设定工厂的相关信息。
	Custom certificate configuration	设定自定义证书相关的设置。
	Google certificate configuration	设定 Google Cast 协议相关的设置。
烧录站文件	Programming Script	上传设备烧录时（支持上传任意格式的烧录脚本）使用的脚本文件。
	Attachment Files	上传除烧录脚本外，创建批次所需的其他文件（支持上传任意格式的文件）。

操作步骤

1. 登录 OBIS。

2. 点击左侧菜单中的产品并选择对应的产品，然后在产品页面的资源池，配置项和烧录站文件区域中进行配置。

   信息

   • 资源池和配置项区域的配置用于创建版本。在资源池和配置项区域，配置产品必要的资源与配置项（Certificate，Firmware List，Chip Config，Matter Config，Factory Data）。未完成必要配置时，无法创建版本，产品处于草稿状态。
   • 烧录站文件区域的文件用于创建批次。在烧录站文件区域，上传烧录必要的文件（Programming Script）。或者你也可以后续在 Programming Station 客户端中为特定批次选择烧录脚本。

   

第一步：配置资源池

提示

资源池区域的配置用于创建版本。在配置 Firmware List 和 File List 时上传的文件，之后可以随时在对应资源的配置页面进行下载。

Key（可选）

Key（可选）

提示

配置 Key 的目的是将 KMS 中的密钥添加到该产品，添加的密钥可在配置 Chip Config 时进行选择。

密钥可以在 KMS 中创建，更多信息请参考创建密钥的步骤。

1. 在产品页面，点击资源池区域的 Key，进入 Key 页面。

   

2. 在 Key 页面，点击添加，选择并添加密钥。

   

Certificate（必要）

Certificate（必要）

提示

配置 Certificate 的目的是将 PKI 中的 CA 模板（终端实体模板，DAC 模板或 Device 模板）添加到该产品，添加的 CA 模板可在配置 Matter Config 时进行选择。

CA 模板可以在 PKI 中创建，更多信息请参考创建证书的步骤。

1. 在产品页面，点击资源池区域的 Certificate，进入 Certificate 页面。

   

2. 在 Certificate 页面，点击添加，选择并添加 CA 模板。

   

Firmware List（必要）

Firmware List（必要）

提示

配置 Firmware List 的目的是上传该产品需要烧录的固件文件，支持上传 .bin, .hex 和 .s37 格式的固件。 上传的固件可在创建版本时进行选择。

1. 在产品页面，点击资源池区域的 Firmware List，进入 Firmware List 页面。

   

2. 在 Firmware List 页面，点击上传文件。

   

3. 在确认资源窗口，输入固件相关信息。

   

   固件信息说明：

   信息	是否必填	说明
   上传文件	是	通过选择本地的固件文件进行上传。
   环境	是	有两种环境可以选择，分别是 TEST 环境和 PROD 环境。
   起始地址	否	固件的起始地址。
   版本	否	标识固件版本。
   固件类型	是	支持以下两种类型： Application：用于实现设备功能，依赖 Bootloader 提供的环境。 Bootloader：用于硬件初始化，固件加载与更新。

4. 点击保存，完成 Firmware List 的配置。

File List（可选）

File List（可选）

提示

配置 File List 的目的是上传除固件外，创建版本所需的其他文件（支持上传任意格式的文件）。

上传的文件可在创建版本时进行选择。

1. 在产品页面，点击资源池区域的 File List，进入 File List 页面。

   

2. 在 File List 页面，点击上传文件。

   

3. 在确认资源窗口，选择并输入相关信息。

   

   File List 信息说明：

   信息	是否必填	说明
   上传文件	是	通过选择本地的文件进行上传。
   环境	是	有两种环境可以选择，分别是 TEST 环境和 PROD 环境。
   Key	否	为文件分配 Key。后期烧录时，烧录脚本可通过 Key 调取并使用对应文件。 注释：一个文件可分配多个不重复的 Key。同时，同一个 key 可被分配到多个文件。可新增 Key 或从已有 Key 中进行选择。
   文件版本	否	标识文件版本并用于跟踪文件变更。

4. 点击添加，即可完成 File List 的配置。

第二步：设定配置项

提示

配置项区域的配置用于创建版本。在配置 Matter Config 和 Factory Data 时上传的文件，之后可以随时在对应资源的配置页面进行下载。

Chip Config（必要）

Chip Config（必要）

提示

配置 Chip Config 的目的是选择并设定产品所使用的芯片型号和安全选项。不同的芯片型号在使能设置中会有对应的安全选项，你可以根据实际需求进行配置。

具体列表请参考当前支持的芯片设置。后续将根据需求新增支持的芯片厂商，系列和型号。

1. 在产品页面，点击配置项区域的 Chip Config，进入 Chip Config 页面。

   

2. 在 Chip Config 页面，找到芯片设置区域，选择对应的芯片厂商，系列和型号，然后点击保存。

   

   当前支持的芯片设置：

   厂商	系列	型号
   Beken	BK7238	BK7238
   NXP	s32k1	s32k144
   Qorvo	QPG6200	QPG6200
   Silicon Labs	EFR32MG24	EFR32MG24B210F1536IM48 EFR32MG24B020F1536IM48 EFR32MG24A110F1024IM48 EFR32MG24A020F1536IM48 EFR32MG24A420F1536IM48 EFR32MG24B020F1536IM40 EFR32MG24A010F1024IM40 EFR32MG24A020F1536IM40 EFR32MG24A420F1536IM40 EFR32MG24B010F1024IM48 EFR32MG24A010F1024IM48 EFR32MG24B110F1536IM48 EFR32MG24A021F1024IM40 EFR32MG24B010F1536IM40 EFR32MG24B220F1536IM48 EFR32MG24A020F1024IM40 EFR32MG24A010F1536IM40 EFR32MG24B010F1536IM48 EFR32MG24A410F1536IM48 EFR32MG24A010F1536IM48 EFR32MG24B120F1536IM48 EFR32MG24A410F1536IM40 EFR32MG24B310F1536IM48 EFR32MG24B020F1024IM48 EFR32MG24A020F1024IM48
   	SIMG301	SiMG301M113WIH
   Telink	TLSR92x	TLSR9268J

3. 在使能设置中，你可根据实际需求在生产（PROD）或测试（TEST）环境勾选并启用安全启动和安全调试功能。TEST 环境下，安全启动和安全调试功能的启用可以在版本中进行更改。

   提示

   在创建批次时，如果需要启用重新打开安全调用功能实现芯片的再次烧录，必须启用安全调试功能。

   使能设置项说明（不同的芯片设置会显示不同的设置项）：

   设置项	说明
   安全启动	防止未授权软件加载的安全保护机制。
   安全调试	防止未授权调试的安全保护机制。
   Secure Boot Key	选择在配置 Key 时添加的密钥。用于验证固件的密钥，确保设备的安全启动。
   Secure Boot Key Hash	Secure Boot Key 的哈希值。
   Secure Debug Key	选择在配置 Key 时添加的密钥。用于授权调试访问。 注释：对于 Telink 芯片，该密钥将由 MCU Boot Key 与 Debug Plaintext 计算得出。
   MCU Boot Key	选择在配置 Key 时添加的密钥。用于设备身份认证和数据加密。
   Debug Plaintext	未加密的调试数据。
   DAC Partition Address	设定 DAC 证书下载到闪存的储存地址。

4. 点击保存，即可完成 Chip Config 的配置。

Matter Config（必要）

Matter Config（必要）

提示

配置 Matter Config 的目的是选择并设定 Matter 协议相关的设置。

在此步骤中，需要选择并上传 CD 文件 ，并选择在配置 Certificate 时添加的 DAC 模板。请确保 CD 文件与 DAC 模板中的 VID （供应商 ID）和 PID （产品 ID）保持一致。

在后续创建版本时，你可以根据实际需求更换其他 CD 文件。

1. 在产品页面，点击配置项区域的 Matter Config，进入Matter Config 页面。

   

2. 在 Matter Config 页面，选择或输入 Matter Setting 区域的相关信息。

   

   Matter Settings 信息说明：

   信息	是否必填	说明
   CD 文件	是	上传时需注意： CD 文件中的 VID 和 PID 必须与 DAC 模板中的一致。 如果 CD 文件包含多个 PID，则其中至少有一个必须与 DAC 模板中的 PID 相同。 注释：仅支持上传 .der 格式的 CD 文件。
   产品 ID	是	上传 CD 文件后会出现对应的 PID。
   TEST DAC Template	是	选择在配置 Certificate 时 TEST 环境下的 DAC 模板，DAC 模板中的 VID 和 PID 必须与CD 文件中的一致。
   PROD DAC Template	否	选择在配置 Certificate 时 PROD 环境下的 DAC 模板，DAC 模板中的 VID 和 PID 必须与 CD 文件中的一致。
   Spike2Iteration	是	Matter 配网过程中 SPAKE2+ 协议的一个参数，保障配网过程的安全性。
   配网流程	是	将设备连网配置的过程，适配不同场景： Standard Commissioning Flow User-Intent Commissioning Flow Custom Commissioning Flow
   设备发现模式	是	支持以下两种发现模式： BLE：蓝牙低功耗。 On IP network：通过 IP 网络发现。

3. 点击保存，即可完成 Matter Config 的配置。

Factory Data（必要）

Factory Data（必要）

提示

配置 Factory Data 的目的是设定工厂的相关信息，支持 Matter 规范所需的全部字段。在后续创建版本时，你可以根据实际需求对 Factory Data 进行修改。

1. 在产品页面，点击配置项区域的 Factory Data，进入 Factory Data 页面。

   

2. 在 Factory Data 页面，找到设置区域，输入产品的 Factory Data 信息（值可为空）。

   备注

   如果勾选某个工厂数据 Mandatory 列的复选框，成员在创建版本时必须输入该工厂数据的值。

   

   Factory Data 信息说明：

   提示

   支持的数据类型包括：String，Number，Hex，Factory，DateFormat，TimeFormat 和 File。

   信息	类型	说明
   Start Address	Hex	起始地址。
   Vendor Name	String	供应商名称。
   Product Name	String	产品名称。
   Hardware Version	String	硬件版本。
   Hardware Version String	String	以字符串形式呈现的硬件版本信息，可能包含更详细的版本描述，例如，HW_V1.0_20240101。
   Part Number	String	型号编号。
   Product URL	String	产品链接。
   Product Label	String	产品标签。
   Manufacturing Date	DateFormat	生产日期，默认格式为 yyyyMMdd。
   Manufacturing Time	TimeFormat	生产时间，默认格式为 HHmmss
   Manufacturing Code	String	生产代码。
   Factory Name	Factory	生产批次的工厂名称。

3. 点击保存，即可完成 Factory Data 的配置。

Custom certificate configuration（可选）

Custom certificate configuration（可选）

提示

配置 Custom certificate configuration 的目的是设定自定义证书相关的设置。

1. 在产品页面，点击配置项区域的新增。

   

2. 在确认资源窗口，设置名称，类型和 Resource key。

   

   资源信息说明：

   信息	说明
   名称	资源名称。
   类型	资源类型。
   Resource Key	Resource key 必须唯一。

3. 在配置项区域点击刚新增的配置项。

   

4. 在自定义证书设置区域, 选择在配置 Certificate 时添加的终端实体模板。

   

5. 点击保存，即可完成 Custom certificate configuration 的配置。

Google certificate configuration（可选）

Google certificate configuration（可选）

提示

配置 Google certificate configuration 的目的是设定 Google Cast 协议相关的设置。

1. 在产品页面，点击配置项区域的新增。

   

2. 在确认资源窗口，设置名称，类型和 Resource key。

   

   资源信息说明：

   信息	说明
   名称	资源名称。
   类型	资源类型。
   Resource Key	Resource key 必须唯一。

3. 在配置项区域点击刚新增的配置项。

   

4. 在谷歌证书设置区域, 选择在配置 Certificate 时添加的 Device 模板。

   

5. 点击保存，即可完成 Google certificate configuration 的配置。

第三步：上传烧录站文件

提示

烧录站文件区域的文件用于创建批次。在配置 Programming Script 和 Attachment Files 时上传的文件，之后可以随时在对应资源的配置页面进行下载。

Programming Script（可选）

Programming Script（可选）

提示

配置 Programming Script 的目的是上传设备烧录时使用的脚本文件（支持上传任意格式的烧录脚本）。上传的烧录脚本可在创建批次时进行选择。

你可以根据实际需求选择并上传烧录脚本；如果暂不需要，后续可在 Programming Station 客户端中为特定批次选择烧录脚本。

1. 在产品页面，点击烧录站文件区域的 Programming Script，进入 Programming Script 页面。

   

2. 在 Programming Script 页面，点击上传文件。

   

3. 在确认资源窗口，选择并输入烧录脚本相关信息。

   

   Programming Script 信息说明：

   信息	是否必填	说明
   上传脚本文件	是	用户通过选择本地的烧录脚本进行上传。
   版本	否	标识烧录脚本的版本。
   环境	是	有两种环境可以选择，分别是 TEST 环境和 PROD 环境。
   选择厂商	否	选择对应的芯片厂商。

4. 点击保存，即可完成 Programming Script 的配置。

Attachment Files（可选）

Attachment Files（可选）

提示

配置 Attachment Files 的目的是上传除烧录脚本外，创建批次所需的其他文件（支持上传任意格式的文件）。

上传文件后，可在创建批次时进行选择。

1. 在产品页面，点击烧录站文件区域的 Attachment Files，进入 Attachment Files 页面。

   

2. 在 Attachment Files 页面，点击上传文件。

   

3. 在确认资源窗口，选择并输入相关信息。

   

   Attachment Files 信息说明：

   信息	是否必填	说明
   上传文件	是	通过选择本地的文件进行上传。
   环境	是	有两种环境可以选择，分别是 TEST 环境和 PROD 环境。
   Key	否	为文件分配 Key。后期烧录时，烧录脚本可通过 Key 调取并使用对应文件。 注释：一个文件可分配多个不重复的 Key。同时，同一个 key 可被分配到多个文件。可新增 Key 或从已有 Key 中进行选择。
   文件版本	否	标识文件版本并用于跟踪文件变更。

4. 点击添加，即可完成 Attachment Files 的配置。