← Back to branch summary

~pmdj/ubuntu/trusty/qemu/2.9+applesmc+fadtv3

« back to all changes in this revision

Viewing changes to roms/u-boot/board/iphase4539/README

  • Committer: Phil Dennis-Jordan
  • Date: 2017-07-21 08:03:43 UTC
  • mfrom: (1.1.1)
  • Revision ID: phil@philjordan.eu-20170721080343-2yr2vdj7713czahv
New upstream release 2.9.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
roms/u-boot/board/iphase4539/README
 
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
===================================================================