First cut at NetBSD/ews4800mips install notes. Not well confirmed.

(I guess very few people will actually require it...)

distrib/notes/common/sysinst

@@ -1,4 +1,4 @@
-.\"	$NetBSD: sysinst,v 1.79 2007/01/31 10:12:28 martin Exp $
+.\"	$NetBSD: sysinst,v 1.80 2007/09/28 18:20:13 tsutsui Exp $
 .\"
 .\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -59,8 +59,8 @@
 \n[sandpoint]:\n[sbmips]:\n[sgimips]:\n[x86_64] \{\
 .  ds part_max p
 .\}
-.if \n[acorn26]:\n[acorn32]:\n[cats]:\n[evbarm]:\n[evbppc]:\n[pc532]:\
+.if \n[acorn26]:\n[acorn32]:\n[cats]:\n[evbarm]:\n[evbppc]:\n[ews4800mips]:\
-\n[sandpoint]:\n[shark] \{\
+\n[pc532]:\n[sandpoint]:\n[shark] \{\
 .  ds part_usr e
 .\}
 .if \n[macppc]:\n[news68k]:\n[newsmips]:\n[sparc]:\n[sparc64] \{\
@@ -85,7 +85,7 @@ covers many details for the sake of completeness.
 Do not let this discourage you; the install program is not hard
 to use.
 .
-.if !\n[acorn26]:\n[acorn32]\n[atari]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k] \{\
+.if !\n[acorn26]:\n[acorn32]\n[atari]:\n[ews4800mips]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k] \{\
 .It
 .To 2 "Possible hardware problems"
 .Em Possible hardware problems
@@ -99,7 +99,7 @@ Non-removable devices can be disabled with
 .Ic boot
 .Fl c
 to enter it).
-.\} \" !\n[acorn26]:\n[atari]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k]
+.\} \" !\n[acorn26]:\n[atari]:\n:[ews4800mips]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k]
 .if \n[mac68k] \{\
 .It
 .To 2 "Possible hardware-specific issues"
@@ -184,6 +184,8 @@ The distribution sets (in this example, they are on CD).
 .It
 .ie \n[alpha] Two floppy disks.
 .el \{\
+.ie \n[ews4800mips] Two floppy disks.
+.el \{\
 .ie \n[i386] Two 1.44 MB 3.5" floppy disks if the CD is not bootable or if you cannot boot from CD.
 .el \{\
 .ie \n[mac68k] The Mac OS Booter application and an Installation Kernel
@@ -198,7 +200,7 @@ sysinst.fs image.
 See the "prepare" section about obtaining those.
 .\}
 .el One 1.44 MB 3.5" floppy.
-.\}\}\}\}
+.\}\}\}\}\}
 .\} \" !\n[pmax]:\n[sgimips]:\n[sparc64]
 .if \n[i386] \{\
 .It
@@ -219,6 +221,7 @@ a hard disk and a minimum of
 .if \n[alpha] 32 MB
 .if \n[atari] 4 MB (TT030/Falcon) or 16 MB (Hades/Milan)
 .if \n[cats] 8 MB
+.if \n[ews4800mips] 16 MB
 .if \n[i386] 4 MB
 .if \n[mac68k] 8 MB
 .if \n[macppc] 16 MB
@@ -236,6 +239,7 @@ The hard disk should have at least
 .if \n[alpha] 200
 .if \n[atari] 120
 .if \n[cats] 200
+.if \n[ews4800mips] 200
 .if \n[i386] 200
 .if \n[mac68k] 120
 .if \n[macppc] 200
@@ -256,7 +260,7 @@ main memory in your system.
 If you wish to install the X Window System as well, you will need at least
 120 MB more.
 .bullet)
