iWave Qseven RZ/G1M User manual

REL 1.6
Page 1 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
iW-RainboW-G20M
RZ/G1M, RZ/G1N Qseven SOM
Linux User Guide

REL 1.6
Page 2 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
Document Revision History
Document Number
iW-PREWZ-UM-01-R5.0-REL1.6-Linux3.10.31
Revision
Date
Description
1.0
18th Mar 2016
Initial Version
1.1
06th Jun 2016
USB OTG as Device, OV5640 camera support added
1.2
25th Jun 2016
Updated version - Substantive changes done throughout the document
1.3
27th Oct 2016
Yocto project setup and device tree name updates are done
1.4
16th Dec 2016
Yocto Build links and commands updated
1.5
4th July 2016
Yocto Build links corrected and updated
1.6
14th Jan 2019
Updated based on R5.x SOMs
PROPRIETARY NOTICE: This document contains proprietary material for the sole use of the intended recipient(s). Do
not read this document if you are not the intended recipient. Any review, use, distribution or disclosure by others is
strictly prohibited. If you are not the intended recipient (or authorized to receive for the recipient), you are hereby
notified that any disclosure, copying distribution or use of any of the information contained within this document is
STRICTLY PROHIBITED. Thank you. “iWave Systems Tech. Pvt. Ltd.”

REL 1.6
Page 3 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
Disclaimer
iWave Systems reserves the right to change details in this publication including but not limited to any Product
specification without notice.
No warranty of accuracy is given concerning the contents of the information contained in this publication. To the
extent permitted by law no liability (including liability to any person by reason of negligence) will be accepted by iWave
Systems, its subsidiaries or employees for any direct or indirect loss or damage caused by omissions from or
inaccuracies in this document.
CPU and other major components used in this product may have several silicon errata associated with it. Under no
circumstances, iWave Systems shall be liable for the silicon errata and associated issues.
Trademarks
All registered trademarks, product names mentioned in this publication are the property of their respective owners
and used for identification purposes only.
Certification
iWave Systems Technologies Pvt. Ltd. is an ISO 9001:2015 Certified Company.
Warranty & RMA
Warranty support for Hardware: 1 Year from iWave or iWave's EMS partner.
For warranty terms, go through the below web link,
http://www.iwavesystems.com/support/warranty.html
For Return Merchandise Authorization (RMA), go through the below web link,
http://www.iwavesystems.com/support/rma.html
Technical Support
iWave Systems technical support team is committed to provide the best possible support for our customers so that
our Hardware and Software can be easily migrated and used.
For assistance, contact our Technical Support team at,
Email : [e-mail]
Website : www.iwavesystems.com
Address : iWave Systems Technologies Pvt. Ltd.
# 7/B, 29th Main, BTM Layout 2nd Stage,
Bangalore, Karnataka,
India –560076

