path: root/i386/README-Drivers

-*- text -*-

** Turning on or off device drivers

Each device driver has an associated configure switch.  The table at the
end of this file indicates whether a device driver is enabled by default
or not.  It also gives --- if possible at all --- the configure switches
to use for disabling or enabling device drivers, in case you're not
satisfied with the default choices.  Where a `--disable-*' switch is
given in the table, the device driver is enabled by default and you have
to use the switch to disable it and vice versa for the `--enable-*'
switches, the device driver is disabled by default and you have to us the
switch to enable it.  To have all device drivers disabled that can be
disabled and would otherwise have been enabled by default you can specify
the `--disable-default-device-drivers' switch and then use the
`--enable-*' switches to enable only those you actually want to have
enabled.


** What the configure switches do

Each configure switch has two effects.  First, it defines a CPP symbol
that turns on or off the hooks that autoconfigure the device and add
it to the list of available devices.  Second, it adds the source code
for the driver to a make variable so that the code for the driver is
compiled and linked into the kernel.


** What are those extra numbers

Each driver is followed by one or more triplets of three numbers.
These triplets specify combinations of I/O address, spl, and, pic that
are believed to work. 


** Then comes the name of the device to users.  %d is a unit number.


** Source files

All source file names are relative to [GNU Mach]/i386/i386at/ for
Mach drivers, and the Linux drivers's files can be found below
[GNU Mach]/linux/.


** Table

*** Serial devices and similar equivalents

PC com ports (always enabled)
	0x3f8,2f8,3e8
	com%d

Parallel port
  --disable-lpr				lpr.c
	lpr%d

System Console (always enabled)
	(indirect name for kd or first com line)
	console

PC keyboard/display (always enabled)
	kd


*** Special devices

Mappable time device (always enabled)
	time

Mouse interface to PC (always enabled)
	(Piggy backs horribly on COM devices)
	mouse%d

X Window System interface to keyboard (always enabled)
	kbd%d

Interface to setting up IO port access for users (always enabled)
	iopl%d


*** Disk controllers (except for SCSI)

PC floppy
  --disable-floppy		block/floppy.c
	0x3f0, 370
	fd%d

IDE disks
  --disable-ide			block/{cmd640,ide-cd,ide,rz1000,triton}.c
	hd%d	(disks)
	wcd%d	(cdroms)


*** SCSI disks

Disks all show up as `sd%d'.  CD Roms all show up as `cd%d'.  Tapes and
generic are not currently supported.

AdvanSys
  --disable-advansys		scsi/advansys.c

BusLogic
  --disable-BusLogic		scsi/{BusLogic,FlashPoint}.c
  --enable-flashpoint (if you want to omit FlashPoint support)

UltraStor 14F/34F
  --disable-u14-34f		scsi/u14-34f.c

UlstraStor
  --disable-ultrastor		scsi/ultrastor.c

Adaptec AHA-152x/2825 (aha152x, aha2825)
  --disable-aha152x		scsi/aha152x.c

Adaptec AHA-1542
  --disable-aha1542		scsi/aha1540.c

Adaptec AHA-1740
  --disable-aha1740		scsi/aha1740.c

Adaptec AIC7xxx
  --disable-aic7xxx		scsi/aic7xxx.c

Future Domain 16xx
  --disable-fdomain		scsi/fdomain.c

Always IN 2000
  --disable-in2000		scsi/in2000.c

Generic NCR5380/53c400 (ncr5380, ncr53c400)
  --enable-g_NCR5380		scsi/g_NCR5380.c

NCR53c406a chip
  --enable-NCR53c406a		scsi/NCR53c406a.c

PAS16
  --disable-pas16		scsi/pas16.c

Seagate ST02, Future Domain TMC-8xx
  --disable-seagate		scsi/seagate.c

Trantor T128/T128F/T228 (t128, t128f, t228)
  --disable-t128		scsi/t128.c

NCR 53C7,8xx
  --disable-ncr53c78xx		scsi/53c78xx.c

EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix)
  --enable-eata_dma		scsi/eata_dma.c

EATA-PIO (old DPT PM2001, PM2012A)
  --disable-eata_pio		scsi/eata_pio.c

WD 7000
  --disable-wd7000		scsi/wd7000.c

