Difference between revisions of "The bootloader X-loader"

From IGEP - ISEE Wiki

Jump to: navigation, search
(Feedback and Contributing)
m (X-loader v1.4.4-3 (stable))
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== How to cross compile X-loader ==
+
= X-loader for IGEP platforms =
  
=== Overview of How-To ===
+
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]])
 +
 
 +
= X-loader v1.4.4-3 (stable) =
 +
 
 +
Download the IGEP X-loader sources and follow next steps:
 +
 
 +
{{Message/Broken Links}}
 +
 
 +
$ wget http://downloads.igep.es/sources/x-loader-1.4.4-3.tar.gz
 +
$ tar xzf x-loader-1.4.4-3.tar.gz
 +
$ cd x-loader-1.4.4-3
 +
$ scripts/./autobuild.sh arm-none-linux-gnueabi-
 +
 
 +
The result will be :
 +
* For IGEP v2 platform
 +
**x-load-ddp.bin.ift in autobuild/igep0020/flash directory (for OneNAND DDP)
 +
**x-load.bin.ift in autobuild/igep0020/sdcard directory (for SD card)
 +
*For OMAP3 IGEP module
 +
**x-load-ddp.bin.ift in autobuild/igep0030/flash directory (for OneNAND DDP)
 +
**x-load.bin.ift in autobuild/igep0030/sdcard directory (for SD card)
 +
 
 +
= X-loader development  =
  
This How-To is meant to be a starting point for people to learn build the x-loader software for IGEP v2 devices as quickly and easily as possible.
+
<span style="color: rgb(255, 0, 0);">'''Note:''' The 'master' branch is where the development work takes place and you should use this if you're after to work with the latest cutting edge developments. It is possible trunk can suffer temporary periods of instability while new features are developed and if this is undesirable we recommend using one of the release branches. '''Use ONLY for development purposes.'''</span>
  
This How-To works with the Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine but most of the contents are valid also for other GNU/Linux distributions. We do not issue any guarantee that this will work on other distributions.
+
Clone the GIT repository from git.igep.es
 +
$ git clone git://git.igep.es/pub/scm/x-loader.git
 +
$ cd x-loader
 +
$ git checkout origin/for-next -b for-next
  
=== Requirements ===
+
and build with
 +
$ cd x-loader
 +
$ make CROSS_COMPILE=arm-none-linux-gnueabi- igep00x0_config
 +
$ make CROSS_COMPILE=arm-none-linux-gnueabi-
  
*'''Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine'''
+
The result will be :
 +
* x-load.bin.ift in ./ directory
  
=== Feedback and Contributing ===
+
= Quality assurance: Test Cases =
Creating articles in the wiki is a collaborative process, at any point, if you see a mistake you can contribute to this article.
 
  
Please, use the discussion tab for user comments. This is useful to separate page content and the discussion thereof and also, if you don't want to give normal users the right to edit the page but still want user contributed notes.
+
== Status table ==
  
Editing permissions are restricted to registered users. [http://www.igep.es Register in the main IGEP site] and you will have single sign-on.
+
== Test case definitions ==
  
Consult the [http://www.mediawiki.org/wiki/Help:Contents User's Guide] for information on using the wiki software.
+
''' #001 : SDCARD boot '''
  
There is a set of [[Wiki contribution guidelines]].
+
How to test: Put x-loader to sdcard and check if booting. Result should be like :
  
=== X-loader for IGEP v2 ===
+
Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
 +
Reading boot sector
 +
u-boot.bin not found or blank nand contents - attempting serial boot . . .
 +
## Ready for binary (kermit) download to 0x80008000 at 115200 bps...
 +
 
 +
''' #002 : Load u-boot from SD-card '''
 +
 
 +
How to test: Put x-loader and u-boot to SD-card and check if booting. Result should be like :
  
First of all setup the build environment sourcing this script
 
 
<pre>
 
<pre>
$ source /usr/local/poky/eabi-glibc/arm/environment-setup
+
Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
 +
Reading boot sector
 +
