__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>
==Necessary package==
{| class="contenttable sortable"|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 & Prepare your U-BOOTBoot Source== will First of all, will be a distintion between '''NXP '''-processors products ( IGEP SMARC iMX6) and Texas '''ARM'''-processors products. Because there are different kinds of U-Boot depending of each processor.
{| class="contenttable sortable" style="width: 888px887px;"|-! style="width: 513px;"|<span style="color: #999999;">'''Commercial Name'''</span>! style="width: 358px;"|<span style="color: #999999;">'''Technical name'''</span>|-| style="background-color: #f2f2f2; text-align: center; width: 871px;" colspan="2"|<span style="color: #999999;">'''Texas instruments'''</span>
|-
| ! style="width: 513px344px;"|<span style="color: #999999000000;">IGEPv2'''Commercial Name'''</span>| ! style="width: 358px527px;"|<span style="color: #999999000000;">IGEP0020, DM3730'''U-Boot Series'''</span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEP COM MODULEIGEPv2 DM3730</span>| style="width: 358px527px;"|<span styledir="color: #999999;auto">IGEP0030, DM3730U-boot-ARM</span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEP COM PROTONMODULE </span>DM3730/AM3703| style="width: 358px527px;"|<span styledir="color: #999999;auto">IGEP0032, OMAP3530U-boot-ARM</span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEP COM AQUILAAQUILA AM335x</span>| style="width: 358px527px;"|<span style="color: #999999000000;">IGEP0033, AM335x<span dir="auto">U-boot-ARM</span> </span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEPv5IGEPv5 OMAP5432</span>| style="width: 358px527px;"|<span styledir="color: #999999;auto">IGEP0050, OMAP5U-boot-ARM</span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEP SMARC AM335x</span>| style="width: 358px527px;"|<span styledir="color: #999999;auto">IGEP0034, AM335xU-boot-ARM</span>
|-
| style="width: 513px344px;"|<span style="color: #999999000000;">IGEP SMARC AM335x LiteiMX6 </span>| style="width: 358px527px;"|<span styledir="color: #999999;auto">IGEP0034, Lite, AM335x</span>|U-| style="backgroundboot-color: #f2f2f2; text-align: center; width: 871px;" colspan="2"|</span style="color: #999999;">'''Freescale-NXP'''</span>|-| style="width: 513px;"|<span style="color: #999999;">IGEP SMARC iMX6 Solo</span>| style="width: 358px;"|<span style="color: #999999;">IGEP0046, IMX6XX</span>|-| style="width: 513px;"|<span style="color: #999999;">IGEP SMARC iMX6 Dual Lite</span>| style="width: 358px;"|<span style="color: #999999;">IGEP0046, iMX6DL</span>|-| style="width: 513px;"|<span style="color: #999999;">IGEP SMARC iMX6 Dual</span>| style="width: 358px;"|<span style="color: #999999;">IGEP0046, iMX6XX</span>|-| style="width: 513px;"|<span style="color: #999999;">IGEP SMARC iMX6 Quad</span>| style="width: 358px;"|<span style="color: #999999;">IGEP0046, iMX6Q</span>
|}
* Once we know which U-Boot have we will clone the corresponding git repository.
====<span dir="auto">U-Boot '''Texas InstrumentsARM''' Series</span>====<div class="clearfix">First : If we have an ARM series we will download the follow this table to get our source of U-Boot file for be able to make the configuration.</div><div class="clearfix"></div>{| class="contenttable sortable" style="width: 882px881px; height: 298px;"|- style="height: 2816.0313px5781px;"! style="width: 854px855px; height: 2816.0313px5781px; text-align: center; vertical-align: middle;" colspan="2"|===='''Downloading binary files====/U-Boot Source'''|- style="height: 31px44px;"! style="background-color: #ffffff; heightwidth: 31px225px; widthheight: 214px44px;"|'''<span id="Clone_the_u-boot_repo" class="mw-headline">Clone the u-boot reporepository</span>'''| style="width: 540px621px; height: 31px44px;"|
Clone the u-boot repository using git address:
<span style="color: #002d87000000;"><code><span style="color: #002d87;">$ git clone git@git.isee.biz:arm-boot/u-boot-arm.git</span></code> </span>
or
<code><span style="color: #002d87000000;">$ git clone </spancode> 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; width: 214px;"|'''<span id="Checkout_u-boot_repo" class="mw-headline">Checkout u-boot repo repository</span>'''| style="width: 640px621px; height: 110px;"|Go to the u-boot-arm directory and checkout the isee_v2017.03 as: <span style="color: #002d87;">$ cd u-boot-arm<br>$ git checkout remotes/origin/isee_v2017.03 -b isee_v2017.03</span>|}
===<span dir="auto">U-Boot '''Freescale-NXP iMX6''' Series</span>===<div class="clearfix">First we will download the U-Boot file for be able to make the configuration.</div>{| class="contenttable sortable" style="font-size: 15.024px; width: 881px;"|- style="height: 22px;"! style="width: 851px; height: 22px; text-align: center; vertical-align: middle;" colspan="2"|====Downloading binary files====|- style="height: 44px;"! style="background-color: #ffffff; width: 205px002d87;"|'''<span id="Clone_the_u-boot_repo" class="mw-headline">Clone the u-boot repo</spancode>'''| style="width: 646px; height: 44px;"|Clone the u-boot repository using git address:<span style="color: #002d87;"><code><span style="color: #002d87000000;">$ git clone git@git.isee.biz:arm-boot/cd u-boot-imx.gitarm</span></span></code></span> or
<code><span style="color: #002d87000000;">$ git clone</spancode> [https://git.isee.bizcheckout remotes/arm-bootorigin/u-boot-imxisee_v2017.git https://git.isee.biz/arm03 -boot/u-boot-imxb isee_v2017.git]03 </code></span>
|- style="height: 89px;"
! style="background-color: #ffffff; width: 205px;"|'''<span id="Checkout_u-boot_repo" class="mw-headline">Checkout u-boot repo </span>'''
| style="width: 646px; height: 89px;"|
Go to the u-boot-imx directory and checkout the version 2015.04.y as:
<span style="color: #002d87;">$ cd u-boot-imx</span><br><span style="color: #002d87;">$ 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</span>
|}
Once we have downloaded we will execute the file called '''defconfig,''' that it variates in function of each model.
====<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>
{| class="contenttable sortable" style="width: 885px; height: 1296px;"|-! style="width: 854px; text-align: center; vertical-align: middle;" colspan="3"|===<span id="Set_the_board_configuration" class="mw-headline">Set the board</span><span id="Set_the_board_configuration" class="mw-headline"> configuratio</span><span id="Set_the_board_configuration" class="mw-headline">n('''Prepare your U-BOOT''')</span>===|-! style="background-color: #f2f2f2; width: 209px;"|Model! style="background-color: #f2f2f2; width: 148px;"|U-BOOT Version! style="width: 497px; background-color: #f2f2f2;"|Example|-! style="background-color: #ffffff; width: 209px;"|IGEPv2| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"| u-boot-ARM| style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0020_defconfig</span>|-! style="background-color: #ffffff; width: 209px;"|IGEP COM Module | style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0030_defconfig </span>|-! style="background-color: #ffffff; width: 209px;"|IGEP COM PROTON | style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0032_defconfig</span>|-! style="background-color: #ffffff; width: 209px000000;"|IGEP COM AQUILA | style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0033_defconfig</span>|-! style="background-color: #ffffff; width: 209px;"|IGEPv5| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">----</span>|-! style="background-color: #ffffff; width: 209px;"|IGEP SMARC AM335x | style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig</span>|-! style="background-color: #ffffff; width: 209px;"|IGEP SMARC AM335x Lite| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-ARM | style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_lite_defconfig</span>|-! style="background-color: #ffffff; width: 209px;"|'''IGEP0046 SMARC Solo'''| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-IMX| style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- xxxxx </span>|-! style="background-color: #ffffff; width: 209px;"|'''IGEP0046 SMARC Dual lite'''| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-IMX| style="width: 497px;"| <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6dl_2G_defconfig</span><span style="color: #002d87;"> </span>|-! style="background-color: #ffffff; width: 209px;"| '''IGEP0046 SMARC Dual '''| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-IMX| style="width: 497px;"|<span style="color: #002d87;"> </span> <span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- xxxxx</span><span style="color: #002d87;"> </span>|-! style="background-color: #ffffff; width: 209px;"| '''IGEP0046 SMARC Quad'''| style="background-color: #ffffff; width: 148px; text-align: center; vertical-align: middle;"|u-boot-IMX| style="width: 497px;"| <span style="color: #002d87;"> $ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6q_2G_defconfig</span>|} ====<span id="Build_u-boot" class="mw-headline">Build u-boot</span>====You can build u-boot executing this command: <span style="color: #002d87;"><code><span style="color: #002d87;">$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-</span></code>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>
* The result for '''Texas Instruments''' processor based board will be a '''MLO''' and '''u-boot.img'''.* The result for <strong style="font-size: 0.939em;">iMX6 </strong><span style="font-sizecolor: 0.939em#000000;">processor based will be a </span><strong style="font-size: 0.939em;"code>cd u-boot.-imx.</strongcode></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>
You can install these files, for example, in the boot partition of a SD-card. |}
==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:
===<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.]]* Boot from NAND flash.* Boot from eMMC.* Boot from USB.* Boot from Network. ==<span style="color: #999999;">Configurations files</span>==<span style="color: #999999;">The result for '''iMX6 '''processor based will be a '''u-boot.imx.'''</span> {| class="contenttable sortable" style="font-sizewidth: 15.024px872px; widthheight: 889px317px;"
|-
! style="width: 361px196px;"|<span Module! style="colorwidth: #99999910px;">Modules</span>|Defconfig! style="width: 361px644px;"|<span style="color: #999999;">Files</span>Example
|-
! | style="background-color: #ffffff; width: 361px; text-align: left196px;"|<span IGEPv2 DM3730| style="colorwidth: #99999910px;">IGEP0046 SMARC iMX6 Duallite 2GB</span>|igep0020_defconfig| style="background-color: #ffffff; width: 361px; text-align: left644px;"|<span style="color: #999999000000;">igep0046_imx6dl_2G_defconfig <code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0020_defconfig</code></span>
|-
! | style="background-colorwidth: #ffffff196px; "|IGEP COM MODULE DM3730/AM3703| style="width: 361px10px; text-align"|igep0030_defconfig| style="width: left644px;"|<span style="color: #999999000000;">IGEP0046 SMARC iMX6 DUAL</spancode>| stylemake ARCH=arm CROSS_COMPILE="backgroundarm-linux-color: #ffffff; width: 361px; textgnueabihf-align: left;"| igep0030_defconfig</code></span>
|-
! style="background-color: #ffffff; width: 361px; text-align: left;"|<span style="color: #999999;">IGEP0046 SMARC iMX6 QUAD</span>| style="background-color: #ffffff; width: 361px; text-align: left196px;"|<span style="color: #999999;">igep0046_imx6q_2G_defconfig''' '''</span>IGEP COM AQUILA AM335x|-! style="background-color: #ffffff; width: 361px; text-align: left10px;"|<span style="color: #999999;">'''IGEP0046 SMARC iMX6 SOLO'''</span>| style="background-color: #ffffff; width: 361px; text-align: left;"| |}am335x_igep0033_defconfig
<span style="color: #999999;">The result for '''Texas Instruments''' processor based board will be a '''MLO''' and '''u-boot.img'''. (COMPROVAR)</span> {| class="contenttable sortable" style="width: 889px;"|-! style="width: 358px644px;"|<span style="color: #999999000000;">Modules</spancode>! stylemake ARCH="width: 513px;"|<span stylearm CROSS_COMPILE="color: #999999;">"Files"</span>|arm-! style="backgroundlinux-color: #ffffff; textgnueabihf-align: left;"|<span style="color: #999999;">IGEP0030 DM3730 Module am335x_igep0033_defconfig</span>| style="width: 513px;"|<span style="color: #999999;">igep0030_defconfig</span>|-! style="background-color: #ffffff; text-align: left;"|<span style="color: #999999;">IGEP0020 DM3730 IGEPv2</span>| style="width: 513px;"|<span style="color: #999999;"code>igep0020_defconfig</span>
|-
! | style="background-color: #ffffff; text-alignwidth: left196px;"|<span IGEPv5 OMAP5432| style="colorwidth: #99999910px;">IGEP0033 AM335x AQUILA Module</span>| | style="width: 513px644px;"|<span style="color: #999999000000;">am335x_igep0033_defconfig<code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-</code></span>
|-
! | style="background-color: #ffffff; text-alignwidth: left196px;"|<span IGEP SMARC AM335x| style="colorwidth: #99999910px;">IGEP0032 OMAP3530 PROTON Module</span>|am335x_igep0034_defconfig| style="width: 513px644px;"|<span style="color: #999999000000;">igep0032_defconfig<code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig</code></span>
|-
! | style="background-colorwidth: #ffffff; text-align: left196px;"|<span IGEP SMARC iMX6 Solo/Dual Lite| style="colorwidth: #99999910px;">IGEP0034 SMARC AM335x Module</span>|igep0046_imx6dl_2G_defconfig| style="width: 513px644px;"|<span style="color: #999999000000;">am335x_igep0034_defconfig<code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6dl_2G_defconfig</code></span>
|-
! | style="background-colorwidth: #ffffff; text-align: left196px;"|<span IGEP SMARC iMX6 Dual/ Quad| style="colorwidth: #99999910px;">IGEP0034 SMARC AM335x Module lite</span>|igep0046_imx6q_2G_defconfig| style="width: 513px644px;"|<span style="color: #999999000000;"> am335x_igep0034_lite_defconfig<code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6q_2G_defconfig</code></span>
|-
! | style="backgroundwidth: 196px;"|IGEP SMARC iMX6 Ultra-Lite / Ultra Ultra-colorLite| style="width: #ffffff10px; text-align"|igep0146_imx6ul_512M_defconfig| style="width: left644px;"|<span style="color: #999999000000;">IGEP0050 OMAP5 IGEPv5<code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0146_imx6ul_512M_defconfig<br /></code></span>| style="width: 513px;"|
|}
<span style="font=Build your U-size: 28BOOT==After running the defconfig.2451px; color: #000000;">Stable You can build the U-Boot</span>by executing this command: <span style="color: #000000;">The software git repository is located [https://git.isee.biz/ make ARCH=arm-boot here].</span><span styleCROSS_COMPILE="color: #000000;">U-boot: OMAP3 boards, OMAP5 boards, AM335x boards is located [https://git.isee.biz/arm-boot/ulinux-bootgnueabihf-arm here].</span><span style="color: #000000;">U-boot: iMX6 boards is located [https://git.isee.biz/arm-boot/Once the compile process has sucesfully finished, we will find the resulting files inside the u-boot-imx here]root folder.</span><span style="color: #000000;">u-boot firmware binaries can Depending on the processor the generated files will be downloaded from here.</span><span style="colordifferent: #000000;">[EOL] For OMAP3 based platforms, ISEE do not support u-boot, instead of, ISEE provides [[The IGEP X-loader]]</span>
=<span style="color: #999999;">How to cross compile the U-Boot</span>=<div style="font-size: 15.024px;"><span style="color: #999999;">In order to compile * The result for '''ARM''' processor based board will be a '''MLO''' and build the U'''u-Boot for IGEP PROCESSOR BOARDS you should set the CROSS_COMPILE variableboot. Set this to the prefix of your toolchain (including the trailing dash "-")img'''. So if your toolchain is invoked as say * The result for '''Freescale'''arm-linux-gnueabi-gcc''', just chop off that trailing gcc and thatNXP'''s what you use: arm-linux-gnueabihf-.</span></div><div strong style="font-size: 150.024px;"><span style="color: #999999939em;">As example, once you've downloaded the u-boot source, you should follow these steps:</span> </divstrong> <span style="color: #999999;">make CROSS_COMPILE=[cross compiler] [board config] make CROSS_COMPILE=[cross compiler]</span><div style="font-size: 150.024px939em;"><span style="color: #999999;">The result processor based will be a MLO and a u-boot.img file. You can install these files, for example, in the boot partition of a SD-card.a </span></div>==<span strong style="color: #999999;">ufont-boot Freescale-NXP iMX6 series</span>==* <span style="colorsize: #9999990.939em;">[[U-boot Freescale-NXP iMX6 Series|u-boot Freescale-NXP iMX6 Series]].imx.</spanstrong>
==<span style="color: #999999;">u-boot Texas Instruments AM335x, OMAP3, DM3730, OMAP5432 series</span>==
* <span style="color: #999999;">[[u-boot_Texas_Instruments_Series|u-boot Texas Instruments Series]]</span>
<span style="color: #999999;">Finally we can copy this files in a '''boot device''', for example, a microSD Memory Card. It is explained in the following [[Category:U-BootHow to prepare a bootable MicroSD Card|post]]</span>.
''''''Bold text''''''{{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 post [[How to prepare a bootable MicroSD Card|How to prepare a bootable MicroSD Card]].</span>}} ===<span id="What_next..." class="mw-headline">What next...</span>===After build u-boot you have to download and compile [[Linux Kernel 4.9.y|kernel]]
