BuildOpenharmony.rst

Building OpenHarmony Image

OpenHarmony is a distributed OS that is designed to run on top of variety of OS kernels. Currently the supported kernels are Zephyr, Yocto, and FreeRTOS. To build OpenHarmony image, you need add multiple layers called meta-ohos. meta-ohos is an umbrella meta layer containing all layers required to build OpenHarmony Image basing on existing kernel meta-layers. This section describes how to build, add layers, and run the OpenHarmony image.

• Build and Run Using Zephyr
• Build and Run Using Linux
• Build and Run Using FreeRTOS

Currently OpenHarmony Supports building image using the following boards:

• Nitrogen
• Avenger96

Figure 1 meta-ohos overview

Prerequisites

To start working with meta-ohos first install git repo:

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

Build and Run Using Zypher

1. Once git repo has been installed, clone the necessary repositories.

$ mkdir ohos; cd ohos
$ repo init -u https://git.ostc-eu.org/incubate/meta-ohos/manifest.git
$ repo sync
$ cd poky
poky$ . oe-init-build-env

2. Add layers for other kernels. Working directory will automatically change to ./poky/build.

build$ bitbake-layers add-layer ../meta-openembedded/meta-oe
build$ bitbake-layers add-layer ../meta-openembedded/meta-python
build$ bitbake-layers add-layer ../meta-zephyr
build$ bitbake-layers add-layer ../meta-freertos

Note

Layers for poky were added automatically by sourcing oe-init-build-env.

3. Build distro by selecting the prefered board:

• For Nitrogen

  build$ DISTRO=zephyr MACHINE=96b-nitrogen bitbake zephyr-philosophers

• For Avenger96

  build$ DISTRO=zephyr MACHINE=96b-avenger96 bitbake zephyr-philosophers

Note

For Zephyr, zephyr-philosophers is the one of sample applications available in meta-zephyr layer by Yocto project. It's easy to build other samples using recipes available in meta-zephyr/recipes-kernel/zephyr-kernel/ directory.

4. After the build is successful, run the image by executing the following command:

• For Nitrogen

  build$ DEPLOY_DIR_IMAGE=tmp-newlib/deploy/images/96b-nitrogen runqemu 96b-nitrogen

• For Avenger96

  build$ DEPLOY_DIR_IMAGE=tmp-newlib/deploy/images/96b-avenger96 runqemu 96b-avenger96

After successful bootup, the following message should be displayed:

Booting from ROM..*** Booting Zephyr OS build zephyr-v2.4.0  ***
Philosopher 0 [P: 3]  THINKING [  300 ms ]
Philosopher 1 [P: 2]   EATING  [  575 ms ]
Philosopher 2 [P: 1]        STARVING
Philosopher 3 [P: 0]   EATING  [  525 ms ]
Philosopher 4 [C: -1]  THINKING [  475 ms ]

Build and Run Using Linux

1. Once git repo has been installed, clone the necessary repositories.

$ mkdir ohos; cd ohos
$ repo init -u https://git.ostc-eu.org/incubate/meta-ohos/manifest.git
$ repo sync
$ cd poky
poky$ . oe-init-build-env

2. Add layers for other kernels. Working directory will automatically change to ./poky/build.

build$ bitbake-layers add-layer ../meta-openembedded/meta-oe
build$ bitbake-layers add-layer ../meta-openembedded/meta-python
build$ bitbake-layers add-layer ../meta-zephyr
build$ bitbake-layers add-layer ../meta-freertos

Note

Layers for poky were added automatically by sourcing oe-init-build-env.

3. Build distro by selecting the prefered board:

• For Nitrogen

  build$ DISTRO=poky-tiny MACHINE=96b-nitrogen bitbake core-image-minimal

• For Avenger96

  build$ DISTRO=poky-tiny MACHINE=96b-avenger96 bitbake core-image-minimal

4. After the build is successful, run the image by executing the following command:

• For Nitrogen

  build$ runqemu 96b-nitrogen ramfs qemuparams="-nographic"

• For Avenger96

  build$ runqemu 96b-avenger96 ramfs qemuparams="-nographic"

After successful bootup, the following message should be displayed:

• For Nitrogen

  # For poky
  96b-nitrogen login:
  # Default login is _root_ without a password.
  # After login you should see prompt:
  root@96b-nitrogen:~#

• For Avenger96

  # For poky
  96b-avenger96 login:
  # Default login is _root_ without a password.
  # After login you should see prompt:
  root@96b-avenger96:~#

Build and Run Using FreeRTOS

1. Once git repo has been installed, clone the necessary repositories.

$ mkdir ohos; cd ohos
$ repo init -u https://git.ostc-eu.org/incubate/meta-ohos/manifest.git
$ repo sync
$ cd poky
poky$ . oe-init-build-env

2. Add layers for other kernels. Working directory will automatically change to ./poky/build.

build$ bitbake-layers add-layer ../meta-openembedded/meta-oe
build$ bitbake-layers add-layer ../meta-openembedded/meta-python
build$ bitbake-layers add-layer ../meta-zephyr
build$ bitbake-layers add-layer ../meta-freertos

3. Build distro by selecting the prefered board.

   Note

   Currently FreeRTOS supports qemu boards only.

   build$ DISTRO=freertos MACHINE=qemuarmv5 bitbake freertos-demo

4. After the build is successful, run the image by executing the following command:

   build$ runqemu 96b-nitrogen

After successful bootup, the following message should be displayed:

###### - FreeRTOS sample application -######

A text may be entered using a keyboard.
It will be displayed when 'Enter' is pressed.

Periodic task 10 secs
Waiting For Notification - Blocked...
Task1
Task1
You entered: "HelloFreeRTOS"
Unblocked
Notification Received
Waiting For Notification - Blocked...