背景
SSU 模组内部包含数据盘、系统盘、SPU、IMU、IMP、SCC 等部件,运行过程中可能产生硬盘预失效、比较错误、只读、温度异常、媒体错误、SPU 错误计数、网络异常及系统异常等告警。当前 BMC 侧没有统一的 SSU 告警信息设备树属性,北向与上层业务无法直接获取这些告警状态。
SSU 固件已提供告警信息查询命令,响应固定 30 字节,每个字节(或 4 字节)对应一种告警。BMC 需要周期性查询该命令,并将结果保存到 SSUCard 对象的 bmc.dev.SSU 接口下,供上层业务使用。
关联 ISSUE
[需求]: 支持SSU模组的告警信息查询-component_drivers-AtomGit
整体方案
- 属性定义:在 SSUCard 对象的
bmc.dev.SSU接口新增只读属性AlarmStatus,类型a{su}(key 为告警名称,value 为U32告警值),不持久化,默认空映射,变化通知打开。 - 带外查询命令:在
ssu_oob中新增get_alarm_info(),通过 Vendor Get 命令查询告警信息,响应固定 30 字节;按告警名称解析为a{su}。 - 周期查询任务:在当前 BMC 为主且 SSU 上电(带外管理已启动)时,每 10s 查询一次告警信息并更新
AlarmStatus;仅在属性内容变化时写库。 - 失败保持:查询失败(带外异常 / CQE 状态非 0 / 响应长度不足 30 字节)时,
AlarmStatus保持上一次查询结果不变。 - 停止清零:BMC 切换为从、SSU 下电或驱动停止时,在停止周期任务的同时将全部告警值清 0(保留全部告警 key)。
- 不持久化:属性不持久化,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键值对即可。