Einrichtung eines TFT-LCD-Displays für den Raspberry Pi

Für Embedded-Software-Ingenieure, Hardware-Hacker und industrielle IoT-Architekten ist der Raspberry Pi der unbestrittene König des Rapid Prototyping. Im standardmäßigen “Headless”-Zustand (per SSH zugänglich) ist er ein leiser, unsichtbarer Arbeitstier. Sobald Sie jedoch eine Mensch-Maschine-Schnittstelle (HMI) benötigen – sei es für einen intelligenten Heizungsthermostaten, eine Fabriksteuerung oder einen maßgeschneiderten Medizingeräte-Prototyp – müssen Sie die Lücke zwischen Code und physischer Interaktion überbrücken.

Die Integration eines TFT-LCD-Raspberry-Pi- Displays ist oft die frustrierendste Initiationsprüfung in der Hardwareentwicklung. Wenn Sie jemals einen Bildschirm an die GPIO-Pins Ihres Pi angeschlossen haben, nur um vom berüchtigten “Weißen Bildschirm des Todes” begrüßt zu werden, wissen Sie genau, wie komplex diese Integration sein kann.

Diese umfassende, schrittweise Technikanleitung führt Sie präzise durch die erforderlichen Hardwareverbindungen, die zugrundeliegenden Linux-Device-Tree-Overlays und die modernen Wayland/X11-Softwarekonfigurationen, um einen TFT-LCD erfolgreich auf einem Raspberry Pi in Betrieb zu nehmen.

1. Architekturanalyse: Ihr Display-Interface verstehen

Bevor Sie auch nur einen Jumper-Draht anfassen oder sudo nano, eintippen, müssen Sie verstehen, wie wie Ihr Display mit dem Raspberry Pi kommuniziert. Die Verbindungsmethode bestimmt vollständig die Bildwiederholrate, die CPU-Auslastung und die benötigte Softwaretreiber.

Es gibt vier primäre Methoden, um einen TFT-LCD-Raspberry-Pi-Display anzuschließen.

A. Das SPI-Interface (Serial Peripheral Interface)

Dies ist die gängigste Schnittstelle für kleine Displays (1,5″ bis 3,5″). Diese Displays sitzen direkt auf dem 40-poligen GPIO-Header.

• Die Realität: SPI ist ein serielles Protokoll. Es sendet Pixeldaten bitweise. Es ist von Natur aus langsam.
• Anwendungsfall: Perfekt für statische Benutzeroberflächen, Sensoranzeigen oder textlastige Dashboards.
• Einschränkungen: Erwarten Sie nicht, 60-FPS-Videos auf einem SPI-Bildschirm abzuspielen. Sie sind physikalisch durch die SPI-Busgeschwindigkeit begrenzt (typischerweise auf etwa 32 MHz bis 48 MHz gedeckelt), was maximal 15 bis 25 FPS auf einem 320×480-Auflösungsbildschirm ergibt. Eine hohe CPU-Auslastung ist erforderlich, um die Pixel zu übertragen.

B. Das MIPI-DSI-Interface (Display Serial Interface)

Dies nutzt den dedizierten Flachbandkabelanschluss auf der Raspberry-Pi-Platine (bei Pi-5-Modellen mit “DISPLAY” oder “MIPI” beschriftet).

• Die Realität: DSI ist ein schnelles, differenzielles Signalinterface, das direkt auf die Broadcom-GPU des Raspberry Pi zugreift.
• Anwendungsfall: Die absolut beste Option für flüssige Benutzeroberflächen, Videowiedergabe und komplexe Grafiken. Es entlastet die CPU vollständig und lässt Ihre GPIO-Pins für andere Sensoren frei.
• Einschränkungen: DSI-Displays sind typischerweise auf offizielle Raspberry-Pi-Bildschirme oder spezielle Drittanbietermodelle mit benutzerdefinierten Bridge-Chips beschränkt.

C. Das DPI-Interface (Display Parallel Interface)

DPI nutzt fast alle GPIO-Pins (bis zu 24 Pins für RGB888-Farbe plus Synchronisationssignale), um ein direktes LCD-Panel anzusteuern.

• Die Realität: Es bietet HDMI-ähnliche Geschwindigkeiten und keine CPU-Auslastung, ohne den sperrigen HDMI-Port zu verwenden.
• Anwendungsfall: Für maßgefertigte Arcade-Automaten oder Industrieanwendungen, bei denen der HDMI-Port blockiert ist oder für einen zweiten Bildschirm benötigt wird.
• Einschränkungen: Sie verlieren fast alle Ihre GPIO-Pins. Sie können nicht einfach I2C-Sensoren oder SPI-Tasten hinzufügen.

D. Die HDMI-/USB-Kombination