REL 1.6
Page 4 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
Table of Contents
1. INTRODUCTION ............................................................................................................................................ 8
1.1 PURPOSE.............................................................................................................................................................. 8
1.2 SCOPE.................................................................................................................................................................. 8
1.3 LIST OF ACRONYMS................................................................................................................................................ 8
2. BOARD SUPPORT PACKAGE......................................................................................................................... 10
2.1 BSP DRIVER DETAILS ............................................................................................................................................ 10
2.1.1 BSP Supported Features ..............................................................................................................................10
2.1.2 Driver Source description ............................................................................................................................10
2.1.3 Device tree source description ....................................................................................................................14
2.2 BSP YOCTO COMPILATION....................................................................................................................................15
2.2.1 Host Requirements...................................................................................................................................... 15
2.2.2 Host setup ...................................................................................................................................................15
2.2.3 Host package installation............................................................................................................................15
2.2.4 Yocto project setup......................................................................................................................................16
2.2.5 Yocto build...................................................................................................................................................18
2.2.6 U-boot .........................................................................................................................................................19
2.2.7 Linux kernel .................................................................................................................................................20
2.2.8 Cross-compiler build....................................................................................................................................21
2.3 BSP STANDALONE COMPILATION ........................................................................................................................... 22
2.3.1 Loader .........................................................................................................................................................23
2.3.2 U-Boot .........................................................................................................................................................24
2.3.3 Linux kernel .................................................................................................................................................25
2.4 BSP CUSTOMIZATION........................................................................................................................................... 26
2.4.1 I2C device ....................................................................................................................................................26
2.4.2 UART............................................................................................................................................................ 27
2.4.3 GPIO ............................................................................................................................................................ 27
2.4.4 LVDS ............................................................................................................................................................28
2.4.5 Primary Display ........................................................................................................................................... 29
2.4.6 Boot Logo Configuration ............................................................................................................................. 29
2.4.7 USB OTG Host Configuration.......................................................................................................................29
2.4.8 Yocto Package .............................................................................................................................................30
3. BINARY PROGRAMMING ............................................................................................................................ 31
3.1 JTAG PROGRAMMING .........................................................................................................................................31
3.1.1 Requirements ..............................................................................................................................................31
3.1.2 Booting Via JTAG.........................................................................................................................................32
3.1.3 U-Boot Programming .................................................................................................................................. 33
3.2 MANUAL PROGRAMMING..................................................................................................................................... 34
3.2.1 Requirements ..............................................................................................................................................34
3.2.2 SD Card Preparation.................................................................................................................................... 34
3.2.3 eMMC Partition........................................................................................................................................... 35

REL 1.6
Page 5 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
3.2.4 U-Boot Programming .................................................................................................................................. 37
3.2.5 Kernel Programming ................................................................................................................................... 38
3.3 BOOTABLE SD CARD ............................................................................................................................................ 39
3.3.1 Requirements ..............................................................................................................................................39
3.3.2 SD Card Partition.........................................................................................................................................39
3.3.3 SD Card Programming.................................................................................................................................42
4. U-BOOT TESTING AND BOOT CONFIGURATION............................................................................................ 43
4.1 BASIC COMMANDS............................................................................................................................................... 43
4.2 RAM TEST .........................................................................................................................................................44
4.3 SD/MMC TEST .................................................................................................................................................. 45
4.4 SPI NOR FLASH TEST........................................................................................................................................... 46
4.5 USBTEST...........................................................................................................................................................46
4.6 ENVIRONMENT VARIABLES SETTINGS ....................................................................................................................... 47
4.6.1 Micro SD boot..............................................................................................................................................47
4.6.2 eMMC boot ................................................................................................................................................. 47
4.6.3 Standard SD boot ........................................................................................................................................48
4.6.4 HDMI Resolution setting ............................................................................................................................. 48
4.6.5 DTB File Selection ........................................................................................................................................48
4.6.6 Default Environment Variable..................................................................................................................... 48
5. LINUX PERIPHERAL TESTING........................................................................................................................ 49
5.1 BLOCK DEVICES TEST ............................................................................................................................................ 49
5.1.1 Testing device Requirements ...................................................................................................................... 49
5.1.2 Block Device Test......................................................................................................................................... 50
5.1.3 USB OTG as device ......................................................................................................................................51
5.1.4 SPI NOR Flash Test.......................................................................................................................................52
5.2 NETWORK DEVICES TEST ....................................................................................................................................... 53
5.2.1 Testing device Requirements ...................................................................................................................... 53
5.2.2 Ethernet Test ............................................................................................................................................... 53
5.2.3 Ethernet speed and duplex settings ............................................................................................................ 54
5.2.4 File transfer using TFTP server ....................................................................................................................54
5.2.5 Folder mount from NFS ............................................................................................................................... 55
5.2.6 CAN Test......................................................................................................................................................55
5.3 DISPLAY DEVICES TEST .......................................................................................................................................... 56
5.3.1 Testing device Requirements ...................................................................................................................... 56
5.3.2 LCD Test....................................................................................................................................................... 56
5.3.3 HDMI Test.................................................................................................................................................... 56
5.3.4 Qseven LVDS control Test............................................................................................................................ 57
5.3.5 PWM brightness Test ..................................................................................................................................57
5.4 HID DEVICES TEST ...............................................................................................................................................58
5.4.1 Testing device Requirements ...................................................................................................................... 58
5.4.2 Mouse Test..................................................................................................................................................58
5.4.3 Keyboard Test.............................................................................................................................................. 58
5.4.4 Touch screen Test........................................................................................................................................59