EATA ISA/EISA/PCI (DPT and generic EATA/DMA-compliant boards)
  --disable-eata		scsi/eata.c

AM53/79C974 (am53c974, am79c974)
  --disable-AM53C974		scsi/AM53C974.c

DTC3180/3280 (dtc3180, dtc3280)
  --disable-dtc	       		scsi/dtc.c

NCR53C8XX (ncr53c8xx, dc390f, dc390u, dc390w)
  --disable-ncr53c8xx		scsi/ncr53c8xx.c

Tekram DC-390(T) (dc390, dc390t)
  --disable-tmscsim		scsi/tmscsim.c

IOMEGA Parallel Port ZIP drive
  --disable-ppa			scsi/ppa.c

Qlogic FAS
  --disable-qlogicfas		scsi/qlogicfas.c

Qlogic ISP
  --disable-qlogicisp		scsi/qlogicisp.c

GDT SCSI Disk Array Controller
  --disable-gdth		scsi/gdth.c


*** Ethernet controllers
These all show up as `eth%d' except the atp device.

NE2000/NE1000 ISA (ne, ne1000, ne2000)
  --disable-ne				net/ne.c net/8390.c
	0x300,280,320,340,360

3Com 503 (3c503) / Etherlink II
  --disable-3c503			net/3c503.c net/8390.c
	0x300,310,330,350,250,280,2a0,2e0

3Com 509/579 (3c509, 3c579) / Etherlink III
  --disable-3c509			net/3c509.c 

WD80x3
  --disable-wd				net/wd.c, net/8390.c
	0x300,280,380,240

3COM 501 (3c501) / Etherlink I
  --disable-3c501			net/3c501.c
	0x280,300

SMC Ultra
  --disable-smc-ultra			net/smc-ultra.c net/8390.c
	0x200,220,240,280,300,340,380

SMC Ultra32
  --disable-smc-ultra32			net/smc-ultra32.c net/8390.c

HP PCLAN+ (27247B and 27252A)
  --disable-hp-plus			net/hp-plus.c net/8390.c
	0x200,240,280,2c0,300,320,340

HP PCLAN (27245 and other 27xxx series)
  --disable-hp	 			net/hp.c, net/8390.c
	0x300,320,340,280,2c0,200,240

3Com 59x/90x (3c59x, 3c590, 3c592, 3c595, 3c597, 3c90x, 3c900, 3c905) "Vortex/Boomerang"
  --disable-3c59x			net/3c59x.c

Seeq8005
  --disable-seeq8005			net/seeq8005.c
	0x300,320,340,360

HP 10/100VG PCLAN (ISA, EISA, PCI) (hp100, hpj2577, hpj2573, hpj2585, hp27248b)
  --disable-hp100			net/hp100.c

Ansel Communications EISA 3200
  --disable-ac3200			net/ac3200.c, net/8390.c

Cabletron E21xx
  --disable-e2100			net/e2100.c, net/8390.c
	0x300,280,380,220

AT1700 (Fujitsu 86965)
  --disable-at1700			net/at1700.c
	0x260,280,2a0,240,340,320,380,300

ICL EtherTeam 16i/32 (eth16i, eth32)
  --disable-eth16i			net/eth16i.c 
	0x260,280,2a0,240,340,320,380,300 (16i)

Zenith Z-Note (znet, znote)
  --disable-znet			net/znet.c

EtherExpress 16
  --disable-eexpress			net/eexpress.c
	0x300,270,320,340

EtherExpressPro
  --disable-eepro			net/eepro.c
	0x200,240,280,2c0,300,320,340,360

Intel EtherExpressPro PCI 10+/100B/100+
  --disable-eepro100			net/eepro100.c

DEPCA (de100, de101, de200, de201, de202, de210, de422)
  --disable-depca			net/depca.c

EtherWORKS 3 (ewrk3, de203, de204, de205)
  --disable-ewrk3			net/ewrk3.c

DE4x5 (de4x5, de425, de434, de435, de450, de500)
  --disable-de4x5			net/de4x5.c

Apricot XEN-II on board ethernet
  --disable-apricot			net/apricot.c

AT&T WaveLAN & DEC RoamAbout DS
  --enable-wavelan			net/wavelan.c
	0x390

3Com 507 (3c507, el16)
  --disable-3c507			net/3c507.c
	0x300,320,340,280

3Com 505 (3c505, elplus)
  --disable-3c505			net/3c505.c
	0x300,280,310

D-Link DE-600
  --disable-de600			net/de600.c
	0x378

D-Link DE-620
  --disable-de620			net/de620.c
	0x378

Schneider & Koch G16
  --disable-sk_g16			net/sk_g16.c
	0x100,180,208,220,288,320,328,390

NI5210
  --disable-ni52			net/ni52.c
	0x300,280,360,320,340

NI6510
  --disable-ni65			net/ni65.c
	0x300/320/340/360

AT-LAN-TEC/RealTek pocket adaptor
  --enable-atp				net/atp.c
	0x378,278,3bc
	atp%d

AMD LANCE and PCnet (at1500, ne2100)
  --disable-lance			net/lance.c

DECchip Tulip (dc21x4x) PCI (elcp, tulip)
  --disable-tulip			net/tulip.c

FMV-181/182/183/184
  --disable-fmv18x			net/fmv18x.c

3Com 515 ISA Fast EtherLink
  --disable-3c515			net/3c515.c

AMD PCI PCnet32 (PCI bus NE2100 cards)
  --disable-pcnet32			net/pcnet32.c

PCI NE2000
  --disable-ne2k-pci			net/ne2k-pci.c

Packet Engines Yellowfin Gigabit-NIC
  --disable-yellowfin			net/yellowfin.c

RealTek 8129/8139 (rtl8129, rtl8139) (not 8019/8029!)
  --disable-rtl8139			net/rtl8139.c

SMC 83c170/175 EPIC/100 (epic, epic100) / EtherPower II
  --disable-epic100			net/epic100.c

TI ThunderLAN
  --disable-tlan			net/tlan.c

VIA Rhine
  --disable-via-rhine			net/via-rhine.c

Packet Engines "Hamachi" GNIC-2 Gigabit Ethernet
  --disable-hamachi			net/hamachi.c

Intel PCI Gigabit Ethernet
  --disable-intel-gige			net/intel-gige.c

Myson MTD803 Ethernet adapter series
  --disable-myson803			net/myson803.c

National Semiconductor DP8381x series PCI Ethernet
  --disable-natsemi			net/natsemi.c

National Semiconductor DP8382x series PCI Ethernet
  --disable-ns820			net/ns820.c

Adaptec Starfire network adapter
  --disable-starfire			net/starfire.c

Sundance ST201 "Alta" PCI Ethernet
  --disable-sundance			net/sundance.c

Winbond W89c840 PCI Ethernet
  --disable-winbond-840			net/winbond-840.c

*** pcmcia bridge drivers

All source files are relative to [GNU Mach]/linux/pcmcia-cs.

Intel 82365 PC Card controller
  --disable-i82365			modules/i82365.c

Disable scan for ISA interrupts at startup
  --disable-pcmcia-isa

*** pcmcia device drivers

These all show up as `eth%d'.

All source files are relative to [GNU Mach]/linux/pcmcia-cs.

3Com 3c574 ``RoadRunner'' PCMCIA Ethernet
  --disable-3c574_cs			clients/3c574_cs.c

3Com 3c589 PCMCIA Ethernet card
  --disable-3c589_cs			clients/3c589_cs.c

Asix AX88190-based PCMCIA Ethernet adapters
  --disable-axnet_cs			clients/axnet_cs.c

fmvj18x chipset based PCMCIA Ethernet cards
  --disable-fmvj18x_cs			clients/fmvj18x_cs.c

New Media Ethernet LAN PCMCIA cards
  --disable-nmclan_cs			clients/nmclan_cs.c

NS8390-based PCMCIA cards
  --disable-pcnet_cs			clients/pcnet_cs.c

SMC91c92-based PCMCIA cards
  --disable-smc91c92_cs			clients/smc91c92_cs.c

Xircom CreditCard and Realport PCMCIA ethernet
  --disable-xirc2ps_cs			clients/xirc2ps_cs.c

Hermes or Prism 2 PCMCIA Wireless adapters (Orinoco)
  --disable-orinoco_cs			wireless/orinoco_cs.c