Skip to main content

v0.5.0 版本新增特性

  • 板卡镜像刷写支持增加到 9 款
  • 镜像源换源支持

安装 v0.5.0

v0.5.0 版本的稳定二进制为 0.5.0 。

在 amd64 架构环境安装:

$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.5.0/ruyi.amd64
$ chmod +x ./ruyi.amd64
$ sudo cp ./ruyi.amd64 /usr/local/bin/ruyi

在 riscv64 架构环境安装:

$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.5.0/ruyi.riscv64
$ chmod +x ./ruyi.riscv64
$ sudo cp ./ruyi.riscv64 /usr/local/bin/ruyi

检查安装版本:

$ ruyi version
Ruyi 0.5.0
Copyright (C) 2023 Institute of Software, Chinese Academy of Sciences (ISCAS).
All rights reserved.
License: Apache-2.0 <https://www.apache.org/licenses/LICENSE-2.0>

板卡镜像刷写

在 0.5.0 版本,板卡镜像刷写功能所支持的板卡增加到 9 款。从该版本开始, ruyi update 将可以更新支持的板卡列表。

板卡支持列表:

开发板版本镜像刷写方式
Allwinner Nezha D1Allwinner Nezha D1 (generic variant)openEuler RISC-V (base system) for Allwinner D1dd
openEuler RISC-V (XFCE) for Allwinner D1dd
Canaan Kendryte K230Canaan Kendryte K230 (generic variant)Canaan Kendryte K230 Official CanMV Debian SDKdd
Canaan Kendryte K230 Official CanMV Ubuntu SDKdd
Milk-V DuoMilk-V Duo (64M RAM)Milk-V Duo Official buildroot SDK (64M RAM)dd
Milk-V Duo Official buildroot SDK (64M RAM, with Python)dd
Milk-V Duo (256M RAM)Milk-V Duo Official buildroot SDK (256M RAM)dd
Milk-V Duo Official buildroot SDK (256M RAM, with Python)dd
Milk-V Pioneer BoxMilk-V Pioneer Box (v1.3)openEuler RISC-V (base system) for Milk-V Pioneer (rootfs on NVMe)dd
openEuler RISC-V (XFCE) for Milk-V Pioneer (rootfs on NVMe)dd
RevyOS for Milk-V Pioneerdd
Milk-V Pioneer Box (v1.2)openEuler RISC-V (base system) for Milk-V Pioneer (rootfs on NVMe)dd
openEuler RISC-V (XFCE) for Milk-V Pioneer (rootfs on NVMe)dd
Milk-V Pioneer Box (v1.1)openEuler RISC-V (base system) for Milk-V Pioneer (rootfs on NVMe)dd
openEuler RISC-V (XFCE) for Milk-V Pioneer (rootfs on NVMe)dd
SiFive HiFive UnmatchedSiFive HiFive Unmatched (generic variant)openEuler RISC-V (base system) for SiFive HiFive Unmatcheddd
openEuler RISC-V (XFCE) for SiFive HiFive Unmatcheddd
OpenWrt for SiFive HiFive Unmatcheddd
Sipeed Lichee RVSipeed Lichee RV (generic variant)openEuler RISC-V (base system) for Allwinner D1dd
openEuler RISC-V (XFCE) for Allwinner D1dd
Sipeed LicheePi 4ASipeed LicheePi 4A (8G RAM)openEuler RISC-V (headless) for Sipeed LicheePi 4A (8G RAM)fastboot
openEuler RISC-V (XFCE) for Sipeed LicheePi 4A (8G RAM)fastboot
RevyOS for Sipeed LicheePi 4A (8G RAM)fastboot
Sipeed LicheePi 4A (16G RAM)openEuler RISC-V (headless) for Sipeed LicheePi 4A (16G RAM)fastboot
openEuler RISC-V (XFCE) for Sipeed LicheePi 4A (16G RAM)fastboot
RevyOS for Sipeed LicheePi 4A (16G RAM)fastboot
StarFive VisionFiveStarFive VisionFive (generic variant)openEuler RISC-V (base system) for StarFive VisionFivedd
openEuler RISC-V (XFCE) for StarFive VisionFivedd
StarFive VisionFive2StarFive VisionFive2 (generic variant)openEuler RISC-V (base system) for StarFive VisionFive2dd
openEuler RISC-V (XFCE) for StarFive VisionFive2dd

刷写工具根据板卡的不同依赖 ddfastboot 命令, RUYI 将自动调用 sudo 提权。

需要注意的是一些镜像的解包需要占用大量的磁盘空间,使用 RUYI 工具刷写镜像前请务必留足磁盘空间; 一些厂家提供的镜像在刷写后并不会自动扩展分区来充分利用整块磁盘,而需要用户自行扩展磁盘分区大小。

镜像源换源支持

从 0.5.0 版本开始,可以使用 config.toml 配置 RUYI 包管理器。该文件需要您自行在 ~/.config/ruyi$XDG_CONFIG_HOME/ruyi 目录建立。

[packages]
# 启用 pre-release 软件包
prereleases = false

[repo]
# RuyiSDK 本地元数据路径
# 未配置或配置为空时,默认使用 $XDG_CACHE_HOME/ruyi/packages-index
local = ""

# RuyiSDK 远端元数据仓库
# 未配置或配置为空时,该值将被使用
remote = "https://github.com/RuyiSDK/packages-index.git"

# 远端元数据仓库分支
# 未配置或配置为空时,该值将被使用
branch = "main"

例如当希望使用其他镜像代替默认的镜像时,可以在配置文件中配置 remote 参数:

$ mkdir ~/.config/ruyi
$ cat > ~/.config/ruyi/config.toml <<EOF
[repo]
remote = "https://example.domain/path/repo.git"
EOF