跳到主要内容

常见问题

系统问题

系统无法启动

检查下载的系统镜像是否正确以及是否解压,烧录工具选择的镜像文件是解压后的文件。

说明:若以上检查无误,可以尝试重新下载系统镜像,避免下载不完整。

远程问题

SSH 无法远程

出厂系统镜像默认开启 SSH 服务,一般情况下,您只需要确保 Cubie A7S 和 PC 端处于同一局域网,即可通过 SSH 远程。

排查方法:

  1. 检查 Cubie A7S 是否连接到网络以及 IP 地址是否正确:使用 ip a 命令可以查看网络连接的详细信息。
  2. 检查 Cubie A7S 和 PC 端是否处于同一局域网:使用 ping 彼此 IP 地址测试是否可以 ping 通。
  3. 检查 SSH 服务是否启动:使用 sudo systemctl status ssh 命令查看 SSH 服务状态。

VNC 无法远程

VNC 远程需要您手动配置 VNC 服务器;若按照教程操作,每次重启或者关机后,VNC 服务器都会自动关闭。

排查方法:

  1. 按照教程完成 VNC 远程的配置。
  2. 确保 SSH 远程一切正常。
  3. 检查是否启动 VNC 服务器:使用 vncserver -list 命令查看 VNC 服务器是否启动。
  4. 使用 ip:5901 进行 VNC 远程,其中 ip 是 Cubie A7S 的 IP 地址。

串口问题

打开串口设备失败

若打开串口出现 Error: Permission denied, cannot open /dev/ttyUSB0 错误提示!

您可以按照以下步骤排查问题:

  1. 检查串口设备是否正确连接 PC

  2. 检查串口设备权限

以 Linux 系统为例,若串口设备权限不足,您需要在终端命令行运行以下命令,让当前用户有权限访问设备。

  • 查看串口设备信息

/dev/ttyUSB0 作为演示:

Linux$
ls -l /dev/ttyUSB0

若系统存在该设备,您会看到类似以下的输出:

crw-rw---- 1 root dialout 188, 0 Sep 10 21:24 /dev/ttyUSB0
  • 添加当前用户到 dialout
Linux$
sudo usermod -a -G dialout $USER
  • 重新登录
Linux$
newgrp dialout
  1. 检查串口设备是否被其他程序占用

网络带宽测试

端口占用

若系统提示 iperf3: error - unable to start listener for connections: Address already in use,说明 iperf3 进程占用了 5201 端口。

解决办法:

  1. 查看 iperf3 的进程
Linux@host$
ps -ef | grep iperf3
  1. 终止 iperf3 进程:将 <PID> 替换为 iperf3 进程的 PID。
Linux@host$
sudo kill <PID>

KDE Discover 无法使用

KDE Discover 默认使用 OpenGL 渲染,而当前 GPU 驱动不支持 OpenGL 渲染,导致 KDE Discover 无法使用,解决方案:直接使用 apt 命令行工具安装软件包。

Linux@host$
sudo apt search <package_name>
sudo apt install <package_name>

apt 可以模糊搜索软件包,在使用 apt install 命令时,可以使用 tab 键自动补全软件包名称。

例如,安装 VLC 媒体播放器:

Linux@host$
sudo apt search vlc
sudo apt install vlc

    您需要登录 GitHub 才能发表评论。如果您已登录,请忽略此消息。

    Radxa-docs © 2026 by Radxa Computer (Shenzhen) Co.,Ltd. is licensed under CC BY 4.0