EN

4-Zoll-IPS-Touchdisplay · Raspberry Pi

HyperTouch 4.0

Hochauflösendes IPS-Display mit kapazitivem Multi-Touch für den Raspberry Pi. Das Bild kommt über die DPI-Schnittstelle direkt vom 40-Pin-Header, ohne HDMI-Kabel und mit 60 Bildern pro Sekunde. Es passt auf jeden Raspberry Pi mit 40-Pin-Header, ein Pi Zero lässt sich auch direkt auflöten.

InstallationTreiber auf GitHub

HyperTouch 4.0 auf einem Raspberry Pi, auf dem Display der Desktop von Raspberry Pi OS mit einem Sonnenuntergang als Hintergrund
800 × 480
IPS, 350 cd/m², Blickwinkel bis 160°
DPI · 60 fps
RGB mit 18 Bit direkt über den 40-Pin-Header
Multi-Touch
kapazitiv, GT911-kompatibel, über I²C
32 Stufen
Hintergrundbeleuchtung per Single-Wire-Dimmung

Montage

Das Display wird mit der beiliegenden 40-poligen Header-Verlängerung auf den Raspberry Pi gesteckt. Löten ist dafür nicht nötig. Einen Pi Zero kann man stattdessen platzsparend direkt auf die Adapterplatine löten.

Seitenansicht: HyperTouch 4.0 über einem Raspberry Pi 4, dazwischen die schwarze Header-Verlängerung, rechts die USB- und Netzwerkbuchsen
Auf einem Raspberry Pi 4 ohne Gehäuse
  • Abstand
    20 bis 27 mmPlatine zu Platine, stufenlos. Die Header-Verlängerung muss mindestens 3 mm in der Buchse des Displays stecken, aber nicht ganz.
  • Kühlung
    Mindestens 5 mm über den USB-BuchsenJe nach Einstecktiefe 5 bis 12 mm. Das lässt beim Pi 4 Luft zur Kühlung und Platz für Gehäuse oder CPU-Kühler.
  • Schrauben
    Gespiegelte Pi-BohrungenDie Adapterplatine hat die Montagebohrungen des Raspberry Pi. Mit M2,5-Abstandshaltern (z. B. Würth Elektronik 970200154) lässt sich alles fest verschrauben.

Aufstecken

  1. Header-Verlängerung zuerst ins Display stecken, nicht in den Raspberry Pi. Sie sitzt absichtlich sehr stramm, damit sie auch bei großem Abstand stabil hält, und lässt sich danach kaum noch lösen.
  2. Bei neuerer Revision vor dem Aufkleben. Ist das Display noch nicht auf die Adapterplatine geklebt, den Header vorher einsetzen. Ist es schon aufgeklebt, beim Einstecken nicht auf das Display im Bereich des Displaykabels drücken.
  3. Auf den Raspberry Pi stecken und dabei den gewünschten Abstand einstellen.
  4. Bei Bedarf verschrauben über die gespiegelten Montagebohrungen.
Rückseite der Adapterplatine mit eingesteckter schwarzer 40-poliger Header-Verlängerung, rechts das orange Flachbandkabel des Displays
Header-Verlängerung im Display, Ansicht von der Pi-Seite
Zwei Finger halten die Header-Verlängerung zwischen Display und Raspberry Pi fest
Zum Abnehmen am Header festhalten, nicht am Display ziehen

Header im Display lassen

Die Verlängerung sollte nicht wieder aus dem Display gezogen werden. Sonst können sich einzelne Goldfederstifte lösen. Bei Verlängerungen mit variablem Abstand lässt sich das bauartbedingt nicht vermeiden. Gelöste Stifte lassen sich vorsichtig wieder in das Kunststoffteil einsetzen.

Abnehmen am Header

Soll das Display vom Raspberry Pi herunter, keine Kraft auf das Display ausüben. Die Header-Verlängerung festhalten und das Display zusammen mit ihr abziehen.

Pi Zero auflöten (für Fortgeschrittene)

Raspberry Pi Zero auf der dunkelblauen Adapterplatine des HyperTouch 4.0, daneben die Header-Verlängerung
Pi Zero auf der Adapterplatine, rechts die Header-Verlängerung

Pi-Zero-Modelle können flach auf die Adapterplatine gelötet werden, mit oder ohne Stiftleiste. Gelötet wird von der Rückseite. Dazu das Display vorsichtig von der Platine lösen, es hält mit doppelseitigem Klebeband.

Ohne Stiftleiste den Zero vorher über die Bohrungen ausrichten und fixieren, zum Beispiel mit einem Streichholz.

Nur bei dieser Montage sind auch die Lötaugen I²C 5V nutzbar, siehe Anschlüsse.

Installation

