Apa itu ST7789V?
ST7789V adalah driver source dan gate TFT LCD dari Sitronix dengan memori frame terintegrasi (GRAM). Karena gambar tersimpan di dalam driver, mikrokontroler hanya mengirim piksel yang berubah dan tidak memerlukan frame buffer sendiri. Itulah sebabnya modul ST7789V populer di board ESP32, STM32, RP2040, dan kelas Arduino.
Antarmuka mana yang sebaiknya saya pakai?
Antarmuka | Pin | Penggunaan umum |
|---|---|---|
4-wire SPI | 4–5 | Sebagian besar modul; pengkabelan sederhana, hingga ~60 MHz |
8080 paralel (MCU) | 12–20 | Refresh layar penuh lebih cepat pada MCU dengan FSMC/FMC |
RGB | 18–24 | Jarang di modul kecil; refresh seperti video |
Masalah bring-up yang umum
- Layar putih atau hitam: periksa timing reset dan pastikan SLPOUT diikuti jeda 120 ms sebelum DISPON.
- Warna salah: ubah INVON/INVOFF dan bit BGR di MADCTL.
- Gambar bergeser: atur awal kolom/baris yang benar untuk panel 240×240 dan 135×240.
- Tearing: gunakan pin TE jika modul Anda mengeluarkannya.
Lihat panduan troubleshooting layar putih TFT kami untuk daftar periksa langkah demi langkah.
Kode inisialisasi ST7789V
// Reference init sequence. Adjust MADCTL, inversion and offsets per panel.
write_cmd(0x01); // SWRESET
delay_ms(150);
write_cmd(0x11); // SLPOUT
delay_ms(120);
write_cmd(0x3A); write_data(0x55); // COLMOD: 16-bit RGB565
write_cmd(0x36); write_data(0x00); // MADCTL: rotation / RGB order
write_cmd(0x21); // INVON: most IPS panels need inversion
write_cmd(0x13); // NORON
write_cmd(0x29); // DISPON
delay_ms(20);Dukungan pustaka ST7789V
| Pustaka | Driver / kelas | Catatan |
|---|---|---|
| TFT_eSPI (Arduino) | ST7789_DRIVER | |
| LovyanGFX (Arduino / ESP-IDF) | lgfx::Panel_ST7789 | |
| ESP-IDF esp_lcd | esp_lcd_new_panel_st7789() (built in) | |
| Catatan | Banyak panel ST7789 memerlukan inversi warna diaktifkan. |
User_Setup_ST7789V.h · LGFX_ST7789V.hpp. Pin bersifat sementara; kami akan mengirim email saat menambahkan konfigurasi yang sudah diuji.
Dev board yang memakai ST7789V
Modul display yang memakai ST7789V
TFT LCD 2,8" 240×320, SPI (PJ2801H22-23H10P200)
- Ukuran
- 2.8"
- Resolusi
- 240×320
- Kecerahan
- 200 nit
TFT LCD 2,4" 240×320, SPI (PJ2401I24-22H30P250)
- Ukuran
- 2.4"
- Resolusi
- 240×320
- Kecerahan
- 250 nit
TFT LCD 2,4" 240×320, MCU (PJ2401I02-22H38P300)
- Ukuran
- 2.4"
- Resolusi
- 240×320
- Kecerahan
- 300 nit
TFT LCD IPS 2,4" 240×320, SPI / MCU / RGB (PJ2401H28-22H45P200)
- Ukuran
- 2.4"
- Resolusi
- 240×320
- Kecerahan
- 200 nit
TFT LCD IPS 2,4" 240×320, SPI / MCU / RGB (PJ2401H25-22H45P200)
- Ukuran
- 2.4"
- Resolusi
- 240×320
- Kecerahan
- 200 nit
TFT LCD 2" 240×320, SPI / MCU (PJ2003L02-22H22P300)
- Ukuran
- 2"
- Resolusi
- 240×320
- Kecerahan
- 300 nit
ST7789V: troubleshooting & FAQ
Mengapa warna di display ST7789 saya terbalik?
Sebagian besar panel IPS dengan ST7789V memerlukan inversi display diaktifkan (perintah 0x21, INVON). Jika warna terlihat seperti negatif foto, ubah inversi; jika merah dan biru tertukar, ubah bit RGB/BGR di MADCTL (0x36).
Berapa clock SPI yang dapat ditangani ST7789V?
Banyak modul bekerja andal pada SPI 40–62,5 MHz dengan pengkabelan pendek. Mulai dari 20 MHz, konfirmasikan gambar, lalu naikkan sambil memeriksa kerusakan gambar.
Mengapa gambar 240×240 saya bergeser 80 piksel?
Memori frame ST7789V berukuran 240×320. Pada panel 240×240, beberapa rotasi memerlukan offset baris atau kolom (sering 80) di CASET/RASET; sebagian besar pustaka menyediakannya sebagai pengaturan rowstart/colstart.