Renesas RZ-G1H, RZ-G1M, RZ-G1N, RZ-G1E, RZ-G1C User Manual

All information contained in these materials, including products and product specifications, represents information on the product at the time of publication and is subject to change by Renesas Electronics Corp. without notice. Please review the latest information published by Renesas Electronics Corp. through various means, including the Renesas Electronics Corp.

website (http://www.renesas.com).

Linux Interface

Specification Yocto recipe Start-Up Guide

User’s Manual: Software

Rev2.12 Dec. 2020

RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C

User

’

s Manual

www.renesas.com

R8A77420 R8A77430 R8A77440 R8A77450 R8A77470

How to Use This Manual

 [Readers]

This manual is intended for engineers who develop products which use the RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C processors.

 [Purpose]

This manual is intended to give users an understanding of the functions of the RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C processor device driver and to serve as a reference for developing hardware and software for systems that use this driver.

 [How to Read This Manual]

It is assumed that the readers of this manual have general knowledge in the fields of electrical  Engineering, logic circuits, microcontrollers, and Linux.

→ Read this manual in the order of the CONTENTS.

 To understand the functions of a multimedia processor for RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C.

→ See the RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C User’s Manual.

 To know the electrical specifications of the multimedia processor for RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E,

RZ/G1C.

→ See the RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Data Sheet.

 [Conventions]

The following symbols are used in this manual. Data significance: Higher digits on the left and lower digits on the right

Note: Footnote for item marked with Note in the text Caution: Information requiring particular attention Remark: Supplementary information

Numeric representation: Binary ... ××××, 0b××××, or ××××B Decimal ... ×××× Hexadecimal ... 0x×××× or ××××H Data type: Word … 32 bits Half word ... 16 bits Byte ... 8 bits

Trademark

All trademarks and registered trademarks are the property of their respective owner

・ Official name of Windows® is Microsoft® Windows® Operating System. ・ Microsoft and Windows are trademarks or registered trademarks of Microsoft Corporation, in the United States

and/or other countries.

・ ARM® is a registered trademark or a trademark of ARM Company in the United States and/or other countries. ・ Linux® is registered is trademark or registered trademark of Linus Torvalds, in the United States and/or other countries. ・ Ubuntu® is trademark or registered trademark of Canonical Limited, in the United Kingdom and/or other countries. ・ Qt® is trademark or registered trademark of The Qt Company Ltd, in the United States and/or other countries. ・ Trademark and registered trademark symbols (® and ™) are sometimes omitted in this document.

Table of Contents

Introduction ............................................................................................................................................ 1

1. RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux BSP package files ..................................... 2

1.1 Reference (RZ/G1H) ................................................................................................................................................. 2

1.2 Reference (RZ/G1M) ................................................................................................................................................ 2

1.3 Reference (RZ/G1N) ................................................................................................................................................. 2

1.4 Reference (RZ/G1E) ................................................................................................................................................. 3

1.5 Reference (RZ/G1C) ................................................................................................................................................. 3

2. ENVIRONMENTAL REQUIREMENT ........................................................................................... 4

2.1 Setting of parts ................................ ................................................................................................ .......................... 4

2.2 Setting of dip switch ................................................................................................................................................. 6

3. Building Instructions .......................................................................................................................... 7

3.1 Common instructions ................................ ................................ ................................................................ ................ 7

3.2 Build images with demo packages .......................................................................................................................... 10

3.3 Build images without demos package ..................................................................................................................... 15

4. Confirm starting of U-Boot and Linux ............................................................................................ 17

5. Exporting Toolchains ....................................................................................................................... 23

6. Memory map .................................................................................................................................... 25

7. How to write binary file by TFTP .................................................................................................... 31

8. U-Boot command ............................................................................................................................. 34

9. Appendix .......................................................................................................................................... 35

9.1 IPMMU Example ................................ ................................................................................................ .................... 35

R01US0227EJ0212 Rev2.12 Page 1 of 37 Dec 31, 2020

Introduction

This start-up guide explains RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Yocto recipe package files, the system environments, the make method of kernel, the operating of U-Boot and so on.

This product RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Yocto recipe is a basic package to operate built-in Linux and basic middleware on the iW-RainboW-G21D RZ/G1H Qseven Development Platform, iW-RainboW-G20D RZ/G1M Qseven Development Platform, iW-RainboW-G20D RZ/G1N Qseven Development Platform, iW-RainboWG22D RZ/G1E SODIMM Development Platform and iW-RainboW-G23S RZ/G1C Single Board Computer. Please contact Renesas Electronics person who provided this product to you in case of questions.

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 2 of 37 Dec 31, 2020

1. RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux BSP package files

This Yocto recipe will be taken

The U-Boot source code from:

git://github.com/renesas-rz/renesas-u-boot-cip.git;branch=2013.01.01/rzg1-iwave

RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux source code from:

https://github.com/renesas-rz/renesas-cip.git;branch=v4.4.x-cipy (for normal linux) https://github.com/renesas-rz/renesas-cip.git;branch=v4.4.x-cipy-rt (for realtime linux)

1.1 Reference (RZ/G1H)

Document name

Version

Date

RZ/G1H User's Manual: Hardware

Rev.1.00

2016.09.30

RZ/G Series, User’s Manual: Hardware

Rev.1.00

2016.09.30

iW-RainboW-G21M RZ/G1H Qseven SOM Hardware User Guide

iW-RainboW-G21D RZ/G1H Qseven Development Platform Hardware User Guide

1.2 Reference (RZ/G1M)

Document name

Version

Date

RZ/G1M User's Manual: Hardware

Rev.1.00

2016.09.30

RZ/G Series, User’s Manual: Hardware

Rev.1.00

2016.09.30

iW-RainboW-G20M RZ/G1M Qseven SOM Hardware User Guide

iW-RainboW-G20D RZ/G1M Qseven Development Platform Hardware User Guide

1.3 Reference (RZ/G1N)

Document name

Version

Date

RZ/G1N User's Manual: Hardware

Rev.1.00

2016.09.30

RZ/G Series, User’s Manual: Hardware

Rev.1.00

2016.09.30

iW-RainboW-G20M RZ/G1N Qseven SOM Hardware User Guide

iW-RainboW-G20D RZ/G1N Qseven Development Platform Hardware User Guide

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 3 of 37 Dec 31, 2020

1.4 Reference (RZ/G1E)

1.5 Reference (RZ/G1C)

Document name

Version

Date

RZ/G1C User's Manual: Hardware

Rev.1.00

2017.10.13

RZ/G Series, User’s Manual: Hardware

Rev.1.00

2016.09.30

iW-RainboW-G23S RZ/G1C SBC Hardware User Guide

Document name

Version

Date

RZ/G1E User's Manual: Hardware

Rev.1.00

2016.09.30

RZ/G Series, User’s Manual: Hardware

Rev.1.00

2016.09.30

iW-RainboW-G22M RZ/G1E SODIMM SOM Hardware User Guide

iW-RainboW-G22M RZ/G1E SODIMM Development Kit Hardware User Guide

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 4 of 37 Dec 31, 2020

2. ENVIRONMENTAL REQUIREMENT

2.1 Setting of parts

Host PC and terminal software are necessary for the operation of this product. Furthermore, Ethernet cable is required to use NFS mount function. Please refer to Table 1.

Table 1 RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux BSP Environmental Requirement

Equipment

Explanation

Linux Host PC

Ubuntu 16.04 LTS is recommended as OS It is used as building and debugging environment. It is used as TFTP server and NFS server.

Windows Host PC

Windows 7 or 10 are recommended as OS. It is used as debugging environment. Terminal software and VCP driver are executed.

Terminal software

Please use following software 1) or 2).

