Official Raspberry Pi 5inch Capacitive Touch Display 2 not working.

[LuleHF]

Hi
Thank you for an excellent system.
I am putting a new system together and i wanted to use the "Official Raspberry Pi 5inch Capacitive Touch Display 2" but i cant get it to show anything.
I have tested the display with Raspberry pi OS and it works so i know it is properly connected.
I have tried pacman -Syu and pacman -Syu raspberrypi-utils. It did not have any effect.

I would very much appreciate any suggestions.

firefox 146.0.1-1

cat /srv/http/data/system/localbrowser.conf

rotate=90
zoom=100
screenoff=0

systemctl status localbrowser

● localbrowser.service - Browser on RPi
Loaded: loaded (/etc/systemd/system/localbrowser.service; enabled; preset: disabled)
Active: active (running) since Fri 2026-01-02 16:11:49 CET; 17min ago
Invocation: f24371e33e9f465aba859dff4646fbc6
Main PID: 1204 (startx)
Tasks: 215 (limit: 2164)
CPU: 28.788s
CGroup: /system.slice/localbrowser.service
├─1204 /bin/sh /usr/bin/startx /srv/http/bash/startx.sh
├─1256 xinit /srv/http/bash/startx.sh -- /etc/X11/xinit/xserverrc :0 -auth /tmp/serverauth.fM60YqeO2q
├─1261 /usr/lib/Xorg -nolisten tcp :0 -auth /tmp/serverauth.fM60YqeO2q
├─1637 /bin/bash /srv/http/bash/startx.sh
├─1638 /bin/bash /srv/http/bash/settings/features.sh startx
├─1666 matchbox-window-manager -use_cursor no
├─1671 /usr/bin/dbus-daemon --syslog --fork --print-pid 4 --print-address 6 --session
├─1673 /usr/lib/firefox/firefox -kiosk -private http://localhost
├─1735 /usr/lib/firefox/firefox -contentproc -ipcHandle 0 -signalPipe 1 -initialChannelId {a7dfb49b-7879-4cb7-a396-6c93780ed988} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 1 forkserver
├─1753 "/usr/lib/firefox/firefox -contentproc -parentBuildID 20251219034254 -prefsHandle 0:36281 -prefMapHandle 1:275689 -sandboxReporter 2 -chrootClient 3 -ipcHandle 4 -initialChannelId {9fa81cd6-109a-4e9e-b1f1-56d4ef181995} -parentPid 1673 -appDir /usr/lib/firefox/browser 2 socket"
├─1761 /usr/lib/at-spi-bus-launcher
├─1787 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:31965 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {5e0b166d-f669-45c7-b10b-a963d18c32e6} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 3 tab"
├─1797 "/usr/lib/firefox/firefox -contentproc -parentBuildID 20251219034254 -prefsHandle 0:36471 -prefMapHandle 1:275689 -sandboxReporter 2 -chrootClient 3 -ipcHandle 4 -initialChannelId {f8211eef-527c-4890-94e8-217769d1c347} -parentPid 1673 -appDir /usr/lib/firefox/browser 4 rdd"
├─1830 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:31965 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {b8fa7e9b-4859-47a8-be9b-f03d3a6dd850} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 5 tab"
├─1836 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:31965 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {06fda3b8-9a7b-496c-8790-c049b6266426} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 6 tab"
├─1842 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:31965 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {35290e00-eac6-4936-b6ba-32974ef4d032} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 7 tab"
├─1891 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:46234 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {d4f8bc82-3d05-4cd1-86db-9237f36a2e0a} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 8 tab"
├─2027 "/usr/lib/firefox/firefox -contentproc -parentBuildID 20251219034254 -sandboxingKind 0 -prefsHandle 0:47255 -prefMapHandle 1:275689 -sandboxReporter 2 -chrootClient 3 -ipcHandle 4 -initialChannelId {a6be4e0f-679f-4fa8-99ad-a5622ff7d782} -parentPid 1673 -appDir /usr/lib/firefox/browser 9 utility"
└─2039 "/usr/lib/firefox/firefox -contentproc -isForBrowser -prefsHandle 0:47255 -prefMapHandle 1:275689 -jsInitHandle 2:223356 -parentBuildID 20251219034254 -sandboxReporter 3 -chrootClient 4 -ipcHandle 5 -initialChannelId {7beb865f-a262-40e7-9cc4-560cf802ffe6} -parentPid 1673 -greomni /usr/lib/firefox/omni.ja -appomni /usr/lib/firefox/browser/omni.ja -appDir /usr/lib/firefox/browser 10 tab"

