WSAL21687 – 4inch DSI LCD

Dokumentationshinweis: Diese technische Dokumentation wurde aus einer archivierten Lieferantenquelle neu formuliert. Technische Angaben und Befehle müssen vor der Verwendung mit der Produktversion und den Herstellerunterlagen abgeglichen werden.

Zusammenfassung

Das Waveshare 4-Zoll-DSI-LCD (WSAL21687) ist ein kapazitiver Touchscreen mit IPS-Panel, Auflösung 480×800 und optischem Bonding. Es wird über die DSI-Schnittstelle direkt an einem Raspberry Pi betrieben und unterstützt Pi5/CM5/4B/3B+/3A+/3B/CM3+/CM3 sowie Bookworm-, Bullseye- und Buster-Betrieb.

Zugeordnete Produkte bei JW Tech

WSAL21687 – 4-Zoll-Kapazitiver Touchscreen für Raspberry Pi, 480×800, DSI-Schnittstelle, IPS, optisch gebundener Bildschirm

Technische Übersicht

Auflösung: 480×800 Pixel; IPS-Panel mit optischem Bonding für bessere Bildqualität.
Fünf-Punkt-kapazitiver Touch mit gehärtetem Glas (Härtegrad bis 6H).
Anschluss über DSI1 (empfohlen) oder DSI0 je nach Board; bei Pi5/CM4/CM3+/CM3 gibt es zwei MIPI-DSI-Schnittstellen.
Unterstützte Boards: Pi5, CM5, 4B, CM4, 3B+, 3A+, 3B, CM3+, CM3.
Betriebssysteme: Bookworm, Bullseye und Buster werden unterstützt.
Für Bookworm/Bullseye: dtoverlay=vc4-kms-dsi-waveshare-panel,4_0_inch in config.txt eintragen; Standard ist DSI1.
Für Buster: Treiber aus dem Waveshare-DSI-LCD-Repository installieren (z. B. WS_xinchDSI_MAIN.sh 40 I2C0) oder vorgefertiges Image verwenden.
Display-Drehung über GUI-Einstellungen (Screen Configuration → Screen → DSI-1/DSI-2); synchronisierte Drehung von Display und Touch wird laut Quelle nur auf Trixie vollständig unterstützt.
Leuchtdichte der Hintergrundbeleuchtung kann per Software gesteuert werden.
Maximale Aktualisierungsrate über DSI: 60 Hz.

Befehle und Beispiele – vor Ausführung prüfen:

dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-waveshare-panel,4_0_inch
git clone https://github.com/waveshare/Waveshare-DSI-LCD
cd Waveshare-DSI-LCD
sudo bash ./WS_xinchDSI_MAIN.sh 40 I2C0
sudo reboot
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=1,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy,I2C_bus=10

Hinweise und Versionsgrenzen

Die exakte Kernelversion muss vor der Treiberinstallation geprüft werden (uname -a); die Quelle verweist z. B. auf das Unterverzeichnis 6.1.21 – andere Kernelversionen erfordern eine passende Verzeichniswahl.
Bei Systemupdates unter Buster können bereits installierte Treiberdateien überschrieben werden; danach muss der Treiber neu installiert werden.
Beim Wechsel des Motherboards (z. B. von Pi4B auf Pi3B+) müssen die passenden Treiber erneut installiert werden.
Die synchrone Drehung von Display und Touch wird laut Quelle nur vollständig auf Trixie unterstützt; auf Bookworm/Buster sind die Einstellpfade anders.
Der DIP-Schalter ist ab Werk auf I2C-0 eingestellt; für den 40-Pin-I2C-Port (I2C-1) muss der Schalter umgestellt und ein 4-PIN-Header verwendet werden.
Vorsicht vor Nachahmungen: Die Quelle warnt vor ungetesteten Kopien ohne Support – Originalität sollte vor Kauf überprüft werden.

Quelle und Revisionsnachweis

4inch DSI LCD - Waveshare Wiki
Quellrevision: 105336
Erfasst: 2026-09-03T03:15:24+00:00
SHA-256: 1e79e96d8de4aa18d44768b0a3943e36c379f77a56976f9e998feb76c31c93fb