已开启
[需求]: csr2.0支持IPMI命令执行电源AC操作 #339
byosoft_liyuxin创建于  4 天前
byosoft_liyuxin
byosoft_liyuxin成员
4 天前 创建

所属版本

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实现;

likedislike
openUBMC-robot
openUBMC-robot成员
4 天前 评论:

注意

此 Issue 需要负责人。 如果没有指派时, WeberChen 是默认的负责人

likedislike
openUBMC-robotopenUBMC-robot成员
4 天前 将 WeberChen 设为负责人
openUBMC-robotopenUBMC-robot成员
4 天前 添加了label:sig/sig-hardware
openUBMC-robot
openUBMC-robot成员
4 天前 评论:

欢迎来到 openUBMC 社区

Hey @byosoft_liyuxin , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅机器人自助配置使用手册。

联系指引

有疑问可以联系 SIG: sig-hardware ,
维护者是: @changxingOpenUBMC, @nathanael, @xiaoxinglxs, @yelvsub ,
优秀贡献者是: @WeberChen, @wwhh_wwhh .

likedislike
openUBMC-robotopenUBMC-robot成员
4 天前 关联了看板:openUBMC 26.12 需求看板
openUBMC-robot
openUBMC-robot成员
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)
likedislike
byosoft_liyuxinbyosoft_liyuxin成员
4 天前 修改了issue 的描述
byosoft_liyuxinbyosoft_liyuxin成员
4 天前 将 chzhpfoxjay_123 设为负责人
byosoft_liyuxinbyosoft_liyuxin成员
4 天前 移除了负责人 WeberChen