CM-FX6: U-Boot: Building Images - Revision history

Grinberg: /* Snapshot download */

2015-10-18T15:26:02Z

‎Snapshot download

Nikita at 10:25, 21 May 2015

2015-05-21T10:25:51Z

Nikita: /* Building the firmware images */

2015-01-20T16:18:41Z

‎Building the firmware images

Nikita at 08:02, 17 September 2014

2014-09-17T08:02:01Z

Grinberg: /* Git clone */

2014-09-07T11:18:06Z

‎Git clone

Grinberg: /* See also */

2014-07-01T12:16:33Z

‎See also

Grinberg: /* Building the firmware images */

2014-06-29T13:06:50Z

‎Building the firmware images

New page

== Overview ==
CM-FX6 firmware consists of two components: Secondary Program Loader (SPL) and U-Boot.
Both components are based on [http://www.denx.de/wiki/U-Boot/WebHome U-Boot] source code.
SPL is the bootstrap utility invoked by the CPU internal boot ROM code of the i.MX6 SoC.
SPL performs minimal hardware initialization and loads U-Boot from the same boot device.
U-Boot initializes hardware modules necessary for system boot and loads the operating system.

== Building Firmware images for CM-FX6 ==
=== Cross-Compiler ===
There are several options for cross-compilation toolchain setup. You can either compile your cross-compiler or use an already built cross-compiler. The cross-compiler should support the ARM embedded-application binary interface ("[http://en.wikipedia.org/wiki/Application_binary_interface#EABI EABI]")
* Pre-built toolchain (recommended):
** [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/ Sourcery CodeBench Lite]
* Tools for creating cross-compilers:
** [http://crosstool-ng.org/ Crosstool-ng]: Builds a cross-compiler from source. Non-distribution specific.
** [http://www.gentoo.org/proj/en/base/embedded/handbook/index.xml?part=1&chap=4 Crossdev]: Gentoo's cross-compiler builder. Needs Gentoo.

=== Getting U-Boot sources ===
There are two ways to get U-Boot sources that can be used as a baseline for CM-FX6 SPL and U-Boot.
You can create a copy of "Das U-Boot" source tree or download a snapshot and extract it.
We assume that you have created {{filename|/home/development/cm-fx6/u-boot}} directory for CM-FX6 u-boot development.

==== Snapshot download ====
* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=dda0dbfc69f3d560c87f5be85f127ed862ea6721;sf=tbz2 v2014.04] snapshot with your web browser.
* Extract the downloaded archive {{filename|u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2}}
<pre>
cd /home/development/cm-fx6/u-boot
tar xvf /path/to/downloaded/u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2
mv u-boot u-boot-cm-fx6
</pre>
: This will create {{filename|/home/development/cm-fx6/u-boot/u-boot-cm-fx6}} directory containing U-Boot source code tree.
* Apply the CM-FX6 patch
<pre>
cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
patch -p1 < /path/to/cm-fx6-u-boot/u-boot/u-boot-v2014.04-cm-fx6-1.patch
</pre>

==== Git clone ====
* Install [http://git-scm.com/ git] version control system.
* Create a clone of U-Boot tree
<pre>
cd /home/development/cm-fx6/u-boot
git clone git://git.denx.de/u-boot.git u-boot-cm-fx6
</pre>
* Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2014.04 tag (dda0dbfc69f3d560c87f5be85f127ed862ea6721 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
<pre>
git checkout -b cm-fx6-dev v2014.04
</pre>
* Apply the CM-FX6 patch
<pre>
cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
git apply /path/to/cm-fx6-u-boot/u-boot/u-boot-v2014.04-cm-fx6-1.patch
</pre>

=== Building the firmware images ===
* First, compile both SPL and U-Boot. The following commands create the {{filename|spl/u-boot-spl.bin}} and {{filename|u-boot.img}} binaries (along with other image types):
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-eabi-
make mrproper
make cm_fx6_config && make
</pre>
* Invoke mkimage on the SPL binary to attach the IVT header required by the i.MX6 boot ROM code to the SPL binary. This generates a new image file {{filename|spl}}.
<pre>
./tools/mkimage -n board/compulab/cm_fx6/imximage.cfg -T imximage -e 0x00908000 -d spl/u-boot-spl.bin spl
</pre>
* Create the combined image by creating a 0xFF initialized 512KB {{filename|cm-fx6-firmware}} file, and writing the {{filename|spl}} and {{filename|u-boot.img}} data to the appropriate offsets within the {{filename|firmware}} file.
<pre>
dd if=/dev/zero count=500 bs=1K | tr '\000' '\377' > cm-fx6-firmware
dd if=spl of=cm-fx6-firmware bs=1K seek=1 conv=notrunc && dd if=u-boot.img of=cm-fx6-firmware bs=1K seek=64 conv=notrunc
</pre>
* You can now install the {{filename|cm-fx6-firmware}} file into an SD card or CM-FX6 SPI flash.

== See also ==

* [[U-Boot quick reference]]
* [[U-Boot images]]
* [http://www.denx.de/wiki/U-Boot/Documentation U-Boot documentation]

[[Category:U-Boot]]
[[Category:CM-FX6]]

@@ Line 22: / Line 22: @@
 ==== Snapshot download ====
-* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=c43fd23cf619856b0763a64a6a3bcf3663058c49 v2014.10] snapshot with your web browser.
+* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=33711bdd4a4dce942fb5ae85a68899a8357bdd94 v2015.07] snapshot with your web browser.
-* Extract the downloaded archive {{filename|u-boot-c43fd23cf619856b0763a64a6a3bcf3663058c49.tar.gz}}
+* Extract the downloaded archive {{filename|u-boot-33711bd.tar.gz}}
 <pre>
 cd /home/development/cm-fx6/u-boot
-tar xvf /path/to/downloaded/u-boot-c43fd23cf619856b0763a64a6a3bcf3663058c49.tar.bz2
+tar xvf /path/to/downloaded/u-boot-33711bd.tar.gz
 mv u-boot u-boot-cm-fx6
 </pre>
@@ Line 33: / Line 33: @@
 <pre>
 cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
-patch -p1 < /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.10-cm-fx6-2.2.patch
+patch -p1 < /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2015.07-cm-fx6-3.patch
 </pre>
@@ Line 44: / Line 44: @@
 cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
 </pre>
-* Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2014.10 tag (c43fd23cf619856b0763a64a6a3bcf3663058c49 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
+* Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2015.07 tag (33711bdd4a4dce942fb5ae85a68899a8357bdd94 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
 <pre>
-git checkout -b cm-fx6-dev v2014.10
+git checkout -b cm-fx6-dev v2015.07
 </pre>
 * Apply the CM-FX6 patch
 <pre>
-git apply /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.10-cm-fx6-2.2.patch
+git apply /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2015.07-cm-fx6-3.patch
 </pre>
@@ Line 63: / Line 63: @@
 * Invoke mkimage on the SPL binary to attach the IVT header required by the i.MX6 boot ROM code to the SPL binary. This generates a new image file {{filename|spl.img}}.
 <pre>
-./tools/mkimage -n board/compulab/cm_fx6/imximage.cfg.cfgtmp -T imximage -e 0x00908000 -d spl/u-boot-spl.bin spl.img
+./tools/mkimage -n arch/arm/imx-common/spl_sd.cfg.cfgtmp -T imximage -e 0x00908000 -d spl/u-boot-spl.bin spl.img
 </pre>
 * Create the combined image by creating a 0xFF initialized 512KB {{filename|cm-fx6-firmware}} file, and writing the {{filename|spl.img}} and {{filename|u-boot.img}} data to the appropriate offsets within the {{filename|firmware}} file.

@@ Line 22: / Line 22: @@
 ==== Snapshot download ====
-* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=dda0dbfc69f3d560c87f5be85f127ed862ea6721;sf=tbz2 v2014.04] snapshot with your web browser.
+* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=c43fd23cf619856b0763a64a6a3bcf3663058c49 v2014.10] snapshot with your web browser.
-* Extract the downloaded archive {{filename|u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2}}
+* Extract the downloaded archive {{filename|u-boot-c43fd23cf619856b0763a64a6a3bcf3663058c49.tar.gz}}
 <pre>
 cd /home/development/cm-fx6/u-boot
-tar xvf /path/to/downloaded/u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2
+tar xvf /path/to/downloaded/u-boot-c43fd23cf619856b0763a64a6a3bcf3663058c49.tar.bz2
 mv u-boot u-boot-cm-fx6
 </pre>
@@ Line 33: / Line 33: @@
 <pre>
 cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
-patch -p1 < /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.04-cm-fx6-1.3.patch
+patch -p1 < /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.10-cm-fx6-2.1.patch
 </pre>
@@ Line 44: / Line 44: @@
 cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
 </pre>
-* Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2014.04 tag (dda0dbfc69f3d560c87f5be85f127ed862ea6721 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
+* Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2014.10 tag (c43fd23cf619856b0763a64a6a3bcf3663058c49 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
 <pre>
-git checkout -b cm-fx6-dev v2014.04
+git checkout -b cm-fx6-dev v2014.10
 </pre>
 * Apply the CM-FX6 patch
 <pre>
-git apply /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.04-cm-fx6-1.3.patch
+git apply /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.10-cm-fx6-2.1.patch
 </pre>
@@ Line 61: / Line 61: @@
 make cm_fx6_config && make
 </pre>
-* Invoke mkimage on the SPL binary to attach the IVT header required by the i.MX6 boot ROM code to the SPL binary. This generates a new image file {{filename|spl}}.
+* Invoke mkimage on the SPL binary to attach the IVT header required by the i.MX6 boot ROM code to the SPL binary. This generates a new image file {{filename|spl.img}}.
 <pre>
-./tools/mkimage -n board/compulab/cm_fx6/imximage.cfg -T imximage -e 0x00908000 -d spl/u-boot-spl.bin spl
+./tools/mkimage -n board/compulab/cm_fx6/imximage.cfg.cfgtmp -T imximage -e 0x00908000 -d spl/u-boot-spl.bin spl.img
 </pre>
-* Create the combined image by creating a 0xFF initialized 512KB {{filename|cm-fx6-firmware}} file, and writing the {{filename|spl}} and {{filename|u-boot.img}} data to the appropriate offsets within the {{filename|firmware}} file.
+* Create the combined image by creating a 0xFF initialized 512KB {{filename|cm-fx6-firmware}} file, and writing the {{filename|spl.img}} and {{filename|u-boot.img}} data to the appropriate offsets within the {{filename|firmware}} file.
 <pre>
 dd if=/dev/zero count=500 bs=1K | tr '\000' '\377' > cm-fx6-firmware
-dd if=spl of=cm-fx6-firmware bs=1K seek=1 conv=notrunc && dd if=u-boot.img of=cm-fx6-firmware bs=1K seek=64 conv=notrunc
+dd if=spl.img of=cm-fx6-firmware bs=1K seek=1 conv=notrunc && dd if=u-boot.img of=cm-fx6-firmware bs=1K seek=64 conv=notrunc
 </pre>
 * You can now install the {{filename|cm-fx6-firmware}} file into an SD card or CM-FX6 SPI flash.

@@ Line 8: / Line 8: @@
 == Building Firmware images for CM-FX6 ==
 === Cross-Compiler ===
-There are several options for cross-compilation toolchain setup. You can either compile your cross-compiler or use an already built cross-compiler. The cross-compiler should support the ARM embedded-application binary interface ("[http://en.wikipedia.org/wiki/Application_binary_interface#EABI EABI]")
+There are several options for cross-compilation toolchain setup. You can either compile your cross-compiler or use an already built cross-compiler.
 * Pre-built toolchain (recommended):
 ** [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/ Sourcery CodeBench Lite]
@@ Line 32: / Line 33: @@
 <pre>
 cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
-patch -p1 < /path/to/cm-fx6-u-boot/u-boot/u-boot-v2014.04-cm-fx6-1.patch
+patch -p1 < /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.04-cm-fx6-1.2.patch
 </pre>
@@ Line 41: / Line 42: @@
 cd /home/development/cm-fx6/u-boot
 git clone git://git.denx.de/u-boot.git u-boot-cm-fx6
 </pre>
 * Create a branch for CM-FX6 development. The CM-FX6 patches are generated vs. v2014.04 tag (dda0dbfc69f3d560c87f5be85f127ed862ea6721 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
@@ Line 48: / Line 50: @@
 * Apply the CM-FX6 patch
 <pre>
-cd /home/development/cm-fx6/u-boot/u-boot-cm-fx6
+git apply /path/to/cm-fx6-u-boot-package/u-boot/u-boot-v2014.04-cm-fx6-1.2.patch
 </pre>

@@ Line 73: / Line 73: @@
 == See also ==
 * [[U-Boot quick reference]]
 * [[U-Boot images]]