From 36c6c0e03729ede1b95f05043dff4138d5f59138 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Tue, 11 Aug 2026 17:46:42 +0800 Subject: [PATCH] docs: add serial port permission denied tip to UART debug common template Add a troubleshooting tip for 'Error: Permission denied, cannot open /dev/ttyUSB*' to the shared UART debug template, covering both the temporary chmod workaround and the permanent dialout group membership solution, in both Chinese and English. --- .../radxa-os/system-config/_uart_debug.mdx | 16 ++++++++++++++++ .../radxa-os/system-config/_uart_debug.mdx | 16 ++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/docs/common/radxa-os/system-config/_uart_debug.mdx b/docs/common/radxa-os/system-config/_uart_debug.mdx index 9ecd11321..03783b11e 100644 --- a/docs/common/radxa-os/system-config/_uart_debug.mdx +++ b/docs/common/radxa-os/system-config/_uart_debug.mdx @@ -83,6 +83,22 @@ import { Image } from "@site/src/utils/docs"; /> +:::tip 串口无法打开 +若出现 `Error: Permission denied, cannot open /dev/ttyUSB*` 错误提示，说明当前用户没有串口设备的访问权限。请先确认主板对应的串口设备号，例如 `/dev/ttyUSB0`，然后执行： + +```bash +sudo chmod 666 /dev/ttyUSB0 +``` + +此方法重启或重新插拔设备后可能失效。建议将当前用户永久加入串口用户组： + +```bash +sudo usermod -aG dialout "$USER" +``` + +执行后注销并重新登录，使权限配置生效。 +::: + 连接成功后，按回车会出现登陆信息，然后使用对应系统的用户账号和密码进行登陆（终端输入密码不会显示出来，输入完密码按回车登陆）。 :::tip Android 系统登录 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_uart_debug.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_uart_debug.mdx index fbf6b2290..05270df15 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_uart_debug.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_uart_debug.mdx @@ -83,6 +83,22 @@ Click the run button to log in to the serial port device. /> +:::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