Troubleshooting

4.1 Installation Dependency Issues

If dependency issues occur when installing the deb package, run the following command to fix them:

sudo apt-get install -f

4.2 Serial Port Permission Issues

If the software reports insufficient serial port permissions, use one of the following methods:

sudo wujihand-upgrader

Or add your user to the dialout group (recommended, no sudo needed each time):

sudo usermod -a -G dialout $USER
newgrp dialout
wujihand-upgrader

4.3 Upgrader Window Not Displaying

If clicking the desktop icon shows the upgrader icon in the taskbar but the main window never appears, start the upgrader from a terminal for troubleshooting.

If the terminal shows Failed to create GBM buffer of size 1280x720: Permission denied (GBM buffer error), it usually means the NVIDIA driver does not have DRM Kernel Mode Setting enabled. For background information, see dioxus#1909.

To resolve this issue:

1. Check if modesetting is enabled:

   cat /sys/module/nvidia_drm/parameters/modeset

2. If the output is N, enable it with the following command:

   echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf

3. Restart the computer, then launch the upgrader again.