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

📋 文档信息

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

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02026-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

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
IdU81--BIOS 上报事件的持久化主键
primaryKey
BIOS事件持久化标识1CSR配置软件
SensorTypeU831--BIOS 上报事件的传感器类型,默认是 0x1FBIOS事件传感器类型配置31CSR配置软件
ReadingTypeU8111--BIOS 上报事件的读值类型,默认是 0x6FBIOS事件读值类型配置111CSR配置软件
EventDataU324294967295--BIOS 上报事件的SEL数据,默认是 0xFFFFFFFFBIOS事件SEL数据配置4294967295CSR配置软件

可选属性

无可选属性


🔗 动态关联机制

语法规范

使用 #/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
  }
}

🔧 使用指南

配置步骤

  1. 设置持久化主键:配置Id属性,作为BIOS上报事件的持久化主键
  2. 设置传感器类型:配置SensorType属性,指定BIOS上报事件的传感器类型
  3. 设置读值类型:配置ReadingType属性,指定BIOS上报事件的读值类型
  4. 设置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)会在每次启动周期重置为默认值