1. 固件验签、拆包解析定制要求 ​

定制固件验签、拆包解析需要配置CSR，需要在FirmwareCustomConfig对象中配置CustomVerifyEnabled、CustomVerifyLibraryName、CustomParseEnabled、CustomParseLibraryName属性。属性说明见下表：

2. 流程 ​

固件验签 ​

1. 客户新增 /opt/bmc/luaclib/xxx.so，作为定制hpm解析的接口库(xxx为定制so名称，下同)
2. 客户自行实现 xxx.so内容，需要提供方法 parse_hpm_file供lua接口调用，入参file_path为hpm包路径；响应为状态码，通过约定返回的状态码标识，确定解析状态。当前实现返回状态码如下：

• 正数表示解析成功，负数表示失败，返回负数则直接退出升级流程；
• 返回状态码为1：解析验证固件成功，需要继续openUBMC的验签+解析+升级；
• 返回状态码为2：解析验证固件成功，需要继续openUBMC的解析+升级；
• 返回状态码为3：解析验证固件成功，直接结束固件解析，跳到后续升级

拆包解析 ​

1. 客户新增 /opt/bmc/luaclib/xxx.so，作为定制hpm解析的接口库(xxx为定制so名称，下同)
2. 客户自行实现 xxx.so内容，需要提供方法 custom_parse_pkg供lua接口调用，入参file_path为hpm包路径，output_dir为拆包解析后数据存放目录；响应为true（解析成功）/false（解析失败），且在output_dir下存放必带文件。

3. 配置示例： ​

固件验签 ​

"FirmwareCustomConfig": {
  "CustomVerifyEnabled": true, //客户签名定制使能
  "CustomVerifyLibraryName": "sign_verify" //客户签名定制库为sign_verify.so
}

拆包解析 ​

"FirmwareCustomConfig": {
  "CustomParseEnabled": true, //客户拆包解析定制使能
  "CustomParseLibraryName": "hpm_parser" //客户拆包解析定制库为hpm_parser.so
}

4. 客户定制仓自行实现要求 ​

固件验签定制库内容流程图 ​

拆包解析定制库输入输出要求 ​

固件管理标准流程调用客户定制库时，会传入file_path（hpm包路径），output_dir（拆包解析后数据存放目录），定制库自行对hpm包进行拆包解析，并将解析内容存放在output_dir下，output_dir必带数据如下：

• beforeaction.sh（升级前自定义动作，内容可为空）
• afteraction.sh（升级后自定义动作，内容可为空）
• update.cfg（参考update.cfg规范）
• 解压后的各个固件镜像的二进制数据（命名为FirmwareX，X为固件索引，起始值为1，随着固件数量递增，如Firmware1、Firmware2...，Firmware0用于将update.cfg这个文件作为固件进行描述）

5. update.cfg 规范 ​

Basic 基础信息域 ​

Firmware 固件描述域 ​

FirmwareX 固件描述详细域 ​

当前域会分为多个域进行描述。

Custom 自定义域 ​

可选域，对于固件的自定义描述，如果固件不涉及自定义可不写。

BMC固件升级update.cfg示例 ​

升级时默认从Firmware1开始读取除update.cfg文件之外的固件相关信息

[Basic]
Version=X.XX.XX.XX
Revision=31

[Firmware]
FileNum=2

[Firmware0]
ProductID=0 # 天池机型的productId为0
ComponentID=0
BoardID=255
ProductUIDList=0xXXXXXXXX,0xXXXXXXXX

[Firmware1]
ProductID=0
ComponentID=25
BoardID=255
ProductUIDList=0xXXXXXXXX,0xXXXXXXXX

[Custom]
VersionCustomerA=X.XX.XX
VersionCustomerB=X.XX.XXXXXXXX