【已评审】新增接口管理SSU BIOS模块

Component Drivers SIG 部件驱动评审
1

SSU（Smart Storage Unit）模组是独立计算/存储单元，BMC 需对模组进行带外管理。SSU模组是独立系统，拥有自己的BIOS固件，需要属性标识当前SSU BIOS启动项配置，固件版本。

关联ISSUE

[需求]: 支持ASU模组的BIOS固件带外升级-component_drivers-AtomGit
[需求]: 支持ASU模组的BIOS启动参数设置和查询-component_drivers-AtomGit

整体方案

1.新增bios固件信息设备树协作接口 bmc.dev.Bios ，并在该接口下新增Version属性，由带外定时获取对应BIOS固件版本，将获取到的数据刷新到设备树协作接口属性上，供北向查询使用。
2.新增bios启动项配置设备树协作接口 bmc.dev.BootOptions ，并在该接口下新增属性和方法，由带外定时获取对应BIOS启动项配置，将获取到的数据刷新到设备树协作接口属性上，供北向查询使用，以及提供方法供北向使用设置对应的BIOS启动项配置。

评审点

1.新增设备树协作接口 bmc.dev.Bios，并在该接口下新增Version属性。
2.新增设备树协作接口 bmc.dev.BootOptions ，并在该接口下新增BootSourceOverrideEnabled、BootSourceOverrideTarget、BootOrder属性，新增SetStartOptionFlag、SetStartOption方法。

详细描述

评审点1：新增设备树协作接口 bmc.dev.Bios 及属性

变更描述：
SSU 模组BIOS接入设备树后缺少正式的南向接口定义，新增接口承载。

接口路径：
/bmc/dev/Systems/:SystemId/SSUCards/:Id

接口链接：
bmc.dev.Bios

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性 变更影响
Version String True false BIOS固件版本 Read: ReadOnly 带外获取 PoweroffPer 否 无影响

评审点2：新增设备树协作接口 bmc.dev.BootOptions 及属性

变更描述：
SSU 模组BIOS接入设备树后缺少正式的南向接口定义，新增接口承载。

接口路径：
/bmc/dev/Systems/:SystemId/SSUCards/:Id

新增属性

接口链接：
bmc.dev.BootOptions

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性 变更影响
BootSourceOverrideEnabled s True false 启动项生效模式 Read: ReadOnly 带外获取 PoweroffPer 否 无影响
BootSourceOverrideTarget s True false 优先启动项 Read: ReadOnly 带外获取 PoweroffPer 否 无影响
BootOrder as True false 默认启动顺序 Read: ReadOnly 带外获取 PoweroffPer 否 无影响

新增方法

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述
SetStartOptionFlag s BootSourceOverrideEnabled:启动项生效模式 i Result: 返回结果，0：执行成功；-1：执行失败 设置启动项生效模式
SetStartOption s BootSourceOverrideTarget:优先启动项 i Result: 返回结果，0：执行成功；-1：执行失败 设置优先启动项

是否准备好AI预审

是

评审结论

同意评审点1：新增设备树协作接口 bmc.dev.Bios 及属性

新增接口 bmc.dev.Bios 承载SSU BIOS固件信息，新增如下属性：

  • Version：BIOS固件版本

同意评审点2：新增设备树协作接口 bmc.dev.BootOptions

新增接口 bmc.dev.BootOptions承载SSU BIOS启动项配置，新增如下属性：

  • BootSourceOverrideEnabled：启动项生效模式
  • BootSourceOverrideTarget：优先启动项
  • BootOrder：默认启动顺序

新增如下方法：

  • SetStartOptionFlag：设置启动项生效模式
  • SetStartOption：设置优先启动项

遗留问题