diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 93898183..0d703a4f 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -60,7 +60,8 @@ export default defineConfig({ { text: 'v0.5.0 版本新增特性', link: '/zh/ruyi/updates/0.5.0' }, { text: 'v0.6.0 版本新增特性', link: '/zh/ruyi/updates/0.6.0' }, { text: 'v0.7.0 版本新增特性', link: '/zh/ruyi/updates/0.7.0' }, - { text: 'v0.8.1 版本新增特性', link: '/zh/ruyi/updates/0.8.1' } + { text: 'v0.8.1 版本新增特性', link: '/zh/ruyi/updates/0.8.1' }, + { text: 'v0.9.0 版本新增特性', link: '/zh/ruyi/updates/0.9.0' } ] } ] diff --git a/docs/zh/ruyi/updates/0.8.1.md b/docs/zh/ruyi/updates/0.8.1.md index e9c4a432..b022e4b5 100644 --- a/docs/zh/ruyi/updates/0.8.1.md +++ b/docs/zh/ruyi/updates/0.8.1.md @@ -1,7 +1,7 @@ # v0.8.1 版本新增特性 + 从 0.8.0 版本开始，默认不允许以 root 用户运行 ruyi -+ 新增 Milkv-V Meles 板块刷写，板卡镜像刷写支持增加到 14 款 ++ 新增 Milkv-V Meles 板卡刷写，板卡镜像刷写支持增加到 14 款 ## 安装 v0.8.1 diff --git a/docs/zh/ruyi/updates/0.9.0.md b/docs/zh/ruyi/updates/0.9.0.md new file mode 100644 index 00000000..77dcc173 --- /dev/null +++ b/docs/zh/ruyi/updates/0.9.0.md @@ -0,0 +1,113 @@ +# v0.9.0 版本新增特性 + ++ 支持了 LZ4 格式压缩文件的解包 ++ RuyiSDK 自 0.9 版本开始支持矽速（Sipeed）全线 RISC-V 产品，板卡镜像刷写支持增加到 20 款 + +## 安装 v0.9.0 + +在 amd64 架构环境安装： + +```bash +$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.9.0/ruyi.amd64 +$ chmod +x ./ruyi.amd64 +$ sudo cp ./ruyi.amd64 /usr/local/bin/ruyi +``` + +在 riscv64 架构环境安装： + +```bash +$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.9.0/ruyi.riscv64 +$ chmod +x ./ruyi.riscv64 +$ sudo cp ./ruyi.riscv64 /usr/local/bin/ruyi +``` + +在 arm64 架构环境安装： + +```bash +$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.9.0/ruyi.arm64 +$ chmod +x ./ruyi.arm64 +$ sudo cp ./ruyi.arm64 /usr/local/bin/ruyi +``` + +检查安装版本： + +```bash +$ ruyi version +Ruyi 0.9.0 + +Running on linux/x86_64. + +Copyright (C) 2023 Institute of Software, Chinese Academy of Sciences (ISCAS). +All rights reserved. +License: Apache-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 + +``` + +## 板卡镜像刷写 + +从 0.9.0 版本开始，板卡镜像刷写功能所支持的板卡增加到 20 款。 + +板卡支持列表： + +| 开发板 | 版本 | 镜像 | 刷写方式 | +|:-:|:-:|:-:|:-:| +| 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 | + +刷写工具根据板卡的不同依赖 ``dd`` 和 ``fastboot`` 命令， RUYI 将自动调用 ``sudo`` 提权。 + +需要注意的是一些镜像的解包需要占用大量的磁盘空间，使用 RUYI 工具刷写镜像前请务必留足磁盘空间； +一些厂家提供的镜像在刷写后并不会自动扩展分区来充分利用整块磁盘，而需要用户自行扩展磁盘分区大小。 +