REL 1.6
Page 6 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
5.5 UART TEST ........................................................................................................................................................60
5.6 PCIE DEVICE TEST ................................................................................................................................................61
5.7 RTC TEST ........................................................................................................................................................... 61
5.8 MULTIMEDIA TEST ...............................................................................................................................................62
5.8.1 Testing device Requirements ...................................................................................................................... 62
5.8.2 Audio Test.................................................................................................................................................... 62
5.8.3 TV-IN Test.................................................................................................................................................... 63
5.8.4 Camera Test ................................................................................................................................................ 65
5.8.5 GPU Test...................................................................................................................................................... 66
5.8.6 Gstreamer Test............................................................................................................................................ 67
5.9 GPIO TESTING ....................................................................................................................................................68
5.9.1 Processor cooling fan test ........................................................................................................................... 68
5.9.2 Thermal trip LED test...................................................................................................................................68
5.9.3 GPIO setting ................................................................................................................................................69
5.10 THERMAL TESTING............................................................................................................................................... 70
6. APPENDIX –Frequently Asked Questions .................................................................................................... 71

REL 1.6
Page 7 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
List of Figures
FIGURE 1: BOOT DEVICE MEMORY LAYOUT .............................................................................................................................. 31
FIGURE 2: LCD -YOCTO GUI .................................................................................................................................................56
FIGURE 3: HDMI -YOCTO GUI .............................................................................................................................................. 56
FIGURE 4: YOCTO TOUCH CALIBRATION................................................................................................................................... 59
FIGURE 5: SPI PROGRAMMING MODULE CONNECTED ON BOARD................................................................................................ 74
FIGURE 6: SPI PROGRAMMING MODULE SWITCHED ON............................................................................................................ 74
FIGURE 7: SPI PROGRAMMING MODULE SWITCHED OFF...........................................................................................................75
List of Tables
TABLE 1: ACRONYMS &ABBREVIATIONS ................................................................................................................................... 8
TABLE 2: DRIVER SOURCE PATH............................................................................................................................................. 10
TABLE 3: DEVICE TREE SOURCE .............................................................................................................................................. 14
TABLE 4: WAYLAND –TV IN INPUT RESOLUTION SETTINGS.........................................................................................................63
TABLE 5: GPIO DEVICE NODE ................................................................................................................................................69

REL 1.6
Page 8 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
1. INTRODUCTION
1.1 Purpose
The purpose of this document is to help the software engineer to program and test the RZ/G1M/G1N SOM Linux
development platform and this will also guide to configure the Linux development environment in the Host PC and
build the board support package.
1.2 Scope
The document describes the U-Boot, Linux Operating systems and related software installed on the RZ/G1M/G1N
SOM. The Linux BSP is the collection of binaries, source code and support files that can be used to create a Linux
kernel image and a root file system for RZ/G1M/G1N SOM.
1.3 List of Acronyms
The following acronyms will be used throughout this document.
Table 1: Acronyms & Abbreviations
Acronyms
Abbreviations
BSP
Board Support Package
CAN
Controller Area Network
CMOS
Complementary Metal Oxide Semiconductor
CPU
Central Processing Unit
DDR3
Double Data Rate 3
eMMC
Enhanced Multi Media Card
HDMI
High-Definition Multimedia Interface
I2C
Inter-Integrated Circuit
Kbps
Kilobits per second
LCD
Liquid Crystal Display
LVDS
Low Voltage Differential Signal
MAC
Media Access Controller
MB
Mega Byte
Mbps
Megabits per sec
MHz
Mega Hertz
MIPI
Mobile Industry CPU Interface
MMC
Multi Media Card
PWM
Pulse Width Modulation
RTC
Real Time Clock
SATA
Serial Advanced Technology Attachment
SD
Secure Digital
SOM
System On Module
SPI
Serial Peripheral Interface

