iWave iW-RainboW-G15D User manual

REL 1.0
Page 1 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
iW-RainboW-G15D
i.MX6 Qseven SOM Development platform
Linux User Guide

REL 1.0
Page 2 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
Document Revision History
Document Number
iW-RainboW-G15M-i.MX6QsevenSOM-Linux4.1.15-SoftwareUserGuide-REL0.1
Revision
Date
Description
1.0
27th Sep 2017
Initial Version
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.0
Page 3 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
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 and product names mentioned in this publication are 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.0
Page 4 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
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 ....................................................................................................................13
2.2 BSP Yocto Compilation....................................................................................................................................14
2.2.1 Host Requirements......................................................................................................................................14
2.2.2 Host setup ...................................................................................................................................................14
2.2.3 Host package installation............................................................................................................................14
2.2.4 Setting up the repo utility............................................................................................................................15
2.2.5 Yocto project setup......................................................................................................................................15
2.2.6 Cross-compiler build....................................................................................................................................16
2.2.7 Yocto build................................................................................................................................................... 17
2.2.8 U-boot .........................................................................................................................................................18
2.2.9 Linux kernel .................................................................................................................................................19
2.3 BSP Standalone compilation ...........................................................................................................................19
2.3.1 U-Boot .........................................................................................................................................................20
2.3.2 Linux kernel .................................................................................................................................................21
2.4 BSP Customization ..........................................................................................................................................23
2.4.1 Display device.............................................................................................................................................. 23
2.4.2 I2C device ....................................................................................................................................................24
2.5 Default Linux boot logo................................................................................................................................... 24
3. BINARY PROGRAMMING ............................................................................................................................ 25
3.1 MFG –Tool Programming................................................................................................................................ 25
3.1.1 Requirements ..............................................................................................................................................25
3.1.2 MFG-Tool.....................................................................................................................................................26
3.1.3 Programming Device Selection ................................................................................................................... 26
3.1.4 Binary Programming ...................................................................................................................................27
3.1.5 Limitations................................................................................................................................................... 28
3.2 Manual SD Card Programming........................................................................................................................ 29
3.2.1 Requirements ..............................................................................................................................................29
3.2.2 SD Card Partition.........................................................................................................................................29
3.2.3 Binary Programming ...................................................................................................................................32
4. U-BOOT TESTING AND BOOT CONFIGURATION............................................................................................ 33
4.1 Basic commands..............................................................................................................................................33

REL 1.0
Page 5 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
4.2 Basic device Tests............................................................................................................................................34
4.2.1 RAM Test .....................................................................................................................................................35
4.2.2 SD/MMC Test ..............................................................................................................................................35
4.2.3 SPI NOR Flash Test.......................................................................................................................................36
4.2.4 I2C Test........................................................................................................................................................36
4.2.5 SATA Test..................................................................................................................................................... 37
4.2.6 Ethernet Test ...............................................................................................................................................37
4.2.7 USB Test ...................................................................................................................................................... 41
4.3 Environment variables settings....................................................................................................................... 41
4.3.1 Micro SD boot.............................................................................................................................................. 41
4.3.2 EMMC boot .................................................................................................................................................42
4.3.3 Standard SD boot ........................................................................................................................................ 42
4.3.4 SATA boot....................................................................................................................................................42
4.3.5 TFTP & NFS boot.......................................................................................................................................... 43
4.3.6 HDMI and LCD settings ............................................................................................................................... 43
4.3.7 Optional features settings........................................................................................................................... 44
5. LINUX PERIPHERAL TESTING........................................................................................................................ 45
5.1 Block devices Test ........................................................................................................................................... 45
5.1.1 SD/eMMC/USB host/ USB OTG (as host)/ SATA test .................................................................................. 46
5.1.2 USB OTG as device ......................................................................................................................................47
5.1.3 SPI NOR Flash Test.......................................................................................................................................49
5.2 Network devices Test......................................................................................................................................49
5.2.1 Ethernet Test ............................................................................................................................................... 50
5.2.2 CAN Test...................................................................................................................................................... 52
5.2.3 Bluetooth Test ............................................................................................................................................. 53
5.3 Display devices Test ........................................................................................................................................ 54
5.3.1 PWM brightness Test ..................................................................................................................................54
5.3.2 Qseven LVDS control Test............................................................................................................................54
5.3.3 LVDS-1 Test..................................................................................................................................................55
5.3.4 LVDS-2 Test..................................................................................................................................................55
5.3.5 HDMI Test.................................................................................................................................................... 56
5.4 HID devices Test..............................................................................................................................................57
5.4.1 USB HID Devices .......................................................................................................................................... 58
5.4.2 Touch screen Test........................................................................................................................................ 58
5.5 UART Test........................................................................................................................................................ 59
5.6 RTC Test...........................................................................................................................................................60
5.7 PCIe Device test...............................................................................................................................................61
5.8 WDOG Test...................................................................................................................................................... 61
5.9 Sensors Test .................................................................................................................................................... 61
5.9.1 Magneto meter ........................................................................................................................................... 62
5.9.2 Accelerometer .............................................................................................................................................62
5.9.3 Barometer ...................................................................................................................................................63
5.9.4 Light sensor .................................................................................................................................................63
5.10 Multimedia test...............................................................................................................................................64

