3 0. Document Conventions
4 1. Default Configuration (GENERIC kernel)
5 2. LINT - other possible configurations
8 See TROUBLE.TXT for Q&A on known hardware problems.
10 =========================================================================
12 0. Document Conventions
13 -- --------------------
15 We have `underlined' text which represents user input with `-' symbols
16 throughout this document to differentiate it from the machine output.
18 1. Default (GENERIC) Configuration
19 -- -------------------------------
21 The following table contains a list of all of the devices that are
22 present in the GENERIC kernel. This is the essential part of the
23 operating system that is placed in your root partition during the
24 installation process. A compressed version of the GENERIC kernel is
25 also used on the installation floppy diskette and DOS boot image.
27 The table describes the various parameters used by the driver to
28 communicate with the hardware in your system. There are four
29 parameters in the table, though not all are used by each and every
32 Port The starting I/O port used by the device, shown in hexadecimal.
34 IOMem The lowest (or starting) memory address used by the device,
35 also shown in hexadecimal.
37 IRQ The interrupt the device uses to alert the driver to an event,
40 DRQ The DMA (direct memory access) channel the device uses to move
41 data to and from main memory, also given in decimal.
43 If an entry in the table has `n/a' for a value then it means that the
44 parameter in question does not apply to that device. A value of `dyn'
45 means that the correct value should be determined automatically by the
46 kernel when the system boots and that you don't need to worry about
49 If an entry is marked with an *, it means that support is currently
50 not available for it but should be back as soon as someone converts
51 the driver to work within the new 3.0 framework.
53 FreeBSD GENERIC kernel:
55 Port IRQ DRQ IOMem Description
56 ---- --- --- ----- ---------------------------------
57 fdc0 3f0 6 2 n/a Floppy disk controller
58 wdc0 1f0 14 n/a n/a IDE/MFM/RLL disk controller
59 wdc1 170 15 n/a n/a IDE/MFM/RLL disk controller
61 adv0 n/a n/a n/a n/a AdvanSys Narrow SCSI controllers
62 adw0 n/a n/a n/a n/a AdvanSys Wide SCSI controllers
63 ncr0 n/a n/a n/a n/a NCR PCI SCSI controller
64 bt0 330 dyn dyn dyn Buslogic SCSI controller
65 uha0* 330 dyn 6 dyn Ultrastore 14f
66 aha0 330 dyn 5 dyn Adaptec 154x/1535 SCSI controller
67 ahb0 dyn dyn dyn dyn Adaptec 174x SCSI controller
68 ahc0 dyn dyn dyn dyn Adaptec 274x/284x/294x SCSI controller
69 aic0* 340 11 dyn dyn Adaptec 152x/AIC-6360 SCSI
71 isp0 dyn dyn dyn dyn QLogic 10X0, 2100 SCSI/FC controllers
72 dpt n/a n/a n/a n/a DPT RAID SCSI controllers.
74 wt0 300 5 1 dyn Wangtek and Archive QIC-02/QIC-36
76 psm0 60 12 n/a n/a PS/2 Mouse
78 mcd0 300 10 n/a n/a Mitsumi CD-ROM
79 matcd0 230 n/a n/a n/a Matsushita/Panasonic CD-ROM
80 scd0 230 n/a n/a n/a Sony CD-ROM
82 sio0 3f8 4 n/a n/a Serial Port 0 (COM1)
83 sio1 2f8 3 n/a n/a Serial Port 1 (COM2)
85 lpt0 dyn 7 n/a n/a Printer Port 0
86 lpt1 dyn dyn n/a n/a Printer Port 1
88 al0 dyn dyn n/a dyn ADMtek AL981/AN985 PCI based cards
89 ax0 dyn dyn n/a dyn ASIX AX88140A PCI based cards
90 de0 n/a n/a n/a n/a DEC DC21x40 PCI based cards
91 (including 21140 100bT cards)
92 dm0 n/a n/a n/a n/a Davicom DM9100/DM9102 PCI based cards
93 ed0 280 10 dyn d8000 WD & SMC 80xx; Novell NE1000 &
94 NE2000; 3Com 3C503; HP PC Lan+
95 eg0 310 5 dyn dyn 3Com 3C505
96 ep0 300 10 dyn dyn 3Com 3C509
97 ex0 dyn dyn dyn n/a Intel EtherExpress Pro/10 cards
98 fe0 300 dyn n/a n/a Allied-Telesyn AT1700, RE2000 and
99 Fujitsu FMV-180 series cards.
100 fxp0 dyn dyn n/a dyn Intel EtherExpress Pro/100B
101 ie0 300 10 dyn d0000 AT&T StarLAN 10 and EN100;
103 Intel EtherExpress (8/16,16[TP]) cards
104 le0 300 5 dyn d0000 Digital Equipment EtherWorks
106 lnc0 280 10 n/a dyn Lance/PCnet cards
107 (Isolan, Novell NE2100, NE32-VL,
108 some PCnet-PCI cards)
109 mx0 dyn dyn n/a dyn Macronix 98713/15/25 PCI based cards
110 pn0 dyn dyn n/a dyn Lite-On PNIC PCI based cards
111 rl0 dyn dyn n/a dyn RealTek 8129/8139 fast ethernet
112 sf0 dyn dyn n/a dyn Adaptec AIC-6915 fast ethernet
113 sis0 dyn dyn n/a dyn SiS 900/SiS 7016 fast ethernet
114 ste0 dyn dyn n/a dyn Sundance ST201 fast ethernet
115 tl0 dyn dyn n/a dyn TI TNET100 'ThunderLAN' cards.
116 wb0 dyn dyn n/a dyn Winbond W89C840F PCI based cards.
117 vr0 dyn dyn n/a dyn VIA VT3043/VT86C100A PCI based cards.
118 vx0 dyn dyn n/a dyn 3Com 3c59x ((Fast) Etherlink III)
119 xl0 dyn dyn n/a dyn 3Com 3c900, 3c905, 3c905B, 3c905C,
120 3c980, 3cSOHO100 ((Fast) Etherlink XL)
121 cs0 0x300 dyn n/a n/a Crystal Semiconductor CS89x0-based
123 ze0 300 5 n/a d8000 IBM/National Semiconductor
124 PCMCIA Ethernet Controller
125 zp0 300 10 n/a d8000 3Com 3c589 Etherlink III
126 PCMCIA Ethernet Controller
130 If the hardware in your computer is not set to the same settings as
131 those shown in the table and the item in conflict is not marked 'dyn',
132 you will have to either reconfigure your hardware or use UserConfig
133 to reconfigure the kernel to match the way your hardware is currently set
134 (see the next section).
136 If the settings do not match, the kernel may be unable to locate
137 or reliably access the devices in your system.
140 2. LINT - other possible configurations
141 -- ------------------------------------
143 The following drivers are not in the GENERIC kernel but remain
144 available to those who do not mind compiling a custom kernel (see
145 section 6 of FreeBSD.FAQ). The LINT configuration file
146 (/sys/i386/conf/LINT) also contains prototype entries for just about
147 every device supported by FreeBSD and is a good general reference.
149 The device names and a short description of each are listed below. The port
150 numbers, etc, are not meaningful here since you will need to compile a
151 custom kernel to gain access to these devices anyway and can thus
152 adjust the addresses to match the hardware in your computer in the process.
153 The LINT file contains prototype entries for all of the below which you
154 can easily cut-and-paste into your own file (or simply copy LINT and edit
157 ctx: Cortex-I frame grabber
158 cx: Cronyx/Sigma multiport sync/async
159 cy: Cyclades high-speed serial driver
161 fea: DEC DEFEA EISA FDDI adapter
162 fpa: DEC DEFPA PCI FDDI adapter
163 gp: National Instruments AT-GPIB and AT-GPIB/TNT board
164 gsc: Genius GS-4500 hand scanner
165 gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
166 gusxvi: Gravis Ultrasound 16-bit PCM
167 hea: Efficient ENI-155p ATM PCI adapter
168 hfa: FORE PCA-200E ATM PCI adapter
169 isic: isdn4bsd Siemens ISDN Chipset driver
171 labpc: National Instrument's Lab-PC and Lab-PC+
172 meteor: Matrox Meteor frame-grabber card
173 bktr: Brooktree Bt848 / Bt 878 based frame-grabber cards.
174 mpu: Roland MPU-401 stand-alone card
175 mse: Microsoft, Logitech, ATI bus mouse ports
176 mss: Microsoft Sound System
177 opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
178 pas: ProAudioSpectrum PCM and MIDI
179 pca: PCM audio ("/dev/audio") through your PC speaker
180 pcm: PCM audio on most modern ISA audio codecs
182 rc: RISCom/8 multiport card
183 sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
184 sbmidi: SoundBlaster 16 MIDI interface
185 sbxvi: SoundBlaster 16
186 si: Specialix SI/XIO/SX (old and enhanced ISA, PCI, EISA) serial
187 spigot: Creative Labs Video Spigot video-acquisition board
188 uart: Stand-alone 6850 UART for MIDI
189 wds: Western Digital WD7000 IDE
194 3. Supported Hardware
195 -- ------------------
197 FreeBSD currently runs on a wide variety of ISA and PCI bus based
198 Alphas's. Support for generic IDE or ESDI drive configurations is
199 somewhat marginal and a SCSI controller is therefore recommended.
201 What follows is a list of all peripherals currently known to work with
202 FreeBSD. Other configurations may also work, we have simply not as yet
203 received confirmation of this.
206 4.1. Disk Controllers
207 ---- ----------------
209 WD1003 (any generic MFM/RLL)
210 WD1007 (any generic IDE/ESDI)
214 Adaptec 1535 ISA SCSI controllers
215 Adaptec 154x series ISA SCSI controllers
216 Adaptec 174x series EISA SCSI controller in standard and enhanced mode.
217 Adaptec 274X/284X/2920C/294x/2950/3940/3950 (Narrow/Wide/Twin) series
218 EISA/VLB/PCI SCSI controllers.
219 Adaptec AIC7850, AIC7860, AIC7880, AIC789x, on-board SCSI controllers.
221 AdvanSys SCSI controllers (all models).
223 BusLogic MultiMaster controllers:
225 [ Please note that BusLogic/Mylex "Flashpoint" adapters are NOT yet supported ]
227 BusLogic MultiMaster "W" Series Host Adapters:
228 BT-948, BT-958, BT-958D
229 BusLogic MultiMaster "C" Series Host Adapters:
230 BT-946C, BT-956C, BT-956CD, BT-445C, BT-747C, BT-757C, BT-757CD, BT-545C,
232 BusLogic MultiMaster "S" Series Host Adapters:
233 BT-445S, BT-747S, BT-747D, BT-757S, BT-757D, BT-545S, BT-542D, BT-742A,
235 BusLogic MultiMaster "A" Series Host Adapters:
238 AMI FastDisk controllers that are true BusLogic MultiMaster clones are also
241 DPT SmartCACHE Plus, SmartCACHE III, SmartRAID III, SmartCACHE IV and
242 SmartRAID IV SCSI/RAID controllers are supported. The DPT SmartRAID/CACHE V
243 is not yet supported.
245 SymBios (formerly NCR) 53C810, 53C810a, 53C815, 53C820, 53C825a,
246 53C860, 53C875, 53C875j, 53C885, 53C895 and 53C896 PCI SCSI controllers:
248 Data Technology DTC3130 (all variants)
249 Diamond FirePort (all)
252 Tekram DC390W, 390U and 390F
256 QLogic 1020, 1040, 1040B and 2100 SCSI and Fibre Channel Adapters
258 DTC 3290 EISA SCSI controller in 1542 emulation mode.
260 With all supported SCSI controllers, full support is provided for
261 SCSI-I & SCSI-II peripherals, including hard disks, optical disks,
262 tape drives (including DAT and 8mm Exabyte), medium changers, processor
263 target devices and CDROM drives. WORM devices that support CDROM commands
264 are supported for read-only access by the CDROM driver. WORM/CD-R/CD-RW
265 writing support is provided by cdrecord, which is in the ports tree.
267 The following drivers were supported under the old SCSI subsystem, but are
268 NOT YET supported under the new CAM SCSI subsystem:
270 Tekram DC390 and DC390T controllers (maybe other cards based on the
273 NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller.
275 UltraStor 14F, 24F and 34F SCSI controllers.
277 Seagate ST01/02 SCSI controllers.
279 Future Domain 8xx/950 series SCSI controllers.
281 WD7000 SCSI controller.
283 Adaptec 1510 series ISA SCSI controllers (not for bootable devices)
284 Adaptec 152x series ISA SCSI controllers
285 Adaptec AIC-6260 and AIC-6360 based boards, which includes the AHA-152x
286 and SoundBlaster SCSI cards.
288 [ Note: There is work-in-progress to port the AIC-6260/6360 and
289 UltraStor drivers to the new CAM SCSI framework, but no estimates on
290 when or if they will be completed. ]
295 Adaptec Duralink PCI fast ethernet adapters based on the Adaptec
296 AIC-6915 fast ethernet controller chip, including the following:
297 ANA-62011 64-bit single port 10/100baseTX adapter
298 ANA-62022 64-bit dual port 10/100baseTX adapter
299 ANA-62044 64-bit quad port 10/100baseTX adapter
300 ANA-69011 32-bit single port 10/100baseTX adapter
301 ANA-62020 64-bit single port 100baseFX adapter
303 Allied-Telesyn AT1700 and RE2000 cards
305 Alteon Networks PCI gigabit ethernet NICs based on the Tigon 1 and Tigon 2
306 chipsets, including the following:
307 Alteon AceNIC (Tigon 1 and 2)
308 3Com 3c985-SX (Tigon 1 and 2)
309 Netgear GA620 (Tigon 2)
310 Silicon Graphics Gigabit Ethernet
311 DEC/Compaq EtherWORKS 1000
314 AMD PCnet/PCI (79c970 & 53c974 or 79c974)
316 SMC Elite 16 WD8013 ethernet interface, and most other WD8003E,
317 WD8003EBT, WD8003W, WD8013W, WD8003S, WD8003SBT and WD8013EBT
318 based clones. SMC Elite Ultra is also supported.
320 RealTek 8129/8139 fast ethernet NICs including the following:
321 Allied Telesyn AT2550
322 Allied Telesyn AT2500TX
323 Genius GF100TXR (RTL8139)
324 NDC Communications NE100TX-E
327 Netronix Inc. EA-1210 NetEther 10/100
328 KTX-9130TX 10/100 Fast Ethernet
329 Accton "Cheetah" EN1027D (MPX 5030/5038; RealTek 8139 clone?)
330 SMC EZ Card 10/100 PCI 1211-TX
332 Lite-On 82c168/82c169 PNIC fast ethernet NICs including the following:
333 LinkSys EtherFast LNE100TX
334 NetGear FA310-TX Rev. D1
335 Matrox FastNIC 10/100
338 Macronix 98713, 98713A, 98715, 98715A and 98725 fast ethernet NICs
339 NDC Communications SFA100A (98713A)
340 CNet Pro120A (98713 or 98713A)
344 Macronix/Lite-On PNIC II LC82C115 fast ethernet NICs including the following:
345 LinkSys EtherFast LNE100TX Version 2
347 Winbond W89C840F fast ethernet NICs including the following:
350 VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
351 NICs including the following:
352 Hawking Technologies PN102TX
356 Silicon Integrated Systems SiS 900 and SiS 7016 PCI fast ethernet NICs
358 Sundance Technologies ST201 PCI fast ethernet NICs including
362 SysKonnect SK-984x PCI gigabit ethernet cards including the following:
363 SK-9841 1000baseLX single mode fiber, single port
364 SK-9842 1000baseSX multimode fiber, single port
365 SK-9843 1000baseLX single mode fiber, dual port
366 SK-9844 1000baseSX multimode fiber, dual port
368 Texas Instruments ThunderLAN PCI NICs, including the following:
369 Compaq Netelligent 10, 10/100, 10/100 Proliant, 10/100 Dual-Port
370 Compaq Netelligent 10/100 TX Embedded UTP, 10 T PCI UTP/Coax, 10/100 TX UTP
371 Compaq NetFlex 3P, 3P Integrated, 3P w/ BNC
372 Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX UTP
373 Racore 8165 10/100baseTX
374 Racore 8148 10baseT/100baseTX/100baseFX multi-personality
376 ADMtek AL981-based PCI fast ethernet NICs
377 ADMtek AN985-based PCI fast ethernet NICs
379 ASIX Electronics AX88140A PCI NICs, including the following:
383 DEC EtherWORKS III NICs (DE203, DE204, and DE205)
384 DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422)
385 DEC DC21040, DC21041, or DC21140 based NICs (SMC Etherpower 8432T, DE245, etc)
386 DEC FDDI (DEFPA/DEFEA) NICs
388 Davicom DM9100 and DM9102 PCI fast ethernet NICs, including the
390 Jaton Corporation XPressNet
392 Efficient ENI-155p ATM PCI
394 FORE PCA-200E ATM PCI
396 Fujitsu MB86960A/MB86965A
398 HP PC Lan+ cards (model numbers: 27247B and 27252A).
400 Intel EtherExpress (not recommended due to driver instability)
401 Intel EtherExpress Pro/10
402 Intel EtherExpress Pro/100B PCI Fast Ethernet
404 Isolan AT 4141-0 (16 bit)
407 Novell NE1000, NE2000, and NE2100 ethernet interface.
408 PCI network cards emulating the NE2000: RealTek 8029, NetVin 5000,
409 Winbond W89C940, Surecom NE-34, VIA VT86C926.
413 3Com 3C503 Etherlink II
415 3Com 3c505 Etherlink/+
417 3Com 3C507 Etherlink 16/TP
419 3Com 3C509, 3C579, 3C589 (PCMCIA), 3C590/592/595/900/905/905B/905C PCI
420 and EISA (Fast) Etherlink III / (Fast) Etherlink XL
422 3Com 3c980/3c980B Fast Etherlink XL server adapter
424 3Com 3cSOHO100-TX OfficeConnect adapter
426 Toshiba ethernet cards
428 PCMCIA ethernet cards from IBM and National Semiconductor are also
431 Note that NO token ring cards are supported at this time as we're
432 still waiting for someone to donate a driver for one of them. Any
439 A range of USB peripherals are supported. Owing to the generic nature
440 of most USB devices, with some exceptions any device of a given class
441 will be supported even if not explicitly listed here.
447 USB printers and USB to parallel printer conversion cables.
452 Motherboards chipsets:
456 Intel 82371SB (PIIX3).
457 Intel 82371AB and EB chipsets (PIIX4).
459 NEC uPD 9210 Host Controller.
461 VIA 83C572 USB Host Controller
463 and any other UHCI or OHCI compliant motherboard chipset (no exceptions
467 PCI plug-in USB host controllers:
469 ADS Electronics PCI plug-in card (2 ports).
471 Entrega PCI plug-in card (4 ports).
474 Specific devices reported to be working:
483 ATen parallel printer adapter.
485 Belkin F5U002 parallel printer adapter.
488 BTC BTC7935 keyboard with mouse port.
490 Cherry G81-3504 keyboard.
496 Entrega USB-to-parallel printer adapter.
500 Iomega USB Zip 100Mb.
502 Kensington Mouse-in-a-Box.
504 Logitech M2452 keyboard.
505 Logitech wheel mouse (3 buttons).
506 Logitech PS/2 / USB mouse (3 buttons).
508 MacAlly mouse (3 buttons).
509 MacAlly self powered hub (4 ports).
511 Microsoft IntelliMouse (3 buttons).
516 Trust Ami Mouse (3 buttons).
519 4.4. ISDN (European DSS1 [Q.921/Q.931] protocol)
520 ---- -------------------------------------------
522 Asuscom I-IN100-ST-DV (experimental, may work)
523 Asuscom ISDNlink 128K PnP
526 AVM Fritz!Card classic
529 AVM Fritz!Card PCMCIA
535 Dr.Neuhaus Niccy 1008
536 Dr.Neuhaus Niccy 1016
537 Dr.Neuhaus Niccy GO@ (ISA PnP)
539 Dynalink IS64PH (no longer maintained)
548 Sagem Cybermod (ISA PnP, may work)
554 Stollmann Tina-pp (under development)
558 Teles S0/16.3 (the "c" Versions - like 16.3c - are unsupported !)
559 Teles S0 PnP (experimental, may work)
561 3Com/USRobotics Sportster ISDN TA intern (non-PnP version)
567 AST 4 port serial card using shared IRQ.
569 ARNET 8 port serial card using shared IRQ.
570 ARNET (now Digiboard) Sync 570/i high-speed serial.
572 Boca BB1004 4-Port serial card (Modems NOT supported)
573 Boca IOAT66 6-Port serial card (Modems supported)
574 Boca BB1008 8-Port serial card (Modems NOT supported)
575 Boca BB2016 16-Port serial card (Modems supported)
577 Cyclades Cyclom-y Serial Board.
579 STB 4 port card using shared IRQ.
581 SDL Communications Riscom/8 Serial Board.
582 SDL Communications RISCom/N2 and N2pci high-speed sync serial boards.
584 Specialix SI/XIO/SX multiport serial cards, with both the older
585 SIHOST2.x and the new "enhanced" (transputer based, aka JET) host cards.
586 ISA, EISA and PCI are supported.
588 Stallion multiport serial boards: EasyIO, EasyConnection 8/32 & 8/64,
589 ONboard 4/16 and Brumby.
591 Adlib, SoundBlaster, SoundBlaster Pro, ProAudioSpectrum, Gravis UltraSound
592 and Roland MPU-401 sound cards.
595 Matrox Meteor Video frame grabber
596 Creative Labs Video Spigot frame grabber
597 Cortex1 frame grabber
598 Various Frame grabbers based on Brooktree Bt848 and Bt878 chip.
600 HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
608 X-10 power controllers
610 GPIB and Transputer drivers.
612 Genius and Mustek hand scanners.
614 Floppy tape drives (some rather old models only, driver rather stale)
616 Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA standard speed
617 (2Mbps) and turbo speed (6Mbps) wireless network adapters and workalikes
618 (NCR WaveLAN/IEEE 802.11, Cabletron RoamAbout 802.11 DS). Note: the
619 ISA versions of these adapters are actually PCMCIA cards combined with
620 an ISA to PCMCIA bridge card, so both kinds of devices work with