REL 1.6
Page 9 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
Acronyms
Abbreviations
UART
Universal Asynchronous Receiver/Transmitter
USB
Universal Serial Bus
USB OTG
USB On The Go

REL 1.6
Page 10 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2. BOARD SUPPORT PACKAGE
2.1 BSP Driver details
This section explains about the features supported, the device driver details and path of the device drivers and device
tree details in the RZ/G1M/G1N SOM BSP.
2.1.1 BSP Supported Features
Refer the Software release note for the supported features in the BSP.
2.1.2 Driver Source description
This section explains about the device driver details and the corresponding path in the Linux BSP of RZ/G1M/G1N
SOM.
Table 2: Driver Source Path
File Path
Description
eMMC
include/linux/mmc/sh_mmcif.h
MMCIF driver header file
drivers/mmc/host/sh_mmcif.c
MMCIF driver source file
PCIe
drivers/pci/host/pcie-rcar.c
PCIe Controller source file
SATA
drivers/ata/sata_rcar.c
SATA driver source file
drivers/ata/libata.h
libata header file
drivers/ata/ata.h
ata header file
SD
drivers/mmc/host/sh_mobile_sdhi.c
SDHI driver source file
drivers/mmc/host/tmio_mmc.h
SD/SDIO driver header file
drivers/mmc/host/tmio_mmc_pio.c
SD/SDIO driver source file
drivers/mmc/host/tmio_mmc_dma.c
include/linux/mmc/sh_mobile_sdhi.h
SDHI driver header file
include/linux/mmc/host.h
MMC Subsystem host header file
include/linux/mmc/tmio.h
SD/SDIO driver header file
include/linux/mfd/tmio.h
SDHI driver, SD/SDIO driver header file
RTC
drivers/rtc/ rtc-pcf85263.c
RTC Driver Source File
CAN
drivers/net/can/rcar_can.c
CAN Driver Source file
include/linux/can/platform/rcar_can.h
CAN Driver header file
UART
drivers/tty/serial/sh-sci.c
Serial source file
drivers/tty/serial/sh-sci.h
Serial header file

REL 1.6
Page 11 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
File Path
Description
USB (USB OTG as Device)
drivers/usb/renesas_usbhs/common.c
USB driver function/host driver source/header files
drivers/usb/renesas_usbhs/common.h
drivers/usb/renesas_usbh/sfifo.c
drivers/usb/renesas_usbhs/fifo.h
drivers/usb/renesas_usbhs/mod.c
drivers/usb/renesas_usbhs/mod.h
drivers/usb/renesas_usbhs/mod_gadget.c
USB function driver source file
drivers/usb/renesas_usbhs/pipe.c
USB driver function/host driver source/header files
drivers/usb/renesas_usbhs/pipe.h
drivers/usb/gadget/mass_storage.c
USB gadget mass storage driver source file
include/linux/usb/renesas_usbhs.h
USB function driver header file
include/linux/usb/gadget.h
USB gadget driver header file
USB2.0 Host and USB3.0 Host
drivers/usb/host/ehci-hcd.c
EHCI host driver source file
drivers/usb/host/ehci-hub.c
drivers/usb/host/ehci-lpm.c
drivers/usb/host/ehci-mem.c
drivers/usb/host/ehci-q.c
drivers/usb/host/ehci-sched.c
drivers/usb/host/ehci-sysfs.c
drivers/usb/host/ehci-pci.c
EHCI driver source file
drivers/usb/host/ehci.h
EHCI header file
drivers/usb/host/ohci-hcd.c
OHCI host driver source file
drivers/usb/host/ohci-hub.c
drivers/usb/host/ohci-mem.c
drivers/usb/host/ohci-q.c
drivers/usb/host/ohci-pci.c
drivers/usb/host/ohci.h
OHCI header file
drivers/usb/host/xhci.c
xHCI host driver source file
drivers/usb/host/xhci-hub.c
drivers/usb/host/xhci-mem.c
drivers/usb/host/xhci-ring.c
drivers/usb/host/xhci-plat.c
xHCI driver source file
drivers/usb/host/xhci-rcar.c
xHCI driver source file for R-Car H2/M2
drivers/usb/host/xhci.h
xHCI header file
drivers/usb/host/xhci-rcar.h
xHCI header file for R-Car H2/M2
drivers/usb/phy/phy.c
USB phy driver source file
drivers/usb/phy/phy-rcar-gen2-usb.c
R-Car Gen2 USB phy driver for EHCI/OHCI source file
drivers/pci/host/pci-rcar-gen2.c
R-Car Gen2 Internal PCI driver source file
drivers/phy/phy-core.c
Generic Phy framework
drivers/phy/phy-rcar-gen2.c
R-Car Gen2 USB phy driver for xHCI source file

