From 8903375d9954cca2f84db8c1ca083dd2162cebc2 Mon Sep 17 00:00:00 2001 From: weilinfox Date: Mon, 20 May 2024 14:29:52 +0800 Subject: [PATCH 1/2] Fix typo Signed-off-by: weilinfox --- docs/zh/ruyi/updates/0.10.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/ruyi/updates/0.10.0.md b/docs/zh/ruyi/updates/0.10.0.md index 99fa4ee6..8d52b664 100644 --- a/docs/zh/ruyi/updates/0.10.0.md +++ b/docs/zh/ruyi/updates/0.10.0.md @@ -1,4 +1,4 @@ -# v0.9.0 版本新增特性 +# v0.10.0 版本新增特性 + news items 多语言支持 + 板卡镜像刷写/文档支持增加到 28 款 From c4774ec912d2fe9b098a04b1d804b684681d184a Mon Sep 17 00:00:00 2001 From: weilinfox Date: Fri, 31 May 2024 10:30:40 +0800 Subject: [PATCH 2/2] Add 0.11.0 docs Signed-off-by: weilinfox --- docs/.vitepress/config.mts | 3 +- docs/zh/ruyi/updates/0.11.0.md | 192 +++++++++++++++++++++++++++++++++ 2 files changed, 194 insertions(+), 1 deletion(-) create mode 100644 docs/zh/ruyi/updates/0.11.0.md diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index cd2a0307..1b4addf5 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -62,7 +62,8 @@ export default defineConfig({ { text: 'v0.7.0 版本新增特性', link: '/zh/ruyi/updates/0.7.0' }, { text: 'v0.8.1 版本新增特性', link: '/zh/ruyi/updates/0.8.1' }, { text: 'v0.9.0 版本新增特性', link: '/zh/ruyi/updates/0.9.0' }, - { text: 'v0.10.0 版本新增特性', link: '/zh/ruyi/updates/0.10.0' } + { text: 'v0.10.0 版本新增特性', link: '/zh/ruyi/updates/0.10.0' }, + { text: 'v0.11.0 版本新增特性', link: '/zh/ruyi/updates/0.11.0' } ] } ] diff --git a/docs/zh/ruyi/updates/0.11.0.md b/docs/zh/ruyi/updates/0.11.0.md new file mode 100644 index 00000000..5bc38c7f --- /dev/null +++ b/docs/zh/ruyi/updates/0.11.0.md @@ -0,0 +1,192 @@ +# v0.11.0 版本新增特性 + ++ 板卡镜像刷写/文档支持增加到 29 款 + +注意 0.11.0 版本会忽略 ``XDG_STATE_HOME`` 环境变量，如果在意这个问题请跳过这个版本，具体可以查看 [issue #151](https://github.com/ruyisdk/ruyi/issues/151)。 + +## 安装 v0.11.0 + +在 amd64 架构环境安装： + +```bash +$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.11.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.11.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.11.0/ruyi.arm64 +$ chmod +x ./ruyi.arm64 +$ sudo cp ./ruyi.arm64 /usr/local/bin/ruyi +``` + +检查安装版本： + +```bash +$ ruyi version +Ruyi 0.11.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.11.0 版本开始，板卡镜像刷写功能所支持的板卡增加到 29 款。 + +新增 Pine64 Star64 的 Armbian 镜像。 + +板卡支持列表： + +| 开发板 | 版本 | 镜像 | 刷写方式 | +|:-:|:-:|:-:|:-:| +| 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) | | +| Pine64 Star64 | Pine64 Star64 (generic variant) | Armbian for Pine64 Star64 | dd | +| 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 工具刷写镜像前请务必留足磁盘空间； +一些厂家提供的镜像在刷写后并不会自动扩展分区来充分利用整块磁盘，而需要用户自行扩展磁盘分区大小。 +