Waveshare 3.2 / 3.5 inch TFT GPIO (and clones) driver for Raspberry PI Zero to 5 on Debian 13 Trixie

works in text console, desktop and KlipperScreen.

Tested on Pi 1 to Pi 5, including Zero W and Zero2 W.

Prequisites:

Install the latest image via Raspberry Pi Imager <br>Update the system<br> sudo apt update && sudo apt upgrade -y<br> Modify the settings to your taste with sudo raspi-config<br> Wayland does not work! You have to select X11. If you are using the desktop, remember to set boot to comand line in raspi-config. Desktop autostart does not work at this moment. Start the desktop with startx as user pi, not root! After that, you may select "boot to Desktop" inside the config menu. If this does not work for you, look under Issues for a workaround.<br>

Install

sudo apt install git

git clone https://github.com/katzenjens/lcd32.git

cd lcd32

for 3.2 or 2.8 inch tft (320 x 240 px):

./install.sh

for 3.5 inch tft (480 x 320 px):

./install35.sh

restore to defaults

./restore.sh

Issues:

Desktop Autostart not working:

On some older Pi's I had issues booting to desktop. So I started with autoboot into command line. You can start the desktop from there with startx which sometimes is not practical. So I included a little snippet for .profile for the user pi. On the command line while in the lcd32 directory, type <br>cat add_startx.txt >> ~/.profile<br> to include startx at startup.

320 x 240 px 2.4 and 2.8 inch tft

Desktop is not recommended for these type of displays since some windows are not fully accessible. Not even setting defaults for small displays. Bummer...

Display and Touchscreen Rotation

Display rotation can be found here: /boot/firmware/config.txt<br> For 3,5 inch display<br> dtoverlay=waveshare35a:rotate=0 Portrait<br> dtoverlay=waveshare35a:rotate=90 Landscape<br> dtoverlay=waveshare35a:rotate=180 Inverted Portrait<br> dtoverlay=waveshare35a:rotate=270 Inverted Landscape<br> Touchscreen Rotation can be found here: /usr/share/X11/xorg.conf.d/40-libinput.conf<br> Inside the file search for Identifier "libinput touchpad catchall" and add a line<br> Option "TransformationMatrix" "0 -1 1 1 0 0 0 0 1" <br>to rotate 90°<br> or<br> Option "TransformationMatrix" "-1 0 1 0 -1 1 0 0 1"<br>to rotate 180°<br> or<br> Option "TransformationMatrix" "0 1 0 -1 0 1 0 0 1" <br>to rotate 270°<br>

For 2,4 to 3,2 inch displays (320x240) try similar tweaks. Your mileage may vary since sometimes displays are orientated landscape or portrait. Try the tweaks above until everything works.