Quelltext der Seite WSAL22028 – 2.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 2.8inch DSI LCD (WSAL22028) is a capacitive touch display with an IPS panel, 480×640 resolution and optical bonding. It is driven directly by the Raspberry Pi via the DSI interface and supports Bookworm, Bullseye and Buster systems across several Pi models.

== Related products at JW Tech ==
* [https://shop.jw-tech.eu/p/WSAL22028 WSAL22028 – 2.8inch Capacitive Touch Display for Raspberry Pi, 480×640, DSI, IPS, Optical Bonding Screen]

== Technical overview ==
* Resolution: 480×640 pixels; display technology: IPS; touch: five-point capacitive touch system
* Optical bonding process improves panel image quality
* Touch surface made of toughened glass with hardness up to 6H
* Supported boards: Pi5/CM5, 4B/CM4, 3B+/3A+, 3B, CM3+/CM3
* Connection via DSI interface; newer models offer two MIPI DSI ports – default recommendation: DSI1
* Maximum refresh rate: 60 Hz
* Software control of backlight brightness is supported
* Supported operating systems: Bookworm, Bullseye, Buster

'''Commands and examples – verify before use:''' 
<syntaxhighlight lang="text">
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-waveshare-panel,2_8_inch
sudo bash ./WS_xinchDSI_MAIN.sh 28 I2C0
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=0,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=10
wlr-randr --output DSI-2 --off
wlr-randr --output DSI-2 --on
xset dpms force off
disable_touchscreen=1
</syntaxhighlight>

== Notes and version constraints ==
* On Pi5/CM5/CM4/CM3+/CM3 there are two MIPI DSI interfaces; it must be ensured that the correct interface and matching dtoverlay commands are used – the default recommendation is DSI1
* The configuration files mentioned in the source (config.txt, cmdline.txt) reside in the root directory of the TF card or under /boot/; changes only take effect after reboot
* The wlr-randr command applies only to Labwc/Wayfire graphical interfaces; xset dpms force off only to X11
* For Buster systems, a system update may overwrite previously installed driver files; the DSI driver then has to be reinstalled
* When changing the board (e.g., from Pi4 to Pi3), the drivers must be reconfigured for the new board
* Synchronous rotation of display and touch is only supported on Trixie/Bookworm; on Bullseye/Buster the touch rotation must be set manually and separately
* All steps listed assume a working internet connection (e.g., for the manual driver installation path)
* No information on price, availability, warranty or certifications is present in the source; these values were deliberately not included

== Source and revision record ==
* [https://www.waveshare.com/wiki/2.8inch_DSI_LCD 2.8inch DSI LCD - Waveshare Wiki]
* Source revision: 110978
* Captured: 2026-09-03T03:35:50+00:00
* SHA-256: <code>cfa612a273cb7e3ccb09e51aa7a7c93ed71c6859bc5b716e80c3b1b351cf4b9f</code>