跳到主要内容

安装系统到 eMMC

说明

教程适用于 Cubie A7S 板载 eMMC 版本的用户

介绍如何在 MicroSD 卡 启动系统正常的情况下,使用 dd 命令将系统安装到 eMMC 中。

注意

安装系统会格式化 eMMC,如果有重要数据请提前备份!

使用前提

您需要满足以下条件才可以使用 dd 命令将系统安装到 eMMC 中:

  • 系统可以通过 MicroSD 卡 正常启动系统

  • eMMC 安装到主板上或主板板载 eMMC

硬件连接

若你的主板是板载 eMMC 的版本,无需安装。

安装系统

下载系统镜像

主板需要访问 资源汇总下载 页面,下载 最新系统镜像 到主板上。

镜像说明

下载的系统镜像是压缩文件,需要解压后才能使用!

您可以使用 wget 命令下载系统镜像文件到主板上。

radxa@cubie-a7s$
sudo apt update
sudo apt install wget -y
wget <download_url>

其中 <download_url> 为系统镜像文件的下载地址,可以复制 资源汇总下载 页面中的镜像下载地址进行替换。

下载示例:wget https://github.com/radxa-build/radxa-a733/releases/download/rsdk-t2/radxa-a733_bullseye_kde_t2.output_512.img.xz

解压系统镜像

我们的系统镜像一般为 *.img.xz 格式,需要解压后才能使用。

radxa@cubie-a7s$
sudo apt install xz-utils -y
unxz <path_to_image_unxz>

其中 <path_to_image_unxz> 为系统镜像文件的路径,需要替换成实际的系统镜像文件路径。

解压示例:

unxz radxa-a733_bullseye_kde_t2.output_512.img.xz

确定设备路径

可以使用 lsblk 命令查看设备路径,根据磁盘的容量来确定设备路径。

说明:若是磁盘容量接近一致,可以安全插拔(适用于 eMMC 模块)来观察出现和消失的设备路径,从而确定设备路径。

radxa@cubie-a7s$
lsblk

系统若识别出 eMMC 设备,通常会识别成 /dev/mmcblk* 设备。

终端输出示例:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
···
mmcblk1 179:0 0 29.1G 0 disk
└─mmcblk1p1 179:1 0 29.1G 0 part
···

安装系统镜像

使用 dd 命令将系统镜像安装到 eMMC 中。

radxa@cubie-a7s$
sudo dd if=<path_to_image> of=<device_target> bs=4M status=progress

写入示例:

sudo dd if=radxa-a733_bullseye_kde_t2.output_512.img of=/dev/mmcblk1 bs=4M status=progress

参数说明:

  • <path_to_image>:系统镜像文件的路径,需要替换成实际的系统镜像文件路径。

  • <device_target>:eMMC 模块的设备路径,需要替换成实际的 eMMC 模块的设备路径。

  • bs=4M:写入块大小。

  • status=progress:显示写入进度。

验证写入结果

安装系统完成后,可以通过 lsblk 命令查看 eMMC 的分区表是否正常创建。

radxa@cubie-a7s$
lsblk

终端输出示例:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
···
mmcblk0 179:0 0 29.1G 0 disk
├─mmcblk0p1 179:1 0 16M 0 part
├─mmcblk0p2 179:2 0 300M 0 part
└─mmcblk0p3 179:3 0 28.8G 0 part
···

启动系统

完成系统的安装后,将主板关机,断开主板电源,按照以下操作完成系统启动:

① : 将 microSD 卡从主板上取下

② : 使用 USB-C 转 HDMI 或 DP 数据线连接显示器和主板

③ : 使用 USB-A 接口连接鼠标或键盘:若有 USB-A 拓展坞,可以通过拓展坞连接鼠标和键盘

④ : 使用 5V Type-C 电源适配器给主板供电

若主板供电正常,主板电源指示灯绿色亮起;若系统启动正常,状态指示灯蓝色闪烁。

成功启动系统后,显示器会显示系统桌面,你可以根据系统信息登录并使用系统。

系统信息

使用官方系统镜像时,请使用以下默认登录凭据:

项目内容
用户名radxa
密码radxa

登录系统

根据系统信息登录并使用系统。

使用系统

成功启动系统后,您就可以在 Cubie A7S 上正式使用瑞莎系统,对于瑞莎系统的简单使用,可参考 系统使用 教程。

    您需要登录 GitHub 才能发表评论。如果您已登录,请忽略此消息。

    Radxa-docs © 2026 by Radxa Computer (Shenzhen) Co.,Ltd. is licensed under CC BY 4.0