REL 1.6
Page 12 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
File Path
Description
firmware/UU3DRD1FW_2005L.dlmem
xHCI firmware
include/linux/usb.h
USB driver header file
include/linux/usb/hcd.h
HCD driver header file
Audio
sound/soc/codecs/sgtl5000.c
SGTL5000 CODEC driver source file
sound/soc/codecs/sgtl5000.h
SGTL5000 CODEC driver header file
sound/soc/sh/rcar/rsnd.h
Driver internal header file
include/sound/rcar_snd.h
Driver external header file
sound/soc/generic/simple-card.c
Driver source file
sound/soc/sh/rcar/core.c
sound/soc/sh/rcar/genc
sound/soc/sh/rcar/ssi.c
sound/soc/sh/rcar/src.c
sound/soc/sh/rcar/dvc.c
sound/soc/sh/rcar/adg.c
Display
drivers/gpu/drm/rcar-du/rcar_du_crtc.c
CRTC source file
drivers/gpu/drm/rcar-du/rcar_du_crtc.h
CRTC header file
drivers/gpu/drm/rcar-du/rcar_du_drv.c
DRM driver source file
drivers/gpu/drm/rcar-du/rcar_du_drv.h
DRM driver header file
drivers/gpu/drm/rcar-du/rcar_du_encoder.c
DRM encoder source file
drivers/gpu/drm/rcar-du/rcar_du_encoder.h
DRM encoder header file
drivers/gpu/drm/rcar-du/rcar_du_group.c
DRM group source file
drivers/gpu/drm/rcar-du/rcar_du_group.h
DRM group header file
drivers/gpu/drm/rcar-du/rcar_du_hdmicon.c
HDMI connector source file
drivers/gpu/drm/rcar-du/rcar_du_hdmicon.h
HDMI connector header file
drivers/gpu/drm/rcar-du/rcar_du_kms.c
KMS driver source file
drivers/gpu/drm/rcar-du/rcar_du_kms.h
KMS driver header file
drivers/gpu/drm/rcar-du/rcar_du_lvdscon.c
LVDS connector source file
drivers/gpu/drm/rcar-du/rcar_du_lvdscon.h
LVDS connector header file
drivers/gpu/drm/rcar-du/rcar_du_lvdsenc.c
LVDS encoder source file
drivers/gpu/drm/rcar-du/rcar_du_lvdsenc.h
LVDS encoder header file
drivers/gpu/drm/rcar-du/rcar_du_plane.c
Plane operation source file
drivers/gpu/drm/rcar-du/rcar_du_plane.h
Plane operation header file
drivers/gpu/drm/rcar-du/rcar_du_regs.h
DU register header file
drivers/gpu/drm/rcar-du/rcar_du_vgacon.c
VGA connector source file
drivers/gpu/drm/rcar-du/rcar_du_vgacon.h
VGA connector header file
drivers/gpu/drm/rcar-du/rcar_lvds_regs.h
LVDS register header file
drivers/gpu/drm/rcar-du/vsp_du_if.c
vsp-du interface file
drivers/gpu/drm/rcar-du/vsp_du_if.h
vsp-du interface header file
drivers/gpu/drm/rcar-du/vspd_dl.c
vspd display list file
drivers/gpu/drm/rcar-du/vspd_drv.h
vsp driver header file

