]> git.sur5r.net Git - u-boot/blob - doc/README.IPHASE4539
powerpc/corenet_ds: Slave uploads ucode when boot from SRIO
[u-boot] / doc / README.IPHASE4539
1
2 This file contains basic information on the port of U-Boot to IPHASE4539
3 (Interphase 4539 T1/E1/J1 PMC Communications Controller).
4 All the changes fit in the common U-Boot infrastructure, providing a new
5 IPHASE4539-specific entry in makefiles. To build U-Boot for IPHASE4539,
6 type "make IPHASE4539_config", edit the "include/config_IPHASE4539.h"
7 file if necessary, then type "make".
8
9
10 Common file modifications:
11 --------------------------
12
13 The following common files have been modified by this project:
14 (starting from the ppcboot-1.1.5/ directory)
15
16 MAKEALL                         - IPHASE4539 entry added
17 Makefile                        - IPHASE4539_config entry added
18
19
20 New files:
21 ----------
22
23 The following new files have been added by this project:
24 (starting from the ppcboot-1.1.5/ directory)
25
26 board/iphase4539/               - board-specific directory
27 board/iphase4539/Makefile       - board-specific makefile
28 board/iphase4539/config.mk      - config file
29 board/iphase4539/flash.c        - flash driver (for AM29LV033C)
30 board/iphase4539/ppcboot.lds    - linker script
31 board/iphase4539/iphase4539.c   - ioport and memory initialization
32 include/config_IPHASE4539.h     - main configuration file
33
34
35 New configuration options:
36 --------------------------
37
38 CONFIG_IPHASE4539
39
40         Main board-specific option (should be defined for IPHASE4539).
41
42
43 Acceptance criteria tests:
44 --------------------------
45
46 The following tests have been conducted to validate the port of U-Boot
47 to IPHASE4539:
48
49 1. Operation on serial console:
50
51 With SMC1 defined as console in the main configuration file, the U-Boot
52 output appeared on the serial terminal connected to the 2.5mm stereo jack
53 connector as follows:
54
55 ------------------------------------------------------------------------------
56 => help
57 base    - print or set address offset
58 bdinfo  - print Board Info structure
59 bootm   - boot application image from memory
60 bootp   - boot image via network using BootP/TFTP protocol
61 bootd   - boot default, i.e., run 'bootcmd'
62 cmp     - memory compare
63 coninfo - print console devices and informations
64 cp      - memory copy
65 crc32   - checksum calculation
66 dcache  - enable or disable data cache
67 echo    - echo args to console
68 erase   - erase FLASH memory
69 flinfo  - print FLASH memory information
70 go      - start application at address 'addr'
71 help    - print online help
72 icache  - enable or disable instruction cache
73 iminfo  - print header information for application image
74 loadb   - load binary file over serial line (kermit mode)
75 loads   - load S-Record file over serial line
76 loop    - infinite loop on address range
77 md      - memory display
78 mm      - memory modify (auto-incrementing)
79 mtest   - simple RAM test
80 mw      - memory write (fill)
81 nm      - memory modify (constant address)
82 printenv- print environment variables
83 protect - enable or disable FLASH write protection
84 rarpboot- boot image via network using RARP/TFTP protocol
85 reset   - Perform RESET of the CPU
86 run     - run commands in an environment variable
87 saveenv - save environment variables to persistent storage
88 setenv  - set environment variables
89 sleep   - delay execution for some time
90 source  - run script from memory
91 tftpboot- boot image via network using TFTP protocol
92                and env variables ipaddr and serverip
93 version - print monitor version
94 ?       - alias for 'help'
95 =>
96 ------------------------------------------------------------------------------
97
98
99 2. Flash driver operation
100
101 The following sequence was performed to test the "flinfo" command:
102
103 ------------------------------------------------------------------------------
104 => flinfo
105
106 Bank # 1: AMD AM29LV033C (32 Mbit, uniform sectors)
107   Size: 4 MB in 64 Sectors
108   Sector Start Addresses:
109     FF800000 (RO) FF810000 (RO) FF820000      FF830000      FF840000
110     FF850000      FF860000      FF870000      FF880000      FF890000
111     FF8A0000      FF8B0000      FF8C0000      FF8D0000      FF8E0000
112     FF8F0000      FF900000      FF910000      FF920000      FF930000
113     FF940000      FF950000      FF960000      FF970000      FF980000
114     FF990000      FF9A0000      FF9B0000      FF9C0000      FF9D0000
115     FF9E0000      FF9F0000      FFA00000      FFA10000      FFA20000
116     FFA30000      FFA40000      FFA50000      FFA60000      FFA70000
117     FFA80000      FFA90000      FFAA0000      FFAB0000      FFAC0000
118     FFAD0000      FFAE0000      FFAF0000      FFB00000 (RO) FFB10000 (RO)
119     FFB20000 (RO) FFB30000 (RO) FFB40000      FFB50000      FFB60000
120     FFB70000      FFB80000      FFB90000      FFBA0000      FFBB0000
121     FFBC0000      FFBD0000      FFBE0000      FFBF0000
122 ------------------------------------------------------------------------------
123
124 Note: the Hardware Configuration Word (HWC) of the 8260 is on the
125 first sector of the flash and should not be touched. The U-Boot
126 environment variables are stored on second sector and U-Boot
127 starts at the address 0xFFB00000.
128
129
130 The following sequence was performed to test the erase command:
131
132 ------------------------------------------------------------------------------
133 => cp 0 ff880000 10
134 Copy to Flash... done
135 => md ff880000 20
136 ff880000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
137 ff880010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
138 ff880020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
139 ff880030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
140 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
141 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
142 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
143 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
144 => erase ff880000 ff88ffff
145 Erase Flash from 0xff880000 to 0xff88ffff
146 .. done
147 Erased 1 sectors
148 => md ff880000
149 ff880000: ffffffff ffffffff ffffffff ffffffff    ................
150 ff880010: ffffffff ffffffff ffffffff ffffffff    ................
151 ff880020: ffffffff ffffffff ffffffff ffffffff    ................
152 ff880030: ffffffff ffffffff ffffffff ffffffff    ................
153 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
154 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
155 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
156 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
157 => cp 0 ff880000 10
158 Copy to Flash... done
159 => md ff880000 20
160 ff880000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
161 ff880010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
162 ff880020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
163 ff880030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
164 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
165 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
166 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
167 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
168 => erase 1:8
169 Erase Flash Sectors 8-8 in Bank # 1
170 .. done
171 => md ff880000 20
172 ff880000: ffffffff ffffffff ffffffff ffffffff    ................
173 ff880010: ffffffff ffffffff ffffffff ffffffff    ................
174 ff880020: ffffffff ffffffff ffffffff ffffffff    ................
175 ff880030: ffffffff ffffffff ffffffff ffffffff    ................
176 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
177 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
178 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
179 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
180 => cp 0 ff880000 10
181 Copy to Flash... done
182 => cp 0 ff890000 10
183 => md ff880000 20
184 ff880000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
185 ff880010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
186 ff880020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
187 ff880030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
188 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
189 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
190 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
191 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
192 => md ff890000
193 ff890000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
194 ff890010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
195 ff890020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
196 ff890030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
197 ff890040: ffffffff ffffffff ffffffff ffffffff    ................
198 ff890050: ffffffff ffffffff ffffffff ffffffff    ................
199 ff890060: ffffffff ffffffff ffffffff ffffffff    ................
200 ff890070: ffffffff ffffffff ffffffff ffffffff    ................
201 => erase 1:8-9
202 Erase Flash Sectors 8-9 in Bank # 1
203 .... done
204 => md ff880000 20
205 ff880000: ffffffff ffffffff ffffffff ffffffff    ................
206 ff880010: ffffffff ffffffff ffffffff ffffffff    ................
207 ff880020: ffffffff ffffffff ffffffff ffffffff    ................
208 ff880030: ffffffff ffffffff ffffffff ffffffff    ................
209 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
210 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
211 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
212 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
213 => md ff890000
214 ff890000: ffffffff ffffffff ffffffff ffffffff    ................
215 ff890010: ffffffff ffffffff ffffffff ffffffff    ................
216 ff890020: ffffffff ffffffff ffffffff ffffffff    ................
217 ff890030: ffffffff ffffffff ffffffff ffffffff    ................
218 ff890040: ffffffff ffffffff ffffffff ffffffff    ................
219 ff890050: ffffffff ffffffff ffffffff ffffffff    ................
220 ff890060: ffffffff ffffffff ffffffff ffffffff    ................
221 ff890070: ffffffff ffffffff ffffffff ffffffff    ................
222 =>
223 ------------------------------------------------------------------------------
224
225
226 The following sequence was performed to test the Flash programming commands:
227
228 ------------------------------------------------------------------------------
229 => erase ff880000 ff88ffff
230 Erase Flash from 0xff880000 to 0xff88ffff
231 .. done
232 Erased 1 sectors
233 => cp 0 ff880000 10
234 Copy to Flash... done
235 => md 0 20
236 00000000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
237 00000010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
238 00000020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
239 00000030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
240 00000040: 3c83c000 2c040000 40823378 7c0000a6    <...,...@.3x|...
241 00000050: 60000030 7c1b03a6 3c00c000 600035ec    `..0|...<...`.5.
242 00000060: 7c1a03a6 4c000064 00000000 00000000    |...L..d........
243 00000070: 00000000 00000000 00000000 00000000    ................
244 => md ff880000 20
245 ff880000: ff000000 60000000 60000000 7c7f1b78    ....`...`...|..x
246 ff880010: 7c9e2378 7cbd2b78 7cdc3378 7cfb3b78    |.#x|.+x|.3x|.;x
247 ff880020: 3b000000 4811e0f5 48003719 480036a5    ;...H...H.7.H.6.
248 ff880030: 480036f9 48003731 48005c5d 7c7a1b78    H.6.H.71H.\]|z.x
249 ff880040: ffffffff ffffffff ffffffff ffffffff    ................
250 ff880050: ffffffff ffffffff ffffffff ffffffff    ................
251 ff880060: ffffffff ffffffff ffffffff ffffffff    ................
252 ff880070: ffffffff ffffffff ffffffff ffffffff    ................
253 =>
254 ------------------------------------------------------------------------------
255
256
257 The following sequence was performed to test storage of the environment
258 variables in Flash:
259
260 ------------------------------------------------------------------------------
261 => setenv foo bar
262 => saveenv
263 Un-Protected 1 sectors
264 Erasing Flash...
265 .. done
266 Erased 1 sectors
267 Saving Environment to Flash...
268 Protected 1 sectors
269 => reset
270 ...
271 => printenv
272 ...
273 foo=bar
274 ...
275 Environment size: 339/65532 bytes
276 =>
277 ------------------------------------------------------------------------------
278
279
280 The following sequence was performed to test image download and run over
281 Ethernet interface (both interfaces were tested):
282
283 ------------------------------------------------------------------------------
284 => tftpboot 40000 hello_world.bin
285 ARP broadcast 1
286 TFTP from server 10.0.0.1; our IP address is 10.0.0.8
287 Filename 'hello_world.bin'.
288 Load address: 0x40000
289 Loading: #############
290 done
291 Bytes transferred = 65932 (1018c hex)
292 => go 40004
293 ## Starting application at 0x00040004 ...
294 Hello World
295 argc = 1
296 argv[0] = "40004"
297 argv[1] = "<NULL>"
298 Hit any key to exit ...
299
300 ## Application terminated, rc = 0x0
301 =>
302 ------------------------------------------------------------------------------
303
304
305 3. Known Problems
306
307 None for the moment.
308
309
310 ----------------------------------------------------------------------------
311 U-Boot and Linux for Interphase 4539 T1/E1/J1 PMC Communications Controller
312 ----------------------------------------------------------------------------
313
314 U-Boot:
315
316         Configure and make U-Boot:
317
318         $ cd <path>/u-boot
319         $ make IPHASE4539_config
320         $ make dep
321         $ make
322         $ cp -p u-boot.bin /tftpboot
323
324         Load u-boot.bin into the Flash memory at 0xffb00000.
325
326
327 Linux:
328
329         Configure and make Linux:
330
331         $ cd <patch>/linux-2.4
332         $ make IPHASE4539_config
333         $ make oldconfig
334         $ make dep
335         $ make uImage
336         $ cp -p arch/powerpc/mbxboot/uImage /tftpboot
337
338         Load uImage via tftp and boot it.
339
340
341 Flash organisation:
342
343         The following preliminary layout of the Flash memory
344         is defined:
345
346         0xff800000 (   0    -   64 kB): Hardware Configuration Word.
347         0xff810000 (  64 kB -  128 kB): U-Boot Environment.
348         0xff820000 ( 128 kB -    3 MB): RAMdisk.
349         0xffb00000 (   3 MB - 3328 kB): U-Boot.
350         0xffb40000 (3328 KB -    4 MB): Linux Kernel.
351
352
353 For further information concerning U-Boot and Linux please consult
354 the "DENX U-Boot and Linux Guide".
355
356
357 (C) 2002 Wolfgang Grandegger, DENX Software Engineering, wg@denx.de
358 ===================================================================