struktur DXGK_DSI_TRANSMISSION (dispmprt.h)

Artikel
02/26/2024

Struktur DXGK_DSI_TRANSMISSION digunakan untuk mengirimkan paket Display Serial Interface (DSI) ke driver bus (kernel grafis).

Sintaks

typedef struct _DXGK_DSI_TRANSMISSION {
  UINT            TotalBufferSize;
  BYTE            PacketCount;
  BYTE            FailedPacket;
  struct {
    WORD TransmissionMode : 2;
    WORD ReportMipiErrors : 1;
    WORD ClearMipiErrors : 1;
    WORD SecondaryPort : 1;
    WORD ManufacturingMode : 1;
    WORD Reserved : 10;
  };
  WORD            ReadWordCount;
  WORD            FinalCommandExtraPayload;
  WORD            MipiErrors;
  WORD            HostErrors;
  DXGK_DSI_PACKET Packets[1];
} DXGK_DSI_TRANSMISSION, *PDXGK_DSI_TRANSMISSION;

Anggota

TotalBufferSize

Jumlah byte di seluruh struktur termasuk header, perintah, dan payload.

PacketCount

Jumlah elemen DXGK_DSI_PACKET dalam array Paket .

FailedPacket

Indeks, ketika diketahui, dari DXGK_DSI_PACKET dalam array Paket yang memiliki kesalahan. Jika tidak diketahui atau tidak ada kesalahan paket yang terdeteksi, nilai DXGK_DSI_INVALID_PACKET_INDEX diatur.

TransmissionMode

Salah satu nilai DXGK_MIPI_CONTROL_TRANSMISSIONMODE.

ReportMipiErrors

Jika diatur, driver grafis harus meminta akumulasi kesalahan MIPI dalam pengakuan perintah akhir dan melaporkannya di bidang MipiErrors.

ClearMipiErrors

Jika diatur dan driver grafis telah mengirim perintah yang dimulai panel non-OEM, driver harus memastikan bahwa kesalahan MIPI yang terakumulasi dihapus sebelum mulai mengirim urutan ini.

SecondaryPort

Atur apakah transmisi harus dikirim ke panel sekunder, bukan primer.

ManufacturingMode

Atur untuk menonaktifkan validasi OS perintah DCS saat sistem dalam mode manufaktur.

Reserved

Dicadangkan.

ReadWordCount

FinalCommandExtraPayload

MipiErrors

Kombinasi dari kemungkinan nilai kesalahan berikut, menunjukkan kesalahan yang dilaporkan oleh komunikasi dengan periferal.

Kesalahan DXGK_MIPI_DSI_XXX	Makna
DXGK_MIPI_DSI_SOT_ERROR	Kemungkinan kesalahan di Awal urutan pemimpin transmisi High-Speed
DXGK_MIPI_DSI_SOT_SYNC_ERROR	Kesalahan dalam Urutan awal High-Speed pimpinan transmisi
DXGK_MIPI_DSI_EOT_SYNC_ERROR	Byte periferal terdeteksi tidak lengkap dalam transmisi High-Speed
DXGK_MIPI_DSI_ESCAPE_MODE_ENTRY_COMMAND_ERROR	Kesalahan atau periferal tidak mengenali urutan escape
DXGK_MIPI_DSI_LOW_POWER_TRANSMIT_SYNC_ERROR	Byte periferal terdeteksi tidak lengkap dalam transmisi Low-Speed
DXGK_MIPI_DSI_FALSE_CONTROL_ERROR	Periferal mendeteksi kesalahan dalam urutan escape atau urutan turnaround
DXGK_MIPI_DSI_CONTENTION_DETECTED	Ketidakcocokan terdeteksi
DXGK_MIPI_DSI_CHECKSUM_ERROR_CORRECTED	Kesalahan checksum terdeteksi dan dikoreksi
DXGK_MIPI_DSI_CHECKSUM_ERROR_NOT_CORRECTED	Kesalahan checksum terdeteksi tetapi tidak dapat diperbaiki
DXGK_MIPI_DSI_LONG_PACKET_PAYLOAD_CHECKSUM_ERROR	Checksum payload salah untuk paket panjang
DXGK_MIPI_DSI_DSI_DATA_TYPE_NOT_RECOGNIZED	Periferal tidak mengenali jenis data yang dikirim ke dalamnya
DXGK_MIPI_DSI_DSI_VC_ID_INVALID	Periferal dikirim perintah untuk saluran virtual yang tidak didukungnya
DXGK_MIPI_DSI_INVALID_TRANSMISSION_LENGTH	Periferal mendeteksi bahwa jumlah byte yang ditransmisikan tidak cocok dengan apa yang ditentukan di header
DXGK_MIPI_DSI_DSI_PROTOCOL_VIOLATION	Periferal mendeteksi kurangnya EoTP pada transmisi atau host gagal memberi sinyal bus berbalik untuk dibaca

