# # (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/.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 _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