[src/trunk]: src/distrib/notes/evbarm First cut at installation notes for Net...

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

details:   https://anonhg.NetBSD.org/src/rev/66c3800e59dc
branches:  trunk
changeset: 518474:66c3800e59dc
user:      thorpej <thorpej%NetBSD.org@localhost>
date:      Fri Nov 30 23:48:50 2001 +0000

description:
First cut at installation notes for NetBSD/evbarm.  Needs some
fleshing-out (and general "how to set up diskless environment"
instructions in the ../common directory).

Supported hardware and setup for the Intel IQ80310 board is written.

I've filled in the supported-hardware bits for the ARM Integrator
board, but someone (HI RICHARD! :-) will need to provide info about
setting up the firmware for booting and typical run-time environments
for this board.

diffstat:

 distrib/notes/evbarm/INSTALL.ASCII.toc      |   42 +++++++++
 distrib/notes/evbarm/INSTALL.HTML.toc       |   42 +++++++++
 distrib/notes/evbarm/INSTALL.PostScript.toc |   42 +++++++++
 distrib/notes/evbarm/INSTALL.more.toc       |   42 +++++++++
 distrib/notes/evbarm/Makefile               |    3 +
 distrib/notes/evbarm/hardware               |   93 ++++++++++++++++++++
 distrib/notes/evbarm/install                |  126 ++++++++++++++++++++++++++++
 distrib/notes/evbarm/legal                  |   10 ++
 distrib/notes/evbarm/prep                   |   73 ++++++++++++++++
 distrib/notes/evbarm/upgrade                |    5 +
 distrib/notes/evbarm/whatis                 |   16 +++
 distrib/notes/evbarm/xfer                   |    3 +
 12 files changed, 497 insertions(+), 0 deletions(-)

diffs (truncated from 545 to 300 lines):

diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/INSTALL.ASCII.toc
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/INSTALL.ASCII.toc    Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,42 @@
+.Ti 0 1 "About this Document"
+.Ti 0 2 "What is NetBSD?"
+.Ti 0 2 "Upgrade path to NetBSD 1.5.1"
+.Ti 0 2 "Major Changes Between 1.5 and 1.5.1"
+.Ti 0 4 "Changes Between The NetBSD 1.4 and 1.5 Releases"
+.Ti 1 4 "Kernel"
+.Ti 1 4 "Networking"
+.Ti 1 5 "File system"
+.Ti 1 5 "Security"
+.Ti 1 5 "System administration and user tools"
+.Ti 1 6 "Miscellaneous"
+.Ti 0 6 "The Future of NetBSD"
+.Ti 0 7 "Sources of NetBSD"
+.Ti 0 7 "NetBSD 1.5Y Release Contents"
+.Ti 1 9 "NetBSD/evbarm subdirectory structure"
+.Ti 1 9 "Binary distribution sets"
+.Ti 0 10 "NetBSD/evbarm System Requirements and Supported Devices"
+.Ti 1 10 "Supported devices (ARM, Ltd. Integrator)"
+.Ti 2 10 "PrimeCell PL030 Real Time Clock"
+.Ti 2 10 "Serial ports"
+.Ti 2 10 "SCSI host adapters"
+.Ti 2 10 "Ethernet adapters"
+.Ti 1 11 "Supported devices (Intel IQ80310)"
+.Ti 2 11 "Serial ports"
+.Ti 2 11 "Ethernet adapters"
+.Ti 2 11 "i80312 Companion I/O functions"
+.Ti 0 11 "Getting the NetBSD System on to Useful Media"
+.Ti 0 13 "Preparing your System for NetBSD installation"
+.Ti 1 13 "Preparation for the Intel IQ80310"
+.Ti 0 14 "Installing the NetBSD System"
+.Ti 1 14 "Installation for the Intel IQ80310"
+.Ti 0 15 "Post installation steps"
+.Ti 0 17 "Upgrading a previously-installed NetBSD System"
+.Ti 0 17 "Compatibility Issues With Previous NetBSD Releases"
+.Ti 1 18 "General issues"
+.Ti 1 18 "Issues affecting an upgrade from NetBSD 1.4 or prior"
+.Ti 0 18 "Using online NetBSD documentation"
+.Ti 0 19 "Administrivia"
+.Ti 0 19 "Thanks go to"
+.Ti 0 22 "We are..."
+.Ti 0 25 "Legal Mumbo-Jumbo"
+.Ti 0 27 "The End"
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/INSTALL.HTML.toc
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/INSTALL.HTML.toc     Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,42 @@
+.Ti 0 1 "About this Document"
+.Ti 0 2 "What is NetBSD?"
+.Ti 0 2 "Upgrade path to NetBSD 1.5.1"
+.Ti 0 2 "Major Changes Between 1.5 and 1.5.1"
+.Ti 0 4 "Changes Between The NetBSD 1.4 and 1.5 Releases"
+.Ti 1 4 "Kernel"
+.Ti 1 4 "Networking"
+.Ti 1 5 "File system"
+.Ti 1 5 "Security"
+.Ti 1 5 "System administration and user tools"
+.Ti 1 6 "Miscellaneous"
+.Ti 0 6 "The Future of NetBSD"
+.Ti 0 7 "Sources of NetBSD"
+.Ti 0 7 "NetBSD 1.5Y Release Contents"
+.Ti 1 9 "NetBSD/evbarm subdirectory structure"
+.Ti 1 9 "Binary distribution sets"
+.Ti 0 10 "NetBSD/evbarm System Requirements and Supported Devices"
+.Ti 1 10 "Supported devices (ARM, Ltd. Integrator)"
+.Ti 2 10 "PrimeCell PL030 Real Time Clock"
+.Ti 2 10 "Serial ports"
+.Ti 2 10 "SCSI host adapters"
+.Ti 2 10 "Ethernet adapters"
+.Ti 1 11 "Supported devices (Intel IQ80310)"
+.Ti 2 11 "Serial ports"
+.Ti 2 11 "Ethernet adapters"
+.Ti 2 11 "i80312 Companion I/O functions"
+.Ti 0 11 "Getting the NetBSD System on to Useful Media"
+.Ti 0 13 "Preparing your System for NetBSD installation"
+.Ti 1 13 "Preparation for the Intel IQ80310"
+.Ti 0 14 "Installing the NetBSD System"
+.Ti 1 14 "Installation for the Intel IQ80310"
+.Ti 0 15 "Post installation steps"
+.Ti 0 17 "Upgrading a previously-installed NetBSD System"
+.Ti 0 17 "Compatibility Issues With Previous NetBSD Releases"
+.Ti 1 18 "General issues"
+.Ti 1 18 "Issues affecting an upgrade from NetBSD 1.4 or prior"
+.Ti 0 18 "Using online NetBSD documentation"
+.Ti 0 19 "Administrivia"
+.Ti 0 19 "Thanks go to"
+.Ti 0 22 "We are..."
+.Ti 0 25 "Legal Mumbo-Jumbo"
+.Ti 0 27 "The End"
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/INSTALL.PostScript.toc
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/INSTALL.PostScript.toc       Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,42 @@
+.Ti 0 1 "About this Document"
+.Ti 0 2 "What is NetBSD?"
+.Ti 0 2 "Upgrade path to NetBSD 1.5.1"
+.Ti 0 2 "Major Changes Between 1.5 and 1.5.1"
+.Ti 0 4 "Changes Between The NetBSD 1.4 and 1.5 Releases"
+.Ti 1 4 "Kernel"
+.Ti 1 4 "Networking"
+.Ti 1 4 "File system"
+.Ti 1 5 "Security"
+.Ti 1 5 "System administration and user tools"
+.Ti 1 5 "Miscellaneous"
+.Ti 0 6 "The Future of NetBSD"
+.Ti 0 6 "Sources of NetBSD"
+.Ti 0 6 "NetBSD 1.5Y Release Contents"
+.Ti 1 8 "NetBSD/evbarm subdirectory structure"
+.Ti 1 8 "Binary distribution sets"
+.Ti 0 9 "NetBSD/evbarm System Requirements and Supported Devices"
+.Ti 1 10 "Supported devices (ARM, Ltd. Integrator)"
+.Ti 2 10 "PrimeCell PL030 Real Time Clock"
+.Ti 2 10 "Serial ports"
+.Ti 2 10 "SCSI host adapters"
+.Ti 2 10 "Ethernet adapters"
+.Ti 1 10 "Supported devices (Intel IQ80310)"
+.Ti 2 10 "Serial ports"
+.Ti 2 10 "Ethernet adapters"
+.Ti 2 10 "i80312 Companion I/O functions"
+.Ti 0 10 "Getting the NetBSD System on to Useful Media"
+.Ti 0 12 "Preparing your System for NetBSD installation"
+.Ti 1 12 "Preparation for the Intel IQ80310"
+.Ti 0 13 "Installing the NetBSD System"
+.Ti 1 13 "Installation for the Intel IQ80310"
+.Ti 0 14 "Post installation steps"
+.Ti 0 17 "Upgrading a previously-installed NetBSD System"
+.Ti 0 17 "Compatibility Issues With Previous NetBSD Releases"
+.Ti 1 17 "General issues"
+.Ti 1 17 "Issues affecting an upgrade from NetBSD 1.4 or prior"
+.Ti 0 17 "Using online NetBSD documentation"
+.Ti 0 18 "Administrivia"
+.Ti 0 18 "Thanks go to"
+.Ti 0 21 "We are..."
+.Ti 0 26 "Legal Mumbo-Jumbo"
+.Ti 0 27 "The End"
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/INSTALL.more.toc
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/INSTALL.more.toc     Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,42 @@
+.Ti 0 1 "About this Document"
+.Ti 0 2 "What is NetBSD?"
+.Ti 0 2 "Upgrade path to NetBSD 1.5.1"
+.Ti 0 2 "Major Changes Between 1.5 and 1.5.1"
+.Ti 0 4 "Changes Between The NetBSD 1.4 and 1.5 Releases"
+.Ti 1 4 "Kernel"
+.Ti 1 4 "Networking"
+.Ti 1 5 "File system"
+.Ti 1 5 "Security"
+.Ti 1 5 "System administration and user tools"
+.Ti 1 6 "Miscellaneous"
+.Ti 0 6 "The Future of NetBSD"
+.Ti 0 7 "Sources of NetBSD"
+.Ti 0 7 "NetBSD 1.5Y Release Contents"
+.Ti 1 9 "NetBSD/evbarm subdirectory structure"
+.Ti 1 9 "Binary distribution sets"
+.Ti 0 10 "NetBSD/evbarm System Requirements and Supported Devices"
+.Ti 1 10 "Supported devices (ARM, Ltd. Integrator)"
+.Ti 2 10 "PrimeCell PL030 Real Time Clock"
+.Ti 2 10 "Serial ports"
+.Ti 2 10 "SCSI host adapters"
+.Ti 2 10 "Ethernet adapters"
+.Ti 1 11 "Supported devices (Intel IQ80310)"
+.Ti 2 11 "Serial ports"
+.Ti 2 11 "Ethernet adapters"
+.Ti 2 11 "i80312 Companion I/O functions"
+.Ti 0 11 "Getting the NetBSD System on to Useful Media"
+.Ti 0 13 "Preparing your System for NetBSD installation"
+.Ti 1 13 "Preparation for the Intel IQ80310"
+.Ti 0 14 "Installing the NetBSD System"
+.Ti 1 14 "Installation for the Intel IQ80310"
+.Ti 0 15 "Post installation steps"
+.Ti 0 17 "Upgrading a previously-installed NetBSD System"
+.Ti 0 17 "Compatibility Issues With Previous NetBSD Releases"
+.Ti 1 18 "General issues"
+.Ti 1 18 "Issues affecting an upgrade from NetBSD 1.4 or prior"
+.Ti 0 18 "Using online NetBSD documentation"
+.Ti 0 19 "Administrivia"
+.Ti 0 19 "Thanks go to"
+.Ti 0 22 "We are..."
+.Ti 0 25 "Legal Mumbo-Jumbo"
+.Ti 0 27 "The End"
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/Makefile     Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,3 @@
+#      $NetBSD: Makefile,v 1.1 2001/11/30 23:48:51 thorpej Exp $
+
+.include <bsd.man.mk>
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/hardware
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/hardware     Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,93 @@
+.\"    $NetBSD: hardware,v 1.1 2001/11/30 23:48:51 thorpej Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\" 
+.Nx \*V
+runs on the following ARM architecture evaluation boards:
+.(bullet -offset indent
+ARM, Ltd. Integrator
+.It
+Intel IQ80310
+.bullet)
+.
+.Ss2 Supported devices (ARM, Ltd. Integrator)
+For devices that have machine-independent drivers,
+this is not an exhaustive list, but merely reflects the
+devices that have been tested on this platform.
+.(bullet -offset indent
+.Te 2 "PrimeCell PL030 Real Time Clock"
+.It
+.Te 2 "Serial ports"
+.(bullet -compact
+PrimeCell PL010 UART
+.bullet)
+.It
+.Te 2 "SCSI host adapters"
+.(bullet -compact
+Adaptec AHA-2910, 2915, 2920, and 2930C adapters.
+.It
+Adaptec AHA-2x4x[U][2][W] cards and onboard PCI designs using the AIC-7770,
+AIC-7850, AIC-7860, AIC-7870, AIC-7880 and AIC-789x chipsets.
+.It
+Adaptec AHA-394x[U][W] cards [b]
+.It
+Adaptec AHA-3950U2 cards
+.It 
+Adaptec AHA-3960, 19160 and 29160 Ultra-160 adapters
+.bullet)
+.It
+.Te 2 "Ethernet adapters"
+.(bullet -compact
+Intel i82557, i82558, i82559, i82550
+.bullet)
+.bullet)
+.
+.Ss2 Supported devices (Intel IQ80310)
+For devices that have machine-independent drivers,
+this is not an exhaustive list, but merely reflects the
+devices that have been tested on this platform.
+.(bullet -offset indent
+.Te 2 "Serial ports"
+.(bullet -compact
+On-board ST16c550 UARTs
+.bullet)
+.It
+.Te 2 "Ethernet adapters"
+.(bullet -compact
+Intel i82557, i82558, i82559, i82550
+.bullet)
+.It
+.Te 2 "i80312 Companion I/O functions"
+.(bullet -compact
+General Purpose I/O unit
+.bullet)
+.bullet)
diff -r b62552df1cf3 -r 66c3800e59dc distrib/notes/evbarm/install
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/evbarm/install      Fri Nov 30 23:48:50 2001 +0000
@@ -0,0 +1,126 @@
+.\"    $NetBSD: install,v 1.1 2001/11/30 23:48:51 thorpej Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.     
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met: