NetBSD/sys/dev/ic
mjacob 219d22404b Major restructuring for swizzling to the request queue and unswizzling from
the response queue. Instead of the ad hoc ISP_SWIZZLE_REQUEST, we now have
a complete set of inline functions in isp_inline.h. Each platform is
responsible for providing just one of a set of ISP_IOX_{GET,PUT}{8,16,32}
macros.

The reason this needs to be done is that we need to have a single set of
functions that will work correctly on multiple architectures for both little
and big endian machines. It also needs to work correctly in the case that
we have the request or response queues in memory that has to be treated
specially (e.g., have ddi_dma_sync called on it for Solaris after we update
it or before we read from it).

One thing that falls out of this is that we no longer build requests in the
request queue itself. Instead, we build the request locally (e.g., on the
stack) and then as part of the swizzling operation, copy it to the request
queue entry we've allocated. I thought long and hard about whether this was
too expensive a change to make as it in a lot of cases requires an extra
copy. On balance, the flexbility is worth it. With any luck, the entry that
we build locally stays in a processor writeback cache (after all, it's only
64 bytes) so that the cost of actually flushing it to the memory area that is
the shared queue with the PCI device is not all that expensive. We may examine
this again and try to get clever in the future to try and avoid copies.

Another change that falls out of this is that MEMORYBARRIER should be taken
a lot more seriously. The macro ISP_ADD_REQUEST does a MEMORYBARRIER on the
entry being added. But there had been many other places this had been missing.
It's now very important that it be done.

For NetBSD, it does a ddi_dmamap_sync as appropriate. This gets us out of
the explicit ddi_dmamap_sync on the whole response queue that we did for SBus
cards at each interrupt.

Set things up so that platforms that cannot have an SBus don't get a lot of
the SBus code checks (dead coded out).

Additional changes:

Fix a longstanding buglet of sorts. When we get an entry via isp_getrqentry,
the iptr value that gets returned is the value we intend to eventually plug
into the ISP registers as the entry *one past* the last one we've written-
*not* the current entry we're updating. All along we've been calling sync
functions on the wrong index value. Argh. The 'fix' here is to rename all
'iptr' variables as 'nxti' to remember that this is the 'next' pointer-
not the current pointer.

Devote a single bit to mboxbsy- and set aside bits for output mbox registers
that we need to pick up- we can have at least one command which does not
have any defined output registers (MBOX_EXECUTE_FIRMWARE).

Explicitly decode GetAllNext SNS Response back *as* a GetAllNext response.
Otherwise, we won't unswizzle it correctly.

