Subject: [docathon] converted Ports/mipsco/faq.list
To: None <netbsd-docs@netbsd.org>
From: None <dsieger@techfak.uni-bielefeld.de>
List: netbsd-docs
Date: 04/06/2007 18:14:54
--qGV0fN9tzfkG3CxV
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

mipsco/faq.list is done. patch attached

- Daniel

-- 
Daniel Sieger
Faculty of Technology
Bielefeld University
wwwhomes.uni-bielefeld.de/dsieger

--qGV0fN9tzfkG3CxV
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="mipsco-faq.diff"

Index: layout.xml
===================================================================
RCS file: /cvsroot/htdocs/layout.xml,v
retrieving revision 1.236
diff -u -r1.236 layout.xml
--- layout.xml	6 Apr 2007 13:22:24 -0000	1.236
+++ layout.xml	6 Apr 2007 16:12:42 -0000
@@ -264,7 +264,9 @@
         <tocentry page="Ports/macppc/models.xml" filename="models.html"/>
         <tocentry page="Ports/macppc/x11.xml" filename="x11.html"/>
       </tocentry>
+      <tocentry page="Ports/mipsco/faq.xml" dir="mipsco" filename="faq.html"/>
       <tocentry page="Ports/mmeye/index.xml" dir="mmeye"  filename="."/>
       <tocentry page="Ports/mvme68k/index.xml" dir="mvme68k"  filename="."/>
       <tocentry page="Ports/news68k/index.xml" dir="news68k" filename="."/>
Index: Ports/mipsco/Makefile
===================================================================
RCS file: /cvsroot/htdocs/Ports/mipsco/Makefile,v
retrieving revision 1.6
diff -u -r1.6 Makefile
--- Ports/mipsco/Makefile	14 Oct 2005 08:59:58 -0000	1.6
+++ Ports/mipsco/Makefile	6 Apr 2007 16:12:42 -0000
@@ -1,5 +1,6 @@
 #	$NetBSD: Makefile,v 1.6 2005/10/14 08:59:58 rillig Exp $
 
-LISTDOCS+=	faq.list models.list
+XMLDOCS+=	faq
+LISTDOCS+=	models.list
 
 .include "../../share/mk/web.site.mk"
Index: Ports/mipsco/faq.xml
===================================================================
RCS file: Ports/mipsco/faq.xml
diff -N Ports/mipsco/faq.xml
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ Ports/mipsco/faq.xml	6 Apr 2007 16:12:42 -0000
@@ -0,0 +1,126 @@
+<?xml version="1.0"?>
+<!DOCTYPE webpage
+ PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
+        "http://www.NetBSD.org/share/xml/website-netbsd.dtd">
+
+<webpage id="Ports-mipsco-faq">
+<config param="desc" value="NetBSD/mipsco Frequently Asked Questions"/>
+<config param="cvstag" value="$NetBSD$"/>
+<config param="rcsdate" value="$Date$"/>
+<head>
+
+<!-- Copyright (c) 1994-2007
+	The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
+
+<title>&os;/mipsco: Frequently Asked Questions</title>
+</head>
+
+
+<sect1 role="toc">
+<title>&os;/mipsco Frequently Asked Questions</title>
+
+<sect2>
+<title>General Questions</title>
+
+<sect3 id="dead-nvram">
+<title>NVRAM Setup procedure</title>
+<para>
+If you are having problems with bootp and see your ethernet address
+is 00:00:00:00:00:00 then the most likely cause is your NVRAM
+has reached the end of it's battery life.</para>
+<para>
+The only way to solve the problem is to replace the MK48T02 NVRAM chip
+which is located near <code>U-C8H1</code> on the main board.  You will have
+to remove the Power Supply and look for a chip of non-standard height.
+</para>
+<para>
+Unfortunately the MIPS designer engineers decided to make the first 1k
+of the NVRAM read only.  The only way you can reprogram your Ethernet
+MAC address is to use another machine.  The important values are at the
+start of memory and should be setup as follows:
+</para>
+
+<table id="nvram_values">
+<tgroup cols="2">
+
+<thead>
+<row><entry>Address</entry><entry>Contents</entry></row>
+</thead>
+
+<tbody>
+<row><entry>0x0</entry><entry>MSB of MAC&nbsp;address</entry></row>
+<row><entry>0x1</entry><entry>..</entry></row>
+<row><entry>0x2</entry><entry>..</entry></row>
+<row><entry>0x3</entry><entry>..</entry></row>
+<row><entry>0x4</entry><entry>..</entry></row>
+<row><entry>0x5</entry><entry>LSB of MAC address</entry></row>
+<row><entry>0x6</entry><entry>Machine type (0x0a = Mips Magnum 3000)</entry></row>
+<row><entry>0x7</entry><entry>???</entry></row>
+<row><entry>0x8</entry><entry>???</entry></row>
+<row><entry>0x9</entry><entry>ASCII Serial Number - 1st digit</entry></row>
+<row><entry>0xa</entry><entry>ASCII Serial Number</entry></row>
+<row><entry>0xb</entry><entry>ASCII Serial Number</entry></row>
+<row><entry>0xc</entry><entry>ASCII Serial Number - last
+digit</entry></row>
+</tbody>
+
+</tgroup>
+</table>
+
+<para>
+Additional information about the MK48T02 NVRAM chip can be found in the
+<ulink url="http://www.squirrel.com/squirrel/sun-nvram-hostid.faq.html">
+Sun NVRAM/Hostid FAQ</ulink>.
+</para>
+
+<para>
+The procedure for using a Sun IPX, SS1 or SS2 for reprogramming the NVRAM
+is as follows:
+</para>
+
+<orderedlist>
+<listitem><para>Remove NVRAM from Mips machine and install into Sun Workstation</para></listitem>
+<listitem><para>Boot Sun Workstation and break into firmware monitor</para></listitem>
+<listitem><para>Enter new command mode by entering n</para></listitem>
+<listitem><para>Read the machine serial number which should look like 00ABCD-9111
+     where ABCD is a 4 digit serial number.</para></listitem>
+<listitem><para>Type the following commands in sequence:</para>
+<programlisting>
+    02000000 obio 0 map-page
+    0 7f8 ff fill
+    0 0 c!
+    0 1 c!
+    6b 2 c!
+    AB 3 c!        <emphasis>(AB is first 2 digits of serial number)</emphasis>
+    52 4 c!
+    CD 5 c!        <emphasis>(CD is last 2 digits of serial number)</emphasis>
+    0a 6 c!
+    10 7 c!
+    44 8 c!
+    3A 9 c!        <emphasis>(3 followed by first serial number digit)</emphasis>
+    3B a c!        <emphasis>(3 followed by second serial number digit)</emphasis>
+    3C b c!        <emphasis>(3 followed by third serial number digit)</emphasis>
+    3D c c!        <emphasis>(3 followed by last serial number digit)</emphasis>
+</programlisting>
+</listitem>
+<listitem><para>While at the monitor prompt immediately power down the machine
+ (don't attempt to reboot otherwise the NVRAM will be reinitialized).
+ Transplant the MK48T02 chip into your Mips machine.</para></listitem>
+
+<listitem><para>With a newly initialized NVRAM chip you will hear a beep at powerup
+ and see the startup diagnostics when you connect a terminal to serial 1
+ at 9600 baud.</para>
+ <para>
+ You will probably witness a NVRAM checksum error - at this stage we
+ are unable to locate enough information about the NVRAM format and checksum
+ procedure to correct this.  For now the machine will be usable on the
+ network even with a checksum failure.</para></listitem>
+</orderedlist>
+
+</sect3>
+</sect2>
+</sect1>
+
+<parentsec url="./" text="NetBSD/mipsco ports page"/>
+
+</webpage>

--qGV0fN9tzfkG3CxV--