xref: /openbmc/u-boot/board/cobra5272/README (revision 0b45a79f)
1File:		README.COBRA5272
2Author:		Florian Schlote for Sentec elektronik (linux@sentec-elektronik.de)
3Contents:	This is the README of u-boot (Universal bootloader) for our
4		COBRA5272 board.
5Version:	v01.00
6Date:		Tue Mar 30 00:28:33 CEST 2004
7License:	This document is published under the GNU GPL
8______________________________________________________________________
9
10CHANGES
11040330   v01.00 Creation
12
13______________________________________________________________________
14
15
16CONFIGURING
17-----------
18
191. Modify include/configs/cobra5272.h acc. to your prefs
20
212. If necessary, modify board/cobra5272/config.mk (see below)
22
233.
24
25> make cobra5272_config
26
27> make
28
29
30Please refer to u-boot README (general info, u-boot-x-x-x/README),
31to u-boot-x-x-x/doc/README.COBRA5272 and
32to the comments in u-boot-x-x-x/include/configs/cobra5272.h
33
34Configuring u-boot is done by commenting/uncommenting preprocessor defines.
35
36Default 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
54The 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
68How to build the different images:
69
70------------------------------
71Flash version
72------------------------------
73
74Compile u-boot
75
76in dir ./u-boot-x-x-x/
77
78please 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
98then:
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------------------------------
110RAM version
111------------------------------
112
113in dir ./u-boot-x-x-x/
114
115	host> make distclean
116
117please 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
138then:
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----
150HINT
151----
152
153If the m68k-elf-toolchain & the m68k-bdm-gdb is installed you can run the RAM
154version by typing (in dir ./u-boot-x-x-x/)
155"board/cobra5272/bdm/load-cobra_uboot" ,
156in ./u-boot-x-x-x/ the RAM version u-boot (elf format) has to be available.
157