>Number:         36373
>Category:       port-macppc
>Synopsis:       Patch to update hardware notes for macppc port in preparation for 4.0 release
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    port-macppc-maintainer
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon May 21 22:55:00 +0000 2007
>Originator:     David H. Gutteridge
>Release:        
>Organization:
>Environment:
>Description:
Hi all,

I've attached a patch for the macppc port's hardware notes
(/src/distrib/notes/macppc/hardware) to try to bring it up to date for
the 4.0 release.

A summary of my changes:

- Updated the supported hardware list to include newer Powerbook G4
models, the Mac Mini, and various G5 models.  (Basically synced it with
the separate web page that provides this information, though there are
probably still differences.)
- Added a caveat about the fact some of the newest G4 models do not
necessarily run at their full CPU speed.  (This is also consistent with
the note on the model support web page.)  I assume that this is still
relevant for 4.0, the last email I could find on the subject is here:
http://mail-index.netbsd.org/port-macppc/2006/03/09/0001.html
- Added a caveat that G5 models are only supported in 32-bit bridge
mode.
- Revised unsupported model list to reflect changes above.
- Fixed three references to ethernet devices so their "proper" names are
provided.
- Added note that wscons capabilities are now available.
- Also supplied caveat that wscons does not support VT switching while
X is running, reference:
http://mail-index.netbsd.org/port-macppc/2007/01/15/0002.html
- Added the snapper driver to the list of supported devices.
- Slightly revised the comment about awacs being an experimental driver.
- Fixed a nroff glitch under serial ports that was causing two words to
be rendered without a space between them in the HTML output.
- Updated list of unsupported devices, removing some, and adding a note
that the SATA controller on G5s is not supported, reference:
http://mail-index.netbsd.org/port-macppc/2006/11/27/0005.html

This is based on what I know from reading the port-macppc mailing list,
and so may not be wholly complete or accurate, but I thought I'd take a
stab at it.

A few things I didn't change but have questions about, as they may be
relevant:

- Does the awacs instability caveat really still apply for releases
>=4.0?  (I don't have a machine with awacs, so I can't test.)
- Under unsupported devices, should advanced power management be
qualified or updated?  I infer there has been some progress here.  Or
am I confusing power monitoring and power management?  I use the
former but not the latter on my iBook right now.

Dave
>How-To-Repeat:

>Fix:
--- hardware.orig	2004-10-31 22:01:56.000000000 -0500
+++ hardware	2007-05-21 18:17:10.000000000 -0400
@@ -125,7 +125,8 @@
 Apple PowerBook (G3 Series (bronze keyboard) and G3 (FireWire))
 .It
 Apple PowerBook (G4 (Titanium), G4 (Gigabit Ethernet), G4 (DVI), 
-G4 (12-inch), G4 (17-inch), G4 (12-inch DVI))
+G4 (12-inch), G4 (17-inch), G4 (12-inch DVI), PowerBook G4
+(15-inch FW 800), PowerBook G4 (17-inch 1.33GHz/1.5GHz))
 .It
 Apple PowerMacintosh G3 (Blue and White)
 .It
@@ -133,7 +134,18 @@
 (Digital Audio), G4 (Quicksilver), G4 (Quicksilver 2002), 
 G4 (Mirrored Drive Doors), G4 (FW 800), and G4 Cube)
 .It
+Apple Mac Mini G4 (1.25GHz/1.42GHz/1.5GHz)
+.It
 Apple original Xserve and Xserve (Slot Load)
+.(Note
+Some newer G4 models may not run at their full CPU speed, due to
+the fact Open Firmware starts the CPU at a reduced frequency.
+.Note)
+.It
+Apple iMac G5, PowerMacintosh G5, Xserve G5
+.(Note
+G5 models are supported as a 32-bit port in bridge mode only.
+.Note)
 .bullet)
 .tag)
 .
@@ -142,8 +154,6 @@
 Systems with Open Firmware, but using a PPC 601 microprocessor
 (PowerMacintosh 7200 and 7500 (without CPU upgrade))
 .It
-Systems with Open Firmware, but using a PPC G5 microprocessor
-.It
 Systems with a PowerPC microprocessor, but lacking Open Firmware
 .(bullet -compact
 Apple PowerBook (1400, 2300, and 5300)
@@ -163,15 +173,6 @@
 .It
 Systems upgraded from any of the above (unless the motherboard is replaced as
 part of the upgrade)
-.It
-Systems released in late 2004 and later (future releases of
-.Nx*M
-will support these systems)
-.It
-Systems released before late 2004, but not listed
-above.
-These models might work, but have not been tested as of the release of
-.Nx \*V .
 .bullet)
 .
 .Ss2 Supported devices
@@ -191,13 +192,13 @@
 Ethernet
 .(bullet -compact
 On-board 79C950-based MACE Ethernet interface
-.Pq Em mc0
+.Pq Em mc
 .It
 On-board bmac Ethernet interface
-.Pq Em bm0
+.Pq Em bm
 .It
 On-board gmac Ethernet interface
-.Pq Em gem0
+.Pq Em gem
 .It
 Apple PCI Ethernet Card (option for Apple Network Server)
 .Pq Em tlp
@@ -359,17 +360,23 @@
 .It
 PCI frame buffers which have Open Firmware support
 (ATI, IMS, Matrox, and NVIDIA have several models which work)
+.It
+Full wscons capabilities, such as virtual terminals and color text are
+available.  (Note however that switching between virtual terminals
+while running an X session is not supported at present.)
 .bullet)
 .It
 Audio
 .(bullet -compact
 On-board audio on most models
-.Pq Em awacs
+.Pq Em awacs No or Em snapper
 .(Note
-This driver has only recently been introduced and is considered
-.Dq experimental
-meaning that it may cause your system to crash and/or is lacking some
-features you may expect.
+The
+.Pq Em awacs
+driver is considered
+.Dq experimental No ,
+meaning that it may cause your system to crash and/or is lacking
+some features you may expect.
 Due to interrupt conflicts with some G4 models, this driver is disabled
 by default and you will need to build a kernel with it enabled.
 .Note)
@@ -386,7 +393,8 @@
 .It
 Serial ports
 .br
-.Nx*M refers to the on-board serial ports as 
+.Nx*M
+refers to the on-board serial ports as 
 .Pq Em tty00
 and
 .Pq Em tty01 .
@@ -490,16 +498,15 @@
 .Note)
 .Pp
 .It
-FireWire (IEEE 1394)
-.It
 Advanced power management (cannot put system to
 .Sq sleep )
 .It
-Full wscons capabilities, such as virtual terminals and color text
-.It
 On-board video capture
 .It
 AirPort Extreme
+.It
+On-board SATA controller on G5 systems (these machines must be
+netbooted)
 .bullet)
 .
 .Ss2 Supported boot devices and media