【已评审】新增查询/设置环境变量北向接口（IPMI/CLI）评审

Interface SIG Interface评审
1

评审点一，新增设置/查询环境变量的IPMI命令：

设置环境变量的IPMI命令： Set Soc Environment Variable
操作类型：SET
请求说明：
字节顺序 域内容
NetFn 30h
CMD 90h
1 Sub command，子命令= 0x80
2 Parameter Selector
3 Data Length
4:N Configuration parameter data 请参见表Host Info Parameters Table - set
响应说明：
字节顺序 域内容
1 Completion Code
表Host Info Parameters Table - set
Parameter 操作权限 # Parameter Data 说明
Set Host Gmac BasicSetting 01h 请求：
data3：Data Length 7；data4：HostGmacIndex；data[5-10]：MacAddr
Set Coprocessor Boot Mem Limit SecurityMgmt 02h 请求：
data3：Data Length 4；data[4-7]：MemSize，十六进制		 仅限装备使用
使用示例：
// 请求：设置HOST.GMAC 1的MAC地址为00 18 82 01 02 04
ipmitool raw 30 90 80 01 07 01 00 18 82 01 02 04
// 响应：
00

查询环境变量的IPMI命令：Get Soc Environment Variable

操作类型：GET
请求说明：
字节顺序 域内容
NetFn 30h
CMD 90h
1 Sub command，子命令= 0x81
2 Parameter Selector
3 Data Length
4:N Parameter Data 请参见表Host Info Parameters Table - get
响应说明：
字节顺序 域内容
1 Completion Code
2 Data Length
3:N Parameter Data 请参见表Host Info Parameters Table - get
表Host Info Parameters Table - get
Parameter 操作权限 # Parameter Data 说明
Get Host Gmac BasicSetting 01h 请求：
Data Length: 1；data4：HostGmacIndex。
响应：
Data Length：6；data[3-8]：MacAddr
Get Coprocessor Boot Mem Limit SecurityMgmt 02h 请求：
Data Length: 0。
响应：
Data Length：4；data[3-6]：MemSize，十六进制。		 仅限装备使用
使用示例：
// 请求：查询HOST.GMAC 1的MAC地址
ipmitool raw 30 90 81 01 01 01
// 响应：
00 06 00 18 82 01 02 04

评审点二，新增设置HOST.GMAC的CLI命令：

查询SOC环境变量的CLI命令：

变化类型：新增命令字
操作权限：BasicSetting
ipmcget -t envvar -d <dataitem> -v <gmacindex>
    -d <dataitem>
       hostgmac                      Get host GMAC address
使用示例：
// 请求：查询HOST.GMAC 1的MAC地址
ipmcget -t envvar -d hostgmac -v 1

20:22:01:88:AB:48

设置SOC环境变量的CLI命令：

变化类型：新增命令字
操作权限：BasicSetting
ipmcset -t envvar -d <dataitem> -v <gmacindex> <macaddr>
    -d <dataitem>
       hostgmac                      Set host GMAC address
使用示例：
// 请求：设置HOST.GMAC 1的MAC地址
ipmcset -t envvar -d hostgmac -v 1 20:22:01:88:AB:48

Set host GMAC address successfully.
参数说明：
参数名称 取值类型 说明 取值范围 是否可选
gmacindex integer gmac的索引 [1, 2] 否
macaddr string mac地址 mac地址 否

评审结论

  • 评审点1： 通过，同意新增IPMI命令，用于查询和设置 SoC 环境变量信息，其中命令的 NetFn = 30h， Cmd = 90h，子命令字设置为 80h， 查询为 81h。
    具体命令定义，参数说明以及权限见议题。
  • 评审点2： 通过，同意新增CLI命令，用于查询和设置 HOST GMAC 信息。具体命令如下：
    查询：ipmcget -t envvar -d hostgmac -v <gmacindex>
    设置：ipmcset -t envvar -d hostgmac -v <gmacindex> <macaddr>
    具体的命令定义以及参数说明见议题。