antarmuka _DSM untuk JEDEC Byte Byte Addressable Energy Backed Function Class (Antarmuka Fungsi 1)

Bagian ini menjelaskan antarmuka Metode Khusus Perangkat (_DSM) yang dirancang untuk memetakan ke standar Antarmuka Yang Didukung Energi Yang Dapat Diatasi Byte JEDEC untuk meminimalkan kompleksitas BIOS. Ini memberikan dasar umum fungsi perangkat pelaporan & kemampuan, sehingga perangkat lunak OS dapat berinteraksi dengan berbagai implementasi melalui mekanisme yang sama. Selanjutnya, ini memungkinkan dukungan untuk fungsionalitas khusus vendor melalui akses ke register I2C.

Platform yang sesuai dengan antarmuka _DSM untuk Byte Addressable Energy Backed Function Class (Antarmuka Fungsi 1) dapat mendukung NVDIMM-N yang mengimplementasikan spesifikasi ANTARMUKA yang Didukung Energi Yang Dapat Diatasi Byte JEDEC (kelas fungsi 0x01 dan antarmuka fungsi 0x01). Untuk informasi selengkapnya, lihat spesifikasi JEDEC Byte Addressable Energy Backed Interface (dokumen JESD245).

Definisi GUID

GUID untuk antarmuka _DSM Kelas Fungsi yang Didukung Energi yang Dapat Diatasi Byte JEDEC adalah 1EE68B36-D4BD-4a1a-9A16-4F8E53D46E05.

Fungsi dan bidang wajib

Fungsi _DSM yang ditentukan di bagian ini harus diimplementasikan dalam objek perangkat Namespace NVDIMM ACPI. Istilah Wajib mengacu pada apakah fungsi harus mengembalikan data yang valid atau tidak.

Tabel berikut menentukan fungsi dan bidang yang wajib, di mana "ESP" adalah singkatan dari "Kebijakan Sumber Energi".

Indeks Fungsi	Nama Fungsi	Wajib untuk Device-Managed ESP	Wajib untuk Host-Managed ESP
0	Fungsi yang Diimplementasikan Kueri (Indeks Fungsi 0)	Ya	Ya
1	Dapatkan Identifikasi NVDIMM-N (Indeks Fungsi 1)	Ya	Ya
2	Dapatkan Persyaratan Operasi Penyimpanan (Indeks Fungsi 2)	Ya	Ya
3	Dapatkan Identifikasi Sumber Energi (Indeks Fungsi 3)	Ya	Ya
4	Dapatkan Informasi Pencadangan Terakhir (Indeks Fungsi 4)	Ya	Ya
5	Mendapatkan Ambang NVM (Indeks Fungsi 5)	Ya	Ya
6	Atur Ambang Batas Peringatan Persentase Masa Pakai NVM (Indeks Fungsi 6)	Ya	Ya
7	Dapatkan Ambang Sumber Energi (Indeks Fungsi 7)	Ya	Tidak
8	Atur Ambang Batas Peringatan Seumur Hidup Sumber Energi (Indeks Fungsi 8)	Ya	Tidak
9	Atur Ambang Batas Peringatan Suhu Sumber Energi (Indeks Fungsi 9)	Ya	Tidak
10	Dapatkan Info Kesehatan Kritis (Indeks Fungsi 10)	Ya	Ya
11	Dapatkan Info Kesehatan NVDIMM-N (Indeks Fungsi 11)	Ya	Ya
12	Dapatkan Info Kesehatan Sumber Energi (Indeks Fungsi 12)	Ya	Tidak
13	Dapatkan Statistik Operasional (Indeks Fungsi 13)	Ya	Ya
14	Dapatkan Ukuran Halaman Log Vendor (Indeks Fungsi 14)	Ya	Ya
15	Dapatkan Halaman Log Vendor (Indeks Fungsi 15)	Ya	Ya
16	Status Injeksi Kesalahan Kueri (Indeks Fungsi 16)	Ya	Ya
17	Kesalahan Injeksi (Indeks Fungsi 17)	Ya	Ya
18	Dapatkan Kesalahan yang Disuntikkan (Indeks Fungsi 18)	Ya	Ya
19	Menghapus Gambar NVM (Indeks Fungsi 19)	Ya	Ya
20	Arm NVDIMM-N (Indeks Fungsi 20)	Ya	Ya
21	Reset ke Default Pabrik (Indeks Fungsi 21)	Ya	Ya
22	Mulai Pembaruan Firmware (Indeks Fungsi 22)	Ya	Ya
23	Mengirim Data Pembaruan Firmware (Indeks Fungsi 23)	Ya	Ya
24	Selesaikan Pembaruan Firmware (Indeks Fungsi 24)	Ya	Ya
25	Pilih Slot Gambar Firmware (Indeks Fungsi 25)	Ya	Ya
26	Dapatkan Info Firmware (Indeks Fungsi 26)	Ya	Ya
27	Baca I2C (Indeks Fungsi 27)	Ya	Ya
28	I2C Write (Indeks Fungsi 28)	Ya	Ya
29	Membaca Data Bertipe (Indeks Fungsi 29)	Ya	Ya
30	Tulis Data Yang Dititik (Indeks Fungsi 30)	Ya	Ya
31	Mengatur Penghitung Kesalahan Memori (Indeks Fungsi 31)	Ya	Ya

