Mulai dari sini: koneksi apa yang Anda gunakan?
Koneksi | Gejala yang khas | Periksa lebih dulu |
|---|---|---|
Ribbon MIPI DSI (Touch Display resmi, sebagian besar panel 5–10") | Backlight mati, atau backlight menyala tetapi layar hitam | Jenis dan orientasi kabel, daya layar, |
HDMI (monitor, board driver HDMI) | "No signal", resolusi salah, layar hitam setelah boot | Port yang digunakan, mode yang dipaksa dengan |
SPI pada header GPIO (panel kecil 2.4–3.5") | Layar putih, tidak ada apa pun setelah desktop mulai | Driver dan overlay yang disediakan vendor panel |
Kerjakan bagian untuk koneksi Anda secara berurutan. Setiap langkah menyingkirkan satu penyebab, dan langkah-langkah awal adalah yang paling sering menjadi biang masalah.
Layar DSI: layar hitam atau hanya backlight yang menyala
1. Gunakan kabel ribbon yang tepat untuk Pi Anda
Raspberry Pi 5 memiliki konektor DSI yang lebih kecil daripada model-model sebelumnya, sehingga kabel yang disertakan dengan layar lama tidak muat. Menurut dokumentasi Raspberry Pi:
- Raspberry Pi 4 dan sebelumnya: kabel fleksibel datar (FFC) 15-way ke 15-way.
- Raspberry Pi 5: FFC 22-way ke 15-way (Standard – Mini). Ujung 22-way adalah ujung yang lebih kecil dan masuk ke Pi; ujung yang lebih besar masuk ke layar.
- Touch Display 2, 10 inci, di Raspberry Pi 5: FFC 22-way ke 22-way Mini – Mini yang disertakan.
Model Raspberry Pi Zero tidak memiliki konektor DSI, sehingga layar DSI sama sekali tidak dapat digunakan padanya.
2. Pastikan kabel terpasang penuh dan menghadap ke arah yang benar
Buka klip pengunci konektor, dorong kabel hingga masuk sepenuhnya, lalu tutup klipnya. Pada Raspberry Pi 4B dan sebelumnya, konektor layar berlabel DISPLAY (bukan CAMERA), dan kontak logamnya menghadap ke port Ethernet dan USB-A. Kabel yang terpasang terbalik, setengah masuk, atau berada di konektor kamera menimbulkan gejala yang persis sama dengan panel yang mati.
3. Beri layar 5 V tersendiri
Layar resmi ditenagai secara terpisah dari kabel DSI:
- Touch Display asli: kabel jumper dari header GPIO Pi, hitam ke pin 6 (GND) dan merah ke pin 4 (5 V), atau pin 2 jika pin 4 sudah terpakai. Anda bisa memakai catu daya micro USB sebagai gantinya, tetapi jika begitu jangan juga menghubungkan kabel daya GPIO.
- Touch Display 2: kabel daya GPIO yang disertakan, ujung kecilnya ke port
J1pada layar, merah ke pin 2 dan hitam ke pin 6.
Jika backlight tidak pernah menyala, daya adalah tersangka pertama. Panel pihak ketiga sering membutuhkan catu daya terpisah untuk backlight; periksa diagram pengkabelan dari vendor.
4. Jangan menambahkan baris dtoverlay yang tidak Anda perlukan
Raspberry Pi OS sudah menyertakan display_auto_detect=1 di /boot/firmware/config.txt, dan dengan pengaturan tersebut firmware memuat overlay untuk layar DSI yang dikenali secara otomatis. Pada Raspberry Pi standar, layar resmi karena itu memerlukan tanpa baris dtoverlay sama sekali. Menambahkannya secara manual, dengan ukuran atau port yang salah, adalah penyebab umum layar hitam.
Raspberry Pi Compute Modules berbeda: modul ini tidak mendeteksi layar DSI secara otomatis, jadi Anda harus menambahkan overlay sendiri:
- Touch Display 2, 5 inci:
dtoverlay=vc4-kms-dsi-ili9881-5inch - Touch Display 2, 7 inci:
dtoverlay=vc4-kms-dsi-ili9881-7inch - Touch Display 2, 10 inci:
dtoverlay=vc4-kms-dsi-ili79600-10-1inch - Touch Display 7 inci asli:
dtoverlay=vc4-kms-dsi-7inch
Bawaannya adalah port berlabel 1; tambahkan ,dsi0 untuk menggunakan port 0 (misalnya dtoverlay=vc4-kms-dsi-7inch,dsi0). Untuk layar asli, hapus juga semua baris display_auto_detect yang ada.
5. Panel DSI pihak ketiga membutuhkan overlay tersendiri
Deteksi otomatis hanya berlaku untuk layar yang dikenali firmware. Panel MIPI DSI pihak ketiga membutuhkan device-tree overlay yang sesuai dengan kontroler, jumlah lane, dan timing-nya, biasanya disediakan oleh vendor panel. Jika overlay dari vendor ditujukan untuk kernel yang lebih lama atau model Pi yang lain, panel bisa tetap gelap meskipun pengkabelannya benar. Minta overlay yang sudah diuji pada model Pi dan rilis OS yang persis sama dengan milik Anda. Catatan layar Raspberry Pi 5 dan gambaran umum layar MIPI DSI kami membahas apa saja yang perlu Anda tanyakan.
Display HDMI: "no signal" atau resolusi salah
1. Gunakan port HDMI yang pertama
Pada Raspberry Pi 4B dan 5, port berlabel HDMI0 pada board adalah output display pertama (HDMI-A-1 di Linux). Sambungkan satu display ke port tersebut sebelum menguji hal lain.
2. Setelan HDMI config.txt yang lama sudah tidak berfungsi
Banyak panduan masih menyuruh Anda mengatur hdmi_force_hotplug, hdmi_group dan hdmi_mode di config.txt. Dokumentasi Raspberry Pi kini mencantumkan opsi-opsi ini sebagai opsi legacy yang "tidak berfungsi dengan Raspberry Pi OS Bookworm dan yang lebih baru". Dengan driver grafis KMS, Linux mengelola seluruh pipeline display, termasuk output HDMI.
3. Paksa mode dengan video= di cmdline.txt
Tanpa mode yang ditetapkan, Pi membaca EDID display dan memilih resolusi sendiri. Board driver HDMI kecil kadang melaporkan EDID yang tidak cocok dengan panel, sehingga muncul "no signal" atau gambar terpotong. Paksa mode native panel dengan menambahkan parameter video= pada satu baris di /boot/firmware/cmdline.txt, misalnya video=HDMI-A-1:1024x600M@60 untuk panel 1024×600 pada 60 Hz.
Formatnya adalah video=<display>:<width>x<height>M@<refresh>. Gunakan HDMI-A-2 untuk port HDMI kedua dan DSI-1 untuk display DSI atau DPI. Ambil resolusi dan refresh rate dari datasheet panel. Pastikan seluruh isi cmdline.txt tetap dalam satu baris.
Gambar terputar atau tercermin
- Desktop: Preferences > Control Centre > Screens, pilih display, lalu atur Orientation ke Normal, Left, Inverted atau Right.
- Hanya konsol: perluas parameter
video=, misalnyavideo=DSI-1:720x1280@60,rotate=90. Gunakanreflect_x,reflect_yataureflect_xyuntuk mencerminkan gambar.
Ada dua batasan: semua display yang tersambung berbagi setelan rotate= yang sama, dan rotate= hanya memutar konsol teks. Aplikasi yang menggambar langsung ke DRM, seperti cvlc atau aplikasi libcamera, memerlukan opsi rotasinya sendiri.
Sentuhan tidak sesuai dengan gambar
Pada desktop, atur orientasi di Control Centre dan sentuhan akan mengikuti. Pada setup non-desktop dengan display yang diputar, tambahkan parameter sentuhan ke overlay display di config.txt: invx dan invy membalik satu sumbu, swapxy menukar keduanya, dan disable_touch mematikan sentuhan. Misalnya, dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy membalik kedua sumbu pada Touch Display 2 berukuran 7 inci.
Untuk display 7 inci versi pertama, hapus display_auto_detect=1 saat menambahkan overlay sentuhan dengan cara ini. Raspberry Pi mencatat bahwa memutar sentuhan di device tree dapat berkonflik dengan library input Anda, jadi putar peristiwa sentuhan di library atau desktop bila memungkinkan.
Layar menjadi hitam setelah sepuluh menit
Itu adalah screen blanking, bukan kerusakan. Saat aktif, Raspberry Pi OS memblankkan layar setelah 600 detik tanpa aktivitas. Matikan di Control Centre (toggle Screen Blanking) atau dengan sudo raspi-config > 2 Display Options > D2 Screen Blanking. Untuk konsol teks, tambahkan consoleblank=0 ke cmdline.txt agar layar tidak pernah diblankkan.
Ketika yang bermasalah panelnya, bukan Pi-nya
Jika panel tetap gelap pada Pi yang diketahui baik dengan kabel, daya, dan setelan yang tepat, ukur suplai backlight dan ganti dengan panel kedua sebelum mengerjakan ulang perangkat lunak. Untuk produk, bukan rakitan sekali pakai, pilih panel yang supliénya memberi Anda overlay, timing, dan urutan daya untuk host yang persis sama. Perbandingan antarmuka display kami menjelaskan kapan DSI atau HDMI menjadi pilihan yang lebih baik untuk desain Raspberry Pi.
Pertanyaan yang sering diajukan
Mengapa display Raspberry Pi 5 saya tidak berfungsi dengan kabel dari display lama saya?
Raspberry Pi 5 memiliki konektor DSI 22-pin yang lebih kecil. Display dengan konektor 15-pin memerlukan kabel fleksibel flat dari 22-pin ke 15-pin, dengan ujung 22-pin yang lebih kecil terpasang di Pi.
Apakah saya perlu baris dtoverlay untuk Raspberry Pi Touch Display resmi?
Tidak pada Raspberry Pi standar: dengan display_auto_detect=1, yang merupakan bawaan Raspberry Pi OS, firmware memuat overlay secara otomatis. Compute Modules tidak mendeteksi display DSI secara otomatis, jadi tambahkan overlay, misalnya dtoverlay=vc4-kms-dsi-ili9881-7inch, sendiri.
Mengapa hdmi_mode tidak berfungsi lagi?
hdmi_group, hdmi_mode dan hdmi_force_hotplug adalah opsi config.txt legacy yang tidak berfungsi dengan Raspberry Pi OS Bookworm dan yang lebih baru. Paksa mode dengan video= di cmdline.txt, misalnya video=HDMI-A-1:1024x600M@60.
Bagaimana cara menghentikan layar Raspberry Pi agar tidak mati?
Matikan Screen Blanking di Control Centre atau di raspi-config pada 2 Display Options > D2 Screen Blanking. Untuk konsol teks, tambahkan consoleblank=0 ke cmdline.txt.