REL 1.0
Page 6 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
5.10.1 Audio Test....................................................................................................................................................64
5.10.2 Camera Test ................................................................................................................................................ 65
5.10.3 Gstreamer Test............................................................................................................................................ 66
5.10.4 VPU Test ......................................................................................................................................................67
5.10.5 GPU Test...................................................................................................................................................... 67
6. APPENDIX................................................................................................................................................... 68
6.1 Frequently Asked Question............................................................................................................................. 68

REL 1.0
Page 7 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
List of Figures
Figure 1: Boot device memory layout.............................................................................................................................25
Figure 2: Platform Detection........................................................................................................................................... 27
Figure 3: Binary Programming Succeed .......................................................................................................................... 28
Figure 4: OTG device detection on Host PC .................................................................................................................... 48
Figure 5: LCD Image Dump.............................................................................................................................................. 55
Figure 6: HDMI 1080p Image .......................................................................................................................................... 56
Figure 7: HDMI 720p Image ............................................................................................................................................ 57
Figure 8: Yocto home screen .......................................................................................................................................... 58
List of Tables
Table 1: Acronyms & Abbreviations.................................................................................................................................. 8
Table 2: Driver Source Path.............................................................................................................................................10
Table 3: Device tree source.............................................................................................................................................13
Table 4: Codec list ...........................................................................................................................................................67

REL 1.0
Page 8 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
1. INTRODUCTION
1.1 Purpose
The purpose of this document is to help the software engineer to program and test the iW-RainboW-G15M-Q7 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 MFG-Tool, U-Boot, Linux Operating systems and related software installed on the iW-
RainboW-G15M-Q7 platform. 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 iW-RainboW-G15M-Q7 platform.
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
CPU
Central Processing Unit
CSI
Camera Serial Interface
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
LDB
LVDS Display Bridge
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
RGMII
Reduced Gigabit Media Independent Interface
RTC
Real Time Clock
SATA
Serial Advanced Technology Attachment
SD
Secure Digital

REL 1.0
Page 9 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
Acronyms
Abbreviations
SOM
System On Module
SPI
Serial Peripheral Interface
UART
Universal Asynchronous Receiver/Transmitter
USB
Universal Serial Bus
USB OTG
USB On The Go

REL 1.0
Page 10 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
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 iW-RainboW-G15M-Q7 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 iW-RainboW-
G15M-Q7 BSP.
Table 2: Driver Source Path
File Path
Description
eMMC
drivers/mmc/host/mxc_mmc.h
MMC driver header file
drivers/mmc/host/mxc_mmc.c
MMC driver source file
PCIe
drivers/pci/host/pci-imx6.c
PCIe controller source file
SATA
drivers/ata/ahci_imx.c
SATA driver source file
SD
drivers/mmc/host/sdhci.c
SDHI driver source file
drivers/mmc/host/sdhci-pltfm.c
SDHI platform layer file
drivers/mmc/host/sdhci-esdhc-imx.c
uSDHC driver source file
drivers/mmc/host/sdhci-esdhc.h
uSDHC driver header file
RTC
drivers/rtc/rtc-snvs.c
SNVS RTC driver file
CAN
drivers/net/can/flexcan.h
CAN driver header file
drivers/net/can/flexcan.c
CAN driver source file
UART
linux/drivers/tty/serial/imx.c
Serial driver source file
USB2.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

