iWave iW-RainboW-G21M User manual

REL 1.2
Page 1 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
iW-RainboW-G21M
RZ/G1H Qseven SOM
Linux User Guide

REL 1.2
Page 2 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
Document Revision History
Document Number
iW-PREXZ-UM-01-R2.0-REL1.0-Linux3.10.31
Revision
Date
Description
1.0
18th Aug 2016
Initial Version
1.1
3rd Jan 2017
Yocto build link and commands updated
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.2
Page 3 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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.2
Page 4 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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 .........................................................................................................................................................20
2.2.7 Linux kernel .................................................................................................................................................21
2.2.8 Cross-compiler build....................................................................................................................................22
2.3 BSP STANDALONE COMPILATION ........................................................................................................................... 23
2.3.1 Loader .........................................................................................................................................................24
2.3.2 U-Boot .........................................................................................................................................................25
2.3.3 Linux kernel .................................................................................................................................................26
2.4 BSP CUSTOMIZATION........................................................................................................................................... 28
2.4.1 I2C device ....................................................................................................................................................28
2.4.2 UART............................................................................................................................................................ 29
2.4.3 GPIO ............................................................................................................................................................ 29
2.4.4 LVDS ............................................................................................................................................................30
2.4.5 Primary Display ........................................................................................................................................... 31
2.4.6 Boot Logo Configuration ............................................................................................................................. 31
2.4.7 USB OTG Host Configuration.......................................................................................................................31
2.4.8 Yocto Package .............................................................................................................................................32
3. BINARY PROGRAMMING ............................................................................................................................ 33
3.1 JTAG PROGRAMMING .........................................................................................................................................33
3.1.1 Requirements ..............................................................................................................................................33
3.1.2 Booting Via JTAG.........................................................................................................................................34
3.1.3 U-Boot Programming .................................................................................................................................. 35
3.2 MANUAL PROGRAMMING..................................................................................................................................... 36
3.2.1 Requirements ..............................................................................................................................................36
3.2.2 SD Card Preparation.................................................................................................................................... 36
3.2.3 eMMC Partition........................................................................................................................................... 37

REL 1.2
Page 5 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
3.2.4 U-Boot Programming .................................................................................................................................. 39
3.2.5 Kernel Programming ................................................................................................................................... 40
3.3 BOOTABLE SD CARD ............................................................................................................................................ 41
3.3.1 Requirements ..............................................................................................................................................41
3.3.2 SD Card Partition......................................................................................................................................... 41
3.3.3 SD Card Programming.................................................................................................................................44
4. U-BOOT TESTING AND BOOT CONFIGURATION............................................................................................ 45
4.1 BASIC COMMANDS............................................................................................................................................... 45
4.2 RAM TEST .........................................................................................................................................................46
4.3 SD/MMC TEST .................................................................................................................................................. 47
4.4 SPI NOR FLASH TEST........................................................................................................................................... 48
4.5 USB TEST........................................................................................................................................................... 48
4.6 ETHERNET TEST ...................................................................................................................................................49
4.6.1 TFTP & NFS Host PC setup........................................................................................................................... 49
4.7 ENVIRONMENT VARIABLES SETTINGS .......................................................................................................................51
4.7.1 eMMC boot ................................................................................................................................................. 51
4.7.2 Standard SD boot ........................................................................................................................................ 51
4.7.3 TFTP & NFS boot.......................................................................................................................................... 52
4.7.4 HDMI Resolution setting ............................................................................................................................. 52
4.7.5 VIN Camera Selection.................................................................................................................................. 53
4.7.6 SPI/VIN2 Camera Selection .........................................................................................................................53
4.7.7 Default Environment Variable..................................................................................................................... 53
5. LINUX PERIPHERAL TESTING........................................................................................................................ 54
5.1 BLOCK DEVICES TEST ............................................................................................................................................ 54
5.1.1 Testing device Requirements ...................................................................................................................... 54
5.1.2 Block Device Test......................................................................................................................................... 55
5.1.3 USB OTG as device ......................................................................................................................................56
5.1.4 SPI NOR Flash Test.......................................................................................................................................57
5.2 NETWORK DEVICES TEST ....................................................................................................................................... 58
5.2.1 Testing device Requirements ...................................................................................................................... 58
5.2.2 Ethernet Test ............................................................................................................................................... 58
5.2.3 Ethernet speed and duplex settings ............................................................................................................ 60
5.2.4 File transfer using TFTP server .................................................................................................................... 60
5.2.5 Folder mount from NFS ............................................................................................................................... 60
5.2.6 CAN Test......................................................................................................................................................61
5.3 DISPLAY DEVICES TEST .......................................................................................................................................... 62
5.3.1 Testing device Requirements ...................................................................................................................... 62
5.3.2 LCD Test....................................................................................................................................................... 62
5.3.3 HDMI Test.................................................................................................................................................... 62
5.3.4 Qseven LVDS control Test............................................................................................................................ 63
5.3.5 PWM brightness Test ..................................................................................................................................63
5.4 HID DEVICES TEST ...............................................................................................................................................64
5.4.1 Testing device Requirements ...................................................................................................................... 64

