NetBSD/sys/dev/ic
ross 7e0b361d84 Fix for kernel alignment crash reported on port-alpha. A developer went on
a happy code sweep (in the kernel!) and constified a random selection of
kernel objects. This changed the alignment of the previously-aligned-by-
accident seqprog array, and exposed a lurking bug.  I can't decide if this
is good or bad.
2001-04-14 19:37:17 +00:00
..
Makefile re-add bt8xx.h (needed for fxtv, without which bktr is pretty much useless) 2001-04-11 09:07:21 +00:00
README.ncr5380sbc
ac97.c constify 2001-01-18 20:28:15 +00:00
ac97reg.h
ac97var.h
ad1848.c constify 2001-01-18 20:28:15 +00:00
ad1848reg.h
ad1848var.h
adv.c Cast to u_int64_t when computing callout argument, to avoid int overflow. 2001-03-27 17:24:03 +00:00
adv.h Preliminary support for detaching an "adv" instance. This 2001-03-08 06:49:49 +00:00
advlib.c
advlib.h Preliminary support for detaching an "adv" instance. This 2001-03-08 06:49:49 +00:00
advmcode.c constify 2001-01-18 20:28:15 +00:00
advmcode.h constify 2001-01-18 20:28:15 +00:00
adw.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
adw.h
adwlib.c
adwlib.h
adwmcode.c
adwmcode.h constify 2001-01-18 20:28:15 +00:00
aha.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
ahareg.h
ahavar.h
aic7xxx.c Fix for kernel alignment crash reported on port-alpha. A developer went on 2001-04-14 19:37:17 +00:00
aic7xxx_seeprom.c
aic7xxxvar.h expose the definitions of MIN() and MAX() in sys/param.h to the kernel 2001-02-05 10:42:40 +00:00
aic77xx.c
aic77xxreg.h
aic77xxvar.h
aic6360.c
aic6360reg.h
aic6360var.h
am79c930.c
am79c930reg.h
am79c930var.h
am7930.c
am7930reg.h
am7930var.h
am7990.c
am7990reg.h
am7990var.h
am9513reg.h Added. 2001-04-10 12:46:26 +00:00
am79900.c
am79900reg.h
am79900var.h
an.c Make sure data after the header is aligned, so that this works on 2001-03-08 16:33:43 +00:00
anreg.h Add additional padding to the status record, needed by the AIR-PCM342. 2001-03-08 16:30:50 +00:00
anvar.h
apcdmareg.h
ate_subr.c Prepare for MCA attachment: 2001-03-31 00:26:53 +00:00
ate_subr.h fix the copyright - Charles's name was added here by mistake, use 2001-03-31 09:49:00 +00:00
awi.c
awi_wep.c constify 2001-01-18 20:28:15 +00:00
awi_wicfg.c
awireg.h
awivar.h constify 2001-01-18 20:28:15 +00:00
bha.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
bhareg.h
bhavar.h
bt8xx.h
bt431reg.h
bt459reg.h
bt463.c
bt463reg.h
bt463var.h
bt485.c
bt485reg.h
bt485var.h
cac.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
cacreg.h
cacvar.h
cd1190reg.h
cd1400reg.h
clmpcc.c
clmpccreg.h
clmpccvar.h
com.c
com_upc.c
comreg.h
comvar.h
cs4231.c
cs4231reg.h
cs4231var.h
cs4237reg.h
cy.c Untangle some spl-spaghetti in cy_modem_control(). 2001-01-21 16:55:10 +00:00
cyreg.h
cyvar.h Pack the minor numbers like the Cyclades-Z driver does, and 2001-01-20 19:29:05 +00:00
daic.c
daicreg.h
daicvar.h
dc21040reg.h
decmonitors.c
depca.c
depcareg.h
depcavar.h
dl10019.c Support for the MII on the D-Link DL10019/DL10022 NE2000-compatible 2001-02-13 01:43:02 +00:00
dl10019reg.h Register definitions for the D-Link DL10019 and DL10022 Ethernet 2001-02-10 16:41:40 +00:00
dl10019var.h Support for the MII on the D-Link DL10019/DL10022 NE2000-compatible 2001-02-13 01:43:02 +00:00
dp8390.c Add a "stop_card", which is the opposite of "init_card", and 2001-02-12 18:56:26 +00:00
dp8390reg.h
dp8390var.h Add a "stop_card", which is the opposite of "init_card", and 2001-02-12 18:56:26 +00:00
dpt.c Missing splx(). From OpenBSD. 2001-03-25 14:48:28 +00:00
dptreg.h
dptvar.h
ds.h
elink3.c Add MCA ep(4) attachment, for 3Com 3c529-type cards. Tested with 3c529-TP, 2001-03-22 16:54:45 +00:00
elink3reg.h
elink3var.h Add MCA ep(4) attachment, for 3Com 3c529-type cards. Tested with 3c529-TP, 2001-03-22 16:54:45 +00:00
elinkxl.c Power management support for the CardBus Etherlink XL cards. 2001-01-30 19:27:39 +00:00
elinkxlreg.h
elinkxlvar.h Power management support for the CardBus Etherlink XL cards. 2001-01-30 19:27:39 +00:00
hayespreg.h
hd64570.c IPv6 support, from fujiwara@rcac.tdi.co.jp 2001-03-01 00:40:41 +00:00
hd64570reg.h IPv6 support, from fujiwara@rcac.tdi.co.jp 2001-03-01 00:40:41 +00:00
hd64570var.h
hme.c
hmereg.h
hmevar.h
hscx.c First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
hscx.h Filename cleanup: remove i4b_ prefixes outside sys/netisdn, last round. 2001-02-20 22:24:31 +00:00
i8042reg.h
i8237reg.h
i8253reg.h
i82365.c make some more constant arrays 'const' 2001-02-21 21:39:52 +00:00
i82365reg.h
i82365var.h
i82557.c
i82557reg.h
i82557var.h
i82586.c ether_ioctl() expects i82586_init() to return an errno. Have it do so 2001-04-09 22:31:16 +00:00
i82586reg.h improve description of IE_TDR_OPEN & IE_TDR_SHORT a bit 2001-03-10 19:57:38 +00:00
i82586var.h add 'why' argument to the channel attention hook function; this argument 2001-03-10 20:04:30 +00:00
i82595reg.h Don't need to use the hash filter for a single individual address; make 2001-03-16 13:43:31 +00:00
ics2101reg.h
ims332reg.h
intersil7170.c
intersil7170.h
interwave.c
interwavereg.h
interwavevar.h
ipac.h Filename cleanup: remove i4b_ prefixes outside sys/netisdn, last round. 2001-02-20 22:24:31 +00:00
isac.c First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
isac.h Filename cleanup: remove i4b_ prefixes outside sys/netisdn, last round. 2001-02-20 22:24:31 +00:00
isic.c First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
isic_bchan.c improve readibility 2001-03-25 14:38:23 +00:00
isic_l1.c First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
isic_l1.h First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
isic_l1fsm.c First step to cleanup the hardware driver <-> upper layers interface. 2001-03-24 12:40:29 +00:00
isp.c Note one other place that bogus interrupts can be measured. 2001-04-10 21:51:21 +00:00
isp_inline.h Handles are now u_int16_t instead of u_int32_t. ANSIfy (NetBSD was the holdout). 2001-03-14 04:55:21 +00:00
isp_ioctl.h Add some HBA ioctl functions (LIP resets, rescan, setting debugging level). 2001-04-10 21:50:40 +00:00
isp_netbsd.c Add initial implementation of ISP_SDBLEV, ISP_RESETHBA, ISP_FC_RESCAN, 2001-04-10 21:52:00 +00:00
isp_netbsd.h Include isp_ioctl.h. 2001-04-10 21:52:15 +00:00
isp_target.c Keep up with the Joneses: sync with common core target mode code. Eventually 2001-04-05 02:28:17 +00:00
isp_target.h Keep up with the Joneses: sync with common core target mode code. Eventually 2001-04-05 02:28:17 +00:00
isp_tpublic.h Clean up some comments. Expand usage of cd_reserved. Expand cd_tagval 2001-03-14 05:10:38 +00:00
ispmbox.h Add a few opcodes for target mode. Define firmware attributes (for FC f/w). 2001-04-05 02:28:53 +00:00
ispreg.h Put in offset definitions for FPM and FBM registers, plus just enough 2001-02-12 23:33:11 +00:00
ispvar.h Roll core minor. ANSify. 2001-03-14 05:14:36 +00:00
lance.c
lancereg.h
lancevar.h
ld_cac.c
ld_mlx.c Add a driver for the Mylex DAC960 family (including DEC SWXCR). 2001-02-04 17:05:11 +00:00
lemac.c
lemacreg.h
lemacvar.h
lpt.c
lpt_upc.c
lptreg.h
lptvar.h
lsi64854.c Make sure to print "\n" at the end of the attach line on non-DEBUG case. 2001-04-08 11:45:45 +00:00
lsi64854reg.h fas support added 2001-03-29 02:58:38 +00:00
lsi64854var.h fas support added 2001-03-29 02:58:38 +00:00
mb86960.c consistently use FE_DEBUG (DEBUG was used a couple of places where it 2001-01-20 07:31:00 +00:00
mb86960reg.h
mb86960var.h
mb89352.c
mb89352reg.h
mb89352var.h
mc6845reg.h
mc68450reg.h
mc146818reg.h
midway.c splimp -> splnet 2001-04-12 03:10:35 +00:00
midwayreg.h
midwayvar.h
mk48txx.c Correct values for sanity checks. 2001-04-08 17:05:10 +00:00
mk48txxreg.h
mlx.c - Some firmware fills the system drive table with junk, so get the number 2001-04-09 15:40:09 +00:00
mlxio.h Add a driver for the Mylex DAC960 family (including DEC SWXCR). 2001-02-04 17:05:11 +00:00
mlxreg.h Add a driver for the Mylex DAC960 family (including DEC SWXCR). 2001-02-04 17:05:11 +00:00
mlxvar.h Add a driver for the Mylex DAC960 family (including DEC SWXCR). 2001-02-04 17:05:11 +00:00
mm58167.c Added. 2001-04-10 12:46:26 +00:00
mm58167var.h Added. 2001-04-10 12:46:26 +00:00
monitors.h
mpu.c
mpuvar.h
ncr53c9x.c fas support added 2001-03-29 02:58:38 +00:00
ncr53c9xreg.h fas support added 2001-03-29 02:58:38 +00:00
ncr53c9xvar.h fas support added 2001-03-29 02:58:38 +00:00
ncr53c400reg.h
ncr5380.doc
ncr5380reg.h
ncr5380sbc.c Remove the use of splimp() from the NetBSD kernel. splnet() 2001-04-13 23:29:55 +00:00
ncr5380var.h
ne2000.c Adjust the way that media is initialized on DP8390-compatible 2001-02-12 18:49:03 +00:00
ne2000reg.h
ne2000var.h Adjust the way that media is initialized on DP8390-compatible 2001-02-12 18:49:03 +00:00
nec765reg.h
ns8477reg.h
ns16450reg.h
ns16550reg.h
nslm7x.c
nslm7xvar.h
opl.c constify 2001-01-18 20:28:15 +00:00
opl3sa3reg.h
oplinstrs.c constify 2001-01-18 20:28:15 +00:00
oplreg.h
oplvar.h constify 2001-01-18 20:28:15 +00:00
pcdisplay.h
pcdisplay_chars.c constify 2001-01-18 20:28:15 +00:00
pcdisplay_subr.c
pcdisplayvar.h
pckbc.c Change the way the aux port is probed for. Some older chipsets w/o 2001-04-09 15:45:50 +00:00
pckbcvar.h
pdq.c
pdq_ifsubr.c
pdqreg.h
pdqvar.h
ramdac.h
rrunner.c eliminate the KERN_* error codes in favor of the traditional E* codes. 2001-03-15 06:10:32 +00:00
rrunnerreg.h
rrunnervar.h
rtl80x9.c Adjust the way that media is initialized on DP8390-compatible 2001-02-12 18:49:03 +00:00
rtl80x9reg.h
rtl80x9var.h Adjust the way that media is initialized on DP8390-compatible 2001-02-12 18:49:03 +00:00
rtl81x9.c Rework the transmit logic. Use a "free" and "dirty" list of 2001-02-02 04:34:19 +00:00
rtl81x9reg.h Use a 16K receive buffer on the SEGA Dreamcast (XXX should be 2001-01-31 07:44:51 +00:00
rtl81x9var.h Rework the transmit logic. Use a "free" and "dirty" list of 2001-02-02 04:34:19 +00:00
seeq8003reg.h
seeq8005.c In ea_writembuf(), reset the DMA pointer for each mbuf we copy, since 2001-04-06 00:02:49 +00:00
seeq8005reg.h Add some definitions for the 80C04A, thanks to Reinoud, who found me a data 2001-04-01 21:15:15 +00:00
seeq8005var.h Enormous pile of changes from mark's (uncommitted) work on this driver. 2001-03-24 20:38:41 +00:00
sgec.c Nuke some unneeded splimp. 2001-04-12 03:16:56 +00:00
sgecreg.h
sgecvar.h
siop.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
siop_common.c Preliminary support for SYM53C1010-33 (at 80MB/s only for now), based on 2001-03-12 10:00:50 +00:00
siopreg.h Preliminary support for SYM53C1010-33 (at 80MB/s only for now), based on 2001-03-12 10:00:50 +00:00
siopvar.h Note that SF_CHIP_QUAD is for clock quadrupler with busy wait for PPL. 2001-03-15 17:38:59 +00:00
siopvar_common.h Fix a 4 byte ovferflow in an array: 2001-01-26 21:58:56 +00:00
smc83c170.c Fix tyop in comments. 2001-03-15 13:45:00 +00:00
smc83c170reg.h
smc83c170var.h
smc90cx6.c
smc90cx6reg.h
smc90cx6var.h
smc91cxx.c
smc91cxxreg.h
smc91cxxvar.h
smc93cx6.c
smc93cx6var.h
st16650reg.h
tcic2.c
tcic2reg.h
tcic2var.h
tms320av110.c
tms320av110reg.h
tms320av110var.h
tropic.c
tropicreg.h
tropicvar.h
tulip.c C requires that labels be followed by statements. 2001-02-24 00:01:22 +00:00
tulipreg.h
tulipvar.h make some more constant arrays 'const' 2001-02-21 21:39:52 +00:00
uha.c Add BUS_DMA_STREAMING to data transfer maps. 2001-03-07 23:07:12 +00:00
uhareg.h
uhavar.h
universereg.h
upc.c
upcreg.h
upcvar.h
vga.c constify 2001-01-18 20:28:15 +00:00
vga_subr.c
vgareg.h
vgavar.h
wdc.c Add a small delay before reset at attach time, required by one old ATAPI 2001-03-21 08:44:14 +00:00
wdc_upc.c
wdcreg.h
wdcvar.h Force certain commands (i.e. DVD authentication) to PIO mode. They are 2001-01-22 07:00:39 +00:00
we.c kill bunch of unneeded includes 2001-03-29 08:48:55 +00:00
wereg.h Split we(4) driver to bus independant and ISA-specific parts, in preparation 2001-03-23 17:34:41 +00:00
wevar.h Split we(4) driver to bus independant and ISA-specific parts, in preparation 2001-03-23 17:34:41 +00:00
z8530.doc
z8530reg.h
z8530sc.c
z8530sc.h
z8530tty.c Add some delay in zstty_attach() to wait previous console output 2001-03-12 15:46:56 +00:00

README.ncr5380sbc

NCR 53C80/53C400 driver

BACKGROUND
----------
The NCR 53C80 SCSI Bus Controller (SBC) is an early single-chip solution
which formed the basis of many early SCSI host adapters for both the
i386 and m68k platforms. The NCR 53C400 is a slightly more advanced
chip which retains backward compatability with the 53C80.

On the PC, the NCR 53C80 was most commonly used to implement simple, cheap
SCSI host adapters that were bundled with tape and CD-ROM drives. Since
these controllers were not bus-mastering (and in some cases were not even
interrupt-driven), they (like IDE adapters) required the CPU to perform
much of the actual processing. These days, these controllers are cheap
and plentiful since many are not supported by Windows 95.

Similarly, NetBSD, although it has had an MI 53C80 driver (used by the
Sun3 and Mac68k ports) for some time, has not had a i386 driver.

Until now, that is...

OVERVIEW
--------
The NCR 53C80/53C400 driver (the 'nca' device) consists of two pieces:

	1) Patches for the 53C80 MI driver to make it use bus_space()
	   functions. (This requires an optional define. By default,
	   the driver will compile in "legacy" memory-mapped mode.

	2) A machine-dependent driver (nca) containing probe and
	   attachment routines.

This driver has bene tested with the following adapters:

	NCS-250 (Chinon)	53C80, port-mapped, polled-mode
				(This is used in my primary development
				box to drive an external Zip drive.)
	Sumo SCSI-AT		53C80, port-mapped, interrupt driven
				(Note: This is an odd card in that its
				own firmware seems to have trouble detecting
				attached drives. Under NetBSD, however,
				it operates with no problems.)
	Trantor T-160		53C400, port-mapped, interrupt driven
				This card was often bundled with NEC
				CD-ROM drives. (My standalone test box
				is using this as its primary adapter.)
	DTC 3150V		53C400, memory-mapped, interrupt driven
				This a simple card designed to drive
				a CD-ROM.

CONFIGURATION
-------------
To setup the nca driver, the configuration file must contain the following:

	options	NCR5380_USE_BUS_SPACE

This line is required to add bus_space() compatability to the MI driver.

Next you need to add one or more configuration lines for the nca devices:

	nca0	at isa? port 0x360 irq 15
	nca1	at isa? iomem 0xd8000 irq 5

The first is for a port-mapped controller at 0x360, IRQ 15. The second line
is for a memory-mapped controller (Trantor T128 or equivalent) at
0xd800-0xdff, IRQ 5.

You can also set up the driver in "polled" mode (i.e., no interrupts) by
leaving off the "irq" portion of the line:

	nca0	at isa? port 0x360
	nca1	at isa? iomem 0xd8000

Lastly, you need to add a scsibus attachment line for the nca device:

	scsibus* at nca?

The following is the probe output from my test system:

	Copyright (c) 1996, 1997, 1998
	    The NetBSD Foundation, Inc.  All rights reserved.
	Copyright (c) 1982, 1986, 1989, 1991, 1993
	    The Regents of the University of California.  All rights reserved.
	
	NetBSD 1.3.2 (GENERIC) #2: Sun Oct  4 17:11:43 EDT 1998
	    root@hefalump:/usr/src/sys/arch/i386/compile/GENERIC
	cpu0: Intel 486DX (486-class)
	real mem  = 7995392
	avail mem = 5349376
	using 123 buffers containing 503808 bytes of memory
	mainbus0 (root)
	isa0 at mainbus0
	com1 at isa0 port 0x2f8-0x2ff irq 3: ns8250 or ns16450, no fifo
	com2 at isa0 port 0x3e8-0x3ef irq 5: ns8250 or ns16450, no fifo
	lpt0 at isa0 port 0x378-0x37b irq 7
	nca0 at isa0 port 0x360-0x36f irq 15
	nca0: NCR 53C400 detected
	scsibus0 at nca0: 8 targets
	sd0 at scsibus0 targ 0 lun 0: <HP, C2235, 0B11> SCSI2 0/direct fixed
	sd0: 402MB, 1574 cyl, 9 head, 58 sec, 512 bytes/sect x 825012 sectors
	cd0 at scsibus0 targ 6 lun 0: <CHINON, CD-ROM CDS-535, Q20> SCSI2 5/cdrom removable
	nca1 at isa0 iomem 0xdb878-0xdb887 irq 5
	nca1: NCR 53C400 detected
	scsibus1 at nca1: 8 targets
	sd1 at scsibus1 targ 5 lun 0: <IOMEGA, ZIP 100, J.02> SCSI2 0/direct removable
	sd1: 96MB, 96 cyl, 64 head, 32 sec, 512 bytes/sect x 196608 sectors
	npx0 at isa0 port 0xf0-0xff: using exception 16
	pc0 at isa0 port 0x60-0x6f irq 1: color
	pc0: console
	fdc0 at isa0 port 0x3f0-0x3f7 irq 6 drq 2
	fd0 at fdc0 drive 0: 1.44MB, 80 cyl, 2 head, 18 sec
	biomask 8060 netmask 8460 ttymask 84e2
	boot device: sd0
	root on sd0a dumps on sd0b
	root file system type: ffs

In this output, nca0 is a Trantor T-160 and nca1 is a DTC 3150V. Both happen
to be 53C400-based controllers.

LIMITATIONS
-----------
As of this writing, the nca driver has two known limitations:

1) No DMA or pseudo-DMA support

