iWave iW-RainboW-G18D User manual

REL 1.0
Page 1 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
iW-RainboW-G18D
i.MX6UL/ULL SODIMM Development platform
Linux User Guide

REL 1.0
Page 2 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
Document Revision History
Document Number
iW-PREVZ-UM-01-R2.0-REL1.0-Linux4.1.15
Revision
Date
Description
1.0
30th May 2017
Initial Version
1.1
24th Jun 2017
Ethernet Permanent MAC address 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.0
Page 3 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D 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.0
Page 4 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
Table of Contents
1. INTRODUCTION....................................................................................................................................... 7
1.1 PURPOSE............................................................................................................................................................ 7
1.2 SCOPE................................................................................................................................................................ 7
1.3 LIST OF ACRONYMS .......................................................................................................................................... 7
2. BOARD SUPPORT PACKAGE.................................................................................................................. 9
2.1 BSP DRIVER DETAILS........................................................................................................................................ 9
2.1.1 BSP Supported Features............................................................................................................................... 9
2.1.2 Driver Source description............................................................................................................................. 9
2.1.3 Device tree source description.................................................................................................................... 11
2.2 BSP YOCTO COMPILATION......................................................................................................................... 12
2.2.1 Host Requirements...................................................................................................................................... 12
2.2.2 Host setup.................................................................................................................................................... 12
2.2.3 Host package installation............................................................................................................................ 12
2.2.4 Setting up the repo utility............................................................................................................................13
2.2.5 Yocto project setup...................................................................................................................................... 13
2.2.6 Cross-compiler build................................................................................................................................... 14
2.2.7 Yocto build ..................................................................................................................................................15
2.2.8 U-boot.........................................................................................................................................................16
2.2.9 Linux kernel.................................................................................................................................................17
2.3 BSP STANDALONE COMPILATION................................................................................................................... 17
2.3.1 U-Boot......................................................................................................................................................... 18
2.3.2 Linux kernel.................................................................................................................................................19
2.4 BSP CUSTOMIZATION .....................................................................................................................................21
2.4.1 Ethernet selection in u-boot........................................................................................................................21
2.4.2 Default Linux boot logo ..............................................................................................................................21
2.4.3 I2C device on the Linux Image.................................................................................................................... 21
2.4.4 Display device on the Linux Image.............................................................................................................22
3. BINARY PROGRAMMING..................................................................................................................... 23
3.1 MFG–TOOL PROGRAMMING.......................................................................................................................... 23
3.1.1 Requirements............................................................................................................................................... 23
3.1.2 MFG-Tool ...................................................................................................................................................24
3.1.3 Binary Programming .................................................................................................................................. 25
3.1.4 Limitations ..................................................................................................................................................26
3.2 MANUAL SD CARD PROGRAMMING ............................................................................................................... 27
3.2.1 Requirements............................................................................................................................................... 27
3.2.2 SD Card Partition....................................................................................................................................... 27
3.2.3 Binary Programming .................................................................................................................................. 30
4. U-BOOT TESTING AND BOOT CONFIGURATION............................................................................. 31
4.1 BASIC COMMANDS ..........................................................................................................................................32

REL 1.0
Page 5 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
4.2 BASIC DEVICE TESTS....................................................................................................................................... 33
4.2.1 RAM Test..................................................................................................................................................... 33
4.2.2 SD Test........................................................................................................................................................34
4.2.3 NAND Flash Test........................................................................................................................................ 35
4.2.4 I2C Test....................................................................................................................................................... 35
4.2.5 Ethernet Test............................................................................................................................................... 36
4.2.6 USB Test...................................................................................................................................................... 39
4.2.7 Bmode Test.................................................................................................................................................. 39
4.3 ENVIRONMENT VARIABLES SETTINGS............................................................................................................. 40
4.3.1 Micro SD boot............................................................................................................................................. 40
4.3.2 NAND boot.................................................................................................................................................. 40
4.3.3 TFTP & NFS boot.......................................................................................................................................41
4.3.4 Optional features settings ........................................................................................................................... 41
5. LINUX PERIPHERAL TESTING............................................................................................................ 42
5.1 BLOCK DEVICES TEST ..................................................................................................................................... 42
5.1.1 SD/ USB host/ NAND.................................................................................................................................. 43
5.1.2 USB OTG as device..................................................................................................................................... 43
5.2 NETWORK DEVICES TEST................................................................................................................................ 45
5.2.1 Ethernet Test............................................................................................................................................... 46
5.2.2 CAN Test..................................................................................................................................................... 48
5.3 DISPLAY DEVICES TEST................................................................................................................................... 49
5.3.1 LCD Test.....................................................................................................................................................49
5.3.2 PWM brightness Test ..................................................................................................................................50
5.4 HID DEVICES TEST.......................................................................................................................................... 51
5.4.1 USB HID Devices........................................................................................................................................51
5.4.2 Touch screen Test........................................................................................................................................ 52
5.5 UART TEST.....................................................................................................................................................53
5.6 RTC TEST........................................................................................................................................................54
5.7 WDOG TEST...................................................................................................................................................55
5.8 MULTIMEDIA TEST .......................................................................................................................................... 55
5.8.1 Camera Test................................................................................................................................................55
5.8.2 Audio Test ...................................................................................................................................................56
6. APPENDIX ............................................................................................................................................... 57
6.1 FREQUENTLY ASKED QUESTION.....................................................................................................................57