1) Hyperterm (Included in WindowsXP)

2) TeraTerm (Confirmed with Japanese version of Tera Term 4.72 Available at http://sourceforge.jp/projects/ttssh2 )

VCP driver

Please install following VCP driver to Windows Host PC before you connect Windows Host PC and the RZ/G1 board.

Latest VCP Driver for Windows:

 Available at http://www.ftdichip.com/Drivers/VCP.htm

TFTP server software

It is used when SPI Flash is written by U-Boot or zImage/uImage is downloaded.

NFS server software

It is used when File system is mounted by NFS.

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 5 of 37 Dec 31, 2020

Recommended Environment

The following shows a Recommended Environment.

Figure 1 Recommended Environment for RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux BSP

Note) Functions in covered with () are optional.

Hub

[Linux Host PC]

TFTP server

NFS server

Straight Ethernet cable

USB cable (type A to

mini/micro AB)

[Windows7 Host PC]

Terminal software to display console

(ssh to control Linux Host)

(Straight Ethernet cable)

RZ/G1H, RZ/G1M, RZ/G1N

Qseven Development Platform, RZ/G1E SODIMM Development Platform, RZ/G1C SBC

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 6 of 37 Dec 31, 2020

2.2 Setting of dip switch

The setting of RZ/G1H, RZ/G1M, RZ/G1N Qseven Development Platform's dip switches is shown the following Table

2. Please refer to “iW-RainboW-G21D RZ/G1H Qseven Development Kit Hardware User Guide”, “iW-RainboW-G20D RZ/G1M RZ/G1N Qseven Development Kit Hardware User Guide” and “iW-RainboW-G22D-SODIMM RZ/G1E SODIMM Development Kit Hardware User Guide” for details.

Table 2 setting of Dip switches (RZ/G1H, RZ/G1M, RZ/G1N)

Switch2

Bits

Switch2

Bit Name

Description

OFF

BIOS_DISABLE#

Set

BATLOW#

Set

LID_BTN#

Set

USB_SELECT

Set

CODEC_SELECT

Set

PCIe_SELECT

Set - 7

DEBUG_SELECT

Set

USB_ID

Set

Note) SW2 Bit 1 to Bit 5 are not used in RZ/G1H/G1M/G1N carrier board.

Table 3 setting of Dip switches (RZ/G1E)

Switch4

Bits

Switch4

Pin Name

Description

OFF

GPIO974(GP1_14)

Set

GPIO865(GP4_1)

Set

