NetBSD/distrib/notes/macppc/hardware

.\"$NetBSD: hardware,v 1.13 2001/05/22 04:09:41 mbw Exp $
.
Currently,
.Nx*M
requires the use of
.Tn "Open Firmware"
to boot.
Open Firmware is a command environment using the FORTH language which the
.Nx
kernel uses to gether information about your system, and to control some
of your devices.  It is part of the boot ROMs in most 
.Tn PowerPC Ns No -based Tn Macintosh
systems.  Until late 1996, 
.Tn Apple 
never intended to use Open Firmware for anything other than internal debugging and hardware support.  It was not
intended to be used to boot an operating system.  This is why earlier machines
have so much trouble with Open Firmware.
This also means that PowerMacs and clones that lack Open Firmware cannot boot
.Nx
on the \*M platform. Most machines introduced by Apple and the clone-makers
after August 17, 1995 have Open Firmware and are supported.
.Pp
Apple made several revisions of this Open Firmware environment, and each has
various quirks and problems that we must work around. The single hardest step
of installing
.Nx*M
is to set up Open Firmware properly. Open Firmware versions 1.0.5 and 
2.0.x act
similarly and the same set of instructions applies to them. Open Firmware
version 2.4 is slightly different with regards to booting. Open Firmware
version 3 is altogether different.
.Pp
At present,
.Nx*M
does not support the PPC 601 microprocessor, which means that the
PowerMacintosh 7200 and 7500 models are not supported. The PowerMacintosh
7500 may be upgraded to a PPC 604, G3, or G4 microprocessor via a
daughtercard replacement, in which case
.Nx
will run on this system.
.Pp
The minimal configuration requires 16 MB of RAM and ~80 MB of disk space.
To install the entire system requires much more disk space, and to run
X or compile the system, more RAM is recommended, as
.Nx
with 16 MB of RAM is very slow. Note that until you have
around 32 MB of RAM, getting more RAM is more important than getting a
faster CPU.
.
.Ss2 Supported models
Find your model from the list below and take note of its Open Firmware
version:
.(tag 8n
.It Em "Open Firmware 1.0.5"
.Pp
.(bullet -compact
Apple PowerMacintosh (7300, 7500 (with CPU upgrade), 7600, 8500, 8600, 9500,
and 9600)
.It
Power Computing (PowerBase, PowerCenter, PowerCenter Pro, PowerCurve,
PowerTower, PowerTower Pro, and PowerWave)
.It
UMAX (J700, S900)
.bullet)
.It Em "Open Firmware 1.1.22"
.Pp
.(bullet -compact
Apple Network Server (500 and 700)
.(Note
Users have reported that the
.Nx
kernel does not work well with the on-board MACE-based ethernet (the one
that requires an Apple AAUI dongle).
If your system does not have the Apple PCI Ethernet Card, you may need to
purchase and install another ethernet card in your Apple Network Server.
.Note)
.bullet)
.It Em "Open Firmware 2.0.x"
.Pp
.(bullet -compact
Apple PowerBook (2400, 3400, G3, and G3 Series)
.It
Apple PowerMacintosh/Performa (4400, 54xx, 5500, 6300/160, 6360, 6400, and
6500)
.It
Apple PowerMacintosh (G3
.Dq Beige
models with ATI RageII+: Desktop, Mini Tower, and All-in-One)
.It
APS Tech (M*Power 604e/200)
.It
Motorola StarMax (3000, 4000, 5000, and 5500)
.It
UMAX (Apus 2000, Apus 3000, C500, and C600)
.bullet)
.It Em "Open Firmware 2.4"
.Pp
.(bullet -compact
Apple PowerMacintosh (G3
.Dq Beige
models with ATI Rage Pro: Desktop, Mini Tower, and All-in-One)
.bullet)
.It Em "Open Firmware 3"
.Pp
.(bullet -compact
Apple original iBook and iBook SE
.It
Apple iMac; Bondi Blue (Rev A and Rev B, 233 MHz),
5 Flavors (Rev C and Rev D, 266 MHz and 333 MHz), and Slot Loading
.It
Apple PowerBook (G3 Series (bronze keyboard) and G3 (FireWire))
.It
Apple PowerBook G4 (Titanium)
.It
Apple PowerMacintosh G3 (Blue and White)
.It
Apple PowerMacintosh (G4 (PCI), G4 (AGP), G4 (Gigabit Ethernet), G4
(Digital Audio), and G4 Cube)
.bullet)
.(Note
There have been some reports that PowerBook G4 (Titanium) models that have
BootROM version 4.1.8 do not boot
.Nx No .
.Note)
.tag)
.
.Ss2 Unsupported models
.(bullet -compact -offset indent
Systems with Open Firmware, but using a PPC 601 microprocessor
(PowerMacintosh 7200 and 7500 (without CPU upgrade))
.It
Systems with a PowerPC microprocessor, but lacking Open Firmware
.(bullet -compact
Apple PowerBook (1400, 2300, and 5300)
.It
Apple PowerMacintosh/Performa (52xx, 53xx, 62xx, and 63xx
(except 6300/160 and 6360 which are supported))
.It
Apple PowerMacintosh/Performa (61xx, 71xx, and 81xx)
.It
PowerComputing (Power 100 and Power 120)
.bullet)
.It
Systems with broken Open Firmware (Twentieth Anniversary Macintosh)
.It
Systems with a Motorola 68k microprocessor (these systems are supported by
.Nx Ns /mac68k )
.It
Systems upgraded from any of the above (unless the motherboard is replaced as
part of the upgrade)
.It
Systems released in the second half of 2001 and later (future releases of
.Nx*M
will support these systems)
.bullet)
.
.Ss2 Supported devices
.(bullet -offset indent
Ethernet
.(bullet -compact
On-board 79C950-based MACE Ethernet interface
.Pq Em mc0
.It
On-board bmac Ethernet interface
.Pq Em bm0
.It
On-board gmac Ethernet interface
.Pq Em gm0
.It
Apple PCI Ethernet Card (option for Apple Network Server)
.Pq Em tlp
.It
Asante Mac 10/100 PCI Rev A, part number 09-00169-01
.Pq Em de
.It
Farallon Fast EtherTX 10/100, part number PN996L-TX
.Pq Em de
.It
SMC Etherpower II (9432TX)
.Pq Em epic
.It
SMC 83c170
.Pq Em epic
.It
3Com 3c905
.Pq Em ex
.It
Intel EtherExpress PRO/10+ PCI LAN Adapter
.Pq Em fxp
.It
RealTek 8029 Ethernet
.Pq Em ne
.It
VIA Technologies VT86C926
.Pq Em ne
.It
RealTek 8139
.Pq Em rtk
.It
Netgear FA-311
.Pq Em sip
.It
Lite-On PNIC
.Pq Em tlp
.It
D-Link DFE-530TX
.Pq Em vr
.It
Many other PCI and Cardbus Ethernet interfaces, such as
Tulip-compatable
.Pq Em de No and Em tlp ,
3Com
.Pq Em ep ,
SMC
.Pq Em epic ,
Intel
.Pq Em fxp ,
NE2000-compatable
.Pq Em ne ,
and RealTek
.Pq Em rtk
.It
Many USB Ethernet interfaces
.Po
.Em aue ,
.Em cue ,
and
.Em kue
.Pc
.bullet)
.It
SCSI
.(bullet -compact
On-board NCR 53c94 SCSI controller
.Pq Em esp
.It
On-board MESH SCSI controller
.Pq Em mesh
.It
Adaptec PCI controllers 291x, 2920, 2930C, 294x, 295x, 39xx, 19160, 29160
and AIC-78xx
.Pq Em ahc
.(Note
The 294x models are not bootable in Open Firmware, even though they
can boot
.Tn MacOS No Ns .
.Note)
.Pp
.It
AdvanSys 1200[A,B], 9xx[U,UA] SCSI controller
.Pq Em adv
.It
AMD 53c974
.Pq Em pcscp
.It
NCR/Symbios 53C8xx
.Pq Em ncr No or Em siop
.It
Many other PCI SCSI controllers should work, but no one has tried them
.It
Most SCSI disk/tape/CD-ROM devices should work
.bullet)
.It
IDE
.(bullet -compact
On-board IDE controlers
.It
Promise Ultra66
.Pq Em pciide
(this, and other PC-based cards are not bootable on \*M)
.It
Some other PCI IDE controllers should work, although no one has had much success
.(Note
The Sonnet Tempo ATA/66 card does not work with
.Nx*M
yet.
.Note)
.Pp
.It
Most IDE disk/CD-ROM/ATAPI devices should work
.bullet)
.It
Input devices
.(bullet -compact
Most ADB keyboards, mice, trackballs, and trackpads
.It
Most USB keyboards, mice, trackballs, and trackpads
.It
Most PS/2 keyboards, mice, and trackballs
(middle button on 3-button mice may not work)
.bullet)
.It
Video
.(bullet -compact
On-board video on most models
.Pq Em ofb
.(Note
Several models have been reported to not work with
.Nx
if the on-board video is in use, such as the Performa 54xx, 6360, 6400,
PowerComputing PowerTower, and UMAX C600 and Apus 3000.  Also, the video
card that shipped with the PowerMacintosh 9500/150, 9500/180, and 9500/200
systems is reported to have the same problem.
.Note)
.Pp
.It
PCI frame buffers which have Open Firmware support
(ATI, IMS, Matrox, and NVIDIA have several models which work)
.bullet)
.It
Audio
.(bullet -compact
On-board audio on most models
.Pq Em awacs
.(Note
This driver has only recently been introduced and is considered
.Dq untested
meaning that it may cause your system to crash and/or is lacking some
features you may expect
.Note)
.Pp
.It
USB audio devices
.Pq Em uaudio
.Pp
.It
PCI audio cards, although only the Ensoniq AudioPCI 
.Pq Em eap
has been thoroughly tested
.bullet)
.It
Serial ports
.(bullet -compact
On-board serial ports (the modem and printer ports)
.Pq Em ttya No and Em ttyb
.(Note
The on-board serial ports can be used for console (38400 bps, 8 bits, no
parity, 1 stop bit, no handshaking), although many users have
reported problems trying to run ppp or other high speed serial applications
.Note)
.Pp
.It
The Gee Three Stealth Serial Port, possibly the Griffin Technology gPort
.(Note
These serial ports can be used for console (57600 bps, 8 bits, no parity,
1 stop bit, no handshaking).  Use 
.Pq Em scca
for the Open Firmware
.Sq input-device
and
.Sq output-device
variables.
.Note)
.Pp
.It
Some USB, PCI, and Cardbus serial ports should work, but no one has tried them
.bullet)
.It
USB devices
.(bullet -compact
Most MI USB devices should work (such as disks, printers, input devices, and
ethernet interfaces)
.Lk http://www.netbsd.org/Hardware/usb.html
.bullet)
.It
PCMCIA and Cardbus cards
.(bullet -compact
Most MI PCMCIA and Cardbus cards should work, although very few have been
tested with
.Nx*M
.Lk http://www.netbsd.org/Hardware/cardbus.html
.Lk http://www.netbsd.org/Hardware/pcmcia.html
.bullet)
.It
PCI cards
.(bullet -compact
Most MI PCI cards should work, although very few have been tested with
.Nx*M
.Lk http://www.netbsd.org/Hardware/pci.html
.bullet)
.Pp
.(Note
While the
.Nx
kernel may support the various Cardbus, PCI, PCMCIA, and USB devices you may
have, Open Firmware does
.Em not
unless it has a specific Open Firmware ROM. This means you cannot boot from
these devices.
Some Adaptec SCSI controllers have bootable Open Firmware ROMs.
.Note)
.bullet)
.
.Ss2 Unsupported devices
.(bullet -offset indent
Floppy disk
.(Note
Though
.Nx*M
can boot from a floppy, there is no kernel support yet
.Note)
.Pp
.It
FireWire (IEEE 1394)
.It
Advanced power management (cannot put system to
.Sq sleep )
.It
Multiple processors
.(Note
Although
.Nx*M
can boot with more than one processor present, it will not use the additional
CPUs
.Note)
.Pp
.It
AirPort
.It
On-board video capture
.bullet)
.
.Ss2 Supported boot devices and media
.
Each version of Open Firmware supports different devices and media that you
may boot from.  We define the terms
.Dq "bootable media"
as the media (hard drive, CD-R, ethernet) that will be used to bootstrap
your \*M system into
.Nx No Ns ,
and
.Dq "distribution sets"
or
.Dq "distribution media"
as the media (hard drive, CD-R, ethernet) that contains the files that
will be installed to generate a working 
.Nx
system onto your destination media.
.Pp
Go to the
.Nx*M
Model Support webpage and look up your system. Take note of the comments
about your model and keep these in mind during the rest of this installation
procedure.
.Lk http://www.netbsd.org/Ports/macppc/models.html