Große TFT-LCD-Raspberry-Pi-Bildschirme (5 Zoll bis 10 Zoll) verwenden oft Standard-HDMI für das Displaysignal und ein USB-Kabel für die Touch-Oberfläche.

• Die Realität: Plug-and-Play-Einfachheit. Der Pi behandelt ihn wie einen Standard-Desktop-Monitor.
• Einschränkungen: Sperrige Verkabelung. Es ist schwierig, sie sauber in ein schlankes, maßgeschneidertes Produktgehäuse zu integrieren.

Für diesen praktischen Leitfaden konzentrieren wir uns auf die berüchtigt schwierigste Integration: den SPI-basierten GPIO-Display,, da er das tiefste Verständnis des Linux-Kernels erfordert.

2. Hardwaremontage: Verdrahtung des SPI-Displays

Wenn Ihr SPI-Display nicht direkt als “HAT” (Hardware Attached on Top) auf den GPIO-Header aufgesteckt wird, müssen Sie es manuell verkabeln.

Die goldene Regel der Hardware

Schließen Sie niemals ein Display an, während der Raspberry Pi eingeschaltet ist. Hot-Plugging von GPIO-Pins kann einen Spannungsspitze verursachen, die sofort den LCD-Treiber-IC zerstört oder, schlimmer noch, den Broadcom-SoC des Raspberry Pi durchbrennen lässt.

Die SPI-Pinbelegung im Detail

Um einen standardmäßigen SPI-TFT-LCD-Raspberry-Pi-Bildschirm zum Laufen zu bringen, müssen Sie die Stromversorgung, den SPI-Bus (MOSI, SCLK, CE) und die Steuerpins (DC, Reset) anschließen.

Hier ist die standardmäßige Zuordnung, die Sie mit Female-to-Female-Jumper-Kabeln durchführen müssen:

Technischer Hinweis: Die DC (Daten/Befehl) Pin ist entscheidend. SPI sendet nur Einsen und Nullen. Der Display-Controller (wie der ILI9341) muss wissen, ob diese Einsen und Nullen Pixelfarbdaten oder Systembefehle sind (wie “Bildschirm einschalten”). Der DC-Pin schaltet auf High oder Low, um dem Controller mitzuteilen, wie er die eingehenden SPI-Daten interpretieren soll.

3. Kernel-Konfiguration: Das Device Tree Overlay

Sie haben den Bildschirm verkabelt. Sie schalten den Pi ein. Der Bildschirm leuchtet, ist aber rein weiß. Dies ist der Weiße Bildschirm des Todes. Das bedeutet, die Hintergrundbeleuchtung hat Strom, aber der Raspberry Pi Kernel weiß nichts von der Existenz des Bildschirms, daher sendet er keine Pixeldaten.

Wir müssen dem Linux-Kernel mitteilen, wie er mit dem Bildschirm kommunizieren soll. Im modernen Raspberry Pi OS (Bookworm und später) geschieht dies über Device Tree Overlays (dtoverlay).

Schritt 3.1: SPI-Bus aktivieren

Zuerst müssen Sie die SPI-Hardware auf dem Pi freischalten.

1. SSH in Ihren Raspberry Pi.
2. Führen Sie das Konfigurationstool aus:Bashsudo raspi-config
3. Navigieren Sie zu Schnittstellen-Optionen -> SPI -> Wählen Sie Ja zum Aktivieren.
4. Starten Sie den Pi neu.

Schritt 3.2: Identifizieren Sie Ihren Display-Controller (Der Treiber)

TFT-LCD-Panels sind dummes Glas. Sie werden von einem Mikrochip angetrieben, der auf die Rückseite des Glases (oder auf die Leiterplatte) geklebt ist. Die häufigsten Controller auf den europäischen/US-amerikanischen Maker-Märkten sind:

• ILI9341 (Sehr verbreitet bei 2,4″ bis 2,8″ Bildschirmen)
• ST7789 (Verbreitet bei 1,3″ bis 2,0″ IPS-Bildschirmen)
• ILI9486 (Verbreitet bei 3,5″ Bildschirmen)

Sie müssen müssen wissen, welchen Controller Ihr Bildschirm verwendet. Prüfen Sie das Datenblatt des Herstellers.

Schritt 3.3: Bearbeiten Sie config.txt

Im modernen Raspberry Pi OS hat sich die Boot-Konfigurationsdatei verschoben.

Öffnen Sie sie mit dem Nano-Texteditor:

Bash

sudo nano /boot/firmware/config.txt

(Hinweis: Bei älteren Bullseye-OS-Versionen ist der Pfad nur /boot/config.txt)

