代码仓
中
更新时间: 2026/10/27
在AtomGit上查看源码

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 按钮事件上报、设备数量/最大可插数量统计、整机状态统计
2I2cLed 灯控制为装备测试提供控制 I2C 灯状态的手段
3LED 灯控制控制 UID 定位灯状态;基于当前告警控制健康灯颜色变化;远程登录闪烁、电源升级独占锁
4Led 数码管显示基于当前告警在数码管上显示错误码,或显示机箱框号
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),并持久化"曾开箱"标志
UIDUnit Identification,定位/识别指示灯,用于在机房中定位目标设备
UID 短按/长按UID 按钮按下较短时间会翻转 UID 灯;长按(约数秒)会复位 BMC
LCS(Local Control State)本地控制模式,灯由 BMC 自身策略控制
OS(Override State)超驰模式,灯由 IPMI/上层显式设置覆盖本地控制
健康灯策略由 bmc.kepler.Systems.Led.Policy 定义的不同告警等级对应的颜色/状态组合
数码管机箱面板上的 3 位七段数码管,用于显示告警错误码或机框号
I2cLed通过 I2C 控制、无需用户管理的指示灯,主要用于装备测试
NCSINetwork Controller Sideband Interface,网络控制器边带接口;NCSI 线缆用于 BMC 与网卡之间的共享网口通信
SuperPod超节点,多个计算节点通过 UB 总线组网形成的大规模计算集合
UB(UnifiedBus)统一总线,超节点内节点互联的高速总线
ASU / SSU挂在整机下的子模块;ASU/SSU 拥有各自的 SystemId,可含独立的定位灯与健康灯
ControlOwnerSSUCard 的主从属性,标识该 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
废弃状态正常可用
属性名类型只读默认值描述
NameString是NALED 灯的名称
OnDurationU8是0亮灯持续时间
OffDurationU8是0关灯持续时间
CapabilityU8是NA颜色,3:绿色,2:红色
SystemIdU8是NA系统 ID
StateU8否NA当前 LED 灯的状态
IdU8是NA每个 LED 灯对应的固定 ID(整机 UID=4、健康灯=2);仅用于组件内部判断,不出现在对象路径中
FruIdU8是NA关联的 FRU ID
ColorCapabilitiesU8是NALED 灯支持的颜色能力(位图)
LocalControlStateColorString是NA本地控制模式下的颜色
OverrideStateColorString是NA超驰状态下的颜色
ModeU8是NALed 模式
DefaultLCSColorU8是NA本地控制模式默认颜色,0:reserved,1:BLUE,2:RED,3:GREEN,4:AMBER,5:ORANGE,6:WHITE
DefaultOSColorU8是NA超驰模式默认颜色,取值同 DefaultLCSColor
方法名入参类型出参类型描述取值范围
SetStateyyyyy设置 LED 灯的状态(仅 Id=4 的 UID 灯)y: State 灯状态(0=关,0xFF=常亮,5=慢闪,7=快闪,1=模块灯闪烁)
y: Interval 闪烁持续时长,单位:秒,闪烁时需大于 0(interval=0 与闪烁态组合会报 OperationFailed)
出参: State / OnDuration / OffDuration
SetLocksu-设置 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;
  • 锁超时后自动释放并恢复原闪烁倒计时。

调试示例 ​

bash
# 点亮 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" 10

2.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
废弃状态正常可用
属性名类型只读描述
NormalU16[]否Normal 等级亮灯策略,每项为 {颜色, 状态}
MinorU16[]否Minor 等级亮灯策略
MajorU16[]否Major 等级亮灯策略
CriticalU16[]否Critical 等级亮灯策略
SeverityReferenceSourceString否健康灯严重等级来源,枚举:Event、Sensor、EventAndSensor、HardwareEvent,默认 Event

各枚举取值对应的健康状态来源:

取值健康状态来源
Event主 System 读 Events.Health,多 System 读 EventSummary.Health
Sensor读 Chassis/1/Sensors 的 Health
EventAndSensorEvents.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 时只读取事件对象的硬件健康状态;
  • 按配置来源取不到健康状态时不执行点灯,保持当前灯态并记录日志。

调试示例 ​

bash
# 查看当前健康灯严重等级来源
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 7

2.3 机框管理(bmc.kepler.Chassis) ​

功能说明 ​

