Valentin: /* Install on the eMMC */

2016-02-16T11:36:50Z

‎Install on the eMMC

New page

= Overview =
The Yocto Project is an open-source collaboration focused on embedded Linux development. 
The purpose of this article is to show how to get Yocto Image with CL-SOM-iMX6UL support.

= Build CL-SOM-iMX6UL Yocto Image =
== Yocto Environment Setup ==
This section describes the Yocto environment setup and build procedure.
=== Host Setup ===
To get the Yocto Project expected behavior 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.
The recommended minimum Ubuntu version is 12.04 or later.
Earlier versions may cause the Yocto Project build setup to fail, because it requires python versions only available starting with Ubuntu 12.04.

==== Host Packages ====
A Freescale Yocto Project Community BSP build requires that some packages be installed for the build that are documented under the Yocto Project.
You can go to [http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#required-packages-for-the-host-development-system Yocto Project Quick Start] and check for the packages that must be installed for your build machine.
* Essential Yocto Project host packages:
<pre>
$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev
</pre>
* i.MX layers host packages for Ubuntu 12.04 or 14.04 host setup are:
<pre>
$ 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
</pre>
* i.MX layers host packages for a Ubuntu 12.04 host setup only are:
<pre>
$ sudo apt-get install uboot-mkimage
</pre>
* i.MX layers host packages for a Ubuntu 14.04 host setup only are:
<pre>
$ sudo apt-get install u-boot-tools
</pre>

==== Setting up the repo utility ====
{{filename|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.
{{filename|repo}} complements very well the layered nature of the Yocto Project, making it easier for customers to add their own layers to the BSP.
 To install the {{filename|repo}} utility, perform these steps:
* Create a bin folder in the home directory.
<pre>
$ mkdir ~/bin #(this step may not be needed if the bin folder already exists)
$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
</pre>
* Add the following line to the {{filename|.bashrc}} file to ensure that the ~/bin folder is in your PATH variable.
<pre>
$ export PATH=~/bin:$PATH
</pre>

==== Yocto Project Setup ====
A Yocto Project directory contains a {{filename|sources}} directory, which contains the recipes used to build, one or more build
directories, and a set of scripts used to set up the environment.
The recipes used to build the project come from both the community and Freescale. The following commands are used to
download the Freescale Yocto Project Community BSP recipe layers. The Yocto Project layers are downloaded and placed in
the {{filename|sources}} directory. This sets up the recipes that are used to build the project.
For this example, a directory called "fsl-release-bsp" is created for the project.
<pre>
$ mkdir fsl-release-bsp
$ cd fsl-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-3.14.38-6UL_ga
$ repo sync
$ export FSL_BSP_ROOT=`pwd`
</pre>

When this process is completed, the source code is checked out at {{filename|fsl-release-bsp/sources}}.
You can perform repo synchronization, with the command {{filename|repo sync}}, periodically to update to the latest codes.

=== CL-SOM-iMX6UL Support ===
{{Note|We assume that {{filename|/path/to/cl-som-imx6ul-yocto}} contains unpacked content of the CL-SOM-iMX6UL Yocto Linux Package}}
==== CL-SOM-iMX6UL Patches ====
* Go to the {{filename|fsl-release-bsp/source/meta-fsl-arm-extra}} directory and apply the patches:
<pre>
$ cd ${FSL_BSP_ROOT}/sources/meta-fsl-arm-extra
$ git am /path/to/cl-som-imx6ul-yocto/development/*.patch
</pre>
* Go to the {{filename|fsl-release-bsp}} root:
<pre>
$ cd ${FSL_BSP_ROOT}
</pre>

==== Build x11 image for CL-SOM-iMX6UL ====
<pre>
$ export MACHINE=cl-som-imx6ul
$ source fsl-setup-release.sh –b build -e x11
$ bitbake fsl-image-gui
</pre>
If bitbake displays an error indicating that fsl-image-gui cannot be found, this means that fsl-setup-release.sh was not run.
This script hooks in the meta-fsl-bsp-release layer with the Yocto Project layer system.
Build scripts used to generate prebuilt images for this release are provided in the meta-fsl-bsp-release layer in imx/tools.
Use these for additional examples.

Once a build is complete, the created images reside in {{filename|${FSL_BSP_ROOT}/build/tmp/deploy/images/${MACHINE}}}.
The image build creates a U-Boot, Linux kernel, and rootfs image type based on the IMAGE_FSTYPES defined in the machine configuration file.
Most machine configurations provide an SD card image, ext3 and tar.bz2. The ext3 is the root file system.

Create an environment variable {{parameter|BSP_IMAGES_DIR}} for use during deployment.
<pre>
$ export BSP_IMAGES_DIR=${FSL_BSP_ROOT}/build/tmp/deploy/images/${MACHINE}
</pre>

= Image Deployment =
== Image content ==
=== File System ===
* {{filename|fsl-image-gui-cl-som-imx6ul.sdcard}} - SD card image that provides the full system to boot with U-Boot and Linux kernel
* {{filename|fsl-image-gui-cl-som-imx6ul.tar.bz2}} - rootfs tar ball for deployment onto any (including NFS) storage or further customization
=== Kernel and Modules ===
* {{filename|zImage-cl-som-imx6ul.bin}} - ready to run Linux kernel image binary for CL-SOM-iMX6UL
* {{filename|modules-cl-som-imx6ul.tgz}} - the Linux kernel modules
=== Device Tree Blobs ===
* {{filename|zImage-imx6ul-cl-som-imx6ul.dtb}} - CL-SOM-iMX6UL (module only) device tree blob
* {{filename|zImage-imx6ul-cl-som-imx6ul-wilink.dtb}} - CL-SOM-iMX6UL (module only) with WiLink8 device tree blob
* {{filename|zImage-imx6ul-sbc-imx6ul.dtb}} - SBC-iMX6UL (evaluation board) device tree blob
* {{filename|zImage-imx6ul-sbc-imx6ul-wilink.dtb}} - SBC-iMX6UL (evaluation board) with WiLink8 device tree blob

=== U-Boot ===
* {{filename|u-boot-cl-som-imx6ul.imx}} - ready to flash CL-SOM-iMX6UL firmware

== SD card deployment ==
=== Flashing an SD card ===
* Flash the SD card image:
{{Note|sdX represents an entire device, not a partition Example: {{filename|/dev/sde}} }}
<pre>
$ sudo -i
$ cd ${BSP_IMAGES_DIR}
$ SDCARD_IMAGE=$(ls -tr *.sdcard | head -1)
$ dd if=${SDCARD_IMAGE} of=/dev/sdX bs=1M
</pre>
* Copy the U-Boot binary to the SD card:
{{Note|sdX1 represents the device 1-st partition Example: {{filename|/dev/sde1}} }}
<pre>
$ hdparm -z /dev/sdX
$ mkdir /tmp/sdX1
$ mount /dev/sdX1 /tmp/sdX1
$ cp u-boot-cl-som-imx6ul.imx /tmp/sdX1/
</pre>
* Unmount and eject the SD card:
<pre>
$ umount /dev/sdX1
$ eject /dev/sdX
$ exit
</pre>

=== Booting from an SD card ===
* Plug the SD card into the full size sd slot(P9) of the SB-SOM-iMX6UL
* Hold the ALT BOOT (SW3) button while resetting/powering on the CL-SOM-iMX6UL evaluation system
* The CL-SOM-iMX6UL will boot from the SD card
* Press a button as soon as "'''Hit any key to stop autoboot:'''" shows up

==== Flash the U-Boot ====
<pre>
mmc dev 0; mmc rescan
setenv size 0x80000; mw.b ${loadaddr} 0 ${size}
load mmc 0 ${loadaddr} u-boot-cl-som-imx6ul.imx
sf probe ; sf erase 0 0x80000 ; sf write ${loadaddr} 0x400 ${size}
</pre>

==== Set and save the default U-Boot environment ====
<pre>
env default -a
saveenv
reset
</pre>

== eMMC deployment ==
=== Install on the eMMC ===
{{Note|Requires a Yocto [[#SD card deployment|SD card]] to be prepared first.}}
* [[#Booting_from_an_SD_card|Boot up the board using the SD-Card]]
* Upon successful boot the login prompt shows up:
<pre>
Poky (Yocto Project Reference Distro) 1.8 cl-som-imx6ul /dev/ttymxc2

cl-som-imx6ul login:
</pre>
* Login as {{parameter|root}} into the system.
Once the board has been booted using a bootable [[#SD card deployment|SD Card]], the Yocto rootfs can be installed onto the board eMMC.
{{Note|We assume that {{filename|/mount/point}} contains unpacked content of the {{parameter|BSP_IMAGES_DIR}}.}}
* In this subsection the term {{filename|/mount/point}} can be:
** {{filename|/mnt/net}} if NFS is used
** {{filename|/media/mmcblk0pX}} if an MMC/SD card is used, where X is the partition number.
** {{filename|/media/sdXY}} if a USB storage is used, where X is the USB drive letter and Y is the partition number.
* Flash the SD card image on the eMMC:
<pre>
$ cd ${BSP_IMAGES_DIR}
$ SDCARD_IMAGE=$(ls -tr *.sdcard | head -1)
$ sudo dd if=${SDCARD_IMAGE} of=/dev/mmcblk1 bs=1M
</pre>
* WiLink8 Deployment
<pre>
$ hdparm -z /dev/sdX
$ mkdir /tmp/sdX2
$ mount /dev/sdX2 /tmp/sdX2
$ tar -C /tmp/sdX2 -xvf /path/to/cl-som-imx6ul-yocto/images/extra/WiLink8.fs.support.tar.bz2
</pre>
* Power off the device:
<pre>
$ poweoff
</pre>

=== Booting from the eMMC ===
* Power on the device.
* Press a button as soon as "'''Hit any key to stop autoboot:'''" shows up.
* Update the boot environment and boot the device:
<pre>
setenv mmcdev 1
setenv mmcroot "/dev/mmcblk${mmcdev}p2 rootwait rw"
setenv fdt_file imx6ul-sbc-imx6ul-wilink.dtb
saveenv
boot
</pre>

== Display Options ==

SBC-iMX6UL has an option to connecte either an LCD or a DVI display. 
The default device tree layout allows using both interfaces at the same time with the 1024x768@60 resolution. 
{{Note|A side effect is: the LCD display shows upper left part of the screen with geometry 800x480}}

Below are examples that show how to change the boot environment in order to set the correct interface
timing and geometry and work with either an LCD or a DVI display separately.

=== LCD ===
<pre>
setenv lcd+ 'fdt add ${fdt_addr}; fdt rm lcdif/display/display-timings/dvi'
setenv bootcmd 'run mmcargs; run loadfdt; run loadimage; run lcd+; bootz ${loadaddr} - ${fdt_addr}'
saveenv
boot
</pre>

=== DVI ===
<pre>
setenv dvi+ 'fdt add ${fdt_addr}; fdt rm lcdif/display/display-timings/lcd'
setenv bootcmd 'run mmcargs; run loadfdt; run loadimage; run lcd+; bootz ${loadaddr} - ${fdt_addr}'
saveenv
boot
</pre>

= See Also =
* [http://compulab.co.il/utilite-computer/download/imx6ul/unofficial_unsupported/Yocto/Freescale_Yocto_Project_User's_Guide.pdf Freescale Yocto Project_User's Guide]
* [http://www.yoctoproject.org The Yocto Project homepage]
* [http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#required-packages-for-the-host-development-system Yocto Project Quick Start]

[[Category:Linux]]
[[Category:Yocto]]
[[Category:CL-SOM-iMX6UL]]

CL-SOM-iMX6UL: Yocto Linux: Building - Revision history

Valentin: /* Install on the eMMC */