常见问题
打开串口设备失败
若打开串口出现 Error: Permission denied, cannot open /dev/ttyUSB0 错误提示！
您可以按照以下步骤排查问题：
-
检查串口设备是否正确连接 PC
-
检查串口设备权限
以 Linux 系统为例，若串口设备权限不足，您需要在终端命令行运行以下命令，让当前用户有权限访问设备。
- 查看串口设备信息
以 /dev/ttyUSB0 作为演示：
ls -l /dev/ttyUSB0
若系统存在该设备，您会看到类似以下的输出：
crw-rw---- 1 root dialout 188, 0 Sep 10 21:24 /dev/ttyUSB0
- 添加当前用户到
dialout组
sudo usermod -a -G dialout $USER
- 重新登录
newgrp dialout
- 检查串口设备是否被其他程序占用
为什么 Radxa OS 默认使用 GDM 而不是 SDDM？
Radxa OS 默认使用 GDM（GNOME Display Manager）替代 SDDM（Simple Desktop Display Manager），主要原因如下：
SDDM 的局限性：
- 在 HDMI 未连接的 headless 模式下，SDDM 无法正常启动图形界面
- 这会导致用户无法通过远程桌面或 VNC 等方式登录系统
GDM 的优势：
- 在各种连接状态下（包括 headless 模式）都能稳定运行
- 提供更好的兼容性和可靠性
如果您希望切换回 SDDM，请按以下步骤操作：
sudo dpkg-reconfigure sddm
在弹出的配置界面中，选择 sddm 作为默认显示管理器，然后重启系统即可使更改生效。
为什么我的 SBC 只有在桌面模式下登录后才能连接 Wi-Fi？不接显示器直接通过 SSH 无法连接网络？
这是因为 KDE 或 GNOME 桌面环境默认将 Wi-Fi 密码存储在用户专属的 密钥环（Keyring）中。该密钥环只有在用户图形界面登录后才会被解锁，因此系统在无人登录（如 headless 模式）时无法自动连接受保护的 Wi-Fi 网络，导致 SSH 也无法使用。 为了解决这个问题，您可以选择以下三种方法之一：
-
启用自动登录功能： 这样系统在启动时会自动登录到指定用户，从而解锁密钥环，允许 Wi-Fi 连接：使用 rsetup 工具启用自动登录
-
关闭 keyring 加密：
您可以通过以下步骤关闭密钥环加密：kde 设置 -> kde wallet -> 禁用密钥环加密 然后忘记 wifi 密码，重新链接 wifi 即可 这样密钥环将不再加密，系统可以在无人登录时访问 Wi-Fi 密码，从而实现自动连接 Wi-Fi 网络。请注意，这种方法会降低系统的安全性。
-
使用 nmtui/nmcli 工具手动添加 Wi-Fi 密码： 通过命令行工具 nmtui 或 nmcli 手动配置 Wi-Fi 网络连接，并保存密码到系统范围内的配置文件中，而不是用户的密钥环中。
nmcli connection add type wifi con-name <connection_name> ssid <ssid> password <password>
# or
nmtui
网络连接出现自动断开的现象
可以修改 /usr/share/glib-2.0/schemas/org.gnome.settings-daemon.plugins.power.gschema.xml 文件的参数，禁用休眠时间。
vim /usr/share/glib-2.0/schemas/org.gnome.settings-daemon.plugins.power.gschema.xml
修改文件中的 sleep-inactive-ac-timeout 和 sleep-inactive-battery-timeout 参数默认值为 0，然后重启系统即可使更改生效。
为什么调用硬件编码器会导致 Q6A 直接重启？
在使用硬件编码器前，需要先在 BIOS 中启用相关配置：
Hypervisor Settings -> Hypervisor Override in UEFI Setup
开机时按 F2 即可进入 UEFI Setup。
如果没有启用该选项，调用硬件编码器时系统可能会直接重启。
启用硬件编码器后，会有以下影响：
- 系统会以
EL2而不是EL1启动，此时可以使用 KVM /dev/mtd0会消失，因此不能直接在板子上更新 SPI 固件
为什么运行 sudo apt upgrade 后系统无法启动？
直接使用 sudo apt upgrade 命令升级系统可能会导致更新不完全或系统异常（如无法启动）。建议使用 Rsetup 工具进行系统更新：
sudo rsetup
进入 Rsetup 后，选择 System -> System Update 完成更新。
详细信息请参考：系统更新。
如果在更新过程中断电或更新失败，系统可能无法正常启动。此时需要重新刷写系统镜像。
7 寸屏显示花屏如何解决？
7 寸屏默认会使用 1080p 分辨率，如果屏幕不支持该分辨率会导致花屏，需要手动设置屏幕分辨率。
查看支持分辨率
首先连接屏幕并登录系统，查看 HDMI 输出支持的分辨率：
# 解析 EDID 内容（需安装 edid-decode）
sudo apt install edid-decode
sudo edid-decode /sys/class/drm/card1-HDMI-A-1/edid
在输出中确认屏幕支持的分辨率列表。若 7 寸屏的 1024x600 分辨率没有出现在默认的 modes 中，说明默认的 1080p 分辨率设置会导致显示异常。
调整分辨率
确认分辨率后，修改内核命令行参数来指定正确的屏幕分辨率：
old=$(cat /etc/kernel/cmdline)
echo "$old video=HDMI-A-1:1024x600@60" | sudo tee /etc/kernel/cmdline
更新内核
sudo kernel-install add $(uname -r) /boot/vmlinuz-$(uname -r)
重启
sudo reboot
重启后如果仍然显示异常，请重新插拔 HDMI 线缆。