RDK X5 常见问题精选（FAQ 合集）：从入门到踩坑的 10 个高频问题
一、硬件与系统Q1上电后板卡反复重启或无法启动现象系统在 U-Boot 引导阶段或内核启动初期无明显错误日志就直接重启绿灯状态异常。原因分析供电不足或不稳定MicroSD 卡接触不良或镜像烧录失败串口在启动时误触进入 U-Boot 命令行解决方案使用符合要求的电源适配器RDK X3 推荐 5V/3A禁止使用 PC USB 接口供电重新烧录系统镜像推荐 balenaEtcher拔掉串口线后重新上电或在hobot提示符下输入boot回车更换高速 MicroSD 卡Class 10 / U1 以上验证绿灯正常闪烁系统进入就绪状态。Q2如何查看系统版本号cat/etc/version# 示例输出2.0.0 或 3.0.0aptlist--installed|grephobot rdkos_info# 较新系统版本2.1.0Q3默认登录账户和密码是什么普通用户sunrise/sunrise超级用户root/root⚠️ 具体默认账户可能因镜像版本略有不同建议查阅该镜像的发行说明。二、网络连接Q4RDK X5 的默认网口 IP 是什么以 RDK OS 3.0.0 为例接口类型默认 IP有线网口以太网192.168.127.10/24闪连口USB Device虚拟网卡192.168.128.10/24验证连通性在 PC 端ping 192.168.127.10。Q5apt update失败提示密钥或域名错误常见报错Clearsigned file isnt valid, got NOSPLITCould not resolve archive.sunrisepi.tech解决方案# 1. 检查当前源配置cat/etc/apt/sources.list.d/sunrise.list# 2. 替换旧域名为新域名sudosed-is/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摄像头插拔有什么注意事项严禁在开发板未断电的情况下插拔摄像头否则非常容易烧坏摄像头模组或主板接口。Q7MIPI 摄像头连接后如何验证sudoi2cdetect-y-r1# F37 通常在 0x40GC4663 在 0x29cd/app/ai_inference/03_mipi_camera_samplesudopython3 mipi_camera.py四、系统维护Q8执行apt upgrade时桌面黑屏怎么办建议通过串口终端或 SSH 远程登录后在纯字符终端中执行更新。sudoaptupdatesudoaptupgrade五、编译与开发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 自动引导流程。解决在hobot提示符下输入boot并回车或拔掉串口线后重新上电快速排查索引问题类型参考无法启动/反复重启Q1查看系统版本Q2默认账户密码Q3网口 IP 地址Q4apt update 失败Q5摄像头热插拔Q6MIPI 摄像头验证Q7桌面黑屏Q8内存不足Q9U-Boot 卡住Q10