REL 1.2
Page 6 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
5.4.2 Mouse Test..................................................................................................................................................64
5.4.3 Keyboard Test.............................................................................................................................................. 64
5.4.4 Touch screen Test........................................................................................................................................65
5.5 UART TEST ........................................................................................................................................................67
5.6 PCIE DEVICE TEST ................................................................................................................................................ 68
5.7 RTC TEST ........................................................................................................................................................... 68
5.8 MULTIMEDIA TEST ............................................................................................................................................... 69
5.8.1 Testing device Requirements ...................................................................................................................... 69
5.8.2 Audio Test.................................................................................................................................................... 69
5.8.3 Camera Test ................................................................................................................................................ 70
5.8.4 GPU Test...................................................................................................................................................... 71
5.8.5 Gstreamer Test............................................................................................................................................ 72
5.9 GPIO TESTING ....................................................................................................................................................74
5.9.1 Thermal trip LED test...................................................................................................................................74
5.10 PROCESSOR COOLING FANCONTROL TEST ............................................................................................................... 76
5.11 WAYLAND .......................................................................................................................................................... 77
5.11.1 Camera Test ................................................................................................................................................ 77
5.11.2 GPU Test......................................................................................................................................................78
5.11.3 Gstreamer Test............................................................................................................................................ 79
6. APPENDIX –Frequently Asked Questions .................................................................................................... 80

REL 1.2
Page 7 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
List of Figures
FIGURE 1: BOOT DEVICE MEMORY LAYOUT .............................................................................................................................. 33
FIGURE 2: LCD -YOCTO GUI .................................................................................................................................................62
FIGURE 3: HDMI -YOCTO GUI .............................................................................................................................................. 62
FIGURE 4: YOCTO HOME SCREEN............................................................................................................................................65
FIGURE 5: YOCTO MENU SELECTION........................................................................................................................................65
FIGURE 6: YOCTO TOUCH CALIBRATION ICON ........................................................................................................................... 66
FIGURE 7: YOCTO TOUCH CALIBRATION................................................................................................................................... 66
List of Tables
TABLE 1: ACRONYMS &ABBREVIATIONS ................................................................................................................................... 8
TABLE 2: DRIVER SOURCE PATH............................................................................................................................................. 10
TABLE 3: DEVICE TREE SOURCE .............................................................................................................................................. 14
TABLE 4: CAMERA INPUT RESOLUTION SETTINGS ....................................................................................................................... 70
TABLE 5: GPIO DEVICE NODE ................................................................................................................................................75
TABLE 6: WAYLAND –CAMERA INPUT RESOLUTION SETTINGS .....................................................................................................78
TABLE 7: SOM SWITCH SETTINGS ..........................................................................................................................................81

REL 1.2
Page 8 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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/G1H 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/G1H SOM.
The Linux BSP is the collection of binary, source code and support files that can be used to create a Linux kernel
image and a root file system for RZ/G1H 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.2
Page 9 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
Acronyms
Abbreviations
UART
Universal Asynchronous Receiver/Transmitter
USB
Universal Serial Bus
USB OTG
USB On The Go

REL 1.2
Page 10 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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/G1H 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/G1H 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-bq32k.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.2
Page 11 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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/usbgadget.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.2
Page 12 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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.2
Page 13 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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.2
Page 14 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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/G1H 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
r8a7742_iwg21m.dtsi
This device tree source include file defines the common CPU
controllers configuration of RZ/G1H (Quad) processors used in iW-
RainboW-G21 platform.
r8a7742-iwg21m_q7.dts
This device tree source file is for Renesas R8A7742 (Quad) processors
used in iW-RainboW-G21 platforms.

