【申报模板】【待评审】IPMI 新增 XXX 命令

ISSUE 链接

【选填】填写议题关联的 issue 链接,如果需求还未定或者涉及不便公开的内容,则写明不涉及以及不涉及的原因(此提示正式评审议题删除)

背景

必填】文字描述议题的背景,主要讲清楚问题的场景以及需要增加命令的必要性(此提示正式评审议题删除)

评审点

必填】文字描述评审点,如果涉及多个评审点则分评审点子项分别罗列进行评审(此提示正式评审议题删除)

评审点1:IPMI 新增 XXX 命令

必填】文字描述评审点的命令详细信息,对于 蓝色斜体 部分字体自行根据评审的诉求进行替换(替换时连同格式一起替换,替换之后保持正文格式,不需要保留样式)

命令名称: XXX
命令说明: 命令的主要功能以及使用约束(如仅带内BT通道访问等)
命令权限: ReadOnly
是否锁定之后可以访问: 是/否
是否有敏感数据: 是/否
命令样式: 使用 ipmitool 说明命令的请求样式,参数使用大驼峰。举例如下(正式评审中按需替换示例):

  • 请求:ipmitool raw 0x30 0x90 <ManufacturerID> <SubCmd> <Length> <Data>
  • 响应:<ManufacturerID> <Result>

命令请求参数: 按照命令样式(请求)中的参数和顺序依次说明参数。举例如下(正式评审中按需替换示例):

字节顺序 域取值说明
NetFn 30h
Cmd 90h
1:3 Manufacturer ID,LB Byte first。长度固定 3 个字节,例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为第1个字节为 DBh,第二个字节为 07h,第三个字节为 00h。
4 SubCmd,固定为 78h
5 Length, 命令长度
6:N Data,测试配置数据

命令响应参数: 按照命令样式(响应)中的参数和顺序依次说明参数。举例如下(正式评审中按需替换示例):

字节顺序 域取值说明
1 Completion Code,所有的完成码则需要单独和详细说明,比如:
00h = 【标准完成码】命令响应成功
CCh = 【标准完成码】命令入参超过支持范围
80h = 【非标完成码】命令的长度和参数不匹配
81h = 【非标完成码】命令的参数无法支持
2:4 Manufacturer ID,LB Byte first。长度固定 3 个字节,例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为第1个字节为 DBh,第二个字节为 07h,第三个字节为 00h。
5 Result ,下发结果,取值如下:
00h = 命令下发成功
01h = 命令下发失败

命令示例: 使用 ipmitool 说明命令的示例,示例需要明确命令的参数和使用方法(注意敏感数据进行脱敏处理)。举例如下(正式评审中按需替换示例):
样例1: 设置 DDR 的测试配置为 [255 255 255 255]

  • 请求:ipmitool raw 0x30 0x90 0xdb 0x07 0x00 0x78 0x04 0xff 0xff 0xff 0xff
  • 响应:db 07 00 00

评审点2:IPMI 新增 YYY 命令

【选填】格式同 评审点1,如果仅有一个评审点则 当前评审点整章节删除 即可

评审结论

【评审前选填,评审后必填】评审结束后录入,描述全面且清晰,不能是通过或不通过、同意或不同意(此部分正式评审议题删除)

遗留问题

【选填】如果评审会议上没有明确结论则记录问题,如果没有则填写 或者 本章节整章节删除 即可

——————(以下部分为议题申报提醒,正式评审议题删除)——————
在interface板块创建话题时,标题和内容参考上面的模板,话题类别请选择"Interface评审"