Difference between revisions of "The bootloader U-Boot"

From IGEP - ISEE Wiki

Jump to: navigation, search
(→‎Download Binary package)
 
(124 intermediate revisions by 9 users not shown)
Line 1: Line 1:
−
<meta name="description" content="All you need to know about the U-Boot bootloader for IGEP Processor Boards. How to cross compile, get stable versions and get the latest development versions, etc."></meta>
+
__TOC__
−
<meta name="keywords" content="U-Boot, IGEP, ARM, OMAP3, AM335x, OMAP5"></meta>
 
  
−
= U-Boot for IGEP platforms =
+
==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>
  
−
This page contains information about the customized U-Boot provided by ISEE, as well as the mainline U-Boot. Both can be used on the IGEP platforms.
+
===<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>
  
−
== Environment Settings ==
+
<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>
  
−
First of all setup the build environment sourcing this script
 
−
<pre>
 
−
$ source /usr/local/poky/eabi-glibc/arm/environment-setup
 
−
</pre>
 
−
or
 
−
<pre>
 
−
$ source /usr/local/poky/eabi-glibc/environment-setup-arm-none-linux-gnueabi
 
−
</pre>
 
−
if you have updated your SDK environment to latest version (see [[Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine]])
 
  
−
== Mainline U-Boot, 2012.10 release ==
 
  
−
See the [[U-Boot Mainline Series]] article.
+
==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).
  
−
As of the 2012.10 release, mainline U-Boot has got SPL (Secondary Program Loader) integrated, which replaces X-Loader ('''not IGEP-X-Loader!''') in the [[Boot up sequence|boot sequence]].
+
{{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>}}
  
−
Download the source from the git repository:
+
In order to install the Compiler we can use this command:
  
−
  $ git clone git://git.denx.de/u-boot.git
+
  sudo apt install gcc-arm-linux-gnueabihf
−
$ cd u-boot
+
==Download U-Boot Source==
−
$ git checkout v2012.10 -b v2012.10-local
+
 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.
  
−
Configure for your board with
+
{| 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
 +
|}
  
−
$ make CROSS_COMPILE=arm-none-linux-gnueabi- <board-config>
+
* Once we know which U-Boot have we will clone the corresponding git repository.
  
−
where:
 
  
−
* <board-config> is igep0020_config for IGEP v2 platform.
+
====<span dir="auto">U-Boot '''ARM''' Series</span>====
−
* <board-config> is igep0030_config for OMAP3 IGEP module.
+
: 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:
  
−
Finally, build with
+
<span style="color: #000000;"> <code>git clone https://git.isee.biz/cgit/arm-boot/u-boot-arm.git</code></span>
  
−
$ make CROSS_COMPILE=arm-none-linux-gnueabi-  
+
|- 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:
  
−
The results will be a '''MLO''' and a '''u-boot.img''' file in the u-boot directory.
+
<span style="color: #002d87;"><code><span style="color: #002d87;"><span style="color: #000000;">cd u-boot-arm</span></span></code></span>
  
−
'''CAVEAT:''' Wifi is not set up in this version, the pin mux for the MMC2 interface needs to be configured first!
+
<span style="color: #000000;"><code>git checkout -b isee_v2017.03 origin/isee_v2017.03</code></span>
  
−
== U-Boot 2010.06-y series (stable) ==
+
|}
  
−
See the [[U-Boot 2010.06-y series]] article.
+
====<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 https://git.isee.biz/cgit/arm-boot/u-boot-imx.git</code></span>
  
−
Download the IGEP U-Boot sources and follow next steps:
+
|- 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>
  
−
Either download the sources from the git repository
+
<span style="color: #000000;"><code>cd u-boot-imx</code></span>
  
−
$ git clone git://git.isee.biz/pub/scm/u-boot-arm.git
+
<span style="color: #000000;"><code>git checkout 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>
−
$ cd u-boot-arm
 
−
$ git checkout v2010.06-3 -b v2010.06-3-local
 
  
−
Or get the snapshot from the downloads directory
+
|}
  
