README.en.md · 泰晓科技/RISC-V Lab

# 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).

泰晓科技/RISC-V Lab

简介

发行版

贡献者

近期动态

泰晓科技/RISC-V Lab .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

泰晓科技/RISC-V Lab