Chassis 机框管理服务
版本信息
| 项目 | 内容 |
|---|---|
| 组件版本 | 1.80.57 |
| 首发版本 | openUBMC 25.3.0 |
| 文档作者 | |
| 最后更新 | 2026-10-27 |
1. 组件概述
1.1 组件简介
Chassis(机框管理服务)是 openUBMC 的机框管理组件,围绕机箱物理状态与指示灯两条主线对外提供服务。组件由 chassis_app 统一编排,通过 CSR 自发现把 Led、Chassis、LedDispControl、I2cLed、SuperPodLabel、Enclosure、NCSICapabilities、ADCVoltageConfig、UBConfiguration 等对象分发到各业务 service,对外同时暴露资源协作接口(RPC)、IPMI 命令与配置导入导出三类入口。
本组件主要包括 7 大功能特性:
| 序号 | 功能特性 | 功能描述 |
|---|---|---|
| 1 | 整机状态管理 | 开箱事件检测、UID 按钮事件上报、设备数量/最大可插数量统计、整机状态统计 |
| 2 | I2cLed 灯控制 | 为装备测试提供控制 I2C 灯状态的手段 |
| 3 | LED 灯控制 | 控制 UID 定位灯状态;基于当前告警控制健康灯颜色变化;远程登录闪烁、电源升级独占锁 |
| 4 | Led 数码管显示 | 基于当前告警在数码管上显示错误码,或显示机箱框号 |
| 5 | 度量数据采集 | 向 metric_analyzer 组件提供进风口/出风口温度数据 |
| 6 | 读取设备配置能力 | 读取 PCIe 标卡 NCSI 线缆是否在位、主板对 PCIe 标卡 NCSI 功能是否支持 |
| 7 | 超节点属性配置与获取 | SuperPodId、ServerIndex、NPU 规模(SuperPodSize)等经 CPLD 下发给芯片 |
1.2 核心功能
整机状态管理
开箱事件检测:常驻协程周期读取 SMC 寄存器,区分钟 AC 上电/下电两种开箱,支持断电记忆; UID 按钮事件:短按通过属性监听翻转 UID 灯,长按在启动后检查寄存器并上报复位类事件; 设备数量统计:遍历资源树统计 CPU/Memory/PCIe/Disk/Psu/Fan 等实时数量,并结合
Connector计算最大可插数量,写入DeviceSpecication; 整机状态统计:GetPowerCmd汇总开机策略、电源故障、UID、风扇/硬盘健康状态;GetChassisCapabilities读写机箱能力。LED 灯控制
UID 定位灯(Id=4):支持常亮/闪烁/关闭、identify 倒计时、远程登录闪烁、电源升级独占锁; 健康灯(Id=2):按
LedPolicy的 Normal/Minor/Major/Critical 策略,按SeverityReferenceSource取Events.Health、Sensors.Health、Events.HardwareHealth之一或取严重者,控制颜色与闪烁; 多 System/ASU:按SystemId分别为各子系统健康灯点灯,并按ControlOwner做主从拦截; 模块定位灯:ASU/SSU 模块定位灯只支持“点亮(硬件固定频率闪烁)”与“关闭”,不支持常亮、可控闪烁与灯测试,且仅主 BMC 可写。I2cLed 灯控制
面向装备测试,控制"不需要用户管理"的 I2C 灯;支持常亮、闪烁、新常灭等状态。
Led 数码管显示
3 位数码管:
LedDispMode=0循环显示当前告警的LedFaultCode;LedDispMode=1显示机箱框号(仅主 BMC)。启动时 3 次全亮/全灭自检。度量数据采集
实现
bmc.kepler.Metric接口,对外提供chassis.inlettemp/chassis.outlettemp两个采集项,并支持事件触发式采集信号。读取设备配置能力
实现
bmc.kepler.Systems.NCSICapabilities与GetDeviceCapabilities/SetDeviceCapabilities,读取 PCIe 标卡 NCSI 线缆在位、主板 NCSI 支持能力等。超节点属性配置与获取
bmc.kepler.Chassis.SuperPodLabel提供 SuperPodId、ServerIndex、SuperPodSize、TopologyType、UBMDeployMode 等属性的配置与获取,经 CPLD 寄存器下发,并用 CRC16 校验;节点 ID 通过 ADC 电压识别后写入LogicalSlotNumber;PSR 中配置的 serdes index 通过UBConfiguration下发。
1.3 关键术语表
| 术语 | 解释 |
|---|---|
| 开箱事件 | 机箱盖被打开产生的事件,组件区分 AC 上电开箱(IntrusionACOn)与 AC 下电开箱(IntrusionACOff),并持久化"曾开箱"标志 |
| UID | Unit Identification,定位/识别指示灯,用于在机房中定位目标设备 |
| UID 短按/长按 | UID 按钮按下较短时间会翻转 UID 灯;长按(约数秒)会复位 BMC |
| LCS(Local Control State) | 本地控制模式,灯由 BMC 自身策略控制 |
| OS(Override State) | 超驰模式,灯由 IPMI/上层显式设置覆盖本地控制 |
| 健康灯策略 | 由 bmc.kepler.Systems.Led.Policy 定义的不同告警等级对应的颜色/状态组合 |
| 数码管 | 机箱面板上的 3 位七段数码管,用于显示告警错误码或机框号 |
| I2cLed | 通过 I2C 控制、无需用户管理的指示灯,主要用于装备测试 |
| NCSI | Network Controller Sideband Interface,网络控制器边带接口;NCSI 线缆用于 BMC 与网卡之间的共享网口通信 |
| SuperPod | 超节点,多个计算节点通过 UB 总线组网形成的大规模计算集合 |
| UB(UnifiedBus) | 统一总线,超节点内节点互联的高速总线 |
| ASU / SSU | 挂在整机下的子模块;ASU/SSU 拥有各自的 SystemId,可含独立的定位灯与健康灯 |
| ControlOwner | SSUCard 的主从属性,标识该 SSU 由哪一侧 BMC 管理 |
| ADC 节点 ID | 通过 ADCVoltageConfig 读取的电压值换算出的物理节点 ID,写入 LogicalSlotNumber |
| serdes index | 高速串行接口参数索引,由 PSR 配置经 UBConfiguration 下发给 CPLD |
| CRC16 | 循环冗余校验,用于保证下发到 CPLD 的超节点属性数据一致性 |
| AC / DC | 交流/直流;开箱检测区分上电(AC On)与下电(AC Off)两个寄存器 |
1.4 外部交互边界图
说明:北向接口(Redfish/Web/CLI/SNMP)由 rackmount 通过 D-Bus 资源协作接口调用 chassis;IPMI 命令由 ipmi_core 路由,chassis 向其注册处理函数;南向通过 hwproxy 的 Accessor/Scanner 读写 CPLD 与 SMC 寄存器。健康灯策略依赖 event 与 sensor,整机状态依赖 fructrl,远程登录闪烁依赖 session,主从判断依赖 SSUCard 的
ControlOwner与ActiveStandby.Status。
2. API 使用说明与示例
本章命令按标准机型给出实际值(服务名
bmc.kepler.chassis、/bmc/kepler/Chassis/1、/bmc/kepler/Systems/1/Leds/Led_UIDLed_0101),可整段复制执行。 路径末段是否为对象名取决于mdb_interface的路径参数::ID/:Id取对象名(带_0101这类位置后缀,如Led_UIDLed_0101),:SystemId/:ChassisId取对象属性/主键值,不带位置后缀(如/bmc/kepler/Chassis/1)。路径以busctl --user tree bmc.kepler.chassis | grep -i <关键字>的实际输出为准。 IPMI 示例中的<BMC的IP>、<用户名>、<密码>需替换为实际值;busctl传数组参数时需先给元素个数(a{ss}写a{ss} 0、aq写aq <个数> <元素...>)。
2.1 LED 灯控制(bmc.kepler.Systems.Led)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Systems.Led |
| 路径 | /bmc/kepler/Systems/:SystemId/Leds/:ID |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 默认值 | 描述 |
|---|---|---|---|---|
| Name | String | 是 | NA | LED 灯的名称 |
| OnDuration | U8 | 是 | 0 | 亮灯持续时间 |
| OffDuration | U8 | 是 | 0 | 关灯持续时间 |
| Capability | U8 | 是 | NA | 颜色,3:绿色,2:红色 |
| SystemId | U8 | 是 | NA | 系统 ID |
| State | U8 | 否 | NA | 当前 LED 灯的状态 |
| Id | U8 | 是 | NA | 每个 LED 灯对应的固定 ID(整机 UID=4、健康灯=2);仅用于组件内部判断,不出现在对象路径中 |
| FruId | U8 | 是 | NA | 关联的 FRU ID |
| ColorCapabilities | U8 | 是 | NA | LED 灯支持的颜色能力(位图) |
| LocalControlStateColor | String | 是 | NA | 本地控制模式下的颜色 |
| OverrideStateColor | String | 是 | NA | 超驰状态下的颜色 |
| Mode | U8 | 是 | NA | Led 模式 |
| DefaultLCSColor | U8 | 是 | NA | 本地控制模式默认颜色,0:reserved,1:BLUE,2:RED,3:GREEN,4:AMBER,5:ORANGE,6:WHITE |
| DefaultOSColor | U8 | 是 | NA | 超驰模式默认颜色,取值同 DefaultLCSColor |
| 方法名 | 入参类型 | 出参类型 | 描述 | 取值范围 |
|---|---|---|---|---|
| SetState | yy | yyy | 设置 LED 灯的状态(仅 Id=4 的 UID 灯) | y: State 灯状态(0=关,0xFF=常亮,5=慢闪,7=快闪,1=模块灯闪烁) y: Interval 闪烁持续时长,单位:秒,闪烁时需大于 0( interval=0 与闪烁态组合会报 OperationFailed)出参: State / OnDuration / OffDuration |
| SetLock | su | - | 设置 LED 灯锁(仅整机 UID 灯支持) | s: OperationType,Lock 加锁 / Unlock 解锁u: TimeoutSeconds,超时自动解锁,范围 10~3600,单位 s |
返回值与异常
| 返回值类型 | 含义 | 触发条件 | 处理建议 |
|---|---|---|---|
| yyy | 设置成功 | 参数校验通过并成功写灯 | 无 |
| OperationFailed | 操作失败 | LED 对象不存在、对非 UID 灯调用 SetState、模块定位灯下发不支持的状态 | 确认 Id/Name 对应的 LED 已上树;模块灯只接受 State=1(点亮,固定频率闪烁)或 State=0(关闭) |
| OperationNotAllowed | 操作被拒绝 | UID 灯被其他方独占锁定 | 等待锁定方解锁或锁超时 |
| UnrequiredProperty | 参数非法 | state=ON 且 interval!=0 | 常亮时不要传闪烁时长 |
| PropertyValueNotInList | 参数取值非法 | SetLock 的 OperationType 不是 Lock/Unlock | 使用合法操作类型 |
| PropertyValueOutOfRange | 参数范围非法 | SetLock 的 TimeoutSeconds 不在 10~3600 | 使用 10~3600 的秒数 |
限制条件
SetLock仅对整机 UID 灯(Id=4)生效;对其他 LED 调用不改变灯态,只记录 error 日志,调用本身返回成功;- 模块定位灯只接受
State=1(点亮,硬件固定频率闪烁)与State=0(关闭),0xFF(常亮)、5/7(可控闪烁)等均返回OperationFailed; SetState仅对Id=4的 UID 灯生效,对其他 LED(如Id=2健康灯)调用返回OperationFailed(报文This operation is not supported.);- 整机 UID 灯被独占锁定时,非锁定方的
SetState返回OperationNotAllowed;SSU 模块灯不受该锁影响,由主从判断控制,从 BMC 写灯返回OperationFailed; Interval单位为秒,仅闪烁时有意义;State=0xFF(常亮)时必须为 0,否则返回UnrequiredProperty;- 锁超时后自动释放并恢复原闪烁倒计时。
调试示例
# 点亮 UID 灯(State=0xFF 常亮)
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds/Led_UIDLed_0101 bmc.kepler.Systems.Led \
SetState a{ss}yy 0 0xFF 0
# 闪烁 UID 灯(State=5 慢闪,Interval=10 即 10s)
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds/Led_UIDLed_0101 bmc.kepler.Systems.Led \
SetState a{ss}yy 0 5 10
# 电源升级前对 UID 灯加锁,超时 3600s
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds/Led_UIDLed_0101 bmc.kepler.Systems.Led \
SetLock a{ss}su 0 "Lock" 3600
# 升级结束解锁
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds/Led_UIDLed_0101 bmc.kepler.Systems.Led \
SetLock a{ss}su 0 "Unlock" 102.2 LED 亮灯策略(bmc.kepler.Systems.Led.Policy)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Systems.Led.Policy、bmc.kepler.Systems.Led.Policy.SystemHealth |
| 路径 | /bmc/kepler/Systems/:SystemId/Leds |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 描述 |
|---|---|---|---|
| Normal | U16[] | 否 | Normal 等级亮灯策略,每项为 {颜色, 状态} |
| Minor | U16[] | 否 | Minor 等级亮灯策略 |
| Major | U16[] | 否 | Major 等级亮灯策略 |
| Critical | U16[] | 否 | Critical 等级亮灯策略 |
| SeverityReferenceSource | String | 否 | 健康灯严重等级来源,枚举:Event、Sensor、EventAndSensor、HardwareEvent,默认 Event |
各枚举取值对应的健康状态来源:
| 取值 | 健康状态来源 |
|---|---|
Event | 主 System 读 Events.Health,多 System 读 EventSummary.Health |
Sensor | 读 Chassis/1/Sensors 的 Health |
EventAndSensor | Events.Health 与 Sensors.Health 取严重者 |
HardwareEvent | 主 System 读 Events.HardwareHealth,多 System 读 EventSummary.HardwareHealth,不读取 Health |
HardwareEvent自组件版本 1.80.57(openUBMC 26.12)引入。HardwareHealth的统计规则与事件配置由 event 组件负责,chassis 只读取、不修改、不回写。
返回值与异常
| 返回值类型 | 含义 | 触发条件 | 处理建议 |
|---|---|---|---|
| 读取属性 | 返回对应 U16[] 策略数组 | 对象已上树 | 无 |
| 写入属性 | 成功无输出 | 数组元素为 {颜色, 状态} | 无 |
| 写入属性 | 错误响应 | 值格式非法 | 按 {颜色, 状态} 的 U16 数组传入 |
限制条件
- 策略数组元素为
{颜色, 状态},颜色取值 0~6,状态取值见 LED 状态定义; SeverityReferenceSource为EventAndSensor时两条来源取严重者;为HardwareEvent时只读取事件对象的硬件健康状态;- 按配置来源取不到健康状态时不执行点灯,保持当前灯态并记录日志。
调试示例
# 查看当前健康灯严重等级来源
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds bmc.kepler.Systems.Led.Policy.SystemHealth SeverityReferenceSource
# 设置严重等级来源为事件+传感器
busctl --user set-property bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds bmc.kepler.Systems.Led.Policy.SystemHealth \
SeverityReferenceSource s "EventAndSensor"
# 设置严重等级来源为硬件事件(HardwareEvent)
busctl --user set-property bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds bmc.kepler.Systems.Led.Policy.SystemHealth \
SeverityReferenceSource s "HardwareEvent"
# 设置 Critical 策略为红灯快闪(颜色=2,状态=7)
busctl --user set-property bmc.kepler.chassis \
/bmc/kepler/Systems/1/Leds bmc.kepler.Systems.Led.Policy \
Critical aq 2 2 72.3 机框管理(bmc.kepler.Chassis)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Chassis |
| 路径 | /bmc/kepler/Chassis/:ChassisId |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 默认值 | 描述 |
|---|---|---|---|---|
| Name | String | 是 | NA | 机框名 |
| IntrusionFlag | U8 | 是 | 0 | 开箱事件标志,开箱:0x01,关箱:0x00(持久化,可跨一次下电) |
| UidButtonPressed | U8 | 是 | NA | UID 按钮按下标志 |
| UidButtonLongPressed | U8 | 是 | NA | UID 按钮长按标志 |
| ChassisType | U8 | 是 | NA | 当前管理软件类型 |
| Location | String | 否 | NA | 位置信息,写入前做控制字符校验 |
| DeviceSpecication | Array | 是 | NA | 设备配置信息集合,元素为 DeviceSpecification |
| TopologyConfigId | U16 | 是 | 65535 | 产品组网拓扑 |
| ChassisIdentifier | String | 否 | NA | 物理位置标识符 |
| ChassisId | String | 否 | NA | 机框号,可用于数码管显示 |
| 类型 | 字段 | 类型 | 说明 |
|---|---|---|---|
| DeviceSpecification | DeviceName | String | 设备名称 |
| MaximumNum | U8 | 设备最大数量 | |
| DeviceSlots | U8[] | 设备槽位号 | |
| DeviceMaxCount | DeviceName | String | [兼容性保留] 旧版本设备名称定义 |
| MaximumNum | U8 | [兼容性保留] 旧版本设备最大数量定义 |
返回值与异常
| 返回值类型 | 含义 | 触发条件 | 处理建议 |
|---|---|---|---|
| DeviceSpecication | 获取成功 | 设备数量统计任务已完成 | 无 |
| PropertyValueFormatError | 值格式非法 | Location 含控制字符 | 去除非法字符后重试 |
| PropertyValueNotInList | 值不在允许列表 | ChassisType 等枚举赋值非法 | 使用合法枚举值 |
限制条件
IntrusionFlag由组件内部按扫描结果维护,不允许外部直接写入;Location写入会 trim 并校验,禁止控制字符;DeviceSpecication在启动后约 30s 才完成首次统计。
调试示例
# 查看机框名与开箱标志
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1 bmc.kepler.Chassis Name
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1 bmc.kepler.Chassis IntrusionFlag
# 查看设备配置信息集合
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1 bmc.kepler.Chassis DeviceSpecication
# 设置位置信息
busctl --user set-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1 bmc.kepler.Chassis Location s "Rack-01-U02"2.4 机框能力(bmc.kepler.Chassis.ChassisCapabilities)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Chassis.ChassisCapabilities |
| 路径 | /bmc/kepler/Chassis/:ChassisId |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 默认值 | 描述 |
|---|---|---|---|---|
| CapabilitiesFlags | U8 | 是 | NA | 支持获取机箱能力标志 |
| FRUDeviceAddress | U8 | 是 | 32 | 机箱可更换单元信息设备地址 |
| SDRDeviceAddress | U8 | 是 | 32 | 机箱 SDR 设备地址 |
| SELDeviceAddress | U8 | 是 | 32 | 机箱 SEL 设备地址 |
| SMDeviceAddress | U8 | 是 | 32 | 机箱系统管理设备地址 |
| BridgeDeviceAddress | U8 | 是 | 32 | 机箱桥接器设备地址 |
限制条件
- 属性在接口侧只读,仅能通过 IPMI
SetChassisCapabilities写入; - IPMI 侧
sysLockedPolicy=Forbidden,系统锁定(如升级中)时禁止设置。
调试示例
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1 bmc.kepler.Chassis.ChassisCapabilities FRUDeviceAddress2.5 机框尺寸(bmc.kepler.Chassis.Dimension)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Chassis.Dimension |
| 路径 | /bmc/kepler/Chassis/:ChassisId/Dimension |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 默认值 | 描述 |
|---|---|---|---|---|
| HeightU | Double | 是 | 0 | 机框高度(U 为单位,支持 0.5 精度) |
限制条件
- 高度按 2 字节下发,IPMI
GetChassisHeight越界(ReadOffset ≥ 2或ReadLen > 2)返回ParmOutOfRange; - 小数部分为 0.5 时低字节为 5,例如高度 2.0 回显
02 00。
调试示例
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1/Dimension bmc.kepler.Chassis.Dimension HeightU
ipmitool -H <BMC的IP> -I lanplus -U <用户名> -P <密码> -C 17 raw 0x30 0x94 \
0xDB 0x07 0x00 0x6C 0x00 0x01 0x00 0x00 0x022.6 机框/机柜序列号(bmc.kepler.Chassis.Enclosure)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Chassis.Enclosure |
| 路径 | /bmc/kepler/Chassis/:ChassisId/Enclosure |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 描述 |
|---|---|---|---|
| CabinetSerialNumber | String | 是 | 机柜 SN |
| EnclosureSerialNumber | String | 是 | 机框 SN |
限制条件
- 仅刀片计算节点(
ChassisType=2)从管理板 SMM 同步;非刀片节点或尚未同步时返回空串(回显s ""); - 启动时最多重试 10 次,每次间隔 10s;
- IPMI
GetShelfInfo读取机柜(type=1)/机框(type=3)序列号。
调试示例
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1/Enclosure bmc.kepler.Chassis.Enclosure CabinetSerialNumber2.7 度量数据采集(bmc.kepler.Metric)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Metric |
| 路径 | /bmc/kepler/Chassis/:ChassisId |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 方法名 | 入参 | 出参 | 描述 |
|---|---|---|---|
| GetData | as | a(sas) | 获取采集项数据:入参为采集项名称数组,出参每项为 {MetricName, Data[]} |
| GetItems | - | sa(ss)a(ss)as | 获取采集项描述:Component / Classification / Identification / MetricName |
| SynDataAcquisitionEnable | y | - | 同步数据采集开关(0 关闭,1 打开) |
信号 CollectSignal(MetricName: String, TagPath: String) 用于事件触发式采集。
限制条件
- 采集项固定为
chassis.inlettemp、chassis.outlettemp,数据取自ThresholdSensorDisplay.ReadingDisplay; - 裁剪包中
GetItems/GetData返回ActionNotSupported。
调试示例
busctl --user call bmc.kepler.chassis /bmc/kepler/Chassis/1 bmc.kepler.Metric \
GetItems a{ss} 0
busctl --user call bmc.kepler.chassis /bmc/kepler/Chassis/1 bmc.kepler.Metric \
GetData a{ss}as 0 2 "chassis.inlettemp" "chassis.outlettemp"2.8 NCSI 能力(bmc.kepler.Systems.NCSICapabilities)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Systems.NCSICapabilities |
| 路径 | /bmc/kepler/Systems/:SystemId/NCSICapabilities |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 描述 |
|---|---|---|---|
| PCIeNCSIEnabled | U8 | 是 | PCIe 标卡 NCSI 线缆在位标记 |
| PCIeNCSISupported | Boolean | 是 | 用于生产查询主板对 PCIe 标卡 NCSI 功能支持能力 |
限制条件
- 生产测试用:
GetDeviceCapabilities按设备 ID(1/2/5/9/10/13/14)批量返回能力信息,SetDeviceCapabilities恒返回DataNotAvailable; - 裁剪包中不处理
NCSICapabilities对象,相关 IPMI 命令不注册。
调试示例
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Systems/1/NCSICapabilities bmc.kepler.Systems.NCSICapabilities PCIeNCSIEnabled2.9 超节点标签(bmc.kepler.Chassis.SuperPodLabel)
功能说明
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Chassis.SuperPodLabel |
| 路径 | /bmc/kepler/Chassis/:ChassisId/SuperPodLabel |
| 首发版本 | openUBMC 25.3.0 |
| 废弃状态 | 正常可用 |
| 属性名 | 类型 | 只读 | 默认值 | 描述 |
|---|---|---|---|---|
| SuperPodId | U32 | 是 | 4294967295 | 超节点集合 ID |
| ServerIndex | U16 | 是 | 65535 | 超节点内计算节点 ID 编号 |
| SuperPodSize | U16 | 是 | 384 | 超节点规模(NPU 卡数量) |
| SuperPodEnabled | Boolean | 是 | false | 是否超节点模式 |
| TopologyType | U8 | 是 | 0 | 节点拓扑类型,1:1D,2:2D |
| ChassisId | U16 | 是 | 65535 | 超节点机框号 |
| UBMDeployMode | U8 | 是 | 0 | 计算服务器 UBM 部署位置,0:带内物理机,1:带外物理机,2:带内虚拟机 |
| IsUBFabricMode | Boolean | 是 | false | 是否通过 UB 设备组集群 |
| IsUBControlNode | Boolean | 是 | false | 是否为 UB 控制节点 |
| LogicalSlotNumber | U8 | 是 | 255 | 节点柜内逻辑槽位号(由 ADC 识别写入) |
| PresentDPUCount | U8 | 是 | 0 | 物理在位的 DPU 数量 |
| NPUBootOption | U8 | 是 | 0 | NPU 启动方式 |
| InterconType | U8 | 是 | 0 | 节点互联类型 |
| DeviceSlotID | U8 | 是 | 255 | 节点柜内槽位号,提供上层网管配置 |
| 方法名 | 入参类型 | 出参类型 | 描述 | 取值范围 |
|---|---|---|---|---|
| SetSuperPodId | u | b | 设置超节点 ID | u: SuperPodId 出参: true 成功,false 失败 |
| SetServerIndex | q | b | 设置超节点服务器编号 | q: ServerIndex |
| SetSuperPodSize | q | b | 设置超节点容量 | q: SuperPodSize(IPMI 路径校验 1~384,RPC 路径当前不校验,见限制条件) |
| SetSuperPodEnabled | b | - | 设置超节点模式 | b: true 开启组网,false 单机运行;要求 FruCtrl 电源 OFF(当前实现只判断首个 FruCtrl,见限制条件) |
| RestoreDefaults | - | b | 恢复超节点属性默认值 | 出参: true 成功 |
| SetSuperPodLabel | yaa{su} | - | 设置超节点属性 | y: Policy 位图,BIT0(1) 写持久化,BIT1(2) 写硬件寄存器 aa{su}: 属性键值对数组 |
| 类型 | 字段 | 类型 | 说明 |
|---|---|---|---|
| SuperPodLabel | Key | String | 超节点属性名,如 TopologyType |
| Value | U32 | 超节点属性值,如 2 |
返回值与异常
| 返回值类型 | 含义 | 触发条件 | 处理建议 |
|---|---|---|---|
| b true | 设置成功 | 寄存器写入并重算 CRC 成功 | 无 |
| b false | 设置失败 | 3 次重试后寄存器仍写入失败 | 检查 CPLD/寄存器状态 |
| PropertyModificationNotSupported | 当前不允许修改 | 设置 SuperPodEnabled 时存在电源未 OFF | 下电后重试 |
| ActionNotSupported | 接口不支持 | 裁剪包中该特性被裁剪 | 使用全量包 |
限制条件
SetSuperPodEnabled要求电源处于 OFF:读取FruCtrl的PowerState判断,非 OFF 时返回PropertyModificationNotSupported;DeviceSlotID仅在LogicalSlotNumber == 255(硬件未上报)时允许设置,优先硬件上报值;SetSuperPodSize的 1~384 范围校验由 IPMI 命令执行,RPC 调用不做范围校验;SetSuperPodLabel的 Policy 可同时写持久化与寄存器;- 属性最终写入 CPLD 寄存器并重算 CRC16,保证数据一致性。
调试示例
# 查看超节点集合 ID 与 NPU 规模
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel SuperPodId
busctl --user get-property bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel SuperPodSize
# 设置超节点 ID
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel \
SetSuperPodId a{ss}u 0 10
# 设置超节点服务器编号
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel \
SetServerIndex a{ss}q 0 1
# 设置超节点规模为 128
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel \
SetSuperPodSize a{ss}q 0 128
# 设置拓扑类型为 2D(Policy=3 同时写持久化与寄存器)
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel \
SetSuperPodLabel a{ss}yaa{su} 0 3 1 1 "TopologyType" 2
# 恢复默认值
busctl --user call bmc.kepler.chassis \
/bmc/kepler/Chassis/1/SuperPodLabel bmc.kepler.Chassis.SuperPodLabel \
RestoreDefaults a{ss} 02.10 IPMI 与 CLI 接口
2.10.1 IPMI 命令清单
chassis 共注册 20 条 IPMI 命令,命令包名为 ChassisIpmiCmds,厂商 ID 为 0x0007DB。
| NetFn/Cmd | 命令路径 | 权限 | 功能说明 | 裁剪 |
|---|---|---|---|---|
0x00/0x00 | GetChassisCapabilities | ReadOnly | 获取机箱能力标志与各设备地址 | 否 |
0x00/0x05 | SetChassisCapabilities | BasicSetting | 设置机箱能力标志与各设备地址 | 否 |
0x00/0x01 | GetPowerCmd | ReadOnly | 获取机框电源状态与开机策略 | 否 |
0x00/0x04 | ChassisIdentify | BasicSetting | 识别机框(UID 灯) | 否 |
0x00/0x0A | SetPanelButtonEnabled | BasicSetting | 设置前面板电源按钮使能 | 否 |
0x2C/0x06 | GetLedColorCapabilities | ReadOnly | 获取 LED 颜色能力 | 否 |
0x2C/0x07 | SetFruLedState | BasicSetting | 设置 LED 状态 | 否 |
0x30/0x94 | GetChassisHeight | ReadOnly | 获取机框高度 | 否 |
0x30/0x92 | GetDeviceCapabilities | ReadOnly | 获取 PCIe 标卡 NCSI 能力 | 是 |
0x30/0x92 | SetDeviceCapabilities | BasicSetting | 设置设备能力(恒返回 DataNotAvailable) | 是 |
0x30/0x94 | GetShelfInfo | ReadOnly | 获取机架信息(机柜/机框 SN) | 是 |
0x30/0x94 | GetSuperPodLabelInfo | ReadOnly | 获取超节点标签信息 | 是 |
0x30/0x94 | SetSuperPodLabelInfo | BasicSetting | 设置超节点标签信息 | 是 |
0x30/0x94 | SetSuperPodId | BasicSetting | 设置超节点 ID | 是 |
0x30/0x94 | SetServerIndex | BasicSetting | 设置服务器索引 | 是 |
0x30/0x94 | SetSuperPodSize | BasicSetting | 设置超节点规模 | 是 |
0x30/0x94 | SetSuperPodEnabled | BasicSetting | 设置超节点使能 | 是 |
0x30/0x94 | GetSuperPodEnabled | ReadOnly | 获取超节点使能 | 是 |
0x30/0x94 | GetSuperPodLabelInfoExpansion | ReadOnly | 获取超节点扩展属性(TLV) | 是 |
0x30/0x94 | SetSuperPodLabelInfoExpansion | BasicSetting | 设置超节点扩展属性(TLV) | 是 |
0x30/0x94为厂商自定义 NetFn+Cmd,通过子命令/数据区分具体功能;0x30/0x92通过SubCmd区分 Get(0x4E)/Set(0x4F)。
2.10.2 关键命令参数说明
2.10.2.1 GetPowerCmd(0x00/0x01)
| 字段 | 长度 | 说明 |
|---|---|---|
| CompletionCode | 1B | 完成码 |
| CurrentPowerState | 1B | 当前电源状态(bit0 表示 ON,bit6/5 表示开机策略) |
| LastPowerEvent | 1B | 上次电源事件 |
| MiscChassisState | 1B | 杂项机箱状态(UID 灯态、风扇故障、硬盘故障) |
| FrontPanelButton | 1B | 前面板按钮状态(电源按钮被屏蔽时 bit0 置位) |
2.10.2.2 SetFruLedState(0x2C/0x07)
| 字段 | 长度 | 说明 |
|---|---|---|
| PicmgId | 1B | PICMG 标识 |
| FruId | 1B | FRU ID |
| LedId | 1B | LED ID,0xFF 表示全部 LED |
| LedFunc | 1B | 功能字:0x00 超驰关,0xFF 超驰开,0xFC 释放本地控制,0x01~0xFA 超驰闪烁,0xFB 灯测试 |
| OnDuration | 1B | 亮灯持续时间 |
| Color | 1B | 颜色(0xE 不变,0xF 默认) |
2.10.2.3 超节点系列(0x30/0x94)
| 命令 | SubCommand | ParameterSelector | 说明 |
|---|---|---|---|
| GetSuperPodLabelInfo | 0x6A | 0x0004 | 返回 SuperPodId(4B)+ServerIndex(2B)+SuperPodSize(2B) |
| SetSuperPodLabelInfo | 0x6B | 0x0004 | 一次性设置 3 项,校验 SuperPodSize ∈ [1,384] |
| SetSuperPodId | 0x6B | 0x0004 | DataType=0x01,4 字节小端 |
| SetServerIndex | 0x6B | 0x0004 | DataType=0x02,2 字节 |
| SetSuperPodSize | 0x6B | 0x0004 | DataType=0x03,2 字节,校验范围 |
| SetSuperPodEnabled | 0x6B | 0x0005 | 0/1 映射 false/true,要求所有电源 OFF |
| GetSuperPodEnabled | 0x6A | 0x0005 | 1 字节 |
| GetSuperPodLabelInfoExpansion | 0x6A | 0x0008 | TLV 扩展属性读取 |
| SetSuperPodLabelInfoExpansion | 0x6B | 0x0008 | TLV 扩展属性设置 |
扩展属性 TLV 类型:TopologyType(0x00)、UBMDeployMode(0x04)、ChassisId(0x05)、IsUBFabricMode(0x06)、IsUBControlNode(0x07)、LogicalSlotNumber(0x08);单次总数不超过 6 个。
2.10.3 CLI 与 IPMI 使用样例
以下
ipmitool raw示例中的厂商自定义命令(0x30/0x94系列)字节序与长度字段与具体平台协议相关,实际使用前请结合设备协议文档核对;标准命令(0x00/0x2C系列)可直接使用。
2.10.3.1 获取机框电源状态
CLI 获取电源状态:
ipmcget -d powerstateIPMI 获取机框状态:
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x012.10.3.2 识别机框(点 UID 灯)
默认闪烁 15s:
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04指定点亮时长(如 10s):
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04 0x0A强制常亮(第 2 字节大于 0):
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04 0x0A 0x012.10.3.3 设置 LED 状态
设置全部 LED 超驰关(LedFunc=0x00):
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x2C 0x07 0x00 0x00 0xFF 0x00 0x00 0x00获取 LED 颜色能力:
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x2C 0x06 0x00 0x00 0x022.10.3.4 设置超节点 ID
# 设置超节点 ID 为 10(DataType=0x01)
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x30 0x94 \
0xDB 0x07 0x00 0x6B 0x04 0x00 0x00 0x00 0x00 0x05 0x01 0x0A 0x00 0x00 0x003. 组件扩展案例
3.1 扩展能力概述
不适用。
4. 配置介绍
4.1 配置导入导出项
chassis 仅对超节点相关配置做导入导出:
| 配置项 | 说明 |
|---|---|
| SuperPodEnabled | 超节点模式使能 |
| SuperPodLabel.SuperPodId | 超节点集合 ID |
| SuperPodLabel.ServerIndex | 超节点内计算节点编号 |
| SuperPodLabel.SuperPodSize | 超节点规模(NPU 卡数量) |
| SuperPodLabel.TopologyType | 节点拓扑类型 |
| SuperPodLabel.UBMDeployMode | UBM 部署位置 |
| SuperPodLabel.ChassisId | 超节点机框号 |
| SuperPodLabel.PresentDPUCount | 物理在位的 DPU 数量 |
| SuperPodLabel.NPUBootOption | NPU 启动方式 |
| SuperPodLabel.InterconType | 节点互联类型 |
| SuperPodLabel.IsUBFabricMode | 是否通过 UB 设备组集群 |
| SuperPodLabel.IsUBControlNode | 是否为 UB 控制节点 |
| SuperPodLabel.DeviceSlotID | 节点柜内槽位号 |
导入时扩展属性统一按 policy=3(同时写硬件寄存器与持久化)下发;导出时 PresentDPUCount 会换算为真实值。
4.2 装备定制化项
本组件无独立装备定制化项,相关硬件配置由 vpd 仓的 PSR/SR 提供。
4.3 CSR 配置介绍
以下片段可直接粘贴到机型 SR 的 Objects 下,// 为字段说明;示例值取自 vpd 仓现网 SR。社区仓未发布的机型(超节点、ADC 节点识别)给出按 schema 字段构造的最小示例。
4.3.1 Led 对象
"Led_UIDLed": {
"Id": 4, // 4=整机 UID 定位灯;SSU 模块灯也用 4
"SystemId": 1, // 所属系统号
"Name": "UIDLed", // 整机定位灯固定 UIDLed;模块灯 Name 需含 SSU
"FruId": 1, // 关联的 FRU
"CtrlValue": "#/Accessor_UIDLedAccessor.Value", // 写灯寄存器
"Capability": 1, // 当前颜色:1=BLUE 2=RED 3=GREEN 4=AMBER 5=ORANGE 6=WHITE
"Mode": 0, // 0=LCS 本地控制,1=OS 超驰,2=灯测试
"ColorCapabilities": 2, // 支持的颜色位图
"DefaultOSColor": 1, // 超驰模式默认颜色
"DefaultLCSColor": 1, // 本地控制默认颜色
"LCSColor": 1,
"LCSState": 0, // 0 关 / 255 常亮 / 5 慢闪 / 7 快闪
"OSColor": 1,
"OSState": 0,
"LampTestColor": 1,
"LampTestDuration": 0, // 灯测试持续秒数
"ControlOwner": 0 // 仅 SSU 模块灯:该模块由哪侧 BMC 管理
},
"Led_SysHealth": {
"Id": 2, // 健康灯固定 2
"SystemId": 1,
"Name": "SysHealLed",
"CtrlValue": "#/Accessor_SysHealthLedAccessor.Value",
"Capability": 5,
"Mode": 0,
"ColorCapabilities": 32, // 位图:bit5 表示支持 ORANGE
"DefaultOSColor": 5,
"DefaultLCSColor": 5,
"LCSColor": 5,
"LCSState": 255,
"OSColor": 5,
"OSState": 0,
"LampTestColor": 5,
"LampTestDuration": 0
},4.3.2 LedPolicy 对象
"LedPolicy_1": {
"Normal": [3, 255], // {颜色, 状态}:3=GREEN,255=常亮
"Minor": [3, 255],
"Major": [2, 5], // 2=RED,5=慢闪
"Critical": [2, 7], // 2=RED,7=快闪
"UpdateUidStateByRemoteLogin": false, // 远程登录时是否闪烁 UID 灯
"SeverityReferenceSource": "Event" // Event / Sensor / EventAndSensor / HardwareEvent
},4.3.3 Chassis 对象
"Chassis_1": {
"Name": "1", // 机框名(主键);标准机型下路径为 /bmc/kepler/Chassis/1
"IntrusionACOn": "<=/Scanner_Gpio72.Value |> expr($1 == 0 ? 1 : 0)", // AC 上电开箱检测
"IntrusionACOff": "<=/Scanner_ChassisIntrusionACOff.Value", // AC 下电开箱检测
"CoverStatus": "<=/Scanner_Gpio77.Value", // 当前机箱盖状态
"IntrusionACOnClear": "#/Accessor_ChassisIntrusionACOnClear.Value", // 开箱事件清除寄存器
"IntrusionACOffClear": "#/Accessor_ChassisIntrusionACOffClear.Value",
"IntrusionFlag": 0, // 开箱标志(组件维护)
"UidButtonAccessor": "#/Accessor_UIDButtonEvent.Value", // UID 按钮写寄存器
"UidButtonScanner": "<=/Scanner_UIDButtonEvent.Value", // UID 按钮扫描
"UidButtonPressed": 0,
"UidButtonLongAccessor": "#/Accessor_UIDButtonLongEvent.Value", // UID 长按写寄存器
"UidButtonLongScanner": "<=/Scanner_UIDButtonLongEvent.Value",
"UidButtonLongPressed": 0
},4.3.4 Dimension 对象
"Dimension_1": {
"HeightU": 2 // 机框高度,支持 0.5,如 2.5
},4.3.5 SuperPodLabel 对象
"SuperPodLabel_1": {
"Id": 1, // 主键,固定 1
"SuperPodId": 4294967295, // 超节点集合 ID,未配置时保持默认
"ServerIndex": 65535, // 超节点内计算节点编号
"SuperPodSize": 384, // 超节点规模(NPU 卡数),有效范围 1~384
"SuperPodEnabled": false, // 超节点模式使能
"TopologyType": 0, // 1=1D,2=2D
"ChassisId": 65535, // 超节点机框号
"UBMDeployMode": 0, // 0=带内物理机,1=带外物理机,2=带内虚拟机
"LogicalSlotNumber": 255, // 节点柜内逻辑槽位号,由 ADC 识别写入
"DeviceSlotID": 255, // 节点柜内槽位号,LogicalSlotNumber=255 时才允许设置
"SuperPodIdAcc": "#/Accessor_SuperPodId.Value", // 各属性对应的 CPLD 寄存器
"ServerIndexAcc": "#/Accessor_ServerIndex.Value",
"SuperPodSizeAcc": "#/Accessor_SuperPodSize.Value",
"Crc16": "#/Accessor_Crc16.Value", // CRC 校验寄存器
"CrcCalcParams": ["ServerIndex", "SuperPodSize", "SuperPodId"], // 参与 CRC 的属性
"ConfigurationCompletedFlag": 0, // 配置完成标志
"ConfigurationCompletedReg": "#/Accessor_CfgDone.Value",
"DefaultChassisId": 65535, // 各属性恢复默认值使用
"DefaultTopologyType": 0,
"DefaultInterconType": 0,
"DefaultPresentDPUCount": 0,
"DefaultNPUBootOption": 0,
"DefaultUBMDeployMode": 0,
"UBParam": 255, // serdes index
"UBParamReg": "#/Accessor_UBParam.Value" // serdes index 下发寄存器
},4.3.6 NCSICapabilities 对象
"NCSICapabilities_1": {
"PCIeNCSIEnabled": "#/Accessor_NCSI.Value", // PCIe 标卡 NCSI 线缆在位
"PCIeNCSISupported": false // 主板是否支持 PCIe 标卡 NCSI
},4.3.7 其他内部 CSR 对象
"LedDispControl_0": { // 数码管能力与显示控制
"LedTubeSupport": true, // 是否支持数码管
"LeftLedTube": "#/Accessor_LeftLedTube.Value",
"MidLedTube": "#/Accessor_MidLedTube.Value",
"RightLedTube": "#/Accessor_RightLedTube.Value",
"LedDispMode": 0 // 0=显示告警码,1=显示机框号
},
"I2cLed_1": { // 装备测试用 I2C 灯
"CtrlValue": "#/Accessor_LedTest.Value",
"LedOnValue": 1
},
"ChassisTable_ChassisInfo": { // BMC 复位/进程重启标志,供 LED 启动自检
"Id": "ChassisInfo", // 主键,固定 ChassisInfo
"BmcHardResetFlag": 0, // BMC 硬复位标志(ResetPer)
"ProcessRestartFlag": 0 // 进程重启标志(TemporaryPer)
},
"AdcVoltageConfig_1": { // ADC 节点 ID 识别
"Voltage": "#/Accessor_AdcVoltage.Value", // ADC 电压读值寄存器
"Model": "#/Accessor_AdcModel.Value", // 模式寄存器
"ModelConfig": 0, // 进入外部参考源模式的配置值
"ChannelReg": "#/Accessor_AdcChannel.Value", // 通道选择寄存器
"ChannelRegMap": [0, 1, 2, 3], // 通道寄存器映射
"ThresholdConfig": [ // 阈值配置:{NodeId, Low, High}
{"NodeId": 0, "Low": 100, "High": 900}
]
},
"UBConfiguration_1": { // serdes index 下发
"UBParam": 255,
"UBParamReg": "#/Accessor_UBParam.Value"
},4.3.8 Enclosure 对象
Enclosure 的 CabinetSerialNumber、EnclosureSerialNumber 由组件从管理板 SMM 同步,一般无需 CSR 配置。
5. 日志说明
5.1 日志路径
| 日志路径 | 说明 | 定义位置 |
|---|---|---|
/data/var/log/bmc/chassis.log | 组件主日志,log:notice/error/warn 与操作日志均写入此文件 | dist/config.cfg |
5.2 一键日志收集
一键收集(Web「一键收集」或 BMC 上执行 ipmcget -d d)时,框架调用组件 debug 接口的 Dump 方法;chassis 在 chassis_app:init() 中通过 debug.on_dump 注册 chassis_app:on_dump,再由 led_service:led_dump / led_service:record_led_info 生成组件专属文件。收集包解压后根目录为 dump_info,组件产物位于 dump_info/AppDump/chassis/。
| 收集文件 | 生成位置 | 内容说明 |
|---|---|---|
dump_info/AppDump/chassis/LedInfo | chassis_app:on_dump → led_service:record_led_info | 逐个 LED 输出:LED Name、LED Mode(Local Control / Override / Lamp Test)、LED State(OFF / ON / BLINKING,闪烁时附 On Duration、Off Duration,单位 ms)、LED Color、LED Color Capabilities(支持的色名)、Default LED Color(LOCAL control / OVERRIDE state 两行) |
dump_info/AppDump/chassis/mdb_info.log | 框架 common_dump | 组件资源树对象/接口/属性快照与属性写入量统计(所有 app 均收集) |
dump_info/AppDump/chassis/sync_property_trace.log | 框架 common_dump | 属性同步记录,含属性值、来源服务与来源路径(所有 app 均收集) |
dump_info/AppDump/chassis/rpc_records.log | 框架 common_dump | RPC 方法调用记录(所有 app 均收集,仅非 release 版本) |
dump_info/AppDump/chassis/skynet_info.json | 框架 common_dump | skynet 服务/协程信息(所有 app 均收集,仅非 release 版本) |
chassis 自身只额外导出 LED 信息,不含寄存器值、设备数量等;定位寄存器类问题需结合
busctl --user introspect与 hwproxy 的 Accessor/Scanner 查看。
5.3 关键日志
按源码
log:*调用整理,只列排查常用项;完整日志见/data/var/log/bmc/chassis.log。
| 级别 | 日志 | 含义 / 定位 |
|---|---|---|
| notice | start super init / end fork init | 初始化阶段开始/结束,初始化卡住时按阶段定位 |
| notice | Open the chassis cover(AC On) / Open the chassis cover(AC Off) | 开箱/关箱(区分 AC 上电、下电),结合 IntrusionACOn/IntrusionACOff 寄存器确认 |
| notice | UID led locked by %s / UID led lock released / UID led lock timeout, auto released | UID 灯独占锁加锁/解锁/超时释放,灯不受控时先查是否被锁 |
| notice | get_event_health change to: %s / change SeverityReferenceSource to %s | 健康灯参考的健康状态/来源变化,颜色异常时先比对该值 |
| notice | [chassis]get device info start / finish | 设备数量统计开始/结束,数量不符时查中间日志 |
| notice | Calculate %s crc16 value: %s | 超节点属性下发时计算 CRC16 |
| error | current power state is %s, expect OFF for update superpod-enabled property | 设置 SuperPodEnabled 时电源未 OFF,下电后重试 |
| error | Set led state rejected: current BMC is standby | 从 BMC 拒绝点灯(主从保护),确认主从状态与 ControlOwner |
| error | Led obj(Id: %s, FruId: %s) is not a UID led, cannot set identify | 对非 UID 灯调用 identify,改用 Id=4 的 UID 灯 |
| error | Set module led (%s) blink failed, module led only support on/off | 模块定位灯只支持点亮(固定频率闪烁)/关闭;IPMI 侧改用 LedFunc=0xFF 点亮、0x00 熄灭,不能用可控闪烁(0x01~0xFA)与灯测试(0xFB) |
| error | get chassis object failed / get super_pod_label object failed | 目标对象未就绪或自发现失败,检查 CSR 配置与依赖组件 |
| error | [active_standby] read led ControlOwner failed, err: %s | 主从信息读取失败,按可用性优先放行,必要时排查 SSUCard |
| error | [ledtube] led number or data to be displayed is invalid | 数码管显示内容或长度非法 |
6. 问题定界指南
6.1 典型问题定界
| 现象描述 | 是否为本组件问题 | 判断依据 | 关键证据收集方法 |
|---|---|---|---|
| UID 灯不亮、常亮或不受控 | 是 | 查看 LED 是否被独占锁定;确认 Led 对象是否上树 | busctl --user get-property bmc.kepler.chassis /bmc/kepler/Systems/1/Leds/Led_UIDLed_0101 bmc.kepler.Systems.Led State;查看 LedInfo dump |
| 健康灯颜色与告警等级不符 | 是 | 确认 SeverityReferenceSource 与 LedPolicy 策略配置 | 读取 LedPolicy 属性,比对 Events.Health |
| 数码管不显示或显示框号异常 | 是 | 确认 LedTubeSupport、LedDispMode 及主备状态 | 查看 LedDispControl 配置与主从状态 |
| 开箱告警误报或重复上报 | 是 | 确认寄存器值与 IntrusionFlag 变化 | 读取 IntrusionACOn/IntrusionACOff/CoverStatus |
| 超节点属性下发失败 | 是 | 确认电源已 OFF、CPLD 寄存器可写、CRC 正确 | 读取对应 XxxAcc 与 Crc16 寄存器 |
| NCSI 能力查询失败 | 视情况 | 确认是否为裁剪包 | 检查 NCSICapabilities 对象是否存在 |
6.2 调试方法
6.2.1 查看资源树
# 查看 chassis 组件资源树
busctl --user tree bmc.kepler.chassis
# 查看机框对象
busctl --user introspect bmc.kepler.chassis /bmc/kepler/Chassis/1
# 查看 LED 对象
busctl --user introspect bmc.kepler.chassis /bmc/kepler/Systems/1/Leds/Led_UIDLed_0101
# 单属性读取(mdbctl 更短;对象名 = 路径最后一段,可由 mdbctl lsobj 查得)
mdbctl getprop Led_UIDLed_0101 bmc.kepler.Systems.Led Id对象路径最后一段是 CSR 对象名(含位置后缀,如 Led_UIDLed_0101),不是接口属性 Id(4/2)。常见报错:
| 报错 | 原因 |
|---|---|
The name ... was not provided by any .service files | 服务名错误,用 busctl --user list | grep -i chassis 确认 |
Unknown object '...' | 路径错误,用 busctl --user tree bmc.kepler.chassis | grep -i <关键字> 查实际路径 |
Unknown interface / intf not found | 接口名错误 |
Unknown method | 接口存在但方法名错误 |
Too few parameters for signature. | 参数个数不足;数组类型需先给元素个数,如 a{ss}yy 0 5 10 中的 0 |
6.2.2 查看硬件寄存器
通过 hwproxy 的 Accessor/Scanner 读取开箱、UID 按钮、LED CtrlValue 等寄存器,确认软件读到的值是否符合预期。
6.2.3 查看日志
通过一键日志中的 LedInfo 与系统日志确认点灯流程、开箱检测流程是否正常执行。
7. 常见问题解答
| 问题 | 排查步骤 |
|---|---|
| Q1 UID 灯设置不生效 | ① 确认 Id=4(仅整机 UID 灯支持 identify 与加锁);② 查是否被独占锁定,锁定期间非锁定方返回 OperationNotAllowed;③ 常亮(State=0xFF)时 Interval 必须为 0,闪烁时需大于 0;④ 模块定位灯只接受 State=1(点亮,固定频率闪烁)/State=0(关闭),常亮与可控闪烁都不支持 |
| Q2 健康灯颜色与告警等级不一致 | ① 读 LedPolicy 的 Normal/Minor/Major/Critical,确认数组为 {颜色, 状态} 且取值合法;② 确认 SeverityReferenceSource 与预期一致(Event/Sensor/EventAndSensor/HardwareEvent);③ 取严重者模式下需同时看 Events.Health 与 Sensors.Health;④ 多 System 场景确认 ControlOwner 与主从状态 |
| Q3 数码管不显示告警码或框号 | ① 确认 CSR 中 LedTubeSupport=true;② 确认 LedDispMode(0 告警码 / 1 框号)与 Chassis.ChassisId;③ 框号仅主 BMC 显示,从 BMC 不显示;④ 确认装备测试未占用数码管 |
| Q4 开箱告警误报或重复上报 | ① 读 IntrusionACOn/IntrusionACOff/CoverStatus 确认硬件状态;② 核对 LastIntrusionACOn 与 IntrusionFlag 的持久化值;③ 排查机箱盖寄存器抖动,确认硬件扫描周期 5s、软件扫描周期 6s |
| Q5 超节点属性设置失败 | ① SetSuperPodEnabled 需电源 OFF,否则返回 PropertyModificationNotSupported;② 确认 CPLD 寄存器可写、CRC16 重算正确;③ DeviceSlotID 仅在 LogicalSlotNumber=255 时允许设置;④ 裁剪包中接口返回 ActionNotSupported,需全量包 |
附录
附录A 参考资料
- 《机框管理概述》(chassis 组件仓
docs/机框管理概述.md) - 组件源码仓库:
https://gitcode.com/openUBMC/chassis - 接口定义仓库:
mdb_interface(json/intf/mdb/bmc/kepler/)