Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Media SDV: Mengelola layar

SDV Media mengekspos tampilan yang tersedia ke aplikasi OEM dengan Linux DRM API.

Interaksi antara komponen DRM

Gambar 1. Interaksi antara komponen DRM.

Framebuffer adalah sumber data piksel, yang didukung oleh beberapa buffer memori yang dialokasikan secara eksternal.
Bidang adalah sumber gambar yang digunakan oleh CRTC. Objek ini dikaitkan dengan framebuffer, dan dapat merepresentasikan tampilan framebuffer yang dipangkas.
CRTC merepresentasikan keseluruhan pipeline tampilan. Layanan ini dapat menggabungkan beberapa bidang untuk membuat output video akhir, dan mengirimkan output ke beberapa encoder.
Encoder mengonversi output video dari CRTC menjadi bentuk yang sesuai untuk konektor tertentu.
Konektor mewakili konektor layar yang tersedia. Misalnya, port HDMI.

Untuk deskripsi yang lebih mendalam, lihat:

Platform API

SDV Media menyediakan antarmuka DRM Linux. Meskipun dapat digunakan secara langsung menggunakan syscall ioctl, untuk pengembangan aplikasi, sebaiknya gunakan library helper ruang pengguna. Contoh:

Crate drm-rs untuk Rust (direkomendasikan),
libdrm untuk C/C++. drm-kms man page memberikan ringkasan yang komprehensif tentang API dan penggunaannya.

Menyiapkan rendering ke satu layar

Buka perangkat DRM (/dev/dri/card*) dan gunakan API DRM Linux, misalnya, melalui libdrm, pada deskriptor filenya untuk memilih tampilan dan modenya.

Biasanya, sistem host hanya mengekspos satu perangkat GPU virtual, yang muncul sebagai /dev/dri/card0.
Mengalokasikan buffer depan dan belakang dengan Linux DRM API.

Sebaiknya gunakan gbm_bo_create() minigbm dan dapatkan deskriptor file DMA-BUF dengan gbm_bo_get_fd().
Buat framebuffer GL yang didukung oleh buffer yang dialokasikan.
1. Buat EGLImage dari buffer DRM dengan eglCreateImageKHR dengan EGL_LINUX_DMA_BUF_EXT (dari ekstensi EGL_EXT_image_dma_buf_import).
2. Buat tekstur GL dan gunakan glEGLImageTargetTexture2DOES (dari ekstensi GL_OES_EGL_image) untuk menyetel penyimpanan tekstur ke EGLImage dari langkah sebelumnya.
3. Buat framebuffer GL dan gunakan glFramebufferTexture2D untuk menyetel tekstur pendukungnya ke tekstur yang dibuat pada langkah sebelumnya.
Untuk merender frame:
1. Ikat salah satu framebuffer GL yang dibuat.
2. Gambar frame dengan API GLES biasa.
3. Menampilkan frame di layar: gunakan Linux DRM API (drmModeAtomicCommit()) untuk mengirim DRM_MODE_PAGE_FLIP_EVENT dengan deskriptor file DMA-BUF yang digunakan oleh framebuffer GL terikat.

Menyusun output video dari beberapa lapisan

Untuk komposisi multi-layer (multi-plane) yang dipercepat hardware, kami mengandalkan sistem host yang mengekspos setiap layer sebagai konektor DRM terpisah (tampilan virtual), dan memetakannya ke lokasi / pipeline hardware yang tepat.

Lihat Menyiapkan rendering ke beberapa layar untuk mengetahui detailnya.

Menyiapkan rendering ke beberapa layar

Buka perangkat DRM /dev/dri/card* seperti pada alur satu layar.
Mencantumkan konektor layar yang tersedia.

Setiap layar diekspos sebagai konektor DRM terpisah dari perangkat DRM.

Catatan: Karena SDV Media berjalan di VM, bergantung pada hypervisor, tampilan yang tersedia mungkin tidak selalu sesuai dengan tampilan fisik, tetapi misalnya jendela yang dikelola oleh proses compositor yang berjalan di sistem host.

Untuk setiap konektor layar:

Pilih CRTC yang kompatibel dengan konektor. Setiap konektor memiliki daftar encoder yang tersedia, dan setiap encoder menunjukkan CRTC yang dapat digunakan. Selalu ada minimal satu CRTC yang kompatibel.
1. Pilih pesawat yang kompatibel dengan CRTC.
2. Buat framebuffer DRM yang didukung oleh buffer GPU. Proses ini terlihat sama seperti untuk varian layar tunggal.
3. Hubungkan bidang, CRTC, dan konektor, lalu tetapkan mode video di CRTC.
  
  Anda dapat menyetel mode beberapa layar secara bersamaan dengan menggunakan API atomik untuk menyetel properti DRM berikut untuk setiap konektor, CRTC, dan set bidang.

Daftar lengkap properti yang diperlukan:

Target	Properti	Jenis	Deskripsi
Pemersatu	`CRTC_ID`	ID CRTC	ID CRTC yang akan ditetapkan ke konektor
CRTC	`MODE_ID`	ID Blob	ID blob properti yang dibuat menggunakan `drmModeCreatePropertyBlob`, yang berisi struct `drmModeModeInfo` dari mode video yang dipilih
CRTC	`ACTIVE`	Boolean	`true` untuk menandai CRTC sebagai aktif
Pesawat	`FB_ID`	ID Framebuffer	ID framebuffer DRM yang akan ditampilkan di layar
Pesawat	`SRC_X`	Piksel	Koordinat X persegi panjang gambar sumber framebuffer
Pesawat	`SRC_Y`	Piksel	Koordinat Y persegi panjang gambar sumber framebuffer
Pesawat	`SRC_W`	Titik tetap 16.16	Lebar persegi panjang gambar sumber framebuffer (piksel digeser ke kiri sebesar 16 bit)
Pesawat	`SRC_H`	Titik tetap 16.16	Tinggi persegi panjang gambar sumber framebuffer (piksel digeser ke kiri sebesar 16 bit)
Pesawat	`CRTC_X`	Piksel	Koordinat X persegi panjang gambar tujuan CRTC
Pesawat	`CRTC_Y`	Piksel	Koordinat Y persegi panjang gambar tujuan CRTC
Pesawat	`CRTC_W`	Piksel	Lebar persegi panjang gambar tujuan CRTC
Pesawat	`CRTC_H`	Piksel	Tinggi persegi panjang gambar tujuan CRTC

Masukkan loop render:
1. Tunggu peristiwa balik halaman di CRTC sebelum merender frame berikutnya.
2. Merender frame dan menampilkannya di layar dengan menjadwalkan penggantian halaman untuk CRTC+framebuffer tertentu.