−
$ wget http://downloads.isee.biz/pub/SW_Releases/sources/u-boot-arm-2010.06-3.tar.gz
+
==Prepare your U-BOOT==
−
$ tar xzf u-boot-arm-2010.06-3.tar.gz
+
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.
−
$ cd u-boot-arm-2010.06-3
 
  
−
Configure for your board with,
+
In order to load the default configuration of the target board, we have to write the following command:
  
−
  $ make CROSS_COMPILE=arm-none-linux-gnueabi- <board-config>
+
  <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:
  
−
where:
 
  
−
* <board-config> is igep0020_config for IGEP v2 platform.
 
−
* <board-config> is igep0030_config for OMAP3 IGEP module.
 
  
−
Finally, build with
+
{| 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
  
−
$ make CROSS_COMPILE=arm-none-linux-gnueabi-  
+
| 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>
 +
|-
 +
| style="width: 196px;"|IGEP SMARC iMX6 Ultra-Lite / Ultra Ultra-Lite
 +
| style="width: 10px;"|igep0146_imx6ul_512M_defconfig
 +
| style="width: 644px;"|<span style="color: #000000;"><code>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0146_imx6ul_512M_defconfig<br /></code></span>
 +
|}
  
−
The result will be an u-boot.bin file in local directory.
+
==Build your U-BOOT==
 +
After running the defconfig. You can build the U-Boot by executing this command:
  
