支持设备

• LiCheePi 4A

下载并解压镜像

注：以下命令以2025年10月12日对应 Github repo 的 CI 产出与 deepin-25-crimson-preview-riscv64-th1520-20250928-121959 版本为准，具体后续版本更新后请将下文指令对应部分改为正确版本及名称。

在镜像列表中的 T-Head TH1520 栏目下载最新的 .tar.xz 格式的镜像包至本地，随后使用以下命令解压镜像与校验码至当前文件夹：

tar xvf deepin-25-crimson-preview-riscv64-th1520-20250928-121959.tar.xz

这里除去原有压缩包有四个东西：

.
├── deepin-25-crimson-preview-riscv64-th1520-20250928-121959.tar.xz  # 最开始的压缩包
├── deepin-th1520-riscv64-25-desktop-installer.boot.ext4             # 启动分区
├── deepin-th1520-riscv64-25-desktop-installer.md5sum                # md5校验和
├── deepin-th1520-riscv64-25-desktop-installer.root.ext4             # 操作系统根分区
└── deepin-th1520-riscv64-25-desktop-installer.sha256sum             # sha256校验和

检查校验和以确保文件完整性：

cat *.sha256sum 
6fe113bd42d547e7e689f80857a2aea45a066e299f1d0361fc3d8b2c55368386  deepin-th1520-riscv64-25-desktop-installer.boot.ext4
d9a3c7fa640b9f0be64190d950e2723ec4c1ceb1722e13912e6bf6b577366cda  deepin-th1520-riscv64-25-desktop-installer.root.ext4
sha256sum *.boot.ext4 
6fe113bd42d547e7e689f80857a2aea45a066e299f1d0361fc3d8b2c55368386  deepin-th1520-riscv64-25-desktop-installer.boot.ext4
sha256sum *.root.ext4
d9a3c7fa640b9f0be64190d950e2723ec4c1ceb1722e13912e6bf6b577366cda  deepin-th1520-riscv64-25-desktop-installer.root.ext4

但这还不够，我们还需要启动引导镜像。

在 deepin-riscv-kernel的actions 中找到最新的（这里的“最新”以你所在的时间为准）build-all action，下载其中的 uboot-th1520-revyos 产出，这是一个 .zip 文件，你可以用

unzip uboot-th1520-revyos.zip

在当前文件夹中进行解压。

这里的文件有点多，应该查看开发板包装盒进行选择。比如对于 LiCheePi 4A ，如果拥有 8G LPDDR4X 内存则应选择 light_lpi4a ，如果拥有 16G LPDDR4X 内存则应选择 light_lpi4a_16g 。将对应文件夹下的 u-boot-with-spl.bin 复制到刚才 deepin 系统所在的目录下。

使用 fastboot 刷写镜像

按住开发板上的 boot 键（位于 USB-C 接口附近），使用 USB-C to USB-A 线缆（开发板包装内附赠）与电脑连接，松开 boot 按键，在本机上输入命令

lsusb

检查结果中是否出现 ID 2345:7654 T-HEAD USB download gadget ，若未出现，返回上述步骤重新连接。

使用

sudo fastboot flash ram u-boot-with-spl.bin

进入 u-boot 的 fastboot 烧录模式。然后重启 fastboot ：

sudo fastboot reboot

等待约五秒钟，直至 USB 设备被重新识别，之后进行如下刷写步骤：

sudo fastboot flash uboot u-boot-with-spl.bin # 刷写 u-boot 启动引导
sudo fastboot flash boot deepin-th1520-riscv64-25-desktop-installer.boot.ext4 # 刷写 deepin 启动分区
sudo fastboot flash root deepin-th1520-riscv64-25-desktop-installer.root.ext4 # 刷写 deepin 根分区
# 等待一段时间，根分区的刷写可能涉及较多文件...
sudo fastboot reboot # 重启开发板

重启完成后断开开发板与电脑的 USB 连接。

启动deepin

使用 USB-C 接口进行供电，等待约30秒观察风扇是否正常转动，若风扇不转动，先检查风扇是否红线接正极黑线接负极，否则镜像刷写失败，需要重新回到 使用 fastboot 刷写镜像 一节刷写。

使用开发板自带的 HDMI 接口与显示器进行连接，若出现 deepin 开机 logo 并进入了新用户设定界面则刷写成功，可以正常使用 deepin 进行后续的开发工作了。