Overview

This application note explains how to build the Emcraft software distribution for the Renesas RZ/V2H SoC.

Emcraft Software Distribution for Renesas RZ/V2H

Repositories

This following repositories comprise the Emcraft software distribution for the Renesas RZ/V2H:

Building Emcraft Software Distribution for Renesas RZ/V2H

Build Host

You will need a Ubuntu 20 build host with about 100GB of free disk space.

This configuration has been explicitly validated by Emcraft for the build procedure documented below.

Build Procedure

Use the following step-wise procedure to build the Emcraft software distribution for the Renesas RZ/V2H:

1. Prepare host for the build:

   $ sudo apt-get update
   $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat cpio python
   python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping libsdl1.2-dev xterm p7zip-full libyaml-dev
   libssl-dev

2. Create a build directory:

   $ mkdir build-desktop
   $ cd build-desktop

3. Checkout the git repositories into the build tree:

   $ mkdir -p sources/meta-rz-features
   $ pushd sources
   $ git clone git@github.com:EmcraftSystems/meta-econsys
   $ git clone git@github.com:EmcraftSystems/meta-renesas
   $ git clone git@github.com:EmcraftSystems/meta-rz-drpai meta-rz-features/meta-rz-drpai
   $ git clone git@github.com:EmcraftSystems/meta-rz-graphics meta-rz-features/meta-rz-graphics
   $ git clone git@github.com:EmcraftSystems/meta-rz-multi-os meta-rz-features/meta-rz-multi-os
   $ git clone git@github.com:EmcraftSystems/meta-renesas-desktop
   $ git clone git@github.com:EmcraftSystems/meta-rz-emcraft
   $ git clone -b dunfell-23.0.21 https://git.yoctoproject.org/git/poky
   $ git clone https://git.yoctoproject.org/git/meta-gplv2
   $ cd meta-gplv2/
   $ git checkout 60b251c25ba87e946a0ca4cdc8d17b1cb09292ac
   $ cd ..
   $ git clone https://git.yoctoproject.org/git/meta-virtualization
   $ cd meta-virtualization/
   $ git checkout a63a54df3170fed387f810f23cdc2f483ad587df
   $ cd ..
   $ git clone https://github.com/openembedded/meta-openembedded
   $ cd meta-openembedded/
   $ git checkout 7952135f650b4a754e2255f5aa03973a32344123
   $ cd ..
   $ popd

4. Activate the build environment. The following command will create a build/ directory and change into it:

   $ TEMPLATECONF=${PWD}/sources/meta-renesas-desktop/conf/ source sources/poky/oe-init-build-env

5. Optionally, configure the Yocto cache directories for shared state and downloads:

   $ sudo mkdir -p /yocto/sstate-cache
   $ sudo mkdir -p /yocto/downloads
   $ sudo chmod 777 /yocto/*
   $ vi conf/site.conf
   SSTATE_DIR = "/yocto/sstate-cache"
   DL_DIR = "/yocto/downloads"
   $

6. Build the images:

   $ MACHINE=rzv2h-evk-alpha-emc bitbake image-ubuntu-desktop
   ...

7. After a successful build, the build artefacts will reside in the tmp/deploy/images/rzv2h-evk-alpha-emc/ directory.

Build Images

The following images are built by the Emcraft software distribution build procedure: