интерфейс _DSM для класса функции JEDEC Byte Addressable Energy BackedEd (Function Interface 1)
В этом разделе описывается интерфейс метода для конкретного устройства (_DSM ), предназначенный для сопоставления со стандартом JEDEC Byte Addressable Energy Backed Interface, чтобы свести к минимуму сложность BIOS. Он предоставляет общую основу для создания отчетов о функциях устройств & возможностей, чтобы программное обеспечение ОС ранее взаимодействовать с различными реализациями с помощью одних и того же механизма. Кроме того, это позволяет поддерживать функциональные возможности конкретных поставщиков через доступ к регистрам I2C.
Платформы, соответствующие интерфейсу _DSM для класса функций с поддержкой байтовой адресуемой энергии (интерфейс функции 1), могут поддерживать NVDIMM-N, реализующий спецификацию интерфейса JEDEC Byte Addressable Energy Backed Interface (класс функции 0x01 и функциональный интерфейс 0x01). Дополнительные сведения см. в спецификации интерфейса JEDEC Byte Addressable Energy Backed Interface (документ JESD245).
Определение GUID
Идентификатор GUID для класса функции JEDEC Byte Addressable Energy Backed, _DSM интерфейс: 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.
Обязательные функции и поля
Функции _DSM, определенные в этом разделе, должны быть реализованы в объектах устройств пространства имен ACPI NVDIMM. Термин Обязательный указывает, должна ли функция возвращать допустимые данные.
В следующей таблице указаны функции и поля, которые являются обязательными, где "ESP" означает "Политика источников энергии".
Входные данные метода _DSM
Arg3 для всех функций — это значение пакета. Если функция не принимает входной аргумент, значение Package не содержит данных. Если функция принимает входной аргумент, значение Package содержит буфер.
Если функция не принимает входной аргумент и Arg3 не является пустым пакетом, функция должна вернуть общий код состояния недопустимых входных параметров.
Выходные данные метода _DSM
Все методы возвращают буфер длиной больше или равной 4 байтам. Первые 4 байта возвращаемого буфера структурированы следующим образом:
| Поле | Длина байтов | Смещение в байтах | Описание |
|---|---|---|---|
| Общий код состояния | 2 | 0 | Общий код состояния. Возможные значения приводятся ниже. |
| Код ошибки Function-Specific | 1 | 2 | Код ошибки, относящееся к вызываемой функции. Это поле содержит допустимые сведения, только если общий код состояния равен коду ошибки для конкретной функции. |
| Код ошибки конкретного поставщика | 1 | 3 | Коды состояния для конкретных поставщиков. Это поле содержит допустимые сведения, только если общий код состояния равен коду ошибки конкретного поставщика. |
Ниже приведены возможные значения для общего кода состояния.
| Значение | Значение |
|---|---|
| 0 | Успешное завершение |
| 1 | Не поддерживается |
| 2 | Недопустимые входные параметры |
| 3 | Ошибка связи I2C |
| 4 | Код ошибки Function-Specific |
| 5 | Код ошибки конкретного поставщика |
| 6 | 0xFFFF — зарезервировано |
Любой ненулевой общий код состояния указывает на сбой функции. Никакая функция, определенная в этой версии спецификации, не должна возвращать общий код состоянияНе поддерживается. Все обязательные функции должны возвращать допустимые данные или код ошибки, указывающий на ошибку среды выполнения. Необязательная функция может возвращать Function-Specific код ошибки, указывающий на отсутствие допустимых данных.
Все зарезервированные биты и байты должны иметь значение 0. Если не указано иное, все многобайтовые поля должны быть представлены в малобайтовом формате.
Примечание
Ссылка на регистр интерфейса Energy-Backed с адресной Energy-Backed байтами описывает множество возвращаемых полей для функций, указанных в этом интерфейсе. Эти поля должны быть идентичны регистру, определенному в редакции "Byte Addressable Energy Backed Interface, версия 1.0, стандарт JEDEC No 2233-22" спецификации интерфейса Byte-Addressable Energy-Backed. Версия спецификации указывается в поле Редакция спецификации, возвращаемом функцией Get NVDIMM-N Identification (Function Index 1).
Некоторые поля возврата ссылаются на сведения об источнике энергии (ES). Если политика ES управляется устройством, платформа должна считывать регистр оборудования, указанный в описании поля, чтобы получить всю информацию, связанную с ES. Когда политика ES управляется узлом, платформа должна получать сведения, связанные с ES, с помощью механизмов, зависящих от платформы. В этом случае вся информация, связанная с ES, должна быть представлена в том же двоичном макете, что и регистр оборудования, указанный в описании поля.