背景
某产品1825大板网卡,当带内异常的时候,需要支持带外通过IPMI命令单独复位单个1825网卡芯片,用于故障恢复,支持区分平滑复位与强制复位。现需通过IPMI通道,不新增IPMI命令,扩展现有的Set Component Parameters命令实现网卡复位。
关联ISSUE
暂无
决策点
扩展现有设备设置类命令Set Component Parameters,新增Parameter Selector=0xC001支持复位网卡,通过Parameter Data区分平滑复位与强制复位
详细描述
1、Set Component Parameters(扩展)
IPMI命令字: NetFn: 0x30, Cmd: 0x93 ,SubCmd: 0x8F
变化类型:扩展现有接口(新增Parameter Selector取值)
持久化类型: 不涉及
优先级:Default
操作权限:BasicSetting
请求说明:
| 字节顺序 | 域内容 |
|---|---|
| NetFn | 30h |
| Cmd | 93h |
| 1:3 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| 4 | Sub command,子命令 = 8Fh |
| 5:8 | Component Type, LS Byte first [31]:设备类型标识符类型 0-设备类型标识符参考DMTF规范文档DSP0249中PLDM Entity ID Code tables的定义 1- 设备类型标识符参考表 设备类型(Component Type)定义 [16:30]:reserved [0:15]:设备类型标识符 |
| 9 | Group Id,组编号。0xFF表示无效值。 若设备编号在产品上不全局唯一,则必须根据产品规划填充此字段,后台根据组编号和设备编号进行索引; 若设备编号在产品上全局唯一,则此字段填充无效值,后台只根据设备编号进行索引; 若设备编号全局唯一但填充有效值或设备编号不全局唯一但填充无效值,则命令返回C9h。 |
| 10:11 | Component Id,LS Byte first 设备编号,若设备支持丝印编号,则与丝印编号保持一致;若设备不支持丝印编号,则填逻辑编号 |
| 12:13 | Parameter Selector,LS Byte first,参见Component Parameters表 |
| 14 | [7:1]:reserved [0]:级联标志 0=是最后一帧数据 1=后面还有数据 |
| 15:16 | Write Offset,LS Byte first 写入的数据偏移,从0开始,当数据较长需要多次写入时,一定要从头到尾按顺序写入,不能乱序。 |
| 17 | Length 本次写入长度N |
| 18:17+N | Parameter Data,参见Component Parameters表 |
| 响应说明: | |
| 字节顺序 | 域内容 |
| 1 | Completion Code 00h = Command Completed Normally C9h = Parameter Out of Range CCh = Invalid Data Field in Request CEh = Command Response Could not Be Provided |
| 2:4 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
Component Parameters表(新增行):
| Parameter Selector | 功能描述 | Parameter Data-Get | Parameter Data-Set |
|---|---|---|---|
| 0xC001 | 复位网卡 | 不涉及 | 仅支持Component Type=0x8000000D 请求: Group Id:0xFF Component Id:网卡逻辑编号(NodeId数字后缀,如UBEthernetAdapter1的编号1) Write Offset:0x0000 Length:1 Data:• data1-复位类型 0x01 = 平滑复位 0x02 = 强制复位 其他值返回CCh 响应: 无 |
命令示例:
复位逻辑编号为1的1825网卡
样例1:平滑复位逻辑编号为1的1825网卡
请求:
ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x8f 0x0d 0x00 0x00 0x80 0xff 0x01 0x00 0x01 0xc0 0x00 0x00 0x00 0x01 0x01
响应:
db 07 00
样例2:强制复位逻辑编号为1的1825网卡
请求:
ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x8f 0x0d 0x00 0x00 0x80 0xff 0x01 0x00 0x01 0xc0 0x00 0x00 0x00 0x01 0x02
响应:
db 07 00
实现组件:
network_adapter仓