freebsd-skq/sys/powerpc/conf/NOTES

# $FreeBSD$
#
# This file contains machine dependent kernel configuration notes.  For
# machine independent notes, look in /sys/conf/NOTES.


#####################################################################
# CPU OPTIONS

#
# You must specify at least one CPU (the one you intend to run on).
cpu		AIM
#cpu		E500

options 	FPU_EMU

#options 	MPC85XX
options 	POWERMAC		#NewWorld Apple PowerMacs
options 	PSIM			#GDB PSIM ppc simulator

options 	SC_OFWFB		# OFW frame buffer

# The cpufreq(4) driver provides support for CPU frequency control
device		cpufreq

# Standard busses
device		pci

device		bm		# Apple BMAC (Big Mac Ethernet)
device		kiic		# Apple Keywest I2C Controller
device		ofwd		# Open Firmware disks
device		adb		# Apple Desktop Bus
device		cuda		# VIA-CUDA ADB interface
device		pmu		# Apple Power Management Unit
device		smu		# Apple System Management Unit
device		snd_ai2s	# Apple I2S Audio
device		snd_davbus	# Apple Davbus Audio


#####################################################################
# Devices we don't want to deal with

nodevice	fdc
nodevice	ppc
nodevice	splash
# when splash works enable *_saver
nodevice	blank_saver
nodevice	daemon_saver
nodevice	dragon_saver
nodevice	fade_saver
nodevice	fire_saver
nodevice	green_saver
nodevice	logo_saver
nodevice	rain_saver
nodevice	snake_saver
nodevice	star_saver
nodevice	warp_saver
nodevice	daemon_saver
nodevice	star_saver
nodevice	snake_saver
# isa
nodevice	pcii
nodevice	tnt4882
# sound
nodevice	snd_cmi
# wants gdb_cur
nodevice	dcons
nodevice	dcons_crom


#####################################################################
# Options we don't want to deal with

nooption	PPC_DEBUG
nooption	PPC_PROBE_CHIPSET
nooption 	SC_NO_MODE_CHANGE
nooption 	UKBD_DFLT_KEYMAP
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								# $FreeBSD$
 								#
 								# This file contains machine dependent kernel configuration notes.  For
 								# machine independent notes, look in /sys/conf/NOTES.
 								#####################################################################
 								# CPU OPTIONS
 								#
 								# You must specify at least one CPU (the one you intend to run on).
