Freescale Semiconductor i.MX 6SoloLite Linux User manual

i.MX 6SoloLite EVK Linux User's
Guide
Document Number: IMX6SLLXUGEVK
Rev L3.0.35_4.1.0, 09/2013

i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
2 Freescale Semiconductor, Inc.

Contents
Section number Title Page
Chapter 1
About This Book
1.1 Audience.........................................................................................................................................................................5
Chapter 2
Introduction
2.1 Boot Loader....................................................................................................................................................................7
2.2 Linux Kernel Image........................................................................................................................................................7
2.3 Gnome Mobile Root File System...................................................................................................................................7
Chapter 3
Building the Linux Platform
3.1 Setting Up the Linux Host..............................................................................................................................................9
3.2 Installing and Building LTIB..........................................................................................................................................9
3.3 Setting rootfs for NFS.....................................................................................................................................................10
3.4 Copying Images to TFTP Server....................................................................................................................................11
3.5 How to Generate No-Padding U-Boot............................................................................................................................12
3.6 How to Generate uImage from a zImage........................................................................................................................12
3.7 How to Build U-Boot and Kernel in Standalone Environment......................................................................................12
3.8 Building Manufacturing Firmware.................................................................................................................................13
Chapter 4
How to Boot the i.MX 6SoloLite EVK Board
4.1 How to Enter Serial Download Mode for MFGTool......................................................................................................15
4.2 How to Boot from SD Card from Slot2..........................................................................................................................15
4.3 How to Boot From eMMC4.4.........................................................................................................................................15
4.4 How to Boot from SPI-NOR...........................................................................................................................................16
Chapter 5
Flash Memory Map
5.1 MMC/SD Memory Map.................................................................................................................................................17
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 3

Section number Title Page
Chapter 6
Downloading Images by Using MFGTool
6.1 Installing the MFGTool..................................................................................................................................................19
6.2 Usage...............................................................................................................................................................................19
Chapter 7
Downloading Images by Bootloader or NFS
7.1 Setting Up the Terminal .................................................................................................................................................23
7.2 Downloading Images by U-Boot....................................................................................................................................23
7.2.1 MMC/SD on SD1...............................................................................................................................................24
7.3 U-Boot Configurations....................................................................................................................................................25
7.4 Using i.MX 6SoloLite EVK Board as Host Server to Create rootfs..............................................................................25
Chapter 8
Using a Linux Host to Set Up an SD/MMC Card
8.1 Requirements..................................................................................................................................................................27
8.2 Copying the Boot Loader Image.....................................................................................................................................28
8.3 Copying the Kernel Image..............................................................................................................................................28
8.4 Copying the Root File System (rootfs)...........................................................................................................................28
Chapter 9
Running the Image on the Target
9.1 Running the Image from NFS.........................................................................................................................................31
9.2 Running the Image from MMC/SD................................................................................................................................31
Chapter 10
Frequently Asked Questions
10.1 How to Fuse in U-Boot...................................................................................................................................................33
10.2 How to Use L2 Cache as IRAM.....................................................................................................................................33
10.2.1 Demo on i.MX 6SL Board.................................................................................................................................34
10.3 How to Enable Secure Boot............................................................................................................................................34
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
4 Freescale Semiconductor, Inc.

Chapter 1
About This Book
1.1 Audience
This information is intended for software, hardware, and system engineers who are
planning to use the product, and for anyone who wants to understand more about the
product.
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 5

Audience
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
6 Freescale Semiconductor, Inc.

Chapter 2
Introduction
The i.MX 6SoloLite EVK Linux BSP is a collection of binary, source code, and support
files that can be used to create U-Boot boot loader, Linux kernel image, and a root file
system for i.MX 6SoloLite EVK development systems .
2.1 Boot Loader
The i.MX 6SoloLite EVK Linux delivery package contains the following U-Boot
bootloader binary:
L3.0.35_4.1.0_130816_images_MX6S/u-boot-mx6sl-evk.bin
This bootloader supports SD/MMC, eMMC4.3, eMMC4.4, eMMC4.41, SPI-NOR
2.2 Linux Kernel Image
This Freescale i.MX BSP contains a pre-built kernel image based on the 3.0.35 version of
the Linux kernel. The i.MX 6SoloLite EVK kernel image is located at the following path:
L3.0.35_4.1.0_130816_images_MX6S/uImage
2.3 Gnome Mobile Root File System
The root file system package provides busybox, common libraries, and other fundamental
elements.
The i.MX 6SoloLite EVK BSP package contains the following rootfs file system:
L3.0.35_4.1.0_130816_images_MX6S/rootfs.ext2.gz
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 7

The rootfs.ext2.gz file system includes Freescale specific libraries and gnome GUI. It can
be mounted as NFS (see Setting rootfs for NFS), or its contents can be stored on a boot
media such as Secure Digital (SD) card.
Gnome Mobile Root File System
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
8 Freescale Semiconductor, Inc.

Chapter 3
Building the Linux Platform
This chapter explains how to set up the build environment, install and build LTIB, set the
rootfs for NFS, and set up the host environment.
Note that not all of the steps are required for every boot mode. The only required steps
are in Setting Up the Linux Host and Installing and Building LTIB.
3.1 Setting Up the Linux Host
See the Setting Up a Linux Host for LTIB Builds on Ubuntu 9.04 document included in
the release package to set up the Linux host server.
NOTE
The following new packages are needed for this release:
• asciidoc
• texlive-latex-base
• dblatex xutils-dev
For more details, see Setting Up a Linux Host for LTIB Builds
on Ubuntu 9.04.
3.2 Installing and Building LTIB
NOTE
To run LTIB, some host packages are needed. If any error
related to a host package is raised, install the host package.
1. Remove all previously-installed packages from /opt/freescale/pkgs/.
2. Install the LTIB package, not as root, in a location such as /home/user/:
tar zxvf L3.0.35_4.1.0_130816_source.tar.gz
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 9

./L3.0.35_4.1.0_130816_source/install
This command installs LTIB to your directory.
3. Build LTIB:
cd <LTIB directory>
./ltib -m config
4. Select platform to Freescale i.MX reference boards and exit, saving the changes.
At the next menu, select platform type as imx6s and package profile. Exit and save
the new configuration. Only the profiles of Min profile, FSL gnome release
packages, and mfg firmware profile pass build tests.
NOTE
You can use the ./ltib -m selectype command to change the
profile after the first selection.
5. To build U-Boot for i.MX 6SoloLite EVK board, select "Choose your board for U-
Boot" as "mx6sl_evk". Please note this option is only for U-Boot. For the kernel
image, the current default kernel configuration builds a single image that works for
all i.MX 6 boards except i.MX 6SoloLite boards. i.MX 6SoloLite boards use 'MX6S'
--- Choose your board
board (mx6sl_evk) --->
7. Close the configuration screen to save the changes.
8. Run the following command:
./ltib
When this procedure is completed, the kernel image and the U-Boot images are
located at: rootfs/boot/
9. Some other useful LTIB commands are:
./ltib -help
/* List the packages in LTIB */
./ltib –m listpkgs
/* Get the source code of one package. The source code will be extracted to <ltib folder>/
rpm/BUILD/ */
./ltib -m prep -p <package name>
/* This command is used to build the source code of <package name>. If you modify the source
code, you can rebuild the source code by this command */
./ltib -m scbuild -p <package name>
/* Install one package to rootfs */
./ltib -m scdeploy -p <package name>
Setting rootfs for NFS
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
10 Freescale Semiconductor, Inc.