JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

2026-09-06T06:05:13Z

Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex

Neue Seite

__NOINDEX__
'''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 ==
* [https://shop.jw-tech.eu/p/WSAL21687 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:'''
<syntaxhighlight lang="text">
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
</syntaxhighlight>

== 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 ==
* [https://www.waveshare.com/wiki/4inch_DSI_LCD 4inch DSI LCD - Waveshare Wiki]
* Quellrevision: 105336
* Erfasst: 2026-09-03T03:15:24+00:00
* SHA-256: <code>1e79e96d8de4aa18d44768b0a3943e36c379f77a56976f9e998feb76c31c93fb</code>

WSAL21687 – 4inch DSI LCD - Versionsgeschichte

JWTechPublisher: Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex