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评审"
