Compartir a través de

interfaz de _DSM para la clase de función con respaldo de energía con dirección JEDEC (interfaz de función 1)

  • Artículo

En esta sección se describe la interfaz del método específico del dispositivo (_DSM) diseñada para asignarse al estándar JEDEC Byte Addressable Energy Backed Interface para minimizar la complejidad del BIOS. Proporciona una base común de las funciones del dispositivo de informes & funcionalidades, de modo que el software del sistema operativo pueda interactuar con varias implementaciones a través de los mismos mecanismos. Además, permite la compatibilidad con la funcionalidad específica del proveedor a través del acceso a los registros de I2C.

Las plataformas que se ajustan a la interfaz de _DSM para la clase de función con respaldo de energía direccionable byte (function backed Function Interface 1) pueden admitir una NVDIMM-N que implementa la especificación jedec Byte Addressable Energy Backed Interface (clase de función 0x01 e interfaz de función 0x01). Para obtener más información, consulta la especificación jedec byte addressable energy backed interface (document JESD245).

Definición de GUID

El GUID de la clase de función con respaldo de energía con dirección JEDEC _DSM interfaz es 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.

Funciones y campos obligatorios

Las funciones de _DSM definidas en esta sección deben implementarse en objetos de dispositivo de espacio de nombres ACPI NVDIMM. El término Obligatorio hace referencia a si la función debe devolver datos válidos o no.

En la tabla siguiente se especifican las funciones y los campos que son obligatorios, donde "ESP" significa "Directiva de origen de energía".

Índice de función Nombre de la función Obligatorio para Device-Managed ESP Obligatorio para Host-Managed ESP
0 Funciones implementadas por consultas (índice de función 0) Sí Sí
1 Obtener identificación nvDIMM-N (índice de función 1) Sí Sí
2 Obtener requisitos de operación de guardado (Índice de función 2) Sí Sí
3 Obtención de la identificación de la fuente de energía (Índice de función 3) Sí Sí
4 Obtener la última información de copia de seguridad (índice de función 4) Sí Sí
5 Obtener umbrales de NVM (Índice de función 5) Sí Sí
6 Establecer umbral de advertencia de porcentaje de duración de NVM (índice de función 6) Sí Sí
7 Obtener umbrales de fuente de energía (Índice de función 7) Sí No
8 Establecer umbral de advertencia de duración de la fuente de energía (índice de función 8) Sí No
9 Establecer umbral de advertencia de temperatura de fuente de energía (índice de función 9) Sí No
10 Obtener información de mantenimiento crítica (índice de función 10) Sí Sí
11 Obtener información de mantenimiento de NVDIMM-N (índice de función 11) Sí Sí
12 Obtener información de mantenimiento del origen de energía (índice de función 12) Sí No
13 Obtener estadísticas operativas (índice de función 13) Sí Sí
14 Obtener tamaño de página del registro del proveedor (Índice de función 14) Sí Sí
15 Página Obtener registro de proveedor (Índice de función 15) Sí Sí
16 Estado de inserción de errores de consulta (índice de función 16) Sí Sí
17 Error de inserción (índice de función 17) Sí Sí
18 Obtener errores insertados (índice de función 18) Sí Sí
19 Borrar imagen NVM (Índice de función 19) Sí Sí
20 Arm NVDIMM-N (Índice de función 20) Sí Sí
21 Restablecer valores predeterminados de fábrica (Índice de función 21) Sí Sí
22 Iniciar actualización de firmware (Índice de función 22) Sí Sí
23 Enviar datos de actualización de firmware (Índice de función 23) Sí Sí
24 Finalizar actualización de firmware (Índice de función 24) Sí Sí
25 Seleccionar ranura de imagen de firmware (Índice de función 25) Sí Sí
26 Obtener información de firmware (Índice de función 26) Sí Sí
27 Lectura de I2C (índice de función 27) Sí Sí
28 Escritura de I2C (índice de función 28) Sí Sí
29 Leer datos con tipo (índice de función 29) Sí Sí
30 Escribir datos con tipo (índice de función 30) Sí Sí
31 Establecer contadores de errores de memoria (índice de función 31) Sí Sí

entrada del método _DSM

Arg3 para todas las funciones es un valor package. Si la función no toma un argumento de entrada, el valor package no contiene datos. Si la función toma un argumento de entrada, el valor package contiene un búfer.

Si la función no toma un argumento de entrada y Arg3 no es un paquete vacío, la función devolverá el código de estado general de los parámetros de entrada no válidos.

Salida del método _DSM

Todos los métodos devolverán un búfer de longitud mayor o igual que 4 bytes. Los primeros 4 bytes del búfer de devolución se estructuran de la siguiente manera:

Campo Longitud de bytes Desplazamiento de bytes Descripción
Código de estado general 2 0 Código de estado general. Consulte a continuación los valores posibles.
Function-Specific código de error 1 2 Código de error específico de la función a la que se llamó. Este campo solo contiene información válida si el código de estado general es igual al código de error específico de la función.
Código de error específico del proveedor 1 3 Códigos de estado específicos del proveedor. Este campo solo contiene información válida si el código de estado general es igual al código de error específico del proveedor.

A continuación se muestran los valores posibles para el código de estado general.

Valor Significado
0 Correcto
1 No compatible
2 Parámetros de entrada no válidos
3 Error de comunicación I2C
4 Function-Specific código de error
5 Código de error específico del proveedor
6 0xFFFF: reservado

Cualquier código de estado general distinto de cero indica que se produjo un error en la función. Ninguna función definida en esta versión de la especificación devolverá el código de estado general no admitido. Todas las funciones obligatorias devolverán datos válidos o un código de error que indique un error en tiempo de ejecución. Las funciones no obligatorias pueden devolver un código de error de Function-Specific para indicar que no hay datos válidos que se van a devolver.

Todos los bits y bytes reservados tendrán un valor de 0. A menos que se indique lo contrario, todos los campos de varios bytes se representarán de forma little-endian.

Nota

Una referencia a un registro de interfaz Energy-Backed direccionable byte describe muchos campos devueltos para las funciones especificadas en esta interfaz. Estos campos serán idénticos al registro definido en la revisión "Byte Addressable Energy Backed Interface, versión 1.0, JEDEC Standard No. 2233-22" de la especificación Byte-Addressable Energy-Backed Interface. La versión de especificación se notifica en el campo Revisión de especificación devuelto por la función Get NVDIMM-N Identification (Function Index 1).

Algunos campos devueltos hacen referencia a información sobre la fuente de energía (ES). Cuando la directiva es administrada por el dispositivo, la plataforma leerá el registro de hardware especificado en la descripción del campo para recuperar toda la información relacionada con ES. Cuando la directiva es administrada por el host, la plataforma obtendrá la información relacionada con la ES a través de mecanismos específicos de la plataforma. En este caso, toda la información relacionada con ES se presentará en el mismo diseño binario que el registro de hardware especificado en la descripción del campo.