REL 1.0
Page 6 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
List of Figures
FIGURE 1: BOOT DEVICE MEMORY LAYOUT ....................................................................................................................................... 23
FIGURE 2: BOOT SWITCH POSITIONS (BEFORE PROGRAMMING)......................................................................................................... 24
FIGURE 3: PLATFORM DETECTION..................................................................................................................................................... 25
FIGURE 4: BINARY PROGRAMMING SUCCEED.................................................................................................................................... 26
FIGURE 5: OTG DEVICE DETECTION ON HOST PC.............................................................................................................................. 44
FIGURE 6: LCD IMAGE DUMP............................................................................................................................................................ 49
FIGURE 7: TOUCH SCREEN CALIBRATION WINDOW ............................................................................................................................ 52
List of Tables
TABLE 1: ACRONYMS &ABBREVIATIONS ........................................................................................................................................... 7
TABLE 2: DRIVER SOURCE PATH ......................................................................................................................................................... 9
TABLE 3: DEVICE TREE SOURCE......................................................................................................................................................... 11

REL 1.0
Page 7 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
1. INTRODUCTION
1.1 Purpose
The purpose of this document is to help the software engineer to program and test the iW-RainboW-G18D-SM
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-G18D-SM 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-G18D-SM 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
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
SD
Secure Digital
SOM
System On Module
SPI
Serial Peripheral Interface

REL 1.0
Page 8 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
Acronyms
Abbreviations
UART
Universal Asynchronous Receiver/Transmitter
USB
Universal Serial Bus
USB OTG
USB On The Go

REL 1.0
Page 9 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D 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 i.MX6UL/i.MX6ULL 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
i.MX6UL/i.MX6ULL SOM.
Table 2: Driver Source Path
File Path
Description
NAND
drivers/mtd/nand/gpmi-nand/gpmi-nand.h
NAND driver header file
drivers/mtd/nand/gpmi-nand/gpmi-nand.c
NAND driver source file
SD
drivers/mmc/host/sdhci-esdhc-imx.c
SDHC driver source file
drivers/mmc/host/sdhci-pltfm.h
SDHC platform header file
drivers/mmc/host/sdhci-esdhc.h
SDHC driver header file
include/linux/mmc/host.h
MMC Subsystem host header file
include/linux/mmc/mmc.h
SD/SDIO driver header file
include/linux/mmc/sdio.h
SDHI driver, SD/SDIO driver header file
RTC
drivers/rtc/rtc-snvs.c
RTC Driver Source File
CAN
drivers/net/can/flexcan.c
CAN Driver Source file
include/linux/can/platform/flexcan.h
CAN Driver header file
UART
drivers/tty/serial/imx.c
Serial source file
USB (USB OTG as Device)
drivers/usb/gadget/configfs.c
USB gadget configuration driver source file
drivers/usb/gadget/legacy/mass_storage.c
USB gadget storage driver
drivers/usb/gadget/function/f_mass_storage.c
drivers/usb/gadget/function/storage_comman.h
USB gadget storage header file
drivers/usb/gadget/function/f_mass_storage.h
include/linux/usbgadget.h
USB gadget driver header file
USB2.0 Host
drivers/usb/chipidea/core.c
Chipidea IP core driver source file

