安装系统到板载 UFS

主要介绍在 MicroSD 卡 启动系统正常的情况下，使用 dd 命令将系统安装到 UFS 中。

注意

安装系统会格式化 UFS 模块或板载 UFS，如果有重要数据请提前备份！

使用前提

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

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

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

硬件连接

UFS 模块

UFS 模块安装步骤：

1. 观察 UFS 模块上的缺角方向和主板上的 UFS 模块接口的缺角丝印，以确定正确的安装方向。
2. 将 UFS 模块放置到主板 UFS 模块接口上方，确保 UFS 模块接口与主板的 UFS 模块接口基本对齐。
3. 稍用力按压 UFS 模块的一端，听到“咔哒”声表示安装成功，再以同样方式按压另一端，确保 UFS 模块安装成功。

板载 UFS

若你的主板是板载 UFS 的版本，无需安装。

安装系统

下载系统镜像

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

镜像说明

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

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

radxa@device$

sudo apt update
sudo apt install wget -y
wget <download_url>

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

下载示例：wget <download_url>

解压系统镜像

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

radxa@device$

sudo apt install xz-utils -y
unxz <path_to_image_unxz>

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

解压示例：

unxz <path_to_image_unxz>

确定设备路径

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

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

radxa@device$

lsblk

系统若识别出 UFS 设备，通常会识别成 /dev/sd* 设备。

终端输出示例:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
···
sda           8:0    0 119.2G  0 disk
└─sda1        8:1    0 119.2G  0 part
···

安装系统镜像

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

radxa@device$

sudo dd if=<path_to_image> of=<device_target> bs=4M status=progress

写入示例：

sudo dd if=<path_to_image> of=/dev/sda bs=4M status=progress

参数说明：

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

• <device_target>：UFS 模块的设备路径，需要替换成实际的 UFS 模块的设备路径。

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

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

验证写入结果

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

radxa@device$

lsblk

终端输出示例:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
···
sda           8:0    0 119.2G  0 disk
├─sda1        8:1    0   128M  0 part
├─sda2        8:2    0   2.3G  0 part
└─sda3        8:3    0   6.4G  0 part
···