REL 1.6
Page 13 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
File Path
Description
drivers/gpu/drm/rcar-du/vspd_drv_main.c
vsp driver main file
drivers/gpu/drm/rcar-du/vspd_drv_private.h
vsp driver private header file
include/linux/platform_data/rcar-du.h
DRM driver header file
drivers/gpu/drm/i2c/adv7511_core.c
ADV7511 source file
drivers/gpu/drm/i2c/adv7511_core.h
ADV7511 header file
SPI
drivers/spi/spi.c
SPI core interface source file
drivers/spi/spi-bitbang.c
drivers/spi/spi-sh-msiof.c
MSIOF driver source file
drivers/mtd/spi-nor/spi-nor.c
SPI NOR Flash driver source file
include/linux/spi/spi.h
SPI core interface header file
include/linux/spi/spi_bitbang.h
include/linux/spi/sh_msiof.h
MSIOF driver header file
include/linux/mtd/spi-nor.h
SPI NOR Flash driver header file
include/linux/spi/flash.h
drivers/mtd/devices/m25p80.c
SPI NOR Flash driver source file
drivers/spi/spi-rspi.c
QSPI driver source file
EtherAVB
drivers/net/ethernet/renesas/ravb_main.c
Gigabit Ethernet driver source file
drivers/net/ethernet/renesas/ravb.h
Gigabit Ethernet driver header file
drivers/net/phy/micrel.c
Phy driver source file
include/linux/micrel_phy.h
Phy driver header file
GPIO
drivers/gpio/gpio-rcar.c
Source file (device dependence)
drivers/gpio/gpiolib.c
GPIO library source file
arch/arm/include/asm/gpio.h
Header file
include/linux/gpio.h
VIN, Camera and TVIN
drivers/media/platform/soc_camera/rcar_vin.c
Video capture driver file
drivers/media/i2c/soc_camera/ov7725.c
OV7725 Camera driver file
drivers/media/i2c/soc_camera/ov5640.c
OV5640 Camera driver file
drivers/media/i2c/tvp5150.c
TVP5150 TV-In driver file
drivers/media/i2c/tvp5150_reg.h
TVP5150 TV-In header file
include/media/ov772x.h
OV7725 Camera header file
include/linux/platform_data/camera_rcar.h
Video capture driver header file
Touch
drivers/input/touchscreen/edt-ft5x06.c
Touch Driver Source file
include/linux/input/edt-ft5x06.h
Touch Driver header file

REL 1.6
Page 14 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.1.3 Device tree source description
This section explains about the device tree source code configuration and organization for RZ/G1M/G1N SOM. The
device tree source codes will be available in below path of the Linux kernel.
~/arch/arm/boot/dts/
Table 3: Device tree source
File Name
Description
r8a7743_iwg20m.dtsi
This device tree source include file defines the common CPU
controller’s configuration of RZ/G1M (Dual) processors used in iW-
RainboW-G20 platform.
r8a7744_iwg20m.dtsi
This device tree source include file defines the common CPU
controller’s configuration of RZ/G1N (Dual) processors used in iW-
RainboW-G20 platform.
r8a7743-iwg20m_q7.dts
This device tree source file is for Renesas R8A7743 (Dual) processors
used in iW-RainboW-G20 platforms.
r8a7744-iwg20m_q7.dts
This device tree source file is for Renesas R8A7744 (Dual) processors
used in iW-RainboW-G20 platforms.