REL 1.2
Page 15 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
2.2 BSP Yocto Compilation
This section explains procedure and detailed information about compiling the YOCTO for RZ/G1H 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/G1H 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.2
Page 16 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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 iwg21m-release-bsp;cd iwg21m-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
Checkout available version of each git clone.
$ cd iwg21m-release-bsp/poky
$ git checkout -b tmp yocto-1.6.1
$ cd iwg21m-release-bsp/meta-openembedded
$ git checkout -b tmp dca466c074c9a35bc0133e7e0d65cca0731e2acf
$ cd iwg21m-release-bsp/meta-linaro
$ git checkout -b tmp 8a0601723c06fdb75e62aa0f0cf15fc9d7d90167
The Yocto tar file from deliverables is located in the below path.
iW-RainboW-G21M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables/Source-
Code/Linux/Yocto/meta-renesas.tar.gz
Extract the Yocto tar file.
$ cd ~/<path to iwg21m-release-bsp>/iwg21m-release-bsp/
$ tar zxf ~/<path to Yocto tar file>/meta-renesas.tar.gz
The Yocto patch file from deliverables is located in the below path.
iW-RainboW-G21M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables/Source-
Code/Linux/Yocto/PATCH003-iW-PREXZ-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>/PATCH003-iW-PREXZ-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.
iW-RainboW-G21M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables/Source-
Code/Linux/Yocto/copy_proprietary_softwares.sh
iW-RainboW-G21M-Q7-RX.X-RELX.X-Linux3.10.31-YoctoDaisy_Deliverables/Source-
Code/Linux/Yocto/PKG-DIR

REL 1.2
Page 17 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
Copy proprietary software into recipe directory structure.
$ sh <path to script file>/copy_proprietary_softwares.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 iWG21M platform.
$ cp -rf ../meta-renesas/meta-rzg1/templates/iwg21m_q7-config/bblayers.conf ./conf
To build X11 for iWG21 platform, overwrite the local.conf file with X11 configuration files by executing the
below command
$ cp -rf ../meta-renesas/meta-rzg1/templates/iwg21m_q7-config/local-x11.conf ./conf/local.conf
To build Wayland for iWG21 platform, overwrite the local.conf file with wayland configuration files by
executing the below command
$ cp -rf ../meta-renesas/meta-rzg1/templates/iwg21m_q7-config/local-wayland.conf
./conf/local.conf

REL 1.2
Page 18 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
2.2.5 Yocto build
This section provides the detailed information and process for building the Yocto binaries.
Note:
1. In Filepath, meta-linaro/meta-linaro-toolchain/recipes-devtools/gdb/gdb-linaro-7.6.1.inc, replace following line
SRC_URI = “https://releases.linaro.org/${MMYY}/components/toolchain/gdb-linaro/gdb-${PV}-
${RELEASE}.tar.bz2”
with
SRC_URI=”https://releases.linaro.org/archive/${MMYY}/components/toolchain/gdb-linaro/gdb-${PV}-
${RELEASE}.tar.bz2”
2. In Filepath, meta-linaro/meta-linaro-toolchain/recipes-devtools/gcc/gcc-linaro-4.8.inc, replace following line
SRC_URI = "https://releases.linaro.org/${MMYY}/components/toolchain/gcc-linaro/${BASEPV}/gcc-${PV}-
${RELEASE}.tar.xz \
with
SRC_URI = "https://releases.linaro.org/archive/${MMYY}/components/toolchain/gcc-linaro/${BASEPV}/gcc-
${PV}-${RELEASE}.tar.xz \
Open a terminal window and change the directory as follows.
$ cd iwg21m-release-bsp
$ source poky/oe-init-build-env
To compile the yocto file system for X11, execute the below command.
$ bitbake core-image-x11
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 iwg21m-release-bsp>/iwg21m-release-bsp/build/tmp/deploy/images/iwg21m/
The binary files are listed below
core-image-<x11/weston>-iwg21m-<date & time>.rootfs.tar.bz2
uImage--<revision>-iwg21m-<date & time>.bin
uImage--<revision>-r8a7742-iwg21m_q7-<date & time>.dtb
u-boot-iwg21m-<revision>.bin
Rename the binary files as mentioned below
core-image-<x11/weston>-iwg21m-<date & time>.rootfs.tar.bz2- -> rootfs.tar.bz2
uImage--<revision>-iwg21m-<date & time>.bin - -> uImage
uImage--<revision>-r8a7742-iwg21m_q7-<date & time>.dtb - - > r8a7742-iwg21m_q7.dtb
u-boot-iwg21m-<revision>.bin - -> u-boot.bin

REL 1.2
Page 19 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H Qseven SOM Linux User Guide
Both X11 and Wayland cannot be compiled with same build folder. Once the X11 or Wayland is compiled,
rename the build folder inside iwg21m-release-bsp and follow the steps mentioned in this section to build
the other one.
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.2
Page 20 of 83
iWave Systems Technologies Pvt. Ltd.
RZ/G1H 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 iwg21m-release-bsp>/iwg21m-release-bsp/
To compile the u-boot, execute the below command.
$ bitbake u-boot-iwg21m
To re-build u-boot, execute the below commands.
$ bitbake -f -c compile u-boot-iwg21m
After the successful compilation the binaries will be placed in below path.
~/<path to iwg21m-release-bsp>/iwg21-release-bsp/build/tmp/work/cortexa15hf-vfp-neon-poky-
linux-gnueabi/u-boot-iwg21m/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.