964ae7986f
Also configuration file clarifications, and other minor updates. Co-authored-by: jordanruthe <31575189+jordanruthe@users.noreply.github.com>
64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
# Troubleshooting
|
|
|
|
This page will have common problems and common solutions to those problems.
|
|
|
|
## First Steps
|
|
|
|
The first step to troubleshooting any problem is getting the cause of the error. KlipperScreen log output will occur
|
|
in two places. Check for the file `/tmp/KlipperScreen.log` and look at the contents by running
|
|
`cat /tmp/KlipperScreen.log` or grabbing the file over WinSCP or another scp program.
|
|
|
|
If that file is non-existent, there is a problem in KlipperScreen starting up. To get the error output in this case,
|
|
run `journalctl -xe -u KlipperScreen`.
|
|
|
|
|
|
## Common Errors
|
|
|
|
### Problems occurring before the log file appears
|
|
|
|
This section will detail problems that may happen before the log file has been created. Each section will start with a
|
|
relevant line from the journalctl output.
|
|
|
|
#### Cannot open virtual Console
|
|
```
|
|
xf86OpenConsole: Cannot open virtual console 2 (Permission denied)
|
|
```
|
|
|
|
* Check /etc/X11/Xwrapper.conf
|
|
This should have the line `allowed_users=anybody` in it
|
|
* Check /etc/group
|
|
Run the command `cat /etc/group | grep tty`. If your username is not listed under that line, you need to add it with the
|
|
following command (if your username is not 'pi' change 'pi' to your username):
|
|
`usermod -a -G tty pi`
|
|
|
|
|
|
### Problems occurring with the log file
|
|
|
|
#### Screen shows console instead of KlipperScreen
|
|
Run the command `ls /dev/fb*`. If you have multiple devices, you may need to fix the X11 configuration.
|
|
|
|
Run the command `cat /usr/share/X11/xorg.conf.d/99-fbturbo.conf | grep /dev/fb`. Try modifying the file (
|
|
`sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf`) and change `/dev/fb0` to a different file listed in the
|
|
previous command (i.e. `/dev/fb1`).
|
|
|
|
Once you have saved that file, restart KlipperScreen and it should show up on your display.
|
|
|
|
#### Screen is all white or blank
|
|
|
|
Improperly installed screen, follow the manufacturer instructions on how to physically connect the screen and install
|
|
the proper drivers.
|
|
|
|
### Touch not working on debian Bullseye
|
|
|
|
Some dsi screens have issues where touch doesn't work with debian bullseye, the current fix
|
|
(at least until upstream is fixed) consist in editing `/boot/config.txt` and changing:
|
|
|
|
`dtoverlay=vc4-kms-v3d`
|
|
|
|
to:
|
|
|
|
`dtoverlay=vc4-fkms-v3d`
|
|
|
|
and reboot. That should make the touch work, if your screen is rotated 180 degrees, then you may need to adjust
|
|
[the touch rotation](Hardware.md) as described in the Hardware page.
|