Quelltext der Seite WSAL21229 – 8inch DSI LCD/en

__NOINDEX__
'''Documentation notice:''' This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

== Summary ==
The 8-inch DSI LCD from Waveshare is a capacitive touch display with 800×480 resolution and 5-point touch. It is driven directly by the Raspberry Pi's DSI interface, supports up to 60 Hz refresh rate, and works on several Pi models without additional drivers.

== Related products at JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL21229 WSAL21229 – 8inch Capacitive Touch Display for Raspberry Pi, DSI Interface, 800×480]

== Technical overview ==
* Resolution: 800 × 480 pixels; capacitive touch panel with 5-point detection and toughened glass (hardness 6H).
* Interface: 15-pin DSI connector for older Pi models (Pi 4B/3B+/3A+/3B/2B/B+/A+); 22-pin DSI1 connector for newer models (Pi 5/CM4/CM3+/CM3).
* Compatibility: Works with Raspberry Pi OS, Ubuntu, Kali, Volumio and Retropie without extra drivers; also supports VisionFive 2 (Debian), Tinker Board 2 (Linux/Android) and Core3566 (Debian/Ubuntu).
* Backlight brightness controllable via terminal through /sys/class/backlight/*/brightness (range 0–255).
* Display rotation: Via GUI in Trixie/Bookworm or via cmdline.txt (video=DSI-1:800x480M@60,rotate=90/180/270) in Lite versions.
* Touch rotation in older systems (Bullseye/Buster) must be configured separately via X11 settings (CalibrationMatrix in /etc/X11/xorg.conf.d/40-libinput.conf).
* DSI overlay in config.txt: dtoverlay=vc4-kms-dsi-7inch for DSI1; dtoverlay=vc4-kms-dsi-7inch,dsi0 only on Pi 5/CM4 for DSI0.
* Pre-installed image: After entering the correct dtoverlay value in config.txt, safely eject the SD card and reboot the device.
* Brightness setting via GUI: In Trixie through Control Center → Screens → DSI-2 → Brightness; in Bookworm under Screen Configuration → Screen.
* Additional hardware features: VCOM voltage adjustment resistor, pogo-pin power supply, two 5V outputs for fans etc., reversed camera hole on the touch panel.

'''Commands and examples – verify before use:''' 
<syntaxhighlight lang="text">
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-7inch
#dtoverlay=vc4-kms-dsi-7inch,dsi0
echo 100 | sudo tee /sys/class/backlight/*/brightness
echo 0 | sudo tee /sys/class/backlight/*/brightness
echo 255 | sudo tee /sys/class/backlight/*/brightness
video=DSI-1:800x480M@60,rotate=90
Option "CalibrationMatrix" "0 1 0 -1 0 1 0 0 1"
Option "CalibrationMatrix" "-1 0 1 0 -1 1 0 0 1"
Option "CalibrationMatrix" "0 -1 1 1 0 0 0 0 1"
xset dpms force off
disable_touchscreen=1
</syntaxhighlight>

== Notes and version constraints ==
* The DSI0 overlay (dtoverlay=vc4-kms-dsi-7inch,dsi0) applies only to Pi 5/CM4; it cannot be used on other models.
* For the Bookworm system on Raspberry Pi 5, it is recommended to manually update to the latest system version before booting (network connection required): sudo apt-get update &amp;&amp; sudo apt-get full-upgrade -y, then sudo reboot.
* On Bullseye/Buster, after rotating the display, touch rotation must be configured separately via X11 settings; synchronized GUI rotation is only available in Trixie/Bookworm.
* The screen-sleep command xset dpms force off works only on Bullseye and Buster according to the source.
* Changes to config.txt or cmdline.txt require a reboot to take effect.
* The exact compatibility list for other boards (VisionFive 2, Tinker Board 2, Core3566) is based solely on the source file; independent testing is recommended for confirmation.
* The display brightness is listed as 300 cd/m² in the FAQ; this is a manufacturer claim and should be verified for your own applications.

== Source and revision record ==
* [https://www.waveshare.com/wiki/8inch_DSI_LCD 8inch DSI LCD - Waveshare Wiki]
* Source revision: 109294
* Captured: 2026-09-03T02:38:15+00:00
* SHA-256: <code>3ba2bb63a60dfa16fef97ac1ec2df76b49d326154a82eb085e9095a0e939a2e1</code>