Building Emcraft Software Distribution

 

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:

Repository

Location

Owned by

Summary

Notes

Repository

Location

Owned by

Summary

Notes

meta-renesas-desktop

https://github.com/EmcraftSystems/meta-renesas-desktop

Emcraft

Provides Ubuntu Desktop distribution into filesystem images

 

meta-rz-emcraft

https://github.com/EmcraftSystems/meta-rz-emcraft

Emcraft

Build recipes for Emcraft Linux and U-Boot for RZ/V2H board

 

meta-renesas

https://github.com/EmcraftSystems/meta-renesas

Renesas

Renesas support for RZ/V2H board

 

meta-rz-drpai

https://github.com/EmcraftSystems/meta-rz-drpai

Renesas

Renesas support for Dynamically Reconfigurable Processor for AI (DRP-AI)

 

meta-rz-graphics

https://github.com/EmcraftSystems/meta-rz-graphics

Renesas

Renesas support for RZ/V2H graphics core (Mali GPU)

 

meta-rz-multi-os

https://github.com/EmcraftSystems/meta-rz-multi-os

Renesas

Renesas RZ-V2H support for CM33 and CM8 co-processors

 

meta-econsys

https://github.com/EmcraftSystems/meta-econsys

Renesas

Renesas support for imx462 camera for Renesas RZ-V2H

 

linux-rz

https://github.com/EmcraftSystems/linux-rz

Emcraft

Emcraft work on Renesas RZ-V2H Linux kernel

 

u-boot-rz

https://github.com/EmcraftSystems/u-boot-rz

Emcraft

Emcraft work on Renesas RZ-V2H U-Boot boot loader

 

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:

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

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

  6. Build the images:

  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:

Image

Summary

Notes

Image

Summary

Notes

Image-rzv2h-evk-alpha.bin

Linux Kernel image

 

Image-r9a09g057h4-evk.dtb

Linux Device Tree Blob image

 

image-ubuntu-desktop-rzv2h-evk-alpha.wic.zst

Combined image suitable for installing it to eMMC or SD card.

 

image-ubuntu-desktop-rzv2h-evk-alpha.manifest

Build Manifest

 

Flash_Writer_SCIF_RZV2H_DEV_INTERNAL_MEMORY.mot

Flash Writer image

 

bl2_bp_emmc-rzv2h-evk-alpha.srec

BL2 Loader image

 

fip-rzv2h-evk-alpha.srec

FIP Loader image