跳至主要内容

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 配置設定重設為預設值。

主機板/韌體資訊指令

本節列出用於查詢主機板和韌體資訊的指令。

網路功能 = 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 增加了其他控制功能。

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

0x1E

機箱電源還原延遲選項

要求:

位元組 1

要求類型︰

0x00 = 設定延遲選項

0x01 = 查詢延遲選項

位元組 2

(如果位元組 1 = 0x00)

0x00 = 已停用(預設)

0x01 = 隨機

0x02 - 0xFF 保留

回應

位元組 1 – 完成碼

位元組 2

00h:

切換至主機

01h:

切換至 BMC

回應

位元組 1 – 完成碼

位元組 2 – 延遲選項(僅限「查詢」要求)

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

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

其他指令

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

網路功能 = 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 個(包括空值在內)。

0x98

前方面板 USB 埠控制

要求

位元組 1

01h:

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

回應

位元組 1 – 完成碼

位元組 2

00h:

主機所擁有

01h:

BMC 所擁有

要求

位元組 1

04h:

如果前面板 USB 埠處於共用模式,請手動設定其擁有者

位元組 2

00h:

切換至主機

01h:

切換至 BMC

回應

位元組 1 – 完成碼

此指令用於查詢 FP USB 埠的擁有者,以及在主機和 BMC 之間切換 USB 埠擁有者。