iWave iW-RainboW-G27M User manual

REL 1.0
Page 1 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
iW-RainboW-G27M
i.MX8 Quad Max Development platform
Linux User Guide

REL 1.0
Page 2 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
Document Revision History
Document Number
iW-RainboW-G27M-i.MX8QuadMaxSOM-Linux4.9.51-SoftwareUserGuide-REL1.0
Revision
Date
Description
1.0
31st Jul 2018
Initial Release
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 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
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 ....................................................................................................................12
2.2 BSP Yocto Compilation....................................................................................................................................13
2.2.1 Host Requirements......................................................................................................................................13
2.2.2 Host setup ...................................................................................................................................................13
2.2.3 Host package installation............................................................................................................................13
2.2.4 Setting up the repo utility............................................................................................................................14
2.2.5 Yocto project setup......................................................................................................................................14
2.2.6 Cross-compiler build....................................................................................................................................15
2.2.7 Yocto build...................................................................................................................................................16
2.2.8 U-boot .........................................................................................................................................................17
2.2.9 Linux kernel .................................................................................................................................................18
2.3 BSP Standalone compilation ...........................................................................................................................19
2.3.1 System Controller Firmware(SCFW) ............................................................................................................19
2.3.2 U-Boot .........................................................................................................................................................21
2.3.3 imx-boot ......................................................................................................................................................22
2.3.4 Linux kernel .................................................................................................................................................23
3. BINARY PROGRAMMING ............................................................................................................................ 24
3.1 MFG –Tool Programming................................................................................................................................24
3.1.1 Requirements ..............................................................................................................................................24
3.1.2 MFG-Tool.....................................................................................................................................................25
3.1.3 Programming Device Selection ...................................................................................................................25
3.1.4 Binary Programming ...................................................................................................................................25
3.1.5 Limitations...................................................................................................................................................27
3.2 Manual SD Card Programming........................................................................................................................28
3.2.1 Requirements ..............................................................................................................................................28
3.2.2 SD Card Partition.........................................................................................................................................28
3.2.3 Binary Programming ...................................................................................................................................31
4. U-BOOT TESTING AND BOOT CONFIGURATION............................................................................................ 32
4.1 Basic commands..............................................................................................................................................32
4.2 Basic device Tests............................................................................................................................................33
4.2.1 RAM Test.....................................................................................................................................................33

REL 1.0
Page 5 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
4.2.2 SD/MMC Test ..............................................................................................................................................34
4.2.3 SATA Test.....................................................................................................................................................34
4.2.4 Ethernet Test...............................................................................................................................................35
4.2.5 USB Test ......................................................................................................................................................38
4.3 Environment variables settings.......................................................................................................................39
4.3.1 EMMC boot .................................................................................................................................................39
4.3.2 Standard SD boot ........................................................................................................................................39
4.3.3 SATA boot....................................................................................................................................................40
4.3.4 TFTP & NFS boot..........................................................................................................................................40
4.3.5 Optional features settings...........................................................................................................................40
5. LINUX PERIPHERAL TESTING........................................................................................................................ 41
5.1 Block devices Test ...........................................................................................................................................41
5.1.1 SD/eMMC/USB host/ USB OTG (as host)/ SATA test ..................................................................................42
5.1.2 USB OTG as device ......................................................................................................................................42
5.2 Network devices Test......................................................................................................................................44
5.2.1 Ethernet Test...............................................................................................................................................45
5.2.2 CAN Test......................................................................................................................................................47
5.2.3 Wi-Fi Test.....................................................................................................................................................48
5.2.4 Bluetooth Test .............................................................................................................................................49
5.3 Display devices Test ........................................................................................................................................51
5.3.1 Brightness Test............................................................................................................................................51
5.4 HID devices Test..............................................................................................................................................51
5.4.1 USB HID Devices ..........................................................................................................................................52
5.4.2 Touch screen Test........................................................................................................................................52
5.5 RTC Test...........................................................................................................................................................54
5.6 UART Test........................................................................................................................................................55
5.7 PCIe Device test...............................................................................................................................................56
5.8 WDOG Test......................................................................................................................................................56
5.9 Multimedia test...............................................................................................................................................56
5.9.1 Audio Test....................................................................................................................................................57
5.9.2 Gstreamer Test............................................................................................................................................58
5.9.3 GPU Test......................................................................................................................................................58
6. APPENDIX................................................................................................................................................... 59
6.1 Frequently Asked Question.............................................................................................................................59

