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.

3.3 Setting rootfs for NFS
There are two ways to set up the rootfs for NFS on this package.
• Using the ext2 format rootfs package provided in the distribution
• Using the rootfs that is created after making the build of the kernel
Use the following commands to set the rootfs directory for NFS using the rootfs.ext2.gz
package already included in the distribution (you must be the root user for this operation):
mkdir /mnt/rootfs
mkdir /tools
cp imx6s/rootfs.ext2.gz /tools
cd /tools
gunzip rootfs.ext2.gz
mount -o loop -t ext2 rootfs.ext2 /mnt/rootfs
cp -a /mnt/rootfs .
NOTE
In some Linux distributions (such as Fedora), the user needs to
make sure that the contents inside /tools/rootfs have the proper
permission for user access. Since the mount command is made
as root, the content shows as restricted access after the
command cp -a /mnt/rootfs, which may prevent the NFS mount
from working correctly.
To use the root file system created in the LTIB directory after the kernel build, use the
command:
%vi /etc/exports
edit this file by adding the export directory, for example:
/tools/rootfs *(rw,no_root_squash)
save and exit
%exportfs -a
3.4 Copying Images to TFTP Server
To use the TFTP server to download the image, copy the kernel image in the release
package or LTIB to the TFTP directory.
For example:
cp imx6/uImage <tftp folder>
or
cp /<LTIB directory>/rootfs/boot/uImage <tftp folder>
Chapter 3 Building the Linux Platform
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 11

3.5 How to Generate No-Padding U-Boot
To generate no-padding U-Boot, run the following command:
sudo dd if=u-Boot-mx6sl-evk.bin of=u-Boot-mx6sl-evk-no-padding.bin bs=512 skip=2
3.6 How to Generate uImage from a zImage
To generate a uImage with LTIB, in the kernel source code, change the build target from
"zImage" to "uImage".
If you want to generate a uImage from a zImage you built, you can generate a "uImage",
based on the above zImage as shown below:
• Build U-Boot package to get "mkimage" tool under rpm/BUILD/u-boot-<version>/
tools/mkimage.
• Copy mkimage to /usr/bin/
• Run the command below:
mkimage -A arm -O linux -T kernel -C none -a 0x80800000 -e 0x80800000 -n
"Linux-$(KERNELRELEASE)" -d zImage uImage
Note: Replace KERNELRELEASE with the appropriate kernel version for your image.
For example, 3.0.35-151-xxxx.
3.7 How to Build U-Boot and Kernel in Standalone
Environment
To build U-Boot in a standalone environment, perform the following actions in the root
folder of U-Boot sources:
./ltib -m prep -p u-boot
cd rpm/BUILD/u-boot-2009.08
make ARCH=arm
CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.6.2-glibc-2.13-linaro-multilib-2011.12/fsl-
linaro-toolchain/bin/arm-none-linux-gnueabi- distclean
make ARCH=arm
CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.6.2-glibc-2.13-linaro-multilib-2011.12/fsl-
linaro-toolchain/bin/arm-none-linux-gnueabi- mx6sl_evk_config
make ARCH=arm
CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.6.2-glibc-2.13-linaro-multilib-2011.12/fsl-
linaro-toolchain/bin/arm-none-linux-gnueabi-
How to Generate No-Padding U-Boot
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
12 Freescale Semiconductor, Inc.

To build the kernel in the standalone environment, do the following:
cd <ltib folder>/rpm/BUILD/linux
make ARCH=arm
CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.6.2-glibc-2.13-linaro-multilib-2011.12/fsl-
linaro-toolchain/bin/arm-none-linux-gnueabi- imx6s_defconfig
make ARCH=arm
CROSS_COMPILE=/opt/freescale/usr/local/gcc-4.6.2-glibc-2.13-linaro-multilib-2011.12/fsl-
linaro-toolchain/bin/arm-none-linux-gnueabi- uImage
3.8 Building Manufacturing Firmware
Keep the LTIB environment clean before you begin to configure and build the firmware.
Then, set up the LTIB environment and configure the file ./config/platform/imx/
imx6s_updater.cf to specify the target firmware.
./ltib --selectype
Choose correct item as shown below:
--- Choose the platform type
Selection (imx6s) --->
--- Choose the packages profile
Selection (mfg firmware profile)--->
In "Freescale i.MX 6 Based Boards" section, choose the board information as in the
following example:
--- Choose your board for U-Boot
board (mx6sl_evk) --->
In the "Choose your Kernel" section, choose the kernel as in the following example:
---Choose your Kernel
Kernel(Linux 3.0.35-imx) --->
After LTIB has completed the build, initramfs.cpio.gz.uboot is generated under the ltib
root folder. The u-boot.bin and uImage for MFG tool are generated under rootfs/boot/.
Chapter 3 Building the Linux Platform
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 13

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

Chapter 4
How to Boot the i.MX 6SoloLite EVK Board
The boot modes of the i.MX 6SoloLite EVK board are controlled by the boot
configuration DIP switches on the board. To locate the boot configuration switches, see .
The following sections list basic boot setup configurations only.
4.1 How to Enter Serial Download Mode for MFGTool
Table 4-1. Boot switch setup for MFGTool
Switch D1 (BOOT_MODE0) D2 (BOOT_MODE1)
S1 ON OFF
4.2 How to Boot from SD Card from Slot2
The following table shows the dip settings for SD2 boot:
Table 4-2. Boot switch setup for SD2 boot
Switch D1 D2 D3 D4 D5 D6 D7 D8
SW3 OFF ON OFF OFF OFF OFF OFF OFF
SW4 OFF OFF ON OFF ON ON OFF OFF
SW5 OFF OFF OFF OFF OFF OFF OFF OFF
Table 4-3. The boot mode setup for SD2 boot (S1)
Switch D1 D2
S1 OFF ON
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 15

