[src/netbsd-1-5]: src/distrib/notes/macppc Pullup 1.6 [mw]:

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

details:   https://anonhg.NetBSD.org/src/rev/3ad78ccecc7b
branches:  netbsd-1-5
changeset: 490089:3ad78ccecc7b
user:      tv <tv%NetBSD.org@localhost>
date:      Wed Nov 01 23:19:00 2000 +0000

description:
Pullup 1.6 [mw]:
Tweaks and re-detailing.

diffstat:

 distrib/notes/macppc/prep |  675 +++++++++++++++++++++++++++++++++++++++------
 1 files changed, 586 insertions(+), 89 deletions(-)

diffs (truncated from 955 to 300 lines):

diff -r 415c6ebda410 -r 3ad78ccecc7b distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Wed Nov 01 23:18:45 2000 +0000
+++ b/distrib/notes/macppc/prep Wed Nov 01 23:19:00 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.2.8.1 2000/11/01 03:48:18 tv Exp $
+.\"    $NetBSD: prep,v 1.2.8.2 2000/11/01 23:19:00 tv Exp $
 .
 .Ss2 Open Firmware System Preparation
 .
@@ -22,11 +22,11 @@
 .Dq Save
 button, or the patches will not be saved to NVRAM.
 .(Note
-NVRAM patches will be erased if you
+NVRAM patches and Open Firmware settings will be erased if you
 .Sq zap your PRAM
 by holding down
-.Key COMMAND-OPTION-P-R
-during the boot chimes
+.Dq COMMAND-OPTION-P-R
+keys during the boot chimes
 .Note)
 .Pp
 .
@@ -43,7 +43,22 @@
 .Ss2 Getting to the Open Firmware Prompt
 .
 There are various methods to get to the Open Firmware prompt. They may
-or may not work, depending on which system model you have
+or may not work, depending on which system model you have.  Most models
+can use the on-board video and an ADB or USB keyboard to access Open
+Firmware.  Those that cannot must use a serial console.  Likewise, most
+systems can be set up to use a serial console if you do not wish to use
+the on-board video.
+.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.  Most early models
+(Open Firmware versions 1.x and 2.0.x) will default to using a serial
+console.  The later models (Open Firmware versions 2.4 and 3) will default
+to using the on-board video and keyboard.  The instructions below describe
+how to set your system up to access Open Firmware from the on-board video 
+and keyboard.
 .
 .Ss2 Getting to the Open Firmware Prompt (Easy method using MacOS)
 .
@@ -61,21 +76,29 @@
 .Dq Save
 button and reboot your system.
 .Pp
+If your
+.Sq output-device
+is
+.Sq Li /chaos/control
+(i.e. you have a PowerMacintosh 7300 - 8600 system), there is a chance that
+your monitor will not sync. See
+.Lk http://www.netbsd.org/Ports/macppc/SystemDisk-tutorial/of105patch.html
+.Pp
 You should now see the Open Firmware command prompt:
 .Pp
 .Dl 0 >
 .Pp
