v0.10.0 版本新增特性
- news items 多语言支持
- 板卡镜像刷写/文档支持增加到 28 款
安装 v0.10.0
在 amd64 架构环境安装：
$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.10.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.10.0/ruyi.riscv64
$ chmod +x ./ruyi.riscv64
$ sudo cp ./ruyi.riscv64 /usr/local/bin/ruyi
在 arm64 架构环境安装：
$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.10.0/ruyi.arm64
$ chmod +x ./ruyi.arm64
$ sudo cp ./ruyi.arm64 /usr/local/bin/ruyi
检查安装版本：
$ ruyi version
Ruyi 0.10.0
Running on linux/x86_64.
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>
This version of ruyi makes use of code licensed under the Mozilla Public
License 2.0 (https://mozilla.org/MPL/2.0/). You can get the respective
project's sources from the project's official website:
* certifi: https://github.com/certifi/python-certifi
i18n 支持
从 0.10.0 版本开始， ruyi news items 将根据运行环境 locales 自动选择显示的语言。
板卡镜像刷写
从 0.10.0 版本开始，板卡镜像刷写功能所支持的板卡增加到 28 款。
本次主要增加了沁恒 RISC-V 单片机系列的文档支持。
板卡支持列表：
| 开发板 | 版本 | 镜像 | 刷写方式 |
|---|---|---|---|
| Allwinner Nezha D1 | Allwinner Nezha D1 (generic variant) | openEuler RISC-V (base system) for Allwinner D1 | dd |
| openEuler RISC-V (XFCE) for Allwinner D1 | dd | ||
| Canaan Kendryte K230 | Canaan Kendryte K230 (generic variant) | Canaan Kendryte K230 Official CanMV Debian SDK | dd |
| Canaan Kendryte K510 | Canaan Kendryte K510 (generic variant) | Canaan Kendryte K510 Official Buildroot SDK (documentation-only) | |
| Canaan Kendryte K230 Official CanMV Ubuntu SDK | dd | ||
| Milk-V Duo | Milk-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 Duo S | Milk-V Duo S (generic variant) | Milk-V Duo S Official buildroot SDK (FreeRTOS, on SD card) | dd |
| Milk-V Mars | Milk-V Mars (generic variant) | Milk-V Mars Official Debian Desktop SDK (on SD card) | dd |
| Milk-V Mars CM | Milk-V Mars CM (generic variant) | Milk-V Mars CM Official Debian Desktop SDK (on SD card) | dd |
| Milk-V Meles | Milk-V Meles (4G RAM) | RevyOS for Milk-V Meles (4G RAM) | fastboot |
| Milk-V Meles (8G RAM) | RevyOS for Milk-V Meles (8G RAM) | fastboot | |
| Milk-V Vega | Milk-V Vega (generic variant) | Milk-V Vega Official Buildroot SDK (documentation-only) | |
| Milk-V Pioneer Box | Milk-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 Pioneer | dd | ||
| 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 Unmatched | SiFive HiFive Unmatched (generic variant) | openEuler RISC-V (base system) for SiFive HiFive Unmatched | dd |
| openKylin for SiFive HiFive Unmatched | dd | ||
| openEuler RISC-V (XFCE) for SiFive HiFive Unmatched | dd | ||
| OpenWrt for SiFive HiFive Unmatched | dd | ||
| Ubuntu Server for SiFive HiFive Unmatched | dd | ||
| Sipeed Lichee Cluster 4A | Sipeed Lichee Cluster 4A (8G RAM) | RevyOS for Sipeed Lichee Cluster 4A (8G RAM) | fastboot |
| Sipeed Lichee Cluster 4A (16G RAM) | RevyOS for Sipeed Lichee Cluster 4A (16G RAM) | fastboot | |
| Sipeed Lichee Console 4A | Sipeed Lichee Console 4A (8G RAM) | RevyOS for Sipeed Lichee Console 4A (8G RAM) | fastboot |
| Sipeed Lichee Console 4A (16G RAM) | RevyOS for Sipeed Lichee Console 4A (16G RAM) | fastboot | |
| Sipeed Lichee RV | Sipeed Lichee RV (generic variant) | openEuler RISC-V (base system) for Allwinner D1 | dd |
| openEuler RISC-V (XFCE) for Allwinner D1 | dd | ||
| Sipeed LicheeRV Nano | Sipeed LicheeRV Nano (generic variant) | Sipeed LicheeRV Nano Official buildroot SDK (Linux & FreeRTOS) | dd |
| Debian for Sipeed LicheeRV Nano (from https://github.com/Fishwaldo) | dd | ||
| Sipeed Maix-I | Sipeed Maix-I (generic variant) | Sipeed Maix-I Official FreeRTOS SDK (documentation-only) | |
| Sipeed Tang Mega 138K Pro | Sipeed Tang Mega 138K Pro (generic variant) | Sipeed Tang Mega 138K Pro FPGA & FreeRTOS SDK (documentation-only) | |
| Sipeed Tang Mega 138K Pro FPGA & RT-Thread SDK (documentation-only) | |||
| Sipeed LicheePi 4A | Sipeed 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 VisionFive | StarFive VisionFive (generic variant) | openEuler RISC-V (base system) for StarFive VisionFive | dd |
| openEuler RISC-V (XFCE) for StarFive VisionFive | dd | ||
| StarFive VisionFive2 | StarFive VisionFive2 (generic variant) | openEuler RISC-V (base system) for StarFive VisionFive2 | dd |
| openEuler RISC-V (XFCE) for StarFive VisionFive2 | dd | ||
| WCH CH32V103 EVB | WCH CH32V103 EVB (CH32V103C6T6) | WCH CH32V103 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V103 EVB FreeRTOS PlatformIO SDK (documentation-only) | |||
| WCH CH32V103 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V103 EVB (CH32V103C8T6) | WCH CH32V103 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V103 EVB FreeRTOS PlatformIO SDK (documentation-only) | |||
| WCH CH32V103 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V103 EVB (CH32V103C8U6) | WCH CH32V103 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V103 EVB FreeRTOS PlatformIO SDK (documentation-only) | |||
| WCH CH32V103 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V103 EVB (CH32V103R8T6) | WCH CH32V103 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V103 EVB FreeRTOS PlatformIO SDK (documentation-only) | |||
| WCH CH32V103 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB | WCH CH32V203 EVB (CH32V203C6T6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203C8T6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203C8U6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203F6P6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203F8P6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203F8U6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203G6U6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203G8R6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203K6T6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203K8T6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V203 EVB (CH32V203RBT6) | WCH CH32V203 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V203 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V208 EVB | WCH CH32V208 EVB (CH32V208CBU6) | WCH CH32V208 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V208 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V208 EVB (CH32V208GBU6) | WCH CH32V208 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V208 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V208 EVB (CH32V208RBT6) | WCH CH32V208 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V208 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V208 EVB (CH32V208WBU6) | WCH CH32V208 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V208 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V303 EVB | WCH CH32V303 EVB (CH32V303CBT6) | WCH CH32V303 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V303 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V303 EVB (CH32V303RBT6) | WCH CH32V303 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V303 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V303 EVB (CH32V303RCT6) | WCH CH32V303 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V303 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V303 EVB (CH32V303VCT6) | WCH CH32V303 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V303 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V305 EVB | WCH CH32V305 EVB (CH32V305FBP6) | WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | |||
| WCH CH32V305 EVB (CH32V305GBU6) | WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | |||
| WCH CH32V305 EVB (CH32V305RBT6) | WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V305 EVB FreeRTOS SDK (documentation-only) | |||
| WCH CH32V307 EVB | WCH CH32V307 EVB (CH32V307RCT6) | WCH CH32V307 EVB FreeRTOS SDK (documentation-only) | |
| WCH CH32V307 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V307 EVB (CH32V307WCU6) | WCH CH32V307 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V307 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH32V307 EVB (CH32V307VCT6) | WCH CH32V307 EVB FreeRTOS SDK (documentation-only) | ||
| WCH CH32V307 EVB RT-Thread SDK (documentation-only) | |||
| WCH CH582F EVB | WCH CH582F EVB (generic variant) | WCH CH582F EVB FreeRTOS SDK (documentation-only) | |
| WCH CH582F EVB RT-Thread SDK (documentation-only) | |||
| WCH CH592X EVB | WCH CH592X EVB (generic variant) | WCH CH592X EVB FreeRTOS SDK (documentation-only) | |
| WCH CH592X EVB RT-Thread SDK (documentation-only) |
刷写工具根据板卡的不同依赖 dd 和 fastboot 命令。
在使用普通用户调用 dd 命令刷写镜像失败时，RUYI 将尝试调用 sudo 提权。
在使用 fastboot 工具刷写镜像时， RUYI 则只会使用当前普通用户，故需要用户自行配置 udev 规则。这里提供示例规则仅供参考：
SUBSYSTEM=="usb", ATTR{idVendor}="2345", ATTR{idProduct}=="7654", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}="1234", ATTR{idProduct}=="8888", MODE="0666", GROUP="plugdev"
需要注意的是一些镜像的解包需要占用大量的磁盘空间，使用 RUYI 工具刷写镜像前请务必留足磁盘空间； 一些厂家提供的镜像在刷写后并不会自动扩展分区来充分利用整块磁盘，而需要用户自行扩展磁盘分区大小。