跳至主要内容

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 – 系統 ID

位元組 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 – 延遲選項(僅限「查詢」要求)

如果機箱電源還原原則設為在 AC 電源接通/恢復供電後始終開啟電源或恢復為開啟電源(若原先已開啟電源),將使用此設定。共有 2 種選擇:已停用(預設值,開啟電源時無延遲)和隨機。隨機延遲設定將自 AC 電源接通/恢復供電以及伺服器自動開啟電源之時起隨機提供 1 至 15 秒不等的延遲。

此指令僅限機架式伺服器上的 XCC 才有支援。

0x38

NMI 與重設

要求

位元組 1 – 秒數
  • 0 = 僅限 NMI

位元組 2 – 重設類型
  • 0 = 正常重設
  • 1 = 關閉再開啟電源

回應

位元組 1 – 完成碼

此指令用於執行系統 NMI。或者,在 NMI 後可將系統重設(重新開機)或關閉再開啟電源。

若「秒數」欄位非 0,系統將在指定的秒數過後重設或關閉再開啟電源。

要求的位元組 2 為選用。如果未提供位元組 2,或者其值為 0x00,則將執行正常重設。如果位元組 2 為 0x01,系統將關閉再開啟電源。

其他指令

本節提供不屬於任何其他各節內容的指令。

網路功能 = 0x3A
代碼指令要求、回應資料說明

0x55

取得/設定主機名稱

要求長度 = 0

要求資料為空

回應

位元組 1

完成碼

位元組 2 至 65

目前主機名稱。

ASCIIZ,以 Null 結尾的字串。

要求長度 1-64

位元組 1 至 64

DHCP 主機名稱

ASCIIZ 以 00h 結尾

使用此指令可取得/設定主機名稱。

設定主機名稱時,所需的值必須以 00h 結尾。主機名稱的字元數限制為 63 個(包括空值在內)。

0x98

前方面板 USB 埠控制

要求

位元組 1

01h:

取得前方面板 USB 埠的現行擁有者

回應

位元組 1 – 完成碼

位元組 2

00h:

主機所擁有

01h:

BMC 所擁有

要求

位元組 1

02h:

取得前方面板 USB 埠的配置

回應

位元組 1 – 完成碼

位元組 2

00h:

主機專用

01h:

BMC 專用

02h:

共用模式

位元組 3:4 – 以分鐘為單位的閒置逾時(MSB 在前)

位元組 5 – 啟用 ID 按鈕

00h:

已停用

01h:

已啟用

位元組 6 – 遲滯(選用)秒數

要求

位元組 1

03h:設定前方面板 USB 埠的配置

位元組 2

00h:

主機專用

01h:

BMC 專用

02h:

共用模式

位元組 3:4 – 以分鐘為單位的閒置逾時(MSB 在前)

位元組 5 – 啟用 ID 按鈕

00h:

已停用

01h:

已啟用

位元組 6 – 遲滯(選用)秒數

回應

位元組 1 – 完成碼,位元組 2

00h:

切換至主機

01h:

切換至 BMC

回應

位元組 1 – 完成碼

位元組 1

05h:

啟用/停用前方面板 USB 埠

位元組 2

00h:

停用

01h:

啟用

回應

位元組 1 – 完成碼

要求

位元組 1

06h:

讀取前方面板 USB 埠的啟用/停用狀態

回應

位元組 1 - 完成碼

位元組 2

此指令用於查詢前方面板 USB 埠的狀態/配置、配置前方面板 USB 埠的模式/逾時,以及將 USB 埠的擁有者切換至主機或 BMC

在配置中,前方面板 USB 可分為 3 種模式 – 主機專用、BMC 獨佔或允許切換擁有者至主機或 BMC 的共用模式。

如果啟用了共用模式,USB 埠將於伺服器電源關閉時連接到 BMC,並於伺服器電源開啟時連接到伺服器。

啟用共用模式並已開啟伺服器電源後,若發生了配置的閒置逾時,BMC 會將 USB 埠交還給伺服器。

如果伺服器具有識別按鈕,使用者可以啟用/停用 ID 按鈕,透過按住 ID 按鈕 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

完成碼

此指令用於啟用/停用 XCC 對原生 Intel IPMI 指令的橋接功能。