Merge pull request #27 from xijing21/main

add plan and gnu

README.md

@@ -8,14 +8,12 @@
 
 docs仓库采用vitepress技术将Markdown格式的文档自动生成为web页面，结合github-pages 设置，能够自动将文档更新进行发布。
 
-
 ### 仓库目录介绍
 
 - docs ： Markdown文档；采用分级管理。
   - .vitepress/config.mts : 目录索引定义。
 - build ：根据Markdown文档构建的html网页。
 
-
 ### 贡献文档
 
 欢迎大家一起参与RUYISDK文档贡献。贡献方法：
@@ -24,9 +22,8 @@ docs仓库采用vitepress技术将Markdown格式的文档自动生成为web页
 2. 在docs/docs/zh 目录下按需新建目录和markdown文档，或者修改已有的markdown文档；
 3. 修改docs/docs/.vitepress/config.mts 文档调整目录；
 4. 提交修改并创建pull request将文档贡献提交到docs仓库，等待仓库管理员审核合入；
-5. pr被合入后大约几十秒或几分钟后，访问 https://ruyisdk.github.io/docs/zh 检查网页是否更新。
-
+5. pr被合入后大约几十秒或几分钟后，访问 https://ruyisdk.github.io/docs 检查网页是否更新。
 
 ## 访问docs网站
-https://ruyisdk.github.io/docs/zh
 
+网址：https://ruyisdk.github.io/docs

docs/.vitepress/config.mts