REL 1.0
Page 10 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
File Path
Description
drivers/usb/chipidea/udc.c
Chipidea peripheral driver
drivers/usb/chipidea/host.c
Chipidea host driver
drivers/usb/chipidea/ci_hdrc_imx.c
i.MX glue layer
drivers/usb/chipidea/usbmisc_imx.c
i.MX SoC abstract layer
drivers/usb/chipidea/ci.h
Chipidea driver header files
drivers/usb/chipidea/udc.h
drivers/usb/chipidea/host.h
Include/linux/usb/chipidea.h
drivers/usb/phy/phy.c
USB phy driver source file
drivers/phy/phy-core.c
Generic Phy framework
include/linux/usb.h
USB driver header file
Audio
sound/soc/fsl/imx-sgtl5000.c
SGTL5000 CODEC driver source file
sound/soc/codecs/sgtl5000.c
SGTL5000 CODEC controller source file
sound/soc/codecs/sgtl5000.h
SGTL5000 CODEC driver header file
Display
drivers/video/fbdev/mxsfb.c
LCD driver source file
drivers/video/fbdev/mxc/mxc_dispdrv.h
MXC display driver header file
drivers/video/fbdev/mxc/crtc.h
CRTC header file
Include/linux/mxcfb.h
MXC frame buffer header file
Ethernet
drivers/net/ethernet/freescale/fec_main.c
FEC Ethernet driver source file
drivers/net/ethernet/freescale/fec.h
FEC Ethernet driver header file
Include/linux/fec.h
drivers/net/phy/micrel.c
Phy driver source code
include/linux/phy.h
Phy driver header file
GPIO
drivers/gpio/gpio-mxc.c
Source file
drivers/gpio/gpiolib.c
GPIO library source file
arch/arm/include/asm/gpio.h
Header file
include/linux/gpio.h
Camera
drivers/media/platform/mxc/subdev/ov7725.c
OV7725 Camera driver file
drivers/media/platform/mxc/subdev/ov5640.c
OV5640 Camera driver file
Touch
drivers/input/touchscreen/stmpe-ts.c
Touch Driver Source file
include/linux/mfd/stmpe.h
Touch Driver header file
PWM
drivers/pwm/pwm-imx.c
PWM driver source file
drivers/video/backlight/pwm_bl.c
PWM controller source file
Include/linux/pwm.h
PWM driver header file
Include/linux/pwm_backlight.h

REL 1.0
Page 11 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
File Path
Description
Include/linux/backlight.h
2.1.3 Device tree source description
This section explains about the device tree source code configuration and organization for i.MX6UL/i.MX6ULL 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
imx6-iwg18m-sm.dtsi
This device tree source include file defines the common CPU
controllers configuration of i.MX6UL/i.MX6ULL processors used in iW-
RainboW-G18 platform.
imx6ul-iwg18m-sm.dts
This device tree source file is for i.MX6UL processors used in iW-
RainboW-G18 platforms.
imx6ull-iwg18m-sm.dts
This device tree source file is for i.MX6ULL processors used in iW-
RainboW-G18 platforms.

REL 1.0
Page 12 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
2.2 BSP Yocto COMPILATION
2.2.1 Host Requirements
A Linux host PC with latest version (ex. Ubuntu version 12.04).
Root permission on the Development Host.
Cross compiler package for iW-RainboW-G18D-SM.
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 Ubuntu version is 14.04.
Minimum hard disk space required is about 50 GB and 4GB of RAM.
Note: Earlier versions may cause the Yocto Project build setup to fail, because it requires python versions which
are available only starting with Ubuntu 12.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 wget git-core unzip texinfo gcc-multilib socat
sudo apt-get install libsdl1.2-dev gawk diffstat build-essential chrpath
sudo apt-get install sed cvs subversion coreutils texi2html
sudo apt-get install docbook-utils python-pysqlite2 help2man make gcc g++
sudo apt-get install desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev
sudo apt-get install mercurial autoconf automake groff
sudo apt-get install mercurial curl lzop asciidoc xterm u-boot-tools

REL 1.0
Page 13 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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 iwg18-release-bsp;cd iwg18-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.0.3.xml
$ repo sync
Perform repo synchronization, with the command “repo sync”, periodically to update to the latest
codes.
The Yocto Project layers are downloaded and placed in the below directory.
$ ~/<path to iwg18-release-bsp>/iwg18-release-bsp/sources
To apply the Yocto patch file, execute the below commands.
$patch -Np1 < <path to Yocto patch file>/PATCH000-iW-PREVZ-SC-01-RX.X-RELX.X-
YoctoKrogoth_basic_customization.patch
The Yocto patch file from deliverables is located in the below path.
iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/Linux/Yocto/PATCH000-iW-PREVZ-SC-01-RX.X-RELX.X-
YoctoKrogoth_basic_customization.patch
To configure the yocto source for iW-RainboW-G18M-SM platform, execute the below command.
$DISTRO=fsl-imx-x11 MACHINE=imx6-iwg18 source fsl-setup-release.sh -b build_iwg18
The EULA is required to be accepted for the first time. After that, the acceptance is logged and EULA
acceptance is not required again.