REL 1.0
Page 11 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
File Path
Description
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/ehci-platform.c
EHCI Platform driver source file
Audio
sound/soc/fsl/imx-rt5610.c
Machine layer for stereo CODEC ALSA SoC (CODEC as I2S
Master)
ound/soc/codecs/rt5610.c
CODEC driver source file
sound/soc/codecs/rt5610.h
CODEC driver header file
sound/soc/soc-ac97.c
ALSA SoC audio layer AC97
sound/soc/fsl/imx-pcm-dma.c
Platform layer for stereo CODEC ALSA SoC
sound/soc/fsl/imx-pcm.h
PCM driver and AUDMUX register definitions header file
sound/soc/fsl/fsl_ssi.c
SSI CPU DAI driver source file
sound/soc/fsl/fsl_ssi.h
SSI CPU DAI driver and SSI register definitions header file
IPU
drivers/mxc/ipu3/ipu_common.c
IPU common library functions
drivers/mxc/ipu3/ipu_ic.c
IPU IC base driver source file
drivers/mxc/ipu3/ipu_disp.c
IPU display functions source file
drivers/mxc/ipu3/ipu_device.c
IPU driver device interface and fops functions source file
drivers/mxc/ipu3/ipu_capture.c
IPU CSI capture base driver source file
drivers/mxc/ipu3/ipu_calc_stripes_sizes.c
Multistripes method functions for ipu_device.c
drivers/mxc/ipu3/pre.c
Prefetch/Resolve the engine driver source file
drivers/mxc/ipu3/prg.c
Prefetch/Resolve the Gasket driver source file
drivers/mxc/ipu3/ipu_param_mem.h
IPU parameter memory access helper functions header file
drivers/mxc/ipu3/ipu_prv.h
Pre-processing driver header file
drivers/mxc/ipu3/ipu_regs.h
IPU register definitions header file
drivers/mxc/ipu3/pre-regs.h
Prefetch/Resolve Engine register definitions header file
drivers/mxc/ipu3/prg-regs.h
Prefetch/Resolve Gasket register definitions header file
include/linux/ipu.h
IPU basic driver header file
Display
drivers/video/fbdev/mxc/mxc_ipuv3_fb.c
Synchronous frame buffer driver source file
drivers/video/fbdev/mxc/mxc_lcdif.c
Parallel LCD Display driver source file
drivers/video/fbdev/mxc/iwg15_backlight.c
Backlight on/off driver source file
drivers/video/fbdev/mxc/mxc_edid.c
HDMI EDID driver source file
drivers/video/fbdev/mxc/mxc_hdmi.c
HDMI Display Driver source file
drivers/video/fbdev/mxc/ldb.c
On chip LVDS synchronous frame buffer driver source file
GPU
drivers/mxc/gpu-
viv/hal/kernel/arch/gc_hal_kernel_context.c
Hardware-specific driver code for GC2000, GC880, GC400T,
and GC320
drivers/mxc/gpu-

REL 1.0
Page 12 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
File Path
Description
viv/hal/kernel/arch/gc_hal_kernel_context.h
drivers/mxc/gpu-
viv/hal/kernel/arch/gc_hal_kernel_hardware.c
drivers/mxc/gpu-
viv/hal/kernel/arch/gc_hal_kernel_recorder.c
SPI
drivers/spi/spi_imx.c
SPI core interface source file
drivers/spi/spi-fsl-spi.c
MSIOF driver source file
Ethernet
drivers/net/ethernet/freescale/fec_main.c
Ethernet LAN controller driver source file
drivers/net/ethernet/freescale/fec.h
Ethernet LAN controller 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-unused.c
Unused gpios configurations source file
drivers/gpio/gpiolib.c
GPIO library source file
arch/arm/include/asm/gpio.h
GPIO header file
include/linux/gpio.h
I2C
drivers/i2c/busses/i2c-imx.c
I2C bus driver source file
Touch
drivers/input/touchscreen//edt-ft5x06.c
Touch driver Source file
Thermal
drivers/thermal/imx_thermal.c
Thermal zone driver source file
drivers/thermal/device_cooling.c
Regulator
drivers/regulator/core.c
Regulators Linux kernel interface source file
drivers/regulator/anatop-regulator.c
Anatop regulator client driver source file
PFUZE100
drivers/regulator/pfuze100-regulator.c
PFUZE100 regulator client driver source file
Power Management
drivers/cpufreq/imx6q-cpufreq.c
CPUFREQ functions source file
arch/arm/mach-imx/suspend-imx6.S
CPU suspend Assembly file
arch/arm/mach-imx/pm-imx6.c
Suspend operation support file
Board File
arch/arm/mach-imx/mach-iwg15.c
Board file for i.MX6 Qseven iWG15 SOMs

