# riscv

**Repository Path**: opengauss/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**: 5
- **Forks**: 11
- **Created**: 2024-07-12
- **Last Updated**: 2025-08-15

## 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
```

## 路线图

目前的主要任务是让让本仓库代码合并进入上游[主分支](https://gitee.com/opengauss/openGauss-server/tree/master)，以期籍此复用上游的测试流程。我们在[third-party](https://gitee.com/opengauss/openGauss-third_party/)上的工作需要优先进行主线化。

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

- [x] 基于 openEuler 系统自带工具链编译 openGauss-server 5.1.0

    | openGauss 5.1.0 (轻量版) 支持矩阵 | openEuler23.09 | openEuler24.03 |
    | ----------------------- | -------------- | -------------- |
    | SG2042                  |       :white_check_mark:      |        :white_check_mark:       |
    | 容器环境                 |       :white_check_mark:      |        :white_check_mark:       |
 

- [x] 基于 openEuler/Fedora 系统自带工具链编译 openGauss-server 6.0.0

    | openGauss 6.0.0 (轻量版) 支持矩阵 | openEuler23.09 | openEuler24.03 | Fedora41 |
    | ----------------------- | -------------- | -------------- | -------- |
    | SG2042                  |       N/A      |  :white_check_mark:  | :white_check_mark: |
    | LicheePi 4A             |       N/A      |  :white_check_mark:  |   N/A    |
    | VisionFive 2            |       N/A      |  :white_check_mark:  |   N/A    |
    | qemu-system-riscv64     |       N/A      |  :white_check_mark:  |   N/A    |
    | 容器环境                 |:white_check_mark:|:white_check_mark:  |   :white_check_mark:    |

- [x] 把 openGauss-third_party 工具链适配到 RISC-V 架构

- [ ] 基于 openGauss-third_party 的工具链编译 openGauss-server 6.0.0 `全量版`

- [ ] 把 openGauss-third_party 同步到 openGauss-third_party 主线

- [ ] 把本仓库的开发补丁、测试文档同步到 openGauss-server 主分支

- [ ] 推动 RISC-V 成为 openGauss 正式发行版架构

## 许可证

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