4.3 How to Boot From eMMC4.4
Table below shows the boot switch settings to boot from eMMC4.4 connected on slot2
Table 4-4. Boot switch setup for eMMC4.4 boot with 4bit SDR mode
Switch D1 D2 D3 D4 D5 D6 D7 D8
SW3 OFF ON ON OFF OFF OFF OFF OFF
SW4 OFF OFF ON OFF ON OFF OFF OFF
SW5 - - - - - - - -
NOTE
eMMC is not mounted on MX6SL EVK board. An eMMC
daughter card is required.
For more details on switch setting, see table "MMC/eMMC
Boot Fusemap" in IC reference manual.
4.4 How to Boot from SPI-NOR
Table below shows the boot switch settings to boot from SPI-NOR.
Table 4-5. Boot switch setup for SPI-NOR boot
Switch D1 D2 D3 D4 D5 D6 D7 D8
SW3 OFF OFF ON ON OFF OFF OFF OFF
SW4 OFF OFF OFF OFF OFF OFF OFF OFF
SW5 OFF OFF OFF OFF ON OFF OFF OFF
How to Boot from SPI-NOR
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
16 Freescale Semiconductor, Inc.

Chapter 5
Flash Memory Map
This chapter describes the software layout in MMC/SD cards.
This information may be useful for understanding subsequent sections about image
download.
5.1 MMC/SD Memory Map
The MMC/SD scheme is different from the NAND and NOR flash which are deployed in
the BSP software. The MMC/SD must keep the first sector (512 bytes) as the MBR
(Master Boot Record) in order to use MMC/SD as the rootfs.
Upon boot up, the MBR is executed to look up the partition table to determine which
partition to use for booting. The bootloader should be after the MBR. The kernel image
and rootfs may be stored at any address after bootloader.
The MBR can be generated through the fdisk command when creating partitions in
MMC/SD cards on a Linux Host server.
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 17

MMC/SD Memory Map
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
18 Freescale Semiconductor, Inc.

Chapter 6
Downloading Images by Using MFGTool
This chapter describes the procedure for using the MFGTool to download images to the
different devices.
6.1 Installing the MFGTool
Unzip Mfgtools-Rel-4.1.0_130816_MX6SL_UPDATER.tar.gz
6.2 Usage
The MFGTool V2 follows the instructions in "Profiles\MX6SL Linux Update\OS
Firmware\ucl2.xml" to execute program operations. The user must read and update
ucl2.xml to understand the operations before using the MFGTool V2.
Additionally, the user must correctly configure the cfg.ini and UICfg.ini. For example, if
only a board would be supported, "PortMgrDlg=1" should be set in UICfg.ini; if four
boards would be supported, "PortMgrDlg=4" should be set. Incorrect configuration will
cause MFGTool V2 to malfunction.
NOTE
The user needs to change the default setting in cfg.ini file as
follows. MFGTool V2 will look for the setting in ucl2.xml file.
[profiles]
chip = MX6SL Linux Update
[platform]
board = EVK-SD
[LIST]
name = EVK-SD
Follow these instructions to use the i.MX 6SoloLite EVK MFGTool V2:
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
Freescale Semiconductor, Inc. 19

• Connect a USB cable from a PC to the USB OTG port on the board.
• Connect a USB cable from OTG-to-UART port to PC for console output.
• Open a Terminal emulator program. Refer to Setting Up the Terminal .
• Set boot pin to Mfgtool mode. Refer to How to Enter Serial Download Mode for
MFGTool.
• The default profile of the manufacturing tool 2 assumes your file system to be packed
and compressed using bzip2 algorithm, an example can be found in the MFGTool
release package in the folder Profiles\MX6SL Linux Update\OS Firmware\files. To
create this file, you can run the following commands as a root user on Linux OS. You
can also modify profile to support other formats.
• >cd your_rootfs_dir
• >tar cjf ../rootfs.tar.bz2 *
• You can specify your images in two ways: One way is by editing "Profiles\MX6SL
Linux Update\OS Firmware\ucl2.xml" to modify the file path or flash operations to
accommodate your needs. After the modification is completed, save the changes and
exit. The other way is by replacing the files in "Profiles\MX6SL Linux Update\OS
Firmware\files" directory with your files.
NOTE
You will find u-boot-<board>.bin and uImage binaries in
"Profiles\MX6SL Linux Update\OS Firmware" folder.
Those files are manufacturing firmware loaded by tools and
shouldn't be changed unless you need to adapt it for your
own board.
• Before running "MfgTool2.exe", see Manufacturing Tool V2 Quick Start Guide to
know how to configure Mfgtool2, it can be found at Document\V2 directory in the
MFGTOOL release package.
• Execute "MfgTool2.exe" and power on the board. If this is the first time connecting
an i.MX 6 board with the MFGTool V2, system will automatically install HID driver
for you.
• There is no configuration Menu in MFGTool V2. The configuration is done by
parsing ucl2.xml and cfg.ini. After the board has been detected, you will see "HID-
compliant device" in the notification bar as shown in the figure below.
Usage
i.MX 6SoloLite EVK Linux User's Guide, Rev. L3.0.35_4.1.0, 09/2013
20 Freescale Semiconductor, Inc.