-<!-- 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