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.

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.

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

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

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 8 of 22 Mar 31, 2021

3.1 Building instructions of a BSP all manually

This section describes the manual building method. VLP supports two GUI frameworks: Qt and HTML5 (Gecko). But these cannot be used at the same time. Please run the commands depending on the GUI framework which will be used.

Before starting the manual build, run the command below on the Linux Host PC to install packages used for building BSP.

$ 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

Please refer to the URL below for detailed information:

• https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/yocto-project-qs.html

In addition, run the command below to install packages used for building Gecko.

$ sudo apt-get install autoconf2.13 $ sudo apt install clang llvm clang-3.9 llvm-3.9

Run the commands below and set the user name and email address before starting the build procedure. Without this

setting, an error occurs when building procedure runs git command to apply patches.

$ git config --global user.email "you@example.com" $ git config --global user.name "Your Name"

(1) Set the shell variable

Run the command below and enter an absolute path of the working directory.

$ export WORK=[user’s working directory]

(2) Create the working directory, and decompress Yocto recipe package

Run the commands below. Please replace “type” by “pro” or “eva”. Copy the compressed Yocto recipe package files (rzg_bsp_pro_v219.tar.gz for product version, rzg_bsp_eva_v219.tar.gz for evaluation version) into the current directory prior to this step.

$ mkdir -p $WORK $ cd $WORK $ tar xvzf ./rzg_bsp_type_v219.tar.gz

Additionally, in case to use HTML5, run the commands below to decompress Yocto recipe package for building Gecko.

$ cd $WORK $ tar xvzf ./rzg_bsp_gecko_v219.tar.gz

Note) In case to use HTML5 on iWave boards of RZ/G1E and RZ/G1C, please refer to 6. Notes (2) and apply a patch

to the meta-renesas directory.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 9 of 22 Mar 31, 2021

(3) Execute the copy scripts for proprietary software

Run the scripts below. It’s necessary to run a script corresponding to the target board at the command (*1). Please replace “x” according to the target board:

“copy_gfx_software_rzg1h.sh” RZ/G1H “copy_gfx_software_rzg1e.sh” RZ/G1E “copy_gfx_software_rzg1m.sh” RZ/G1M “copy_gfx_software_rzg1c.sh” RZ/G1C “copy_gfx_software_rzg1n.sh” RZ/G1N

$ cd $WORK/meta-renesas/meta-rzg1 $ ./copy_mm_software_lcb.sh ../../MMP $ ./copy_gfx_software_rzg1x.sh ../../MMP (*1)

(4) Setup the build environment

Run the commands below. The environment to build is set by the source command.

$ cd $WORK $ source poky/oe-init-build-env

(5) Prepare the default configuration files for the target board

There are 4 types of the default configuration files. Select one of them and copy suitable files into the work directory by the commands below. Fill the directory name corresponding to the target board to <board>:

iwg21m: iWave board for RZ/G1H iwg22m: iWave board for RZ/G1E iwg20m-g1m: iWave board for RZ/G1M iwg23s: iWave board for RZ/G1C iwg20m-g1n: iWave board for RZ/G1N

• No GUI Framework required

