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 a machine directive to choose powerpc or powerpc64
#machine		powerpc powerpc[64]

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

options 	FPU_EMU

#options 	MPC85XX
options 	POWERMAC		#NewWorld Apple PowerMacs
#options	PS3			#Sony Playstation 3
options 	PSIM			#GDB PSIM ppc simulator
options 	MAMBO			#IBM Mambo Full System Simulator
#options 	WII			#Nintendo Wii

options 	SC_OFWFB		# OFW frame buffer

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

# Standard busses
device		pci
device		agp

device		bm		# Apple BMAC (Big Mac Ethernet)
device		glc		# Sony Playstation 3 Ethernet
device		kiic		# Apple Keywest I2C Controller
device		ofwd		# Open Firmware disks
device		adb		# Apple Desktop Bus
device		cuda		# VIA-CUDA ADB interface
device          ad7417          # PowerMac7,2 temperature sensor
device		ds1631		# PowerMac11,2 temperature sensor
device		ds1775		# PowerMac7,2 temperature sensor
device		fcu		# Apple Fan Control Unit
device		max6690		# PowerMac7,2 temperature sensor
device		pmu		# Apple Power Management Unit
device		smu		# Apple System Management Unit
device		snd_ai2s	# Apple I2S Audio
device		snd_davbus	# Apple Davbus Audio
device		adm1030		# Apple G4 MDD fan controller


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

nodevice	bktr
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
-												Unbreak the LINT kernel on powerpc64. Note that the LINT kernel
configuration is TARGET_ARCH specific and must be generated with
TARGET_ARCH set.

Reviewed by:	imp

											
										
										
											2010-08-19 03:19:26 +00:00
+								# You must specify a machine directive to choose powerpc or powerpc64
 								#machine		powerpc powerpc[64]
-												MFppc64:

Kernel sources for 64-bit PowerPC, along with build-system changes to keep
32-bit kernels compiling (build system changes for 64-bit kernels are
coming later). Existing 32-bit PowerPC kernel configurations must be
updated after this change to specify their architecture.

											
										
										
											2010-07-13 05:32:19 +00:00
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								#
 								# 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
-												Let us manage differences of Book-E PowerPC variations i.e. vendor /
implementation specific vs. the common architecture definition.

Bring PPC4XX defines (PSL, SPR, TLB). Note the new definitions under
BOOKE_PPC4XX are not used in the code yet.

This change set is not supposed to affect existing E500 support, it's just
another reorg step before bringing support for E500mc, E5500 and PPC465.

Obtained from:	AppliedMicro, Freescale, Semihalf

											
										
										
											2012-05-27 10:25:20 +00:00
+								#cpu		BOOKE_E500
 								#cpu		BOOKE_PPC440
-												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
-												Unbreak the LINT build. PS3 kernels can only be built 64-bit, and LINT is
built for both architectures. We need a better solution here.

											
										
										
											2011-01-06 14:12:24 +00:00
+								#options	PS3			#Sony Playstation 3
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								options 	PSIM			#GDB PSIM ppc simulator
-												In kernel config files, it is supposed to be 'options<space><tab>' not
'options<tab><tab>', per long standing (but recently not so strictly
enforced) convention.

											
										
										
											2014-03-18 14:41:18 +00:00
+								options 	MAMBO			#IBM Mambo Full System Simulator
-												Add "options WII".

											
										
										
											2012-10-21 04:02:34 +00:00
+								#options 	WII			#Nintendo Wii
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
-												- 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
-												Add a driver for the Apple Uninorth AGP host bridge found in all PowerPC
Macintoshes with an AGP bus.

											
										
										
											2010-10-31 18:27:05 +00:00
+								device		agp
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
-												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)
-												Import support for the Sony Playstation 3 using the OtherOS feature
available on firmwares 3.15 and earlier.

Caveats: Support for the internal SATA controller is currently missing,
as is support for framebuffer resolutions other than 720x480. These
deficiencies will be remedied soon.

Special thanks to Peter Grehan for providing the hardware that made this
port possible, and thanks to Geoff Levand of Sony Computer Entertainment
for advice on the LV1 hypervisor.

											
										
										
											2011-01-06 04:12:29 +00:00
+								device		glc		# Sony Playstation 3 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
-												Add a new driver, the ad7417, to read temperatures and voltages on some
PowerMac's.

Approved by:	nwhitehorn (mentor)

											
										
										
											2011-05-29 14:25:42 +00:00
+								device          ad7417          # PowerMac7,2 temperature sensor
-												Add the ds1631 temperature driver.

											
										
										
											2012-08-19 19:44:13 +00:00
+								device		ds1631		# PowerMac11,2 temperature sensor
-												Add three new drivers for fan control and temperature reading on the
PowerMac7,2.

- The fcu driver lets us read and write the fan RPMs for all fans in the
  PowerMac7,2. This driver is PowerMac specific.
- The ds1775 is a driver to read the temperature for the drive bay sensor.
- The max6690 is another driver to read temperatures. Here it is used to
  read the inlet, the backside and the U3 heatsink temperature.

An additional driver, the ad7417, will follow later.

Thanks to nwhitehorn for guiding me through this driver development.

Approved by:	nwhitehorn (mentor)

											
										
										
											2010-10-15 20:08:16 +00:00
+								device		ds1775		# PowerMac7,2 temperature sensor
 								device		fcu		# Apple Fan Control Unit
 								device		max6690		# PowerMac7,2 temperature sensor
-												Accidentally left ADB out of the PowerPC NOTES file during initial import.

											
										
										
											2008-12-08 02:38:13 +00:00
+								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
-												Move the adm1030 driver to the proper location, and rename it.

For compatibility, 'device windtunnel' is still supported, but one should use
'device adm1030' instead, and this has been updated in GENERIC and NOTES.

											
										
										
											2014-10-16 01:32:22 +00:00
+								device		adm1030		# Apple G4 MDD fan controller
-												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
-												Unbreak the LINT kernel on powerpc64. Note that the LINT kernel
configuration is TARGET_ARCH specific and must be generated with
TARGET_ARCH set.

Reviewed by:	imp

											
										
										
											2010-08-19 03:19:26 +00:00
+								nodevice	bktr
-												add LINT build

Discussed with:	grehan
MFC after:	1 week

											
										
										
											2005-12-21 02:51:41 +00:00
+								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