欢迎来到 openUBMC 社区
Hey @changxingOpenUBMC , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅机器人自助配置使用手册。
联系指引
有疑问可以联系 SIG: sig-hardware ,
维护者是: @changxingOpenUBMC, @nathanael, @xiaoxinglxs, @yelvsub ,
优秀贡献者是: @adellonzzy, @dli_bmc, @weiziang, @yelmh .


Issue 工作流介绍
社区的需求和缺陷的工作流状态处于纳管中。
| 类型 | 上个状态 | 下个状态 | 评论命令 | 谁可以操作 |
|---|---|---|---|---|
| 需求 | 待办的 | 已接纳 | /todo2accepted | SIG组: sig-release-management (maintainer) |
| 需求 | 已接纳 | 开发中 | /accepted2developing | 仓库成员角色: Maintainer, Committer, Contributor, Owner |
| 需求 | 开发中 | 待验收 | /developing2UAT | 仓库成员角色: Maintainer, Committer, Contributor, Owner |
| 需求 | 待验收 | 已完成 | /UAT2done | SIG组: sig-QA (maintainer,committer) |
| 需求 | 待办的 | 已挂起 | /todo2suspended | SIG组: sig-release-management (maintainer) |
| 需求 | 已挂起 | 已接纳 | /suspended2accepted | SIG组: sig-release-management (maintainer) |
| 需求 | 待办的 | 已拒绝 | /todo2rejected | SIG组: sig-release-management (maintainer) |
| 需求 | 已拒绝 | 已接纳 | /rejected2accepted | SIG组: sig-release-management (maintainer) |


【架构优化遗留项】厂商固件能力相关校验下沉适配层 so(已同步写入详设遗留问题 3,随 PR !693 提交)
背景:本需求(!693)一致性校验 V2 实现采用"Lua 层 hint 预校验 + 适配层 so(hs_ctrl)权威裁决"双层折中:Lua 侧基于对象缓存分组属性做快速失败与分档选择(delay 上界 250/24、周期分档、mask 选位),hs_ctrl 侧 fresh query 后做权威 gate 与 0x523/0x587 命令字分流,正确性已内聚在 so。
问题:Lua 层(rpc_service_controller.lua)携带了 1880 固件 2.0 的私有能力知识,属层次泄漏;若第二家厂商固件出现同类能力差异,需在 RPC 层继续堆叠厂商 if-else。
建议:出现第二家能力差异厂商时统一重构——能力相关的范围校验/分档/mask 选位下沉到各厂商适配层 so,Lua 仅保留通用参数校验、vendor 检查与错误码→文案映射;下沉前需先定义 so 层校验通用契约(能力查询接口、错误码规范、带参数名错误信息传递机制)。本需求阶段仅一家厂商存在差异且需保持 V1 路径不变,暂不重构。


所属版本
openUBMC 26.12
版本分支
openUBMC main
简要说明
1880 RAID 卡固件区分为固件类型 1.0 与固件类型 2.0,一致性校验功能相关功能需要进行兼容适配
前置条件
BMC运行正常、1880 RAID 卡加载正常
系统用户
运维人员、测试人员、开发人员
主成功场景
1、固件1.0和固件2.0兼容:
(1)固件1.0能力:支持校验周期按照天配置、支持全局自动修复功能开关、任务等待时间取值范围0–24 小时、命令字SET_CONSIS_CHECK = 0x523;
(2)固件2.0能力:支持校验周期按照小时配置、支持不同RAID级别的自动修复功能开关,RAID(1\10)为一类、RAID(5\6\50\60)为一类、任务等待时间取值范围0–250 小时、命令字SET_CONSIS_CHECK_V2 0x587;
2、Web、Redfish接口兼容:
(1)固件1.0支持全局自动修复功能开关、校验周期按照天配置、任务等待时间可配置的取值范围0–24 小时;
(2)固件2.0支持不同RAID级别的自动修复功能开关、校验周期按照小时配置、任务等待时间可配置的取值范围0–250 小时;
(3)针对不同固件类型,兼容全局自动修复功能开关和不同RAID级别的自动修复功能开关的配置;
3、不同固件类型的RAID卡固件在对应的配置范围内均能成功设置一致性校验功能;
4、操作日志记录:一致性校验配置的操作日志记录;
5、资料刷新:webreset、redfish接口资料刷新;
非功能需求类型
(1)可靠性要求:不同固件类型的RAID卡固件均能设置一致性校验成功
(2)可维护性要求:一致性校验功能设置成功及失败原因可在日志中记录
(3)可测试性要求:Web、Redfish接口即可验证固件类型 1.0/2.0 的属性返回、取值范围校验、超范围失败及设置成功等场景
(4)性能要求:NA
(5)兼容性要求(和以前版本及周边配套):兼容固件类型1.0和固件类型2.0的RAID卡固件
(6)安全要求:NA
(7)韧性要求:NA
兼容性影响评估
兼容固件类型1.0和固件类型2.0的RAID卡固件一致性校验配置与命令字差异
扩展场景(含异常场景)
1、固件类型无法识别或未返回时,需要重试获取,如果始终失败则更新为固件类型1.0;
2、固件类型2.0配置全局自动修改功能开关时,兼容设置所有RAID级别的自动修改功能;
周边依赖
1、1880 RAID卡固件:固件类型1.0/2.0及一致性校验命令字(SET_CONSIS_CHECK=0x523、SET_CONSIS_CHECK_V2=0x587);
2、Web、Redfish北向接口:按固件类型暴露差异化配置能力;
3、操作日志与接口资料(webreset/redfish):配置记录与资料刷新。
约束
仅1880 RAID 卡适配固件类型