CL-SOM-AM57x: U-Boot: Building Images - Revision history

Urim at 10:21, 4 June 2017

2017-06-04T10:21:04Z

Urim: /* Snapshot download */

2017-03-16T11:53:06Z

‎Snapshot download

Urim at 16:24, 9 March 2017

2017-03-09T16:24:55Z

Urim: /* Git clone */

2017-03-05T11:55:13Z

‎Git clone

New page

== Overview ==
The CompuLab CL-SOM-AM57x 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 AM57x 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 CL-SOM-AM57x ==
=== Getting U-Boot sources ===
There are two ways to get U-Boot sources that can be used as a baseline for CL-SOM-AM57x 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/cl-som-am57x/u-boot}} directory for CL-SOM-AM57x u-boot development.

==== Snapshot download ====
* Download [http://git.denx.de/cgi-bin/gitweb.cgi?p=u-boot.git;a=snapshot;h=a705ebc81b7f91bbd0ef7c634284208342901149;sf=tgz v2017.01] snapshot with your web browser.
* Extract the downloaded archive {{filename|u-boot-a705ebc.tar.gz}}
<pre>
cd /home/development/cl-som-am57x/u-boot
tar xvf /path/to/downloaded/u-boot-a705ebc.tar.gz
mv u-boot u-boot-cl-som-am57x
</pre>
: This will create {{filename|/home/development/cl-som-am57x/u-boot/u-boot-cl-som-am57x}} directory containing U-Boot source code tree.
* Apply the CL-SOM-AM57x patch
<pre>
cd /home/development/cl-som-am57x/u-boot/u-boot-cl-som-am57x
patch -p1 < /path/to/cl-som-am57x-u-boot/u-boot/u-boot-v2017.01-cl-som-am57x-1.0.patch
</pre>

==== Git clone ====
* Install [http://git-scm.com/ git] version control system.
* Create a clone of U-Boot tree
<pre>
cd /home/development/cl-som-am57x/u-boot
git clone git://git.denx.de/u-boot.git u-boot-cl-som-am57x
</pre>
* Create a branch for CL-SOM-AM57x development. The CL-SOM-AM57x patches are generated vs. v2017.01 tag (a705ebc81b7f91bbd0ef7c634284208342901149 commit) in the U-Boot tree. It is recommended to use exactly the same baseline to avoid merge conflicts.
<pre>
cd u-boot-cl-som-am57x
git checkout -b cl-som-am57x-dev v2017.01
</pre>
* Apply the CL-SOM-AM57x patch
<pre>
git am ~/device/cl-som-am57x/package/cl-som-am57x-u-boot/u-boot/patches/*
</pre>

=== Building the firmware images ===
In this section we assume that any version of a toolchain is installed on a host machine and it's location is added to the PATH.
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-none-linux-eabi-
make mrproper
make cl-som-am57x_defconfig && make
</pre>

In the example above, CL-SOM-AM57x firmware images for SPL ({{filename|MLO}}) and U-Boot ({{filename|u-boot.img}}) will be created in {{filename|/home/development/cl-som-am57x/u-boot/u-boot-cl-som-am57x}}.

== See also ==

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

[[Category:U-Boot]]
[[Category:CL-SOM-AM57x]]

@@ Line 24: / Line 24: @@
 <pre>
 cd /home/development/cl-som-am57x/u-boot/u-boot-cl-som-am57x
-patch -p1 < /path/to/cl-som-am57x-u-boot/u-boot/u-boot-v2017.01-cl-som-am57x-1.1.patch
+patch -p1 < /path/to/cl-som-am57x-u-boot/u-boot/u-boot-v2017.01-cl-som-am57x-1.2.patch
 </pre>

@@ Line 4: / Line 4: @@
 SPL is the bootstrap utility invoked by the CPU internal boot ROM code of the AM57x 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.
+U-Boot initializes hardware modules necessary for system boot and loads the operating system.<br>
 == Building Firmware images for CL-SOM-AM57x ==
@@ Line 24: / Line 25: @@
 <pre>
 cd /home/development/cl-som-am57x/u-boot/u-boot-cl-som-am57x
-patch -p1 < /path/to/cl-som-am57x-u-boot/u-boot/u-boot-v2017.01-cl-som-am57x-1.2.patch
+patch -p1 < /path/to/cl-som-am57x-u-boot/u-boot/u-boot-v2017.01-cl-som-am57x-1.3.patch
 </pre>