@@ -15,9 +15,13 @@ export default defineConfig({
           { text: '文档', link: '/zh/introduction/' }
         ],
         sidebar: [
-          { text: '介绍', link: '/zh/introduction/' },
-          {
-            text: '工具',
+          { text: '介绍', 
+            items: [
+              { text: 'RUYISDK 简介', link: '/zh/introduction/' },
+              { text: '版本规划路线图', link: '/zh/plan/' },
+            ]
+          },
+          { text: '工具',
             items: [
               {
                 text: 'RUYI 包管理器',
@@ -49,6 +53,24 @@ export default defineConfig({
               }
             ]
           },
+          { text: 'RuyiSDK',
+            items: [
+              {
+                text: 'GNU',
+                link: '/zh/sdk/gnu/',
+                items: [
+                  { text: 'GNU Upstream', link: '/zh/sdk/gnu/' },
+                ]
+              },
+              {
+                text: 'LLVM',
+                link: '/zh/sdk/llvm/',
+                items: [
+                  { text: 'LLVM Upstream', link: '/zh/sdk/llvm/' },
+                ]
+              }
+            ]
+          }
         ],
       }
     },

docs/zh/plan/index.md

@@ -11,12 +11,12 @@ RUYISDK 目前以每半年为一个里程碑版本周期来推动RUYISDK的不
 * V0.3  （计划发布时间：2024年6月）
 * V0.4  （计划发布时间：2024年12月）
 * V1.0  （计划发布时间：2025年6月）
-
+* V2.0  （计划发布时间：2025年12月）
 
 ## RUYISDK 路线图
 
 ### 包管理器
 
 ### IDE
 
-### 开发者社区
+### 开发者社区

docs/zh/sdk/gnu/index.md

@@ -0,0 +1,63 @@
+# RUYISDK GCC 工具链介绍
+
+RUYISDK GCC 工具链是专门用于 RISC-V 架构的 GNU 工具链，它包括一系列工具，如编译器、汇编器、链接器等，用于开发和构建 RISC-V 架构的软件。
+
+## 模块介绍
+
+### GCC（GNU Compiler Collection）
+
+**功能：** RISC-V GNU Toolchain 的核心组件之一，用于将高级编程语言（如 C、C++）的源代码翻译成 RISC-V 架构的目标代码。
+
+**支持：** 提供对不同 RISC-V 位长的支持，包括 RV32（32 位）和 RV64（64 位），以及不同RISC-V 指令集扩展的支持。
+
+**详细使用说明参考：** https://gcc.gnu.org/onlinedocs/gcc-13.2.0/gcc/
+
+### GNU Binutils
+
+包含工具： 汇编器（as）、链接器（ld）、目标文件工具（objdump、objcopy 等），性能分析工具（gprof）。
+
+**功能：** 用于处理生成 RISC-V 架构的目标文件，执行汇编和链接，反汇编等操作。
+
+**详细使用说明参考：** https://sourceware.org/binutils/docs-2.41/
+
+### GDB（GNU Debugger）
+
+**功能：** 提供调试功能，允许开发人员在 RISC-V 目标上调试他们的程序。
+
+### Glibc（GNU C Library）
+
+**功能：** C 语言运行时库，提供许多标准 C 库函数的实现，以支持在 RISC-V 上运行的程序。
+
+### Newlib
+
+**功能：** 一个小型的 C 库，适用于嵌入式系统和其他资源受限的环境。对于一些嵌入式RISC-V 系统，选择使用 Newlib 而不是 Glibc 可以更高效的利用有限的系统资源。
+
+### Libgcc
+
+**功能：** 包含一些与编译**功能：**器紧密相关的支持函数，例如用于浮点数乘除法的模拟运算函数。
+
+目前 RUYISDK 包含三种工具链版本，分别为 GNU upstream 版本，Xuantie 版本以及RUYISDK 版本，不同版本支持的 RISC-V 指令集有所不同。
+
+GNU upstream 工具链适合面向最新 RISC-V 特性的开发者，Xuantie 工具链侧重于使用 Xuantie 系列 CPU 芯片的硬件，RUYISDK 工具链侧重于提供稳定的工具链环境，尽可能的继承目前 RISC-V 的各个扩展与新特性。
+
+## 使用说明
+
+工具链中各个工具的使用方法请参考其使用说明文档，下面重点介绍 RISC-V 架构的一些常见用法：
+
+* -march 选项可以控制工具链开启的 RISC-V 扩展，其默认参数在 64 位工具链中为 `rv64gc`, 32 位工具链中为 `rv32gc`, 若要开启其他扩展，则需利用该选项重新向工具链指定想要开启的扩展，例如打开 V 扩展可以使用-march=rv64gcv，打开 b 扩展可以使用 `-march=rv64gc_zba_zbb_zbc_zbs，`
+  RUYISDK 中不同扩展的工具链已经在-march 中配置了其对应参数，方便用户直接使用，用户可以根据自身需求调整-march 输入，控制不同扩展的使用。
+* -mabi 选项主要控制工具链中所使用的寄存器组，其默认参数在 64 位工具链中为 `lp64d`，32 位工具链中为 `ilp32d`，嵌入式设备中为 `lp64e`, `ilp32e`, 无浮点硬件中为 `lp64`, `ilp32`, 用户可以根据自身硬件和使用场景进行选择。
+  使用 RVV 向量扩展时，请务必同时使用 `-O3` 选项，在编译器中开启 RVV 的向量化特性，一些 RVV 使用示例请参考：https://gcc.gnu.org/git/?p=gcc.git;a=tree;f=gcc/testsuite/gcc.target/riscv/rvv
+
+下面我们来介绍 RVV 使用时的两个常用参数：
+
+* --param=riscv-autovec-preference=用于告知编译器输入向量的长度，有已知固定向量长度的 `fixed-vlmax`输入与可伸缩向量不固定长度的 `scalable`输入，用户可以更具自己的程序进行调整，以获得更高的程序性能。
+* --param=riscv-autovec-lmul=用于指定一个循环迭代中处理的向量元素的数量，其输入参数可以参考 riscv-v-spec 手册，包括”dynamic,m1,m2,m4,m8”等，对于不熟悉参数的用户，建议使用 `dynamic`选项，由编译器自动配置选取合适的处理数量。
+
+## 扩展支持
+
+| 工具链版本 | 扩展名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Upstream   | i, m, a, f, d, c, v, e(注意指定对应的 eABI）`<br>` zicsr, zifencei, zicond, zawrs, zba, zbb, zbc, zbs `<br>`zfinx, zdinx, zhinx, zhinxmin(注意指定的 ABI 为 lp64 或 ilp32, 与 f/d 扩展不兼容)`<br>`zbkb, zbkc, zbkx, zknd, zkne, zknh, zkr, zksed, zksh, zkt `<br>`zihintntl, zihintpause, zicboz, zicbom, zicbop `<br>`zfh, zfhmin, zvfh, zvfhmin, zvbb, zvbc, zvkg, zvkned, zvknha, zvknhb, zvksed, zvksh `<br>`zvknc, zvksc, zvkt, zfa, zmmul, zca, zcb, zce, zcf(仅 RV32)`<br>`zcd, zcmp(与 zcd 不兼容), zcmt, ztso `<br>`svinval, svnapot, `<br>`xcvmac, xcvalu, `<br>`xtheadba, xtheadbb, xtheadbs, xtheadcmo, xtheadcondmov, xtheadfmv, `<br>`xtheadint, xtheadmac, xtheadmemidx, xtheadfmemidx, `<br>`xtheadmempair, xtheadsync, xventanacondops |
+| Xuantie    | 对 xtheadba, xtheadbb, xtheadbs, xtheadcmo, xtheadcondmov, xtheadfmv,`<br>`xtheadint, xtheadmac, xtheadmemidx,`<br>`xtheadfmemidx, xtheadmempair, xtheadsync, xventanacondops `<br>`有特定优化，不支持 Zfinx, K, V, Zc, Xcv 等系列扩展                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| RUYISDK    | 额外支持 RV64-ILP32, Profiles(RV20/22), zpn, zpsfoperand, zbpbo                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

docs/zh/sdk/llvm/index.md

@@ -0,0 +1,3 @@
+# RUYISDK LLVM 工具链介绍
+
+> todo