Loading u-boot.bin from mmc
 +
 
 +
U-Boot 2011.03-00406-gf92edd8 (May 05 2011 - 13:01:04)
 
</pre>
 
</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]])
 
  
==== X-loader v1.4.2-2 (stable) ====
+
''' #003 : ONENAND boot '''
 +
 
 +
How to test: Put x-loader to onenand and check if booting. Result should be like :
 +
 
 +
Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
 +
u-boot.bin not found or blank nand contents - attempting serial boot . . .
 +
## Ready for binary (kermit) download to 0x80008000 at 115200 bps...
 +
 
 +
Script : flash x-loader using u-boot
 +
 
 +
mmc rescan 0
 +
fatload mmc 0:1 0x80300000 mlo
 +
onenand erase 0 0x80000
 +
onenand write 0x80300000 0 0x80000
 +
 
 +
''' #004 : Load u-boot from onenand '''
  
This version supports full OneNAND DDP
+
How to test: Put x-loader and u-boot to SD-card and check if booting. Result should be like :
  
Download the IGEP v2 X-loader sources and follow next steps:
 
 
<pre>
 
<pre>
$ wget http://downloads.igep.es/sources/x-loader-1.4.2-2.tar.gz
+
Texas Instruments X-Loader 1.5.0 (May 19 2011 - 10:47:12)
$ tar xzf x-loader-1.4.2-2.tar.gz
+
Detected Numonyx OneNAND 4G Flash
$ cd x-loader-1.4.2-2
+
Loading u-boot.bin from onenand
$ scripts/./autobuild.sh arm-none-linux-gnueabi-
+
 
 +
U-Boot 2011.03-00532-g638a48e (May 19 2011 - 11:43:43)
 
</pre>
 
</pre>
The result will be :
 
*x-load-ddp.bin.ift in autobuild/igep0020/flash directory (for OneNAND DDP)
 
*x-load.bin.ift in autobuild/igep0020/sdcard directory (for SD card)
 
  
==== X-loader mainline tree (development) ====
+
Script : flash u-boot using u-boot
 +
 
 +
mmc rescan 0
 +
fatload mmc 0 0x80300000 u-boot.bin
 +
onenand erase 0x80000 0x180000
 +
onenand write 0x80300000 0x80000 0x180000
  
