Lifshitz at 11:34, 11 August 2015

2015-08-11T11:34:13Z

Lifshitz: /* Building the firmware images */

2015-02-02T12:18:56Z

‎Building the firmware images

New page

== Overview ==
The CompuLab CM-A510 System-on-Module / Computer-on-Module firmware consists of two components: Binary Header and U-Boot.
Binary Header is the bootstrap utility invoked by the CPU internal boot ROM code of the 88AP510 SoC.
Binary Header performs DRAM initialization. U-Boot initializes hardware modules necessary for system boot and loads the operating system.

== Building Firmware images for CM-A510 ==
=== Cross-Compiler ===
CM-A510 firmware was compiled using Marvell Little Endian Cross Compiler, available at [https://extranet.marvell.com Marvell Extranet]

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

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

=== Building the firmware images ===

In this section we assume that Marvell Little Endian Cross Compiler is installed on a host machine and it's location is added to the PATH.
<pre>
export ARCH=arm
export CROSS_COMPILE=arm-marvell-linux-gnueabi-
make mrproper
</pre>

==== Building Binary Header ====

In order to compile a firmware Binary Header execute the following commands:

<pre>
cd tools/brom_bin_hdr/
make clean
make
</pre>

The resulting binary header file is: {{filename | tools/binary_hdr.bin}}

==== Configuring firmware build system ====

CM-A510 firmware build system should be configured properly to support various production option of the board.
To configure the build system, execute the following command:

<pre>
make cm_a510_config [OPTIONS]
</pre>

Where {{cmd | OPTIONS}} are defined as follows:

* DRAM size
** For 1G DDR3 installed on board add: DRAM=CM_A510_1G
** For 512M DDR3 installed on board add: DRAM=CM_A510_512M

* NAND
** If the board has NAND option add: NAND=1

Example of configuring a build system for 1G board with NAND:
<pre>
make cm_a510_config DRAM=CM_A510_1G NAND=1
</pre>

==== Compiling firmware images ====

After executing the {{cmd | make}} command:

<pre>
make
</pre>

the following binary images will be created:

* {{filename|u-boot-cm_a510_1G_spi.bin}} - U-Boot and Binary Header combined to a single binary, compatible for boot from SPI flash.
* {{filename|u-boot-cm_a510_1G_sata.bin}} - U-Boot binary, compatible for boot from SATA drive.
* {{filename|u-boot-cm_a510_1G_sata_header.bin}} - Binary Header, compatible for boot from SATA drive.

== 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-A510]]

@@ Line 25: / Line 25: @@
 <pre>
 cd /home/development/cm-a510/u-boot/u-boot-cm-a510
-patch -p1 < /path/to/cm-a510-u-boot/u-boot/u-boot-v2009.08-cm-a510-2.patch
+patch -p1 < /path/to/cm-a510-u-boot/u-boot/u-boot-v2009.08-cm-a510-3.patch
 </pre>
@@ Line 42: / Line 42: @@
 <pre>
 cd /home/development/cm-a510/u-boot/u-boot-cm-a510
-git apply /path/to/cm-a510-u-boot/u-boot/u-boot-v2009.08-cm-a510-2.patch
+git apply /path/to/cm-a510-u-boot/u-boot/u-boot-v2009.08-cm-a510-3.patch
 </pre>

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

Lifshitz at 11:34, 11 August 2015

Lifshitz: /* Building the firmware images */