-.if \n[alpha]:\n[i386]:\n[news68k]:\n[newsmips] \{\
+.if \n[alpha]:\n[ews4800mips]:\n[i386]:\n[news68k]:\n[newsmips] \{\
 .It
 Creating the boot floppies.
 You can create the floppies needed for installation
@@ -275,7 +279,7 @@ command prompt:
 .Dl Ic "rawrite"
 .Pp
 When asked for a source filename, answer
-.if \n[i386] \{\
+.if \n[ews4800mips]:\n[i386] \{\
 .Dl Pa \&..\efloppy\eboot1.fs
 for the first diskette and
 .Dl Pa \&..\efloppy\eboot2.fs
@@ -296,7 +300,7 @@ system, you would type something like:
 .Pp
 .Dl # Ic "dd if=.../boot1.fs of=/dev/rfd0a bs=18k"
 .Pp
-.\} \" \n[alpha]:\n[i386]:\n[news68k]:\n[newsmips]
+.\} \" \n[alpha]:\n[ews4800mips]:\n[i386]:\n[news68k]:\n[newsmips]
 .if \n[mac68k] \{\
 .It
 The NetBSD Boot Tools folder.
@@ -394,6 +398,10 @@ Type
 .Dl \&\*>\*>\*> Ic "B DVA0"
 .Pp
 .\}
+.if \n[ews4800mips] \{\
+Change boot device to floppy on the PROM menu which is invoked by
+pressing ESC key right after hardware checks, and boot the computer again.
+.\}
 .if \n[i386] When prompted, insert the second boot floppy.
 .if \n[news68k] \{\
 Type

distrib/notes/common/xfer

@@ -1,4 +1,4 @@
-.\"	$NetBSD: xfer,v 1.55 2007/01/04 00:19:45 wiz Exp $
+.\"	$NetBSD: xfer,v 1.56 2007/09/28 18:20:13 tsutsui Exp $
 .\"
 .\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -154,14 +154,33 @@ mode.
 .Pp
 .\} \" \n[macppc]
 .
-.if \n[news68k] \{\
+.if \n[ews4800mips]:\n[news68k]:\n[newsmips] \{\
 .(Note
 .Nx*M
-\*V does not support any framebuffers (yet) so
+\*V
+.if \n[ews4800mips] \{\
+does not support framebuffers other than onboard ones on
+EWS4800/350, EWS4800/360AD and EWS4800/360ADII so
+you have to use serial console on installation procedure
+if your machine doesn't have supported framebuffers listed above.
+.\} \" \n[ews4800mips]
+.if \n[news68k] \{\
+does not support any framebuffers (yet) so
 you have to use serial console on installation procedure.
+.\} \" \n[news68k]
+.if \n[newsmips] \{\
+does not support any framebuffers other than NWB-253 on NWS-3470D and
+XA on NWS-5000 (yet) so
+you have to use serial console on installation procedure
+if your machine doesn't have supported framebuffers listed above.
+.\} \" \n[newsmips]
 .Note)
 .Pp
-You will need to have a 1.44 MB floppy disk to boot off.
+You will need to have
+.if \n[ews4800mips] two 1.44 MB floppy disks
+.if \n[news68k] a 1.44 MB floppy disk
+.if \n[newsmips] two 1.44 MB floppy disks
+to boot off.
 You must put the boot floppy image onto this disk, which contains
 software to install
 .Nx
@@ -170,7 +189,12 @@ system.
 If you are using a
 .Ul
 system (such as
+.if \n[ews4800mips] \{\
+.Tn EWS-UX
+.\} \" \n[ews4800mips]
+.if \n[news68k]:\n[newsmips] \{\
 .Tn NEWS-OS
+.\} \" \n[news68k]:\n[newsmips]
 or other
 .Nx
 machines) to write the floppy images to disks, you should use the
@@ -212,8 +236,8 @@ even after
 .Nx*M
 has been installed.
 .Pp
-SCSI devices on NWS-12x0 machines are not supported (yet), so they
+If your machine doesn't have any SCSI disks, or SCSI interface
-can only run
+on your machine is not supported, it can still run
 .Nx*M
 diskless.
 No file transfer is needed, and all you have to do is to prepare files on
@@ -221,6 +245,18 @@ the server.
 More information about diskless setting can be found at
 .Lk http://www.NetBSD.org/Documentation/network/netboot/
 .Pp
+.if \n[ews4800mips] \{\
+The PROM uses the ordinary tftp protocol, so
+you can load bootloader via network.
+The PROM also supports tape boot but
+.Nx*M
+does not support it currently.
+.Pp
+After the boot floppy or diskless server is prepared, just set
+boot device on the PROM menu which can be invoked by pressing ESC key
+right after hardware checks.
+.\} \" \n[ews4800mips]
+.if \n[news68k] \{\
 The
 .Tn NEWS
 PROM also supports tape boot and network boot, but
@@ -232,75 +268,7 @@ After the boot floppy is prepared, just type
 on the PROM prompt to boot it.
 .Pp
 .\} \" \n[news68k]
-.
 .if \n[newsmips] \{\
-.(Note
-.Nx*M
-\*V does not support any framebuffers other than NWB-253 on NWS-3470D and
-XA on NWS-5000 (yet) so
-you have to use serial console on installation procedure.
-.Note)
-.Pp
-You will need to have a 1.44 MB floppy disk to boot off.
-You must put the boot floppy image onto this disk, which contains
-software to install
-.Nx
-system.
-.Pp
-If you are using a
-.Ul
-system (such as
-.Tn NEWS-OS
-or other
-.Nx
-machines) to write the floppy images to disks, you should use the
-.Xr dd 1
-command to copy the file system image(s)
-(.fs file(s)) directly to the raw floppy disk.
-It is suggested that you read the
-.Xr dd 1
-manual page or ask your system administrator to determine the correct
-set of arguments to use; it will be slightly different from system to
-system, and a comprehensive list of the possibilities is beyond the
-scope of this document.
-.Pp
-If you have an i386 machine which runs
-.Tn MS-DOS
-and use them to write the floppy image(s) to floppy disk,
-you can use the
-.Ic rawrite
-utility, provided in the
-.Pa i386/installation/misc
-directory of the
-.Nx
-distribution.
-It will write a file system image (.fs file) to a floppy disk.
-A
-.Ic rawrite32
-is also available that runs under
-.Tn MS Windows .
-.Pp
-Though
-.Nx*M
-uses the floppy disk to boot for the initial
-installation, the
-.Nx*M
-kernel does not support the
-floppy device.
-Some other machines or systems are still required to write floppy images
-even after
-.Nx*M
-has been installed.
-.Pp
-SCSI devices on NWS-3xxx and NWS-5000 machines are supported.
-But they also can run
-.Nx*M
-diskless.
-No file transfer is needed, and all you have to do is to prepare files on
-the server.
-More information about diskless setting can be found at
-.Lk http://www.NetBSD.org/Documentation/network/netboot/
-.Pp
 On NWS-3xxx machines, the PROM also supports network boot but it uses
 an unusual protocol which is not supported by
 .Nx*M .
@@ -320,8 +288,9 @@ After the boot floppy is prepared, just type
 (NWS-5000) or
 .Ic "bo fh"
 (NWS-3xxx) on the PROM prompt to boot it.
-.Pp
 .\} \" \n[newsmips]
+.Pp
+.\} \" \n[ews4800mips]:\n[news68k]:\n[newsmips]
 .
 .if \n[pmax] \{\
 First-time installation on a bare machine is not supported, because most
@@ -616,7 +585,7 @@ and
 .Pp
 Proceed to the instruction on installation.
 .
-.if !\n[news68k]:\n[hp300]:\n[macppc]:\n[pmax]:\n[sgimips]:\n[sparc64]:\n[vax]:\n[x68k] \{\ 
+.if !\n[ews4800mips]:\n[hp300]:\n[macppc]:\n[news68k]:\n[pmax]:\n[sgimips]:\n[sparc64]:\n[vax]:\n[x68k] \{\ 
 .It Em MS-DOS floppy
 .Nx
 doesn't include split sets to keep the distribution size down.

distrib/notes/ews4800mips/Makefile

@@ -0,0 +1,5 @@
+#	$NetBSD: Makefile,v 1.1 2007/09/28 18:20:14 tsutsui Exp $
+
+MERGED_SRCS+=	${COMMON}/sysinst ${COMMON}/upgrade ${COMMON}/xfer
+
+.include <bsd.man.mk>

distrib/notes/ews4800mips/hardware

@@ -0,0 +1,60 @@
+.\"	$NetBSD: hardware,v 1.1 2007/09/28 18:20:14 tsutsui Exp $
+.
+.Nx*M
+\*V will run on some models of MIPS-based NEC EWS4800 workstations,
+EWS4800/350 and EWS4800/360 machines.
+.Pp
+.Nx*M
+\*V does not support all framebuffers so
+.Em you have to use serial console
+to install
+.Nx*M
+on such EWS4800 without a framebuffer listing below.
+.
+.Ss2 Supported hardware
+.(bullet -offset indent
+CPUs
+.(bullet -compact
+"TR2" models: EWS4800/350, EWS4800/350F
+.It
+"TR2A" models: EWS4800/360, EWS4800/360AD, EWS4800/360ADII, EWS4800/360SX,
+EWS4800/360EX
+.bullet)
+.It
+Framebuffer
+.(bullet -compact
+Color framebuffer on EWS4800/360AD and EWS4800/360ADII
+.It
+Color framebuffer on EWS4800/350
+.bullet)
+.It
+Input devices
+.(bullet -compact
+EWS keyboard and mouse
+.bullet)
+.It
+RS232 interfaces
+.(bullet -compact
+built in Zilog 8530 Serial Communication Controllers (zsc)
+.bullet)
+.It
+Network interfaces
+.(bullet -compact
+on-board Intel i82596 based Ethernet on EWS4800/350 (sn)
+.It
+on-board LANCE Ethernet on EWS4800/360 (le)
+.bullet)
+.It
+SCSI interfaces
+.(bullet -compact
+on-board NCR 53C710 SCSI interface (osiop)
+.It
+most SCSI devices
+.bullet)
+.bullet)
+.Pp
+If it's not on this list, there is no official support for it in this release.
+More information can also be found at the
+.Nx*M
+homepage:
+.Lk http://www.NetBSD.org/Ports/\*M/

distrib/notes/ews4800mips/install

@@ -0,0 +1,3 @@
+.\"	$NetBSD: install,v 1.1 2007/09/28 18:20:14 tsutsui Exp $
+.
+.so ../common/sysinst

distrib/notes/ews4800mips/legal

@@ -0,0 +1,2 @@
+.\"	$NetBSD: legal,v 1.1 2007/09/28 18:20:15 tsutsui Exp $
+.

distrib/notes/ews4800mips/prep

@@ -0,0 +1,9 @@
+.\"	$NetBSD: prep,v 1.1 2007/09/28 18:20:15 tsutsui Exp $
+.
+First and foremost, before beginning the installation process,
+.Em make sure you have a reliable backup
+of any data on your hard disk that you wish to keep.
+Mistakes in partitioning your hard disk may lead to data loss.
+.Nx*M
+is still in very experimental state so unexpected trouble could
+also happen even on normal operations.

distrib/notes/ews4800mips/upgrade

@@ -0,0 +1,3 @@
+.\"	$NetBSD: upgrade,v 1.1 2007/09/28 18:20:15 tsutsui Exp $
+.
+.so ../common/upgrade

distrib/notes/ews4800mips/xfer

@@ -0,0 +1,3 @@
+.\"	$NetBSD: xfer,v 1.1 2007/09/28 18:20:15 tsutsui Exp $
+.
+.so ../common/xfer