View source for The bootloader U-Boot

__TOC__

==Overview==
<span style="color: #000000;">This page is meant to be a starting point for people to learn build a u-boot image and show to people the current status of different u-boot versions for IGEP Processor Boards.</span>

===<span style="color: #000000;">What is U-Boot?</span>===
<span style="color: #000000;">[http://www.denx.de/wiki/U-Boot/ Das U-Boot] (Universal Bootloader) is an open source, primary boot loader used in embedded devices. Its primary purpose in the shipping system is to load some operating system.</span>

<span style="color: #000000;">That means that U-Boot is necessary to perform a certain task, but it's nothing you want to throw any significant resources at. Typically U-Boot is stored in relatively small NOR flash memory, which is expensive compared to the much larger NAND devices often used to store the operating system and the application.</span>



==Necessary package==
In order to compile the u-boot it is '''necessary''' to set up the Cross Compiler correctly. In this [[Set Up the Cross Compiler|post]] it is detailed how to set up correctly the Cross Compiler (and the desired version).

{{Message/Information Message|message=The following steps has been tested using '''Ubuntu 16.04''' and the '''4.9 version''' of the '''arm-linux-'''<span class="mw-headline">'''gnueabihf''' compiler</span>}}

In order to install the Compiler we can use this command:

 sudo apt install gcc-arm-linux-gnueabihf
==Download U-Boot Source==
 First of all, will be a distintion between '''NXP'''-processors products and '''ARM'''-processors products. Because there are different kinds of U-Boot depending of each processor.

{| class="contenttable sortable" style="width: 887px;"
|-
! style="width: 344px;"|<span style="color: #000000;">'''Commercial Name'''</span>
! style="width: 527px;"|<span style="color: #000000;">'''U-Boot Series'''</span>
|-
| style="width: 344px;"|<span style="color: #000000;">IGEPv2 DM3730</span>
| style="width: 527px;"|<span dir="auto">U-boot-ARM</span>
|-
| style="width: 344px;"|<span style="color: #000000;">IGEP COM MODULE </span>DM3730/AM3703
| style="width: 527px;"|<span dir="auto">U-boot-ARM</span> 
|-
| style="width: 344px;"|<span style="color: #000000;">IGEP COM AQUILA AM335x</span>
| style="width: 527px;"|<span style="color: #000000;"><span dir="auto">U-boot-ARM</span> </span>
|-
| style="width: 344px;"|<span style="color: #000000;">IGEPv5 OMAP5432</span>
| style="width: 527px;"|<span dir="auto">U-boot-ARM</span> 
|-
| style="width: 344px;"|<span style="color: #000000;">IGEP SMARC AM335x</span>
| style="width: 527px;"|<span dir="auto">U-boot-ARM</span> 
|-
| style="width: 344px;"|<span style="color: #000000;">IGEP SMARC iMX6 </span>
| style="width: 527px;"|<span dir="auto">U-boot-</span>Freescale-NXP
|}

* Once we know which U-Boot have we will clone the corresponding git repository.


====<span dir="auto">U-Boot '''ARM''' Series</span>====
: If we have an ARM series we will follow this table to get our source of U-Boot
{| class="contenttable sortable" style="width: 881px; height: 298px;"
|- style="height: 16.5781px;"
! style="width: 855px; height: 16.5781px; text-align: center; vertical-align: middle;" colspan="2"|'''Downloading binary files/U-Boot Source'''
|- style="height: 44px;"
! style="background-color: #ffffff; width: 225px; height: 44px;"|'''<span id="Clone_the_u-boot_repo" class="mw-headline">Clone the u-boot repository</span>'''
| style="width: 621px; height: 44px;"|
Clone the u-boot repository using git address:

<span style="color: #000000;"><code>git clone git@git.isee.biz:arm-boot/u-boot-arm.git</code> </span>

or

<span style="color: #000000;"> <code>git clone [https://git.isee.biz/arm-boot/u-boot-arm.git https][https://git.isee.biz/arm-boot/u-boot-arm.git ://git.isee.biz/arm-boot/u-boot-arm.git]</code></span>

|- style="height: 110px;"
! style="background-color: #ffffff; width: 225px; height: 110px;"|<span id="Checkout_u-boot_repo" class="mw-headline">Checkout u-boot repository</span>
| style="width: 621px; height: 110px;"|
Go to the u-boot-arm directory and checkout the isee_v2017.03 as:

<span style="color: #002d87;"><code><span style="color: #002d87;"><span style="color: #000000;">cd u-boot-arm</span></span></code></span>

<span style="color: #000000;"><code>git checkout remotes/origin/isee_v2017.03 -b isee_v2017.03 </code></span>

|}


====<span dir="auto">U-Boot '''Freescale-NXP'''  Serie</span>====
<div class="clearfix">
: If we have an Freescale-NXP series we will follow this table to get our source of U-Boot
</div>
{| class="contenttable sortable" style="width: 883px; height: 263px;"
|- style="height: 22px;"
! style="width: 849px; height: 22px; text-align: center; vertical-align: middle;" colspan="2"|'''Downloading binary files/U-Boot Source'''
|- style="height: 44px;"
! style="background-color: #ffffff; width: 223px;"|'''<span id="Clone_the_u-boot_repo" class="mw-headline">Clone the u-boot repository</span>'''
| style="width: 626px; height: 44px;"|
<span style="color: #000000;">Clone the u-boot repository using git address:</span>

<span style="color: #000000;"><code>git clone git@git.isee.biz:arm-boot/u-boot-imx.git</code></span>

<span style="color: #000000;">or</span>

<span style="color: #000000;"> <code>git clone [https://git.isee.biz/arm-boot/u-boot-imx.git https://git.isee.biz/arm-boot/u-boot-imx.git]</code></span>

|- style="height: 89px;"
! style="background-color: #ffffff; width: 223px;"|'''<span id="Checkout_u-boot_repo" class="mw-headline">Checkout u-boot repository</span>'''
| style="width: 626px; height: 89px;"|
<span style="color: #000000;">Go to the u-boot-imx directory and checkout the isee_imx_v2017.03.y as:</span>

<span style="color: #000000;"><code>cd u-boot-imx</code></span>

<span style="color: #000000;"><code>git checkout remotes/origin/isee_imx_v2017.03_4.9.11_1.0.0_ga -b isee_imx_v2017.03_4.9.11_1.0.0_ga </code></span>

|}

==Prepare your U-BOOT==
Once we have downloaded the U-Boot source. We will '''execute''' the file called '''defconfig''' (default configuration) that it variates in function of each model.

In order to load the default configuration of the target board, we have to write the following command:

 <span style="color: #000000;"> make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- [your_defconfig]</span>
* In the following table it can be found the name of each default configuration associated to each IGEP PROCESSORS BOARDS:



{| class="contenttable sortable" style="width: 872px; height: 317px;"
|-
! style="width: 196px;"|Module
! style="width: 10px;"|Defconfig
! style="width: 644px;"|Example
|-
| style="width: 196px;"|IGEPv2 DM3730
| style="width: 10px;"|igep0020_defconfig
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0020_defconfig</code></span>
|-
| style="width: 196px;"|IGEP COM MODULE DM3730/AM3703
| style="width: 10px;"|igep0030_defconfig
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0030_defconfig</code></span>
|-
| style="width: 196px;"|IGEP COM AQUILA AM335x
| style="width: 10px;"|
am335x_igep0033_defconfig

| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0033_defconfig</code></span>
|-
| style="width: 196px;"|IGEPv5 OMAP5432
| style="width: 10px;"| 
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-</code></span>
|-
| style="width: 196px;"|IGEP SMARC AM335x
| style="width: 10px;"|am335x_igep0034_defconfig
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig</code></span>
|-
| style="width: 196px;"|IGEP SMARC iMX6 Solo/Dual Lite
| style="width: 10px;"|igep0046_imx6dl_2G_defconfig
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6dl_2G_defconfig</code></span>
|-
| style="width: 196px;"|IGEP SMARC iMX6 Dual/ Quad
| style="width: 10px;"|igep0046_imx6q_2G_defconfig
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6q_2G_defconfig</code></span>
|}


==Build your U-BOOT==
After running the defconfig. You can build the U-Boot by executing this command:

 <span style="color: #000000;">  make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-</span>
Once the compile process has sucesfully finished, we will find the resulting files inside the u-boot root folder. Depending on the processor the generated files will be different:

* The result for '''ARM''' processor based board will be a '''MLO''' and '''u-boot.img'''.
* The result for '''Freescale'''-'''NXP'''<strong style="font-size: 0.939em;"> </strong><span style="font-size: 0.939em;">processor based will be a </span><strong style="font-size: 0.939em;">u-boot.imx.</strong>


Finally we can copy this file in a boot device, for example, a microSD Memory Card and power on the board.

{{Message/Information Message|title=TITLE|message= <span style="color: #000000;">In case of the Freescale-NXP Porcessor Boards, it is not possible to copy directly the u-boot.imx file. It is necessary to copy in the first blocks of the boot device using the dd command. It is explained in the following link.</span>}}



===<span id="What_next..." class="mw-headline">What next...</span>===
After build u-boot you can use it for boot the board, exist several options for boot, check the Hardware Reference Manual about the options available for your board.

* [[How to boot from MicroSD Card|Boot from MicroSD Card.]]
* [[How to Flash the System into the NAND/eMMC|Boot from NAND/eMMC flash.]]

<span style="color: #999999;">[[Category:Boot_loaders]]</span>