REL 1.0
Page 14 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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 iwg18-release-bsp>/iwg18-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching
of every new terminal window.
$ DISTRO=fsl-imx-x11 MACHINE=imx6-iwg18 source setup-environment build_iwg18
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-cortexa7hf-neon-toolchain-
4.1.15-2.0.3.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.0.3: (Just a return)
You are about to install the SDK to "/opt/poky/<version>". Proceed[Y/n]? (Enter Y)
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/4.1.15-2.0.3

REL 1.0
Page 15 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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 iwg18-release-bsp>/iwg18-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching
of every new terminal window.
$ DISTRO=fsl-imx-x11 MACHINE=imx6-iwg18 source setup-environment build_iwg18
To compile the yocto file system, execute the below command.
$ bitbake core-image-minimal
To re-build the yocto image, execute the below commands.
$ bitbake -f core-image-minimal
After the successful compilation the binaries will be placed in below path.
~/<path to iwg18-release-bsp>/iwg18-release-bsp/build_iwg18/tmp/deploy/images/imx6-
iwg18/
The binary files are listed below
core-image-minimal-imx6-iwg18-<date & time>.rootfs.tar.bz2
zImage--<revision>-imx6ul-iwg18m-sm-<date & time>.dtb
zImage--<revision>-imx6ull-iwg18m-sm-<date & time>.dtb
zImage--<revision>-imx6-iwg18m-sm-<date & time>.bin
u-boot-nand-<revision>.imx
Rename the binary files as mentioned below
core-image-minimal-imx6-iwg18-<date & time>.rootfs.tar.bz2 --> rootfs.tar.bz2
zImage--<revision>-imx6ul-iwg18m-sm<date & time>.dtb --> imx6ul-iwg18m-sm.dtb
zImage--<revision>-imx6ull-iwg18m-sm<date & time>.dtb --> imx6ull-iwg18m-sm.dtb
zImage--<revision>-imx6-iwg18m-sm<date & time>.bin --> zImage
u-boot-nand-<revision>.imx --> u-boot.imx
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.0
Page 16 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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 iwg18-release-bsp>/iwg18-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching
of every new terminal window.
$ DISTRO=fsl-imx-x11 MACHINE=imx6-iwg18 source setup-environment build_iwg18
To compile the u-boot, execute the below command.
$ bitbake u-boot-iwg18
To re-build u-boot, execute the below commands.
$ bitbake -f -c compile u-boot-iwg18
After the successful compilation the binaries will be placed in below path.
~/<path to iwg18-release-bsp>/iwg18-release-bsp/build_iwg18/tmp/work/imx6_iwg18-poky-
linux-gnueabi/u-boot-iwg18/2016.03-r0/image/boot/
The binary files are listed below
u-boot.imx
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.0
Page 17 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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 iwg18-release-bsp>/iwg18-release-bsp/
To setup environment build path, execute the below command. This is required only once on switching
of every new terminal window.
$ DISTRO=fsl-imx-x11 MACHINE=imx6-iwg18 source setup-environment build_iwg18
To compile the Linux kernel, execute the below command.
$ bitbake linux-iwg18
To change the Linux kernel configuration, execute the below command.
$ bitbake -c menuconfig linux-iwg18
To re-build Linux kernel from scratch, execute the below commands.
$ bitbake -f -c compile linux-iwg18
After the successful compilation the binaries will be placed in below path.
~/<path to iwg18-release-bsp>/iwg18-release-bsp/build_iwg18/tmp/work/imx6_iwg18-poky-
linux-gnueabi/linux-iwg18/4.1.15-r0/build/arch/arm/boot/
The binary files are listed below
zImage
dts/imx6ul-iwg18m-sm.dtb
dts/imx6ull-iwg18m-sm.dtb
Refer the BINARY PROGRAMMING section to update the Linux kernel binary.
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-G18M-SM 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 18 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
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-G18M-SM-RX.X-RELX.X-Linux4.1.15-YoctoKrogoth_Deliverables/SourceCode/U-
Boot/u-boot-iwg18.tar.gz
Un-tar the downloaded u-boot-iwg18.tar.gz file in to newly created directory.
host@host/<directory>~$tar -xvzf /<path to iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables>/iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/U-Boot/u-boot-iwg18.tar.gz
Copy the u-boot patch file to current directory.
host@host/<directory>~$cp /<path to iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables>/iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/U-Boot/PATCH001-iW-PREVZ-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-iwg18
To apply the patch file, execute the below command.
host@host/<directory>/u-boot-iwg18~$patch -Np1 < ../PATCH001-iW-PREVZ-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-iwg18~$export ARCH=arm
host@host/<Directory>/uboot-iwg18~$export PATH=$PATH:/opt/fsl-imx-x11/4.1.15-
2.0.3/sysroots/<processor>-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi
host@host/<Directory>/u-boot-iwg18~$export CROSS_COMPILE=arm-poky-linux-gnueabi-
To configure for iWave-G18M-SM platform, execute the below command.
host@host/<directory>/u-boot-iwg18~$make mx6_iwg18m_sm_defconfig
To compile the u-boot source code, execute the below command.
host@host/<directory>/u-boot-iwg18~$make CC="arm-poky-linux-gnueabi-gcc --sysroot=/opt/
fsl-imx-x11/4.1.15-2.0.3/sysroots/cortexa7hf-neon-poky-linux-gnueabi/"
After successful compilation, boot loader image (u-boot.imx) will be created in below path.
~/u-boot-iwg18/u-boot.imx
Refer the BINARY PROGRAMMING section to update the u-boot binary.

