ipmi接口文档格式评审

背景
(必选)从最终用户视角阐述当前有什么问题,包含问题的场景、影响点,以及当前系统的差距。

需要新增IPMI命令"Get Command Support"(查询命令支持能力),用于查询指定通道、LUN下特定NetFn的命令支持情况。该命令允许用户了解BMC支持的IPMI命令范围,对于IPMI功能发现和兼容性检测至关重要。当前系统缺少此命令,用户无法动态查询BMC的命令支持能力。

关联ISSUE
(可选)此议题关联的代码仓的issue链接。

整体方案
(可选)简要描述此议题关联的整体方案,包括但不限于逻辑架构、组件依赖关系、交互上下文。

实现IPMI App层(NetFn 06h)下的Get Command Support命令(CMD 0Ah),接收用户请求的通道号、NetFn、操作标记和LUN参数,返回对应范围的命令支持度掩码。

评审点
(必选)一句话概括描述待评审的内容。

新增IPMI命令Get Command Support(NetFn: 06h, CMD: 0Ah)的接口设计评审。

详细描述
(必选)详细描述接口设计,多种备选设计时需要以表格的方式对比优缺点。

场景3:新增/变更IPMI命令

项目 描述
命令字 NetFn: 06h (App)
CMD: 0Ah
权限 User
功能说明 查询IPMI命令支持能力

请求参数:

字节顺序 域名称 类型 取值范围/说明
1 Channel uint8 当前查询命令支持度的通道号
2 Operation uint8 当前查询命令支持度的操作参数,位域排布:
- [0:5] NetFN:查询命令支持度需要的NetFN(6位)
- [6:7] Operation:查询命令支持度的标记(2位)
- 00b:查询命令范围 00h ~ 7Fh
- 01b:查询命令范围 80h ~ FFh
3 LUN uint8 当前查询命令支持度的LUN,取值范围 [0, 3]

响应参数:

字节顺序 域名称 类型 取值范围/说明
1 Completion Code uint8 命令完成码
2:17 Support Mask uint8[16] 支持度掩码(16字节),每个bit位含义:
- 00b:命令可用
- 01b:命令不可用
掩码映射规则:
- byte 1, bit 0 → command 00h 或 80h
- byte 1, bit 7 → command 07h 或 87h
- …
- byte 16, bit 0 → command 78h 或 F8h
- byte 16, bit 7 → command 7Fh 或 FFh

响应码:

  • 00h:命令完成成功
  • CCh:无效的通道号
  • 其他标准IPMI错误码

是否准备好AI预审
(必选)是/否

评审结论
(必选)针对决策点,详细描述最终结论,不能是简单的同意或不同意,通过或不通过。

(可选)列出评审会议现场无法直接给出明确结论的事务。