Renesas RZ/G User manual
Release Note
R01TU0269EJ0108 Rev. 1.08 Page 1 of 22
Mar 31, 2021
RZ/G Verified Linux Package
Version 2.1.9
Release Note
Introduction
This release note describes the contents, the building procedures and the important points of the RZ/G Verified Linux
Package (hereinafter referred to as “VLP”).
This document also describes the environment to build VLP without using “RZ/G Development Platform”. If additional
information about the platform is required, please refer to “RZ/G Linux Platform Tools User’s Manual for the RZ/G
Series”.
Contents
1. Release Items ................................................................................................................. 2
2. Build environment .......................................................................................................... 4
3. Building Instructions ...................................................................................................... 6
3.1 Building instructions of a BSP all manually ............................................................................. 8
3.2 Building instructions of a BSP with script ............................................................................. 12
3.3 Building instructions of SDK ................................................................................................... 16
4. Changes from previous version .................................................................................. 17
5. Restrictions .................................................................................................................. 18
6. Notes ............................................................................................................................. 19
R01TU0269EJ0108
Rev. 1.08
Mar 31, 2021
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 2 of 22
Mar 31, 2021
1. Release Items
• Name and version
RZ/G Verified Linux Package Version 2.1.9
(hereinafter referred to as “VLP v2.1.9”).
• Distribution method
Please visit the site below and create an account to download the packages. This site is for the entire RZ Family
which includes the RZ/G series. Basic packages of VLP v2.1.9 which are listed in Table 1 can be downloaded.
RZ Family:
https://www.renesas.com/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus
You can also download the basic packages of VLP v2.1.9 which are listed in Table 1 from the site below.
RZ/G Marketplace:
https://www.renesas.com/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform
• Target boards
iWave RZ/G1H-PF Qseven Development Platform R2.1
iWave RZ/G1M-PF Qseven Development Platform R2.0
iWave RZ/G1N-PF Qseven Development Platform R3.4
iWave RZ/G1E-PF SODIMM Development Platform R3.1, R4.0
iWave RZ/G1C-PF Pi SBC Development Platform R2.0, R4.0
These boards are provided by iWave Systems Technologies Pvt. Ltd.
• Verified functions
Linux BSP
- Linux Kernel
- Linux Drivers
- Graphics Libraries
GUI Framework
- HTML5 (Gecko is used as a rendering engine)
- Qt (LGPL version)
• File contents
VLP is delivered by the files listed in Table 1.
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 3 of 22
Mar 31, 2021
Table 1. RZ/G Verified Linux Package
Basic packages
File
Description
rzg_bsp_eva_v219.tar.gz (Evaluation version) (101MB)
rzg_bsp_pro_v219.tar.gz (Product version) (101MB)
Yocto recipe packages
rzg_bsp_gecko_v219.tar.gz (556KB)
Yocto recipe packages for HTML5
oss_pkg_v219.7z (3.9GB)
Open source software packages
oss_pkg_gecko_v219.7z (830MB)
Open source packages for
HTML5
r01tu0269ej0108-rz-g.pdf
This document
r01tu0270ej0108-rz-g.pdf
Component list
setup_env_script_v219.py (7.6KB)
Script for setting up a build
environment
(Optional) A document and files for updating from VLP v2.1.7
File
Description
r01tu0271ej0108-rz-g.pdf
Patch application guide for VLP
v2.1.7 users
v217-to-v219.patch.tar.gz (1.8MB)
Diff files of Yocto recipes
compared with VLP v2.1.7
v217-to-v219.oss_packages.7z (210MB)
Diff files of OSS packages
compared with VLP v2.1.7
Sometimes the above packages are downloaded with the different file names like as
“REN_rzg_bsp_eva_v21x.tar.gz_ESW_2021xxxx.gz”. In that case, please rename them to the above file names.
Note) Open source software packages contain all source codes of OSS except for Linux kernel. These are the same
versions of OSS used when VLP was verified. These are also used in “offline” environment. Please refer to the
section 2. Build environment.
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 4 of 22
Mar 31, 2021
2. Build environment
Figure 1 shows an overall constitution of the recommended environment of VLP. This environment uses the equipment
and the software listed in Table 2. Please refer to “RZ/G Verified Linux Package Start-Up Guide” for details about
setting up the environment.
Figure 1. Recommended Environment
Table 2. Equipment and Software Necessary for Developing Environment of RZ/G Linux Platform
Equipment
Description
Linux Host PC
Used as build/debug environment.
Max 100GB free space on HDD is necessary.
OS
Ubuntu 16.04 LTS
64 bit OS must be used.
TFTP server
Used for downloading the Linux kernel to the board.
NFS server
Used for mounting rootfs via NFS.
Windows Host PC
Used as debug environment, controlling with terminal software.
OS
Windows10 are recommended.
Terminal software
Used for controling serial console of the target board.
Tera Term (latest version) is recommended.
Available at https://ttssh2.osdn.jp/index.html.en.
VCP Driver
Virtual COM Port driver which enables to communicate Windows
Host PC and the target board via USB which is virtually used as
serial port.
Available at http://www.ftdichip.com/Drivers/VCP.htm.
Note) Build may fail if Ubuntu 14, 18 or 20 is used.
Hub
[Linux Host PC]
TFTP server
NFS server
Straight Ethernet cable
USB cable
*type A to
micro B
(Optional)
Straight Ethernet cable
[Windows10 Host PC]
Terminal software to display console
(ssh to control Linux Host)
Target Board
Straight Ethernet cable
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 5 of 22
Mar 31, 2021
Most bootable images VLP supports can be built on an “offline” environment.
The word “offline” means an isolated environment which does not connect to any network. Since VLP includes all
necessary source codes of OSS except for the Linux kernel, VLP can always build images in this “offline” environment
without affected from changes of repositories of OSS. Also, this “offline” environment reproduces the same images as
the images which were verified by Renesas.
Below images can be built “offline”.
• core-image-minimal
• core-image-weston (including the case using Gecko)
• core-image-weston-sdk
Below are not available in the “offline” environment. Please connect your Linux Host PC to the internet.
• Preparing a Linux Host PC
• Building images which use meta-rzg-demos layer
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 6 of 22
Mar 31, 2021
3. Building Instructions
This chapter describes the building instructions of Board Support Package (hereinafter referred to as “BSP”). There are
two sections for building procedures (3.1 and 3.2). Please choose either one of them and run the commands from the
chosen section. Section 3.1 describes the manual building method. Section 3.2 describes a method to use a script which
automates the steps setting up the build environment and build the BSP. Section 3.2 runs automatically the same
commands from section 3.1. Whichever the choice, the output will be the same.
Figure 2 shows a building outline of section 3.1 and 3.2. Once the building procedures are executed, some image files
which names will depend on the target board name will be made. Table 3 lists the names of the image files. Moreover,
the GUI framework and the building procedures can be changed by a user’s choice. Because of that, please select a
target board and a GUI framework, then run the commands from section 3.1 or 3.2.
Figure 2. Building Outline
Note) There are two GUI frameworks available, Qt and HTML5. One of them or none can be selected. In case Qt GUI
framework is selected, please choose whether Qt HMI demo applications are required or not.
Start building instruction
Using Qt GUI
framework
Using Qt HMI
demo applications
Installing required packages to the Linux Host PC
Using HTML5 GUI
framework
Preparation to start build
Decompressing Yocto recipe package and OSS files
Running a script for proprietary software
Preparing default configuration files
Building image files by bitbake command
Yes
Yes
No
No
Yes
No
3
Orange Part : Section 3.2 automates the procedures with the script.
1. Qt GUI framework and Qt HMI demo application can be used.
2. Qt GUI framework can be used.
3. HTML5 GUI framework can be used.
4. No GUI framework can be used.
Procedure
Usable GUI framework and
application
corresponding
to 1 - 4 numbers
RZ/G Verified Linux Package Release Note
R01TU0269EJ0108 Rev. 1.08 Page 7 of 22
Mar 31, 2021
Table 3. Image files
Linux kernel
Device tree file
root filesystem
Kernel
modules
u-boot
RZ/G1H
uImageiwg21m.bin
uImage-r8a7742iwg21d-q7-dbcmca.dtb
core-image-westoniwg21m.tar.bz2
modulesiwg21m.tgz
u-bootiwg21m.bin
RZ/G1M
uImage-iwg20mg1m.bin
uImage-r8a7743iwg20d-q7-dbcmca.dtb
core-image-westoniwg20m-g1m.tar.bz2
modules-iwg20mg1m.tgz
u-bootiwg20mg1m.bin
RZ/G1N
uImage-iwg20mg1n.bin
uImage-r8a7744iwg20d-q7-dbcmca.dtb
core-image-westoniwg20m-g1n.tar.bz2
modules-iwg20mg1n.tgz
u-bootiwg20mg1n.bin
RZ/G1E
uImageiwg22m.bin
uImage-r8a7745iwg22d-sodimm.dtb
core-image-westoniwg22m.tar.bz2
modulesiwg22m.tgz
u-bootiwg22m.bin
RZ/G1C
uImageiwg23s.bin
uImage-r8a77470iwg23s-sbc.dtb
core-image-westoniwg23s.tar.bz2
modulesiwg23s.tgz
u-bootiwg23s.bin
Loading...