−
''' CHANGELOG '''
+
<span style="color: #000000;">  make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-</span>
−
* [http://git.igep.es/?p=pub/scm/u-boot-arm.git;a=commit;h=386abd9fa4656aea453a13b28f9c85ea53e07a8b 2011-07-29 Release 2010.06-3]
+
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:
−
** fix boot hang with DM37x and TPS65950 A3
 
−
* [http://git.igep.es/?p=pub/scm/u-boot-arm.git;a=commit;h=ccba4652f9d2bd32e76770661d5b5762631f2261 2011-03-07 Release 2010.06-2]
 
−
** Set MPU to 1GHz and IVA to 800MHz by default for DM3730
 
−
** Improve GPMC timming for SMSC LAN9221
 
−
* [http://git.igep.es/?p=pub/scm/u-boot-arm.git;a=commit;h=e99b5040053d8228b5d58b4542aadea859a37a07 2010-11-03 Release 2010.06-1]
 
−
** Improve I2C driver  support
 
−
** Use default NET_GPMC configuration to be compatible with DM37XX. This worsens a bit the SMSC LAN9221 throughput.
 
−
* [http://git.igep.es/?p=pub/scm/u-boot-arm.git;a=commit;h=6cf985486c5061e5e47586bf929bd2d1b73c6ef5 2010-10-19 Release 2010.06-0]
 
−
** Add support for DM37XX
 
  
−
''' KNOWN ISSUES '''
+
* The result for '''ARM''' processor based board will be a '''MLO''' and '''u-boot.img'''.
−
* This versions does not work if you use gcc 4.4 or upper.
+
* 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>
  
−
== U-Boot 2009.11-y series (stable) ==
 
  
−
See the [[U-Boot 2009.11-y series]] article.
+
Finally we can copy this files in a '''boot device''', for example, a microSD Memory Card. It is explained in the following [[How to prepare a bootable MicroSD Card|post]].
  
 +
{{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>}}
  
−
Download the IGEP U-Boot sources and follow next steps:
 
  
−
$ git clone git://git.isee.biz/pub/scm/u-boot-arm.git
 
−
$ cd u-boot-arm
 
−
$ git checkout v2009.11-2 -b v2009.11-2.local
 
  
−
Configure for your board with,
+
==Download Binary package==
 +
[http://downloads.isee.biz/ You can download binary packages from here.]
  
−
$ make CROSS_COMPILE=arm-none-linux-gnueabi- <board-config>
+
==<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]]
−
where:
 
−
 
 
−
* <board-config> is omap3_igep0020_config for IGEP v2 platform.
 
−
* <board-config> is omap3_igep0030_config for OMAP3 IGEP module.
 
−
 
 
−
Finally, build with
 
−
 
 
−
$ make CROSS_COMPILE=arm-none-linux-gnueabi-
 
−
 
 
−
The result will be an u-boot.bin file in local directory.
 
−
 
 
−
''' CHANGELOG '''
 
−
 
 
−
* [http://git.igep.es/?p=pub/scm/u-boot-arm.git;a=commit;h=10f386973ff68d604323b1e7787a0f3bd3b3c381 2010-06-15 Release 2009.11-2]
 
−
** improve SMSC LAN9221 throughput
 
−
** add support for OMAP3 IGEP module (igep0030)
 
−
 
 
−
[[Category:Boot loaders|Uboot]]
 

Latest revision as of 16:27, 12 October 2023

Overview

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.

What is 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.

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.


Necessary package

In order to compile the u-boot it is necessary to set up the Cross Compiler correctly. In this post it is detailed how to set up correctly the Cross Compiler (and the desired version).

Information.jpg The following steps has been tested using Ubuntu 16.04 and the 4.9 version of the arm-linux-gnueabihf compiler

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.

Commercial Name U-Boot Series
IGEPv2 DM3730 U-boot-ARM
IGEP COM MODULE DM3730/AM3703 U-boot-ARM 
IGEP COM AQUILA AM335x U-boot-ARM 
IGEPv5 OMAP5432 U-boot-ARM 
IGEP SMARC AM335x U-boot-ARM 
IGEP SMARC iMX6  U-boot-Freescale-NXP
  • Once we know which U-Boot have we will clone the corresponding git repository.


U-Boot ARM Series

If we have an ARM series we will follow this table to get our source of U-Boot
Downloading binary files/U-Boot Source
Clone the u-boot repository

Clone the u-boot repository using git address:

 git clone https://git.isee.biz/cgit/arm-boot/u-boot-arm.git

Checkout u-boot repository

Go to the u-boot-arm directory and checkout the isee_v2017.03 as:

cd u-boot-arm

git checkout -b isee_v2017.03 origin/isee_v2017.03

U-Boot Freescale-NXP  Serie

If we have an Freescale-NXP series we will follow this table to get our source of U-Boot
Downloading binary files/U-Boot Source
Clone the u-boot repository

Clone the u-boot repository using git address:

git clone https://git.isee.biz/cgit/arm-boot/u-boot-imx.git

Checkout u-boot repository

Go to the u-boot-imx directory and checkout the isee_imx_v2017.03.y as:

cd u-boot-imx

git checkout origin/isee_imx_v2017.03_4.9.11_1.0.0_ga -b isee_imx_v2017.03_4.9.11_1.0.0_ga 

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: 

 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- [your_defconfig]
  • In the following table it can be found the name of each default configuration associated to each IGEP PROCESSORS BOARDS:


Module Defconfig Example
IGEPv2 DM3730 igep0020_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0020_defconfig
IGEP COM MODULE DM3730/AM3703 igep0030_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0030_defconfig
IGEP COM AQUILA AM335x

am335x_igep0033_defconfig

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0033_defconfig
IGEPv5 OMAP5432   make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-
IGEP SMARC AM335x am335x_igep0034_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- am335x_igep0034_defconfig
IGEP SMARC iMX6 Solo/Dual Lite igep0046_imx6dl_2G_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6dl_2G_defconfig
IGEP SMARC iMX6 Dual/ Quad igep0046_imx6q_2G_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0046_imx6q_2G_defconfig
IGEP SMARC iMX6 Ultra-Lite / Ultra Ultra-Lite igep0146_imx6ul_512M_defconfig make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- igep0146_imx6ul_512M_defconfig

Build your U-BOOT

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

  make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-

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 processor based will be a u-boot.imx.


Finally we can copy this files in a boot device, for example, a microSD Memory Card. It is explained in the following post.

Information.jpg 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.


Download Binary package

You can download binary packages from here.

What next...

After build u-boot you have to download and compile kernel

Retrieved from "http://labs.isee.biz/index.php?title=The_bootloader_U-Boot&oldid=12228"