Options revision 1.10
11.10Sad$NetBSD: Options,v 1.10 2007/12/31 13:38:48 ad Exp $
21.3Scgd
31.1SmycroftHere is a list of hp300 specific kernel compilation options and what they
41.1Smycroftmean:
51.1Smycroft
61.1SmycroftHAVEVAC
71.1Smycroft	Compiles in support for virtually addressed cache (VAC) found on
81.1Smycroft	hp320 and 350 machines.  Should only be defined when HP320 and/or
91.1Smycroft	HP350 is.
101.1Smycroft
111.1SmycroftHP320
121.9Slukem	Support for old hp320 machines: 16 MHz 68020, HP MMU, 16 MHz 68881
131.1Smycroft	and VAC.  Compiles in support for a VAC, HP MMU, and the 98620A
141.1Smycroft	16-bit DMA channel.  Forces the definition of HAVEVAC.
151.1Smycroft
161.1SmycroftHP350
171.9Slukem	Support for old hp350 machines: 25 MHz 68020, HP MMU, 20 MHz 68881
181.1Smycroft	and VAC.  Compiles in support for a VAC and the HP MMU.  Differs
191.1Smycroft	from HP320 in that it has no support for 16-bit DMA controller.
201.1Smycroft	Forces the definition of HAVEVAC.
211.1Smycroft
221.1SmycroftHP330
231.9Slukem	Support for old hp330 (and 318/319) machines: 16 MHz 68020, 68851 PMMU
241.9Slukem	and 16 MHz 68881.  Compiles in support for PMMU.
251.1Smycroft
261.6ScarrelHP340
271.1SmycroftHP360
281.9Slukem	Support for old 340 and hp360 machines: 25 MHz 68030+MMU and 25 MHz
291.1Smycroft	68882.  Compiles in support for PMMU and 68030.  Differs from HP330
301.1Smycroft	in support for 68030 on-chip data cache.
311.1Smycroft
321.1SmycroftHP370
331.9Slukem	Support for old hp370 (and current 345/375/400) machines: 33 (50) MHz
341.9Slukem	68030+MMU and 33 (50) MHz 68882.  Compiles in support for PMMU, 68030
351.1Smycroft	and off-chip physically addressed cache.  Differs from 360 in only one
361.1Smycroft	place, in dealing with flushing the external cache.
371.1Smycroft
381.1SmycroftHP380
391.9Slukem	Support for "current" hp380/425 (and 433) machines: 25 (33) MHz 68040
401.1Smycroft	with MMU/FPU.  Compiles in support for 68040.
411.1Smycroft
421.2SmycroftFPSP
431.2Smycroft	Compiles in support to link with Motorola's 68040 FP emulation
441.2Smycroft	library.  Kernel will build and run without this option, but many
451.2Smycroft	binaries will core dump.  Should not be defined unless HP380 is.
461.1Smycroft
471.1Smycroft
481.1SmycroftUSELEDS
491.1Smycroft	Twinkle the hp4xx front panel (or hp3xx internal) LEDs in the HP
501.1Smycroft	designated way.  Somewhat frivolous, but the heartbeat LED is
511.1Smycroft	useful to see if your machine is alive.
521.1Smycroft
531.1SmycroftPANICBUTTON
541.1Smycroft	Compiles in code which will enable a "force-crash" HIL keyboard
551.1Smycroft	sequence.  When the Reset key is typed twice in succession (within
561.1Smycroft	half a second) the kernel will panic.  Note that the HIL Reset key
571.1Smycroft	sends a NMI to the processor which will get the CPUs attention no
581.1Smycroft	matter what it is doing (i.e. as long as it isn't halted).  Alas,
591.1Smycroft	also note that the NMI is only sent when the keyboard is in "cooked"
601.1Smycroft	(ITE) mode.  If it is in "raw" mode (i.e. X-server is running) the
611.1Smycroft	Reset key is just another keypress event.  A cheezy substitute in
621.1Smycroft	this case is holding down the upper right-most unlabeled key and
631.1Smycroft	then pressing the unlabeled key to its left.  Note that this only
641.1Smycroft	works if HIL (level 1) interrupts are not masked.
651.1Smycroft
661.1SmycroftDEBUG
671.5Schristos	Compiles in a variety of consistency checks and debug printfs
681.1Smycroft	throughout the hp300 MD code and device drivers.
691.1Smycroft
701.1SmycroftDCMSTATS
711.1Smycroft	Compile in code to collect a variety of transmit/receive statistics
721.1Smycroft	for the 98642 4-port MUX.
731.1Smycroft
741.1SmycroftWAITHIST
751.1Smycroft	Compile in code to collect statistics about the distribution of
761.1Smycroft	wait-times for various busy waits in the SCSI host-adaptor driver.
771.1Smycroft
781.1SmycroftSTACKCHECK
791.1Smycroft	Enables two types of kernel stack checking in hp300/hp300/locore.s:
801.1Smycroft	1. stack "overflow".  On every clock interrupt we ensure that
811.1Smycroft	   the current kernel stack has not grown into the user struct
821.1Smycroft	   page, i.e. size exceeded UPAGES-1 pages.
831.1Smycroft	2. stack "underflow".  Before every rte to user mode we ensure
841.1Smycroft	   that we will be exactly at the base of the stack after the
851.1Smycroft	   exception frame has been popped.
861.1Smycroft	This option can degrade performance considerably, use it only if
871.1Smycroft	you suspect a problem with kernel stacks.
881.1Smycroft
891.1SmycroftSCSI_REVPRI
901.1Smycroft	Changes autoconf to start matching logical SCSI devices starting
911.1Smycroft	at slave 6 and working backwards instead of starting at slave 0
921.1Smycroft	and working up.  Later releases of the HP boot ROM search for
931.1Smycroft	boot devices in this manner.  This is apparently the order in
941.1Smycroft	which priority is given to slaves on the host adaptor.  Define
951.1Smycroft	this if you use wildcarding and want to stay in sync with the
961.1Smycroft	boot ROM's strategy.
971.1Smycroft
981.1SmycroftMAPPEDCOPY
991.1Smycroft	Use page remapping to do large copyin/copyouts.  When defined
1001.1Smycroft	the default is to use mapped copy for operations on one page
1011.1Smycroft	or more except on machines with virtually-indexed caches.
1021.1Smycroft	See initcpu() in machdep.c
1031.1Smycroft
1041.1SmycroftBUFFERS_UNMANAGED
1051.1Smycroft	Set up the buffer cache "below" the machine independent VM.
1061.1Smycroft	Normally, in startup() we use vm_map operations to initially
1071.1Smycroft	assign physical memory to the buffers.  This creates a map with
1081.1Smycroft	a huge number of map entries (twice the number of buffers)
1091.1Smycroft	which serve no purpose since remaining buffer operations
1101.1Smycroft	(i.e. pagemove) work below the MI layer anyway.  Defining this
1111.1Smycroft	symbol will cause startup() to use pmap operations to map the
1121.1Smycroft	initial pages leaving the buffer_map one big entry.
113