REL 1.0
Page 13 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.1.3 Device tree source description
This section explains about the device tree source code configuration and organization for iW-RainboW-G15M-Q7
platform. 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
imx6qdl_iwg15.dtsi
This device tree source include file defines the common SOC
controllers configuration of i.MX6 (Quad,Dual,Duallite & Solo)
processors used in iW-RainboW-G15 platforms.
imx6q_iwg15.dtsi
This device tree source include file defines the specific SOC
controllers configuration of i.MX6 Quad and Dual processors used in
iW-RainboW-G15 platforms.
imx6dl_iwg15.dtsi
This device tree source include file defines the specific SOC
controllers configuration of i.MX6 Duallite and Solo processors used
in iW-RainboW-G15 platforms.
imx6qdl-iwg15m-q7.dtsi
This device tree source include file defines the peripherals used in
iW-RainboW-G15M-Q7 SOM.
imx6dls-iwg15m-q7_pmic_ldoactive.dts
This device tree source file is for i.MX6 Duallite and solo PMIC SOMs
with CPU regulators in LDO active mode.
imx6qd-iwg15m-q7_pmic_ldoactive.dts
This device tree source file is for i.MX6 Quad and Dual PMIC SOMs
with CPU regulators in LDO active mode.
imx6dqp-iwg15m-q7_pmic_ldoactive.dts
This device tree source file is for i.MX6 Quad plus and Dual plus PMIC
SOMs with CPU regulators in LDO active mode.
imx6dls-iwg15m-q7_ldobypass.dts
This device tree source file is for i.MX6 Duallite and solo Non PMIC
SOMs with CPU regulators in LDO bypass mode.
imx6qd-iwg15m-q7_ldobypass.dts
This device tree source is for i.MX6 Quad and Dual Non PMIC SOMs
with CPU regulators in LDO bypass mode.
imx6dqp-iwg15m-q7_ldobypass.dts
This device tree source is for i.MX6 Quad plus and Dual plus Non
PMIC SOMs with CPU regulators in LDO bypass mode.
imx6dls-iwg15m-q7_pmic_ldobypass.dts
This device tree source file is for i.MX6 Duallite and solo PMIC SOMs
with CPU regulators in LDO bypass mode.
imx6qd-iwg15m-q7_pmic_ldobypass.dts
This device tree source file is for i.MX6 Quad and Dual PMIC SOMs
with CPU regulators in LDO bypass mode.
imx6dqp-iwg15m-q7_pmic_ldobypass.dts
This device tree source file is for i.MX6 Quad plus and Dual plus PMIC
SOMs with CPU regulators in LDO bypass mode.
imx6dls-iwg15m-q7_ldoactive.dts1
This device tree source file is for i.MX6 Duallite and solo Non PMIC
SOMs with CPU regulators in LDO active mode.
imx6qd-iwg15m-q7_ldoactive.dts1
This device tree source file is for i.MX6 Quad and Dual Non PMIC
SOMs with CPU regulators in LDO active mode.
imx6dqp-iwg15m-q7_ldoactive.dts1
This device tree source file is for i.MX6 Quad plus and Dual plus Non
PMIC SOMs with CPU regulators in LDO active mode.
1It is not recommended to use the CPU regulators in LDO active mode in Non PMIC SOMs. This may lead to
hardware bug.

REL 1.0
Page 14 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
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 iW-RainboW-G15M-Q7.
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 gawk wget git-core diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat libsdl1.2-dev
$sudo sudo apt-get install libsdl1.2-dev xterm sed cvs subversion coreutils texi2html \
docbook-utils python-pysqlite2 help2man make gcc g++ desktop-file-utils \
libgl1-mesa-dev libglu1-mesa-dev mercurial autoconf automake groff curl lzop asciidoc
$sudo apt-get install u-boot-tools

