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-64:位元組 1
完成碼
位元組 2 至 65
目前主機名稱。
ASCIIZ,以空值結尾的字串。
位元組 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:位元組 1
完成碼
位元組 2
目前啟用/停用狀態
回應:位元組 1
原生 NM IPMI 介面啟用/停用屬性
00h – 停用
01h – 啟用
位元組 1
完成碼
此指令用於啟用/停用 XCC 對原生 Intel IPMI 指令的橋接功能。