REL 1.0
Page 6 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
List of Figures
Figure 1: Boot device memory layout.............................................................................................................................24
Figure 2: Platform Detection...........................................................................................................................................26
Figure 3: Binary Programming Succeed..........................................................................................................................26
Figure 4: OTG device detection on Host PC....................................................................................................................43
Figure 5: Yocto Touch calibration Icon............................................................................................................................52
Figure 6: Yocto Touch calibration ...................................................................................................................................53
Figure 7: Yocto home screen ..........................................................................................................................................53
List of Tables
Table 1: Acronyms & Abbreviations..................................................................................................................................7
Table 2: Driver Source Path...............................................................................................................................................9
Table 3: Device tree source.............................................................................................................................................12
Table 4: List of VBS files ..................................................................................................................................................25

REL 1.0
Page 7 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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-G27M-QM
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-G27M-QM 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-G27M-QM 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
LPDDR4
Low Power Double Data Rate 4
eMMC
Enhanced Multi Media Card
HDMI
High-Definition Multimedia Interface
I2C
Inter-Integrated Circuit
Kbps
Kilobits per second
LVDS
Low Voltage Differential Signal
MAC
Media Access Controller
MB
Mega Byte
Mbps
Megabits per sec
MHz
Mega Hertz
MIPI
Mobile Industry Processor 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
SOM
System On Module
SPI
Serial Peripheral Interface

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

REL 1.0
Page 9 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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-G27M-QM 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-
G27M-QM BSP.
Table 2: Driver Source Path
File Path
Description
eMMC
drivers/mmc/host/ sdhci-esdhc.h
MMC driver header file
drivers/mmc/host/ sdhci-esdhc-imx.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-imx-sc.c
RTC driver source file
CAN
drivers/net/can/flexcan_iwg27m.c
CAN driver source file
UART
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
drivers/usb/host/ehci-sched.c

REL 1.0
Page 10 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
File Path
Description
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
USB3.0 Host
drivers/usb/host/xhci-hcd.c
XHCI host driver source file
drivers/usb/host/xhci-hub.c
drivers/usb/host/xhci-pci.c
drivers/usb/host/xhci-ring.c
drivers/usb/host/xhci.c
XHCI driver source file
drivers/usb/host/xhci.h
XHCI header file
drivers/usb/host/xhci-platform.c
XHCI Platform driver source file
Type-C Host
drivers/usb/fusb302/core/fusb30X.c
FUSB30x host driver source file
drivers/usb/fusb302/core/typeC.c
drivers/usb/fusb302/core/port.c
drivers/usb/fusb302/Platform_Linux/fusb30x_driver.
c
FUSB30x source driver file
drivers/usb/fusb302/Platform_Linux/fusb30x_driver.
h
FUSB30x header file
drivers/usb/fusb302/Platform_Linux/platform.c
FUSB30x Platform driver source file
drivers/usb/fusb302/Platform_Linux/platform_helpe
rs.c
USB OTG
drivers/usb/chipidea/ci_hdrc_imx.c
USB OTG host driver file
drivers/usb/chipidea/ci_hdrc_msm.c
drivers/usb/chipidea/ci_hdrc_pci.c
drivers/usb/chipidea/ci_hdrc_usb2.c
drivers/usb/chipidea/ci_hdrc_imx.h
USB OTG header file
Audio
sound/soc/fsl/imx-sgtl5000.c
Machine layer for stereo CODEC ALSA SoC
sound/soc/codecs/sgtl5000.c
CODEC driver source file
sound/soc/codecs/sgtl5000.h
CODEC driver header file
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_sai.c
SAI CPU DAI driver source file
sound/soc/fsl/fsl_sai.h
SAI CPU DAI driver and SAI register definitions header file
Display
drivers/gpu/drm/panel/panel-raydium-rm68200.c
Raydium display panel driver file
Include/video/mipi_display.h
Header file
GPU

REL 1.0
Page 11 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
File Path
Description
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-
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
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/at803x.c
Phy driver source file
GPIO
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/gt1151/gt1x.c
Touch driver source file
drivers/input/touchscreen/gt1151/gt1x_generic.c
Touch driver generic Source file
drivers/input/touchscreen/gt1151/gt1x_generic.h
Header file
Wi-Fi and Bluetooth
drivers/staging/wilc1000/wilc_spi.c
Wi-Fi driver source file
drivers/staging/wilc1000/linux_wlan.c
Wi-Fi operation file
drivers/staging/wilc1000/wilc_bt.c
Bluetooth driver source file
Thermal
drivers/thermal/imx_sc_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
Soc File
drivers/soc/imx/soc-imx8.c
Soc information for imx8 board.

REL 1.0
Page 12 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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-G27M-QM
platform. The device tree source codes will be available in below path of the Linux kernel.
~/arch/arm64/boot/dts/freescale/
Table 3: Device tree source
File Name
Description
Imx8qm.dtsi
This device tree source include file defines the common SOC
controllers configuration of i.MX8QM processors used in iW-
RainboW-G27-QM platforms.
fsl-imx8qm-iwg27m.dts
This device tree source include file defines the specific SOC
controllers configuration of i.MX8QM processors used in iW-
RainboW-G27-QM platforms.

