# QEMU<a name="EN-US_TOPIC_0000001101286951"></a>

-   [Introduction](#section11660541593)
-   [Constraints](#section119744591305)
-   [QEMU Install](#section119744591307)
-   [Usage](#section169045116126)
-   [Contribution](#section169045116136)
-   [Repositories Involved](#section1371113476307)

## Introduction<a name="section11660541593"></a>

Quick Emulator \(QEMU\) can simulate the scenario where a kernel runs on different boards, so that the kernel no longer depends on physical development boards.

## Constraints<a name="section119744591305"></a>

QEMU applies only to the OpenHarmony kernel.

## QEMU Install<a name="section119744591307"></a>

1. Install dependencies(Ubuntu 18+)

   ```
   sudo apt install build-essential zlib1g-dev pkg-config libglib2.0-dev  binutils-dev libboost-all-dev autoconf libtool libssl-dev libpixman-1-dev virtualenv flex bison
   ```

2. Acquiring Source Code

   ```
   wget https://download.qemu.org/qemu-6.2.0.tar.xz
   ```

   or

   [Download from official website: qemu-6.2.0.tar.xz](https://download.qemu.org/qemu-6.2.0.tar.xz)

3. Compile and install

   ```
   tar -xf qemu-6.2.0.tar.xz
   cd qemu-6.2.0
   mkdir build && cd build
   ../configure --prefix=qemu_installation_path
   make -j16
   ```

   Wait for the compilation to finish and execute the installation command:

   ```
   make install
   ```

   Finally, add the installation path to the environment variable:

   ```
   vim ~/.bashrc
   ```

   Add the following command line to the last line of ~/.bashrc:

   ```
   export PATH=$PATH:qemu_installation_path
   ```

## Usage<a name="section169045116126"></a>

For details about the ARM architectures:
- [Qemu ARM Virt HOWTO - liteos_a](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_virt/liteos_a/README.md)
- [Qemu ARM Virt HOWTO - linux](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_virt/linux/README.md)

For details about the Cortex-m4 architecture, see  [Qemu Cortex-m4 mps2-an386 HOWTO](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_mps2_an386/README.md).

For details about the Cortex-m55 architecture, see  [Qemu Cortex-m55 mps3-an547 HOWTO](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_mps3_an547/README.md).

For details about the RISC-V architecture, see  [Qemu RISC-V Virt HOWTO](https://gitee.com/openharmony/device_qemu/blob/HEAD/riscv32_virt/README.md).

For details about the Xtensa architecture, see  [Qemu Xtensa Virt HOWTO](https://gitee.com/openharmony/device_qemu/blob/HEAD/esp32/README.md).

For details about the C-SKY architecture, see  [Qemu C-SKY Virt HOWTO](https://gitee.com/openharmony/device_qemu/blob/HEAD/SmartL_E802/README.md).

## Contribution<a name="section169045116136"></a>

[How to involve](https://gitee.com/openharmony/docs/blob/master/en/contribute/how-to-contribute.md)

[Commit message spec](https://gitee.com/openharmony/device_qemu/wikis/Commit%20message%E8%A7%84%E8%8C%83?sort_id=4042860)

## Repositories Involved<a name="section1371113476307"></a>

[Kernel subsystem](https://gitee.com/openharmony/docs/blob/HEAD/en/readme/kernel.md)

**device\_qemu**

[kernel\_liteos\_a](https://gitee.com/openharmony/kernel_liteos_a/blob/HEAD/README.md)

[kernel\_liteos\_m](https://gitee.com/openharmony/kernel_liteos_m/blob/HEAD/README.md)

# QEMU（Quick Emulator）<a name="ZH-CN_TOPIC_0000001101286951"></a>

-   [简介](#section11660541593)
-   [约束](#section119744591305)
-   [QEMU安装](#section119744591307)
-   [使用说明](#section169045116126)
-   [贡献](#section169045116136)
-   [相关仓](#section1371113476307)

## 简介<a name="section11660541593"></a>

QEMU可以模拟内核运行在不同的单板，解除对物理开发板的依赖。

## 约束<a name="section119744591305"></a>

只适用于OpenHarmony内核。

## QEMU安装<a name="section119744591307"></a>

1. 安装依赖(Ubuntu 18+)

   ```
   sudo apt install build-essential zlib1g-dev pkg-config libglib2.0-dev  binutils-dev libboost-all-dev autoconf libtool libssl-dev libpixman-1-dev virtualenv flex bison
   ```

2. 获取源码

   ```
   wget https://download.qemu.org/qemu-6.2.0.tar.xz
   ```

   或

   [官网下载: qemu-6.2.0.tar.xz](https://download.qemu.org/qemu-6.2.0.tar.xz)

3. 编译安装

   ```
   tar -xf qemu-6.2.0.tar.xz
   cd qemu-6.2.0
   mkdir build && cd build
   ../configure --prefix=qemu_installation_path
   make -j16
   ```

   等待编译结束, 执行安装命令:

   ```
   make install
   ```

   最后将安装路径添加到环境变量中:

   ```
   vim ~/.bashrc
   ```

   在~/.bashrc最末尾加入:

   ```
   export PATH=$PATH:qemu_installation_path
   ```

## 使用说明<a name="section169045116126"></a>

arm架构参考：
- [QEMU教程 for arm - liteos_a](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_virt/liteos_a/README_zh.md)
- [QEMU教程 for arm - linux](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_virt/linux/README_zh.md)

cortex-m4架构参考[QEMU教程 for cortex-m4](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_mps2_an386/README_zh.md)。

cortex-m55架构参考[QEMU教程 for cortex-m55](https://gitee.com/openharmony/device_qemu/blob/HEAD/arm_mps3_an547/README_zh.md)。

risc-v架构参考[QEMU教程 for risc-v](https://gitee.com/openharmony/device_qemu/blob/HEAD/riscv32_virt/README_zh.md)。

Xtensa架构参考[QEMU教程 for Xtensa](https://gitee.com/openharmony/device_qemu/blob/HEAD/esp32/README_zh.md)。

C-SKY架构参考[QEMU教程 for C-SKY](https://gitee.com/openharmony/device_qemu/blob/HEAD/SmartL_E802/README_zh.md)。

## 贡献<a name="section169045116136"></a>

[如何参与](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/contribute/%E5%8F%82%E4%B8%8E%E8%B4%A1%E7%8C%AE.md)

[Commit message规范](https://gitee.com/openharmony/device_qemu/wikis/Commit%20message%E8%A7%84%E8%8C%83?sort_id=4042860)

## 相关仓<a name="section1371113476307"></a>

[内核子系统](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/readme/%E5%86%85%E6%A0%B8%E5%AD%90%E7%B3%BB%E7%BB%9F.md)

**device\_qemu**

[kernel\_liteos\_a](https://gitee.com/openharmony/kernel_liteos_a/blob/HEAD/README_zh.md)

[kernel\_liteos\_m](https://gitee.com/openharmony/kernel_liteos_m/blob/HEAD/README_zh.md)