OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [malta.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 28 unneback
<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
2
<!-- This material may be distributed only subject to the terms      -->
3
<!-- and conditions set forth in the Open Publication License, v1.0  -->
4
<!-- or later (the latest version is presently available at          -->
5
<!-- http://www.opencontent.org/openpub/).                           -->
6
<!-- Distribution of the work or derivative of the work in any       -->
7
<!-- standard (paper) book form is prohibited unless prior           -->
8
<!-- permission is obtained from the copyright holder.               -->
9
<HTML
10
><HEAD
11
><TITLE
12
>MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Malta Board </TITLE
13
><meta name="MSSmartTagsPreventParsing" content="TRUE">
14
<META
15
NAME="GENERATOR"
16
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
17
"><LINK
18
REL="HOME"
19
TITLE="eCos Reference Manual"
20
HREF="ecos-ref.html"><LINK
21
REL="UP"
22
TITLE="Installation and Testing"
23
HREF="installation-and-testing.html"><LINK
24
REL="PREVIOUS"
25
TITLE="MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Atlas Board"
26
HREF="atlas.html"><LINK
27
REL="NEXT"
28
TITLE="MIPS/RM7000 PMC-Sierra Ocelot"
29
HREF="ocelot.html"></HEAD
30
><BODY
31
CLASS="SECT1"
32
BGCOLOR="#FFFFFF"
33
TEXT="#000000"
34
LINK="#0000FF"
35
VLINK="#840084"
36
ALINK="#0000FF"
37
><DIV
38
CLASS="NAVHEADER"
39
><TABLE
40
SUMMARY="Header navigation table"
41
WIDTH="100%"
42
BORDER="0"
43
CELLPADDING="0"
44
CELLSPACING="0"
45
><TR
46
><TH
47
COLSPAN="3"
48
ALIGN="center"
49
>eCos Reference Manual</TH
50
></TR
51
><TR
52
><TD
53
WIDTH="10%"
54
ALIGN="left"
55
VALIGN="bottom"
56
><A
57
HREF="atlas.html"
58
ACCESSKEY="P"
59
>Prev</A
60
></TD
61
><TD
62
WIDTH="80%"
63
ALIGN="center"
64
VALIGN="bottom"
65
>Chapter 5. Installation and Testing</TD
66
><TD
67
WIDTH="10%"
68
ALIGN="right"
69
VALIGN="bottom"
70
><A
71
HREF="ocelot.html"
72
ACCESSKEY="N"
73
>Next</A
74
></TD
75
></TR
76
></TABLE
77
><HR
78
ALIGN="LEFT"
79
WIDTH="100%"></DIV
80
><DIV
81
CLASS="SECT1"
82
><H1
83
CLASS="SECT1"
84
><A
85
NAME="MALTA">MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Malta Board</H1
86
><DIV
87
CLASS="SECT2"
88
><H2
89
CLASS="SECT2"
90
><A
91
NAME="AEN6809">Overview</H2
92
><P
93
>RedBoot supports both front
94
facing serial ports and the built in ethernet port for communication and downloads.
95
The default serial port settings are 38400,8,N,1. RedBoot runs from and supports
96
flash management for the system flash region.</P
97
><P
98
>The following RedBoot configurations are supported:
99
 
100
      <DIV
101
CLASS="INFORMALTABLE"
102
><A
103
NAME="AEN6819"><P
104
></P
105
><TABLE
106
BORDER="1"
107
CLASS="CALSTABLE"
108
><THEAD
109
><TR
110
><TH
111
ALIGN="LEFT"
112
VALIGN="TOP"
113
>Configuration</TH
114
><TH
115
ALIGN="LEFT"
116
VALIGN="TOP"
117
>Mode</TH
118
><TH
119
ALIGN="LEFT"
120
VALIGN="TOP"
121
>Description</TH
122
><TH
123
ALIGN="LEFT"
124
VALIGN="TOP"
125
>File</TH
126
></TR
127
></THEAD
128
><TBODY
129
><TR
130
><TD
131
ALIGN="LEFT"
132
VALIGN="TOP"
133
>ROM</TD
134
><TD
135
ALIGN="LEFT"
136
VALIGN="TOP"
137
>[ROM]</TD
138
><TD
139
ALIGN="LEFT"
140
VALIGN="TOP"
141
>RedBoot running from the board's flash boot
142
              sector.</TD
143
><TD
144
ALIGN="LEFT"
145
VALIGN="TOP"
146
>redboot_ROM.ecm</TD
147
></TR
148
><TR
149
><TD
150
ALIGN="LEFT"
151
VALIGN="TOP"
152
>RAM</TD
153
><TD
154
ALIGN="LEFT"
155
VALIGN="TOP"
156
>[RAM]</TD
157
><TD
158
ALIGN="LEFT"
159
VALIGN="TOP"
160
>RedBoot running from RAM with RedBoot in the
161
              flash boot sector.</TD
162
><TD
163
ALIGN="LEFT"
164
VALIGN="TOP"
165
>redboot_RAM.ecm</TD
166
></TR
167
></TBODY
168
></TABLE
169
><P
170
></P
171
></DIV
172
></P
173
></DIV
174
><DIV
175
CLASS="SECT2"
176
><H2
177
CLASS="SECT2"
178
><A
179
NAME="AEN6838">Initial Installation</H2
180
><P
181
>RedBoot is installed using the code download facility built into the
182
Malta board. See the Malta User manual for details, and also the Malta download
183
format in <A
184
HREF="malta.html#MALTA-DOWNLOAD-FORMAT"
185
>the Section called <I
186
>Malta download format</I
187
></A
188
>.</P
189
><DIV
190
CLASS="SECT3"
191
><H3
192
CLASS="SECT3"
193
><A
194
NAME="AEN6842">Quick download instructions</H3
195
><P
196
>Here are quick start instructions for downloading the prebuilt RedBoot
197
image. </P
198
><P
199
></P
200
><OL
201
TYPE="1"
202
><LI
203
><P
204
>Locate the prebuilt files in the bin directory: <TT
205
CLASS="FILENAME"
206
>deleteall.fl</TT
207
> and <TT
208
CLASS="FILENAME"
209
>redboot_ROM.fl</TT
210
>. </P
211
></LI
212
><LI
213
><P
214
>Make sure switch S5-1 is ON. Reset the board and verify that
215
the LED display reads <TT
216
CLASS="COMPUTEROUTPUT"
217
>Flash DL</TT
218
>. </P
219
></LI
220
><LI
221
><P
222
>Make sure your parallel port is connected to the 1284 port
223
Of the Atlas board. </P
224
></LI
225
><LI
226
><P
227
>Send the <TT
228
CLASS="FILENAME"
229
>deleteall.fl</TT
230
> file to the
231
parallel port to erase previous images:
232
<TABLE
233
BORDER="5"
234
BGCOLOR="#E0E0F0"
235
WIDTH="70%"
236
><TR
237
><TD
238
><PRE
239
CLASS="SCREEN"
240
>$ <TT
241
CLASS="USERINPUT"
242
><B
243
>cat deleteall.fl &#62;/dev/lp0</B
244
></TT
245
></PRE
246
></TD
247
></TR
248
></TABLE
249
>
250
When this is complete, the LED display should read
251
<TT
252
CLASS="COMPUTEROUTPUT"
253
>Deleted</TT
254
>.</P
255
></LI
256
><LI
257
><P
258
>Send the RedBoot image to the board:
259
<TABLE
260
BORDER="5"
261
BGCOLOR="#E0E0F0"
262
WIDTH="70%"
263
><TR
264
><TD
265
><PRE
266
CLASS="SCREEN"
267
>$ <TT
268
CLASS="USERINPUT"
269
><B
270
>cat redboot_ROM.fl &#62;/dev/lp0</B
271
></TT
272
></PRE
273
></TD
274
></TR
275
></TABLE
276
>
277
When this is complete, the LED display should show the last address
278
programmed. This will be something like:
279
<TT
280
CLASS="COMPUTEROUTPUT"
281
>1fc17000</TT
282
>. </P
283
></LI
284
><LI
285
><P
286
>Change switch S5-1 to OFF and reset the board. The LED display
287
should read <TT
288
CLASS="COMPUTEROUTPUT"
289
>RedBoot</TT
290
>. </P
291
></LI
292
><LI
293
><P
294
>Run the RedBoot <B
295
CLASS="COMMAND"
296
>fis init</B
297
> and <B
298
CLASS="COMMAND"
299
>fconfig</B
300
> commands to initialize the flash. See <A
301
HREF="flash-image-system.html"
302
>the Section called <I
303
>Flash Image System (FIS)</I
304
> in Chapter 2</A
305
>
306
and <A
307
HREF="persistent-state-flash.html"
308
>the Section called <I
309
>Persistent State Flash-based Configuration and Control</I
310
> in Chapter 2</A
311
> for details. </P
312
></LI
313
></OL
314
></DIV
315
><DIV
316
CLASS="SECT3"
317
><H3
318
CLASS="SECT3"
319
><A
320
NAME="MALTA-DOWNLOAD-FORMAT">Malta download format</H3
321
><P
322
>In order to download RedBoot to the Malta board, it must be converted
323
to the Malta download format.</P
324
><P
325
>The <I
326
CLASS="CITETITLE"
327
>Atlas/Malta Developer's Kit</I
328
> CD contains an <SPAN
329
CLASS="APPLICATION"
330
>srecconv.pl</SPAN
331
> utility which requires Perl. This utility is part
332
of the <TT
333
CLASS="FILENAME"
334
>yamon/yamon-src-02.00.tar.gz</TT
335
> tarball
336
on the Dev Kit CD. The path in the expanded tarball is <TT
337
CLASS="FILENAME"
338
>yamon/bin/tools</TT
339
>.  To use
340
<SPAN
341
CLASS="APPLICATION"
342
>srecconv</SPAN
343
> to convert the S-record file:
344
<TABLE
345
BORDER="5"
346
BGCOLOR="#E0E0F0"
347
WIDTH="70%"
348
><TR
349
><TD
350
><PRE
351
CLASS="SCREEN"
352
>$ <TT
353
CLASS="USERINPUT"
354
><B
355
>cp redboot_ROM.srec redboot_ROM.rec</B
356
></TT
357
>
358
$ <TT
359
CLASS="USERINPUT"
360
><B
361
>srecconv.pl -ES L -A 29 redboot_ROM</B
362
></TT
363
></PRE
364
></TD
365
></TR
366
></TABLE
367
>
368
The resulting file is named <TT
369
CLASS="FILENAME"
370
>redboot_ROM.fl</TT
371
>.</P
372
></DIV
373
></DIV
374
><DIV
375
CLASS="SECT2"
376
><H2
377
CLASS="SECT2"
378
><A
379
NAME="AEN6888">Additional commands</H2
380
><P
381
>The <B
382
CLASS="COMMAND"
383
>exec</B
384
> command which allows the
385
loading and execution of Linux kernels, is supported for this architecture
386
 (see <A
387
HREF="executing-programs.html"
388
>the Section called <I
389
>Executing Programs from RedBoot</I
390
> in Chapter 2</A
391
>). The
392
<B
393
CLASS="COMMAND"
394
>exec</B
395
> parameters used for MIPS boards are:</P
396
><P
397
></P
398
><DIV
399
CLASS="VARIABLELIST"
400
><DL
401
><DT
402
>-b <TT
403
CLASS="REPLACEABLE"
404
><I
405
>&lt;addr&#62;</I
406
></TT
407
></DT
408
><DD
409
><P
410
>Location to store command line and environment passed to kernel</P
411
></DD
412
><DT
413
>-w <TT
414
CLASS="REPLACEABLE"
415
><I
416
>&lt;time&#62;</I
417
></TT
418
></DT
419
><DD
420
><P
421
>Wait time in seconds before starting kernel</P
422
></DD
423
><DT
424
>-c <TT
425
CLASS="REPLACEABLE"
426
><I
427
>"params"</I
428
></TT
429
></DT
430
><DD
431
><P
432
>Parameters passed to kernel</P
433
></DD
434
><DT
435
><TT
436
CLASS="REPLACEABLE"
437
><I
438
>&lt;addr&#62;</I
439
></TT
440
></DT
441
><DD
442
><P
443
>Kernel entry point, defaulting to the entry point of the last image
444
loaded</P
445
></DD
446
></DL
447
></DIV
448
><P
449
>Linux kernels on MIPS platforms expect the entry point to be called with arguments
450
in the registers equivalent to a C call with prototype:
451
<TABLE
452
BORDER="5"
453
BGCOLOR="#E0E0F0"
454
WIDTH="70%"
455
><TR
456
><TD
457
><PRE
458
CLASS="PROGRAMLISTING"
459
>void Linux(int argc, char **argv, char **envp);</PRE
460
></TD
461
></TR
462
></TABLE
463
></P
464
><P
465
>RedBoot will place the appropriate data at the offset specified by the
466
<TT
467
CLASS="PARAMETER"
468
><I
469
>-b</I
470
></TT
471
> parameter, or by default at address 0x80080000, and will set the
472
arguments accordingly when calling into the kernel.</P
473
><P
474
>The default entry point, if no image with explicit entry point has been loaded and
475
none is specified, is 0x80000750.</P
476
></DIV
477
><DIV
478
CLASS="SECT2"
479
><H2
480
CLASS="SECT2"
481
><A
482
NAME="AEN6920">Interrupts</H2
483
><P
484
>RedBoot uses an interrupt vector table which is located at address 0x80000200.
485
Entries in this table are pointers to functions with this protoype:      <TABLE
486
BORDER="5"
487
BGCOLOR="#E0E0F0"
488
WIDTH="70%"
489
><TR
490
><TD
491
><PRE
492
CLASS="PROGRAMLISTING"
493
>int irq_handler( unsigned vector, unsigned data )</PRE
494
></TD
495
></TR
496
></TABLE
497
>On the malta
498
board, the vector argument is one of 22 interrupts defined in <TT
499
CLASS="COMPUTEROUTPUT"
500
>hal/mips/malta/<TT
501
CLASS="REPLACEABLE"
502
><I
503
>VERSION</I
504
></TT
505
>/include/plf_intr.h</TT
506
>: <TABLE
507
BORDER="5"
508
BGCOLOR="#E0E0F0"
509
WIDTH="70%"
510
><TR
511
><TD
512
><PRE
513
CLASS="PROGRAMLISTING"
514
>&#13;#define CYGNUM_HAL_INTERRUPT_SOUTH_BRIDGE_INTR   0
515
#define CYGNUM_HAL_INTERRUPT_SOUTH_BRIDGE_SMI    1
516
#define CYGNUM_HAL_INTERRUPT_CBUS_UART           2
517
#define CYGNUM_HAL_INTERRUPT_COREHI              3
518
#define CYGNUM_HAL_INTERRUPT_CORELO              4
519
#define CYGNUM_HAL_INTERRUPT_COMPARE             5
520
#define CYGNUM_HAL_INTERRUPT_TIMER               6
521
#define CYGNUM_HAL_INTERRUPT_KEYBOARD            7
522
#define CYGNUM_HAL_INTERRUPT_CASCADE             8
523
#define CYGNUM_HAL_INTERRUPT_TTY1                9
524
#define CYGNUM_HAL_INTERRUPT_TTY0               10
525
#define CYGNUM_HAL_INTERRUPT_11                 11
526
#define CYGNUM_HAL_INTERRUPT_FLOPPY             12
527
#define CYGNUM_HAL_INTERRUPT_PARALLEL           13
528
#define CYGNUM_HAL_INTERRUPT_REAL_TIME_CLOCK    14
529
#define CYGNUM_HAL_INTERRUPT_I2C                15
530
#define CYGNUM_HAL_INTERRUPT_PCI_AB             16
531
#define CYGNUM_HAL_INTERRUPT_PCI_CD             17
532
#define CYGNUM_HAL_INTERRUPT_MOUSE              18
533
#define CYGNUM_HAL_INTERRUPT_19                 19
534
#define CYGNUM_HAL_INTERRUPT_IDE_PRIMARY        20
535
#define CYGNUM_HAL_INTERRUPT_IDE_SECONDARY      21</PRE
536
></TD
537
></TR
538
></TABLE
539
>The data
540
passed to the ISR is pulled from a data table (<TT
541
CLASS="COMPUTEROUTPUT"
542
>hal_interrupt_data</TT
543
>) which immediately follows the interrupt vector table. With
544
22 interrupts, the data table starts at address 0x80000258.</P
545
><P
546
>An application may create a normal C function with the above prototype
547
to be an ISR. Just poke its address into the table at the correct index and
548
enable the interrupt at its source. The return value of the ISR is ignored
549
by RedBoot. </P
550
></DIV
551
><DIV
552
CLASS="SECT2"
553
><H2
554
CLASS="SECT2"
555
><A
556
NAME="AEN6929">Memory Maps</H2
557
><P
558
>Memory Maps RedBoot sets up the following memory map on the Malta board.<DIV
559
CLASS="NOTE"
560
><BLOCKQUOTE
561
CLASS="NOTE"
562
><P
563
><B
564
>NOTE: </B
565
>The virtual memory maps in this section use a C and B column to indicate
566
whether or not the region is cached (C) or buffered (B).</P
567
></BLOCKQUOTE
568
></DIV
569
><TABLE
570
BORDER="5"
571
BGCOLOR="#E0E0F0"
572
WIDTH="70%"
573
><TR
574
><TD
575
><PRE
576
CLASS="PROGRAMLISTING"
577
>Physical Address Range  C B  Description
578
----------------------- - -  -----------
579
0x80000000 - 0x81ffffff Y Y  SDRAM
580
0x9e000000 - 0x9e3fffff Y N  System flash (cached)
581
0x9fc00000 - 0x9fffffff Y N  System flash (mirrored)
582
0xa8000000 - 0xb7ffffff N N  PCI Memory Space
583
0xb4000000 - 0xb40fffff N N  Galileo System Controller
584
0xb8000000 - 0xb80fffff N N  Southbridge / ISA
585
0xb8100000 - 0xbbdfffff N N  PCI I/O Space
586
0xbe000000 - 0xbe3fffff N N  System flash (noncached)
587
0xbf000000 - 0xbfffffff N N  Board logic FPGA</PRE
588
></TD
589
></TR
590
></TABLE
591
></P
592
></DIV
593
><DIV
594
CLASS="SECT2"
595
><H2
596
CLASS="SECT2"
597
><A
598
NAME="AEN6936">Rebuilding RedBoot</H2
599
><P
600
>These shell variables provide the platform-specific information
601
needed for building RedBoot according to the procedure described in
602
<A
603
HREF="rebuilding-redboot.html"
604
>Chapter 3</A
605
>:
606
<TABLE
607
BORDER="5"
608
BGCOLOR="#E0E0F0"
609
WIDTH="70%"
610
><TR
611
><TD
612
><PRE
613
CLASS="PROGRAMLISTING"
614
>export TARGET=malta_mips32_4kc
615
export ARCH_DIR=mips
616
export PLATFORM_DIR=malta</PRE
617
></TD
618
></TR
619
></TABLE
620
></P
621
><P
622
>The names of configuration files are listed above with the
623
description of the associated modes.</P
624
></DIV
625
></DIV
626
><DIV
627
CLASS="NAVFOOTER"
628
><HR
629
ALIGN="LEFT"
630
WIDTH="100%"><TABLE
631
SUMMARY="Footer navigation table"
632
WIDTH="100%"
633
BORDER="0"
634
CELLPADDING="0"
635
CELLSPACING="0"
636
><TR
637
><TD
638
WIDTH="33%"
639
ALIGN="left"
640
VALIGN="top"
641
><A
642
HREF="atlas.html"
643
ACCESSKEY="P"
644
>Prev</A
645
></TD
646
><TD
647
WIDTH="34%"
648
ALIGN="center"
649
VALIGN="top"
650
><A
651
HREF="ecos-ref.html"
652
ACCESSKEY="H"
653
>Home</A
654
></TD
655
><TD
656
WIDTH="33%"
657
ALIGN="right"
658
VALIGN="top"
659
><A
660
HREF="ocelot.html"
661
ACCESSKEY="N"
662
>Next</A
663
></TD
664
></TR
665
><TR
666
><TD
667
WIDTH="33%"
668
ALIGN="left"
669
VALIGN="top"
670
>MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Atlas Board</TD
671
><TD
672
WIDTH="34%"
673
ALIGN="center"
674
VALIGN="top"
675
><A
676
HREF="installation-and-testing.html"
677
ACCESSKEY="U"
678
>Up</A
679
></TD
680
><TD
681
WIDTH="33%"
682
ALIGN="right"
683
VALIGN="top"
684
>MIPS/RM7000 PMC-Sierra Ocelot</TD
685
></TR
686
></TABLE
687
></DIV
688
></BODY
689
></HTML
690
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.