[src/netbsd-1-6]: src/distrib/notes/walnut Pull up revision 1.1 (requested by...

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1a448ccbff6b
branches:  netbsd-1-6
changeset: 528003:1a448ccbff6b
user:      lukem <lukem%NetBSD.org@localhost>
date:      Wed Jun 19 00:52:35 2002 +0000

description:
Pull up revision 1.1 (requested by wiz in ticket #289):
Add walnut installation notes.
Information to fill them mostly provided by eeh and simonb.
Fix some random buglets I stumbled over.

diffstat:

 distrib/notes/walnut/Makefile |    5 +
 distrib/notes/walnut/hardware |  126 ++++++++++++++++++++++++++++++++++++++++++
 distrib/notes/walnut/install  |   25 ++++++++
 distrib/notes/walnut/legal    |   25 ++++++++
 distrib/notes/walnut/prep     |   15 +++++
 distrib/notes/walnut/upgrade  |    5 +
 distrib/notes/walnut/whatis   |    4 +
 distrib/notes/walnut/xfer     |    3 +
 8 files changed, 208 insertions(+), 0 deletions(-)

diffs (240 lines):

diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/Makefile     Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,5 @@
+#      $NetBSD: Makefile,v 1.1.2.2 2002/06/19 00:52:35 lukem Exp $
+
+MERGED_SRCS+=${.CURDIR}/../common/sysinst ${.CURDIR}/../common/upgrade
+
+.include <bsd.man.mk>
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/hardware     Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,126 @@
+.\"    $NetBSD: hardware,v 1.1.2.2 2002/06/19 00:52:44 lukem Exp $
+.
+.Nx*M
+is a port of
+.Nx
+to the IBM PowerPC 405GP based walnut evaluation board.
+.
+.Ss2 Supported devices
+.(bullet -offset indent
+Ethernet:
+The built-in Ethernet card is not supported, so another PCI
+Ethernet card supported by
+.Nx
+must be provided if you want to use
+.Nx*M
+on a network.
+Any PCI Ethernet card supported by
+.Nx
+should work.
+.It
+SCSI:
+Any PCI SCSI card supported by
+.Nx
+should work, as should most SCSI disk/tape/CD-ROM devices.
+.It
+IDE:
+.(bullet -compact
+.\" XXXX
+Promise Ultra66
+.Pq Em pciide
+.It
+Other PCI IDE controllers should work, but there are no reports.
+.It
+Most IDE disk/CD-ROM/ATAPI devices should work.
+.bullet)
+.It
+Audio
+.(bullet -compact
+PCI audio cards, although none have been tested.
+.bullet)
+.It
+Serial ports
+.(bullet -compact
+On-board serial ports
+.Pq Em com0
+and
+.Pq Em com1
+.It
+Some PCI serial ports should work, but no one has tried them
+.bullet)
+.It
+PCI cards
+.(bullet -compact
+Most MI PCI cards should work, although very few have been tested with
+.Nx*M
+.Lk http://www.netbsd.org/Hardware/pci.html
+.bullet)
+.bullet)
+.
+.Ss2 Unsupported devices
+.(bullet -offset indent
+On-board Ethernet
+.Pp
+.Em Note :
+This does not concern booting the kernel itself, since that
+is done by the firmware.  For using an NFS root you will have to
+provide a supported network card, though.
+.bullet)
+.
+.Ss2 Supported boot devices and media
+.
+The firmware only supports booting from network or the serial port,
+so you cannot boot from disk even if you install a disk controller.
+Instructions for booting from serial port are not provided; in the
+following we will describe how to setup netbooting.
+.Pp
+The first step is setting the IP addresses of both the walnut itself
+and the host that will be serving the kernel image. From the main menu,
+choose 3 to set the IP address of the machine:
+.(disp
+  1 - Enable/disable tests
+  2 - Enable/disable boot devices
+  3 - Change IP addresses
+  4 - Ping test
+  5 - Toggle ROM monitor debugger
+  6 - Toggle automatic menu
+  7 - Display configuration
+  8 - Save changes to configuration
+  9 - Set baud rate for s1 boot
+  A - Enable/disable I cache (Enabled )
+  B - Enable/disable D cache (Enabled )
+  0 - Exit menu and continue
+-> 3
+.disp)
+.Pp
+Set the IP address for the local Ethernet with 1:
+.(disp
+---   CHANGE IP ADDRESS   ---    
+ Device List:
+   001  Enabled   Ethernet      [ENET]
+                  local=0.0.0.0  remote=0.0.0.0  hwaddr=0004ace312bd
+   004  Disabled  Serial Port 2 [S2]
+                  local=8.1.1.2  remote=255.255.255.255  hwaddr=ffffffffffff
+ ----------------------------      
+select device to change ->1    
+  1 - Change local address
+  2 - Change remote address
+  0 - Return to main menu   
+->1 
+Current IP address = (0.0.0.0)
+Enter new IP address ->Enter IP address in dot notation, (eg. 8.1.1.2)
+.disp)
+.Pp
+Here you enter the machine's IP address, e.g. 10.0.0.1.
+Now you need to do the same thing to set the host IP address (choice 2
+from the menu above).
+.Pp
+Once both the local and remote addresses are set, you can use
+the ping test to make sure the ethernet is working; or you can
+simply use option 0, "Exit menu and continue" to try to boot the
+machine, if you already set up the remote machine to provide
+a kernel image.  For details on how to do that, see the
+.Dq Booting from the network
+section below.
+.Pp
+You should now be able to boot the operating system.
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/install      Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,25 @@
+.\"    $NetBSD: install,v 1.1.2.2 2002/06/19 00:52:52 lukem Exp $
+.
+.Ss2 Booting the installer
+.
+The kernel starts automatically once it is loaded.
+.
+.Ss2 Example of a normal boot
+.
+If you already configured the network settings, just press
+.Sq 0
+from the boot menu to boot.
+.
+.Ss2 Common Problems and Error Messages
+.
+Do not use the plain ELF kernel as the file provided to the
+firmware, use the
+.Dq netbsd.img
+file (which is in the format the firmware expects).
+Of course, you should put the matching
+.Dq netbsd
+as
+.Pa /netbsd
+on your root file system, otherwise some kernel grovellers won't work.
+.
+.so ../common/sysinst
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/legal
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/legal        Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,25 @@
+.\"    $NetBSD: legal,v 1.1.2.2 2002/06/19 00:53:00 lukem Exp $
+.
+.It
+This product includes software developed by Brini.
+.It
+This product includes software developed by Mark Brinicombe
+for the NetBSD Project.
+.It
+This product includes software developed by Mark Brinicombe.
+.It
+This product includes software developed by Christopher G. Demetriou
+for the NetBSD Project.
+.It
+This product includes software developed by Charles M. Hannum.
+.It
+This product includes software developed by the NetBSD Foundation, Inc.
+and its contributors.
+.It
+This product includes software developed by TooLs GmbH.
+.It
+This product includes software developed by the University of
+California, Berkeley and its contributors.
+.It
+This product includes software developed for the NetBSD Project by
+Wasabi Systems, Inc.    
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/prep
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/prep Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,15 @@
+.\"    $NetBSD: prep,v 1.1.2.2 2002/06/19 00:53:09 lukem Exp $
+.
+When installing NetBSD for your
+.Nx*M
+system, you have two options: Via serial port or via network.
+The firmware does not support loading the kernel from a disk.
+.
+.Ss2 Booting over a serial line
+.
+This is not currently documented or supported.  If you would like to
+attempt this and supply documentation, please do!
+.
+.Ss2 Booting from the network
+.
+.so ../common/netboot
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/upgrade
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/upgrade      Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,5 @@
+.\"    $NetBSD: upgrade,v 1.1.2.2 2002/06/19 00:53:17 lukem Exp $
+.
+This is the first release of
+.Nx*M ,
+and as such, there is no ability to upgrade from a prior release.
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/whatis
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/whatis       Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,4 @@
+.\"    $NetBSD: whatis,v 1.1.2.2 2002/06/19 00:53:25 lukem Exp $
+.
+This is the first major release of 
+.Nx*M .
diff -r 8c6ab1d64f7d -r 1a448ccbff6b distrib/notes/walnut/xfer
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/walnut/xfer Wed Jun 19 00:52:35 2002 +0000
@@ -0,0 +1,3 @@
+.\"    $NetBSD: xfer,v 1.1.2.2 2002/06/19 00:53:36 lukem Exp $
+.
+.so ../common/xfer