Treiber und Device-Tree-Overlays liegen auf GitHub unter shpi/hypertouch40. Der Installer baut das Kernelmodul für Hintergrundbeleuchtung und Display-Initialisierung per DKMS, trägt die Overlays in die config.txt ein und fragt Treibermodus und Drehung ab. Ausgeführt wird er auf dem Raspberry Pi, per SSH oder an einem HDMI-Monitor.

curl https://raw.githubusercontent.com/shpi/hypertouch40/main/get-hypertouch.sh | sudo bash
  1. Raspberry Pi OS installieren (32 oder 64 Bit) und den Pi mit Netzwerk starten.
  2. Befehl oben ausführen. Er installiert Git, klont das Repository nach /usr/src/hypertouch40 und startet install.sh.
  3. Treibermodus wählen: 1 KMS/DRM, empfohlen für aktuelle Systeme (auf dem Pi 5 noch Beta), oder 2 Legacy mit Framebuffer.
  4. Drehung wählen, siehe Tabelle.
  5. Neu starten.
AuswahlDrehungAusrichtung
10°Hochformat, Header rechts (Standard)
290°Querformat, Header unten
3180°Hochformat, Header links
4270°Querformat, Header oben

Von Hand

Ohne den Einzeiler: Repository klonen und den Installer direkt starten.

git clone https://github.com/shpi/hypertouch40.git
cd hypertouch40
sudo ./install.sh

32 oder 64 Bit, aber nicht gemischt

Unterstützt werden Raspberry Pi OS mit 32 Bit (armhf) und mit 64 Bit (arm64). Ein 32-Bit-System mit 64-Bit-Kernel oder umgekehrt erkennt der Installer und bricht ab, weil DKMS dafür kein Modul bauen kann. Wer beim 32-Bit-System bleiben will, setzt in der config.txt arm_64bit=0 und startet neu.

Ältere Installation aktualisieren

Einfach install.sh erneut ausführen. Veraltete Einträge wie dtparam=addr= und gpio=27=pu bzw. gpio=27=pd entfernt er selbst. Eine Touch-Adresse muss nicht mehr gewählt werden.

Deinstallieren

Entfernt Kernelmodul, Overlays, alle HyperTouch-Einträge der config.txt (Sicherung als config.txt.bak) und die Drehungs-Helfer. Danach neu starten.

sudo /usr/src/hypertouch40/install.sh --uninstall

Helligkeit und Drehung

Helligkeit

Die Hintergrundbeleuchtung hängt an einem Diodes AL3050, der über eine einzige Leitung (GPIO 19) gedimmt wird. Der Treiber meldet sie als Linux-Backlight mit den Stufen 0 bis 31.

echo 31 | sudo tee /sys/class/backlight/soc:backlight/brightness

Fehlt der Pfad soc:backlight, zeigt ls /sys/class/backlight/ den richtigen Namen.

Drehung

Drehung ändern

Installer erneut ausführen und eine andere Drehung wählen. Bild und Touch werden dabei passend zueinander eingestellt.

KMS

Der Touch bleibt in seiner Grundausrichtung. Der Installer schreibt eine Wayfire-Zuordnung für den Ausgang DPI-1 und legt einen Autostart-Helfer an, der in anderen Sitzungen wlr-randr oder xrandr verwendet.

Legacy

Der Installer setzt display_lcd_rotate= und die passenden Achsen des Touchscreens in der config.txt.

Fehlersuche

Touch reagiert nicht

Die Nummer des Software-I²C-Busses kann von System zu System abweichen. Erst die Busse auflisten, dann den Bus mit dem Namen i2c-ht40 scannen:

i2cdetect -l
i2cdetect -y <Busnummer>

Der Touchcontroller erscheint als UU (vom Treiber belegt) bei 0x14 oder 0x5d.

Zwei mögliche Touch-Adressen

Der GT911 übernimmt seine Adresse beim Einschalten vom Pegel an GPIO 27. Sein Reset liegt fest an 3,3 V, Software kann ihn also nicht neu starten. Die Adresse kann sogar zwischen Kaltstart und Neustart wechseln. Die Overlays tragen deshalb beide Adressen ein, der Kernel bindet die, die antwortet.

Harmlose Meldungen

Für die jeweils andere Adresse steht in dmesg ein kurzer Fehlerblock, zum Beispiel Goodix-TS 22-005d: I2C communication failure: -6. Die Zeile Goodix-TS 22-0014: ID 911, … zeigt dann, dass der Touch läuft. Auch mehrere vc4-drm gpu: bound … beim Start sind normal.

„Pin already requested“

DPI braucht fast alle GPIOs. Der Installer schaltet deshalb dtparam=i2c_arm=on (Pins 2 und 3) und enable_uart=1 (Pins 14 und 15) ab. Werden sie wieder eingeschaltet, können Display oder Touch ausfallen.

