1.2.2.1 全镜像烧录
全镜像烧录是指将完整的操作系统镜像写入存储介质(通常为 SD 卡或 eMMC)的过程。该过程主要用于为开发板提供运行环境,包括用户空间应用、驱动程序及基础软件服务。
- 禁止带电时拔插除 USB、HDMI、网线之外的任何设备。
- RDK X3 Module 通过载板上的 DC 接口供电,推荐使用配件清单中推荐的 12V/2A 适配器。
- 请 不要使用电脑 USB 接口为开发板供电,否则会因供电不足造成开发板异常断电、反复重启等异常情况。
系统启动介质
RDK X3 Module 板载 eMMC,支持 Micro SD 存储卡和 eMMC 作为系统启动介质,烧录时可选择将系统烧录进 Micro SD 存储卡或 eMMC。
- 准备至少 8GB 容量的 Micro SD 存储卡,以便满足 Ubuntu 系统、应用功能软件对存储空间的需求。
- SD 读卡器。
烧录工具
RDK X3 Module 可借助 PC 端工具 RDK Studio 和 Rufus 来完成 Ubuntu 系统的烧录工作。
RDK Studio 工具
- 支持使用 “本地已有镜像” 和 “烧录时在线下载镜像” 两种方式。
- 支持 Windows、Linux、Mac 系统。
- 支持 Micro SD 存储卡烧录。
- 支持 eMMC 烧录,采用 UMS 方式。
下载地址
[点击此处] 进入 RDK Studio 下载页面,根据使用平台选择安装包版本,建议选用 User Installer。
安装方法
Windows 系统
双击下载的 .exe 安装包文件即可自动安装完成并打开应用。
Linux 系统
在安装包目录中的终端执行 sudo dpkg -i 安装包命令即可等待完成安装,安装示例如图所示。
Mac 系统
双击安装包,随即会出现一个弹窗,单击并按住图标拖到 Applications 图标中。
Rufus 工具
- 支持使用 “本地已有镜像”。
- 支持 Windows 系统。
- 支持 Micro SD 存储卡烧录。
- 支持 eMMC 烧录,采用 UMS 方式。
下载地址
[点击此处] 进入 Rufus 官网,根据使用平台选择工具版本。
安装方法
双击下载的 .exe 安装包文件即可自动安装完成并打开应用。
镜像下载
-
[点击此处] 下载镜像,选择 RDK X3 镜像。
镜像说明-
RDK X3 目前提供 Ubuntu 20.04/22.04 系统镜像,支持无桌面 Server 版本系统和带有桌面的 desktop 版本系统:
- desktop 版本:带有桌面的 Ubuntu 系统,可以外接屏幕、鼠标操作。
- server 版本:无桌面的 Ubuntu 系统,可以通过串口、网络远程连接操作。
-
RDK X3 出厂已经烧写测试版本系统镜像,为确保使用最新版本的系统,建议参考本文档完成最新版本系统镜像的烧写。
- 3.X.X 版本(Ubuntu 22.04):基于 RDK Linux 开源代码包制作,支持 RDK X3、RDK X3 Module 开发套件。
- 2.X.X 版本(Ubuntu 20.04):基于 RDK Linux 开源代码包制作,支持 RDK X3、RDK X3 Module 开发套件。
- 1.X.X 版本:RDK X3 历史版本,仅支持 RDK X3,解压后系统镜像名为
system_sdcard.img。
-
-
进入所选版本目录,以下载 3.0.3 版本的系统镜像为例,选择 “server” 版本镜像或 “desktop” 版本镜像,点击下载。
-
下载完成后,解压出 Ubuntu 系统镜像文件,如
rdk-x3-ubuntu22-preinstalled-desktop-3.0.3-arm64.img。
系统烧录步骤
烧录 SD 卡
使用 RDK Studio 工具
RDK Studio 工具提供烧录系统功能,并且可以连接设备并进行管理,支持在 Windows、Linux、Mac 平台上使用,详细步骤参见 使用 RDK Studio 烧录系统。
使用 Rufus 工具
烧 录步骤与 RDK X3 系统烧录步骤 相同。
烧录 eMMC
驱动检查
在使用烧录工具前,Windows 用户需要按照以下步骤确认驱动是否已安装。
-
将载板的 Micro USB 接口(烧录口)通过 USB 线与 PC 连接,接口位置参考下图。
-
给设备上电,观察电脑设备管理器端口状态,如出现
USB download gadget未知设备时,需要更新设备驱动。
驱动下载与安装
-
[点击此处] 下载并解压驱动包
android_hobot.zip。 -
进入解压后的目录,以管理员身份运行
5-runasadmin_register-CA-cer.cmd,完成驱动程序的注册。
-
双击
USB download gadget未知设备,选择驱动包解压目录,然后点击下一步。
-
驱动安装完成后,设备管理器会显示 fastboot 设备
Android Device。
烧录系统
-
使用跳线帽将 RDK X3 Module 载板切换到 3.3V 供电。
-
第一次使用载板的 Micro USB 接口(调试串口)时请 [点击此处] 下载安装 CH340 驱动,将载板的 Micro USB 接口(调试串口)通过 USB 线与 PC 连接,接口位置参考下图。
-
将载板的 Micro USB 接口(烧录口)通过 USB 线与 PC 连接。
-
下载远程连接工具 MobaXterm。
-
打开 MobaXterm 工具,点击
Session,然后选择Serial,配置端口号(例如COM3,实际使用的串口号以 PC 识别到的串口号为准),设置完成后点击OK。串口配置参数如下:
配置项 参数值 波特率(Baud rate) 921600 数据位(Data bits) 8 奇偶校验(Parity) None 停止位(Stop bits) 1 流控(Flow Control) 无
-
开发板上电后立刻长按空格键,进入 U-Boot 命令行模式。
-
在 U-Boot 中执行
watchdog off关闭看门狗,防止设备重启;执行ums 0 mmc 0,将板载 eMMC 设备(设备号 0)通过 USB OTG 接口 0 映射为 USB Mass Storage 设备,使得主机系统可以将其识别为标准 U 盘,从而进行直接读写或烧录操作。watchdog off
ums 0 mmc 0
-
PC 识别到标准 U 盘即 RDK X3 Module 的 eMMC 分区。
使用 RDK Studio 工具
烧录时,在 “选择存储设备” 步骤中选择识别到的标准 U 盘,烧录步骤参见 使用 RDK Studio 烧录系统。
使用 Rufus 工具
打开 Rufus 工具,在 “设备” 下拉框中选择对应的盘符作为目标设备,其余步骤与 RDK X3 使用 Rufus 烧录 一致,完成镜像烧录。

如烧录过程发生中断,请按照上述步骤重新进行。