Was ist der ST7789V?
Der ST7789V ist ein TFT-LCD-Source- und Gate-Treiber von Sitronix mit integriertem Bildspeicher (GRAM). Da das Bild im Treiber liegt, sendet ein Mikrocontroller nur geänderte Pixel und braucht keinen eigenen Framebuffer. Deshalb sind ST7789V-Module an ESP32-, STM32-, RP2040- und Arduino-Boards so beliebt.
Welche Schnittstelle sollte ich verwenden?
Schnittstelle | Pins | Typische Nutzung |
|---|---|---|
4-wire SPI | 4–5 | Die meisten Module; einfache Verdrahtung, bis ~60 MHz |
8080 parallel (MCU) | 12–20 | Schnellerer Vollbild-Refresh bei MCUs mit FSMC/FMC |
RGB | 18–24 | Selten bei kleinen Modulen; videoähnlicher Refresh |
Häufige Probleme bei der Inbetriebnahme
- Weißer oder schwarzer Bildschirm: Reset-Timing prüfen und sicherstellen, dass nach SLPOUT 120 ms gewartet wird, bevor DISPON folgt.
- Falsche Farben: INVON/INVOFF und das BGR-Bit in MADCTL umschalten.
- Bildversatz: den korrekten Spalten-/Zeilenstart für 240×240- und 135×240-Panels einstellen.
- Tearing: den TE-Pin nutzen, falls Ihr Modul ihn herausführt.
Eine Schritt-für-Schritt-Checkliste finden Sie in unserem Leitfaden zur Fehlersuche bei weißem TFT-Bildschirm.
ST7789V-Init-Code
// 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);Bibliotheksunterstützung für ST7789V
| Bibliothek | Treiber / Klasse | Hinweise |
|---|---|---|
| TFT_eSPI (Arduino) | ST7789_DRIVER | |
| LovyanGFX (Arduino / ESP-IDF) | lgfx::Panel_ST7789 | |
| ESP-IDF esp_lcd | esp_lcd_new_panel_st7789() (built in) | |
| Hinweis | Viele ST7789-Panels benötigen aktivierte Farbinvertierung. |
User_Setup_ST7789V.h · LGFX_ST7789V.hpp. Die Pins sind Platzhalter; wir informieren Sie per E-Mail, wenn wir getestete Konfigurationen ergänzen.
Entwicklungsboards mit ST7789V
Displaymodule mit ST7789V
2,8" 240×320 TFT-LCD, SPI (PJ2801H22-23H10P200)
- Größe
- 2.8"
- Auflösung
- 240×320
- Helligkeit
- 200 nits
2,4" 240×320 TFT-LCD, SPI (PJ2401I24-22H30P250)
- Größe
- 2.4"
- Auflösung
- 240×320
- Helligkeit
- 250 nits
2,4" 240×320 TFT-LCD, MCU (PJ2401I02-22H38P300)
- Größe
- 2.4"
- Auflösung
- 240×320
- Helligkeit
- 300 nits
2,4" 240×320 IPS TFT-LCD, SPI / MCU / RGB (PJ2401H28-22H45P200)
- Größe
- 2.4"
- Auflösung
- 240×320
- Helligkeit
- 200 nits
2,4" 240×320 IPS TFT-LCD, SPI / MCU / RGB (PJ2401H25-22H45P200)
- Größe
- 2.4"
- Auflösung
- 240×320
- Helligkeit
- 200 nits
2" 240×320 TFT-LCD, SPI / MCU (PJ2003L02-22H22P300)
- Größe
- 2"
- Auflösung
- 240×320
- Helligkeit
- 300 nits
ST7789V: Fehlersuche & FAQ
Warum sind die Farben auf meinem ST7789-Display invertiert?
Die meisten IPS-Panels mit ST7789V brauchen aktivierte Display-Inversion (Befehl 0x21, INVON). Wenn die Farben wie ein Fotonegativ aussehen, schalten Sie die Inversion um; sind Rot und Blau vertauscht, ändern Sie das RGB/BGR-Bit in MADCTL (0x36).
Welchen SPI-Takt verträgt der ST7789V?
Viele Module laufen mit kurzer Verdrahtung zuverlässig mit 40–62,5 MHz SPI. Beginnen Sie bei 20 MHz, bestätigen Sie das Bild und erhöhen Sie dann schrittweise, während Sie auf Bildfehler achten.
Warum ist mein 240×240-Bild um 80 Pixel verschoben?
Der Bildspeicher des ST7789V umfasst 240×320. Bei 240×240-Panels brauchen manche Rotationen einen Zeilen- oder Spaltenversatz (oft 80) in CASET/RASET; die meisten Bibliotheken bieten das als rowstart/colstart-Einstellung an.