ILI9881C: datasheet, pinout & kode inisialisasi

Apa itu ILI9881C

ILI9881C adalah driver Ilitek untuk panel TFT MIPI DSI, biasanya panel portrait 720×1280 atau 800×1280. Ia tidak memiliki antarmuka piksel SPI atau RGB: perintah dan piksel sama-sama dikirim melalui DSI. Ilitek tidak mempublikasikan datasheet-nya secara terbuka, sehingga referensi praktisnya adalah driver Linux mainline, panel-ilitek-ili9881c.c, ditambah tabel init dari pembuat panel Anda.

Satu controller, banyak tabel init

Driver Linux bukanlah satu konfigurasi tunggal. Driver ini membawa tabel init, timing display, dan jumlah lane yang terpisah untuk setiap panel yang didukungnya. Panel-panel yang tercantum di mainline antara lain:

• Raspberry Pi Touch Display 2, 5″ dan 7″ (raspberrypi,dsi-5inch, raspberrypi,dsi-7inch): 720×1280, 2 data lane.
• Waveshare 7.0″ DSI Touch A: 2 data lane.
• Panel dari Banana Pi, Startek, TDO, Feixin, Bestar, Wanchanglong, dan Ampire: 720×1280 atau 800×1280, pada 2 atau 4 lane tergantung panelnya.

Dua panel dengan controller yang sama tetap bisa membutuhkan tabel init dan timing yang berbeda. Jika Anda menyalin tabel init dari board lain, layar bisa tetap hitam atau menampilkan garis-garis meskipun link DSI sudah aktif. Mulailah dari tabel untuk panel persis yang Anda gunakan.

Linux mainline memiliki driver ILI9881C tetapi tidak ada entri untuk ILI9881D. Perlakukan panel ILI9881D, seperti PJ5015B14 milik kami (4.99″ 720×1280 IPS), sebagai panel yang membutuhkan tabel init dan timing-nya sendiri dari datasheet panel tersebut.

Urutan power-on di driver Linux

Driver mainline menyalakan panel dengan urutan berikut:

1. Aktifkan IOVCC, tunggu 5 ms, lalu aktifkan catu daya utama dan tunggu 5 ms.
2. Tarik reset selama 20 ms, lepaskan, lalu tunggu 20 ms.
3. Kirim tabel init panel. ILI9881C menggunakan perintah page-switch untuk mengakses register vendor-nya.
4. Kembali ke page 0, aktifkan output tearing-effect, dan kirim Exit Sleep.
5. Tunggu 120 ms, lalu kirim Display On.

Raspberry Pi: Touch Display 2

Dokumentasi Raspberry Pi memuat Touch Display 2 dengan overlay berikut:

• dtoverlay=vc4-kms-dsi-ili9881-5inch
• dtoverlay=vc4-kms-dsi-ili9881-7inch

Tambahkan ,dsi0 untuk menggunakan port DSI yang lain. Model 5″ dan 7″ sama-sama 720×1280 dengan touch lima titik. Model 10″ menggunakan controller dan overlay yang berbeda (vc4-kms-dsi-ili79600-10-1inch) dan membutuhkan empat lane DSI.

Panel ILI9881C atau ILI9881D kustom pada Pi membutuhkan device-tree overlay yang menyebutkan entri panel yang cocok. Menggunakan kembali overlay Touch Display 2 hanya berhasil jika panelnya benar-benar sesuai dengan tabel init dan timing tersebut.

ESP32-P4 dan M5Stack Tab5

Driver mipi_dsi milik ESPHome menjalankan panel ILI9881C pada ESP32-P4, dengan 1 atau 2 data lane (default 2). M5Stack Tab5 menunjukkan betapa rapuhnya pilihan ini. ESPHome mendokumentasikan tiga versi perangkat keras:

• Dibuat sebelum 14 Oktober 2025: driver display ILI9881C dengan touch controller GT911 terpisah. Gunakan model M5STACK-TAB5.
• Unit yang lebih baru: sebuah controller display-dan-touch terintegrasi, baik ST7123 (M5STACK-TAB5-ST7123) maupun ST7121 (M5STACK-TAB5-ST7121).

Ketiga urutan init tersebut tidak dapat dipertukarkan. Jika Anda memilih model display yang salah, layarnya hanya tetap gelap dan tidak ada log yang relevan. Touch driver yang salah justru mencatat error, sehingga ESPHome menyarankan mengidentifikasi board dari touch driver-nya terlebih dahulu.

Checklist bring-up

1. Pastikan jumlah lane dan mode DSI (video, sync-pulse, atau burst) dari datasheet panel; pengaturan host harus sesuai.
2. Gunakan tabel init untuk panel persis yang Anda gunakan, bukan hanya berdasarkan nama controllernya.
3. Periksa urutan reset dan catu daya. Beberapa board mengontrol reset atau daya melalui IO expander.
4. Backlight menyala tetapi tanpa gambar biasanya berarti tabel init yang salah, jumlah lane yang salah, atau ketidakcocokan timing DSI, bukan panel yang rusak.

Untuk pilihan antarmuka, lihat MIPI DSI vs LVDS vs eDP dan halaman antarmuka MIPI DSI.