跳到主要内容

OEM IPMI 命令

XCC 支持以下 IPMI OEM 命令。每个命令需要不同的权限级别,如下所示。

代码Netfn 0x2E 命令权限

0xCC

将 XCC 重置为默认设置

PRIV_USR

代码Netfn 0x3A 命令权限

0x00

查询固件版本

PRIV_USR

0x0D

板信息

PRIV_USR

0x1E

机箱电源恢复延迟选项

PRIV_USR

0x38

NMI 和重置

PRIV_USR

0x49

发起数据收集

PRIV_USR

0x4A

推送文件

PRIV_USR

0x4D

数据收集状态

PRIV_USR

0x50

获取 Build 信息

PRIV_USR

0x55

获取/设置主机名

PRIV_USR

0x6B

查询 FPGA 固件修订级别

PRIV_USR

0x6C

查询板硬件修订级别

PRIV_USR

0x6D

查询 PSoC 固件修订级别

PRIV_USR

0x98

前面板 USB 端口控制

PRIV_USR

0xC7

本机 NM IPMI 交换机

PRIV_ADM

将 XCC 重置为默认设置命令

此命令将 XCC 配置设置重置为默认值。

网络功能 = 0x2E
代码命令请求、响应数据描述
0xCC

将 XCC 重置为默认设置

请求:

字节 1 – 0x5E 字节 2 – 0x2B

字节 3 – 0x00

字节 4 – 0x0A 字节 5 – 0x01

字节 6 – 0xFF

字节 7 – 0x00 字节 8 – 0x00

字节 9 – 0x00

响应:

字节 1 – 完成代码 字节 2 – 0x5E 字节 3 – 0x2B

字节 4 – 0x00

字节 5 – 0x0A 字节 6 – 0x01

字节 7 – 响应数据
  • 0 = 成功
  • 非 0 = 失败

此命令将 XCC 配置设置重置为默认值。

板/固件信息命令

本节列出了用于查询板和固件信息的命令。

网格功能 = 0x3A
代码命令请求、响应数据描述

0x00

查询固件版本

请求

无请求的数据

响应

字节 1 – 完成代码

字节 2 – 主要版本

字节 3 – 次要版本

此命令返回固件的主要和次要版本号。如果使用可选的 1 字节请求数据发出命令,则 XCC 响应还会返回版本的第三个字段(修订号)。

(主要.次要.修订)

0x0D

查询板信息

请求:不适用

响应

字节 1 – 系统标识

字节 2 – 板修订号

此命令返回板 ID 和平板修订号。

0x50

查询 Build 信息

请求:不适用

响应

字节 1 – 完成代码。

字节 2:10 – ASCIIZ Build 名称

字节 11:23 – ASCIIZ Build 日期

字节 24:31 – ASCII Build 时间

此命令返回 Build 名称,Build 日期和 Build 时间。Build 名称和 Build 日期字符串以零终止。

Build 日期格式为 YYYY-MM-DD。

例如,“ZUBT99A”
  • “2005-03-07”
  • “23:59:59”

0x6B

查询 FPGA 固件修订级别

请求

字节 1 – FPGA 设备类型*

FPGA 设备类型

0 = 本地(活动级别)

1 = CPU 卡 1(活动级别)

2 = CPU 卡 2(活动级别)

3 = CPU 卡 3(活动级别)

4 = CPU 卡 4(活动级别)

5 = 本地主要 ROM

6 = 本地恢复 ROM

响应

字节 1 – 完成代码

字节 2 – 主要修订级别

字节 3 – 次要修订级别

字节 4 – 次要子修订级别

(XCC 平台上的测试字节)

此命令返回 FPGA 固件的修订级别。

如果省略字节 1,则将选择本地(活动级别)

0x6C

查询板硬件修订级别

请求

无数据。

响应

字节 1 – 完成代码

字节 2 – 修订级别

此命令返回 FPGA 所在板硬件的修订级别。

0x6D

查询 PSoC 固件修订级别

请求

响应

字节 1 – 完成代码

字节 2 – bin#

字节 3 – APID

字节 4 – 修订号

字节 5-6 – FRU ID

字节 6:N – 对每个检测到的 PSoC 重复字节 2-6

此命令返回所有检测到的 PSoC 设备的修订级别。

注:bin# 代表物理位置。有关详细信息,请查阅系统规格。

系统控制命令

IPMI 规格提供基本电源和重置控制。Lenovo 增加了其他控制功能。

网络功能 = 0x2E
代码命令请求、响应数据描述

0x1E

机箱电源恢复延迟选项

请求:

字节 1

请求类型:

0x00 = 设置延迟选项

0x01 = 查询延迟选项

字节 2

(如果字节 1= 0x00)

0x00 = 已禁用(默认)

0x01 = 随机

0x02 - 0xFF 已保留

响应

字节 1 – 完成代码

字节 2 – 延迟选项(仅适用于查询请求)