REL 1.0
Page 13 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
2.2 BSP Yocto Compilation
This section explains procedure and detailed information about compiling the Yocto for i.MX8 QM 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-G27M-QM.
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 100 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 100 GB for the X11
backend. It is recommended that at least 200 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 util-linux srecord
$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 14 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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 https://storage.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 iwg27-release-bsp; cd iwg27-release-bsp
$git config --global user.name "Your Name"
$git config --global user.email "Your Email"
$repo init -u https://source.codeaurora.org/external/imx/imx-manifest -b imx-linux-morty -m imx-
4.9.51-8qm_beta2.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 colour 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)]: [email protected]
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 iwg27-release-bsp>/iwg27-release-bsp/sources

REL 1.0
Page 15 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
•Un-tar the Source-Code.tar.gz file from deliverables.
host@host~$ tar -xvf /<path_to_iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables>/iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables/Source-Code/Source-Code.tar.gz
•The Yocto patch file from deliverables is located in the below path.
<path_to_Source-Code>/Source-Code/Linux/Yocto/PATCH003-iW-PRFHZ-SC-01-RX.X-RELX.X-
Linux4.9.51_Yocto_Basic_Customization.patch
•To apply the Yocto patch file, execute the below commands.
$patch -Np1 < <path_to_Yocto patch file>/PATCH003-iW-PRFHZ-SC-01-RX.X-RELX.X-
Linux4.9.51_Yocto_Basic_Customization.patch
•This sets up the recipes that are used to build the project.
•To configure the yocto source for iW-RainboW-G27M-QM platform, execute the below command.
$DISTRO=fsl-imx-x11 MACHINE=imx8qm_iwg27m source fsl-setup-release.sh -b build_imx8qm
•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 iwg27-release-bsp>/iwg27-release-bsp/
•To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx8qm_iwg27m source setup-environment build_imx8qm
•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.9.51-mx8-beta)
Note: Press [Enter] key for default path
You are about to install the SDK to “/opt/fsl-imx-x11/4.9.51-mx8-beta”.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 16 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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 iwg27-release-bsp>/iwg27-release-bsp/
•To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx8qm_iwg27m source setup-environment build_imx8qm
•To compile the yocto file system, execute the below command.
$bitbake fsl-image-validation-imx
•To re-build the yocto image, execute the below commands.
$bitbake -f fsl-image-validation-imx
•After the successful compilation the binaries will be placed in below path.
~/<path_to_iwg27-release-bsp>/iwg27-release-
bsp/build_imx8qm/tmp/deploy/images/imx8qm_iwg27m/
•The binary files are listed below
fsl-image-validation-imx-imx8qm_iwg27m-<date&time>.rootfs.tar.bz2
Image--4.9.51-r0-fsl-imx8qm-iwg27m-lpddr4-arm2-<date&time>.dtb
Image--4.9.51-r0-imx8qm_iwg27m-<date&time>.bin
imx-boot-imx8qm_iwg27m-sd.bin-flash
•Rename the binary files as mentioned below
fsl-image-validation-imx-imx8qm_iwg27m-<date&time>.rootfs.tar.bz2 --> rootfs.tar.bz2
Image--4.9.51-r0-fsl-imx8qm-iwg27m-lpddr4-arm2-<date&time>.dtb --> fsl-imx8qm-iwg27m.dtb
Image--4.9.51-r0-imx8qm_iwg27m-<date&time>.bin --> Image
imx-boot-imx8qm_iwg27m-sd.bin-flash --> flash.bin
•Refer the BINARY PROGRAMMING section to program the binaries to iW-RainboW-G27M-QM platform.

REL 1.0
Page 17 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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 iwg27-release-bsp>/iwg27-release-bsp/
•To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx8qm_iwg27m source setup-environment build_imx8qm
•To compile the u-boot, execute the below command.
$bitbake u-boot-iwg27m
•To re-build u-boot, execute the below commands.
$bitbake -f -c compile u-boot-iwg27m
•After the successful compilation the binaries will be placed in below path.
~/<path to iwg27-release-bsp>/iwg27-release-bsp/build_imx8qm/tmp/work/imx8qm_iwg27m-poky-
linux/u-boot-iwg27m/2017.03-r0/image/boot/
•The binary files are listed below
u-boot-sd-2017.03-r0.bin
•Refer the BINARY PROGRAMMING section to update the u-boot binary.

