CSR配置字典之Bios类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | Bios类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建Bios类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
Bios 类
属性 | 值 |
---|---|
类名称 | Bios |
功能描述 | BIOS管理,提供BIOS版本管理、配置清除、升级状态监控和安全启动校验功能 |
所属SIG组 | system |
所属组件 | bios |
责任人 | 系统管理组 |
最后更新 | 2025-01-27 |
状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Slot | String | 0 | - | - | 槽位号 | 槽位号 | "${Slot}" | 硬件提供 | 硬件 |
RecoverFailed | U8 | 0 | 0、1 | - | 校验自愈结果 0:成功 1:失败,上报secure boot failed告警 | 上报secure boot failed告警 | 0 | CSR配置 | 软件 |
ResetCmos | String | 0 | 0、1 | Accessor_CMOS | 清除bios配置 0:未下发清除bios配置 1:已下发清除bios配置 | 清除bios配置 | "#/Accessor_CMOS.Value" | CSR配置 | 软件 |
SystemId | Mixed | 1 | 1~8的整数 | - | Host ID | host id | "${SystemId}" | CSR配置 | 软件 |
Version | String | "" | 依据bios上报 | - | bios固件版本号 | 查看bios固件版本号 | "" | CSR配置 | 软件 |
UpgradeFailed | U8 | 0 | 0、1 | - | 用于判断升级状态 | 判断升级是否失败 | 0 | CSR配置 | 软件 |
可选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Soc | String | "" | - | - | 最新版本属性已废弃 | 已废弃 | "" | 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
}
}
🔧 使用指南
配置步骤
- 设置槽位和系统ID:配置Slot和SystemId标识BIOS所在位置
- 关联CMOS寄存器:通过ResetCmos关联BIOS配置清除的Accessor对象
- 设置版本信息:配置Version显示BIOS固件版本
- 配置状态标志:设置RecoverFailed和UpgradeFailed监控BIOS状态
- 验证关联:确保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配置的验证机制