> ## 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.

# 故障排除

### 端口访问权限

启动 Ubuntu 版上位机时，出现无法找到端口问题：

* 方法一：将当前用户加入 `dialout` 组

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

  执行后需使权限生效：

  * 仅当前终端生效：`newgrp dialout`
  * 全局生效：`sudo reboot`

* 方法二：sudo 启动上位机
  ```bash theme={null}
  sudo wuji-hand-hmi
  ```

### 显示缩放警告

若启动时弹出显示缩放警告，说明当前系统显示缩放比例大于 100%。请在系统设置中将显示缩放比例调整到 100% (1:1)，然后重新启动 HMI。


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