跳到主要内容

OEM IPMI 命令

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

代码Netfn 0x2E 命令权限

0xCC

将 XCC 重置为默认设置

PRIV_USR

代码Netfn 0x3A 命令权限

0x00

查询固件版本

PRIV_USR

0x1E

机箱电源恢复延迟选项

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

将 XCC 重置为默认设置命令

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

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

将 XCC 重置为默认设置

请求:

字节 1 – 0x66

字节 2 – 0x4A

字节 3 – 0x00

响应:

字节 1 – 完成代码

字节 2 – 0x66

字节 3 – 0x4A

字节 4 – 0x00

字节 5 – 0x0A

字节 6 – 0x01

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

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

板/固件信息命令

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

Net 函数 = 0x3A
代码命令请求、响应数据描述

0x00

查询固件版本

请求

无请求的数据

响应

字节 1 – 完成代码

字节 2 – 主要版本

字节 3 – 次要版本

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

(主要.次要.修订)

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 设备类型1

FPGA 设备类型

0 = 本地(活动级别)

1 = CPU 卡 1(活动级别)

响应

字节 1 – 完成代码

字节 2 – 主要修订级别

字节 3 – 次要修订级别

字节 4 – 次要子修订级别

(XCC 平台上的测试字节)

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

  1. 如果省略字节 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 增加了其他控制功能。

Net 函数 = 0x3A
代码命令请求、响应数据描述

0x1E

机箱电源恢复延迟选项

请求:

字节 1

请求类型:

0x00 = 设置延迟选项

0x01 = 查询延迟选项

字节 2

(如果字节 1= 0x00)

0x00 = 已禁用(默认)

0x01 = 随机

0x02 - 0xFF 已保留

响应

字节 1 – 完成代码

字节 2

00h:

切换到主机

01h:

切换到 BMC

响应

字节 1 – 完成代码

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

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

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

其他命令

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

Net 函数 = 0x3A
代码命令请求、响应数据描述

0x49

发起服务日志收集

请求:

字节 1 – 服务日志类型

请求类型:

01h = 服务调试日志(FFDC)

02h = 数据日志(微型日志)

字节 2 – 标志(可选)1

对于类型 02:

0000 0001b – 包括“网络”类别。

0000 0010b – 包括“审核”类别。

0000 0100b – 包括“遥测”类别。

0000 1000b – 包括“最近一次故障截屏”类别。

响应

字节 1

完成代码

01h = 转储正在进行

CCh = 数据收集类型不支持

字节 2

FFDC 转储超时值2(按分钟计)

此命令可用于在系统上发起服务日志收集。

  1. 标记字节是可选的。如果未指定,则服务日志类型将不包括这些类别。

  2. 超时值(以分钟为单位)会提供给请求方,以指定 FFDC 包文件生成完成的最长等待时间。

0x4D

服务日志收集状态

请求:

字节 1 – 数据收集类型

请求类型:

01h = 调试日志(FFDC)

02h = 服务数据日志(微型日志)

响应1

字节 1

完成代码

字节 2

收集状态:

00h – 无数据,无正在进行的收集

01h – 数据就绪,可供收集

02h – 收集正在进行

字节 3(可选)

完成百分比2

此命令可用于报告系统上的数据(转储)收集状态。

  1. 响应的长度可能是 2 个字节,也可能是 3 个字节。如果无法报告完成百分比,则响应将仅包含字节 1 和字节 2。如果能够报告完成百分比,则响应还将包含字节 3。

  2. 完成百分比(可选)。这是收集活动进度的近似值,介于 0 到 100 之间。

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

04h:

如果前面板 USB 端口处于共享模式,则手动设置其所有者

字节 2

00h:

切换到主机

01h:

切换到 BMC

响应

字节 1 – 完成代码

此命令用于查询 FP USB 端口的所有者,并在主机和 BMC 之间切换 USB 端口所有者。