> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排除

### 安装依赖问题

安装 deb 包时出现依赖问题，执行以下命令修复：

```bash theme={null}
sudo apt-get install -f
```

### 串口权限问题

启动时提示串口权限不足，使用以下方式解决：

```bash theme={null}
sudo wujihand-upgrader
```

或将当前用户加入 `dialout` 组（推荐，无需每次 sudo）：

```bash theme={null}
sudo usermod -a -G dialout $USER
newgrp dialout
wujihand-upgrader
```

### 升级工具窗口不显示

如果安装完成后点击桌面图标，任务栏中出现了升级工具图标，但主窗口始终没有显示，可先在终端中启动程序进行排查。

若终端中出现 `Failed to create GBM buffer of size 1280x720: Permission denied`（GBM 缓冲区错误），通常说明 NVIDIA 驱动未启用 DRM 内核模式设置（Kernel Mode Setting）。相关背景可参考 [dioxus#1909](https://github.com/DioxusLabs/dioxus/issues/1909#issuecomment-1974930010)。

可按以下步骤处理：

1. 检查是否已启用 modesetting：

   ```bash theme={null}
   cat /sys/module/nvidia_drm/parameters/modeset
   ```

2. 如果输出为 `N`，执行以下命令启用：

   ```bash theme={null}
   echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf
   ```

3. 重启计算机后，再次启动升级工具。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.