$ cd $WORK/build $ cp ../meta-renesas/meta-rzg1/templates/<board>/*.conf ./conf

• Enable HTML5 (Gecko)

$ cd $WORK/build $ cp ../meta-renesas/meta-rzg1/templates/<board>/gecko/*.conf ./conf

• Enable Qt

$ cd $WORK/build $ cp ../meta-renesas/meta-rzg1/templates/<board>/qt/*.conf ./conf

• Enable Qt HMI demo applications

$ cd $WORK/build $ cp ../meta-rzg-demos/meta-rzg1/qt-hmi-demo/template/<board>/*.conf ./conf

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 10 of 22 Mar 31, 2021

(6) Decompress OSS files to “build” directory

Copy the compressed OSS package files (oss_pkg_v219.7z, oss_pkg_gecko_v219.7z) into the “build” directory prior to this step.

Run the commands below.

$ cd $WORK/build $ 7z x ./oss_pkg_v219.7z

Additionally, in case to use HTML5, run the commands below to decompress OSS files for building Gecko.

$ cd $WORK/build $ 7z x ./oss_pkg_gecko_v219.7z

Note) This step is not mandatory in case the “offline” environment is not used.

If this step is omitted and BB_NO_NETWORK is set to “0” in next step, all source codes will be downloaded

from the repositories of each OSS via the internet when running the bitbake command. Please note that there is a possibility to fail a build because of implicit changes of the repository of OSS.

(7) Download Linux kernel source code

Run the commands below. The source code of the linux kernel is not included in oss_pkg_v219.7z. This step obtains the source code from CIP’s Git repository. Once this step is finished, the Linux Host PC can be disconnected from the network.

$ cd $WORK/build $ bitbake linux-renesas -c fetch

If you want to prevent network access, please change the line in the ${WORK}/build/conf/local.conf as below: Change BB_NO_NETWORK from “0” to “1”.

BB_NO_NETWORK = "1"

Note) If Qt HMI demo applications are required, please set “BB_NO_NETWORK” to “0” and connect the Linux Host

PC to the network.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 11 of 22 Mar 31, 2021

(8) Start the build

Run the commands below. Building an image can take up to a few hours depending on the user’s host system performance.

$ cd $WORK/build $ bitbake core-image-weston

After the build is successfully completed, a similar output will be seen:

NOTE: Tasks Summary: Attempted 4945 tasks of which 16 didn't need to be rerun and al l succeeded.

and the command prompt will return.

All necessary files listed in Table 3 will be generated by the bitbake command at build/tmp/deploy/images directory.

Note) If the user’s name and email address are not set before starting the build, an error will occur, and the messages

below will be displayed. In case to cause this error, another error will occur when you try to build again. Please set the user’s name and email address like as below messages and delete [user’s working directory]. Then try to build again from the step (1).

*** Please tell me who you are.

Run

git config --global user.email "you@example.com" git config --global user.name "Your Name"

to set your account's default identity. Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'renesas@rzg.(none)')

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 12 of 22 Mar 31, 2021

3.2 Building instructions of a BSP with script

This section describes the script building method. Note that the script automates the steps to setup the build environment. There are additional commands to run manually once the script finished running.

Please make a directory (hereinafter called “[user’s working directory]”) somewhere in the Linux Host PC and copy the following files into the same directory in advance. These files can be downloaded from Renesas

Electronics Website. Please refer to “Distribution method” in the chapter 1.

Table 4. Basic files for the script building method

File

Description

Either rzg_bsp_eva_v219.tar.gz (Evaluation version) or rzg_bsp_pro_v219.tar.gz (Product version)

Yocto recipe packages rzg_bsp_gecko_v219.tar.gz

Yocto recipe packages for HTML5 (*4)

oss_pkg_v219.7z

Open source software packages

oss_pkg_gecko_v219.7z

Open source software packages for HTML5 (*5)

setup_env_script_v219.py

Script for setting up a build environment

Note) In case not to use HTML5, it is not necessary to copy the files which are marked (*4) and (*5) in the [user’s

working directory].

If the Git has not been configured yet, set the user name and email address before starting build procedure. Without

this setting, an error occurs when building procedure runs git command to apply patches.

$ git config --global user.email "you@example.com" $ git config --global user.name "Your Name"

After that, please run the following steps.

Note) Python3 is required to run the script. This script is experimental and provided AS IS.

(1) Set a shell variable

Run the command below and enter an absolute path of the working directory.

$ export WORK=[user’s working directory]

(2) Run the script

Run the commands below to start the script.

$ cd $WORK $ ./setup_env_script_v219.py

The following message will be displayed. Enter the number corresponding to the target board.

What is your target board? Please enter one of the following numbers corresponding to the target board. [1] RZ/G1H, [2] RZ/G1M, [3] RZ/G1N, [4] RZ/G1E, [5] RZ/G1C

Please Enter Number:

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 13 of 22 Mar 31, 2021

Then enter the number corresponding to the GUI framework that will be used. A sudo command to update a package list will then run, hence enter the password.

Which GUI framework do you want to use? Please enter one of the following numbers corresponding to the GUI framework. [1] Qt, [2] HTML5, [3] None* (*Does not use Qt and HTML5.)

Please Enter Number:

The following message will be displayed once the script’s sequence is completed. Then run manually the next steps (3) - (5) of section 3.2. Once the script finishes, a directory named “user_work” and a file named “v219_script.log” will be made in the [user’s working directory]. In case the script fails to setup or is interrupted by the user, please delete the “user_work” directory in the [user’s working directory], and then try it again from the beginning of this step.

** The sequence of this script was successfully completed. ** ** Please refer to the manual and execute the next procedures. **

Please enter “y” in case the Qt HMI demo applications are required.

Do you want to include the Qt HMI demo applications? (y/n):

The script will search packages in the user’s Linux Host PC. The following confirmation message will be displayed if the required packages are not installed. If “y” is chosen, a command to install the packages will run. If “n” is ch osen,

the script will stop. [the required packages] will change depending on the chosen GUI framework.

It is necessary to install the following packages to your Linux Host PC. Packages = [the required packages]

Is it OK to install the packages? (y/n) :

Please refer to the URL below for detailed information:

• https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/yocto-project-qs.html

This script requires network access. If the Linux Host PC is not connected to the network, the following message will be displayed. Please connect the Linux Host PC to the network and press enter. Please press “Ctrl + C” to stop the script in case the network is not available.

WARNING: Linux Host PC is not connected to the network. Please connect to the network. Process wait until it is online. Will you try again? (Yes : [enter], No : [Ctrl + C]):

Note) If there are no Yocto recipe package or Open source software package inside the [user’s working directory], the

following messages will be displayed and the script will stop.

ERROR: There are no Yocto recipe package (rzg_bsp_***_v219.tar.gz) or Open Source Package (oss_pkg_v219.7z) in your working directory. Please copy the files to the directory and try again to run this script.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 14 of 22 Mar 31, 2021

Note) If the script fails to run the setup command, the following messages will be displayed and the script will stop.

Please then delete the “user_work” directory in the [user’s working directory] and try it again from the beginning of this step.

ERROR: Command = [the executed command] failed. This script will stop.

Note) If the script finishes, “v219_script.log” is created in the [user’s working directory]. You can check the executed

commands and the results of them with this log file.

(3) Setup the environment to use bitbake command

Run the commands below. The environment to build is set by the source command.

$ cd $WORK $ source poky/oe-init-build-env

(4) Download Linux kernel source code

Run the commands below. The source code of the linux kernel is not included in oss_packages.7z. This step obtains the source code from CIP’s Git repository. Once this step is finished, the Linux Host PC can be disconnected from the network.

$ cd $WORK/build $ bitbake linux-renesas -c fetch

If you want to prevent network access, please change the line in the ${WORK}/build/conf/local.conf as below: Change BB_NO_NETWORK from “0” to “1”.

BB_NO_NETWORK = "1"

Note) If Qt HMI demo applications are required, please set “BB_NO_NETWORK” to “0” and connect the Linux Host

PC to the network.

(5) Start the build

Run the commands below. Building an image can take up to a few hours depending on the user’s host system performance.

$ cd $WORK/build $ bitbake core-image-weston

After the build is successfully completed, a similar output will be seen, and the command prompt will return:

NOTE: Tasks Summary: Attempted 4945 tasks of which 16 didn't need to be rerun and al l succeeded.

All necessary files listed in Table 3 will be generated by the bitbake command at user_work/build/tmp/deploy/images directory.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 15 of 22 Mar 31, 2021

Note) If the user’s name and email address are not set before starting the build, an error will occur, and the messages

*** Please tell me who you are.

Run

git config --global user.email "you@example.com" git config --global user.name "Your Name"

to set your account's default identity. Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'renesas@rzg.(none)')

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 16 of 22 Mar 31, 2021

3.3 Building instructions of SDK

To build Software Development Kit (SDK), run the commands below after building a BSP.

$ cd $WORK/build $ bitbake core-image-weston-sdk -c populate_sdk

Note) Please setup a building environment to enable Qt before building BSP. This SDK is also valid for images which

enabled Gekco or disabled GUI frameworks.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 17 of 22 Mar 31, 2021

4. Changes from previous version

The Linux kernel has been replaced to newer one. Version information of all components are available at “Component list of VLP”. Almost all components are same as VLP v2.1.7.

Table 5. Versions of commonly used components

Components

VLP v2.1.7

VLP v2.1.9

Linux kernel

4.4.222-cip45

4.4.249-cip53

GCC

7.2.1 (Linaro GCC 7.2-2017.11)

Glibc

2.19 (CIP)

2.28 (CIP)

Busybox

1.22.0 (CIP)

1.30.1 (CIP)

Openssl

1.0.1t (CIP)

1.1.1d (CIP)

gstreamer1.0

1.12.2

Wayland

1.13.0

Weston

2.0.0

python3

3.5.3

Qt (LGPL version)

5.6.3

Note) By default settings, VLP v2.1.9 and later integrate Debian 10 (Buster) based CIP Core Packages which

indicated as “(CIP)” in the Table 5. Older Debian 8 (Jessie) based CIP packages are still supported just in case. Please refer to 6. Notes (3) for how to select between Debian versions to be built in. For more technical information, please contact Renesas.

Note) Python2 is removed in this release because it is EOL.

Note) CIP version of components is going to be maintained by CIP project for over ten years.

The booting method and the required settings are not changed from the previous version. Please refer to “RZ/G Verified Linux Package Start-Up Guide”.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 18 of 22 Mar 31, 2021

5. Restrictions

In this version, Wifi/Bluetooth on the iWave RZ/G1E rev4.0 board has not been supported.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 19 of 22 Mar 31, 2021

6. Notes

(1) Weston

Due to the specification of opensource software (Weston 2.0.0), it is not recommended to resize application windows. Please consider designing the application to use fixed sized windows.

(2) HTML5

• Patch for iWave Platform of RZ/G1E, RZ/G1C

✓ iWave RZ/G1E-PF SODIMM Development Platform ✓ iWave RZ/G1C-PF Pi SBC Development Platform

The above target boards don’t have enough memory to operate HTML5(Gecko) properly. In case to use HTML5 on them, please run the commands below to adjust memory for HTML5 after the step (2) of the section 3.1.

$ cd $WORK/meta-renesas $ patch -p1 < ../extra/0001-mmngr-iwg22m-iwg23s-reducing-CMA-reserved-for-MMP-\

to.patch

After that, run the steps (3) - (8) of the section 3.1.

Note) Gecko for RZ/G1E and RZ/G1C is tested on the environment of CMA 128MB, the other functions are tested on

that of CMA 256MB which is default.

• WebGL (Web Graphics Library)

RZ/G1E, RZ/G1C cannot use WebGL of JavaScript API for 2D/3D graphics.

(3) CIP Core Packages

VLP includes Debian 10 (Buster) based CIP Core Packages which indicated as “(CIP)” in Table 5 and enabled in the default settings. Replacing by Debian 8 (Jessie) based CIP Core Packages is not recommended but can do following instructions as below. CIP Core Packages are going to be maintained by the Civil Infrastructure Platform project. For more technical information, please contact Renesas.

Note) Debian 8 (Jessie) based CIP Core Packages can be built, but they are not fully tested. They are preliminary and

provided AS IS with no warranty.

Buster-full (default):

The following line is added as default in the local.conf:

CIP_MODE = "Buster-full"

Jessie:

This setting selects Debian 8 (Jessie) based CIP Core Packages. Add the following line in the local.conf:

CIP_MODE = "Jessie"

Additional OSS packages will be downloaded via the internet to build Debian 8 (Jessie) based CIP Core Packages when running bitbake command, so please connect the Linux Host PC to the network before starting the build, and change the line in the ${WORK}/build/conf/local.conf as below:

Change BB_NO_NETWORK from “1” to “0”.

BB_NO_NETWORK = "0"

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 20 of 22 Mar 31, 2021

Table 6 shows a comparison between Jessie and Buster based CIP core packages. Table 6. Versions of Packages

(4) GPIO of RZ/G1H

In this release, the driver module that controls the GPIO on RZ/G1H is updated. Please refer to “RZ/G1 Group BSP Manual Set” for details. For example, when you write an application to toggle GPIO5_0 in VLP v2.1.7, the below command is necessary to export and create a device node for the GPIO pin:

$ echo 832 > /sys/class/gpio/export

In VLP v2.1.9, it is changed like following.

$ echo 836 > /sys/class/gpio/export

Package

Jessie

Buster

busybox

1.22

1.30.1

openssl

1.0.1t

1.1.1d

glibc

2.19

2.28

binutils

2.25

2.31.1

openssh

7.5p1

7.9p1

coreutils

8.27

8.30

gnupg

2.2.0

2.2.12

libassuan

2.4.3

2.5.2

libpam

1.3.0

1.3.1

libgcrypt

1.8.0

1.8.4

libunistring

0.9.7

0.9.10

libunwind

1.2

perl

5.24.1

5.28.1

bash

4.4

diffutils

3.6

dosfstools

4.1

gawk

4.1.4

1.4.18

make

4.2.1

sed

4.2.2

asciidoc

8.6.9

cpio

2.12

cronie

1.5.1

expect

5.45

gpgme

1.9.0

groff

1.22.3

gzip

1.8

1.9

logrotate

3.12.3

man

1.6g

patchelf

0.9

pixz

1.0.6

slang

2.3.1a

swig

3.0.12

unfs3

0.9.22-r497

xmlto

0.0.28

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 21 of 22 Mar 31, 2021

To check the GPIO ranges in VLP v2.1.7, please execute the below command in the Linux command line (RZ/G1H as an example):

$ cat /sys/kernel/debug/pinctrl/e6060000.pin-controller/gpio-ranges GPIO ranges handled: 0: e6050000.gpio GPIOS [992 - 1023] PINS [0 - 31] 0: e6051000.gpio GPIOS [962 - 991] PINS [32 - 61] 0: e6052000.gpio GPIOS [932 - 961] PINS [64 - 93] 0: e6053000.gpio GPIOS [900 - 931] PINS [96 - 127] 0: e6054000.gpio GPIOS [868 - 899] PINS [128 - 159] 0: e6055000.gpio GPIOS [836 - 867] PINS [160 - 191]

From the command line output of above example, we can see GPIO5 bank (with physical address e6055000) has the range of [836 – 867]. It means number 836 is assigned to GPIO5_0 by Linux.

RZ/G Verified Linux Package Release Note

R01TU0269EJ0108 Rev. 1.08 Page 22 of 22 Mar 31, 2021

Website and Support

Renesas Electronics Website

http://www.renesas.com/

Inquiries

http://www.renesas.com/contact/

All trademarks and registered trademarks are the property of their respective owners.

Renesas RZ/G User manual

Specifications and Main Features

Frequently Asked Questions

User Manual