REL 1.0
Page 15 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.2.4 Setting up the repo utility
Repo is a tool built on top of Git that makes it easier to manage projects that contain multiple repositories, which do
not need to be on the same server.
Open a terminal window and create a bin folder (This step may not be needed if the bin folder already
exists).
$mkdir ~/bin
To install the “repo” utility, perform these steps:
$curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$chmod a+x ~/bin/repo
$export PATH=~/bin:$PATH
2.2.5 Yocto project setup
To setup the yocto, execute the below steps.
$mkdir iwg15-release-bsp;cd iwg15-release-bsp
$git config --global user.name "Your Name"
$git config --global user.email "Your Email"
$ repo init -u git://git.freescale.com/imx/fsl-arm-yocto-bsp.git -b imx-4.1-krogoth -m imx-4.1.15-
2.1.0.xml
$repo sync
Perform repo synchronization, with the command “repo sync”, periodically to update to the latest codes.
During the synchronization, the git configuration may confirm the user name, email and color display of the
user account as mentioned below. The git configuration may be confirmed once for a user.
Your Name [xxxxx]: xxxxx
Your Email [xxxxx@xxxxxx.(none)]: [e-mail]
Your identity is: xxxxx <[email protected]>
is this correct [y/N]? y
Testing colorized output (for 'repo diff', 'repo status'):
black red green yellow blue magenta cyan white
bold dim ul reverse
Enable color display in this user account (y/N)?y
The Yocto Project layers are downloaded and placed in the below directory.
$~/<path to iwg15-release-bsp>/iwg15-release-bsp/sources

REL 1.0
Page 16 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
To apply the Yocto patch file, execute the below commands.
$patch -Np1 < <path to Yocto patch file>/PATCH000-iW-PRDVZ-SC-01-RX.X-RELX.X-
YoctoKrogoth_basic_customization.patch
The Yocto patch file from deliverables is located in the below path.
iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-YoctoKrogoth_Deliverables/Source-
Code/Linux/Yocto/PATCH000-iW-PRDVZ-SC-01-RX.X-RELX.X-
YoctoKrogoth_basic_customization.patch
This sets up the recipes that are used to build the project.
To configure the yocto source for iW-RainboW-G15M-Q7 platform, execute the below command.
$MACHINE=imx6qdl-iwg15-q7 source fsl-setup-release.sh -b build_iwg15
The EULA is required to be accepted for the first time. After that, the acceptance is logged and EULA
acceptance is not required again.
2.2.6 Cross-compiler build
This section provides the detailed information and process for building the cross-compiler and this cross-compiler
can be used for standalone compilation of U-boot and Linux kernel.
Open a terminal window and change the directory to yocto setup path.
$cd ~/<path to iwg15-release-bsp>/iwg15-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx6qdl-iwg15-q7 source setup-environment build_iwg15
To compile the meta-toolchain, execute the below command.
$bitbake meta-toolchain
After compilation of meta-toolchain, execute the below command to install the cross-compiler.
$sudo sh tmp/deploy/sdk/fsl-imx-x11-glibc-x86_64-meta-toolchain-<version>.sh
During the cross-compiler installation, the target directory will be confirmed as mentioned below.
Enter target directory for SDK (default: /opt/fsl-imx-x11/4.1.15-2.1.0)
Note: Press [Enter] key for default path
You are about to install the SDK to “/opt/fsl-imx-x11/4.1.15-2.1.0”.Proceed[Y/n]?
Extracting SDK...done
Setting it up...done
SDK has been successfully set up and is ready to be used.
After successful installation of cross-compiler, the cross compiler will be available in below path.
/opt/ fsl-imx-x11/

