Setup: Troubleshooting

Whitescreen

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"
   EndSection
   

   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

1. Download and install the plugin SnapStream (also available in the plugin manager)
2. Configurate the settings:

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

   2. If that didn't work, then try http://pi-ip-adrress:8080/webcam/?action=snapshot
      If this works, then replace /webcam/?action=snapshot with http://pi-ip-adrress:8080/webcam/?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

Calibration

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 curl -sLS https://apt.adafruit.com/add | sudo bash
3. Run sudo apt-get install -y xinput-calibrator
4. Run sudo xinit ~/TouchUI-autostart/calibration.xinit*
5. Follow the calibration steps
6. After you completed step 6, pay attention to your command line, because it will show a wall of text with at the bottom instructions, please copy Section until Endsection and follow step 7
7. Exit by pressing CTR-C
8. Run sudo nano /etc/X11/xorg.conf.d/99-calibration.conf and replace the file with the copied Section code from step 6.
9. Save (CTR-O, Enter, CTR-X)
10. Reboot

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

Calibration rotate touchscreen

1. Update your bootloader!.
2. Read the instructions from https://wiki.ubuntu.com/X/InputCoordinateTransformation
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/calibration.sh
6. Edit the new file nano ~/TouchUI-autostart/calibration.sh
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