--- /dev/null
+<!-- Copyright (C) 2003 Red Hat, Inc. -->
+<!-- This material may be distributed only subject to the terms -->
+<!-- and conditions set forth in the Open Publication License, v1.0 -->
+<!-- or later (the latest version is presently available at -->
+<!-- http://www.opencontent.org/openpub/). -->
+<!-- Distribution of the work or derivative of the work in any -->
+<!-- standard (paper) book form is prohibited unless prior -->
+<!-- permission is obtained from the copyright holder. -->
+<HTML
+><HEAD
+><TITLE
+>MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Atlas Board</TITLE
+><meta name="MSSmartTagsPreventParsing" content="TRUE">
+<META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
+REL="HOME"
+TITLE="eCos Reference Manual"
+HREF="ecos-ref.html"><LINK
+REL="UP"
+TITLE="Installation and Testing"
+HREF="installation-and-testing.html"><LINK
+REL="PREVIOUS"
+TITLE="IA32/x86 x86-Based PC"
+HREF="x86pc.html"><LINK
+REL="NEXT"
+TITLE="MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Malta Board "
+HREF="malta.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>eCos Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="x86pc.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Chapter 5. Installation and Testing</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="malta.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="ATLAS">MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Atlas Board</H1
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6659">Overview</H2
+><P
+>RedBoot supports the DgbSer
+serial port and the built in ethernet port for communication and downloads.
+The default serial port settings are 115200,8,N,1. RedBoot runs from and supports
+flash management for the system flash region.</P
+><P
+>The following RedBoot configurations are supported:
+
+ <DIV
+CLASS="INFORMALTABLE"
+><A
+NAME="AEN6669"><P
+></P
+><TABLE
+BORDER="1"
+CLASS="CALSTABLE"
+><THEAD
+><TR
+><TH
+ALIGN="LEFT"
+VALIGN="TOP"
+>Configuration</TH
+><TH
+ALIGN="LEFT"
+VALIGN="TOP"
+>Mode</TH
+><TH
+ALIGN="LEFT"
+VALIGN="TOP"
+>Description</TH
+><TH
+ALIGN="LEFT"
+VALIGN="TOP"
+>File</TH
+></TR
+></THEAD
+><TBODY
+><TR
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>ROM</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>[ROM]</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>RedBoot running from the board's flash boot
+ sector.</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>redboot_ROM.ecm</TD
+></TR
+><TR
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>RAM</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>[RAM]</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>RedBoot running from RAM with RedBoot in the
+ flash boot sector.</TD
+><TD
+ALIGN="LEFT"
+VALIGN="TOP"
+>redboot_RAM.ecm</TD
+></TR
+></TBODY
+></TABLE
+><P
+></P
+></DIV
+></P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6688">Initial Installation</H2
+><P
+>RedBoot is installed using the code download facility built into the
+Atlas board. See the Atlas User manual for details, and also the Atlas download
+format in <A
+HREF="atlas.html#ATLAS-DOWNLOAD-FORMAT"
+>the Section called <I
+>Atlas download format</I
+></A
+>.</P
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
+NAME="AEN6692">Quick download instructions</H3
+><P
+>Here are quick start instructions for downloading the prebuilt RedBoot
+image.</P
+><P
+></P
+><OL
+TYPE="1"
+><LI
+><P
+>Locate the prebuilt files in the bin directory: <TT
+CLASS="FILENAME"
+>deleteall.dl</TT
+> and <TT
+CLASS="FILENAME"
+>redboot.dl</TT
+>.</P
+></LI
+><LI
+><P
+>Make sure switch S1-1 is OFF and switch S5-1 is ON. Reset
+the board and verify that the LED display reads <TT
+CLASS="COMPUTEROUTPUT"
+>Flash DL</TT
+>.</P
+></LI
+><LI
+><P
+>Make sure your parallel port is connected to the 1284 port
+Of the Atlas board. </P
+></LI
+><LI
+><P
+>Send the <TT
+CLASS="FILENAME"
+>deleteall.dl</TT
+> file to the
+parallel port to erase previous images:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>$ <TT
+CLASS="USERINPUT"
+><B
+>cat deleteall.dl >/dev/lp0</B
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+>
+When this is complete, the LED display should read
+<TT
+CLASS="COMPUTEROUTPUT"
+>Deleted</TT
+>.</P
+></LI
+><LI
+><P
+>Send the ROM mode RedBoot image to the board:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>$ <TT
+CLASS="USERINPUT"
+><B
+>cat redboot.dl >/dev/lp0</B
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+>
+When this is complete, the LED display should show the last
+address programmed. This will be something like: <TT
+CLASS="COMPUTEROUTPUT"
+>1fc17000</TT
+>. </P
+></LI
+><LI
+><P
+>Change switch S5-1 to OFF and reset the board. The LED display
+should read <TT
+CLASS="COMPUTEROUTPUT"
+>RedBoot</TT
+>. </P
+></LI
+><LI
+><P
+>Run the RedBoot <B
+CLASS="COMMAND"
+>fis init</B
+>
+and <B
+CLASS="COMMAND"
+>fconfig</B
+> commands to initialize the flash.
+See <A
+HREF="atlas.html#ATLAS-ADDITIONAL-FCONFIG-OPTIONS"
+>the Section called <I
+>Additional config options</I
+></A
+>, <A
+HREF="flash-image-system.html"
+>the Section called <I
+>Flash Image System (FIS)</I
+> in Chapter 2</A
+>
+and <A
+HREF="persistent-state-flash.html"
+>the Section called <I
+>Persistent State Flash-based Configuration and Control</I
+> in Chapter 2</A
+> for details. </P
+></LI
+></OL
+></DIV
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
+NAME="ATLAS-DOWNLOAD-FORMAT">Atlas download format</H3
+><P
+>In order to download RedBoot to the Atlas board, it must be converted
+to the Atlas download format. There are different ways of doing this depending
+on which version of the developer's kit is shipped with the board. </P
+><P
+>The <I
+CLASS="CITETITLE"
+>Atlas Developer's Kit</I
+> CD contains an <SPAN
+CLASS="APPLICATION"
+>srec2flash</SPAN
+> utility. The source code for this utility is part
+of the <TT
+CLASS="FILENAME"
+>yamon/yamon-src-01.01.tar.gz</TT
+> tarball
+on the Dev Kit CD. The path in the expanded tarball is <TT
+CLASS="FILENAME"
+>yamon/bin/tools</TT
+>. To use
+<SPAN
+CLASS="APPLICATION"
+>srec2flash</SPAN
+> to convert the S-record file:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>$ <TT
+CLASS="USERINPUT"
+><B
+>srec2flash -EL -S29 redboot.srec >redboot.dl</B
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+>
+The <I
+CLASS="CITETITLE"
+>Atlas/Malta Developer's Kit</I
+> CD
+contains an <SPAN
+CLASS="APPLICATION"
+>srecconv.pl</SPAN
+> utility which requires
+Perl. This utilty is part of the <TT
+CLASS="FILENAME"
+>yamon/yamon-src-02.00.tar.gz</TT
+>
+tarball on the Dev Kit CD. The path in the expanded tarball
+is <TT
+CLASS="FILENAME"
+>yamon/bin/tools</TT
+>. To use <SPAN
+CLASS="APPLICATION"
+>srecconv</SPAN
+> to convert the S-record file:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>$ <TT
+CLASS="USERINPUT"
+><B
+>cp redboot_ROM.srec redboot_ROM.rec</B
+></TT
+>
+$ <TT
+CLASS="USERINPUT"
+><B
+>srecconv.pl -ES L -A 29 redboot_ROM</B
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+>
+The resulting file is named <TT
+CLASS="FILENAME"
+>redboot_ROM.fl</TT
+>.</P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6746">Flash management</H2
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
+NAME="ATLAS-ADDITIONAL-FCONFIG-OPTIONS">Additional config options</H3
+><P
+>The ethernet MAC address is stored in flash manually using the <B
+CLASS="COMMAND"
+>fconfig</B
+> command. You can use the YAMON <B
+CLASS="COMMAND"
+>setenv
+ethaddr</B
+> command to print out the board ethernet address.
+Typically, it is: <TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>00:0d:a0:00:<TT
+CLASS="REPLACEABLE"
+><I
+>xx:xx</I
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+> where
+<TT
+CLASS="REPLACEABLE"
+><I
+>xx.xx</I
+></TT
+> is the hex representation of the
+board serial number.</P
+></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6756">Additional commands</H2
+><P
+>The <B
+CLASS="COMMAND"
+>exec</B
+> command which allows the
+loading and execution of Linux kernels, is supported for this architecture
+ (see <A
+HREF="executing-programs.html"
+>the Section called <I
+>Executing Programs from RedBoot</I
+> in Chapter 2</A
+>). The
+<B
+CLASS="COMMAND"
+>exec</B
+> parameters used for MIPS boards are:</P
+><P
+></P
+><DIV
+CLASS="VARIABLELIST"
+><DL
+><DT
+>-b <TT
+CLASS="REPLACEABLE"
+><I
+><addr></I
+></TT
+></DT
+><DD
+><P
+>Location to store command line and environment passed to kernel</P
+></DD
+><DT
+>-w <TT
+CLASS="REPLACEABLE"
+><I
+><time></I
+></TT
+></DT
+><DD
+><P
+>Wait time in seconds before starting kernel</P
+></DD
+><DT
+>-c <TT
+CLASS="REPLACEABLE"
+><I
+>"params"</I
+></TT
+></DT
+><DD
+><P
+>Parameters passed to kernel</P
+></DD
+><DT
+><TT
+CLASS="REPLACEABLE"
+><I
+><addr></I
+></TT
+></DT
+><DD
+><P
+>Kernel entry point, defaulting to the entry point of the last image
+loaded</P
+></DD
+></DL
+></DIV
+><P
+>Linux kernels on MIPS platforms expect the entry point to be called with arguments
+in the registers equivalent to a C call with prototype:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>void Linux(int argc, char **argv, char **envp);</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+>RedBoot will place the appropriate data at the offset specified by the
+<TT
+CLASS="PARAMETER"
+><I
+>-b</I
+></TT
+> parameter, or by default at address 0x80080000, and will set the
+arguments accordingly when calling into the kernel.</P
+><P
+>The default entry point, if no image with explicit entry point has been loaded and
+none is specified, is 0x80000750.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6788">Interrupts</H2
+><P
+>RedBoot uses an interrupt vector table which is located at address 0x80000400.
+Entries in this table are pointers to functions with this protoype: <TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>int irq_handler( unsigned vector, unsigned data )</PRE
+></TD
+></TR
+></TABLE
+>On an atlas
+board, the vector argument is one of 25 interrupts defined in <TT
+CLASS="COMPUTEROUTPUT"
+>hal/mips/atlas/<TT
+CLASS="REPLACEABLE"
+><I
+>VERSION</I
+></TT
+>/include/plf_intr.h</TT
+>: <TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>#define CYGNUM_HAL_INTERRUPT_SER 0
+#define CYGNUM_HAL_INTERRUPT_TIM0 1
+#define CYGNUM_HAL_INTERRUPT_2 2
+#define CYGNUM_HAL_INTERRUPT_3 3
+#define CYGNUM_HAL_INTERRUPT_RTC 4
+#define CYGNUM_HAL_INTERRUPT_COREHI 5
+#define CYGNUM_HAL_INTERRUPT_CORELO 6
+#define CYGNUM_HAL_INTERRUPT_7 7
+#define CYGNUM_HAL_INTERRUPT_PCIA 8
+#define CYGNUM_HAL_INTERRUPT_PCIB 9
+#define CYGNUM_HAL_INTERRUPT_PCIC 10
+#define CYGNUM_HAL_INTERRUPT_PCID 11
+#define CYGNUM_HAL_INTERRUPT_ENUM 12
+#define CYGNUM_HAL_INTERRUPT_DEG 13
+#define CYGNUM_HAL_INTERRUPT_ATXFAIL 14
+#define CYGNUM_HAL_INTERRUPT_INTA 15
+#define CYGNUM_HAL_INTERRUPT_INTB 16
+#define CYGNUM_HAL_INTERRUPT_INTC 17
+#define CYGNUM_HAL_INTERRUPT_INTD 18
+#define CYGNUM_HAL_INTERRUPT_SERR 19
+#define CYGNUM_HAL_INTERRUPT_HW1 20
+#define CYGNUM_HAL_INTERRUPT_HW2 21
+#define CYGNUM_HAL_INTERRUPT_HW3 22
+#define CYGNUM_HAL_INTERRUPT_HW4 23
+#define CYGNUM_HAL_INTERRUPT_HW5 24</PRE
+></TD
+></TR
+></TABLE
+>The data
+passed to the ISR is pulled from a data table (<TT
+CLASS="COMPUTEROUTPUT"
+>hal_interrupt_data</TT
+>) which immediately follows the interrupt vector table. With
+25 interrupts, the data table starts at address 0x80000464 on atlas.</P
+><P
+>An application may create a normal C function with the above prototype
+to be an ISR. Just poke its address into the table at the correct index and
+enable the interrupt at its source. The return value of the ISR is ignored
+by RedBoot. </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6797">Memory Maps</H2
+><P
+>Memory Maps RedBoot sets up the following memory map on the Atlas board.
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>Physical Address Range Description
+----------------------- -------------
+0x00000000 - 0x07ffffff SDRAM
+0x08000000 - 0x17ffffff PCI Memory Space
+0x18000000 - 0x1bdfffff PCI I/O Space
+0x1be00000 - 0x1bffffff System Controller
+0x1c000000 - 0x1dffffff System flash
+0x1e000000 - 0x1e3fffff Monitor flash
+0x1f000000 - 0x1fbfffff FPGA</PRE
+></TD
+></TR
+></TABLE
+></P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN6801">Rebuilding RedBoot</H2
+><P
+>These shell variables provide the platform-specific information
+needed for building RedBoot according to the procedure described in
+<A
+HREF="rebuilding-redboot.html"
+>Chapter 3</A
+>:
+<TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>export TARGET=atlas_mips32_4kc
+export TARGET=atlas_mips64_5kc
+export ARCH_DIR=mips
+export PLATFORM_DIR=atlas</PRE
+></TD
+></TR
+></TABLE
+>
+
+Use one of the TARGET settings only. </P
+><P
+>The names of configuration files are listed above with the
+description of the associated modes.</P
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="x86pc.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="ecos-ref.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="malta.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>IA32/x86 x86-Based PC</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="installation-and-testing.html"
+ACCESSKEY="U"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>MIPS/MIPS32(CoreLV 4Kc)+MIPS64(CoreLV 5Kc) Malta Board</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
\ No newline at end of file
projects / karo-tx-redboot.git / blobdiff