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」 代表「能源來源原則」。
_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 相關信息都應該以與欄位描述中指定的硬體快取器相同的二進位配置來呈現。