[src/netbsd-1-6]: src/distrib/notes/macppc Pullup to rev 1.2 (requested by mb...

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

details:   https://anonhg.NetBSD.org/src/rev/ae8109f0df9e
branches:  netbsd-1-6
changeset: 530925:ae8109f0df9e
user:      jmc <jmc%NetBSD.org@localhost>
date:      Tue Oct 21 06:35:22 2003 +0000

description:
Pullup to rev 1.2 (requested by mbw in ticket #1475)

Substantianal overhaul of install notes for macppc

diffstat:

 distrib/notes/macppc/prep.OPENFIRMWARE |  1631 ++++++++++++++++++++++++++++++++
 1 files changed, 1631 insertions(+), 0 deletions(-)

diffs (truncated from 1635 to 300 lines):

diff -r b9f0c5d143bb -r ae8109f0df9e distrib/notes/macppc/prep.OPENFIRMWARE
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/macppc/prep.OPENFIRMWARE    Tue Oct 21 06:35:22 2003 +0000
@@ -0,0 +1,1631 @@
+.\"    $NetBSD: prep.OPENFIRMWARE,v 1.4.2.2 2003/10/21 06:35:22 jmc Exp $
+.if \*[OF_VERSION_3] \{\
+.
+.Ss2 Updating your BootROM
+.
+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. For most G3 and G4
+models, you will need to run the FirmWare updater from MacOS 9. 
+.Pp
+.(Note
+If you accidentally change 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.  This will permanently damage your machine.
+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 G3 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 is one report 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 Open Firmware 3
+.
+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
+Alternatively, if you are currently running
+.Tn MacOS X
+or
+.Tn Darwin ,
+you can use the 
+.Ic nvram
+command to set this variable before rebooting.
+.(disp
+.No # Ic nvram auto-boot\e?=false
+.disp)
+.Pp
+You will need to escape the question-mark or enclose the whole
+.Ic nvram
+argument in double-quotes to prevent your shell from trying to interpret it.
+.\}
+.if \*[OF_VERSION_12] \{\
+.
+.Ss2 Getting to Open Firmware 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 Open Firmware 1 and 2 to boot NetBSD"
+since the next several pages are instructions for MacOS models.
+.Pp
+.
+.Ss2 Open Firmware 1 and 2 System Preparation
+.
+Open Firmware has two variables,
+.Sq input-device
+and
+.Sq output-device No Ns ,
+which specify how it accepts commands and displays 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
+.Pp
+All Open Firmware 1 and 2 \*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 9
+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 Open Firmware (Harder, MacOS 7 thru 9)"
+.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 Open Firmware (MacOS X or Darwin) 
+.
+When you install 
+.Tn MacOS X
+or Darwin, it will install the necessary NVRAM bug fixes.  Use the
+.Ic nvram
+command to set your system to always stop at the Open Firmware prompt, then
+reboot.
+.(disp
+.No # Ic nvram auto-boot\e?=false
+.disp)
+.Pp
+You will need to escape the question-mark or enclose the whole
+.Ic nvram
+argument in double-quotes to prevent your shell from trying to interpret it.
+.Pp
+You should now see the Open Firmware command prompt on your screen:
+.Pp
+.(disp
+Open Firmware, 1.0.5
+To continue booting the MacOS type:
+BYE\*<return\*>
+To continue booting from the default boot device type:
+BOOT\*<return\*>
+ ok
+0 \*>
+.disp)
+.Pp
+If your screen is black, then your model has defaulted to using a serial
+console.  You must hook up a serial
+console (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking).
+.
+.Ss2 Getting to Open Firmware (Best, MacOS 8 or 9)
+.
+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
+.Dq "Power User (Open Firmware)"
+then click on the
+.Dq "Advanced Options"
+button.
+Now, click on the checkbox that says
+.Dq "Stop Boot at Open Firmware prompt"
+and select
+.Dq OK .
+Click the
+.Dq Save
+button and reboot your system.