Skip to content

docs: add serial port permission denied tip to UART debug common template #1986

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Milir-Radxa merged 1 commit into from
Aug 11, 2026
+32 −0
Merged

docs: add serial port permission denied tip to UART debug common template #1986

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/common/radxa-os/system-config/_uart_debug.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,22 @@ import { Image } from "@site/src/utils/docs";
/>
</div>

:::tip 串口无法打开
若出现 `Error: Permission denied, cannot open /dev/ttyUSB*` 错误提示，说明当前用户没有串口设备的访问权限。请先确认主板对应的串口设备号，例如 `/dev/ttyUSB0`，然后执行：

```bash
sudo chmod 666 /dev/ttyUSB0
```

此方法重启或重新插拔设备后可能失效。建议将当前用户永久加入串口用户组：

```bash
sudo usermod -aG dialout "$USER"
```

执行后注销并重新登录，使权限配置生效。
:::

连接成功后，按回车会出现登陆信息，然后使用对应系统的用户账号和密码进行登陆（终端输入密码不会显示出来，输入完密码按回车登陆）。

:::tip Android 系统登录
Expand Down
16 changes: 16 additions & 0 deletions ...aurus-plugin-content-docs/current/common/radxa-os/system-config/_uart_debug.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,22 @@ Click the run button to log in to the serial port device.
/>
</div>

:::tip Serial Port Cannot Be Opened
If you see the error `Error: Permission denied, cannot open /dev/ttyUSB*`, the current user does not have permission to access the serial port device. First confirm the serial device number corresponding to your board, e.g. `/dev/ttyUSB0`, then run:

```bash
sudo chmod 666 /dev/ttyUSB0
```

This method may no longer work after a reboot or replugging the device. It is recommended to permanently add the current user to the serial port user group:

```bash
sudo usermod -aG dialout "$USER"
```

After that, log out and log back in for the permission change to take effect.
:::

After a successful connection, press Enter to display the login prompt. Then use the corresponding system username and password to log in (the password will not be displayed as you type; press Enter after entering the password).

:::tip Android System Login
Expand Down
Loading