REL 1.0
Page 18 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M 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 iwg27-release-bsp>/iwg27-release-bsp/
•To setup environment build path, execute the below command. This is required only once on switching of
every new terminal window.
$MACHINE=imx8qm_iwg27m source setup-environment build_imx8qm
•To compile the Linux kernel, execute the below command.
$bitbake linux-iwg27m
•To change the Linux kernel configuration, execute the below command.
$bitbake -c menuconfig linux-iwg27m
•To re-build Linux kernel from scratch, execute the below commands.
$bitbake -f -c compile linux-iwg27m
•After the successful compilation the Image will be placed in below path.
~/<path to iwg27-release-bsp>/iwg27-release-bsp/build_imx8qm/tmp/work/imx8qm_iwg27m-poky-
linux/linux-iwg27m/4.9.51-r0/build/arch/arm64/boot/
•The dtb files will be placed in below path.
~/<path to iwg27-release-bsp>/iwg27-release-bsp/build_imx8qm/tmp/work/imx8qm_iwg27m-poky-
linuxi/linux-iwg27m/4.9.51-r0/build/arch/arm64/boot/dts/freescale/
•The binary files are listed below
Image
dts/freescale/fsl-imx8qm-iwg27m.dtb
•Refer the BINARY PROGRAMMING section to update the Linux kernel binary.

REL 1.0
Page 19 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
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-G27M-QM 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.
•Un-tar the Source-Code.tar.gz file from deliverables.
host@host~$tar -xvf /<path_to_iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables>/iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables/Source-Code/Source-Code.tar.gz
2.3.1 System Controller Firmware(SCFW)
•Create a directory and open the directory in host to build the SCFW.
host@host~$mkdir <directory_name>
host@host~$cd <directory_name>
•The SCFW source code tar file from deliverables is located in the below path.
iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-YoctoMorty_Deliverables/Source-
Code/SCFW/Code/scfw_export_mx8qm.tar.gz
•Un-tar the downloaded scfw_export_mx8qm.tar.gz file in to newly created directory.
host@host/<Directory>~$tar -xvf /<path_to_iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables>/iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables/Source-Code/SCFW/Code/scfw_export_mx8qm.tar.gz
•The cross compiler file from deliverables is located in the below path.
iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-YoctoMorty_Deliverables/Source-
Code/SCFW/CROSSC_COMPILER/gcc-arm-none-eabi-4_9-2015q3-20150921linux.tar.bz2
•Un-tar the downloaded gcc-arm-none-eabi-4_9-2015q3-20150921linux.tar.bz2 file in to newly created
directory.
host@host/<Directory>~$tar -jxvf iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables/Source-Code/SCFW/CROSSC_COMPILER/gcc-arm-none-eabi-4_9-2015q3-
20150921linux.tar.bz2

REL 1.0
Page 20 of 60
iWave Systems Technologies Pvt. Ltd.
iW-RainboW-G27M Linux User Manual
•Copy the scfw patch file to current directory.
host@host/<directory>~$cp /<path_to_iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables>/iW-RainboW-G27M-QM-RX.X-RELX.X-Linux4.9.51-
YoctoMorty_Deliverables/Source-Code/SCFW/Code/PATCH000-iW-PRFHZ-SC-01-RX.X-RELX.X-
Linux4.9.51_SCFW_Basic_Customization.patch .
•Change the directory to scfw_export_mx8qm.
host@host/<Directory>~$cd scfw_export_mx8qm
•To apply the patch file, execute the below command.
host@host/<directory>/scfw_export_mx8qm~$patch -Np1 < ../PATCH000-iW-PRFHZ-SC-01-RX.X-
RELX.X-Linux4.9.51_SCFW_Basic_Customization.patch
•Export, cross compiler path.
host@host/<Directory>/scfw_export_mx8qm~$export TOOLS=<path_to_directory_holding_gcc-arm-
none-eabi-4_9-2015q3>
•To compile the SCFW, execute the below commands.
host@host/<Directory>/scfw_export_mx8qm ~$make qm
•After successful compilation, SCFW binaries will be created in the below path.
~/ scfw_export_mx8qm/build_mx8qm/scfw_tcm.bin
•Copy this binary to imx-boot folder.
host@host/<directory>~$cp -rf scfw_tcm.bin /<path_to_imx-boot>/imx-boot/iMX8QM/
•Also copy lpddr4 cfg binary file to imx-boot folder which is present in below path & and compile the U-Boot.
host@host/<directory>~$cp -rf imx8qmddr4_dcd_1_2GHz.cfg /<path_to_imx-boot>/imx-
boot/iMX8QM/
•lpddr4 cfg binary file is present in the below path.
~/ scfw_export_mx8qm/platform/board/mx8qm_val/dcd/imx8qmddr4_dcd_1_2GHz.cfg