Setup: Troubleshooting

eboston edited this page Sep 9, 2018 · 25 revisions


This indicates your driver is not working, please consult your touchscreen maker for installation instructions.

Boots to Blackscreen

X11 is using the wrong framebuffer for displaying TouchUI.

  1. Run sudo nano /etc/X11/xorg.conf.d/99-fbdev.conf
    if file/path does not exist then create it

  2. Find the following code:

    Section "Device"  
      Identifier "touchscreen"
      Driver "fbdev"
      Option "fbdev" "/dev/fb1"

    if not found, paste the code into the file
    if found, replace /dev/fb1 into /dev/fb0 or /dev/fb0 into /dev/fb1

  3. Save & Exit (CTR-O, ENTER, CTR-X)

  4. Run sudo chmod +x /etc/X11/xorg.conf.d/99-fbdev.conf

  5. Reboot

Inverted touch Y/X axis

  1. Make sure you followed the Calibration part first!

  2. Edit the calibration file you made sudo nano /etc/X11/xorg.conf.d/99-calibration.conf

  3. Add the following line before the EndSection that you copied from the calibration:

    For inverting horizontal axis

    Option "InvertX" "true"

    For inverting vertical axis

    Option "InvertY" "true"

Webcam image not working

Configurate the webcam settings as followed:
if you're using OctoPi you could also use octopi.local

  1. Open a browser and type http://<pi-ip-address>:8080/webcam/?action=snapshot.
    If this works, then replace /webcam/?action=snapshot with http://<pi-ip-address>:8080/webcam/?action=snapshot and save

  2. If that didn't work, then try <pi-ip-address>:8080/?action=snapshot
    If this works, then replace /webcam/?action=snapshot with http://<pi-ip-address>:8080/?action=snapshot and save

Disabling screensaver

  1. Make sure your bootloader is updated.
  2. Edit TouchUI default file: sudo nano /etc/default/touchui
  3. Add or change the variable DISABLE_SCREENSAVER=false to DISABLE_SCREENSAVER=true
  4. Save (CTR-O, Enter, CTR-X)
  5. Restart TouchUI sudo service touchui restart


Please consult your touchscreen maker for better details. These steps below work on a Waveshare 3.5

Calibration touch location

  1. Stop TouchUI with sudo service touchui stop
  2. Run sudo apt-get install -y xinput-calibrator
  3. Run sudo xinit ~/TouchUI-autostart/calibration.xinit*
  4. Follow the calibration steps
  5. After you completed step 4, pay attention to your command line, because it will show a wall of text with at the bottom instructions, copy Section to Endsection
  6. Exit by pressing CTR-C
  7. Run sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf and replace the file with the copied Section code from step 5.
  8. Save (CTR-O, Enter, CTR-X)
  9. Reboot

* if the file does not exist, update your bootloader!.

Calibration rotate touchscreen

  1. Update your bootloader!.
  2. Read the instructions from
  3. Run sudo apt-get install xinput
  4. To get your device name run FRAMEBUFFER=/dev/fb1 & DISPLAY=:0.0 xinput list
    use /dev/fb0 if you're using HDMI or the Official RPI display
  5. Create a new file touch ~/TouchUI-autostart/
  6. Edit the new file nano ~/TouchUI-autostart/
  7. Copy su $TOUCHUI_USER -c "xinput set-prop 'YOUR DEVICE NAME' 'Coordinate Transformation Matrix' 0 1 0 -1 0 1 0 0 1"
  8. Replace 'YOUR DEVICE NAME' and the coordinates with the instructions from the ubuntu wiki.
  9. Save & Exit (CTR-O, ENTER, CTR-X)
  10. Reboot
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.