diff --git a/docs/build-flavours/linux-flavour.rst b/docs/build-flavours/linux-flavour.rst index 823e8a877118809e897c975b44038221c12a4ed7..95ccf69f057efa39509b2cdbc846e9b8bc830eaf 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 b21ca7c6b5f90e42dbc8feae3e9055b6c17f317e..9611c8b026228c3244a0aca1feba32db9bdac782 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 0000000000000000000000000000000000000000..58deac811cb9cd7f94d3ee740bf6aef8d666cd24 --- /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