HostErrors

Kombinasi kesalahan DXGK_HOST_DSI_XXX yang menunjukkan kesalahan yang dilaporkan oleh driver grafis atau OS.

Kesalahan DXGK_HOST_DSI_XXX	Makna
DXGK_HOST_DSI_DEVICE_NOT_READY	Host mendeteksi bahwa permintaan dibuat untuk perangkat yang tidak dalam status yang benar untuk dapat menerima permintaan.
DXGK_HOST_DSI_INTERFACE_RESET	Driver grafis mendeteksi kesalahan yang memerlukan reset antarmuka DSI dengan panel. Driver panel harus memverifikasi status perangkat sebelum melanjutkan transmisi normal.
DXGK_HOST_DSI_DEVICE_RESET	Driver grafis mendeteksi kesalahan yang memerlukan reset panel dan status harus diasumsikan telah hilang. Driver panel harus menerapkan kembali status perangkat privat apa pun sebelum melanjutkan transmisi normal.
DXGK_HOST_DSI_TRANSMISSION_CANCELLED	Host membatalkan transmisi, yang sedang berlangsung, karena bus diperlukan untuk transmisi prioritas yang lebih tinggi, seperti refresh piksel. Driver panel perlu memastikan bahwa efek apa pun yang dapat ditimbulkan oleh transmisi parsial dibatalkan atau diverifikasi sebelum melanjutkan dengan transmisi. Jika kesalahan ini sering terjadi, itu mungkin berarti bahwa transmisi terlalu besar untuk diselesaikan dengan andal dan driver panel harus diubah untuk membaginya menjadi beberapa transmisi.
DXGK_HOST_DSI_TRANSMISSION_DROPPED	Host menjatuhkan transmisi sebelum memulainya karena transmisi prioritas yang lebih tinggi menyebabkan transmisi tertunda di luar batas yang diizinkan. Driver panel dapat mencoba transmisi yang sama lagi, jika masih relevan. Kesalahan ini menunjukkan bahwa bandwidth tautan DSI tidak memadai sehingga tidak boleh terjadi di lingkungan ritel. Jika transmisi cukup besar, ini mungkin menunjukkan bahwa transmisi perlu dipisahkan agar berhasil dengan andal.
DXGK_HOST_DSI_TRANSMISSION_TIMEOUT	Host mendeteksi batas waktu perangkat keras saat berkomunikasi dengan periferal. Driver panel perlu memastikan bahwa efek apa pun yang dapat ditimbulkan oleh transmisi parsial dibatalkan atau diverifikasi sebelum melanjutkan dengan transmisi. Kecuali transmisi menyebabkan panel memasuki keadaan buruk, tidak ada mitigasi untuk ini di driver panel, jadi harus back-off dan mencoba untuk melanjutkan.
DXGK_HOST_DSI_INVALID_TRANSMISSION	Validasi OS dari buffer DXGK_DSI_TRANSMISSION menemukan kesalahan sehingga transmisi dibatalkan tanpa memanggil driver grafis atau memeriksa paket yang dilarang. Ini disebabkan oleh kesalahan dalam driver panel OEM, atau validasi OS. Bidang `FailedPacket` menunjukkan paket buruk pertama jika kesalahan khusus untuk paket.
DXGK_HOST_DSI_OS_REJECTED_PACKET	OS menemukan paket yang dilarang sehingga transmisi dibatalkan tanpa memanggil driver grafis. Bidang `FailedPacket` menunjukkan paket buruk pertama.
DXGK_HOST_DSI_DRIVER_REJECTED_PACKET	Driver grafis menemukan paket yang tidak dapat diproses dengan aman sehingga transmisi dibatalkan tanpa interaksi periferal. Bidang `FailedPacket` menunjukkan paket buruk pertama.
DXGK_HOST_DSI_BAD_TRANSMISSION_MODE	Driver grafis tidak dapat menggunakan DXGK_DSI_CONTROL_TRANSMISSION_MODE yang ditentukan. Bidang `FailedPacket` menunjukkan paket pertama tidak kompatibel dengan mode transmisi.