Fehler mit Kernel-Headern oder DKMS

Meist passen System und laufender Kernel nicht zusammen (32/64 Bit gemischt). Ein passendes Image verwenden oder beim 32-Bit-System arm_64bit=0 setzen, neu starten und den Installer wiederholen.

Hilfe

Hilft das alles nicht, schreiben Sie an lh@shpi.de, am besten mit Modell des Raspberry Pi, Version von Raspberry Pi OS und der Ausgabe von dmesg.

Anschlüsse

Das Display belegt fast den ganzen 40-Pin-Header. Das Bild läuft parallel über 18 Datenleitungen und vier Steuerleitungen (DPI), der Touch über einen Software-I²C-Bus an GPIO 10 und 11.

FunktionGPIOPinPinGPIOFunktion
3,3 V–12–5 V
DPI V-Sync234–5 V
DPI H-Sync356–GND
DPI Blau 247814DPI Grün 4
GND–91015DPI Grün 5
DPI Grün 717111218Display Chip-Select
Touch-Interrupt271314–GND
DPI Rot 422151623DPI Rot 5
3,3 V–171824DPI Rot 6
I²C SDA (Touch)101920–GND
DPI Blau 79212225DPI Rot 7
I²C SCL (Touch)1123248DPI Blau 6
GND–25267DPI Blau 5
DPI Pixeltakt027281DPI Data Enable
DPI Blau 352930–GND
DPI Blau 46313212DPI Grün 2
DPI Grün 3133334–GND
Hintergrundbeleuchtung19353616DPI Grün 6
Display-Daten (SPI)26373820DPI Rot 2
GND–394021DPI Rot 3

Bilddaten (DPI)Steuerung, Touch, BeleuchtungVersorgungMasse

GPIO 18, 26 und 27 initialisieren beim Start den Displaycontroller (Chip-Select, Daten, Takt). GPIO 27 ist danach der Interrupt des Touchcontrollers. Deshalb lädt der Installer das Modul hypertouch40 immer vor dem Goodix-Touchtreiber.

I²C-Lötaugen

Rendering der Adapterplatine: links der Displaystecker mit Widerstandsreihe, in der Mitte die 40-polige Buchse, rechts unten die Lötaugen I²C 3.3V und I²C 5V, Schriftzug HyperTouch+ 4.0 single wire dimming
Adapterplatine, Seite zum Raspberry Pi (Rendering)
  • I²C 3.3V
    3,3 V · GND · SDA · SCLHängt am Software-I²C-Bus des Touchcontrollers (GPIO 10 und 11, Pull-ups auf der Platine). Hier können weitere I²C-Bausteine angeschlossen werden, deren Adressen nicht 0x14 oder 0x5d sind.
  • I²C 5V
    5 V · GND · SDA · SCLNur nutzbar, wenn ein Pi Zero aufgelötet ist.
  • Bohrungen
    Raster 2,54 mmFür eine Stiftleiste oder direkt angelötete Adern.

Schaltplan

Der Schaltplan ist in KiCad neu gezeichnet, auf zwei A4-Seiten. Grundlage sind der Eagle-Plan von 2021 und die Platine: Alle Verbindungen sind mit der Platine abgeglichen, die Werte entsprechen der Fertigungsstückliste. Ein Klick öffnet die Seite in voller Größe.

Schaltplan Seite 1: links die 40-polige Raspberry-Pi-Buchse U$2 und die Pi-Zero-Lötpads U$1, rechts die 23 Serienwiderstände und der 45-polige Displaystecker CON1
Seite 1: Raspberry Pi, Pi-Zero-Pads, Serienwiderstände, Displaystecker
Schaltplan Seite 2: Hintergrundbeleuchtung mit AL3050 und Spule L6, Touchstecker CON4 mit Pull-ups und RC-Reset, I²C-Lötaugen
Seite 2: Hintergrundbeleuchtung, Touch, I²C-Lötaugen

PDF, 2 Seiten A4Seite 1 (SVG)Seite 2 (SVG)

Bildsignale

18 Farbleitungen (R2–R7, G2–G7, B2–B7), Pixeltakt, Data Enable, H- und V-Sync laufen vom Pi-Header über je einen Serienwiderstand mit 33 Ω zum 45-poligen Displaystecker CON1 (Hirose FH12-45S-0.5SH, Raster 0,5 mm). Die Widerstände dämpfen Reflexionen auf den schnellen Leitungen.

Displaystecker

Die Pinnamen von CON1 folgen dem Panel-Datenblatt (TXW397017S4-AS). Die 6 Bit je Farbe vom Pi liegen an den Panel-Pins R5–R0, G5–G0 und B5–B0, die Bits 7 und 6 jeder Farbe liegen auf GND.

Display-Initialisierung