如果机箱电源恢复策略设置为交流电源通电/电源恢复时始终打开电源或恢复为打开电源(如果之前打开了电源),则使用此设置。有 2 个选择:已禁用(默认设置,打开电源时无延迟)和随机。随机延迟设置提供在交流电源通电/电源恢复以及服务器自动开机时发生 1 到 15 秒之间的随机延迟。

XCC 仅在机架服务器上支持此命令。

0x38

NMI 和重置

请求

字节 1 – 秒数
  • 0 = 仅限 NMI

字节 2 – 重置类型
  • 0 = 软重置
  • 1 = 关闭再打开电源

响应

字节 1 – 完成代码

此命令用于执行系统 NMI。(可选)可以在 NMI 之后重置系统(重新引导)或关闭再打开电源。

如果“秒数”字段不为 0,则系统将在指定的秒数过后重置或关闭再打开电源。

请求的字节 2 为可选。如果未提供字节 2,或者字节 2 的值为 0x00,则将执行软重置。如果字节 2 为 0x01,则将关闭再打开系统电源。

其他命令

本节收录了其他各节不适用的命令。

网格功能 = 0x3A
代码命令请求、响应数据描述

0x55

获取/设置主机名

请求长度 = 0

空请求数据

响应

字节 1

完成代码

字节 2-65

当前主机名。

ASCIIZ,以 Null 终止的字符串。

请求长度 1-64

字节 1-64

DHCP 主机名

ASCIIZ 以 00h 终止

使用此命令获取/设置主机名。

设置主机名时,所需的值必须以 00h 终止。主机名限制为 63 个字符(包括 null 在内)。

0x98

前面板 USB 端口控制

请求

字节 1

01h:

获取前面板 USB 端口的当前所有者

响应

字节 1 – 完成代码

字节 2

00h:

由主机所有

01h:

由 BMC 所有

请求

字节 1

02h:

获取前面板 USB 端口的配置

响应

字节 1 – 完成代码

字节 2

00h:

主机专用

01h:

BMC 专用

02h:

共享模式

字节 3:4 – 空闲超时,以分钟为单位(最高有效字节在前)

字节 5 – 启用标识按钮

00h:

已禁用

01h:

已启用

字节 6 – 滞后(可选),以秒为单位

请求

字节 1

03h:设置前面板 USB 端口的配置

字节 2

00h:

主机专用

01h:

BMC 专用

02h:

共享模式

字节 3:4 – 空闲超时,以分钟为单位(最高有效字节在前)

字节 5 – 启用标识按钮

00h:

已禁用

01h:

已启用

字节 6 – 滞后(可选),以秒为单位

响应

字节 1 – 完成代码 字节 2

00h:

切换到主机

01h:

切换到 BMC

响应

字节 1 – 完成代码

字节 1

05h:

启用/禁用前面板 USB 端口

字节 2

00h:

禁用

01h:

启用

响应

字节 1 – 完成代码

请求

字节 1

06h:

读取前面板 USB 端口的启用/禁用状态

响应

字节 1 - 完成代码

字节 2

此命令用于查询前面板 USB 端口的状态/配置,配置前面板 USB 端口的模式/超时以及在主机和 BMC 之间切换 USB 端口所有者

在配置中,前面板 USB 可以有 3 种模式 – 主机专用、BMC 独占或允许所有者在主机和 BMC 之间切换的共享模式。

如果启用了共享模式,则关闭服务器电源时,USB 端口将连接到 BMC;打开服务器电源时,USB 端口将连接到服务器。

启用共享模式并打开服务器电源后,如果发生了配置中的空闲超时,BMC 会将 USB 端口返回给服务器。

如果服务器具有标识按钮,则用户可以通过长按标识按钮 3 秒钟以上来启用/禁用标识按钮以切换前面板 USB 端口的所有者。

在关闭再打开电源期间自动切换端口时,会设置以秒为单位的滞后。此为可选参数。

SD530 服务器

在 SD530 平台上,该端口是可选的,并且如果存在,则直接连接到 XCC,并且仅连接到 XCC。无法将端口切换到主机。

  • 当发出的命令中字节 1 = 1 时,XCC 始终响应该端口由 BMC 所有。

  • 当发出的命令中字节 1 = 2 时,XCC 始终响应该端口由 BMC 专用。

  • 当发出的命令中字节 1 = 3 或字节 1 = 4 时,XCC 响应完成代码 D6h。

非 SD530 服务器

在非 SD530 平台上,可以通过切换到“主机专用”模式来禁用 XCC 对前面板 USB 端口的使用。

当发出的命令中字节 1 = 5 或字节 1 = 6 时,XCC 响应完成代码 D6h。

0xC7

本机 NM IPMI 交换机

请求长度 = 0:

空请求数据

响应

字节 1

完成代码

字节 2

当前启用/禁用状态

请求长度 = 1:

字节 1

本机 NM IPMI 接口启用/禁用属性

00h – 禁用

01h – 启用

响应

字节 1

完成代码

此命令用于为本机 Intel IPMI 命令启用/禁用 XCC 的桥接功能。