Home | History | Annotate | Download | only in cobra5272
      1 File:		README.COBRA5272
      2 Author:		Florian Schlote for Sentec elektronik (linux (a] sentec-elektronik.de)
      3 Contents:	This is the README of u-boot (Universal bootloader) for our
      4 		COBRA5272 board.
      5 Version:	v01.00
      6 Date:		Tue Mar 30 00:28:33 CEST 2004
      7 License:	This document is published under the GNU GPL
      8 ______________________________________________________________________
      9 
     10 CHANGES
     11 040330   v01.00 Creation
     12 
     13 ______________________________________________________________________
     14 
     15 
     16 CONFIGURING
     17 -----------
     18 
     19 1. Modify include/configs/cobra5272.h acc. to your prefs
     20 
     21 2. If necessary, modify board/cobra5272/config.mk (see below)
     22 
     23 3.
     24 
     25 > make cobra5272_config
     26 
     27 > make
     28 
     29 
     30 Please refer to u-boot README (general info, u-boot-x-x-x/README),
     31 to u-boot-x-x-x/doc/README.COBRA5272 and
     32 to the comments in u-boot-x-x-x/include/configs/cobra5272.h
     33 
     34 Configuring u-boot is done by commenting/uncommenting preprocessor defines.
     35 
     36 Default configuration is
     37 
     38 	FLASH version (for further info see subsection below)
     39 	link address 0xffe00000
     40 
     41 	16 MB RAM
     42 
     43 	network enabled
     44 	no default IP address for target, host set, no MACaddress set
     45 
     46 	bootdelay for autoboot 5 sec.
     47 	autoboot disabled
     48 
     49 
     50 #-----------------------------------
     51 # u-boot FLASH version & RAM version
     52 #-----------------------------------
     53 
     54 The u-boot bootloader for Coldfire processors can be configured
     55 
     56 	1. as a standalone bootloader residing in flash & relocating itself to RAM on
     57 	startup automatically => "FLASH version"
     58 
     59 	2. as a RAM version which will not load from flash automatically as it needs a
     60 	prestage bootloader ("chainloading") & is running only from the RAM address it
     61 	is linked to => "RAM version"
     62 
     63 	This version may be very helpful when installing u-boot for the first time
     64 	since it can be used to make available s. th. like a "bootstrap
     65 	mechanism".
     66 
     67 
     68 How to build the different images:
     69 
     70 ------------------------------
     71 Flash version
     72 ------------------------------
     73 
     74 Compile u-boot
     75 
     76 in dir ./u-boot-x-x-x/
     77 
     78 please first check:
     79 
     80 	in ./include/configs/cobra5272.h
     81 
     82 		CONFIG_MONITOR_IS_IN_RAM has to be undefined, e. g. as follows:
     83 
     84 		#if 0
     85 			#define CONFIG_MONITOR_IS_IN_RAM
     86 			/* define if monitor is started from a pre-loader */
     87 		#endif
     88 
     89 	=> u-boot as single bootloader starting from flash
     90 
     91 
     92 	in board/cobra5272/config.mk CONFIG_SYS_TEXT_BASE should be
     93 
     94 		CONFIG_SYS_TEXT_BASE = 0xffe00000
     95 
     96 	=> linking address for u-boot as single bootloader stored in flash
     97 
     98 then:
     99 
    100 	host> make cobra5272_config
    101 		rm -f include/config.h include/config.mk
    102 		Configuring for cobra5272 board...
    103 	host> make
    104 		[...]
    105 
    106 	host> cp u-boot.bin /tftpboot/u-boot_flash.bin
    107 
    108 
    109 ------------------------------
    110 RAM version
    111 ------------------------------
    112 
    113 in dir ./u-boot-x-x-x/
    114 
    115 	host> make distclean
    116 
    117 please modify the settings:
    118 
    119 	in ./include/configs/cobra5272.h
    120 
    121 		CONFIG_MONITOR_IS_IN_RAM now has to be defined, e. g. as follows:
    122 
    123 		#if 1
    124 			#define CONFIG_MONITOR_IS_IN_RAM
    125 			/*define if monitor is started from a pre-loader */
    126 		#endif
    127 
    128 	=> u-boot as RAM version, chainloaded by another bootloader or using bdm cable
    129 
    130 
    131 	in board/cobra5272/config.mk CONFIG_SYS_TEXT_BASE should be
    132 
    133 		CONFIG_SYS_TEXT_BASE = 0x00020000
    134 
    135 	=> target linking address for RAM
    136 
    137 
    138 then:
    139 
    140 	host> make cobra5272_config
    141 		rm -f include/config.h include/config.mk
    142 		Configuring for cobra5272 board...
    143 	host> make
    144 		[...]
    145 
    146 	host> cp u-boot.bin /tftpboot/u-boot_ram.bin
    147 
    148 
    149 ----
    150 HINT
    151 ----
    152 
    153 If the m68k-elf-toolchain & the m68k-bdm-gdb is installed you can run the RAM
    154 version by typing (in dir ./u-boot-x-x-x/)
    155 "board/cobra5272/bdm/load-cobra_uboot" ,
    156 in ./u-boot-x-x-x/ the RAM version u-boot (elf format) has to be available.
    157