Jan 02 16:11:51 rAudio sudo[1642]: pam_unix(sudo:session): session closed for user root
Jan 02 16:11:51 rAudio sudo[1645]: root : PWD=/ ; USER=root ; COMMAND=/usr/bin/xset dpms 0 0 0
Jan 02 16:11:51 rAudio sudo[1645]: pam_unix(sudo:session): session opened for user root(uid=0) by (uid=0)
Jan 02 16:11:51 rAudio sudo[1645]: pam_unix(sudo:session): session closed for user root
Jan 02 16:11:51 rAudio sudo[1648]: root : PWD=/ ; USER=root ; COMMAND=/usr/bin/xset -dpms
Jan 02 16:11:51 rAudio sudo[1648]: pam_unix(sudo:session): session opened for user root(uid=0) by (uid=0)
Jan 02 16:11:51 rAudio sudo[1648]: pam_unix(sudo:session): session closed for user root
Jan 02 16:11:56 rAudio dbus-daemon[1671]: [session uid=0 pid=1669 pidfd=5] Activating service name='org.a11y.Bus' requested by ':1.0' (uid=0 pid=1673 comm="/usr/lib/firefox/firefox -kiosk -private http://lo")
Jan 02 16:11:56 rAudio dbus-daemon[1671]: [session uid=0 pid=1669 pidfd=5] Successfully activated service 'org.a11y.Bus'

[LuleHF]

Hi,
I have made some progress and the screen is no longer black. i have edited the /boot/config.txt file and added dtoverlay for the screen. this brings up the picture but it seems to conflict with my Hifiberry Amp2 hat. There is no sound and the volume wheel on the screen has disappeared. When connecting via computer browser I get the same picture.

This is my /boot/config.txt.
disable_overscan=1
disable_splash=1
#display_auto_detect=1
dtoverlay=hifiberry-dacplus
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-ili9881-5inch
force_eeprom_read=1
hdmi_ignore_hotplug=1

Thank you!

[LuleHF]

New update,

I have managed to get both sound and picture but the screen does not seem to update and the touch function does not map with the controls on the screen.

Here is my new boot/config.txt.
disable_overscan=1
disable_splash=1
dtoverlay=hifiberry-dacplus
dtparam=i2s=on
hdmi_ignore_hotplug=1
display_auto_detect=1
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-ili9881-5inch,rotation=90

I also have set the rotation in Ui Browser settings to 90 CW
After editing the config.txt i had to go to Player/Output and select HIFIBerry Dac+ HIFI

[LuleHF]

I think I cracked it.

Her is my settings for getting Raspberry Pi 5inch Capacitive Touch Display 2 working on my system.
rAudio 20250822
6.12.42-1-rpi aarch64
20250808-1
Raspberry Pi 4B Rev 1.5

boot/config.txt

disable_overscan=1
disable_splash=1
dtoverlay=hifiberry-dacplus
dtparam=i2s=on
# hdmi_force_hotplug=1
hdmi_ignore_hotplug=1
display_auto_detect=1
dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-ili9881-5inch

/boot/cmdline.txt

