Closed
[需求]: 支持定制IPMI命令执行电源AC操作 #272
changdexingAdd on  Jul 22Closed at  Sep 8
changdexingCollaborators
Jul 22 Create

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

版本分支

openUBMC main

需求属性

所属版本

openUBMC 26.09

工作量

NA

是否需要编码

是

是否免测试

否

周边依赖

NA

需求来源

NA

需求描述

简要说明

支持通过定制 IPMI 命令 Set AC Mode 对电源模块(PSU)执行 AC 下电及相关确认操作;电源模块需新增原子能力,承接并实现电源 AC 操作,保障命令可按指定 PSU、模式及上电延时正确执行

系统用户

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

前置条件

BMC运行正常、PSU 在位且通信正常

主成功场景

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、参数非法:PSU Index、AC mode、PowerOnDelay 取值不在定义范围 → 返回参数错误,不执行 AC 操作;
2、目标 PSU 不在位/不可达:指定单个 PSU 时目标异常 → 返回失败;
3、对 0xFF 全量操作时,全部失败返回失败,或部分成功返回失败;
4、原子能力执行失败:电源模块底层操作失败(通信超时、硬件拒绝等) → 返回失败,系统状态保持可预期,不出现未定义中间态;
5、并发操作冲突:短时间内对同一 PSU 重复下发 AC 相关命令 → 按互斥/排队策略处理,避免状态紊乱;

约束

1、IPMI命令仅定制仓实现,原子能力电源模块实现;
2、命令执行响应以电源实际返回结果为准;

非功能需求

(1)可靠性要求:单个电源AC失败,不影响其他无关电源模块正常工作
(2)可维护性要求:关键日志需记录:命令参数、目标 PSU、执行结果、失败原因
(3)可测试性要求:IPMI接口即可验证
(4)性能要求:IPMI命令执行时间满足性能基线
(5)兼容性要求(和以前版本及周边配套):NA
(6)安全要求:IPMI命令满足电源操作权限要求
(7)韧性要求:NA

likedislike
openUBMC-robot
openUBMC-robotCollaborators
Jul 22 Comments:

注意

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

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Jul 22 Assign WeberChen as responsible person
openUBMC-robotopenUBMC-robotCollaborators
Jul 22 Added label: sig/sig-hardware
openUBMC-robot
openUBMC-robotCollaborators
Jul 22 Comments:

欢迎来到 openUBMC 社区

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

机器人使用手册

有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

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

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Jul 22 associated Kanban: openUBMC 26.09 需求看板
openUBMC-robot
openUBMC-robotCollaborators
Jul 22 Comments:

Issue 工作流介绍

社区的需求和缺陷的工作流状态处于纳管中。

类型 上个状态 下个状态 评论命令 谁可以操作
需求 待办的 已接纳 /todo2accepted SIG组: sig-release-management (maintainer)
需求 已接纳 开发中 /accepted2developing 仓库成员角色: Maintainer, Committer, Contributor, Owner
需求 开发中 转测中 /developing2testing 仓库成员角色: Maintainer, Committer, Contributor, Owner
需求 转测中 待验收 /testing2UAT 仓库成员角色: 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
CchangdexingCollaborators
Jul 22 Modify description of issue
wangjianCollaborators
Jul 25 Comments:

/todo2accepted

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Jul 25 changed custom state from 待办的 to 已接纳
jiazeyuanjiazeyuanCollaborators
Aug 20 Associated pull request
jiazeyuanjiazeyuanCollaborators
Aug 20 Associated pull request
jiazeyuanjiazeyuanCollaborators
Aug 20 Associated pull request
jiazeyuanjiazeyuanCollaborators
Aug 21 Associated pull request
zhaotianliCollaborators
Aug 22 Comments:

PR #706 回顾分析: 【e5f7906ba049018534ca900976eaa7f6】feat: 支持设置和查看电源启动延时时间

仓库: openUBMC/mdb_interface
分支: ipmi → main
合并时间: 2026-08-21 21:30
作者: jiazeyuan

注:get-ai-review 未检索到 OpenClaw AI 检视记录(返回空)。本回顾纳入两类 AI 生成内容:GitCode 平台 AI 代码审查(atomgit-bot,结论"未发现问题")与 AI 一致性检视(@Richardli25,结论"部分一致")。


1. AI 检视意见追踪