-												Rename OEA to AIM. The former means nothing as it applies to all
processors (it's the PowerPC Operating Environment Architecture).
AIM designates the processors made by the Apple-IBM-Motorola
alliance and those we typically support.

While here, remove the NetBSD option IPKDB. It's not an option
used by us. Also, PPC_HAVE_FPU is not used by us either. Remove
that too.

Obtained from: Juniper, Semihalf

											
										
										
											2007-12-16 00:45:56 +00:00
+								cpu		AIM
-												Comment-out cpu E500. We can't yet build it with AIM at the same time.

											
										
										
											2008-03-04 02:20:27 +00:00
+								#cpu		E500
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
-												Add FPU_EMU.

											
										
										
											2008-02-23 22:32:16 +00:00
+								options 	FPU_EMU
-												Also comment-out options MPC85XX. We don't define CCSRBAR_* without E500.

											
										
										
											2008-03-04 03:05:53 +00:00
+								#options 	MPC85XX
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								options 	POWERMAC		#NewWorld Apple PowerMacs
 								options 	PSIM			#GDB PSIM ppc simulator
-												- Use "device\t" and "options \t" for consistency.

											
										
										
											2009-05-10 00:00:25 +00:00
+								options 	SC_OFWFB		# OFW frame buffer
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
-												Introduce support for cpufreq on PowerPC with the dynamic frequency
switching capabilities of the MPC7447A and MPC7448.

											
										
										
											2009-05-31 09:01:23 +00:00
+								# The cpufreq(4) driver provides support for CPU frequency control
 								device		cpufreq
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								# Standard busses
 								device		pci
-												Move bm(4) from the sys/conf/NOTES to sys/powerpc/conf/NOTES.
The driver applies to PowerPC only.

											
										
										
											2008-06-08 01:58:11 +00:00
+								device		bm		# Apple BMAC (Big Mac Ethernet)
-												Driver for Apple Keywest I2C controllers found in MacIO ASICs. Used for
power and thermal control, as well as GPIOs on Xserves and controlling
sound codecs for Apple built-in audio.

Submitted by:	Marco Trillo
Obtained from:	NetBSD

											
										
										
											2009-01-15 02:52:31 +00:00
+								device		kiic		# Apple Keywest I2C Controller
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								device		ofwd		# Open Firmware disks
-												Accidentally left ADB out of the PowerPC NOTES file during initial import.

											
										
										
											2008-12-08 02:38:13 +00:00
+								device		adb		# Apple Desktop Bus
 								device		cuda		# VIA-CUDA ADB interface
 								device		pmu		# Apple Power Management Unit
-												Add cpufreq support on the PowerPC G5, along with a skeleton SMU driver
in order to slew CPU voltage during frequency changes. The OpenBSD SMU
driver was an extremely helpful reference for this.

											
										
										
											2009-06-23 04:28:32 +00:00
+								device		smu		# Apple System Management Unit
-												Add support for the I2S and davbus audio controllers found in Apple PowerPC
hardware.

Submitted by:	Marco Trillo

											
										
										
											2009-01-25 18:20:15 +00:00
+								device		snd_ai2s	# Apple I2S Audio
 								device		snd_davbus	# Apple Davbus Audio
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
 								#####################################################################
 								# Devices we don't want to deal with
 								nodevice	fdc
 								nodevice	ppc
-												Move "device splash" back to MI NOTES and "files", it's MI.

											
										
										
											2006-10-23 13:23:14 +00:00
+								nodevice	splash
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								# when splash works enable *_saver
 								nodevice	blank_saver
 								nodevice	daemon_saver
 								nodevice	dragon_saver
 								nodevice	fade_saver
 								nodevice	fire_saver
 								nodevice	green_saver
 								nodevice	logo_saver
 								nodevice	rain_saver
 								nodevice	snake_saver
 								nodevice	star_saver
 								nodevice	warp_saver
 								nodevice	daemon_saver
 								nodevice	star_saver
 								nodevice	snake_saver
 								# isa
 								nodevice	pcii
 								nodevice	tnt4882
-												Redefine bus_space_tag_t on PowerPC from a 32-bit integral to
a pointer to struct bus_space. The structure contains function
pointers that do the actual bus space access.

The reason for this change is that previously all bus space
accesses were little endian (i.e. had an explicit byte-swap
for multi-byte accesses), because all busses on Macs are little
endian.
The upcoming support for Book E, and in particular the E500
core, requires support for big-endian busses because all
embedded peripherals are in the native byte-order.

With this change, there's no distinction between I/O port
space and memory mapped I/O. PowerPC doesn't have I/O port
space. Busses assign tags based on the byte-order only.
For that purpose, two global structures exist (bs_be_tag and
bs_le_tag), of which the address can be taken to get a valid
tag.

Obtained from: Juniper, Semihalf

											
										
										
											2007-12-19 18:00:50 +00:00
+								# sound
 								nodevice	snd_cmi
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								# wants gdb_cur
 								nodevice	dcons
 								nodevice	dcons_crom
 								#####################################################################
 								# Options we don't want to deal with
 								nooption	PPC_DEBUG
 								nooption	PPC_PROBE_CHIPSET
-												Add missing SC_NO_MODE_CHANGE option. Disable it in the powerpc
NOTES though, as ofw_syscons(4) doesn't properly interface with
syscons(4) regarding loading the font specified with SC_DFLT_FONT,
causing a kernel with both options SC_OFWFB and SC_NO_MODE_CHANGE
to not link.

											
										
										
											2007-01-10 18:45:18 +00:00
+								nooption 	SC_NO_MODE_CHANGE
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								nooption 	UKBD_DFLT_KEYMAP