CSR配置字典之BaseOSBoot类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | BaseOSBoot类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026-06-22 |
| 最后更新 | 2026-06-22 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-06-22 | 初始版本 | 创建BaseOSBoot类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
BaseOSBoot 类
| 属性 | 值 |
|---|---|
| 类名称 | BaseOSBoot |
| 功能描述 | 基础OS启动事件配置对象 |
| 所属SIG组 | system |
| 所属组件 | 事件管理 |
| 责任人 | 系统架构组 |
| 最后更新 | 2026-06-22 |
| 状态 | 🟢 正常运行 |
接口信息
| 属性 | 值 |
|---|---|
| MDB路径 | /bmc/kepler/Systems/:SystemId/EventEntries/BaseOSBoot |
| 接口名称 | bmc.kepler.Systems.IPMIEvent |
| 持久化表 | t_base_os_boot |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | 1 | - | - | BIOS 上报事件的持久化主键 primaryKey | BIOS事件持久化标识 | 1 | CSR配置 | 软件 |
SensorType | U8 | 31 | - | - | BIOS 上报事件的传感器类型,默认是 0x1F | BIOS事件传感器类型配置 | 31 | CSR配置 | 软件 |
ReadingType | U8 | 111 | - | - | BIOS 上报事件的读值类型,默认是 0x6F | BIOS事件读值类型配置 | 111 | CSR配置 | 软件 |
EventData | U32 | 4294967295 | - | - | BIOS 上报事件的SEL数据,默认是 0xFFFFFFFF | BIOS事件SEL数据配置 | 4294967295 | CSR配置 | 软件 |
可选属性
无可选属性
🔗 动态关联机制
语法规范
使用 #/xxx 和 <=/xxx 格式实现属性间的动态关联:
yaml
# 语法格式
属性名: "#/目标类.属性名" # 直接关联
属性名: "<=/目标类.属性名" # 条件关联关联说明
- BaseOSBoot类:当前无动态关联属性,所有属性均为静态CSR配置
- 持久化机制:Id属性为主键,数据存储在
t_base_os_boot表中
📂 分类标准
硬件属性
BaseOSBoot类当前无硬件属性
软件属性
- 定义:用于软件层面的OS启动事件管理和配置
- 特点:包含事件传感器类型、读值类型、SEL数据等事件配置功能
- 示例:
Id,SensorType,ReadingType,EventData
ResetPer属性说明
以下属性具有 ResetPer usage标记,表示每次启动周期重置:
- ReadingType:每次启动周期重置为默认值 0x6F
- EventData:每次启动周期重置为默认值 0xFFFFFFFF
📝 配置示例
默认OS启动事件配置
json
{
"BaseOSBoot": {
"Id": 1,
"SensorType": 31,
"ReadingType": 111,
"EventData": 4294967295
}
}自定义传感器类型配置
json
{
"BaseOSBoot": {
"Id": 1,
"SensorType": 15,
"ReadingType": 111,
"EventData": 4294967295
}
}多事件条目配置
json
{
"BaseOSBoot_Entry1": {
"Id": 1,
"SensorType": 31,
"ReadingType": 111,
"EventData": 4294967295
},
"BaseOSBoot_Entry2": {
"Id": 2,
"SensorType": 31,
"ReadingType": 111,
"EventData": 4294967295
}
}🔧 使用指南
配置步骤
- 设置持久化主键:配置Id属性,作为BIOS上报事件的持久化主键
- 设置传感器类型:配置SensorType属性,指定BIOS上报事件的传感器类型
- 设置读值类型:配置ReadingType属性,指定BIOS上报事件的读值类型
- 设置SEL数据:配置EventData属性,指定BIOS上报事件的SEL数据
注意事项
- 主键唯一性:Id作为primaryKey,在持久化表中必须唯一
- 默认值含义:SensorType默认0x1F(31)、ReadingType默认0x6F(111)、EventData默认0xFFFFFFFF(4294967295)
- ResetPer机制:ReadingType和EventData标记为ResetPer,每次启动周期会重置为默认值
- 路径参数:MDB路径中的:SystemId需替换为实际的System ID
- 持久化表:数据存储在
t_base_os_boot表中,确保表结构定义正确
常见问题
- Q: SensorType默认值为31(0x1F)代表什么?
- A: 0x1F是IPMI规范中定义的系统固件进度传感器类型,用于BIOS启动进度事件上报
- Q: ReadingType默认值为111(0x6F)代表什么?
- A: 0x6F是IPMI规范中定义的传感器特定读值类型,表示状态/断言事件
- Q: EventData默认值为4294967295(0xFFFFFFFF)代表什么?
- A: 0xFFFFFFFF表示SEL数据为全默认值,实际使用时由BIOS事件上报填充具体数据
- Q: ResetPer标记的属性如何处理?
- A: ResetPer标记的属性(ReadingType和EventData)会在每次启动周期重置为默认值