All Scenarios OS - Quick Build

This section will guide you to building your first All Scenarios OS image targeting a supported reference hardware. It will also provide the steps for flashing and booting such an image.

The steps below will focus on a Qemu-based target. If you want to get a feeling of All Scenarios OS on a real hardware, checkout the Avenger96 support page.

Prerequisites

Install all the required host packages. Here is an example for Ubuntu:

$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
  build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
  xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \
  pylint3 xterm

See official Yocto documentation for host package requirements on all supported Linux distributions.

Clone build system repositories

Install Google git repo tool. For example, on Ubuntu 20.04, you can do this by:

$ sudo add-apt-repository ppa:openharmony/tools
$ sudo apt-get update
$ sudo apt-get install git-repo

Initialize a repo workspace and clone all required repositories:

$ mkdir oniroproject; cd oniroproject
$ repo init -u https://git.ostc-eu.org/distro/oniro
$ repo sync --no-clone-bundle

Build the allscenarios-image-base image

The following steps will build a allscenarios-image-base. The process will build all its components, including the toolchain, from source.

First of all change directory into the one where the build repositories were cloned using the repo tool. See above.

Note

Depending on the configuration type, a single All Scenarios OS build could use around 100GB of disk space for downloads, temporary files, and build artifacts combined.

Initialize the build directory and run a build:

$ TEMPLATECONF=../oniro/flavours/linux . ./oe-core/oe-init-build-env build-oniro-linux
$ MACHINE=qemux86-64 bitbake allscenarios-image-base

Booting a Qemu X86-64 target with a All Scenarios OS image

Once the image is built, you can run a Qemu X86-64 instance using the provided script wrapper as follows:

$ MACHINE=qemux86-64 runqemu allscenarios-image-base wic

If the host has a VT-capable CPU, you can pass the kvm argument for better performance. Check runqemu’s help message for all available arguments.