JEDEC 位元組可尋址能源支援函式類別的 _DSM 介面 (函式介面 1)

本節描述 裝置特定方法 (_DSM) 介面,其設計目的是要對應到 JEDEC 位元組可尋址的能源支援介面標準,以將 BIOS 複雜度降到最低。 它提供報告裝置功能 & 功能的常見基礎,讓OS軟體可以透過相同的機制與各種實作互動。 此外,它允許透過存取I2C緩存器來支持廠商特定的功能。

符合位元組可尋址能源支援函式類別_DSM介面的平臺 (函式介面 1) 可以支援 NVDIMM-N,該 NVDIMM-N 可實作 JEDEC 位元組可尋址的能源支援介面 規格 (函式類別0x01和函式介面0x01) 。 如需詳細資訊,請參閱 JEDEC 位元組可尋址能源支援的介面規格 (檔JESD245) 。

GUID 定義

JEDEC 位元組可設定址能源支援的函式類別的 GUID _DSM 介面為 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05。

必要函式和欄位

本節中定義的_DSM函式應該在 NVDIMM ACPI 命名空間裝置物件中實作。 強制一詞是指函 式 是否必須傳回有效的數據。

下表指定必要函式和字段,其中 「ESP」 代表「能源來源原則」。

函式索引 函數名稱 Device-Managed ESP 的必要專案 Host-Managed ESP 的必要專案
0 查詢實作的函式 (函式索引 0) Yes 是
1 取得 NVDIMM-N 識別 (函式索引 1) Yes Yes
2 取得儲存作業需求 (函式索引 2) Yes Yes
3 取得能源來源識別 (函式索引 3) Yes Yes
4 取得上次備份資訊 (函式索引 4) Yes Yes
5 取得 NVM 閾值 (函式索引 5) Yes Yes
6 設定 NVM 存留期百分比警告閾值 (函式索引 6) Yes Yes
7 取得能源來源閾值 (函式索引 7) 是 No
8 設定能源來源存留期警告臨界值 (函式索引 8) 是 No
9 設定能源來源溫度警告臨界值 (函式索引 9) 是 No
10 取得重大健康情況資訊 (函式索引 10) Yes 是
11 取得 NVDIMM-N 健全狀況資訊 (函式索引 11) Yes 是
12 取得能源來源健康情況資訊 (函式索引 12) 是 No
13 取得作業統計數據 (函式索引 13) Yes 是
14 取得廠商記錄頁面大小 (函式索引 14) Yes 是
15 取得廠商記錄頁面 (函式索引 15) Yes 是
16 查詢錯誤插入狀態 (函式索引 16) Yes 是
17 插入錯誤 (函式索引 17) Yes Yes
18 (函式索引 18) 取得插入的錯誤 Yes Yes
19 清除 NVM 影像 (函式索引 19) Yes Yes
20 Arm NVDIMM-N (函式索引 20) Yes Yes
21 重設為 Factory 預設值 (函式索引 21) Yes 是
22 啟動韌體更新 (函式索引 22) Yes Yes
23 傳送韌體更新數據 (函式索引 23) Yes Yes
24 完成韌體更新 (函式索引 24) Yes Yes
25 選取 [韌體映射位置] (函式索引 25) Yes Yes
26 取得韌體資訊 (函式索引 26) Yes 是
27 I2C 讀取 (函式索引 27) Yes Yes
28 I2C 寫入 (函式索引 28) Yes Yes
29 讀取具類型的數據 (函數索引 29) Yes 是
30 寫入具型別數據 (函式索引 30) Yes Yes
31 設定記憶體錯誤計數器 (函式索引 31) Yes Yes

_DSM方法輸入

所有函式的 Arg3 都是 Package 值。 如果函式不採用輸入自變數,則 Package 值不會包含任何數據。 如果函式接受輸入自變數,則 Package 值會包含緩衝區。

如果函式不採用輸入自變數, 而 Arg3 不是空的 Package,則函式應該會傳回無效輸入參數的 一般狀態代碼 。

_DSM方法輸出

所有方法都會傳回長度大於或等於 4 個字節的緩衝區。 傳回緩衝區的前 4 個字節結構化如下:

欄位 位元組長度 位元組位移 Description
一般狀態代碼 2 0 一般狀態代碼。 請參閱底下,取得可能的值。
Function-Specific 錯誤碼 1 2 呼叫之函式特有的錯誤碼。 如果 一般狀態代碼 等於 函式特定錯誤碼,此欄位只會包含有效的資訊。
廠商特定的錯誤碼 1 3 廠商特定的狀態代碼。 如果 [一般狀態代碼 ] 等於 [廠商特定錯誤碼],則此字段只會包含有效的資訊。

以下是一 般狀態代碼的可能值。

值 意義
0 Success

1 不支援

2 無效的輸入參數

3 I2C 通訊錯誤

4 Function-Specific 錯誤碼

5 廠商特定的錯誤碼

6 0xFFFF – 保留

任何非零 的一般狀態代碼 都表示函式失敗。 此規格版本中未定義任何函式,應傳回不支援的一般狀態代碼。 所有必要函式都應該傳回有效的數據或錯誤碼,指出運行時錯誤。 非強制函式可能會傳回 Function-Specific 錯誤碼,以表示沒有傳回有效的數據。

所有保留的位和位元組的值都應該為 0。 除非另有說明,否則所有多位元組位元段都應該以小到大的方式表示。

注意

Byte 可尋址 Energy-Backed 介面緩存器參考描述此介面中所指定函式的許多傳回字段。 這些欄位應與 Byte-Addressable Energy-Backed 介面規格的「位元組可尋址能源支援介面 1.0 版 JEDEC 標準編號 2233-22」修訂中所定義的緩存器相同。 規格版本會在 Get NVDIMM-N Identification (Function Index 1) 函式所傳回的 [規格修訂] 欄位中回報。

某些傳回欄位指的是能源來源 (ES) 的相關信息。 當 ES 原則受裝置管理時,平臺應該讀取欄位描述中指定的硬體快取器,以擷取所有 ES 相關信息。 當 ES 原則受到主機管理時,平臺應該透過平臺特定機制取得 ES 相關信息。 在此情況下,所有 ES 相關信息都應該以與欄位描述中指定的硬體快取器相同的二進位配置來呈現。