interfaccia _DSM per JEDEC Byte Addressable Energy Backed Function Class (Interfaccia funzione 1)
Questa sezione descrive l'interfaccia Device-Specific Method (_DSM) progettata per eseguire il mapping allo standard JEDEC Byte Addressable Energy Backed Interface per ridurre al minimo la complessità del BIOS. Fornisce una base comune per la creazione di report sulle funzioni del dispositivo & funzionalità, in modo che il software del sistema operativo possa interagire con varie implementazioni tramite gli stessi meccanismi. Inoltre, consente il supporto per funzionalità specifiche del fornitore tramite l'accesso ai registri I2C.
Le piattaforme conformi all'interfaccia _DSM per la classe di funzione basata su energia indirizzabile byte (Function Interface 1) possono supportare un NVDIMM-N che implementa la specifica JEDEC Byte Addressable Energy Backed Interface (classe di funzione 0x01 e interfaccia di funzione 0x01). Per altre info, vedi la specifica JEDEC Byte Addressable Energy Backed Interface (documento JESD245).
Definizione GUID
Il GUID per la classe di funzione JEDEC Byte Addressable Energy Backed _DSM interfaccia è 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.
Funzioni e campi obbligatori
Le funzioni _DSM definite in questa sezione devono essere implementate negli oggetti dispositivo dello spazio dei nomi ACPI NVDIMM. Il termine Obbligatorio indica se la funzione deve restituire o meno dati validi.
La tabella seguente specifica le funzioni e i campi obbligatori, dove "ESP" è l'acronimo di "Energy Source Policy".
Input del metodo _DSM
Arg3 a tutte le funzioni è un valore package. Se la funzione non accetta un argomento di input, il valore package non contiene dati. Se la funzione accetta un argomento di input, il valore package contiene un buffer.
Se la funzione non accetta un argomento di input e Arg3 non è un pacchetto vuoto, la funzione restituirà il codice di stato generale dei parametri di input non validi.
Output del metodo _DSM
Tutti i metodi restituiscono un buffer di lunghezza maggiore o uguale a 4 byte. I primi 4 byte del buffer restituito sono strutturati nel modo seguente:
| Campo | Lunghezza byte | Offset di byte | Descrizione |
|---|---|---|---|
| Codice di stato generale | 2 | 0 | Codice di stato generale. Di seguito sono riportati i valori possibili. |
| Function-Specific codice di errore | 1 | 2 | Codice di errore specifico della funzione chiamata. Questo campo contiene solo informazioni valide se il codice di stato generale è uguale al codice di errore specifico della funzione. |
| Codice di errore specifico del fornitore | 1 | 3 | Codici di stato specifici del fornitore. Questo campo contiene solo informazioni valide se il codice di stato generale è uguale al codice di errore specifico del fornitore. |
Di seguito sono riportati i valori possibili per il codice di stato generale.
| Valore | Significato |
|---|---|
| 0 | Operazione riuscita |
| 1 | Non supportato |
| 2 | Parametri di input non validi |
| 3 | Errore di comunicazione I2C |
| 4 | Function-Specific codice di errore |
| 5 | Codice di errore specifico del fornitore |
| 6 | 0xFFFF - Riservato |
Qualsiasi codice di stato generale diverso da zero indica che la funzione non è riuscita. Nessuna funzione definita in questa versione della specifica restituirà il codice di stato generale non supportato. Tutte le funzioni obbligatorie restituiscono dati validi o un codice di errore che indica un errore di runtime. Le funzioni non obbligatorie possono restituire un codice di errore Function-Specific per segnalare che non sono presenti dati validi da restituire.
Tutti i bit e i byte riservati devono avere un valore pari a 0. Se non specificato diversamente, tutti i campi multi-byte devono essere rappresentati in modo little-endian.
Nota
Un riferimento a un registro di interfaccia Energy-Backed indirizzabile byte descrive molti campi restituiti per le funzioni specificate in questa interfaccia. Questi campi devono essere identici al registro definito nella revisione "Byte Addressable Energy Backed Interface, versione 1.0, JEDEC Standard No. 2233-22" della specifica dell'interfaccia Byte-Addressable Energy-Backed. La versione della specifica viene segnalata nel campo Revisione specifica restituita dalla funzione Get NVDIMM-N Identification (Indice funzione 1).
Alcuni campi restituiti fanno riferimento a informazioni sulla fonte di energia (ES). Quando il criterio ES è gestito dal dispositivo, la piattaforma leggerà il registro hardware specificato nella descrizione del campo per recuperare tutte le informazioni correlate a ES. Quando il criterio ES è gestito dall'host, la piattaforma ottiene le informazioni correlate a ES tramite meccanismi specifici della piattaforma. In questo caso, tutte le informazioni relative a ES verranno presentate nello stesso layout binario del registro hardware specificato nella descrizione del campo.