Der Displaycontroller ILI9806E wird beim Start per SPI eingestellt: Chip-Select auf GPIO 18 (CS_DISPLAY), Daten auf GPIO 26 (MOSI), Takt auf GPIO 27. Display und Touchcontroller bekommen ihren Reset gemeinsam über das RC-Glied R5/C1 (4,7 kΩ, 4,7 µF) an 3,3 V.

Hintergrundbeleuchtung

U14 (Diodes AL3050) ist ein Aufwärtswandler für die LED-Kette des Displays. Er arbeitet aus 5 V mit der Spule L6 (22 µH) und liefert VLED+ an CON1-2. Der LED-Strom fließt über VLED− (CON1-1) und R3 (8 Ω) nach Masse. R3 legt ihn über den FB-Eingang fest. GPIO 19 dimmt über R72 (33 Ω) am Eingang CTRL.

Touch

Der Touchcontroller hängt am 8-poligen Stecker CON4 (Omron XF2L-0835-1). SDA und SCL (GPIO 10 und 11) haben Pull-ups mit 4,7 kΩ (R1, R2), der Interrupt auf GPIO 27 einen mit 1 MΩ (R4). Versorgt wird er mit 3,3 V, gestützt von C5.

Pi Zero und R43

Die Lötpads U$1 für einen Pi Zero sind parallel zur Buchse U$2 angeschlossen. Nur Pin 13 geht dort über R43 auf den Touch-Interrupt, die Buchse direkt. Im alten Eagle-Plan standen für die Serienwiderstände noch 604 Ω und für R72 30 Ω, bestückt sind 33 Ω.

Stückliste

Bauteile wie bestückt, laut Fertigungsstückliste von 2021.

RefAnz.WertAufgabeBauteilLCSC
U141–LED-Treiber, AufwärtswandlerDiodes AL3050FDC-7, U-DFN2020-6–
L6122 µH, 300 mASpule für U14GCNR4018-220MC (NR4018)–
R14, R15, R23–R432333 ΩSerienwiderstände Bildsignale und Touch-Interrupt0402C25105
R72133 ΩDimm-Eingang CTRL0402C25105
R318,06 Ω, 1 %LED-StromYageo RC0402FR-078R06L–
R1, R2, R534,7 kΩPull-ups SDA, SCL, Reset0402C25900
R411 MΩPull-up Touch-Interrupt0402WGJ0105TCE–
C1, C2, C4, C544,7 µFReset-Verzögerung, 5 V, 3,3 V0402C23733
C311 µF, 25 VLED-Spannung VLED+0402C52923
CON1145-polig, 0,5 mmDisplaysteckerHirose FH12-45S-0.5SHC376072
CON418-poligTouchsteckerOmron XF2L-0835-1C376058
U$212 × 20, 2,54 mmBuchse zum Raspberry PiBuchsenleiste, 8,5 mm hoch–

Technische Daten

Display
Typ4 Zoll IPS-TFT, 800 × 480 Pixel, kapazitiver Touchscreen
Aktive Fläche86,4 × 51,84 mm
Helligkeit350 cd/m²
Blickwinkelmax. 160°
Display-ICIlitek ILI9806E
Schnittstellen
BildDPI, RGB 18 Bit, 60 fps
TouchMulti-Touch, Goodix GT911-kompatibel, I²C an GPIO 10/11, Adresse 0x14 oder 0x5d
HintergrundbeleuchtungDiodes AL3050, Single-Wire-Dimmung an GPIO 19, 32 Stufen
Elektrik
Versorgungüber den Raspberry Pi: 5 V für die Hintergrundbeleuchtung, Logik 3,3 V
Isolierungkeine
Mechanik
Abmessungen98 × 59 × 15 mm
Gewichtmax. 80 g
MaterialLeiterplatte FR4, IPS-Display
MontageHeader-Verlängerung, Abstand 20–27 mm · gespiegelte Pi-Montagebohrungen für M2,5 · Pi Zero auflötbar
Umgebung
Betrieb0 … +40 °C
Lagerung−25 … +70 °C
Relative Feuchte5 … 93 %, nicht kondensierend
KlimabeständigkeitEN 50090-2-2
Konformität
CEEMV-Richtlinie 2014/30/EU, RoHS-Richtlinie 2011/65/EU
NormenEN 55032:2012 Klasse B · EN 55024:2010 · EN 61000-3-2:2014 · EN 61000-3-3:2013 · EN 63000:2018 · EN 62368-1:2018
Lieferumfang
EnthaltenDisplay mit Touchscreen und Adapterplatine · 40-polige Header-Verlängerung zum Aufstecken

Downloads

Die Treiberhinweise in den PDFs von 2022 (Touch-Adresse in hypertouch40.dts ändern, display_rotate) sind überholt. Es gilt die Installation auf dieser Seite.