1.2.1 RDK X3

在使用RDK X3开发板前，需要做下述准备工作。

烧录准备

供电

RDK X3

RDK X3开发板通过USB Type C接口供电，需要使用支持5V/3A的电源适配器为开发板供电，推荐使用基础配件清单中推荐的电源适配器型号。

RDK X3 Module

RDK X3 Module通过载板上的电源接口供电，官方载板通过DC接口供电，推荐使用认证配件清单中推荐的12V/2A适配器。

警告

请不要使用电脑USB接口为开发板供电，否则会因供电不足造成开发板异常断电、反复重启等异常情况。

更多问题的处理，可以查阅 常见问题 章节。

存储

RDK X3

RDK X3开发板采用Micro SD存储卡作为系统启动介质，推荐至少8GB容量的存储卡，以便满足Ubuntu系统、应用功能软件对存储空间的需求。

RDK X3 Module

RDK X3 Module板载eMMC（可选），支持从eMMC和SD卡两种模式启动系统。

显示

RDK X3

RDK X3开发板支持HDMI显示接口，通过HDMI线缆连接开发板和显示器，支持图形化桌面显示。

RDK X3 Module

RDK X3 Module支持HDMI显示接口，通过HDMI线缆连接官方载板和显示器，支持图形化桌面显示。

网络连接

RDK X3

RDK X3开发板支持以太网、Wi-Fi两种网络接口，用户可通过任意接口实现网络连接功能。

RDK X3 Module

RDK X3 Module支持以太网、Wi-Fi（可选）两种网络接口，用户可通过任意接口实现网络连接功能。

系统烧录

RDK套件目前提供Ubuntu 20.04/22.04系统镜像，可支持Desktop桌面图形化交互。

注意

RDK X3 Module出厂已经烧写测试版本系统镜像，为确保使用最新版本的系统，建议参考本文档完成最新版本系统镜像的烧写。

镜像下载

RDK X3

Video: https://www.bilibili.com/video/BV1rm4y1E73q/?p=1

点击 下载镜像，进入版本选择页面，选择对应版本目录，进入文件下载页。以下载2.0.0版本的系统镜像为例：

下载完成后，解压出Ubuntu系统镜像文件，如ubuntu-preinstalled-desktop-arm64.img

版本说明：

• 2.0版本：基于RDK Linux开源代码包制作，支持RDK X3派、X3模组等全系列硬件
• 1.0版本：旭日X3派历史版本，仅支持旭日X3派硬件，系统镜像名为system_sdcard.img

RDK X3 Module

点击 下载镜像，进入版本选择页面，选择对应版本目录，进入文件下载页。以下载2.0.0版本的系统镜像为例：

下载完成后，解压出Ubuntu系统镜像文件，如ubuntu-preinstalled-desktop-arm64.img

版本说明：

• 2.0版本：基于RDK Linux开源代码包制作，支持RDK X3派、X3模组等全系列硬件
• 1.0版本：旭日X3派历史版本，仅支持旭日X3派硬件，系统镜像名为system_sdcard.img

提示

• desktop：带有桌面的Ubuntu系统，可以外接屏幕、鼠标操作
• server：无桌面的Ubuntu系统，可以通过串口、网络远程连接操作

系统烧录

RDK X3

提示

在烧录Ubuntu系统镜像前，需要做如下准备：

• 准备至少8GB容量的Micro SD卡
• SD 读卡器
• 下载镜像烧录工具balenaEtcher（可点击此处下载）

balenaEtcher是一款支持Windows/Mac/Linux等多平台的PC端启动盘制作工具，制作SD启动卡流程如下：

1. 打开balenaEtcher工具，点击Flash frome file按钮，选择解压出来的ubuntu-preinstalled-desktop-arm64.img文件作为烧录镜像

   

2. 点击Select target按钮，选择对应的Micro SD存储卡作为目标存储设备

   

3. 点击Flash按钮开始烧录，待工具提示Flash Complete时，表示镜像烧录完成，可以关闭balenaEtcher并取出存储卡

   

RDK X3 Module

RDK X3 Module支持从eMMC和SD卡两种模式启动系统：

• 使用SD卡：如需烧录系统到SD上（不从eMMC模式启动），系统烧录步骤与RDK X3相同；
• 使用eMMC：需要使用D-Robotics hbupdate烧录工具。（以下主要介绍该方法）

hbupdate工具支持Windows、Linux两种版本，分别以 hbupdate_win64、 hbupdate_linux 开头，工具下载链接：hbupdate。

注意事项

• 解压工具压缩包，注意解压路径中不要包含空格、中文、特殊字符等内容。
• 工具通过USB口跟RDK X3模组通讯，需要提前安装USB驱动，具体方法见下文描述。

