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

imported>Uri.mashiach at 08:31, 9 August 2022

2022-08-09T08:31:14Z

Urim at 16:44, 15 February 2016

2016-02-15T16:44:02Z

Igor: /* Overview */

2014-11-04T11:47:44Z

‎Overview

Ilya: /* Building the firmware images */

2014-09-07T12:26:50Z

‎Building the firmware images

Nikita: /* See also */

2014-06-11T13:09:17Z

‎See also

Grinberg: /* Building the firmware images */

2014-04-02T12:46:50Z

‎Building the firmware images

Grinberg: /* Getting U-Boot sources */

2013-11-11T13:06:52Z

‎Getting U-Boot sources

New page

== Overview ==
CM-T335 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 AM335x 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-T335 ==
=== 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-T335 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-t335/u-boot}} directory for CM-T335 u-boot development.

==== Snapshot download ====
* Download [http://git.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=snapshot;h=183acb700378a8cfc5d50a01a65de93fb2c24586;sf=tbz2 v2013.10] snapshot with your web browser.
* Extract the downloaded archive {{filename|u-boot-183acb700378a8cfc5d50a01a65de93fb2c24586.tar.bz2}}
<pre>
cd /home/development/cm-t335/u-boot
tar xvf /path/to/downloaded/u-boot-183acb700378a8cfc5d50a01a65de93fb2c24586.tar.bz2
mv u-boot u-boot-cm-t335
</pre>
: This will create {{filename|/home/development/cm-t335/u-boot/u-boot-cm-t335}} directory containing U-Boot source code tree.
* Apply the CM-T335 patch
<pre>
cd /home/development/cm-t335/u-boot/u-boot-cm-t335
patch -p1 < /path/to/cm-t335-u-boot/u-boot/u-boot-v2013.10-cm-t335-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-t335/u-boot
git clone git://git.denx.de/u-boot.git u-boot-cm-t335
</pre>
* Create a branch for CM-T335 development. The CM-T335 patches are generated vs. v2013.10 tag (183acb700378a8cfc5d50a01a65de93fb2c24586 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
<pre>
git checkout -b cm-t335-dev v2013.10
</pre>
* Apply the CM-T335 patch
<pre>
cd /home/development/cm-t335/u-boot/u-boot-cm-t335
git apply /path/to/cm-t335-u-boot/u-boot/u-boot-v2013.10-cm-t335-1.patch
</pre>

=== Building the firmware images ===
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-eabi-
make mrproper
make cm_t335
</pre>

In the example above, CM-T335 firmware images for SPL ({{filename|MLO}}) and U-Boot ({{filename|u-boot.img}}) will be created in {{filename|/home/development/cm-t335/u-boot/u-boot-cm-t335}}.

== See also ==

* [[U-Boot quick reference]]
* [[U-Boot images]]
* [http://www.emlinews.net/2012/10/u-boot-spl-framework-becomes-generic/ U-Boot SPL framework]
* [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-T335]]

@@ Line 10: / Line 10: @@
 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]
+** [https://releases.linaro.org/components/toolchain/binaries/4.9-2017.01/arm-linux-gnueabihf/ Linaro 4.9-2017.01]
 * Tools for creating cross-compilers:
 ** [http://crosstool-ng.org/ Crosstool-ng]: Builds a cross-compiler from source. Non-distribution specific.
@@ Line 32: / Line 32: @@
 <pre>
 cd /home/development/cm-t335/u-boot/u-boot-cm-t335
-patch -p1 < /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.3.patch
+patch -p1 < /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.4.patch
 </pre>
@@ Line 49: / Line 49: @@
 <pre>
 cd /home/development/cm-t335/u-boot/u-boot-cm-t335
-git apply /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.3.patch
+git apply /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.4.patch
 </pre>

@@ Line 1: / Line 1: @@
 == Overview ==
-CM-T335 firmware consists of two components: Secondary Program Loader (SPL) and U-Boot.
+The CompuLab CM-T335 System-on-Module / Computer-on-Module 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 AM335x SoC.

@@ Line 21: / Line 21: @@
 ==== Snapshot download ====
-* Download [http://git.denx.de/?p=u-boot.git;a=snapshot;h=b44bd2c73c4cfb6e3b9e7f8cf987e8e39aa74a0b;sf=tbz2 v2014.01] snapshot with your web browser.
+* Download [http://git.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=snapshot;h=dda0dbfc69f3d560c87f5be85f127ed862ea6721;sf=tbz2 v2014.04] snapshot with your web browser.
-* Extract the downloaded archive {{filename|u-boot-b44bd2c73c4cfb6e3b9e7f8cf987e8e39aa74a0b.tar.bz2}}
+* Extract the downloaded archive {{filename|u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2}}
 <pre>
 cd /home/development/cm-t335/u-boot
-tar xvf /path/to/downloaded/u-boot-b44bd2c73c4cfb6e3b9e7f8cf987e8e39aa74a0b.tar.bz2
+tar xvf /path/to/downloaded/u-boot-dda0dbfc69f3d560c87f5be85f127ed862ea6721.tar.bz2
 mv u-boot u-boot-cm-t335
 </pre>
@@ Line 32: / Line 32: @@
 <pre>
 cd /home/development/cm-t335/u-boot/u-boot-cm-t335
-patch -p1 < /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.01-cm-t335-2.patch
+patch -p1 < /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.2.patch
 </pre>
@@ Line 42: / Line 42: @@
 git clone git://git.denx.de/u-boot.git u-boot-cm-t335
 </pre>
-* Create a branch for CM-T335 development. The CM-T335 patches are generated vs. v2014.01 tag (b44bd2c73c4cfb6e3b9e7f8cf987e8e39aa74a0b commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
+* Create a branch for CM-T335 development. The CM-T335 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-t335-dev v2014.01
+git checkout -b cm-t335-dev v2014.04
 </pre>
 * Apply the CM-T335 patch
 <pre>
 cd /home/development/cm-t335/u-boot/u-boot-cm-t335
-git apply /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.01-cm-t335-2.patch
+git apply /path/to/cm-t335-u-boot/u-boot/u-boot-v2014.04-cm-t335-2.2.patch
 </pre>
 === Building the firmware images ===
 <pre>
 export ARCH=arm

@@ Line 66: / Line 66: @@
 * [[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]