已开启
[需求]: csr2.0支持IPMI命令执行电源AC操作 #339
byosoft_liyuxin创建于 4 天前
openUBMC-robot
4 天前 评论:
4 天前 评论:
4 天前 将 WeberChen 设为负责人
4 天前 添加了label:sig/sig-hardware
openUBMC-robot
4 天前 评论:
4 天前 评论:
欢迎来到 openUBMC 社区
Hey @byosoft_liyuxin , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅机器人自助配置使用手册。
联系指引
有疑问可以联系 SIG: sig-hardware ,
维护者是: @changxingOpenUBMC, @nathanael, @xiaoxinglxs, @yelvsub ,
优秀贡献者是: @WeberChen, @wwhh_wwhh .


4 天前 关联了看板:openUBMC 26.12 需求看板
openUBMC-robot
4 天前 评论:
4 天前 评论:
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) |


4 天前 修改了issue 的描述
4 天前 将 chzhpfoxjay_123 设为负责人
4 天前 移除了负责人 WeberChen
所属版本
openUBMC26.12
版本分支
openUBMC main
简要说明
csr2.0定制 IPMI 命令 Set AC Mode (NetFn: 0x3e, CMD: 0x25),用于控制指定或全部电源模块的 AC 开关状态,并处理相关异常与约束。
前置条件
MC 运行正常,电源模块支持相应原子能力
系统用户
开发人员、运维人员、测试人员
主成功场景
1、定制 IPMI 命令 Set AC Mode: NetFn: 0x3e, CMD: 0x25, Request Length: 2/3 bytes, Response Length: 1byte, Response Details: 1: Completion Code. 权限: PowerMgmt;
2、BMC 解析请求参数:
PSU Index: 指定目标电源;0xFF 表示所有 PSU
AC mode:
0xFC: AC off
0xFD: Confirm AC off
PowerOnDelay (可选):
不传值时默认 10 秒
0x00: 10 秒
0x01: 20 秒
0x02: 30 秒
当 AC mode 为 Confirm AC off (0xFD) 时,PowerOnDelay 不生效,可不携带
3、电源模块新增原子能力下发配置到电源硬件;
4、IPMI 命令处理模块调用电源模块原子能力,执行对应 AC 操作;
5、电源模块按指定范围(单 PSU / 全部 PSU)完成 AC off 或 Confirm AC off;
6、BMC 返回操作结果,记录操作日志;
非功能需求类型
(1)可靠性要求: 单个电源AC失败,不影响其他无关电源模块正常工作
(2)可维护性要求: 关键日志需记录:命令参数、目标 PSU、执行结果、失败原因
(3)可测试性要求: IPMI接口即可验证
(4)性能要求:IPMI命令执行时间满足性能基线
(5)兼容性要求(和以前版本及周边配套):NA
(6)安全要求: IPMI命令满足电源操作权限要求
(7)韧性要求:NA
兼容性影响评估
NA
扩展场景(含异常场景)
1、参数非法:PSU Index、AC mode、PowerOnDelay 取值不在定义范围 → 返回参数错误,不执行 AC 操作;
2、目标 PSU 不在位/不可达:指定单个 PSU 时目标异常 → 返回失败;
3、对 0xFF 全量操作时,全部失败返回失败,或部分成功返回失败;
4、原子能力执行失败:电源模块底层操作失败(通信超时、硬件拒绝等) → 返回失败,系统状态保持可预期,不出现未定义中间态;
5、并发操作冲突:短时间内对同一 PSU 重复下发 AC 相关命令 → 按互斥/排队策略处理,避免状态紊乱;
周边依赖
NA
约束
1、IPMI命令仅定制仓实现,原子能力电源模块实现;
2、命令执行响应以电源实际返回结果为准;
3、南向驱动CSR2.0实现;