【待评审】新增SSU模组告警信息属性 AlarmStatus

背景

SSU 模组内部包含数据盘、系统盘、SPU、IMU、IMP、SCC 等部件,运行过程中可能产生硬盘预失效、比较错误、只读、温度异常、媒体错误、SPU 错误计数、网络异常及系统异常等告警。当前 BMC 侧没有统一的 SSU 告警信息设备树属性,北向与上层业务无法直接获取这些告警状态。

SSU 固件已提供告警信息查询命令,响应固定 30 字节,每个字节(或 4 字节)对应一种告警。BMC 需要周期性查询该命令,并将结果保存到 SSUCard 对象的 bmc.dev.SSU 接口下,供上层业务使用。

关联 ISSUE

[需求]: 支持SSU模组的告警信息查询-component_drivers-AtomGit

整体方案

  1. 属性定义:在 SSUCard 对象的 bmc.dev.SSU 接口新增只读属性 AlarmStatus,类型 a{su}(key 为告警名称,value 为 U32 告警值),不持久化,默认空映射,变化通知打开。
  2. 带外查询命令:在 ssu_oob 中新增 get_alarm_info(),通过 Vendor Get 命令查询告警信息,响应固定 30 字节;按告警名称解析为 a{su}。
  3. 周期查询任务:在当前 BMC 为主且 SSU 上电(带外管理已启动)时,每 10s 查询一次告警信息并更新 AlarmStatus;仅在属性内容变化时写库。
  4. 失败保持:查询失败(带外异常 / CQE 状态非 0 / 响应长度不足 30 字节)时,AlarmStatus 保持上一次查询结果不变。
  5. 停止清零:BMC 切换为从、SSU 下电或驱动停止时,在停止周期任务的同时将全部告警值清 0(保留全部告警 key)。
  6. 不持久化:属性不持久化,BMC/驱动重启后由 SR 初值恢复为空映射。

用户/上层业务需要查看 SSU 模组内部各部件的告警状态(如数据盘预失效、系统盘只读、SPU 错误计数、SSU 温度异常等)。BMC 通过带外查询命令周期采集告警信息,统一写入 bmc.dev.SSU接口下的AlarmStatus属性,由具体的上层业务进一步开发,基于该属性值上报告警或在北向接口中显示等。

评审点

在 SSUCard 对象的 bmc.dev.SSU 接口中新增属性AlarmStatus,用于保存查询到的SSU模组告警信息:

详细描述

属性定义

属性名称 变化类型 签名 读写权限 持久化 变化通知 属性说明 属性约束
AlarmStatus 新增属性 a{su} ReadOnly 不持久化 true SSU 模组告警信息状态,key 为告警名称,value 为告警值 key 固定为 21 个告警名称;value 为 U32;仅由 SSU 驱动根据带外查询结果写入,外部只读;查询失败保持上一次结果;BMC 切从/SSU 下电/驱动停止时全部告警值清 0

告警 key 与响应布局

当前SSU通信协议中,该查询命令响应固定 30 字节,按下表顺序解析:

序号 偏移 key 类型 说明
1 0 DataDiskPrefail U8 数据盘预失效
2 1 DataDiskCompErr U8 数据盘比较错误
3 2 DataDiskRO U8 数据盘只读
4 3 DataDiskTempErr U8 数据盘温度异常
5 4 DataDiskMediaErr U8 数据盘媒体错误
6 5 SysDiskPrefail U8 系统盘预失效
7 6 SysDiskCompErr U8 系统盘比较错误
8 7 SysDiskRO U8 系统盘只读
9 8 SysDiskTempErr U8 系统盘温度异常
10 9 SysDiskMediaErr U8 系统盘媒体错误
11 10-13 SPUDdrErrNum U32 SPU DDR 错误计数(小端)
12 14-17 SPUBusErrNum U32 SPU 总线错误计数(小端)
13 18-21 SPUCpuErrNum U32 SPU CPU 错误计数(小端)
14 22 NetErr U8 网络异常
15 23 UCPErr U8 UCP 异常
16 24 SSUTempErr U8 SSU 温度异常
17 25 IMUSysErr U8 IMU 系统异常
18 26 IMPSysErr U8 IMP 系统异常
19 27 SCCSysErr U8 SCC 系统异常
20 28 DataDiskSysErr U8 数据盘系统异常
21 29 SysDiskSysErr U8 系统盘系统异常

后续如果SSU模组更新适配更多告警信息,可以继续使用当前属性,只需要在该属性下新增对应的key-value键值对即可。

评审结论

遗留问题