属性内容
接口名bmc.kepler.Chassis
路径/bmc/kepler/Chassis/:ChassisId
首发版本openUBMC 25.3.0
废弃状态正常可用
属性名类型只读默认值描述
NameString是NA机框名
IntrusionFlagU8是0开箱事件标志,开箱:0x01,关箱:0x00(持久化,可跨一次下电)
UidButtonPressedU8是NAUID 按钮按下标志
UidButtonLongPressedU8是NAUID 按钮长按标志
ChassisTypeU8是NA当前管理软件类型
LocationString否NA位置信息,写入前做控制字符校验
DeviceSpecicationArray是NA设备配置信息集合,元素为 DeviceSpecification
TopologyConfigIdU16是65535产品组网拓扑
ChassisIdentifierString否NA物理位置标识符
ChassisIdString否NA机框号,可用于数码管显示
类型字段类型说明
DeviceSpecificationDeviceNameString设备名称
MaximumNumU8设备最大数量
DeviceSlotsU8[]设备槽位号
DeviceMaxCountDeviceNameString[兼容性保留] 旧版本设备名称定义
MaximumNumU8[兼容性保留] 旧版本设备最大数量定义

返回值与异常 ​

返回值类型含义触发条件处理建议
DeviceSpecication获取成功设备数量统计任务已完成无
PropertyValueFormatError值格式非法Location 含控制字符去除非法字符后重试
PropertyValueNotInList值不在允许列表ChassisType 等枚举赋值非法使用合法枚举值

限制条件 ​

  • IntrusionFlag 由组件内部按扫描结果维护,不允许外部直接写入;
  • Location 写入会 trim 并校验,禁止控制字符;
  • DeviceSpecication 在启动后约 30s 才完成首次统计。

调试示例 ​

bash
# 查看机框名与开箱标志
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
废弃状态正常可用
属性名类型只读默认值描述
CapabilitiesFlagsU8是NA支持获取机箱能力标志
FRUDeviceAddressU8是32机箱可更换单元信息设备地址
SDRDeviceAddressU8是32机箱 SDR 设备地址
SELDeviceAddressU8是32机箱 SEL 设备地址
SMDeviceAddressU8是32机箱系统管理设备地址
BridgeDeviceAddressU8是32机箱桥接器设备地址

限制条件 ​

  • 属性在接口侧只读,仅能通过 IPMI SetChassisCapabilities 写入;
  • IPMI 侧 sysLockedPolicy=Forbidden,系统锁定(如升级中)时禁止设置。

调试示例 ​

bash
busctl --user get-property bmc.kepler.chassis \
 /bmc/kepler/Chassis/1 bmc.kepler.Chassis.ChassisCapabilities FRUDeviceAddress

2.5 机框尺寸(bmc.kepler.Chassis.Dimension) ​

功能说明 ​

属性内容
接口名bmc.kepler.Chassis.Dimension
路径/bmc/kepler/Chassis/:ChassisId/Dimension
首发版本openUBMC 25.3.0
废弃状态正常可用
属性名类型只读默认值描述
HeightUDouble是0机框高度(U 为单位,支持 0.5 精度)

限制条件 ​

  • 高度按 2 字节下发,IPMI GetChassisHeight 越界(ReadOffset ≥ 2 或 ReadLen > 2)返回 ParmOutOfRange;
  • 小数部分为 0.5 时低字节为 5,例如高度 2.0 回显 02 00。

调试示例 ​

bash
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 0x02

2.6 机框/机柜序列号(bmc.kepler.Chassis.Enclosure) ​

功能说明 ​

属性内容
接口名bmc.kepler.Chassis.Enclosure
路径/bmc/kepler/Chassis/:ChassisId/Enclosure
首发版本openUBMC 25.3.0
废弃状态正常可用
属性名类型只读描述
CabinetSerialNumberString是机柜 SN
EnclosureSerialNumberString是机框 SN

限制条件 ​

  • 仅刀片计算节点(ChassisType=2)从管理板 SMM 同步;非刀片节点或尚未同步时返回空串(回显 s "");
  • 启动时最多重试 10 次,每次间隔 10s;
  • IPMI GetShelfInfo 读取机柜(type=1)/机框(type=3)序列号。

调试示例 ​

bash
busctl --user get-property bmc.kepler.chassis \
 /bmc/kepler/Chassis/1/Enclosure bmc.kepler.Chassis.Enclosure CabinetSerialNumber

