# 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**: 4
- **Forks**: 0
- **Created**: 2022-07-20
- **Last Updated**: 2024-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RISC-V Lab

## Introduction

This lab is designed for RISC-V system and software learning and development, to develop RISC-V Linux kernel or QEMU, please try [Linux Lab](https://gitee.com/tinylab/linux-lab) instead.

RISC-V Lab can boot a RISC-V Linux desktop system in a X86_64 computer and only costs 10 seconds, it runs Ubuntu 22.04 with lxqt, xfce, and also integrates toolchains like gcc and gdb, which is suitable for local RISC-V software development, without any annoyance in cross development.

This open source project is still in development stage, welcome your bug report and pull request.

## Usage

Just like Linux Lab, RISC-V Lab also uses [Cloud Lab](https://gitee.com/tinylab/cloud-lab) as the running framework, although runs system across different CPU architectures, the usage is still as simple as Linux Lab. To learn more detailed usage, please refer to the related chapters in [the manual of Linux Lab](https://tinylab.org/pdfs/linux-lab-v1.0-manual-en.pdf).

Before run it, please prepare Docker and Git at first, then:

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

By default, it uses the xfce4 desktop, if want to try another desktop, please:

```
// use lxqt
$ DESKTOP=lxqt tools/docker/run riscv-lab

// use xfce back
$ DESKTOP=xfce tools/docker/run riscv-lab
```

It supports serveral login methods, includes bash, ssh, vnc, webvnc, webssh，and among them, the ssh, vnc and webvnc methods support GUI softwares.

```
// Use one of them like this
$ 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

// Or
$ LOGIN=bash tools/docker/login riscv-lab

// Or
$ LOGIN=bash tools/docker/run riscv-lab
```

one of the recommended vnc clients is vinagre.

## Contact

If want to learn more about RISC-V Lab or even want to contribute something, try:

* Wechat: tinylab
* Email: contact@tinylab.org

BTW, also welcome to join our open source activity: [RISC-V Linux 内核剖析](https://gitee.com/tinylab/riscv-lab).