RDK X5 常见问题精选（FAQ 合集）：从入门到踩坑的 10 个高频问题

一、硬件与系统

Q1：上电后板卡反复重启或无法启动？

现象：系统在 U-Boot 引导阶段或内核启动初期无明显错误日志就直接重启，绿灯状态异常。

原因分析：

• 供电不足或不稳定
• MicroSD 卡接触不良或镜像烧录失败
• 串口在启动时误触进入 U-Boot 命令行

解决方案：

1. 使用符合要求的电源适配器（RDK X3 推荐 5V/3A，禁止使用 PC USB 接口供电）
2. 重新烧录系统镜像（推荐 balenaEtcher）
3. 拔掉串口线后重新上电，或在hobot>提示符下输入boot回车
4. 更换高速 MicroSD 卡（Class 10 / U1 以上）

验证：绿灯正常闪烁，系统进入就绪状态。

Q2：如何查看系统版本号？

cat/etc/version# 示例输出：2.0.0 或 3.0.0aptlist--installed|grephobot rdkos_info# 较新系统版本（2.1.0+）

Q3：默认登录账户和密码是什么？

• 普通用户：sunrise/sunrise
• 超级用户：root/root

⚠️ 具体默认账户可能因镜像版本略有不同，建议查阅该镜像的发行说明。

二、网络连接

Q4：RDK X5 的默认网口 IP 是什么？

以 RDK OS 3.0.0 为例：

验证连通性：在 PC 端ping 192.168.127.10。

Q5：apt update失败，提示密钥或域名错误？

常见报错：

• Clearsigned file isn't valid, got 'NOSPLIT'
• Could not resolve 'archive.sunrisepi.tech'

解决方案：

# 1. 检查当前源配置cat/etc/apt/sources.list.d/sunrise.list# 2. 替换旧域名为新域名sudosed-i's/archive.sunrisepi.tech/archive.d-robotics.cc/g'/etc/apt/sources.list.d/sunrise.list# 3. 更新 GPG 密钥sudowget-O/usr/share/keyrings/sunrise.gpg http://archive.d-robotics.cc/keys/sunrise.gpg# 4. 重新更新sudoaptupdate

三、外设接口

Q6：摄像头插拔有什么注意事项？

严禁在开发板未断电的情况下插拔摄像头！否则非常容易烧坏摄像头模组或主板接口。

Q7：MIPI 摄像头连接后如何验证？

sudoi2cdetect-y-r1# F37 通常在 0x40，GC4663 在 0x29cd/app/ai_inference/03_mipi_camera_samplesudopython3 mipi_camera.py

四、系统维护

Q8：执行apt upgrade时桌面黑屏怎么办？

建议：通过串口终端或 SSH 远程登录后，在纯字符终端中执行更新。

sudoaptupdate&&sudoaptupgrade

五、编译与开发

Q9：编译大型项目时内存不足被 Kill？

解决方案：增加 Swap 交换空间

# 创建 4GB Swap 文件sudofallocate-l4G /swapfilesudochmod600/swapfilesudomkswap/swapfilesudoswapon/swapfile# 验证swapon--showfree-h# 开机自动挂载（编辑 /etc/fstab，添加一行）# /swapfile none swap sw 0 0

同时减少编译并行度：

make-j1# 单线程编译colcon build--executorsequential --parallel-workers1# ROS2 串行编译

六、U-Boot 引导

Q10：系统启动卡在hobot>命令行界面怎么办？

原因：串口在启动时收到非预期输入，中断了 U-Boot 自动引导流程。

解决：

1. 在hobot>提示符下输入boot并回车
2. 或拔掉串口线后重新上电

快速排查索引