Note) iW-RainboW-G23S RZ/G1C Single Board Computer does not have Dip switch.

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 7 of 37 Dec 31, 2020

3. Building Instructions

You can build BSP by using Yocto Project. Please execute following steps in $WORK directory on Linux Host PC. Filesystem by making following instruction is the one for testing current BSP package in Renesas. Please note that Renesas has not been verified with any other build configuration or modified recipes except “core-image-weston” configuration which is based on upstream Yocto Project deliverables and some additional packages correspond to gstreamer.

Note) Renesas executed following instructions with clean $WORK/build directory. You may use wipe-sysroot and/or bitbake -c cleansstate to reflect modifications of configuration files for Recipe as in open source Yocto Project’s standards, however Renesas strongly recommend to use recipe with clean $WORK/build directory for each configurations because there are some implicit dependency for header files exist to keep compatibility between application build scheme with/without RZ/G Multimedia Package.

If you want to build image with demo packages, please follow the instructions in 3.1, then go to 3.2. If you want to build image without demo packages, please execute 3.1 and 3.3.

3.1 Common instructions

Step 1 installation of required commands

Ubuntu is used as Linux Host PC since Yocto Project Quick Start specifies Ubuntu as one of the distributions. In case of that you can install the required commands as follows. Please refer to yocto website for detail: https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/yocto-project-qs.html

Note) There is a bitbake command in $WORK/poky/scripts/. Command path is available after step 6. Note) When you use terminal interactions to build such as menuconfig under non-X terminal (ssh, etc.), please install “screen” command package to Host PC Note) Below commands are required in case of building HTML5 version

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

$ 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

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 8 of 37 Dec 31, 2020

Step 2 download of required files

Required files (poky, meta-openembedded, meta-linaro, meta-renesas, meta-qt5) are downloaded by git clone.

Below files are required in case of building HTML5 version

$ export WORK=<path-to-your-build-directory> $ mkdir $WORK $ cd $WORK $ git clone git://git.yoctoproject.org/poky $ git clone git://git.openembedded.org/meta-openembedded $ git clone git://git.linaro.org/openembedded/meta-linaro.git $ git clone https://github.com/meta-qt5/meta-qt5.git $ git clone https://github.com/renesas-rz/meta-renesas

$ git clone https://github.com/webdino/meta-gecko-embedded.git $ git clone -b firefox-60esr https://github.com/webdino/meta-browser.git $ git clone -b jethro-14.0.1_rust_1.24.1 https://github.com/webdino/metarust.git

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 9 of 37 Dec 31, 2020

Step 3 checkout and cherry-pick patches

Please checkout available version of each git clone.

Note) tmp is a temporary name of a local branch. We can use checkout command without branch. Please note that HEAD refers directly to commit (detached HEAD).

$ cd $WORK/poky $ git checkout -b tmp 342fbd6a3e57021c8e28b124b3adb241936f3d9d $ cd $WORK/meta-openembedded $ git checkout -b tmp dacfa2b1920e285531bec55cd2f08743390aaf57 $ cd $WORK/meta-linaro $ git checkout -b tmp 75dfb67bbb14a70cd47afda9726e2e1c76731885 $ cd $WORK/meta-qt5 $ git checkout -b tmp c1b0c9f546289b1592d7a895640de103723a0305 $ cd $WORK/meta-renesas

Please choose a specific version e.g. If BSP version is v2.1.1 (support all RZ/G1H,M,N,E,C)

$ git checkout certified-linux-v2.1.1

[Tag name : Feature] certified-linux-v2.1.x : support normal linux certified-linux-v2.1.x-rt : support realtime linux

Linux Interface Specification Yocto recipe Start-Up Guide

R01US0227EJ0212 Rev2.12 Page 10 of 37 Dec 31, 2020

3.2 Build images with demo packages

When you use demo packages (Multimedia and Graphics application for demonstration) from Renesas, please execute as following steps. Otherwise please skip this section and go to section 3.3.

Step 4 download demo packages, checkout and cherry-pick patches

$ cd $WORK $ git clone https://github.com/renesas-rz/meta-rzg-demos $ cd $WORK/meta-rzg-demos

Please choose a specific version. e.g. If BSP version is v2.1.1

$ git checkout certified-linux-v2.1.1

[Tag name : Feature] certified-linux-v2.1.x : support normal and realtime linux

+ 30 hidden pages

Renesas RZ-G1H, RZ-G1M, RZ-G1N, RZ-G1E, RZ-G1C User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Introduction

1. RZ/G1H, RZ/G1M, RZ/G1N, RZ/G1E, RZ/G1C Linux BSP package files

1.1 Reference (RZ/G1H)

1.2 Reference (RZ/G1M)

1.3 Reference (RZ/G1N)

1.4 Reference (RZ/G1E)

1.5 Reference (RZ/G1C)

2. ENVIRONMENTAL REQUIREMENT

2.1 Setting of parts

2.2 Setting of dip switch

3. Building Instructions

3.1 Common instructions

Step 1 installation of required commands

Step 2 download of required files

Step 3 checkout and cherry-pick patches

3.2 Build images with demo packages

Step 4 download demo packages, checkout and cherry-pick patches