REL 1.0
Page 19 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
2.3.2 Linux kernel
Create a directory and open the directory in host to build the Linux.
host@host~$mkdir <directory_name>
host@host~$cd <directory_name>
The Linux kernel source code tar file from deliverables is located in the below path.
iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/Linux/Kernel/linux-iwg18.tar.gz
Un-tar the downloaded linux-4.1.15.tar.gz file in to newly created directory.
host@host/<Directory>~$tar -xvzf /<path_to_iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables>/iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/Linux/Kernel/linux-iwg18.tar.gz
Copy the kernel patch file to current directory and Change the directory to Linux source code directory.
host@host/<Directory>~$cp /<path_to_iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables>/iW-RainboW-G18M-SM-RX.X-RELX.X-Linux4.1.15-
YoctoKrogoth_Deliverables/SourceCode/Linux/Kernel/PATCH002-iW-PREVZ-SC-01-RX.X-RELX.X-
Linux4.1.15_Kernel_basic_customization.patch .
host@host/<Directory>~$cd <path_to_linux-iwg18>/linux-iwg18
To apply the patch file, execute the below command.
host@host/<Directory>/linux-iwg18~$patch -Np1 < ../PATCH002-iW-PREVZ-SC-01-RX.X-RELX.X-
Linux4.1.15_Kernel_basic_customization.patch
Export the architecture, cross compiler and tool chain path.
host@host/<Directory>/linux-iwg18~$export ARCH=arm
host@host/<Directory>/linux-iwg18~$export PATH=$PATH:/opt/fsl-imx-x11/4.1.15-
2.0.3/sysroots/<processor>-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi
host@host/<Directory>/linux-iwg18~$export CROSS_COMPILE=arm-poky-linux-gnueabi-
To configure the kernel for iW-RainboW-G18M-SM, execute the below command.
host@host/<Directory>/linux-iwg18~$make iw_rainbowg18_defconfig
To compile the kernel module drivers and kernel image, execute the below command.
host@host/<Directory>/linux-iwg18~$make
After successful compilation, kernel image (zImage) and device tree (.dtb) will be created in the below
paths respectively.
~/linux-iwg18/arch/arm/boot/zImage
~/linux-iwg18/arch/arm/boot/dts/imx6ul-iwg18m-sm.dtb
~/linux-iwg18/arch/arm/boot/dts/imx6ull-iwg18m-sm.dtb
To install the kernel module drivers which are created during compilation execute the below command.

REL 1.0
Page 20 of 58
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G18D Linux User Guide
host@host/<Directory>/linux-iwg18~$mkdir ../<target_directory>
host@host/<Directory>/linux-iwg18~$make modules_install
INSTALL_MOD_PATH=../<target_directory>
After installation modules will be located in the below specified path
<path_to_target_directory>/lib/modules/4.1.15/kernel/
To copy the kernel driver modules into the file system execute the below commands.
cp –rf <path_to_target_directory>/lib/modules/4.1.15/kernel/ /lib/modules/4.1.15-
2.0.3+gb63f3f5/
Refer the BINARY PROGRAMMING section to update the Linux kernel binary