# ARM Lab

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

## Basic Information

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

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2022-07-23
- **Last Updated**: 2024-11-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ARM Lab

## 简介

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

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

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

## 用法

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

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

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

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

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

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

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

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

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

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

vnc 客户端比较推荐 vinagre。

## 联系我们

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

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

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