# 来源 AI 发现 严重度 后续处理 说明
1 AI 一致性检视 (Richardli25) PowerOnDelaySeconds 的 options.emitsChangedSignal 配置为 "true",与设计帖两处明确的"变化通知: false"不一致 中等 ✅ 已采纳修复 AI 检视(08-20 22:29)后开发者更新分支(08-21 18:53 commit),最终合并代码为 "emitsChangedSignal": "false",与设计评审结论一致
2 AI 一致性检视 (Richardli25) 描述措辞与设计不统一(代码用"电源启动延时时间",设计用"电源开机延时时间");方法描述缺少"配合同接口下的Reset方法使用" 建议 ⏳ 未响应 最终合并代码属性/方法/参数描述仍为"电源启动延时时间",方法描述未补充配合 Reset 使用的说明;语义等价,不影响功能
3 AI 一致性检视 (Richardli25) CHANGELOG 新版本 [1.110.35] 日期 2026-8-18 早于旧版本 [1.110.34] 的 2026-8-20,疑似笔误 建议 ✅ 已采纳修复 最终 CHANGELOG 为 [1.110.37] - 2026-8-21,日期倒挂消除(版本号经 rebase 顺延过 Chip 接口的 1.110.36)
4 atomgit-bot 代码审查 —(未发现问题) — — 无需处理 /ai review 触发的通用代码审查无发现
指标 结果
AI 意见总数 3(不含无发现的 atomgit-bot)
已采纳并修复 2
已回复说明 0
未响应 1(建议级措辞统一)

2. 人工检视补充

  • 检视人: changxingOpenUBMC (changdexing)、DataSculptor (wangjian)
  • 意见概要:
    • changxingOpenUBMC(08-21 19:44,pr_comment):指出 PowerOnDelaySeconds 的 default: 0 不合适,应设为异常值,否则属性读取不到时会被误认为读到 0。
    • DataSculptor:/lgtm /approve 通过检视。
  • 解决状态: ⏳ 未修复、未回复——该意见发表后无新 commit,开发者未作回复,最终代码保留 default: 0 合入;检视者本人在意见 8 分钟后给予 /lgtm,PR 正常通过合入。

说明:该人工意见关注的是"读取失败时默认值与真实值 0 的语义歧义",属 AI 检视与设计帖均未覆盖的实现侧风险,体现了人工检视的补充价值。建议在 power_mgmt 实现侧确认电源读取失败路径的属性值表现,必要时后续版本将默认值调整为异常值(如 0xFFFFFFFF)或在提供者侧保证失败时不暴露 0。

3. 评审贴覆盖情况

评审贴链接:【已评审】新增电源开机延时时间设置资源协作接口

评审点 接口类型 是否涵盖
评审点1:OnePower 接口新增 PowerOnDelaySeconds 属性(签名 u/只读 True/变化通知 false/不易变)+ SetPowerOnDelaySeconds 方法(req: u, rsp: 无) 资源协作 ✅ 已涵盖

覆盖统计: 1/1(属性 baseType U32、readOnly、emitsChangedSignal false 及方法 req/rsp 签名均与评审结论一致;预审警告 MDB-RISK-004 为建议性非设计要求;访问权限/持久化配置属 MDS 范围,不在本仓库)

4. 总结

  • AI 检视核心问题有效闭环:一致性检视判定"部分一致"的唯一 major 差异(emitsChangedSignal 与设计相悖)已被开发者修复,最终实现与设计评审结论完全一致;CHANGELOG 日期笔误一并消除,AI 意见采纳率 2/3,唯一未响应项为建议级措辞统一问题("启动"vs"开机"),语义等价、不影响功能。
  • 开发者响应及时:AI 检视(08-20 深夜)次日即更新分支并通过 CI,从 PR 创建到合入约 24 小时,流程紧凑完整(AI 审查 + 一致性检视 + 人工检视 + CI 全绿 + 双 approve)。
  • 人工检视补充价值:changxingOpenUBMC 提出的默认值语义问题(读取失败误判为 0)是 AI 与设计帖均未覆盖的风险点,但该意见未获代码响应即随 /lgtm 合入;结合 PR #652 的类似案例(默认值经人工检视现场调整),建议此类"实时读取型属性默认值"在设计评审阶段即明确异常值约定。
  • 模式观察:emitsChangedSignal 配置与设计不一致在本仓库多次出现(PR #652、#706),且均靠 AI 一致性检视发现后修复,建议模板/检视清单将其列为新建属性的强制检查项。

此回顾分析由 AI (OpenClaw + GLM-5-turbo) 完成

likedislike
jiazeyuan
jiazeyuanCollaborators
Sep 5 Comments:

/accepted2developing

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Sep 5 changed custom state from 已接纳 to 开发中
jiazeyuan
jiazeyuanCollaborators
Sep 5 Comments:

/developing2testing

likedislike
jiazeyuan
jiazeyuanCollaborators
Sep 5 Comments:

/testing2UAT

likedislike
jiazeyuan
jiazeyuanCollaborators
Sep 5 Comments:

/developing2testing

likedislike
jiazeyuan
jiazeyuanCollaborators
Sep 5 Comments:

/developing2UAT

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Sep 5 changed custom state from 开发中 to 待验收
ZDYM
ZDYMCollaborators
Sep 8 Comments:

/UAT2done

likedislike
openUBMC-robotopenUBMC-robotCollaborators
Sep 8 changed custom state from 待验收 to 已完成
openUBMC-robotopenUBMC-robotCollaborators
Sep 8 Close issue