1. Overview

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

2. Emcraft Software Distribution for Renesas RZ/V2H

2.1. Repositories

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

3. Building Emcraft Software Distribution for Renesas RZ/V2H

3.1. 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.

3.2. 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:

   Code Block
   $ 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:

   Code Block
   $ mkdir build-desktop $ cd build-desktop

3. Checkout the git repositories into the build tree:

   Code Block

   $ 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:

   Code Block
   $ 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:

   Code Block
   $ 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:

   Code Block
   $ 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.

3.3. Build Images

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

...