REL 1.6
Page 15 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.2 BSP Yocto Compilation
This section explains procedure and detailed information about compiling the YOCTO for RZ/G1M/G1N SOM.
2.2.1 Host Requirements
A Linux host PC with latest version (ex. Ubuntu version 14.04).
Root permission on the Development Host.
Cross compiler package for RZ/G1M/G1N SOM.
2.2.2 Host setup
This document assumes that Ubuntu PC is used. Not a requirement, but the packages may be named
differently and the method of installing them may be different.
The recommended minimum Ubuntu version is 14.04 or later.
Minimum hard disk space required is about 50 GB and 4GB of RAM.
Note: Earlier version Ubuntu may cause the Yocto Project build setup to fail, because it requires python versions which
are available only starting with Ubuntu 14.04.
2.2.3 Host package installation
To get the Yocto Project expected behaviour in a Linux Host Machine, the packages and utilities described below must
be installed. An important consideration is the hard disk space required in the host machine. For example, when
building on a machine running Ubuntu, the minimum hard disk space required is about 50 GB for the X11 backend. It
is recommended that at least 120 GB be provided, which is enough to compile any backend.
Open a terminal window and install the below packages in host PC
$ sudo apt-get install sed wget cvs subversion git-core coreutils \
unzip texi2html texinfo libsdl1.2-dev docbook-utils gawk \
python-pysqlite2 diffstat help2man make gcc build-essential \
g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \
mercurial autoconf automake groff bc libtool xterm

REL 1.6
Page 16 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.2.4 Yocto project setup
To setup the yocto, follow the procedure given below.
Required files (poky, meta-openembedded, meta-linaro) are downloaded by git clone.
$ mkdir iwg20m-release-bsp; cd iwg20m-release-bsp
$ 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/renesas-rz/meta-renesas
Checkout available version of each git clone.
$ cd iwg20m-release-bsp/poky
$ git checkout -b tmp yocto-1.6.1
$ cd iwg20m-release-bsp/meta-openembedded
$ git checkout -b tmp dca466c074c9a35bc0133e7e0d65cca0731e2acf
$ cd iwg20m-release-bsp/meta-linaro
$ git checkout -b tmp 8a0601723c06fdb75e62aa0f0cf15fc9d7d90167
$ cd iwg20m-release-bsp/meta-renesas
$ git checkout -b tmp 19bf1ed97d04009722bb88a780268822ee60ff83
Un-tar the Source-Code.tar.gz from the deliverables.
$ cd /<path_to_iW-RainboW-G20M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables>/iW-
RainboW-G20M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables/Source-Code/
$ tar -xvf Source-Code.tar.gz
Change to yocto project layers downloaded directory as below.
$ cd /< path to iwg20m-release-bsp>/iwg20m-release-bsp/
The Yocto patch file from deliverables is located in the below path.
/<path_to_Source-Code>/Source-Code/Linux/Yocto/PATCH000-iW-PREWZ-SC-01-RX.X-RELX.X-
YoctoDaisy_basic_customization.patch
To apply the Yocto patch file, execute the below command.
$ patch -Np1 < <path to Yocto patch file>/PATCH000-iW-PREWZ-SC-01-RX.X-RELX.X-
YoctoDaisy_basic_customization.patch
The copy proprietary script file and Multimedia package directory from deliverables is located in the below
path respectively.
/<path_to_Source-Code>/Source-Code/Linux/Yocto/copy_proprietary_softwares-v1100.sh
/<path_to_Source-Code>/Source-Code/Linux/Yocto/PKG-DIR