Nuke some additional __P macros.
2001-12-14 00:13:44 +00:00
..
ac97.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ac97reg.h
ac97var.h
ad1848.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ad1848reg.h
ad1848var.h AD1845 on my AlphaStation 255 doesn't match the AD1845 doc. 2001-11-04 08:08:25 +00:00
adv.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
adv.h
advlib.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
advlib.h
advmcode.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
advmcode.h
adw.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
adw.h
adwlib.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
adwlib.h
adwmcode.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
adwmcode.h Ensure that data accessed by the ADW driver in memory is in 2001-08-29 17:25:03 +00:00
aha.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
ahareg.h
ahavar.h
aic7xxx_seeprom.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
aic7xxx.c use #ifdef DDB (for consistency with the rest of the kernel) 2001-11-28 05:45:27 +00:00
aic7xxxvar.h
aic77xx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
aic77xxreg.h
aic77xxvar.h
aic6360.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
aic6360reg.h
aic6360var.h
aic6915.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
aic6915reg.h
aic6915var.h
am79c930.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
am79c930reg.h
am79c930var.h
am7930.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
am7930reg.h
am7930var.h
am7990.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
am7990reg.h
am7990var.h
am9513reg.h
am79900.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
am79900reg.h Oops, TMD/RMD byte count masks were one bit shy (and it makes a big 2001-08-24 00:16:25 +00:00
am79900var.h
an.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
anreg.h
anvar.h
apcdmareg.h
ate_subr.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ate_subr.h
awi.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
awireg.h Move IEEE 802.11 MAC management functions from awi driver to 2001-09-18 09:09:57 +00:00
awivar.h Fix for FH infrastructure mode. 2001-09-19 04:09:54 +00:00
ax88190.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ax88190reg.h MII access routines for ASIX AX88190. 2001-08-04 11:38:57 +00:00
ax88190var.h MII access routines for ASIX AX88190. 2001-08-04 11:38:57 +00:00
bha.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
bhareg.h
bhavar.h
bt8xx.h
bt431reg.h
bt459reg.h
bt463.c Update the ramdac interface to be allow the setting of dotclocks. This is 2001-12-12 07:47:46 +00:00
bt463reg.h
bt463var.h
bt485.c Update the ramdac interface to be allow the setting of dotclocks. This is 2001-12-12 07:47:46 +00:00
bt485reg.h
bt485var.h
cac.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
cacreg.h
cacvar.h
cd18xx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
cd18xxreg.h add a backend serial driver for the cirrus logic CL-CD180/1864/1865 2001-10-03 04:25:29 +00:00
cd18xxvar.h add a backend serial driver for the cirrus logic CL-CD180/1864/1865 2001-10-03 04:25:29 +00:00
cd1190reg.h
cd1400reg.h
clmpcc.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
clmpccreg.h
clmpccvar.h
com_upc.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
com.c - pull in opt_kgdb.h where necessary 2001-11-20 08:43:19 +00:00
comreg.h
comvar.h For hayes esp card, set prescaler if specified rate is grater than 115200. 2001-08-27 14:27:01 +00:00
cs89x0.c don't allocate a mbuf cluster if we don't need. 2001-11-27 21:40:55 +00:00
cs89x0reg.h move dev/isa/cs89x0{.c,{var,reg}.h} into dev/ic 2001-11-26 19:17:05 +00:00
cs89x0var.h move dev/isa/cs89x0{.c,{var,reg}.h} into dev/ic 2001-11-26 19:17:05 +00:00
cs4231.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
cs4231reg.h
cs4231var.h
cs4237reg.h
cy.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
cyreg.h
cyvar.h
daic.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
daicreg.h
daicvar.h
dc21040reg.h
decmonitors.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
depca.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
depcareg.h
depcavar.h
dl10019.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
dl10019reg.h
dl10019var.h
dp8390.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
dp8390reg.h
dp8390var.h
dp83932.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
dp83932reg.h
dp83932var.h
dpt.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
dptreg.h
dptvar.h
ds1286reg.h
ds.h
elink3.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
elink3reg.h merge duplicate register definitions. 2001-11-11 00:24:16 +00:00
elink3var.h
elinkxl.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
elinkxlreg.h ELINK_W4_UBYTESOK is 0x0d. This is probably why kim is getting x2 numbers 2001-11-28 23:46:42 +00:00
elinkxlvar.h Prevent hang-up when a CardBus card is removed during the card is working. 2001-10-25 10:02:12 +00:00
gem.c Back out the last two changes I made to this driver -- some people 2001-11-17 00:56:04 +00:00
gemreg.h Manipulate the Tx desc pointer as 2 32-bit values, just as 2001-10-18 03:33:33 +00:00
gemvar.h Yet more cruft removal. 2001-10-18 15:19:21 +00:00
hayespreg.h Add prescaler bit constant (missed in previous commit). 2001-09-04 01:33:14 +00:00
hd64570.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
hd64570reg.h
hd64570var.h
hme.c Back out new "hme" driver because it causes a performance regression on 2001-11-26 10:39:29 +00:00
hmereg.h Back out new "hme" driver because it causes a performance regression on 2001-11-26 10:39:29 +00:00
hmevar.h Back out new "hme" driver because it causes a performance regression on 2001-11-26 10:39:29 +00:00
hscx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
hscx.h
i8042reg.h
i8237reg.h
i8253reg.h
i8259reg.h
i82365.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
i82365reg.h
i82365var.h
i82557.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
i82557reg.h
i82557var.h
i82586.c Added macros for the bits in the SYSBUS byte, and macros 2001-11-26 23:30:59 +00:00
i82586reg.h Added macros for the bits in the SYSBUS byte, and macros 2001-11-26 23:30:59 +00:00
i82586var.h
i82595reg.h
ibm561.c Initial support for the IBM RGB561 RAMDAC. This uses the same interface 2001-12-12 07:46:48 +00:00
ibm561reg.h Initial support for the IBM RGB561 RAMDAC. This uses the same interface 2001-12-12 07:46:48 +00:00
ibm561var.h Initial support for the IBM RGB561 RAMDAC. This uses the same interface 2001-12-12 07:46:48 +00:00
ics2101reg.h
iha.c - Use MI ADAPTER_REQ_SET_XFER_MODE callback. 2001-11-18 14:33:10 +00:00
ihareg.h - make sure to call bus_dmamap_unload() even after request sense 2001-11-17 21:26:12 +00:00
ihavar.h - make sure to call bus_dmamap_unload() even after request sense 2001-11-17 21:26:12 +00:00
ims332reg.h
intersil7170.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
intersil7170.h
interwave.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
interwavereg.h
interwavevar.h
ipac.h
isac.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
isac.h
isic_bchan.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
isic_l1.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
isic_l1.h
isic_l1fsm.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
isic.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
isp_inline.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp_ioctl.h
isp_netbsd.c Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp_netbsd.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp_target.c Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp_target.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp_tpublic.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
isp.c Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
ispmbox.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
ispreg.h Add support for 2 Gigabit cards (2300/2312). This necessitated a change 2001-09-01 07:12:23 +00:00
ispvar.h Major restructuring for swizzling to the request queue and unswizzling from 2001-12-14 00:13:44 +00:00
lance.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
lancereg.h Give initiali[sz]e all the "i"s it deserves. 2001-09-18 18:15:49 +00:00
lancevar.h
ld_cac.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ld_mlx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
lemac.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
lemacreg.h
lemacvar.h
lpt_upc.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
lpt.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
lptreg.h
lptvar.h
lsi64854.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
lsi64854reg.h
lsi64854var.h
Makefile
mb86960.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
mb86960reg.h
mb86960var.h
mb89352.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
mb89352reg.h
mb89352var.h
mc6845reg.h
mc6854reg.h Driver for the standard Archimedes Econet interface, based around the 2001-09-10 23:41:48 +00:00
mc68450reg.h
mc146818reg.h
midway.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
midwayreg.h
midwayvar.h
mk48txx.c Recognize the MK48T18 as well (differs from the MK48T08 only in packaging 2001-12-06 18:54:23 +00:00
mk48txxreg.h Recognize the MK48T18 as well (differs from the MK48T08 only in packaging 2001-12-06 18:54:23 +00:00
mlx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
mlxio.h
mlxreg.h
mlxvar.h Give initiali[sz]e all the "i"s it deserves. 2001-09-18 18:15:49 +00:00
mm58167.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
mm58167var.h
monitors.h
mpc105reg.h Add (some) register definitions for the Motorola MPC105 PCI Bridge/Memory 2001-12-10 12:09:33 +00:00
mpu.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
mpuvar.h
msm6258.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
msm6258var.h
ncr53c9x.c add NCR_VARIANT_NCR53C90_86C01 "NCR53C90 (86C01)" 2001-12-03 23:27:31 +00:00
ncr53c9xreg.h "than" instead of "then". 2001-11-21 19:14:19 +00:00
ncr53c9xvar.h add NCR_VARIANT_NCR53C90_86C01 "NCR53C90 (86C01)" 2001-12-03 23:27:31 +00:00
ncr53c400reg.h
ncr5380.doc "wierd" is weird. 2001-08-20 12:20:01 +00:00
ncr5380reg.h
ncr5380sbc.c Use bus_space on sun2. 2001-11-26 20:15:48 +00:00
ncr5380var.h Use bus_space on sun2. 2001-11-26 20:15:48 +00:00
ne2000.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
ne2000reg.h MII access routines for ASIX AX88190. 2001-08-04 11:38:57 +00:00
ne2000var.h
nec765reg.h
ns8477reg.h
ns16450reg.h
ns16550reg.h
nslm7x.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
nslm7xvar.h
opl3sa3reg.h
opl.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
oplinstrs.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
oplreg.h
oplvar.h Introduce "flags 1", which causes left and right channels swapped. 2001-11-04 06:44:31 +00:00
osiop.c - Use MI ADAPTER_REQ_SET_XFER_MODE callback 2001-11-18 14:50:11 +00:00
osiopreg.h
osiopvar.h - Use MI ADAPTER_REQ_SET_XFER_MODE callback 2001-11-18 14:50:11 +00:00
pcdisplay_chars.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
pcdisplay_subr.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
pcdisplay.h
pcdisplayvar.h
pckbc.c Small change to Christos' fix: allow malloc() to return NULL, but complain 2001-12-06 20:00:58 +00:00
pckbcvar.h
pdq_ifsubr.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
pdq.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
pdqreg.h
pdqvar.h
ramdac.h Update the ramdac interface to be allow the setting of dotclocks. This is 2001-12-12 07:47:46 +00:00
README.ncr5380sbc
rrunner.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
rrunnerreg.h
rrunnervar.h
rtl80x9.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
rtl80x9reg.h
rtl80x9var.h
rtl81x9.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
rtl81x9reg.h
rtl81x9var.h
seeq8003reg.h
seeq8005.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
seeq8005reg.h
seeq8005var.h Add support for feeding entropy to rnd(4). 2001-11-07 20:01:58 +00:00
sgec.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
sgecreg.h
sgecvar.h
siop_common.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
siop.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
siopreg.h
siopvar_common.h Forgot to add __attribute__((__packed__)) to one hardware structure. 2001-10-22 16:45:28 +00:00
siopvar.h
smc83c170.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
smc83c170reg.h Spell 'occurred' with two 'r's. 2001-09-16 16:34:23 +00:00
smc83c170var.h
smc90cx6.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
smc90cx6reg.h
smc90cx6var.h
smc91cxx.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
smc91cxxreg.h
smc91cxxvar.h
smc93cx6.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
smc93cx6var.h
st16650reg.h
sunscpal.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
sunscpalreg.h
sunscpalvar.h
tcic2.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
tcic2reg.h
tcic2var.h
tms320av110.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
tms320av110reg.h
tms320av110var.h
tropic.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
tropicreg.h
tropicvar.h
tulip.c use little-endian crc on multicast hash for admtek chips. 2001-11-22 05:03:04 +00:00
tulipreg.h
tulipvar.h
uha.c don't need <sys/types.h> when including <sys/param.h> 2001-11-15 09:47:59 +00:00
uhareg.h
uhavar.h
universereg.h
upc.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
upcreg.h
upcvar.h
vga_subr.c ANSIfy. 2001-12-13 08:34:55 +00:00
vga.c ANSIfication & cosmetic changes. 2001-12-13 08:31:39 +00:00
vgareg.h
vgavar.h ANSIfication & cosmetic changes. 2001-12-13 08:35:38 +00:00
wdc_upc.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
wdc.c Compile with NWD == 0. Fixe kern/14844 by hamajima@nagoya.ydc.co.jp. 2001-12-05 20:43:00 +00:00
wdcreg.h
wdcvar.h Allow wd to attach to something else than wdc/pciide (like USB<->ATA bridges): 2001-12-03 00:11:15 +00:00
we.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
wereg.h
wevar.h
wi_ieee.h Oops, missed one. 2001-11-11 00:34:52 +00:00
wi.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
wireg.h Get rid of duplicate RID definitions. 2001-11-11 00:16:07 +00:00
wivar.h Add Intersil Prism2.5 Mini-PCI wavelan. 2001-10-13 15:00:23 +00:00
z8530.doc
z8530reg.h
z8530sc.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00
z8530sc.h
z8530tty.c add/cleanup RCSID 2001-11-13 13:14:31 +00:00

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 compatibility 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() compatibility 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