# riscv

**Repository Path**: sunmin89/riscv

## Basic Information

- **Project Name**: riscv
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2024-07-24
- **Last Updated**: 2025-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<table><tr>
<td><img src="doc/images/512px-openGauss-logo.png" alt="openGauss logo" style="height:200px;" /></td>
<td><img src="doc/images/512px-RISC-V-logo-square.png" alt="RISC-V logo" style="height:200px;" /></td>
</tr></table>

## 项目简介

openGauss RISC-V 是由 openGauss RISC-V SIG 负责开展进行的项目。项目旨在推进 openGauss 各个功能模块在 RISC-V 上的移植与优化工作。项目目前以openGauss 5.1.0和6.0.0为基底，初步完成了在openGauss轻量版在RISC-V上的移植工作。

## 编译与安装

编译与安装的过程参见[此文档](./installation.md)。该文档描述了对本项目进行编译和安装的大概步骤，并给出了简单的测试步骤。

详细的测试步骤见[此文档](./test/openGauss_RISC-V_Test_Report/test.md)、[测试报告](./test/openGauss_RISC-V_Test_Report/main.md)。

在x86_64平台上（通过Docker和QEMU二进制翻译）进行编译和安装的详细步骤见[此文档](./test/deploy-on-x86_64/main.md)。

## 分支说明

本仓库维护[master](https://gitee.com/opengauss/riscv/tree/master)分支，该分支也是openGauss RISC-V中openGauss.riscv64包的上游。

标签[v5.1.0](https://gitee.com/opengauss/riscv/tree/v5.1.0)和[v6.0.0](https://gitee.com/opengauss/riscv/tree/v6.0.0)对应了openGauss的两个版本。

## 文件分布

```
.
├── doc # 用于顶层目录的撰写
│   └── images # 文档撰写的图片资产
└── test
    ├── deploy-on-x86_64 # 在x86_64平台上部署测试环境的文档
    │   └── openeuler-docker-opengauss-riscv64 # 通过docker容器构建openGauss riscv容器的尝试
    ├── deploy-with-RAG # 通过openGauss RISC-V部署RAG的尝试
    ├── openGauss-lite_6.0.0_on_VisionFive2_test # openGauss RISC-V 在 VisionFive2 上的可用性测试文档
    ├── openGauss_RISC-V_Test_Report # openGauss RISC-V 在 Milk-V Pioneer Box 和 Sipeed LicheePi 4A 上的可用性测试文档
    │   ├── image
    │   └── logs
    └── sql
```

## 路线图
- [ ] 目标1：基于 openGauss-third_party 的工具链编译 openGauss-server 5.1.0， 并且能运行在当前(2024年)主流 RISC-V 硬件、qemu-riscv64、RISC-V 容器环境，且能通过（[QA](https://gitee.com/opengauss/QA)）中描述的基础用例，达到较高的功能完整性，兼容性和稳定性等

    | openGauss 5.1.0支持矩阵 | openEuler22.03 | openEuler24.03 | Fedora38 |
    | ----------------------- | -------------- | -------------- | -------- |
    | SG2042                  |                |                |
    | TH1520                  |                |                |
    | SpaceMit M1             |                |                |
    | qemu-riscv64            |                |                |
    | 容器环境                |                |                |


- [ ] 目标2：让 openGauss-server 主分支 代码运行在新的主流 RISC-V 硬件运行
- [ ] 目标3: 本仓库代码合入上游主分支，让 RISC-V 成为 openGauss 正式发行版架构

目前的主要任务是让让本仓库代码合并进入上游[主分支](https://gitee.com/opengauss/openGauss-server/tree/master)，以期籍此复用上游的测试流程。

我们在[third-party](https://gitee.com/opengauss/openGauss-third_party/)上的工作需要优先进行主线化。

（主线化意味着我们需要将本仓库的工作拆解出来，提交到上游主线中。）

## 许可证

[木兰宽松许可证，第2版](./LICENSE)