REL 1.6
Page 17 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
Execute the copied script file.
$ sh <path to script file>/copy_proprietary_softwares-v1100.sh <path to Multimedia package
directory>/PKG-DIR
Execute source command with with oe-init-build-env for setting environment
$ source poky/oe-init-build-env
Copy configuration files, bblayers.conf and local.conf for iWG20M platform.
$ cp ../meta-renesas/meta-rzg1/templates/iwg20m_q7-config/*.conf ./conf/
To build Wayland for iWG20 platform, overwrite the local.conf file with wayland configuration files by
executing the below command
$ cp conf/local-wayland.conf conf/local.conf

REL 1.6
Page 18 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.2.5 Yocto build
This section provides the detailed information and process for building the Yocto binaries.
Open a terminal window and change the directory as follows.
$ cd iwg20m-release-bsp
$ source poky/oe-init-build-env
To compile the yocto file system for Wayland, execute the below command.
$ bitbake core-image-weston
After the successful compilation the binaries will be placed in below path.
~/<path to iwg20m-release-bsp>/iwg20m-release-bsp/build/tmp/deploy/images/iwg20m/
The binary files are listed below
core-image-weston-iwg20m-<date & time>.rootfs.tar.bz2
uImage--<revision>-iwg20m-<date & time>.bin
uImage--<revision>-r8a7743-iwg20m_q7-<date & time>.dtb
uImage--<revision>-r8a7744-iwg20m_q7-<date & time>.dtb
u-boot-iwg20m-<revision>.bin
Rename the binary files as mentioned below
core-image-weston-iwg20m-<date & time>.rootfs.tar.bz2 - -> rootfs.tar.bz2
uImage--<revision>-iwg20m-<date & time>.bin - -> uImage
uImage--<revision>-r8a7743-iwg20m_q7-<date & time>.dtb - - > r8a7743-iwg20m_q7.dtb
uImage--<revision>-r8a7744-iwg20m_q7-<date & time>.dtb - - > r8a7744-iwg20m_q7.dtb
u-boot-iwg20m-<revision>.bin - -> u-boot.bin
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.6
Page 19 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.2.6 U-boot
This section provides the detailed information and process for building the u-boot binary image.
Open a terminal window and change the directory to yocto setup path.
$ cd ~/<path to iwg20m-release-bsp>/iwg20m-release-bsp/
To compile the u-boot, execute the below command.
$ bitbake u-boot-iwg20m
To re-build the u-boot, execute the below commands.
$ bitbake -f -c compile u-boot-iwg20m
After the successful compilation the binaries will be placed in below path.
~/<path to iwg20m-release-bsp>/iwg20-release-bsp/build/tmp/work/cortexa15hf-vfp-neon-poky-
linux-gnueabi/u-boot-iwg20m/v2013.01.01+gitAUTOINC+cb82c56b53-r0/git/
The binary files are listed below
u-boot.bin
Refer the BINARY PROGRAMMING section to update the u-boot binary.

REL 1.6
Page 20 of 76
iWave Systems Technologies Pvt. Ltd.
RZ/G1M/G1N Qseven SOM Linux User Guide
2.2.7 Linux kernel
This section provides the detailed information and process for building the kernel images.
Open a terminal window and change the directory to yocto setup path.
$ cd ~/<path to iwg20m-release-bsp>/iwg20m-release-bsp/
To compile the Linux kernel, execute the below command.
$ bitbake linux-iwg20m
To change the Linux kernel configuration, execute the below command.
$ bitbake -c menuconfig linux-iwg20m
To re-build the Linux kernel from scratch, execute the below command.
$ bitbake -f -c compile linux-iwg20m
After the successful compilation the binaries will be placed in below path.
~/<path to iwg20m-release-bsp>/iwg20m-release-bsp/build/tmp/work/iwg20m-poky-linux-
gnueabi/linux-iwg20m/3.10+gitef3cb04de0d01178a64fea73ffa4c5e21e79f310-r0/git/arch/arm/boot
The binary files are listed below
uImage
dts/r8a7743-iwg20m_q7.dtb
dts/r8a7744-iwg20m_q7.dtb
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.
Refer the Device tree source description section for device tree source code organization.