[src/netbsd-1-5]: src/distrib/notes/macppc Pull up revisions 1.19, 1.21, 1.24 (...

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

details:   https://anonhg.NetBSD.org/src/rev/ab1717e02265
branches:  netbsd-1-5
changeset: 492918:ab1717e02265
user:      he <he%NetBSD.org@localhost>
date:      Wed Mar 06 21:30:25 2002 +0000

description:
Pull up revisions 1.19,1.21,1.24 (requested by mbw):
  Various fixes:
   o Significant fixes/rework for macppc section:
     - Tweak ``Quick install'' section for macppc
     - OpenFirmware boot syntax section
     - Update/correct description of boot problems
     - Mention de0 as macppc possible interface
     - Other improvements and fixes
   o Add recently added developers
   o Formatting and spelling fixes

diffstat:

 distrib/notes/macppc/prep |  669 ++++++++++++++++++++++++++++-----------------
 1 files changed, 408 insertions(+), 261 deletions(-)

diffs (truncated from 1234 to 300 lines):

diff -r b61be8ca3041 -r ab1717e02265 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Wed Mar 06 21:30:02 2002 +0000
+++ b/distrib/notes/macppc/prep Wed Mar 06 21:30:25 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.2.8.13 2002/01/05 18:31:05 he Exp $
+.\"    $NetBSD: prep,v 1.2.8.14 2002/03/06 21:30:25 he Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -31,9 +31,8 @@
 but depending on your model it may be almost as painful as learning a 
 little
 .Tn MacOS .
-If you 
-.Em really
-want to bypass it, you should mail port-macppc%netbsd.org@localhost for guidance.
+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.
 .Pp
@@ -134,6 +133,7 @@
 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 
@@ -143,7 +143,7 @@
 recommend not doing this.
 .Note)
 .(Note
-The most recent BootROMs available (4.1.7 and 4.1.8) as of August 2001 are
+The most recent BootROMs available (4.1.7 and later) are
 known to have some problems.  
 Some PowerMacintosh users find that their third-party 
 RAM has been disabled.  See the discussion at
@@ -153,6 +153,11 @@
 (Titanium) models with BootROM 4.1.8 are not supported in this release.  
 If your system has this BootROM, you must use a kernel from the -current
 branch.
+.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
 .
@@ -160,17 +165,17 @@
 .
 (Open Firmware 3)
 .Pp
-Hold down a special key combination when your system boots.
+Hold down a special four-key combination when your system boots.
 .Pp
-After the chime starts, but before it stops, hold down the
+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).
-.Pp
-You should now see the Open Firmware command prompt on your screen:
+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
@@ -186,7 +191,9 @@
 .Pp
 Now, set your system to always stop at the Open Firmware prompt.
 .Pp
-.Dl 0 \*> Ic "setenv auto-boot? false
+.(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
@@ -206,107 +213,59 @@
 .Sq Li ttya
 device in Open Firmware).
 .Pp
-Hold down a special key combination on the keyboard attached to
-the ADB port on your system (not the serial console or PS/2 port) when
+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
+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).
+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
-You should now see some introductory text and the Open Firmware command
-prompt on your terminal:
+.(disp
+.No 0 \*>
+.disp)
 .Pp
-.Dl 0 \*>
-.Pp
-Your screen will remain black.
+Your Apple Network Server's screen will remain black.
 .Pp
 Now, set your system to always stop at the Open Firmware prompt.
 .Pp
-.Dl 0 \*> Ic "setenv auto-boot? false
+.(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 Older Open Firmware System Preparation
+.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.
-.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.  If you read
-the Model Support page, you'd also know that some models are broken by
-or are unsupported by System Disk.
-.Pp
-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
-For every other model, download System Disk from Apple's site:
-.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:
-.Lk http://www.netbsd.org/Ports/macppc/SystemDisk-tutorial/
-.Pp
-Make sure you click the
-.Dq Save
-button, or the patches will not be saved to NVRAM.
-.(Note
-NVRAM patches and Open Firmware settings will be erased if you
-.Sq "zap your PRAM"
-by holding down
-.Key COMMAND-OPTION-P-R
-keys during the boot chimes, or if you accidentally boot into 
-.Tn MacOS No Ns .
-.Note)
-.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
 Open Firmware has two variables,
 .Sq input-device
 and
 .Sq output-device No Ns ,
 which specify which devices to use for input and output.  
-.Pp
 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 set them before you 
-can use your keyboard and screen.  Some models (such as the Performa 54xx,
+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
@@ -331,6 +290,14 @@
 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 
@@ -342,11 +309,53 @@
 .Nx*M
 system.
 .Lk http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/comm/term/zterm-101.hqx
+.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
+.
+(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:
+.Lk http://www.netbsd.org/Ports/macppc/SystemDisk-tutorial/
+.Pp
 Launch the
 .Tn MacOS
 System Disk tool. Click on
@@ -361,6 +370,15 @@
 .Dq Save
 button and reboot your system.
 .Pp
+.(Note
+NVRAM patches and Open Firmware settings will be erased if you
+.Sq "zap your PRAM"
+by holding down
+.Key COMMAND-OPTION-P-R
+keys during the boot chimes, or if you accidentally boot into 
+.Tn MacOS No Ns .
+.Note)
+.Pp
 If your
 .Sq output-device
 is
@@ -392,14 +410,18 @@
 .Dq "Stop Boot at Open Firmware prompt"
 setting is persistent.  It is equivalent to the Open Firmware command
 .Pp
-.Dl 0 \*> Ic "setenv auto-boot? false