2.7 度量数据采集(bmc.kepler.Metric) ​

功能说明 ​

属性内容
接口名bmc.kepler.Metric
路径/bmc/kepler/Chassis/:ChassisId
首发版本openUBMC 25.3.0
废弃状态正常可用
方法名入参出参描述
GetDataasa(sas)获取采集项数据:入参为采集项名称数组,出参每项为 {MetricName, Data[]}
GetItems-sa(ss)a(ss)as获取采集项描述:Component / Classification / Identification / MetricName
SynDataAcquisitionEnabley-同步数据采集开关(0 关闭,1 打开)

信号 CollectSignal(MetricName: String, TagPath: String) 用于事件触发式采集。

限制条件 ​

  • 采集项固定为 chassis.inlettemp、chassis.outlettemp,数据取自 ThresholdSensorDisplay.ReadingDisplay;
  • 裁剪包中 GetItems/GetData 返回 ActionNotSupported。

调试示例 ​

bash
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
废弃状态正常可用
属性名类型只读描述
PCIeNCSIEnabledU8是PCIe 标卡 NCSI 线缆在位标记
PCIeNCSISupportedBoolean是用于生产查询主板对 PCIe 标卡 NCSI 功能支持能力

限制条件 ​

  • 生产测试用:GetDeviceCapabilities 按设备 ID(1/2/5/9/10/13/14)批量返回能力信息,SetDeviceCapabilities 恒返回 DataNotAvailable;
  • 裁剪包中不处理 NCSICapabilities 对象,相关 IPMI 命令不注册。

调试示例 ​

bash
busctl --user get-property bmc.kepler.chassis \
 /bmc/kepler/Systems/1/NCSICapabilities bmc.kepler.Systems.NCSICapabilities PCIeNCSIEnabled

2.9 超节点标签(bmc.kepler.Chassis.SuperPodLabel) ​

功能说明 ​

属性内容
接口名bmc.kepler.Chassis.SuperPodLabel
路径/bmc/kepler/Chassis/:ChassisId/SuperPodLabel
首发版本openUBMC 25.3.0
废弃状态正常可用
属性名类型只读默认值描述
SuperPodIdU32是4294967295超节点集合 ID
ServerIndexU16是65535超节点内计算节点 ID 编号
SuperPodSizeU16是384超节点规模(NPU 卡数量)
SuperPodEnabledBoolean是false是否超节点模式
TopologyTypeU8是0节点拓扑类型,1:1D,2:2D
ChassisIdU16是65535超节点机框号
UBMDeployModeU8是0计算服务器 UBM 部署位置,0:带内物理机,1:带外物理机,2:带内虚拟机
IsUBFabricModeBoolean是false是否通过 UB 设备组集群
IsUBControlNodeBoolean是false是否为 UB 控制节点
LogicalSlotNumberU8是255节点柜内逻辑槽位号(由 ADC 识别写入)
PresentDPUCountU8是0物理在位的 DPU 数量
NPUBootOptionU8是0NPU 启动方式
InterconTypeU8是0节点互联类型
DeviceSlotIDU8是255节点柜内槽位号,提供上层网管配置
方法名入参类型出参类型描述取值范围
SetSuperPodIdub设置超节点 IDu: SuperPodId
出参: true 成功,false 失败
SetServerIndexqb设置超节点服务器编号q: ServerIndex
SetSuperPodSizeqb设置超节点容量q: SuperPodSize(IPMI 路径校验 1~384,RPC 路径当前不校验,见限制条件)
SetSuperPodEnabledb-设置超节点模式b: true 开启组网,false 单机运行;要求 FruCtrl 电源 OFF(当前实现只判断首个 FruCtrl,见限制条件)
RestoreDefaults-b恢复超节点属性默认值出参: true 成功
SetSuperPodLabelyaa{su}-设置超节点属性y: Policy 位图,BIT0(1) 写持久化,BIT1(2) 写硬件寄存器
aa{su}: 属性键值对数组
类型字段类型说明
SuperPodLabelKeyString超节点属性名,如 TopologyType
ValueU32超节点属性值,如 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,保证数据一致性。

调试示例 ​

bash
# 查看超节点集合 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} 0

2.10 IPMI 与 CLI 接口 ​

2.10.1 IPMI 命令清单 ​

