RDK X5 从零上手：烧录系统镜像 + Wi-Fi 配网 + SSH 远程登录 完整教程

摘要：本文面向首次接触地瓜机器人 RDK X5 开发板的开发者，详细介绍从零开始的完整上手流程：选择合适的系统镜像（Server vs Desktop）、使用 RDK Studio 或 Rufus 工具烧录 Micro SD 卡、通过串口首次登录获取 IP、配置 Wi-Fi 无线网络、以及使用 SSH/VNC 进行远程开发。附常见问题排查，帮助你在 30 分钟内完成 RDK X5 开发环境搭建。

---

一、前言

RDK X5 是地瓜机器人基于旭日 X5（Bayse）处理器打造的智能机器人开发平台，搭载 BPU 神经网络加速引擎，广泛应用于机器人视觉、SLAM、模型推理等场景。

本文是 RDK X5 的基础环境搭建教程，覆盖以下流程：

下载镜像 → 烧录 SD 卡 → 首次上电 → 串口登录 → Wi-Fi 配网 → SSH 远程登录

---

二、准备工作

2.1 硬件清单

物品	说明
RDK X5 开发板	旭日 X5 处理器，BPU 算力
Micro SD 卡	至少 16GB，推荐 Class 10 及以上
SD 读卡器	用于 PC 端烧录
USB Type-C 电源适配器	5V/5A（⚠️ 不要用电脑 USB 口供电）
USB 串口转接板	用于首次串口登录（可选）
网线	有线网络连接（可选）

2.2 重要警告

⚠️ 注意

• 禁止带电插拔除 USB、HDMI、网线之外的任何设备
• RDK X5 Type-C 口仅用作供电，不能传输数据
• 必须使用支持 5V/5A 的电源适配器供电，不要使用电脑 USB 接口，否则会因供电不足导致反复重启
• 如需 PoE 供电，参见官方 PoE 文档

---

三、系统镜像选择与下载

RDK X5 运行 Ubuntu 22.04 系统，提供两种版本：

版本	特点	适用场景
Server 版	无桌面，命令行操作	服务器部署、远程开发、机器人主控
Desktop 版	完整 Ubuntu 桌面	外接显示器/键鼠、图形化开发、教学演示

下载步骤：

1. 访问 RDK X5 镜像下载目录：https://archive.d-robotics.cc/downloads/os_images/rdk_x5/
2. 选择版本目录（如 3.3.3）
3. 根据需求选择 server 或 desktop 镜像
4. 下载完成后解压出 .img 文件，如 rdk-x5-ubuntu22-preinstalled-desktop-3.3.3-arm64.img

---

四、系统烧录

RDK X5 支持两种烧录工具：

4.1 方式一：RDK Studio（推荐）

RDK Studio 是地瓜官方桌面工具，支持 Windows / macOS。

• 下载地址：https://developer.d-robotics.cc/rdkstudio
• 安装方法：Windows 双击 .exe 安装；macOS 拖入 Applications
• 烧录步骤：
  1. SD 卡插入读卡器，连接 PC
  2. 打开 RDK Studio，选择「烧录系统」
  3. 选择 SD 卡为目标设备
  4. 选择本地镜像文件（或在线下载）
  5. 点击烧录，等待完成

4.2 方式二：Rufus（轻量替代）

Rufus 是免费的 Windows 镜像烧录工具。

• 下载地址：https://rufus.ie/zh/
• 烧录步骤：
  1. SD 卡插入读卡器，连接 PC
  2. 打开 Rufus，在「设备」下拉选择 SD 卡
  3. 点击「选择」，选取解压后的 .img 镜像文件
  4. 点击「开始」烧录
  5. 等待进度条完成，安全弹出 SD 卡

4.3 烧录完成后

• 将 SD 卡插入 RDK X5 卡槽
• 连接 USB Type-C 电源
• 开发板自动开机（绿色电源灯亮起）

---

五、首次登录（串口方式）

首次使用建议通过串口登录，获取 IP 地址后即可切换到 SSH。

5.1 硬件连接

• 将 USB 串口转接板连接到 RDK X5 调试串口
• 串口驱动可从资源中心下载：https://developer.d-robotics.cc/resource

5.2 终端工具配置

推荐使用 MobaXterm 或 Putty。以 MobaXterm 为例：

参数	值
波特率（Baud rate）	115200（RDK X5）/ 921600（RDK X3）
数据位（Data bits）	8
奇偶校验（Parity）	None
停止位（Stop bits）	1
流控（Flow Control）	无

5.3 登录设备

• 用户名：root
• 密码：root

登录成功后，用 ifconfig 查看 IP：

root@ubuntu:~# ifconfig
eth0: inet 192.168.127.10    # 有线以太网（默认静态IP）
wlan0: ...                   # Wi-Fi（需配置后才有IP）

---

六、Wi-Fi 无线网络配置

6.1 方法一：命令行配置（推荐）

使用 nmcli 连接 Wi-Fi：

# 扫描可用 Wi-Fi
nmcli dev wifi list

# 连接 Wi-Fi（替换 YOUR_SSID 和 YOUR_PASSWORD）
nmcli dev wifi connect "YOUR_SSID" password "YOUR_PASSWORD"

# 查看 Wi-Fi 获取的 IP
ifconfig wlan0

6.2 方法二：srpi-config 图形化配置

sudo srpi-config

进入 System Options → Wireless LAN，输入 SSID 和密码即可。

6.3 网络说明

连接方式	IP 获取方式	默认地址
有线以太网	静态 IP	192.168.127.10
Wi-Fi	DHCP（路由器分配）	通过 ifconfig wlan0 查看

---

七、SSH 远程登录

获取 IP 后，即可从 PC 通过 SSH 远程登录：

# 通过有线网（默认静态IP）
ssh root@192.168.127.10

# 通过 Wi-Fi（替换为实际 IP）
ssh root@192.168.x.x

默认密码：root

---

八、VNC 远程桌面（Desktop 版本）

如果你烧录的是 Desktop 版系统，可以通过 VNC 远程访问桌面：

1. 在 RDK X5 上启动 VNC 服务
2. PC 端使用 VNC Viewer 连接 开发板IP:5900

---

九、常见问题

Q1：烧录后开机无反应？

• 检查电源适配器是否为 5V/5A
• 检查 SD 卡是否插紧
• 确认镜像文件完整（对比 MD5）

Q2：串口连接无输出？

• 确认波特率设置为 115200（不是 RDK X3 的 921600）
• 检查 TX/RX 线序是否正确
• 检查串口驱动是否安装

Q3：SSH 连接被拒绝？

• 确认开发板和 PC 在同一网络
• 尝试 ping 192.168.127.10 检查连通性
• 确认 SSH 服务已启动

Q4：Wi-Fi 连接不上？

• 确认天线已安装
• 使用 nmcli dev wifi list 检查信号
• 尝试靠近路由器

---

十、总结

本文覆盖了 RDK X5 从零上手的完整流程：

1. ✅ 下载 Ubuntu 22.04 系统镜像（Server / Desktop）
2. ✅ 使用 RDK Studio 或 Rufus 烧录 SD 卡
3. ✅ 串口首次登录（115200 波特率）
4. ✅ Wi-Fi 配网（nmcli / srpi-config）
5. ✅ SSH / VNC 远程登录

完成以上步骤后，你的 RDK X5 开发环境已就绪。接下来可以部署 Model Zoo 中的 AI 模型（YOLO、CLIP、PaddleOCR 等），开始机器人应用开发。