1. 对于使用Windows系统的PC，在使用刷机工具前，需要确认是否安装过fastboot驱动程序，请按照如下步骤进行确认：

   （1）使用跳线帽将RDK X3载板的Boot管脚接地，管脚位置参考下图。
   

   （2）将载板的Micro USB接口与电脑通过USB线连接，接口位置参考下图。
   

   （3）给设备上电，然后观察电脑设备管理器端口状态，如出现USB download gadget未知设备时，需要更新设备驱动，否则可跳过下述步骤。
   

   （4）下载并解压驱动包 android_hobot.zip，下载链接 android_hobot 。

   （5）进入解压后的目录，以管理员身份运行 5-runasadmin_register-CA-cer.cmd，完成驱动程序的注册。

   （6）双击USB download gadget未知设备，选择驱动包解压目录，然后点击下一步。
   

   （7）驱动安装完成后，设备管理器会显示fastboot设备Android Device。
   

2. 确认PC设备管理器显示fastboot设备Android Device后，运行hbupdate.exe打开烧录工具，按照以下步骤进行烧录：

   

   （1）选择开发板型号，必选项。

   • RDK_X3_2GB： RDK X3（旭日X3派），2GB内存版本，仅支持烧写最小系统镜像

   • RDK_X3_4GB： RDK X3（旭日X3派），4GB内存版本，仅支持烧写最小系统镜像

   • RDK_X3_MD_2GB： RDK X3 Module，2GB内存版本

   • RDK_X3_MD_4GB： RDK X3 Module，4GB内存版本

   

   （2）点击Browse按钮选择将要烧录的镜像文件，必选项。

   

   （3）点击Start按钮开始刷机，根据弹窗提示开始烧录：

   

   • 烧录镜像时，需要通过跳线帽将BOOT管脚接地，管脚位置参考功能控制接口

   • 将Micro USB接口连接到电脑，电脑设备管理器中会识别出Android Device的设备，如上一节安装USB下载驱动所描述

   • 烧录完毕断开电源，断开和电脑的连接线，将BOOT管脚跳线帽拔下，重新上电即可

   • 如果启动正常，在硬件上的ACT LED灯会进入两次快闪一次慢闪的状态

   （4）检查升级结果

   • 镜像烧录成功时，工具提示如下：

   

   • 镜像烧录失败时，工具提示如下，此时需要确认PC设备管理器是否存在Android Device设备

   

警告

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

启动系统

RDK X3

首先保持开发板断电，然后将制作好的存储卡插入开发板的Micro SD卡槽，并通过HDMI线缆连接开发板与显示器，最后给开发板上电。

系统首次启动时会进行默认环境配置，整个过程持续45秒左右，配置结束后会在显示器输出Ubuntu系统桌面。

开发板指示灯说明

• **红色**指示灯：点亮代表硬件上电正常
• **绿色**指示灯：点亮代表系统启动中，熄灭或闪烁代表系统启动完成

如果开发板上电后长时间没有显示输出（2分钟以上），说明开发板启动异常。此时用户可通过指示灯确认系统状态，方法如下：

• **绿灯**常亮：说明系统启动失败，可检查使用的电源适配器是否满足要求，可尝试重新制作系统镜像
• **绿灯**熄灭或闪烁：说明系统启动成功，但显示服务启动失败，请确认连接的显示器符合支持列表规格

RDK X3 Module

RDK X3 Module支持从eMMC和SD卡两种模式启动系统：

• 当模组上的eMMC没有烧录过系统镜像的情况下，插入制作好系统的SD卡到载板即可通过从SD卡启动系统。

• 如果模组上的eMMC已经烧录过系统镜像，可以按照以下步骤进行eMMC和SD卡启动的切换。

  1、默认情况下会从eMMC启动系统

  2、禁用eMMC的启动切换到使用SD卡启动系统，登录系统后，执行以下命名把eMMC的第二个分区的启动标志删除，并重启系统生效：

  sudo parted /dev/mmcblk0 set 2 boot off
  sudo reboot

  3、在uboot下会发现eMMC没有启动分区而去寻找SD卡的启动分区，从SD卡加载系统启动，登录系统后执行mount命令可以看到跟文件系统挂载在 SD 卡的 第二个分区，config分区也使用的SD卡的第一个分区。

  /dev/mmcblk2p2 on / type ext4 (rw,relatime,data=ordered) 
  /dev/mmcblk2p1 on /boot/config type vfat

• 从SD卡启动切换回从eMMC启动

  当在使用SD卡启动系统时，并且eMMC上已经烧录过系统，执行以下命令恢复回从eMMC启动，重启系统生效。

  sudo parted /dev/mmcblk0 set 2 boot on
  sudo reboot

Ubuntu Desktop版本系统启动完成后，会通过HDMI接口在显示器上输出系统桌面，如下图：

常见问题

首次使用开发板时的常见问题如下：

• 上电不开机 ：请确保使用供电中推荐的适配器供电；请确保开发板的Micro SD卡或eMMC已经烧录过Ubuntu系统镜像
• USB Host接口无反应 ：请确保开发板Micro USB接口没有接入数据线
• 使用中热插拔存储卡 ：开发板不支持热插拔Micro SD存储卡，如发生误操作请重启开发板

注意事项

• 禁止带电时拔插除USB、HDMI、网线之外的任何设备
• RDK X3的 Type C USB接口仅用作供电
• 选用正规品牌的USB Type C 口供电线，否则会出现供电异常，导致系统异常断电的问题

提示

更多问题的处理，可以查阅 常见问题 章节，同时可以访问 D-Robotics 开发者官方论坛 获得帮助。