[src/trunk]: src/distrib/notes/macppc Substantial overhaul which splits OF ve...

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

details:   https://anonhg.NetBSD.org/src/rev/0d62df23c9c9
branches:  trunk
changeset: 551227:0d62df23c9c9
user:      mbw <mbw%NetBSD.org@localhost>
date:      Tue Sep 02 05:47:24 2003 +0000

description:
Substantial overhaul which splits OF versions up for clarity.  Much of
what was in prep is now in prep.OPENFIRMWARE.

prep now calls prep.OPENFIRMWARE twice.  The first time, it generates
documentation specific to Open Firmware 3 systems.  The second pass, it
outputs OF 1.x and 2.x specific stuff.  This makes it easier to follow
directions for a particular class of machines.

diffstat:

 distrib/notes/macppc/prep              |  1837 +-------------------------------
 distrib/notes/macppc/prep.OPENFIRMWARE |  1631 ++++++++++++++++++++++++++++
 2 files changed, 1653 insertions(+), 1815 deletions(-)

diffs (truncated from 3508 to 300 lines):

diff -r c6629d316453 -r 0d62df23c9c9 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Tue Sep 02 05:43:39 2003 +0000
+++ b/distrib/notes/macppc/prep Tue Sep 02 05:47:24 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.39 2003/07/26 17:07:09 salo Exp $
+.\"    $NetBSD: prep,v 1.40 2003/09/02 05:47:24 mbw Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -37,7 +37,7 @@
 See the FAQ for more help:
 .Lk http://www.NetBSD.org/Ports/macppc/faq.html#macos-newbie
 .Pp
