From 6e8c150344e72df160776bebbf4c6992833b7c10 Mon Sep 17 00:00:00 2001
From: Andrei Gherzan <andrei.gherzan@huawei.com>
Date: Wed, 10 Aug 2022 13:58:32 +0200
Subject: [PATCH] docs: Add documentation on the supported qemuarm64-efi
machine
Signed-off-by: Andrei Gherzan <andrei.gherzan@huawei.com>
Signed-off-by: Luca Seritan <luca.seritan@huawei.com>
---
docs/build-flavours/linux-flavour.rst | 1 +
.../hardware-support/virtual-boards/index.rst | 1 +
.../virtual-boards/qemuarm64-efi.rst | 53 +++++++++++++++++++
3 files changed, 55 insertions(+)
create mode 100644 docs/hardware-support/virtual-boards/qemuarm64-efi.rst
diff --git a/docs/build-flavours/linux-flavour.rst b/docs/build-flavours/linux-flavour.rst
index 823e8a87..95ccf69f 100644
--- a/docs/build-flavours/linux-flavour.rst
+++ b/docs/build-flavours/linux-flavour.rst
@@ -22,6 +22,7 @@ Supported machines (default in **bold**):
* **qemux86-64**
* qemux86
+* qemuarm64-efi
* seco-intel-b68 (SECO SBC-B68)
* seco-imx8mm-c61-2gb (SECO SBC-C61 2GB DRAM)
* seco-imx8mm-c61-4gb (SECO SBC-C61 4GB DRAM)
diff --git a/docs/hardware-support/virtual-boards/index.rst b/docs/hardware-support/virtual-boards/index.rst
index b21ca7c6..9611c8b0 100644
--- a/docs/hardware-support/virtual-boards/index.rst
+++ b/docs/hardware-support/virtual-boards/index.rst
@@ -14,3 +14,4 @@ This section details the support for virtual targets in |main_project_name|.
qemux86-64
qemux86
+ qemuarm64-efi
diff --git a/docs/hardware-support/virtual-boards/qemuarm64-efi.rst b/docs/hardware-support/virtual-boards/qemuarm64-efi.rst
new file mode 100644
index 00000000..58deac81
--- /dev/null
+++ b/docs/hardware-support/virtual-boards/qemuarm64-efi.rst
@@ -0,0 +1,53 @@
+.. SPDX-FileCopyrightText: Huawei Inc.
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+.. include:: ../../definitions.rst
+
+Qemu ARM 64bit
+##############
+
+.. contents::
+ :depth: 4
+
+Overview
+********
+
+|main_project_name| supports running the software stack into an virtual
+environment using Qemu.
+
+Building an Oniro image
+=======================
+
+To clone the source code, perform the procedure in: :ref:`Setting up a repo
+workspace <RepoWorkspace>`.
+
+Building a Linux image
+======================
+
+Build Steps
+-----------
+
+1. Source the environment with proper template settings, flavour being *linux*
+ and target machine being *qemuarm64-efi*. Pay attention to how relative
+ paths are constructed. The value of *TEMPLATECONF* is relative to the
+ location of the build directory *./build-oniro-linux*, that is going to be
+ created after this step:
+
+.. code-block:: console
+
+ $ TEMPLATECONF=../oniro/flavours/linux . ./oe-core/oe-init-build-env build-oniro-linux
+
+2. You will find yourself in the newly created build directory. Call *bitbake*
+ to build the image. For example, if you are using *oniro-image-base*
+ run the following command:
+
+.. code-block:: console
+
+ $ MACHINE=qemuarm64-efi bitbake oniro-image-base
+
+Once the image is done, you can run the Qemu using the provided script wrapper:
+
+.. code-block:: console
+
+ $ MACHINE=qemuarm64-efi runqemu oniro-image-base nographic slirp
--
GitLab