root=PARTUUID=f49deebb-02 rw rootwait plymouth.enable=0 dwc_otg.lpm_enable=0 ipv6.disable=1 fsck.repair=yes isolcpus=3 console=tty3 quiet loglevel=0 logo.nologo vt.global_cursor_default=0 video=DSI-1:720x1280@60,rotate=180

[rern]

Thank you for sharing.
This setting will be included in the next update. Please try the UPDATE if you know how.

By the way, someone with Raspberry Pi Touch Display (1st gen.) - please confirm whether any manual settings needed.

[LuleHF]

Hello rern!

I started fresh with a clean install of 20251109 then updated to 20260111 and i did the settings in the gui and the screen did startup, touch and cover art is working after a power cycle.
Settings:
System / Displays /monitor / Raspberry Pi Touch Display 2
Features / Browser / Rotation 90 CW, Zoom% 170, Screen off 0

Thank you.

[R101G]

@rern

I have a 7" touch display, and I have to manually copy shutdown.sh content to /lib/systemd/system-shutdown to turn off the back light.

In portrait mode (rotate 90°), the touch functions are not rotated, and some cover art is oversized unless a volume control is displayed (same problem as the web display.)

[mcisysdev]

The settings so far, at least for 90 and 270 degrees, don't work.

I came across a lot of post, where people tried to get it work setting 'rotate=', 'rotation=' or 'panel_orientation=' in 'cmdline.txt' or 'config.txt' or combinations of it in both files.
I did extensive tests for my own kiosk application, but unfortunately no configuration solved my problem.
The display hardware does not support rotations of 90 and 270 degrees, this functionality is just not built in.
It's up to graphics subsystem to do the job. Setting the orientation of the console with driver parameters works as intended, but framebuffer drivers, the X server or Wayland tend to ignore rotations not done natively by hardware. Where 'tend' means depending on the setup of your system, you get the wanted result or you don't get it.
Finally I kicked out the 'rotate=' stuff and ended up using xrandr and xinput.

Now to rAudio - I recognized my matrices being different from those used by rAudio.
Which lead me to the following solution:

1. Don't add a 'video=' parameter to '/boot/cmdline.txt'.
2. Add 'dtoverlay=vc4-kms-dsi-ili9881-7inch' to /boot/config.txt, without ',rotation='
3. Edit '/srv/http/bash/settings/features.sh' to include the display settings
   Place the code in section 'localbrowser )' , right before the 'else # html' condition.

   elif grep -q ili9881-7inch /boot/config.txt; then
        case $ROTATE in
            0 )   rotate=NORMAL;;
            90 )  rotate=CW  && matrix='0 1 0 -1 0 1 0 0 1';;
            180 ) rotate=UD  && matrix='-1 0 1 0 -1 1 0 0 1';;
            270 ) rotate=CCW && matrix='0 -1 1 1 0 0 0 0 1';;
        esac
        if [[ $R_CHANGED ]]; then
            rotateconf=/etc/X11/xorg.conf.d/99-raspi-rotate.conf
            if [[ $ROTATE == 0 ]]; then
                rm -f $rotateconf
            else
                sed "s/ROTATION_SETTING/$rotate/; s/MATRIX_SETTING/$matrix/" /etc/X11/xinit/rotateconf > $rotateconf
            fi
                splashrotate
            fi
    
    else # html

Notes: I hard coded the path, using 'grep -q ili9881-7inch $config_file' did not work. In the UI I can't switch to 'NORMAL' rotation, the OK button stays greyed out.

Additional information:

The official Touch Display 2 has another major issue, the touch functionality is lost after reboot.
https://forums.raspberrypi.com/viewtopic.php?t=389937&sid=587e7cd704117813bdd2e2e26bfe34ca#p2355171
You need to setup a system service to solve that problem. This is a workaround, to my knowledge there is no final solution.

You can control the brightness using the code below, the display-number depends on your setup.

echo <value> | sudo tee /sys/class/backlight/<display-number>/brightness
e.g.
echo 25 | sudo tee /sys/class/backlight/6-0045/brightness