Grinberg: /* Getting X-Loader sources */

2015-11-19T08:07:36Z

‎Getting X-Loader sources

New page

== Overview ==
CM-T3517 firmware consists of two components: X-Loader and U-Boot.<br>
X-Loader is the bootstrap utility invoked by the CPU internal boot ROM code of the OMAP3 SoC.
X-Loader performs minimal hardware initializations and loads U-Boot.<br>
U-Boot initializes hardware modules necessary for system boot and loads the operating system.

== Building Firmware images for CM-T3517 ==
=== 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 the sources ===
==== Getting X-Loader sources ====
X-Loader source code is included in the Compulab U-Boot package as a tar.gz archive and can be found in the x-loader folder.
We assume that you have created /home/development/cm-t3517/x-loader directory for CM-T3517 X-Loader development.

<pre>
cd /home/development/cm-t3517/x-loader
tar xvf /path/to/x-loader-cm-t3x-3.tar.bz2
mv x-loader x-loader-cm-t3x
cd x-loader-cm-t3x
</pre>

==== Getting U-Boot sources ====
There are two ways to get U-Boot sources that can be used as a baseline for CM-T3517 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-t3517/u-boot}} directory for CM-T3517 U-Boot development.

===== Snapshot download =====
* Download [http://git.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=snapshot;h=33711bdd4a4dce942fb5ae85a68899a8357bdd94;sf=tgz v2015.07] snapshot with your web browser.
* Extract the downloaded archive {{filename|u-boot-33711bd.tar.gz}}
<pre>
cd /home/development/cm-t3517/u-boot
tar xvf /path/to/downloaded/u-boot-33711bd.tar.gz
mv u-boot u-boot-cm-t3517
</pre>
: This will create {{filename|/home/development/cm-t3517/u-boot/u-boot-cm-t3517}} directory containing U-Boot source code tree.
* Apply the CM-T3517 patch
<pre>
cd /home/development/cm-t3517/u-boot/u-boot-cm-t3517
patch -p1 < /path/to/cm-t3517-u-boot/u-boot/u-boot-2015.07-cm-t3517-2.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-t3517/u-boot
git clone git://git.denx.de/u-boot.git u-boot-cm-t3517
</pre>
* Create a branch for CM-T3517 development. The CM-T3517 patches are generated vs. [http://git.denx.de/?p=u-boot.git;a=commit;h=33711bdd4a4dce942fb5ae85a68899a8357bdd94 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-t3517-dev v2015.07
</pre>
* Apply the CM-T3517 patch
<pre>
cd /home/development/cm-t3517/u-boot/u-boot-cm-t3517
git apply /path/to/cm-t3517-u-boot/u-boot/u-boot-2015.07-cm-t3517-2.patch
</pre>

=== Building the firmware images ===
==== Building X-Loader images ====
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-eabi-
make mrproper
make cm-t3x_config
make
</pre>

In the example above, CM-T3517 firmware X-Loader image ({{filename|x-load.bin}}) will be created in {{filename|/home/development/cm-t3517/x-loader/x-loader-cm-t3x}}.

==== Building U-Boot images ====
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-eabi-
make cm_t3517_config
make
</pre>

In the example above, CM-T3517 firmware U-Boot image ({{filename|u-boot.bin}}) will be created in {{filename|/home/development/cm-t3517/u-boot/u-boot-cm-t3517}}.

== See also ==
* [[CM-T3x: U-Boot: Firmware Update]]
* [[U-Boot quick reference]]
* [[U-Boot images]]
* [http://www.denx.de/wiki/U-Boot/Documentation U-Boot documentation]
* [http://processors.wiki.ti.com/index.php/SD/MMC_format_for_OMAP3_boot SD/MMC format for OMAP3 boot]

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

CM-T3517: Building Firmware Images - Revision history

Grinberg: /* Getting X-Loader sources */