This is unfortunate, but may be remedied in a later release. I would welcome
any help by someone more familiar with DMA, particularly in relation to 
bus_space().

As it is, however, performance of the nca driver is acceptable, though some
of that may depend on one's definition of "acceptable". Remember that these
were not high speed controller under the best conditions, so much of it is
really the nature of the beast. It should be adequate for tapes, CD-ROMS, 
and low-usage disk devices (e.g., Zip drives). If you want to drive a CD-R
drive, then invest in an Adaptec 154X or a PCI controller.

2) No support for the SCSI port of the Pro AudioStudio 16.

This is also unfortunate and may not be able to be remedied withing the
current framework of the bus_space() functions and the nca driver.

The problem is this: In most adapters, the eight 53C80 registers are mapped
to eight sequential locations, either ports or memory addresses. On the
PAS-16, however, the registers are mapped to two sets of ports- four
sequential ports at the base address and four sequential ports located
0x2000 higher. As I currently understand it, this is not supportable by
the current bus_space() implementation nor is it possible for the driver
to allocate a second bus_space_tag and _handle itself to accomodate the
second set of ports. Without either, it is very difficult to imagine how
a portable linkage to the MI driver could be made.

Again, I welcome suggestions.

HISTORY
-------
An nca driver first appeared in FreeBSD.

This particular one borrows a little code from it and some from the i386
'esp' and sun3 'si' drivers. It, like many things in the free unix world,
was written because it solved a problem- mine! In my case, it was a need
of a SCSI card and a lack of IRQs. The good news was that I had one
(NCS-250); the bad news was that it was not supported under NetBSD. The
rest is history.

DISCLAIMER
----------
Like most things, you should take this code with a grain of salt. I have
tried to test it sufficiently, but it is always possible that it is not
compatible with some aspect of your system. If you end up suffering
massive data loss and destruction, you have my sympathies, but I do not
and will not allow myself to be held responsible.

CREDITS
-------
My thanks to Jason Thorpe and the rest of the NetBSD team for making it
so easy to write this driver. My thanks also to the authors of the
FreeBSD nca driver for inspiration and 53C400 support.

In the end, I hope that someone else can find this driver as useful as I
have. If so, please drop me a line at jruschme@exit109.com and let me 
know about it.

Share and enjoy

John Ruschmeyer (jruschme@exit109.com)
11 October 1998