-It's done printing?  Fine, now get a dark writing implement.
+It's done printing?  Fine, time to get started.
 .Pp
 The recommended installation procedure is as follows:
 .(enum
@@ -49,15 +49,9 @@
 .Pp
 .It
 Spend about 15 minutes and read through this document from this point onward.
-While you're reading, use the writing implement to cross out the
-sections that do not apply to your model (or hilight the sections that do
-depending on your preferences).
-.Pp
-.It
-Now spend another 5 minutes and re-read this document, and mentally piece
-together how you think you'll be installing onto your machine.
-It may help to take a blank piece of paper and write out an outline of the
-procedure you think you'll be going through.
+There will be many pages of instructions that apply to Open Firmware versions
+that you do not have.  Throw them out.  Do not read them \(em at best you 
+will be confused, at worst you may damage your system requiring repairs.
 .Pp
 .It
 Now create your bootable media and media for the distribution sets.
@@ -76,7 +70,7 @@
 Figure out the correct boot command, and boot your machine from the
 bootable media you just created.
 If you're having trouble, be sure to read the section on
-.Sx Common Problems and Error Messages
+.Sx "Common Problems and Error Messages"
 .Pp
 .It
 Celebrate!
@@ -121,1810 +115,23 @@
 (Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open
 Firmware 2.4, Open Firmware 3)
 .Note)
-.
-.Ss2 Updating your BootROM
-.
-(Open Firmware 3)
-.Pp
-Open Firmware 3 systems have a rewritable
-.Dq firmware ,
-also called the BootROM.
-When you use an Apple firmware updater, it updates the BootROM.
-This will
-.Em not
-change the version of Open Firmware in your machine \(em it will still be
-Open Firmware 3.
-The BootROM is what is first executed when you power on or reset your system.
-The BootROM then loads Open Firmware, which boots your operating system.
-.Pp
-Go to the
-.Sq "Apple Software Downloads"
-web site at
-.Lk http://www.info.apple.com/support/downloads.html
-and search for
-.Sq firmware
-and install the most recent version for your model.
-You will need to run the FirmWare updater from MacOS 9.
-.Pp
-.(Note
-If you accidentally set the
-.Ic load-base No or Ic real-base
-Open Firmware variables and reset your machine you will, in effect,
-rewrite the BootROM with garbage, rendering your machine unbootable.
-We recommend not doing this.
-.Note)
-.(Note
-The most recent BootROMs available (4.1.7 and later) are a little picky
-about RAM.  Initially, some PowerMacintosh users found that their
-third-party RAM had been disabled, but the RAM vendors brought their RAM
-up to spec and it hasn't been much of an issue since then.
-.Pp
-There are reports that FirmWare Update 4.1.9 on iMac (Summer 2000) will
-prevent the CD-ROM and the hard drive from operating together.
-You may get
-.Pa "wdc0:0:1: lost interrupt"
-problems.
-.Note)
-.Pp
-.
-.Ss2 Getting to the Open Firmware Prompt on Newer Models
-.
-(Open Firmware 3)
-.Pp
-Hold down a special four-key combination when your system boots.
-.Pp
-After the chime starts, but before it stops, hold down the four
-.Key COMMAND-OPTION-O-F
-keys (the
-.Key COMMAND
-key looks like a four-leaf clover or an open apple, and the
-.Key OPTION
-key may look like a two-way switch with four straight line segments or say
-.Key ALT )
-until you see the Open Firmware command prompt on your screen:
-.Pp
-.(disp
-Apple PowerBook3,1 2.1f1 BootROM built on 01/29/00 at 22:38:07
-Copyright 1994-2000 Apple Computer, Inc.
-All Rights Reserved
-
-Welcome to Open Firmware.
-To continue booting, type "mac-boot" and press return.
-To shut down, type "shut-down" and press return.
- ok
-0 \*>
-.disp)
-.Pp
-Now, set your system to always stop at the Open Firmware prompt.
-.Pp
-.(disp
-.No 0 \*> Ic "setenv auto-boot? false
-.disp)
-.Pp
-Skip down to the section on
-.Sx Setting up Open Firmware 3 to boot NetBSD
-since the next several pages are instructions for older models.
-.Pp
-.
-.Ss2 Getting to the Open Firmware Prompt on Apple Network Servers
-.
-(Open Firmware 1.1.22)
-.Pp
-The version of Open Firmware in the
-Apple Network Servers can only use a serial console.
-You must first hook up a serial console
-(38400 bps, 8 bits, no parity, 1 stop bit, no handshaking) to
-.Sq "Port 2"
-(the
-.Sq Li ttya
-device in Open Firmware).
-.Pp
-Hold down a special four-key combination on the keyboard attached to
-the ADB port on your system (not the serial console) when
-your system boots.
-.Pp
-After the chime starts, but before it stops, hold down the four
-.Key COMMAND-OPTION-O-F
-keys (the
-.Key COMMAND
-key looks like a four-leaf clover or an open apple, and the
-.Key OPTION
-key may look like a two-way switch with four straight line segments or say
-.Key ALT )
-until you see some introductory text and the Open Firmware
-command prompt on your serial terminal:
-.Pp
-.(disp
-.No 0 \*>
-.disp)
-.Pp
-Your Apple Network Server's screen will remain black.
-.Pp
-Now, set your system to always stop at the Open Firmware prompt.
-.Pp
-.(disp
-.No 0 \*> Ic "setenv auto-boot? false
-.disp)
-.Pp
-Skip down to the section on
-.Sx Setting up pre-Open Firmware 3 to boot NetBSD
-since the next several pages are instructions for MacOS models.
-.Pp
-.
-.Ss2 Getting to the Open Firmware Prompt on Older Models
-.
-(Open Firmware 1.0.5, Open Firmware 2.0.x, Open Firmware 2.4)
-.Pp
-These models are significantly trickier than the newer machines.
-Open Firmware has two variables,
-.Sq input-device
-and
-.Sq output-device No Ns ,
-which specify which devices to use for input and output.
-All Open Firmware 1.0.5 and most Open Firmware 2.0.x systems will default
-to using the
-.Sq Modem
-serial port for the console instead of the ADB keyboard and the monitor
-attached to the on-board video.
-.Pp
-Unless you use a MacOS-based utility to set
-these variables correctly, you
-.Em will
-need to hook up a serial console temporarily to configure Open Firmware
-to use your keyboard and screen.
-Some models (such as the Performa 54xx, 6360, 6400, and 6500) have the
-.Sq Modem
-serial port covered with a piece of plastic since the internal modem
-usurps that serial port.
-You will either need to use Boot Variables to set the
-.Sq input-device
-and
-.Sq output-device
-variables to
-.Sq ttyb
-(which is the Printer serial port) or remove the internal modem.
-.Pp
-Open Firmware seems to ignore the settings on most DB15 to VGA adapters.
-Depending on your model, it will default to either 640 x 480 at 60 Hz or
-to the resolution previously selected in MacOS.
-Make sure that your monitor can handle these resolutions.
-.Pp
-Now would be a good time to look at the
-.Nx*M
-Model Support webpage to determine the issues with your model.
-.Lk http://www.NetBSD.org/Ports/macppc/models.html
-.Pp
-In particular, some models
-.Em must
-use a serial console, or they will be unable to boot
-.Nx
-at all.
-All models can be set to use a serial console, if you desire
-to bypass the keyboard and screen.
-.Pp
-If, after re-reading the next several sections, you still need help
-figuring out your
-.Sq input-device
-and
-.Sq output-device
-settings, see the FAQ:
-.Lk http://www.NetBSD.org/Ports/macppc/faq.html#ofw-input-output-devices
-.Pp
-If you need to use a serial console, you can use a normal
-.Sq printer
-cable (mini-DIN 8 to mini-DIN 8) and a
-.Tn MacOS
-tool, such as ZTerm to
-connect a
-.Tn MacOS
-system to your
-.Nx*M
-system.
-.Lk http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/comm/term/zterm-101.hqx
-.Lk http://homepage.mac.com/dalverson/zterm/
-.Pp
-See the NetBSD Serial Port Primer for additional help and references:
-.Lk http://www.NetBSD.org/Documentation/Hardware/Misc/serial.html
-.
-.Ss2 Older Open Firmware System Preparation
+If you do not have an Open Firmware 3 system, skip down to 
+.Sx "Preparing your Open Firmware 1.x or 2.x System for NetBSD"
 .
-(Open Firmware 1.0.5, Open Firmware 2.0.x, Open Firmware 2.4)
-.Pp
-All pre-Open Firmware 3 \*M systems have Open Firmware bugs.
-Luckily, Open Firmware has a small Non-Volatile RAM variable (NVRAM)
-which is reserved for FORTH commands which will be run before booting
-an operating system.
-Apple has released a freeware
-.Tn MacOS
-tool called System Disk, which patches
-most of these bugs.
-We
-.Em strongly
-recommend that you use this tool to patch your Open Firmware,
-as several systems cannot boot without these patches.
-Instructions for using System Disk are covered in the next section.
-.Pp
-Unfortunately, some models are broken by or are unsupported by System Disk.
-If you have one of the following models, then skip down to the section on
-.Sx Getting to the Open Firmware Prompt (Harder method using MacOS)
-.br
-Apple Performa 4400, 5500, 6500, 54xx, 6400, and 6360,
-.br
-Motorola Starmax 3000, 4000, 5000, and 5500,
-.br
-APS Tech M*Power 604e/200,
-.br
-PowerComputing PowerBase,
-.br
-Umax Apus 2000, Apus 3000, C500, and C600
-.br
-Umax S900
-.Pp
-.
-.Ss2 Getting to the Open Firmware Prompt (Recommended method using MacOS)
-.
-(Open Firmware 1.0.5, Open Firmware 2.0.x, Open Firmware 2.4)
-.Pp
-Download System Disk:
-.Lk ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin
-.Pp
-For a brief tutorial on how to use System Disk, see: