Subject: [docathon] converted Ports/news68k/faq.list
To: None <netbsd-docs@netbsd.org>
From: None <dsieger@techfak.uni-bielefeld.de>
List: netbsd-docs
Date: 04/06/2007 21:05:35
--cyV/sMl4KAhiehtf
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Ports/news68k/faq.list converted. patch attached.
Note: If you're committing a patch, please be sure to update the
according status entry at
http://wiki.netbsd.se/index.php/Hackathon5#List_of_.list_files
Thanks,
Daniel
--
Daniel Sieger
Faculty of Technology
Bielefeld University
wwwhomes.uni-bielefeld.de/dsieger
--cyV/sMl4KAhiehtf
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="news68k-faq.diff"
Index: layout.xml
===================================================================
RCS file: /cvsroot/htdocs/layout.xml,v
retrieving revision 1.238
diff -u -r1.238 layout.xml
--- layout.xml 6 Apr 2007 17:51:23 -0000 1.238
+++ layout.xml 6 Apr 2007 19:00:26 -0000
@@ -272,7 +272,9 @@
<tocentry page="Ports/mvme68k/faq.xml" filename="faq.html"/>
</tocentry>
<tocentry page="Ports/mvmeppc/faq.xml" filename="faq.html"/>
- <tocentry page="Ports/news68k/index.xml" dir="news68k" filename="."/>
+ <tocentry page="Ports/news68k/index.xml" dir="news68k" filename=".">
+ <tocentry page="Ports/news68k/faq.xml" filename="faq.html"/>
+ </tocentry>
<tocentry page="Ports/newsmips/index.xml" dir="newsmips" filename="."/>
<tocentry page="Ports/next68k/index.xml" dir="next68k" filename=".">
<tocentry page="Ports/next68k/faq.xml" filename="faq.html"/>
Index: Ports/news68k/Makefile
===================================================================
RCS file: /cvsroot/htdocs/Ports/news68k/Makefile,v
retrieving revision 1.5
diff -u -r1.5 Makefile
--- Ports/news68k/Makefile 12 May 2006 11:55:13 -0000 1.5
+++ Ports/news68k/Makefile 6 Apr 2007 19:00:26 -0000
@@ -1,6 +1,6 @@
# $NetBSD: Makefile,v 1.5 2006/05/12 11:55:13 heinz Exp $
-LISTDOCS+= faq.list
+XMLDOCS+= faq
XMLDOCS+= index
.include "../../share/mk/web.site.mk"
Index: Ports/news68k/faq.xml
===================================================================
RCS file: Ports/news68k/faq.xml
diff -N Ports/news68k/faq.xml
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ Ports/news68k/faq.xml 6 Apr 2007 19:00:26 -0000
@@ -0,0 +1,425 @@
+<?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-news68k-faq">
+<config param="desc" value="NetBSD/news68k Frequently Asked Questions"/>
+<config param="cvstag" value="$NetBSD$"/>
+<config param="rcsdate" value="$Date$"/>
+<head>
+
+<!-- Copyright (c) 2002-2007
+ The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
+
+<title>NetBSD/news68k Frequently Asked Questions</title>
+</head>
+
+
+<sect1 role="toc">
+<title>NetBSD/news68k Frequently Asked Questions</title>
+
+<sect2 id="general">
+<title>General Questions</title>
+
+<sect3 id="serial_console">
+<title>How can I set up serial console?</title>
+<para>
+First, turn off the DIP switches 1-3 to specify to use serial console
+for the PROM monitor.
+(see <ulink url="#dip_sw">DIP switch descriptions</ulink> for details)</para>
+<para>
+The NEWS machines use CH0 port for serial console, with
+9600bps, 8 bit char, no parity and 1 stop bit.
+</para>
+<para>
+Serial ports of news1400/1500/1600/1700 use ordinary 25P D-sub connectors,
+so you just need a null modem cable.
+</para>
+<para>
+news1200 uses female 9P D-sub connectors.
+It has the same pin layout with PCs, though they have male 9P connectors.
+</para>
+<para>
+See the <ulink url="../../Documentation/Hardware/Misc/serial.html">NetBSD Serial
+Port Primer</ulink> for more information.
+</para>
+</sect3>
+<sect3 id="dead_nvram">
+<title>My NEWS does not print anything to console!</title>
+<para>
+The NEWS machines use the MK48T02 NVRAM chip, which is also used
+in the SPARCstation machines. If the NVRAM battery is dead,
+they don't boot properly.
+</para>
+<para>
+What you need to do, both with a new NVRAM, or one with a dead battery is
+to press the POWER/RESET buttons in the following order to force
+the PROM monitor to re-initialize the NVRAM:
+</para>
+
+<itemizedlist>
+ <listitem><para>Press and hold POWER button</para></listitem>
+ <listitem><para>Press RESET, while still holding POWER</para></listitem>
+ <listitem><para>Release RESET first</para></listitem>
+ <listitem><para>And then release POWER</para></listitem>
+</itemizedlist>
+
+<para>
+Unlike SPARCstations, you don't have to restore any data
+like the ethernet MAC address.
+The MAC address is stored in ROM on NEWS,
+and only thing you have to set is time of the day for the clock.
+</para>
+
+<para>
+If you are going to replace the dead NVRAM,
+<ulink url="http://www.squirrel.com/squirrel/sun-nvram-hostid.faq.html">
+FAQ about Sun NVRAM/hostid page</ulink> has many useful information about
+the chips. Maybe you could try to
+<ulink url="http://www.squirrel.com/squirrel/sun-nvram-hostid.faq.html#attach">
+attach a new battery onto the NVRAM</ulink>, but on some NEWS models the NVRAM
+might be soldered to the mainboard without socket <code>:-(</code>
+</para>
+</sect3>
+
+<sect3 id="dip_sw">
+<title>How should I set the DIP switches?</title>
+<para>
+news68k machines have one block of 8 dip switches:
+</para>
+
+<table id="console_settings">
+<tgroup cols="1">
+<thead>
+<row>
+ <entry>Switch 1,2,3</entry>
+ <entry>console settings</entry>
+</row>
+</thead>
+<tbody>
+<row>
+ <entry><code>OFF,OFF,OFF</code></entry>
+ <entry>ANSI terminals (i.e. serial console)</entry>
+</row>
+<row>
+ <entry><code>OFF,OFF,ON </code></entry>
+ <entry>NWB-512 monochrome bitmap console</entry>
+</row>
+<row>
+ <entry><code>ON ,OFF,OFF</code></entry>
+ <entry>NWB-225A color bitmap console</entry>
+</row>
+<row>
+ <entry><code>ON ,ON ,ON </code></entry>
+ <entry>newer framebuffers which support autoselection functions
+ (NWS-251, NWB-514 etc.)</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<table id="boot_device">
+<tgroup cols="1">
+<thead>
+<row>
+ <entry>Switch 4</entry>
+ <entry>boot device</entry>
+</row>
+</thead>
+<tbody>
+<row>
+ <entry><code>OFF</code></entry>
+ <entry>boot from SCSI disk: <code>hd()</code></entry>
+</row>
+<row>
+ <entry><code>ON</code></entry>
+ <entry>boot from floppy disk: <code>fh()</code></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<table id="autoboot">
+<tgroup cols="1">
+<thead>
+<row>
+ <entry>Switch 5</entry>
+ <entry>autoboot</entry>
+</row>
+</thead>
+<tbody>
+<row>
+ <entry><code>OFF</code></entry>
+ <entry>PROM monitor</entry>
+</row>
+<row>
+ <entry><code>ON</code></entry>
+ <entry>auto boot</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<table id="diagnostic">
+<tgroup cols="1">
+<thead>
+<row>
+ <entry>Switch 6</entry>
+ <entry>diagnostic (?)</entry>
+</row>
+</thead>
+<tbody>
+<row>
+ <entry><code>OFF</code></entry>
+ <entry>Diag off (default)</entry>
+</row>
+<row>
+ <entry><code>ON</code></entry>
+ <entry>Diag on</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+<table id="unused">
+<tgroup cols="1">
+<thead>
+<row>
+ <entry>Switch 7,8</entry>
+ <entry>unused</entry>
+</row>
+</thead>
+<tbody>
+<row>
+ <entry>default off</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+
+</sect3>
+
+<sect3 id="power_off">
+<title>How can I turn off the machine other than to unplug cable?</title>
+<para>
+Just press the RESET button (without POWER),
+or use <code>"off"</code> command on the PROM prompt.
+</para>
+</sect3>
+
+<sect3 id="bootfd">
+<title>NetBSD/news68k install floppy does not boot</title>
+<para>
+There are some reports that some news1500 machines cannot boot
+the install floppy because of read errors.
+It might be caused by bug of PROM monitor or boot loader,
+or be actual media errors. Workaround is cleanup drives and
+try to boot several times with several disks.
+</para>
+</sect3>
+
+<sect3 id="level_3_int">
+<title>Kernel prints <code>"level 3 interrupt:"</code> forever after boot with power cycle</title>
+<para>
+Some old version of PROM monitors does not initialize framebuffers
+in expantion slots properly when serial console is specified,
+then the framebuffer causes spurious interrupts.
+</para>
+
+<para>
+The workaround is resetting the machine (by POWER+RESET method mentioned above)
+with bitmap console settings once, and then reset again with serial console.
+</para>
+</sect3>
+
+<sect3 id="coexist_news_os">
+<title>Can I install both NetBSD and NEWS-OS in the same disk?</title>
+<para>
+It is not well tested, but not recommended anyway.
+</para>
+<para>
+NetBSD/news68k can recognize NEWS-OS disklabel and mount NEWS-OS disks,
+but once NetBSD modifies the NEWS-OS disklabel, NEWS-OS cannot recognize them.
+It is recommended to install both OS into the separate disks.
+</para>
+</sect3>
+</sect2>
+
+<sect2 id="prom_questions">
+<title>PROM monitor Questions</title>
+
+<sect3 id="prom_command">
+<title>What command can I use on PROM prompt?</title>
+<para>
+<code>help</code> command would show the all commands.
+On my NWS-1750 it says:</para>
+<programlisting>
+NEWS> help
+bf [.{b|w|l}] <bgn> {<end>|:<cnt>} <data> : Block Fill
+bm <bgn> {<end>|:<cnt>} <dest> : Block Move
+bo [<dev>] : BOot
+bp [<addr> [:<cnt>]] ... : BreakPoint set
+cp <src_dev> <bgn>:<cnt> <dst_dev> <dest> : CoPy
+format {fd|fh} : FORMAT floppy
+go [<addr> [<bkpt> [:<cnt>]]] : GO to user program
+help : display this
+md [.{b|w|l}] [<bgn> [{<end>|:<cnt>}]] : Memory Display
+ms [.{b|w|l}] [<addr> [<data>]] : Memory Set
+mu : Memory Usage
+nobp [<addr>] ... : NO BreakPoint
+off : turn power OFF
+rc : Re-assign Console
+rd [{dreg|areg|preg|creg|mreg}] ... : Register Display
+rr : Register Reset
+rs [<reg> [<data>]] : Register Set
+set [<var>[=<value>]] : SET variable
+st [:<cnt>] : Stack back Trace
+tr [:<cnt>] [branch] [{dreg|areg|preg|creg|mreg}] : instruction TRace
+vers : VERSion number
+NEWS>
+</programlisting>
+<para>
+The other machines might print these messages differently,
+but they should be mostly same.
+</para>
+<para>
+For boot command, you can specify the following options:</para>
+<table id="boot_options">
+<tgroup cols="1">
+<tbody>
+<row>
+ <entry><code>bo</code></entry>
+ <entry>boot from default device (usually <code>sd0</code>)</entry>
+</row>
+<row>
+ <entry><code>bo /1</code></entry>
+ <entry>boot with <code>RB_ASKNAME</code>
+ (i.e. ask root device before mountroot)</entry>
+</row>
+<row>
+ <entry><code>bo /2</code></entry>
+ <entry>boot with <code>RB_SINGLE</code>
+ (i.e. go to single-user mode)</entry>
+</row>
+<row>
+ <entry><code>bo fh()</code></entry>
+ <entry>boot from 1.44M floppy</entry>
+</row>
+<row>
+ <entry><code>bo hd(1)</code></entry>
+ <entry>boot from SCSI disk of ID 1</entry>
+</row>
+<row>
+ <entry><code>bo /2 hd()/netbsd.0 </code></entry>
+ <entry>boot <code>"netbsd.0"</code> on <code>sd0</code> with single-user</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</sect3>
+
+<sect3 id="netboot">
+<title>Can NetBSD/news68k boot via network?</title>
+<para>
+No, not yet.
+</para>
+<para>
+The PROM monitor of news68k machines uses "remote disk (rd)" protocol
+for diskless boot, but it is supported by only NEWS-OS and
+there is no document about it.
+</para>
+<para>
+Maybe <code>rd_rpc.h</code> or <code>rd_srq.h</code> in NEWS-OS might be help,
+but currently no one is working on it (yet).
+</para>
+</sect3>
+</sect2>
+
+<sect2 id="hardware_questions">
+<title>Hardware Questions</title>
+
+<sect3 id="spec">
+<title>What is the spec of my NEWS?</title>
+<para>
+There is a
+<ulink url="http://katsu.watanabe.name/doc/sonynews/model.html">
+page of SONY NEWS specifications</ulink>.
+This page is written in Japanese, but I guess it is still useful enough.
+</para>
+</sect3>
+
+<sect3 id="memory">
+<title>Which type of SIMM can be used for my NEWS?</title>
+<para>
+For news1600/1700 machines, 30pin 1M SIMMs with 9 chips
+can be used to upgrade to 16M bytes.
+SIMMs with 3 chips or SIMMs without parity cannot be used.
+To upgrade from 16M to 32M, the optional memory board is required.
+</para>
+<para>
+For news1400/1500 machines, 30pin 1M SIMMs with 8 or 9 chips can be used.
+(i.e. these machines don't use parity bit.)
+SIMMs with 2 or 3 chips cannot be used.
+</para>
+</sect3>
+
+<sect3 id="news1800">
+<title>Are there any hope to support NWS-18x0 models?</title>
+<para>
+Unfortunately, there are many problem to support news1800 machines.
+news1800 models have dual 68030 CPUs. One is a main processor, and another is
+an "I/O Processor". All devices (tty, ethernet, SCSI etc.) are connected to
+the IOP, but there are very few information how to handle them.
+The NEWS-OS provides a special module for the IOP called "MRX",
+and it is loaded by the PROM at boot time from the root directory.
+</para>
+<para>
+Some people had asked the NEWS device information to Sony,
+and they once had planned to open their NEWS-OS sources.
+But there were many problem for it because the sources had many license issues,
+and the NEWS development division in Sony had already been dissolved so
+no one could resolve the issues officially.
+</para>
+</sect3>
+
+<sect3 id="news800">
+<title>Then, what about NWS-8xx and NWS-7xx models?</title>
+<para>
+The one problem is that news800 models also use an I/O processor,
+which is mentioned in the above entry.
+Another problem is news800 uses m68020 and the Sony own MMU, not Motorola
+m68851 MMU. news700 also has the original MMU like news800.
+There are few information about it, neither.
+</para>
+</sect3>
+</sect2>
+
+<sect2 id="other_info">
+<title>Other sources of information</title>
+
+<sect3 id="other_info_nbsd">
+<title>Other information on NetBSD.org</title>
+
+<itemizedlist>
+<listitem><para><ulink url="ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-1.6/news68k/INSTALL.html">
+ NetBSD/news68k 1.6 install notes</ulink> - supported hardware and how to
+ install.</para></listitem>
+<listitem><para><ulink url="../../MailingLists/#port-news68k">port-news68k mail list</ulink>
+ (<ulink url="http://mail-index.NetBSD.org/port-news68k/">archive</ulink>)
+ - if you have any additional questions please subscribe.</para></listitem>
+<listitem><para><ulink url="../newsmips/history.html">History of NEWS machines</ulink>
+ - A brief history of machines running NetBSD/newsmips and NetBSD/news68k.</para></listitem>
+<listitem><para><ulink url="../../Documentation/elf.html">The NetBSD ELF FAQ</ulink>
+ - NetBSD/news68k port has switched to ELF instead of a.out
+ after 1.5 release.</para></listitem>
+<listitem><para><ulink url="../../Documentation/Hardware/Misc/serial.html">NetBSD Serial
+Port Primer</ulink></para></listitem>
+<listitem><para><ulink url="../../Documentation/">General NetBSD Documentation</ulink>
+ - for questions not specific to NetBSD/news68k.</para></listitem>
+</itemizedlist>
+</sect3>
+</sect2>
+
+</sect1>
+</webpage>
--cyV/sMl4KAhiehtf--