感谢您为社区贡献新需求！请按照以下提示提供详细信息，以便我们更好地理解并跟进。

版本分支

openUBMC main

需求属性

所属版本

openUBMC 26.09

工作量

NA

是否需要编码

是

是否免测试

否

周边依赖

NA

需求来源

NA

需求描述

简要说明

风扇故障后支持自愈能力，通过CSR配置是否开启自愈功能及自愈次数。检测到风扇故障后，若配置了自愈功能，BMC通过寄存器对风扇进行上下电自愈操作，自愈后延迟重新检测风扇是否恢复正常，自愈次数按CSR配置，达到最大自愈次数仍未恢复则产生告警

系统用户

开发人员、测试人员、运维人员

前置条件

BMC运行正常

主成功场景

（1）BMC启动后加载CSR配置，读取风扇自愈功能开关和自愈次数；
（2）BMC持续监控风扇运行状态，检测到风扇故障（风扇停转/转速异常等）；
（3）判断CSR是否配置自愈功能：
1、自愈功能开启：通过寄存器对故障风扇执行上下电自愈操作；
2、自愈功能未开启：直接产生风扇故障告警；
（4）自愈操作完成后，延迟等待一段时间，重新检测风扇是否恢复正常：
1、恢复正常：自愈成功，重置自愈计数，恢复正常监控，记录自愈成功日志；
2、未恢复：判断是否达到CSR配置的最大自愈次数：
- 未达到：自愈计数加1，重新执行上下电自愈操作；
- 已达到：达到最大自愈次数仍未恢复，产生风扇故障告警；
（5）CSR配置可以区分风扇是共享风扇还是独立风扇，只对独立风扇进行自愈；

扩展场景（含异常场景）

1、CSR未配置自愈次数：按默认自愈3次执行；
2、BMC复位需要保存已自愈的次数；
3、多风扇同时故障：各风扇独立执行自愈流程，互不影响，每个风扇独立计数，独立告警；

约束

1、风扇自愈功能开关和自愈次数由CSR配置决定，未配置自愈功能时不执行自愈；
2、自愈后需延迟一段时间再重新检测，避免误判；
3、多风扇自愈独立处理，互不影响；
4、仅针对节点独立风扇，不对共享风扇自愈；

非功能需求

（1）可靠性要求：自愈操作不得影响其他风扇正常运行
（2）可维护性要求：自愈功能开关和自愈次数通过CSR配置、自愈全流程有详细日志
（3）可测试性要求：支持CSR配置修改自愈功能开关和自愈次数、支持模拟风扇故障
（4）性能要求：NA
（5）兼容性要求(和以前版本及周边配套)：自愈功能默认关闭
（6）安全要求：NA
（7）韧性要求：NA