Scrollen Sie zum Ende der Datei und fügen Sie das spezifische Overlay für Ihren Treiber hinzu. Zum Beispiel, wenn Sie ein ILI9341 Bildschirm genau wie in der obigen Tabelle verkabelt haben:

Ini, TOML

# SPI aktivieren

Für ein ST7789 Display (häufig in Adafruit PiTFTs verwendet):

Ini, TOML

dtoverlay=adafruit-st7789v-hAT,fps=30

Speichern Sie die Datei (Strg+O, Eingabe) und beenden Sie (Strg+X).

Starten Sie den Raspberry Pi neu: sudo reboot.

Bei korrekter Konfiguration wird der weiße Bildschirm während des Bootvorgangs schwarz und Sie werden schließlich den Linux-Konsolentext sehen, der über den kleinen Bildschirm läuft.

4. Moderne Grafikarchitekturen: FBCP vs. DRM/KMS

Hier führen viele Tutorials aus dem Jahr 2020 in die Irre.

Früher, wenn Sie Ihren Haupt-HDMI-Desktop auf ein kleines SPI-TFT-LCD-Raspberry-Pi-Display spiegeln wollten, verwendeten Sie ein Tool namens fbcp (Framebuffer Copy). It took a snapshot of the primary GPU framebuffer (fb0) and aggressively copied it to the SPI screen’s framebuffer (fb1).

The Wayland Reality Check

Starting with Raspberry Pi OS Bookworm, the X11 windowing system and the legacy framebuffer architecture were abandoned. The Pi now uses Wayland (specifically the Wayfire compositor) and the DRM/KMS (Direct Rendering Manager / Kernel Mode Setting) architecture.

fbcp no longer works on modern Raspberry Pi OS.

How to drive the UI today:

If you are building an industrial HMI or a custom device, you should not be trying to run a full desktop GUI on a 3.5-inch screen anyway. Instead, you should write an application that renders directly to the DRM/KMS layer using hardware-accelerated libraries.

The Professional Stack:

• LVGL (Light and Versatile Graphics Library): An open-source C library that writes directly to the Linux DRM subsystem. It is incredibly lightweight and perfect for SPI screens.
• Qt / PyQt: You can configure Qt applications to run using the eglfs oder linuxfb plugins, bypassing the Wayland desktop entirely and drawing your UI directly to the TFT LCD.
• Kiosk Mode: If you absolutely must use web technologies (HTML/CSS/JS), you can configure Wayfire to boot directly into a fullscreen Chromium browser pointing to a local Node.js server.

5. Calibrating the Touch Interface

If your tft lcd raspberry pi has a touch overlay, getting the screen to display an image is only half the battle. Now you must ensure that when you tap the top-left corner, the mouse cursor actually goes to the top-left corner.

Resistive vs. Capacitive Touch

• Resistive (XPT2046 Controller): Requires pressure. Very common on cheap 3.5″ SPI screens. Requires intense calibration because the analog resistance varies by temperature and manufacturing batch.
• Capacitive (FT6236 / Goodix Controllers): Like a smartphone. Generally requires zero calibration as the grid is digitally mapped to the pixels at the factory. Uses the I2C bus instead of SPI.

Calibrating an XPT2046 Resistive Screen under Wayland/Libinput

Because X11 is dead, the old xinput_calibrator tool is obsolete. Today, touchscreens are handled by libinput und udev rules.

1. First, ensure the touch driver is loaded in /boot/firmware/config.txt:Ini, TOMLdtoverlay=ads7846,cs=1,penirq=17,penirq_pull=2,speed=1000000,keep_vref_on=1
2. Reboot and install the libinput calibration tool:Bashsudo apt install weston
3. Wayfire (the default compositor) uses a specific configuration file for input devices. You must edit the Wayfire config to map the touch matrix correctly.Open ~/.config/wayfire.ini and locate the [input] section. You will need to add a calibration matrix.(Note: The exact matrix depends on whether your screen is landscape or portrait. A default identity matrix is 1 0 0 0 1 0.)

If your touch axes are inverted (moving your finger up moves the mouse down), you must flip the matrix values. For example, to invert the Y-axis, your udev rule or Wayfire config matrix would change the Y-scale multiplier to a negative value.

6. Overclocking the SPI Bus (Chasing Frames)

If your user interface feels sluggish, you can attempt to overclock the SPI bus to squeeze a few more frames per second out of the tft lcd raspberry pi.

Open /boot/firmware/config.txt and locate your driver overlay line. Add the Geschwindigkeit parameter (measured in Hz).

Ini, TOML

dtoverlay=rpi-display,speed=48000000

This requests a 48 MHz SPI clock.

