Avnet V2L RZ Board User Guide

: May 15, 2024
: AVNET

Table of Contents

Avnet V2L RZ Board
Product Specifications
Product Usage Instructions
Revision History
Summary
Chapter 1 Build Instructions
Chapter 2 Standalone Build of Kernel and u-Boot
Chapter 3 Flash-Programming and Board Operation
Chapter 4 Appendix
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

Avnet V2L RZ Board

Avnet-V2L-RZ-Board-

Product Specifications

Product Name: RZBoard
Model: V2L
Processor: RZ/V2L dual-core MPU (p/n R9A77G054L2)
Processor Type: 64bit Arm A55 MPUs with DRP-AI acceleration
Manufacturer: Avnet

Product Usage Instructions

Chapter 1: Build Instructions

Setup Build Environment
To set up the build environment, you will need the following resources:

Hardware: At least 300GB of disk space and 8GB of RAM
Software: Ubuntu 64-bit OS, version 20.04 LTS (Ubuntu Desktop or Ubuntu Server). You can also run the Ubuntu OS in a virtual machine or Docker container.

Chapter 3: Flash-Programming and Board Operation
This chapter covers flash-programming and operating the RZBoard.

Frequently Asked Questions (FAQ)

Q: Who owns the intellectual property rights of the RZBoard V2L?
A: The RZBoard V2L and its related intellectual property are owned by Avnet.
Q: What are the two methods detailed in the document for building the Linux image and boot files?
A: The two methods detailed are Yocto build method and Standalone build method. Renesas recommends using the Yocto build method for simplicity.

Linux Yocto Development Guide
V2.7

Copyright Statement

The RZBoard V2L and its related intellectual property are owned by Avnet.
Avnet has the copyright of this document and reserves all rights. Any part of the document should not be modified, distributed or duplicated in any form without written permission issued by Avnet.

Disclaimer:
Avnet does not make warranty of any kind, either expressed or implied, as to the program source code, software and documents provided along with the products, and including, but not limited to, warranties of fitness for a particular purpose; The entire risk as to the quality or performance of the program is with the user of these products.

Revision History

Version Note Author Release Date

2. Script _make_rzuboot.sh is now provided on github

| ****

Lily

2. Git config is unneeded

Summary

Avnet-V2L-RZ-Board-

RZBoard is a development SBC board designed and manufactured by Avnet, based on RZ/V2L 64bit Arm A55 MPUs with DRP-AI acceleration from Renesas Electronics.
RZBoard is fitted with a Renesas RZ/V2L dual-core MPU (p/n R9A77G054L2)
This document describes key aspects of development on RZBoard using Yocto Linux

Note: Two methods are detailed in this document for building the Linux image and boot files:

Yocto build (simpler than the standalone method)
Standalone build

For simplicity, Renesas recommends using the Yocto build method https://renesas.info/wiki/RZ-G/RZG_yocto#Online_vs_Offline_Yocto_build

Chapter 1 Build Instructions

Setup Build Environment
To setup the build environment the following resources are required:

Hardware: At least 300GB of disk space and 8GB of RAM
Software: Ubuntu 64-bit OS, 20.04 LTS version (Ubuntu Desktop or Ubuntu Server version).
You could also run the Ubuntu 64-bit OS on virtual machine or in docker container.

The following packages are required for the development environment. The required packages can be installed using the bash script below:

$ sudo apt-get update
$ sudo apt install -y 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 \
rsync curl locales bash-completion

Fetch Source Code

Download Renesas software packages
Due to licensing restrictions on the Renesas website, users are required to download in person. The links have been provided below:

#	Package Name	Version	File to be downloaded
1	RZ/V Verified Linux Package	V3.0.4

After downloading these packages, copy them to the home directory ( ~/ ) to prepare for the next step.

Note: The “Evaluation” packages contain a time limitation that stops the software after a few hours. For more information please refer to RZ/V2L Wiki.

Extract Renesas software packages
Download a script to extract the file.

$ cd ~/
$ wget https://raw.githubusercontent.com/Avnet/meta-rzboard/rzboard_dunfell_5.10_v3/tools/create_yocto_rz_src.sh
$ chmod a+x create_yocto_rz_src.sh
$ ls ~/
RTK0EF0045Z0024AZJ-v3.0.4.zip RTK0EF0045Z15001ZJ-v1.1.0_EN.zip
r01an6238ej0111-rzv2l-cm33-multi-os-pkg.zip RTK0EF0045Z13001ZJ-v1.1.0_EN.zip
create_yocto_rz_src.sh r11an0549ej0740-rzv2l-drpai-sp.zip

Run the script to generate yocto_rzboard/ directory.

$ ./create_yocto_rz_src.sh
$ ls yocto_rzboard/
extra meta-gplv2 meta-open embedded meta-qt5 meta-renesas meta-rz-features meta virtualization
poky

Download meta-rzboard

$ cd ~/yocto_rzboard
$ git clone https://github.com/Avnet/meta-rzboard.git-brzboard_dunfell_5.10_v3
So far, all the yocto related sources are in place.
$ ls ~/yocto_rzboard
extra meta-gplv2 meta-openembedded meta-qt5 meta-renesas meta-rz-features meta-rzboard
meta-virtualization poky

Yocto Build of BSP

Edit build configuration

