#
# (C) Copyright 2004-2006 Texas Instruments
#
# Some cut/paste from U-Boot README
# (C) Copyright 2000 - 2004
# Wolfgang Denk, DENX Software Engineering, wd@denx.de.
#
# See file CREDITS for list of people who contributed to this
# project.
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License as
# published by the Free Software Foundation; either version 2 of
# the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston,
# MA 02111-1307 USA
#

Summary:
========

This directory contains the source code for X-Loader, an initial program
loader for Embedded boards based on OMAP processors. X-Loader can be
signed by Texas Instruments IFT and installed to Nand flash to achieve
Nand booting.


Status:
=======

The support for Texas Instruments 3430SDP board (OMAP3430) has been implemented
and tested. (Dec 2006)


Support for other OMAP boards can be added.
 
  
Directory Hierarchy:
====================

- board		Board dependent files
- cpu		CPU specific files
- drivers	Commonly used device drivers
- lib		Libraries
 
- cpu/arm1136 Files specific to ARM 1136 CPUs
- cpu/omap3 Files specific to ARM CortexA8 CPU

 
- board/omap3430sdp
		Files specific to OMAP 3420sdp boards

 
Software Configuration:
=======================

Configuration is usually done using C preprocessor defines. Configuration
depends on the combination of board and CPU type; all such information is
kept in a configuration file "include/configs/<board_name>.h".

Example: For a OMAP4 PandaBoard, all configuration settings are in
"include/configs/omap4430panda.h"
  
For all supported boards there are ready-to-use default
configurations available; just type "make <board_name>_config".

Example: For a OMAP4 PandaBoard, type:

	cd x-load
	make omap4430panda_config

After a board has been configured, type "make" to build it supposing the
needed cross tools are in your path.

 
Image Format:
=============

X-Loader expects OS boot loader (e.g. U-Boot) in Nand flash using
JFFS2 style ECC. 


Prepare Booting Nand Flash:
===========================

After you have built x-load.bin for your board, you need to do the
followings to get it into Nand flash:

1. Use Texas Instruments IFT to sign x-load.bin. This results in a
signed image called x-load.bin.ift.
2. Use Texas Instruments FlashPrep to generate a .out file using
FlashWriterNand and specifying 0 as nand target address.
3. Use Texas instrumnets Code Composer Studio to run the .out file 
which flashes x-load.bin.ift to Nand flash.

Next you need to get your OS boot loader to Nand at the address your
X-Loader expects. For the H3 example, you can use U-Boot to flash U-Boot.
You can't use FlashWriterNand because it uses ROM code ECC style.  

Implemenation notes:
====================
3430sdp support OneNAND booting