Warnung: The Raspberry Pi’s SPI core clock operates on a divider system. If you request 48MHz, you will likely get it. If you request 60MHz, the Pi might divide its core clock and drop you down to 31MHz instead, making it slower. Furthermore, if you push the speed too high (e.g., 80000000), the physical jumper wires will act as antennas, introducing electromagnetic interference (EMI) that corrupts the data, resulting in a screen filled with static “snow” or inverted colors. Keep your wires as short as physically possible (under 10cm) if you intend to push the SPI speed.

Conclusion: The Engineering Payoff

Setting up a tft lcd raspberry pi is rarely a plug-and-play experience. It demands a working knowledge of serial protocols, Linux kernel overlays, and display rendering architectures. However, mastering this process is a critical skill for any hardware developer.

By bypassing bulky HDMI monitors and natively driving an SPI or DSI display, you unlock the ability to design highly integrated, professional-grade hardware prototypes. Whether you are building an industrial telemetry dashboard or a bespoke digital audio player, that glowing piece of glass transforms your invisible code into a tangible, interactive product.

Häufig gestellte Fragen (FAQ)

Q1: Why is my SPI display completely white when I boot the Pi?

A: This is the most common issue. A white screen means the backlight has 3.3V or 5V power, but the display controller IC is not receiving data.

1. Check wiring: Überprüfen Sie die MOSI-, SCLK- und insbesondere die CS- (Chip Select) und DC- (Data/Command) Pins.
2. Konfiguration prüfen: Sicherstellen dtparam=spi=on ist in Ihrem /boot/firmware/config.txt.
3. Treiber prüfen: Stellen Sie sicher, dass Sie den korrekten dtoverlay für Ihren spezifischen Controller-Chip des Bildschirms laden (z.B. ILI9341 vs. ST7789).

Q2: Kann ich eine Standard-Desktop-GUI (wie Chromium oder VLC) auf einem 3,5-Zoll-SPI-Bildschirm ausführen?

A: Theoretisch ja, praktisch nein. Der SPI-Bus verfügt einfach nicht über die nötige Bandbreite, um 320×480 Pixel mit 60 Bildern pro Sekunde zu übertragen. Die Videowiedergabe führt zu starkem Bildschirmflimmern, und die Desktop-Oberfläche wird sich extrem träge anfühlen. Für Desktop-Umgebungen oder Videos müssen Sie einen MIPI-DSI- oder HDMI-Bildschirm verwenden. SPI-Bildschirme sind für einfache, statische GUIs, Schaltflächen und Textanzeigen gedacht.

Q3: Meine Touchscreen-Klicks werden erkannt, aber der Mauszeiger bewegt sich zur gegenüberliegenden Seite des Bildschirms. Wie behebe ich das?

A: Ihre Touch-Achsen sind im Verhältnis zu Ihren Bildschirmachsen invertiert. Dies passiert, wenn Sie den Bildschirm in der Software drehen (z.B., display_lcd_rotate=2), aber die Touch-Matrix nicht anpassen. Sie müssen eine Transformationsmatrix über udev Regeln oder innerhalb Ihrer Wayfire-/X11-Konfiguration anwenden, um die X- und Y-Achsen zu vertauschen oder zu invertieren.

Q4: Überlastet ein zusätzlicher LCD-Bildschirm die Stromversorgung meines Raspberry Pi?

A: Das kann passieren, abhängig vom Pi-Modell und der Bildschirmgröße. Ein Raspberry Pi 4 oder 5 benötigt eine robuste 5,1V / 3A bis 5A Stromversorgung. Ein 3,5-Zoll-SPI-Bildschirm zieht etwa 100mA bis 150mA für seine LED-Hintergrundbeleuchtung, was die 5V-GPIO-Pins sicher bewältigen können. Ein 7-Zoll- oder 10-Zoll-Bildschirm kann jedoch 500mA bis 1A verbrauchen. Für Bildschirme größer als 5 Zoll sollten Sie den Bildschirm über eine externe, dedizierte USB-Stromversorgung betreiben, nicht über die GPIO-Pins des Pi, um eine Spannungsabsenkung (angezeigt durch das gelbe Blitzsymbol) zu vermeiden.

Q5: Ich möchte ein kommerzielles Produkt mit einem Raspberry Pi Compute Module entwickeln. Sollte ich SPI verwenden?

A: Nein. Wenn Sie zu einem kommerziellen Produkt mit einem Compute Module 4 (CM4) oder CM5 übergehen, sollten Sie die MIPI-DSI-Leitungen verlegen oder die DPI- (Parallel-) Schnittstelle auf Ihrem individuellen Trägerboard nutzen. Dies entlastet die Anzeigewiedergabe von der Hardware-GPU, befreit die CPU für die Ausführung Ihrer eigentlichen Anwendungslogik und gewährleistet flüssige, professionelle 60-FPS-Animationen.