chassis 共注册 20 条 IPMI 命令,命令包名为 ChassisIpmiCmds,厂商 ID 为 0x0007DB。

NetFn/Cmd命令路径权限功能说明裁剪
0x00/0x00GetChassisCapabilitiesReadOnly获取机箱能力标志与各设备地址否
0x00/0x05SetChassisCapabilitiesBasicSetting设置机箱能力标志与各设备地址否
0x00/0x01GetPowerCmdReadOnly获取机框电源状态与开机策略否
0x00/0x04ChassisIdentifyBasicSetting识别机框(UID 灯)否
0x00/0x0ASetPanelButtonEnabledBasicSetting设置前面板电源按钮使能否
0x2C/0x06GetLedColorCapabilitiesReadOnly获取 LED 颜色能力否
0x2C/0x07SetFruLedStateBasicSetting设置 LED 状态否
0x30/0x94GetChassisHeightReadOnly获取机框高度否
0x30/0x92GetDeviceCapabilitiesReadOnly获取 PCIe 标卡 NCSI 能力是
0x30/0x92SetDeviceCapabilitiesBasicSetting设置设备能力(恒返回 DataNotAvailable)是
0x30/0x94GetShelfInfoReadOnly获取机架信息(机柜/机框 SN)是
0x30/0x94GetSuperPodLabelInfoReadOnly获取超节点标签信息是
0x30/0x94SetSuperPodLabelInfoBasicSetting设置超节点标签信息是
0x30/0x94SetSuperPodIdBasicSetting设置超节点 ID是
0x30/0x94SetServerIndexBasicSetting设置服务器索引是
0x30/0x94SetSuperPodSizeBasicSetting设置超节点规模是
0x30/0x94SetSuperPodEnabledBasicSetting设置超节点使能是
0x30/0x94GetSuperPodEnabledReadOnly获取超节点使能是
0x30/0x94GetSuperPodLabelInfoExpansionReadOnly获取超节点扩展属性(TLV)是
0x30/0x94SetSuperPodLabelInfoExpansionBasicSetting设置超节点扩展属性(TLV)是

0x30/0x94 为厂商自定义 NetFn+Cmd,通过子命令/数据区分具体功能;0x30/0x92 通过 SubCmd 区分 Get(0x4E)/Set(0x4F)。

2.10.2 关键命令参数说明 ​

2.10.2.1 GetPowerCmd(0x00/0x01) ​
字段长度说明
CompletionCode1B完成码
CurrentPowerState1B当前电源状态(bit0 表示 ON,bit6/5 表示开机策略)
LastPowerEvent1B上次电源事件
MiscChassisState1B杂项机箱状态(UID 灯态、风扇故障、硬盘故障)
FrontPanelButton1B前面板按钮状态(电源按钮被屏蔽时 bit0 置位)
2.10.2.2 SetFruLedState(0x2C/0x07) ​
字段长度说明
PicmgId1BPICMG 标识
FruId1BFRU ID
LedId1BLED ID,0xFF 表示全部 LED
LedFunc1B功能字:0x00 超驰关,0xFF 超驰开,0xFC 释放本地控制,0x01~0xFA 超驰闪烁,0xFB 灯测试
OnDuration1B亮灯持续时间
Color1B颜色(0xE 不变,0xF 默认)
2.10.2.3 超节点系列(0x30/0x94) ​
命令SubCommandParameterSelector说明
GetSuperPodLabelInfo0x6A0x0004返回 SuperPodId(4B)+ServerIndex(2B)+SuperPodSize(2B)
SetSuperPodLabelInfo0x6B0x0004一次性设置 3 项,校验 SuperPodSize ∈ [1,384]
SetSuperPodId0x6B0x0004DataType=0x01,4 字节小端
SetServerIndex0x6B0x0004DataType=0x02,2 字节
SetSuperPodSize0x6B0x0004DataType=0x03,2 字节,校验范围
SetSuperPodEnabled0x6B0x00050/1 映射 false/true,要求所有电源 OFF
GetSuperPodEnabled0x6A0x00051 字节
GetSuperPodLabelInfoExpansion0x6A0x0008TLV 扩展属性读取
SetSuperPodLabelInfoExpansion0x6B0x0008TLV 扩展属性设置

扩展属性 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 获取电源状态:

bash
ipmcget -d powerstate

IPMI 获取机框状态:

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x01
2.10.3.2 识别机框(点 UID 灯) ​