Input Metode _DSM

Arg3 ke semua fungsi adalah nilai Paket. Jika fungsi tidak mengambil argumen input, nilai Paket tidak berisi data. Jika fungsi mengambil argumen input, nilai Paket berisi buffer.

Jika fungsi tidak mengambil argumen input dan Arg3 bukan Paket kosong, fungsi akan mengembalikan Kode Status Umum Parameter Input Tidak Valid.

Output Metode _DSM

Semua metode akan mengembalikan buffer panjang yang lebih besar dari atau sama dengan 4 byte. 4 byte pertama dari buffer pengembalian disusun sebagai berikut:

Bidang	Panjang byte	Offset byte	Deskripsi
Kode Status Umum	2	0	Kode status umum. Lihat di bawah untuk kemungkinan nilai.
Kode Kesalahan Function-Specific	1	2	Kode kesalahan yang khusus untuk fungsi yang dipanggil. Bidang ini hanya berisi informasi yang valid jika Kode Status Umum sama dengan Kode Kesalahan Khusus Fungsi.
Kode Kesalahan Khusus Vendor	1	3	Kode status khusus vendor. Bidang ini hanya berisi informasi yang valid jika Kode Status Umum sama dengan Kode Kesalahan Khusus Vendor.

Berikut ini adalah nilai yang mungkin untuk Kode Status Umum.

Nilai	Makna
0	Berhasil
1	Tidak Didukung
2	Parameter Input Tidak Valid
3	Kesalahan Komunikasi I2C
4	Kode Kesalahan Function-Specific
5	Kode Kesalahan Khusus Vendor
6	0xFFFF – Dicadangkan

Kode Status Umum non-nol menunjukkan bahwa fungsi gagal. Tidak ada fungsi yang ditentukan dalam versi spesifikasi ini yang akan mengembalikan Kode Status UmumTidak Didukung. Semua fungsi wajib harus mengembalikan data yang valid atau kode kesalahan yang menunjukkan kesalahan runtime. Fungsi yang tidak wajib dapat mengembalikan Kode Kesalahan Function-Specific untuk memberi sinyal bahwa tidak ada data yang valid untuk dikembalikan.

Semua bit dan byte yang dipesan harus memiliki nilai 0. Kecuali dinyatakan sebaliknya, semua bidang multi-byte harus diwakili dengan cara little-endian.

Catatan

Referensi ke register Byte Addressable Energy-Backed Interface menjelaskan banyak bidang pengembalian untuk fungsi yang ditentukan dalam antarmuka ini. Bidang-bidang ini harus identik dengan register yang ditentukan dalam revisi "Byte Addressable Energy Backed Interface, versi 1.0, JEDEC Standard No. 2233-22" dari spesifikasi antarmuka Byte-Addressable Energy-Backed. Versi spesifikasi dilaporkan di bidang Revisi Spesifikasi yang dikembalikan oleh fungsi Dapatkan Identifikasi NVDIMM-N (Indeks Fungsi 1).

Beberapa bidang pengembalian mengacu pada informasi tentang Sumber Energi (ES). Ketika kebijakan ES dikelola perangkat, platform harus membaca register perangkat keras yang ditentukan dalam deskripsi bidang untuk mengambil semua informasi terkait ES. Ketika kebijakan ES dikelola host, platform harus mendapatkan informasi terkait ES melalui mekanisme khusus platform. Dalam hal ini, semua informasi terkait ES harus disajikan dalam tata letak biner yang sama dengan register perangkat keras yang ditentukan dalam deskripsi bidang.