CSR配置字典之Bios类
更新时间:2025/7/22
在Gitcode上查看源码

📋 文档信息

项目内容
文档标题Bios类配置字典
版本v1.0
创建日期2025-01-27
最后更新2025-01-27
维护状态✅ 活跃维护

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建Bios类配置字典全新文档系统管理员

🎯 类概览

Bios 类

属性
类名称Bios
功能描述BIOS管理,提供BIOS版本管理、配置清除、升级状态监控和安全启动校验功能
所属SIG组system
所属组件bios
责任人系统管理组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SlotString0--槽位号槽位号"${Slot}"硬件提供硬件
RecoverFailedU800、1-校验自愈结果
0:成功
1:失败,上报secure boot failed告警
上报secure boot failed告警0CSR配置软件
ResetCmosString00、1Accessor_CMOS清除bios配置
0:未下发清除bios配置
1:已下发清除bios配置
清除bios配置"#/Accessor_CMOS.Value"CSR配置软件
SystemIdMixed11~8的整数-Host IDhost id"${SystemId}"CSR配置软件
VersionString""依据bios上报-bios固件版本号查看bios固件版本号""CSR配置软件
UpgradeFailedU800、1-用于判断升级状态判断升级是否失败0CSR配置软件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SocString""--最新版本属性已废弃已废弃""CSR配置已废弃

🔗 动态关联机制

语法规范

使用 #/xxx 和变量替换语法实现动态关联:

yaml
# CMOS复位寄存器关联
ResetCmos: "#/Accessor_CMOS.Value"

# 变量替换
Slot: "${Slot}"
SystemId: "${SystemId}"

关联说明

  • ResetCmos: 关联Accessor对象用于BIOS配置清除操作
  • Slot: 使用槽位变量实现动态槽位配置
  • SystemId: 使用系统ID变量标识Host

📂 分类标准

硬件属性

  • 定义:与硬件槽位直接相关的参数
  • 特点:通常由硬件提供
  • 示例Slot

软件属性

  • 定义:用于软件逻辑控制和状态管理的参数
  • 特点:由CSR配置管理
  • 示例RecoverFailed, ResetCmos, SystemId, Version, UpgradeFailed

已废弃属性

  • 定义:不再使用的属性
  • 特点:保持兼容性但不建议使用
  • 示例Soc

📝 配置示例

标准BIOS配置

json
{
  "Bios": {
    "Slot": "${Slot}",
    "RecoverFailed": 0,
    "ResetCmos": "#/Accessor_CMOS.Value",
    "SystemId": "${SystemId}",
    "Version": "",
    "UpgradeFailed": 0
  }
}

多Host系统BIOS配置

json
{
  "Bios": {
    "Slot": "1",
    "RecoverFailed": 0,
    "ResetCmos": "#/Accessor_CMOS.Value",
    "SystemId": "1",
    "Version": "1.0.0",
    "UpgradeFailed": 0
  }
}

升级失败处理配置

json
{
  "Bios": {
    "Slot": "1",
    "RecoverFailed": 1,
    "ResetCmos": "#/Accessor_CMOS.Value",
    "SystemId": "1",
    "Version": "1.0.0",
    "UpgradeFailed": 1
  }
}

🔧 使用指南

配置步骤

  1. 设置槽位和系统ID:配置Slot和SystemId标识BIOS所在位置
  2. 关联CMOS寄存器:通过ResetCmos关联BIOS配置清除的Accessor对象
  3. 设置版本信息:配置Version显示BIOS固件版本
  4. 配置状态标志:设置RecoverFailed和UpgradeFailed监控BIOS状态
  5. 验证关联:确保Accessor对象已正确定义

注意事项

  • CMOS寄存器:ResetCmos必须关联有效的Accessor对象
  • 系统ID范围:SystemId取值范围为1~8的整数
  • 版本管理:Version依据BIOS上报进行更新
  • 状态监控:RecoverFailed和UpgradeFailed用于状态判断
  • 废弃属性:Soc属性已废弃,不建议使用

性能建议

  • 合理配置ID:SystemId应与实际Host个数匹配
  • 优化版本获取:确保BIOS版本能正常上报和更新
  • 状态监控:及时检查RecoverFailed和UpgradeFailed状态

故障排查

  • CMOS清除失败:检查ResetCmos关联的Accessor对象配置
  • 版本获取异常:检查BIOS通信和Version更新机制
  • 升级失败:检查UpgradeFailed状态和升级流程
  • 安全启动失败:检查RecoverFailed状态和安全启动配置
  • 系统识别错误:检查SystemId配置是否正确

BIOS管理

  • 版本管理:Version由BIOS自动上报和更新
  • 配置清除:通过ResetCmos实现BIOS配置的清除
  • 升级监控:UpgradeFailed用于监控BIOS升级状态
  • 安全启动:RecoverFailed用于安全启动校验结果
  • 系统标识:SystemId用于多Host系统中的BIOS识别

安全启动

  • 校验机制:RecoverFailed标识安全启动校验结果
  • 自愈功能:支持安全启动失败后的自愈机制
  • 告警上报:校验失败时上报secure boot failed告警
  • 故障恢复:提供安全启动故障的恢复机制

配置管理

  • CMOS操作:通过ResetCmos实现BIOS配置的清除
  • 配置保护:支持BIOS配置的保护和恢复
  • 默认设置:支持恢复BIOS默认配置
  • 配置验证:提供BIOS配置的验证机制