REL 1.0
Page 17 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.2.7 Yocto build
This section provides the detailed information and process for building the yocto binaries.
Open a terminal window and change the directory to yocto setup path.
$cd ~/<path to iwg15-release-bsp>/iwg15-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx6qdl-iwg15-q7 source setup-environment build_iwg15
To compile the yocto file system, execute the below command.
$bitbake fsl-image-gui
To re-build the yocto image, execute the below commands.
$bitbake -f fsl-image-gui
After the successful compilation the binaries will be placed in below path.
~/<path to iwg15-release-bsp>/iwg15-release-bsp/build_iwg15/tmp/deploy/images/imx6qdl-iwg15-
q7/
The binary files are listed below
fsl-image-gui-imx6qdl-iwg15-<date & time>.rootfs.tar.bz2
zImage--<revision>-imx6*-iwg15m-q7_*-<date & time>.dtb
zImage--<revision>-imx6qdl-iwg15m-q7-<date & time>.bin
u-boot-imx6qdl-iwg15-<revision>.imx
Rename the binary files as mentioned below
fsl-image-gui-imx6qdl-iwg15-<date & time>.rootfs.tar.bz2 --> rootfs.tar.bz2
zImage--<revision>-imx6*-iwg15m-q7_*-<date & time>.dtb --> imx6*-iwg15m-q7*.dtb
zImage--<revision>-imx6qdl-iwg15m-q7-<date & time>.bin --> zImage
u-boot-imx6qdl-iwg15-<revision>.imx --> u-boot.imx
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.0
Page 18 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.2.8 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 iwg15-release-bsp>/iwg15-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx6qdl-iwg15-q7 source setup-environment build_iwg15
To compile the u-boot, execute the below command.
$bitbake u-boot-iwg15
To re-build u-boot, execute the below commands.
$bitbake -f -c compile u-boot-iwg15
After the successful compilation the binaries will be placed in below path.
~/<path to iwg15-release-bsp>/iwg15-release-bsp/build_iwg15/tmp/work/imx6qdl_iwg15_q7-poky-
linux-gnueabi/u-boot-iwg15/2016.03-r0/git/
The binary files are listed below
u-boot.imx
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.0
Page 19 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.2.9 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 iwg15-release-bsp>/iwg15-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx6qdl-iwg15-q7 source setup-environment build_iwg15
To compile the Linux kernel, execute the below command.
$bitbake linux-iwg15
To change the Linux kernel configuration, execute the below command.
$bitbake -c menuconfig linux-iwg15
To re-build Linux kernel from scratch, execute the below commands.
$bitbake -f -c compile linux-iwg15
After the successful compilation the zImage will be placed in below path.
~/<path to iwg15-release-bsp>/iwg15-release-bsp/build_iwg15/tmp/work/imx6qdl_iwg15_q7-poky-
linux-gnueabi/linux-iwg15/4.1.15-r0/build/arch/arm/boot/
The dtb files will be placed in below path.
~/<path to iwg15-release-bsp>/iwg15-release-bsp/build_iwg15/tmp/work/imx6qdl_iwg15_q7-poky-
linux-gnueabi/linux-iwg15/4.1.15-r0/build/arch/arm/boot/dts/
The binary files are listed below
zImage
dts/imx6*-iwg15m-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.
2.3 BSP Standalone compilation
Yocto can be used to extract and build the u-boot source/ linux kernel source. The following steps will help to build
the u-boot source code / linux kernel directly for iW-RainboW-G15M-Q7 platform.
Before compiling the source code cross compiler should be installed to “/opt”directory of host machine if it
is not present.
Refer the Cross-compiler build section to install the cross-compiler.

REL 1.0
Page 20 of 69
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G15D Linux User Manual
2.3.1 U-Boot
Create a directory and open the directory in host to build the uboot
host@host~$mkdir <directory_name>
host@host~$cd <directory_name>
The u-boot source code tar file from deliverables is located in the below path.
iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-YoctoKrogoth_Deliverables/Source-Code/U-Boot/u-
boot-iwg15.tar.gz
Un-tar the downloaded u-boot-iwg15.tar.gz file in to newly created directory.
host@host/<directory>~$tar -xvf /<path to iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables >/iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/Source-Code/U-Boot/u-boot-iwg15.tar.gz
Copy the u-boot patch file to current directory.
host@host/<directory>~$cp /<path to iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables>/iW-RainboW-G15M-Q7-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/Source-Code/U-Boot/PATCH001-iW-PRDVZ-SC-01-RX.X-RELX.X-
Linux4.1.15_UBoot_basic_customization.patch .
Change the directory to u-boot source code directory.
host@host/<directory>~$cd /<path to u-boot source>/u-boot-iwg15
To apply the patch file, execute the below command.
host@host/<directory>/u-boot-iwg15~$patch -Np1 < ../PATCH001-iW-PRDVZ-SC-01-RX.X-RELX.X-
Linux4.1.15_UBoot_basic_customization.patch
To export the Cross Compiler and tool chain path, execute the below command.
host@host/<Directory>/u-boot-iwg15~$export ARCH=arm
host@host/<Directory>/uboot-iwg15~$export PATH=$PATH:/opt/fsl-imx-x11/4.1.15-
2.1.0/sysroots/<processor>-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi
host@host/<Directory>/u-boot-iwg15~$export CROSS_COMPILE=arm-poky-linux-gnueabi-
To configure for iWave-G15M-Q7 platform, execute the below command.
host@host/<directory>/u-boot-iwg15~$make mx6_iwg15m_q7_defconfig
To compile the u-boot source code, execute the below command.
host@host/<directory>/u-boot-iwg15~$make CC="arm-poky-linux-gnueabi-gcc --sysroot=/opt/fsl-
imx-x11/4.1.15-2.1.0/sysroots/cortexa9hf-neon-poky-linux-gnueabi/"
After successful compilation, boot loader image (u-boot.imx) will be created in below path.
~/u-boot-iwg15/u-boot.imx
Refer the BINARY PROGRAMMING section to update the u-boot binary.