默认闪烁 15s:

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04

指定点亮时长(如 10s):

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04 0x0A

强制常亮(第 2 字节大于 0):

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x00 0x04 0x0A 0x01
2.10.3.3 设置 LED 状态 ​

设置全部 LED 超驰关(LedFunc=0x00):

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x2C 0x07 0x00 0x00 0xFF 0x00 0x00 0x00

获取 LED 颜色能力:

bash
ipmitool -H <BMC的IP> -I lanplus -p 623 -U <用户名> -P <密码> -C 17 raw 0x2C 0x06 0x00 0x00 0x02
2.10.3.4 设置超节点 ID ​
bash
# 设置超节点 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 0x00

3. 组件扩展案例 ​

3.1 扩展能力概述 ​

不适用。

4. 配置介绍 ​

4.1 配置导入导出项 ​

chassis 仅对超节点相关配置做导入导出:

配置项说明
SuperPodEnabled超节点模式使能
SuperPodLabel.SuperPodId超节点集合 ID
SuperPodLabel.ServerIndex超节点内计算节点编号
SuperPodLabel.SuperPodSize超节点规模(NPU 卡数量)
SuperPodLabel.TopologyType节点拓扑类型
SuperPodLabel.UBMDeployModeUBM 部署位置
SuperPodLabel.ChassisId超节点机框号
SuperPodLabel.PresentDPUCount物理在位的 DPU 数量
SuperPodLabel.NPUBootOptionNPU 启动方式
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 对象 ​

plain
        "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 对象 ​

plain
        "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 对象 ​

plain
        "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 对象 ​

plain
        "Dimension_1": {
            "HeightU": 2                          // 机框高度,支持 0.5,如 2.5
        },

4.3.5 SuperPodLabel 对象 ​

plain
        "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 对象 ​

plain
        "NCSICapabilities_1": {
            "PCIeNCSIEnabled": "#/Accessor_NCSI.Value",   // PCIe 标卡 NCSI 线缆在位
            "PCIeNCSISupported": false                    // 主板是否支持 PCIe 标卡 NCSI
        },

4.3.7 其他内部 CSR 对象 ​

plain
        "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/LedInfochassis_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_dumpRPC 方法调用记录(所有 app 均收集,仅非 release 版本)
dump_info/AppDump/chassis/skynet_info.json框架 common_dumpskynet 服务/协程信息(所有 app 均收集,仅非 release 版本)

chassis 自身只额外导出 LED 信息,不含寄存器值、设备数量等;定位寄存器类问题需结合 busctl --user introspect 与 hwproxy 的 Accessor/Scanner 查看。

5.3 关键日志 ​

按源码 log:* 调用整理,只列排查常用项;完整日志见 /data/var/log/bmc/chassis.log。

级别日志含义 / 定位
noticestart super init / end fork init初始化阶段开始/结束,初始化卡住时按阶段定位
noticeOpen the chassis cover(AC On) / Open the chassis cover(AC Off)开箱/关箱(区分 AC 上电、下电),结合 IntrusionACOn/IntrusionACOff 寄存器确认
noticeUID led locked by %s / UID led lock released / UID led lock timeout, auto releasedUID 灯独占锁加锁/解锁/超时释放,灯不受控时先查是否被锁
noticeget_event_health change to: %s / change SeverityReferenceSource to %s健康灯参考的健康状态/来源变化,颜色异常时先比对该值
notice[chassis]get device info start / finish设备数量统计开始/结束,数量不符时查中间日志
noticeCalculate %s crc16 value: %s超节点属性下发时计算 CRC16
errorcurrent power state is %s, expect OFF for update superpod-enabled property设置 SuperPodEnabled 时电源未 OFF,下电后重试
errorSet led state rejected: current BMC is standby从 BMC 拒绝点灯(主从保护),确认主从状态与 ControlOwner
errorLed obj(Id: %s, FruId: %s) is not a UID led, cannot set identify对非 UID 灯调用 identify,改用 Id=4 的 UID 灯
errorSet module led (%s) blink failed, module led only support on/off模块定位灯只支持点亮(固定频率闪烁)/关闭;IPMI 侧改用 LedFunc=0xFF 点亮、0x00 熄灭,不能用可控闪烁(0x01~0xFA)与灯测试(0xFB)
errorget 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 查看资源树 ​

bash
# 查看 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/)