Clone the GIT repository from git.myigep.com
+
= Changelog =
<pre>
+
* [http://git.igep.es/?p=pub/scm/x-loader.git;a=commit;h=7a4eb1c5c2a6f2c83927c7a09a335481dc054d70 2011-07-29 Release 1.4.4-3]
$ git clone git://git.igep.es/pub/scm/x-loader.git
+
** fix build with linaro toolchain
$ cd x-loader
+
* [http://git.igep.es/?p=pub/scm/x-loader.git;a=commit;h=5a8ddfa826ee447853c27f14dc437dd81e2c52a5 2011-03-07 Release 1.4.4-2]
</pre>
+
** improve clk frequency selection
and build with
+
* [http://git.igep.es/?p=pub/scm/x-loader.git;a=commit;h=0aad3f949c55196491721129d73261ac6bcca120 2010-11-08 Release 1.4.4-1]
<pre>
+
** improve led management
$ cd x-loader
+
* [http://git.igep.es/?p=pub/scm/x-loader.git;a=commit;h=63815b693325970f3fddbb197af67cd6d439aee7 2010-10-12 Release 1.4.4-0]
$ scripts/./autobuild.sh arm-none-linux-gnueabi-
+
** add support for DM3730
</pre>
+
* [http://git.igep.es/?p=pub/scm/x-loader.git;a=commit;h=88e476f71ddb4f9bee833b4da4b05fd883284d5c 2010-06-15 Release 1.4.3-0]
The result will be :
+
** add watchdog support
*x-load-ddp.bin.ift in autobuild/igep0020b/flash directory (for OneNAND DDP)
+
** add support for the 128MB SDRAM
*x-load.bin.ift in autobuild/igep0020b/sdcard directory (for SD card)
+
** add support for OMAP3 IGEP module (igep0030)
  
[[Category:Software|Xloader]]
+
[[Category:Boot loaders|Xloader]]

Latest revision as of 13:20, 14 May 2012

X-loader for IGEP platforms

First of all setup the build environment sourcing this script

$ source /usr/local/poky/eabi-glibc/arm/environment-setup

or

$ source /usr/local/poky/eabi-glibc/environment-setup-arm-none-linux-gnueabi

if you have updated your SDK environment to latest version (see Ubuntu 8.04 IGEP v2.0 SDK Virtual Machine)

X-loader v1.4.4-3 (stable)

Download the IGEP X-loader sources and follow next steps:

Warning icon.png A user reported that this page might contain some broken, wrong or missing links to external pages.

Thank you for your patience as it is being fixed.

$ wget http://downloads.igep.es/sources/x-loader-1.4.4-3.tar.gz
$ tar xzf x-loader-1.4.4-3.tar.gz
$ cd x-loader-1.4.4-3
$ scripts/./autobuild.sh arm-none-linux-gnueabi-

The result will be :

  • For IGEP v2 platform
    • x-load-ddp.bin.ift in autobuild/igep0020/flash directory (for OneNAND DDP)
    • x-load.bin.ift in autobuild/igep0020/sdcard directory (for SD card)
  • For OMAP3 IGEP module
    • x-load-ddp.bin.ift in autobuild/igep0030/flash directory (for OneNAND DDP)
    • x-load.bin.ift in autobuild/igep0030/sdcard directory (for SD card)

X-loader development

Note: The 'master' branch is where the development work takes place and you should use this if you're after to work with the latest cutting edge developments. It is possible trunk can suffer temporary periods of instability while new features are developed and if this is undesirable we recommend using one of the release branches. Use ONLY for development purposes.

Clone the GIT repository from git.igep.es

$ git clone git://git.igep.es/pub/scm/x-loader.git
$ cd x-loader
$ git checkout origin/for-next -b for-next

and build with

$ cd x-loader
$ make CROSS_COMPILE=arm-none-linux-gnueabi- igep00x0_config 
$ make CROSS_COMPILE=arm-none-linux-gnueabi-

The result will be :

  • x-load.bin.ift in ./ directory

Quality assurance: Test Cases

Status table

Test case definitions

#001 : SDCARD boot

How to test: Put x-loader to sdcard and check if booting. Result should be like :

Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
Reading boot sector
u-boot.bin not found or blank nand contents - attempting serial boot . . .
## Ready for binary (kermit) download to 0x80008000 at 115200 bps...

#002 : Load u-boot from SD-card

How to test: Put x-loader and u-boot to SD-card and check if booting. Result should be like :

 Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
 Reading boot sector
 Loading u-boot.bin from mmc

 U-Boot 2011.03-00406-gf92edd8 (May 05 2011 - 13:01:04)

#003 : ONENAND boot

How to test: Put x-loader to onenand and check if booting. Result should be like :

Texas Instruments X-Loader 1.5.0 (May  5 2011 - 09:59:19)
u-boot.bin not found or blank nand contents - attempting serial boot . . .
## Ready for binary (kermit) download to 0x80008000 at 115200 bps...

Script : flash x-loader using u-boot

mmc rescan 0
fatload mmc 0:1 0x80300000 mlo
onenand erase 0 0x80000
onenand write 0x80300000 0 0x80000

#004 : Load u-boot from onenand

How to test: Put x-loader and u-boot to SD-card and check if booting. Result should be like :

 Texas Instruments X-Loader 1.5.0 (May 19 2011 - 10:47:12)
 Detected Numonyx OneNAND 4G Flash
 Loading u-boot.bin from onenand

 U-Boot 2011.03-00532-g638a48e (May 19 2011 - 11:43:43)

Script : flash u-boot using u-boot

mmc rescan 0
fatload mmc 0 0x80300000 u-boot.bin
onenand erase 0x80000 0x180000
onenand write 0x80300000 0x80000 0x180000

Changelog