# RISC-V Lab

**Repository Path**: tinylab/riscv-lab

## Basic Information

- **Project Name**: RISC-V Lab
- **Description**: RISC-V 实验室，允许在 X86_64 主机上直接运行一个 RISC-V Linux 桌面系统，支持 lxqt, xfce 桌面，内置 gcc, gdb 等开发工具，方便在没有 RISC-V 硬件的情况下直接开展 RISC-V 软件开发。其用法跟 Linux Lab 类似，也可以在泰晓 Linux 实验盘下运行。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2022-07-20
- **Last Updated**: 2024-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RISC-V Lab

## 简介

该实验环境用于 RISC-V 系统与软件开发，如需开展 RISC-V 内核与 QEMU 开发，可使用 [Linux Lab][002]。

RISC-V Lab 可以于 10 秒内在 X86 主机上跨架构跑起一个 RISC-V 桌面系统，基础系统是 Ubuntu 22.04，已支持 lxqt, xfce 桌面，并内置有 gcc, gdb 等开发工具，适合 RISC-V 本地开发，能有效避免交叉编译的烦恼。

该开源项目目前还在紧张开发中，未来会集成各种 RISC-V 本地学习资源，欢迎大家使用并提交 Bug Report 和 Pull Request。

## 用法

RISC-V Lab 跟 Linux Lab 一样，基于 [Cloud Lab][001]，虽然跨架构，但是实验环境的使用跟 Linux Lab 一样简单，这里不做深入介绍，建议参考 [Linux Lab 手册][004] 中对应的章节。

下面简单演示如何快速跑起来一套 RISC-V Lab，注意，请事先准备好 Docker 和 Git。

```
$ git clone https://gitee.com/tinylab/cloud-lab.git
$ cd cloud-lab
$ tools/docker/run riscv-lab
```

默认会启用 xfce 桌面，如果想体验 lxqt，运行时或者再次运行时可以这样指定：

```
// 启用 lxqt 桌面
$ DESKTOP=lxqt tools/docker/run riscv-lab

// 用回 xfce 桌面
$ DESKTOP=xfce tools/docker/rerun riscv-lab
```

可选登陆方式比较多，有 bash, ssh, vnc, webvnc, webssh，其中的 ssh, vnc 和 webvnc 可运行图形软件。

```
// 明确指定某种方式
$ tools/docker/bash riscv-lab
$ tools/docker/ssh riscv-lab
$ tools/docker/vnc riscv-lab
$ tools/docker/webssh riscv-lab
$ tools/docker/webvnc riscv-lab

// 或者这样
$ LOGIN=bash tools/docker/login riscv-lab

// 又或者
$ LOGIN=bash tools/docker/run riscv-lab
```

vnc 客户端比较推荐 vinagre。

## 联系我们

如果想参与 RISC-V Lab 的交流与开发，联系我们吧。

* 微信：tinylab
* 邮箱：contact@tinylab.org

另外，也欢迎参加相关的开源活动：[RISC-V Linux 内核剖析][003]，持续招募实习生和兼职工程师呢。

[001]: https://gitee.com/tinylab/cloud-lab
[002]: https://gitee.com/tinylab/linux-lab
[003]: https://gitee.com/tinylab/riscv-lab
[004]: https://tinylab.org/pdfs/linux-lab-v1.0-manual-zh.pdf