# loongarch-lab

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

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-05
- **Last Updated**: 2024-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LoongArch Lab

## 简介

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

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

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

## 用法

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

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

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

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

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

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

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

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

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

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

vnc 客户端比较推荐 vinagre。

## 联系我们

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

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

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