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 |
---|---|---|---|---|
| Emcraft | Provides Ubuntu Desktop distribution into filesystem images |
| |
| Emcraft | Build recipes for Emcraft Linux and U-Boot for RZ/V2H board |
| |
| Renesas | Renesas support for RZ/V2H board |
| |
| Renesas | Renesas support for Dynamically Reconfigurable Processor for AI (DRP-AI) |
| |
| Renesas | Renesas support for RZ/V2H graphics core (Mali GPU) |
| |
| Renesas | Renesas RZ-V2H support for CM33 and CM8 co-processors |
| |
| Renesas | Renesas support for imx462 camera for Renesas RZ-V2H |
| |
| Emcraft | Emcraft work on Renesas RZ-V2H Linux kernel |
| |
| 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:
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
Create a build directory:
$ mkdir build-desktop $ cd build-desktop
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
Activate the build environment. The following command will create a
build/
directory and change into it:Optionally, configure the Yocto cache directories for shared state and downloads:
Build the images:
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 |
---|---|---|
| Linux Kernel image |
|
| Linux Device Tree Blob image |
|
| Combined image suitable for installing it to eMMC or SD card. |
|
| Build Manifest |
|
| Flash Writer image |
|
| BL2 Loader image |
|
| FIP Loader image |
|