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".

Indice della funzione	Nome funzione	Obbligatorio per Device-Managed ESP	Obbligatorio per Host-Managed ESP
0	Funzioni implementate da query (indice funzione 0)	Sì	Sì
1	Ottenere l'identificazione NVDIMM-N (indice della funzione 1)	Sì	Sì
2	Ottenere i requisiti dell'operazione di salvataggio (indice funzione 2)	Sì	Sì
3	Ottenere l'identificazione della fonte di energia (indice funzione 3)	Sì	Sì
4	Ottenere le informazioni sull'ultimo backup (indice funzione 4)	Sì	Sì
5	Ottenere soglie NVM (indice funzione 5)	Sì	Sì
6	Impostare la soglia di avviso percentuale durata NVM (indice funzione 6)	Sì	Sì
7	Get Energy Source Thresholds (Function Index 7)	Sì	No
8	Imposta soglia di avviso per la durata dell'origine dell'energia (indice funzione 8)	Sì	No
9	Impostare soglia di avviso relativo alla temperatura della fonte di energia (indice funzione 9)	Sì	No
10	Ottenere informazioni di integrità critiche (indice funzione 10)	Sì	Sì
11	Ottenere informazioni sull'integrità NVDIMM-N (indice funzione 11)	Sì	Sì
12	Ottenere informazioni sull'integrità della fonte di energia (indice funzione 12)	Sì	No
13	Ottenere statistiche operative (indice funzione 13)	Sì	Sì
14	Get Vendor Log Page Size (Function Index 14)	Sì	Sì
15	Pagina Get Vendor Log (Indice funzione 15)	Sì	Sì
16	Stato di inserimento degli errori di query (indice della funzione 16)	Sì	Sì
17	Errore di inserimento (indice funzione 17)	Sì	Sì
18	Errori get inseriti (indice funzione 18)	Sì	Sì
19	Cancella immagine NVM (indice funzione 19)	Sì	Sì
20	Arm NVDIMM-N (indice funzione 20)	Sì	Sì
21	Ripristina impostazioni predefinite delle impostazioni predefinite (indice della funzione 21)	Sì	Sì
22	Avviare l'aggiornamento del firmware (indice funzione 22)	Sì	Sì
23	Send Firmware Update Data (Function Index 23)	Sì	Sì
24	Fine aggiornamento firmware (indice funzione 24)	Sì	Sì
25	Selezionare slot immagine firmware (indice funzione 25)	Sì	Sì
26	Ottenere informazioni sul firmware (indice funzione 26)	Sì	Sì
27	Lettura I2C (indice funzione 27)	Sì	Sì
28	Scrittura I2C (indice funzione 28)	Sì	Sì
29	Read Typed Data (Function Index 29)	Sì	Sì
30	Scrivere dati tipiti (indice funzione 30)	Sì	Sì
31	Impostare i contatori degli errori di memoria (indice funzione 31)	Sì	Sì

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.