-If your screen is black, then your model does not support using the screen in
+If your screen is black, then your model does not support using the 
+on-board video in
 Open Firmware. You will need to connect up a serial console
 (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking).
 .(Note
-This setting is persistent until you disable
+The
 .Dq Stop Boot at Open Firmware prompt
-or tell Open Firmware
+setting is persistent.  Your system will always stop at the Open Firmware
+prompt unless you uncheck this checkbox or tell Open Firmware
 .Pp
 .Dl 0 > Ic "setenv auto-boot? true
-.Pp
-your system will always stop at the Open Firmware prompt.
 .Note)
 .(Note
 Unfortunately, there are a few models that are better off without the System
@@ -91,7 +114,10 @@
 .Tn MacOS
 is too old or because
 System Disk says that it doesn't support your model, then you may try using
-the BootVars tool.
+the 
+.Tn MacOS
+BootVars tool on your Open Firmware 1 or 2 system (it will crash 
+Open Firmware 3 systems).
 .Pp
 .Lk ftp://ftp.netbsd.org/pub/NetBSD/arch/macppc/macos-utils/bootvars/bootvars.sit.hqx
 .(Note
@@ -107,20 +133,31 @@
 .Nx*M
 Model Support webpage.
 .Lk http://www.netbsd.org/Ports/macppc/models.html
+If the 
+.Nx*M
+Model support webpage does not list an 
+.Sq output-device
+for your model, then your system will default to using the on-board
+video.  You needn't fill in the
+.Sq output-device
+and
+.Sq input-device
+variables.
 .Pp
 Launch the
 .Tn MacOS
-BootVars tool. Click on the
+BootVars tool.  Click on the
 .Dq auto-boot?
 checkbox, then click on the
 .Dq All Variables
 checkbox and type
 .Ic kbd
 into the
-.Dq input-device
+.Sq input-device
 box, and the proper device name into the
-.Dq output-device
-box. Click on the
+.Sq output-device
+box. 
+Click on the
 .Dq write
 button, and restart.
 .Pp
@@ -136,13 +173,18 @@
 .Pp
 .Dl 0 >
 .Pp
-If your model does not have an
-.Sq output-device
-listed, or its screen is black when you restart your system, then it
-has defaulted to using a serial console because the internal video does not
-work.  This is fairly common on these models if you do not use
-the System Disk tool to set up Open Firmware. You must hook up a serial
+If your screen is black, then your model has defaulted to using a serial 
+console.  This is fairly common on Open Firmware 1 and 2 models if you do not
+use the System Disk tool to set up Open Firmware. You must hook up a serial
 console (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking).
+.(Note
+The
+.Dq auto-boot?
+setting is persistent.  Your system will always stop at the Open Firmware
+prompt unless you uncheck this checkbox or tell Open Firmware
+.Pp
+.Dl 0 > Ic "setenv auto-boot? true
+.Note)
 .
 .Ss2 Getting to the Open Firmware Prompt (Without using MacOS)
 .
@@ -150,18 +192,18 @@
 .Tn MacOS ,
 then you need to hold down a special key combination when your system boots.
 .(Note
-Your system will
+Your Open Firmware 1 or 2 system will
 .Em not
 have the (possibly critical) NVRAM patches that System Disk applies.
 Expect devices to not work.
 .Note)
 .Pp
 After the chime starts, but before it stops, hold down the
-.Key COMMAND-OPTION-O-F
+.Dq COMMAND-OPTION-O-F
 keys (the
-.Key COMMAND
+.Dq COMMAND
 key looks like a four-leaf clover or an open apple, and the
-.Key OPTION
+.Dq OPTION
 key may look like a two-way switch with four straight line segments).
 .Pp
 You should now see the Open Firmware command prompt:
@@ -169,22 +211,33 @@
 .Dl 0 >
 .Pp
 If your screen is black, then your system has defaulted to using a serial
-console. This is fairly common on these models if you do not use the System
+console. This is fairly common on Open Firmware 1 and 2 models if you do
+not use the System
 Disk tool to set up Open Firmware. You must hook up a serial console
 (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking).
+.Pp
 The Apple Network Server uses
 .Sq Port 2
 (the
 .Sq Li ttya
 device in Open Firmware) as the console port.
 .Pp
-Look up the proper
+Now, set your system to always stop at the Open Firmware prompt.
+.Pp
+.Dl 0 > Ic "setenv auto-boot? false
+.Pp
+To allow Open Firmware to automatically boot the specified operating
+system when the system is booted, type:
+.Pp
+.Dl 0 > Ic "setenv auto-boot? true
+.Pp
+To use your on-board video and keyboard, look up the proper
 .Sq output-device
 for your model on the
 .Nx*M
 webpage
 .Lk http://www.netbsd.org/Ports/macppc/models.html
-Run the following commands to set this variable to use your screen instead of
+Run the following commands to use your screen instead of
 a serial console
 (replace
 .Sq Li screen
@@ -205,11 +258,6 @@
 (i.e. you have a PowerMacintosh 7300 - 8600 system), there is a chance that
 your monitor will not sync. See
 .Lk http://www.netbsd.org/Ports/macppc/SystemDisk-tutorial/of105patch.html
-.Pp
-.(Note
-You must install the patches from System Disk before the beige G3 will boot
-.Nx
-.Note)
 .
 .Ss2 Setting Open Firmware up to boot NetBSD
 .
@@ -219,10 +267,13 @@
 .Dl 0 > Ic "dev /openprom"
 .Dl 0 > Ic ".properties"
 .Pp
-If your version of Open Firmware is prior to version 3, then you must set
+If your system has Open Firmware prior to version 3, then you must set
 some Open Firmware variables before
 .Nx
-can boot.
+can boot.  Do
+.Em not
+run these commands on Open Firmware 3 machines, as you may overwrite your
+firmware requiring a trip to Apple for repairs.
 .Pp
 .Dl 0 > Ic "setenv load-base 600000"
 .Dl 0 > Ic "setenv real-base F00000"
@@ -266,36 +317,50 @@
 .Dl 0 > Ic mac-boot
 .bullet)
 .(Note
-Open Firmware 1.0.5 settings will be erased if you boot into
+Open Firmware 1.0.5 settings and nvram patches will be erased if you boot into
 .Tn MacOS .
 You will need to re-enter them before booting
 .Nx
-again. Open Firmware 2.0.x does not appear to suffer from this problem.
+again.
 .Note)
 .
 .Ss2 Available Boot Media
 .
-In order to boot and run
-.Nx ,
-you need a method to load and run the
+Each version of Open Firmware is capable of booting from a variety of
+media.  To boot the
 .Nx
-kernel.
-.Pp
-Whilst Open Firmware 3 can load the kernel directly, older versions need a
+kernel, Open Firmware must first open a
 .Sq bootloader
-which can then bootstrap the kernel.
-Unfortunately, some kernels do not
+which knows how to load the
+.Nx
+kernel.  There are two approaches, the 
+.Pa ofwboot.xcf
+bootloader and the
+.Sq partition zero
+bootloader.  In the former case, the user tells Open Firmware to
+load
+.Pa ofwboot.xcf
+and it will load the kernel.  In the latter case, the user tells Open
+Firmware to boot from a particular device, and a primary bootloader
+.Pa bootxx
+is loaded, which then loads the secondary bootloader
+.Pa ofwboot
+which then loads the kernel.
+.Pp
+Open Firmware 3 systems can load the kernel without the use of a
+bootloader, although, some kernels do not
 .Dq just work ,
-and you will need
-to load the bootloader to load the kernel.
+and you will need to load the bootloader to load the kernel.
 Feel free to experiment and load the kernel with the command you use to load
-the bootloader, bypassing this step.
+the bootloader, bypassing a step, however we recommend using a bootloader.
 .Pp
 The following bootable media are available for loading the bootloader
 .Pq Pa ofwboot No or Pa ofwboot.xcf :