cd ~/yocto_rzboard
$ mkdir -p ./build/conf
$ cp meta-rzboard/conf/rzboard/* build/conf/
$ ls build/conf/
bblayers.conf local.conf site.conf
The directory to which all Yocto packages are downloaded, can be set by User in conf/local.conf:
DL_DIR ?= “${HOME}/downloads”

Setting build environment and Build

$ cd ~/yocto_rzboard/
$ source poky/oe-init-build-env build/
$ bitbake avnet-core-image

After the build has successfully completed, the output files are deployed in:

/yocto_rzboard/build/tmp/deploy/images/rzboard/

Flash_Writer_SCIF_rzboard.mot	FlashWriter image tool
bl2_bp-rzboard.srec	BL2 bootloader file in S-record format
fip-rzboard.srec	BL31 bootloader plus u-Boot packages in S-record

format
avnet-core-image-rzboard- xxxx.rootfs.wic| System image, this includes:

Linux kernel, DTB and root file system.

Image| Kernel image
rzboard.dtb| RZBoard device tree binary
*overlays/rzboard-.dtbo| RZBoard device tree overlay binary
avnet-core-image-rzboard- xxxx.rootfs.tar.bz2**| System image compressed archive file

Chapter 2 Standalone Build of Kernel and u-Boot

This chapter describes how to build u-Boot and the kernel using either Yocto SDK or ARM GCC in a standalone (offline) environment.

Cross-compile tool chain
The cross-compile tool chain that is used, can be ARM GCC or Yocto SDK.

ARM GCC
Download the tool chain for the A-profile architecture on arm Developer GNU-A Downloads page. It is recommended to use the 10.3 version for this release. You can download the “gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux- gnu.tar.xz “, and decompress the file into a local directory.

$ mkdir ~/toolchain
$ tar -xJf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz -C ./toolchain

Execute the following command to check that the toolchain can be directly run.

$ cd toolchain/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin/
$ ./aarch64-none-linux-gnu-gcc -v

To compile a project with ARM GCC, first set the environment with the following commands before building:

$ TOOLCHAIN_PATH=$HOME/toolchain/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linuxgnu/ bin
$ export PATH=$TOOLCHAIN_PATH:$PATH
$ export ARCH=arm64
$ export CROSS_COMPILE=aarch64-linux-gnu-

Yocto SDK
Generate an SDK from the Yocto Project build environment with the following command after generating the image in the previous chapter.

$ cd ~/yocto_rzboard/
$ source poky/oe-init-build-env build
$ bitbake avnet-core-image -c populate_sdk

The SDK will be generated under: ~/yocto_rzboard/build/tmp/deploy/sdk/./poky- glibc-x86_64-avnet-core-image-aarch64-rzboard-toolchain-3.1.21.sh
Execute this script to install the SDK. The default location is /opt but it can be placed anywhere on the host machine.

$ ./poky-glibc-x86_64-avnet-core-image-aarch64-rzboard-toolchain-3.1.21.sh
Poky (Yocto Project Reference Distro) SDK installer version 3.1.21
==================================================================
Enter target directory for SDK (default: /opt/poky/3.1.21):
You are about to install the SDK to “/opt/poky/3.1.21”. Proceed [Y/n]? Y
Extracting SDK………………done

When using Yocto SDK to compile a project, first execute the following command to configure the environment variables:

$ source /opt/poky/3.1.21/environment-setup-aarch64-poky-linux

Build u-Boot in a standalone environment
To build a bootloader for RZBoard, the user should get cloned different repositories, such as renesas-u-Boot.git, trusted-firmware-a.git and bootparameter code. After compiling the code of each repository, the user has to perform some steps to generate the final boot image.
A shell script named make_rz_uboot.sh is provided to simplify these processes. So the user can download the all code and build with this script. The boot image build steps are as follows:
Download the bash script into the tmp directory and change the file mode:

$ mkdir ~/tmp
$ cd ~/tmp
$ wget https://raw.githubusercontent.com/Avnet/rzboard-build-tools/main/make_rz_uboot.sh
$ chmod a+x make_rz_uboot.sh

Execute the script with parameter -g to download the code first:

$ ./make_rz_uboot.sh -g

Then execute the script with parameter -rz to start the build process:

$ ./make_rz_uboot.sh -rz

The following outputs are generated by default in the tmp directory:

bl2_bp_rzboard.srec
fip_rzboard.srec

Please refer to RZBoard-Linux-Yocto-Usermanual.pdf to update these boot images to the board.

Build Kernel in a standalone environment
Get the Linux source code

$ cd ~/
$ git clone https://github.com/Avnet/renesas-linux-cip.git-brzboard_v2l_v5.10.175
Check that the environment variables are correctly set:
$ echo $CROSS_COMPILE $ARCH

Build the kernel sources

$ cd ~/renesas-linux-cip
$ make distclean
$ make rzboard_defconfig
$ make -j4

Execute the ‘ls’ command to view the Image, dtb file and dtbo files after compilation.

$ ls arch/arm64/boot/Image
$ ls arch/arm64/boot/dts/renesas/rzboard.dtb
$ ls arch/arm64/boot/dts/renesas/overlays/rzboard-*.dtbo

Execute the following command to compile the kernel modules, and install the modules to rootfs in the current directory.

$ make modules
$ make modules_install INSTALL_MOD_PATH=./rootfs

Chapter 3 Flash-Programming and Board Operation

To program the generated new Bootloader and System image files into RZBoard’s eMMC memory, use the procedure described in the RZBoard-Linux-Yocto-UserManual (This also detailed in section 12 of the RZBoard Hardware User Guide)
For guidance on power-up RZBoard, the boot-up process, and how to exercise the supported BSP features of RZBoard, please refer to RZBoard-Linux-Yocto-UserManual
All Avnet documents are accessible via the RZBoard product page at https://www.avnet.me/rzboard

Chapter 4 Appendix

Hardware Documents
For hardware details please refer to:

RZBoard Hardware User Guide
RZBoard Block Diagram

Software Documents and Links
RZBoard supports Yocto Linux, for additional information, please refer to the following documents accessible from the RZBoard product page at https://www.avnet.me/rzboard