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/AIC-6260 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 dc0 n/a n/a n/a n/a DEC/Intel 21143 and workalikes
89 de0 n/a n/a n/a n/a DEC DC21x40 PCI based cards
90 (including 21140 100bT cards)
91 ed0 280 10 dyn d8000 WD & SMC 80xx; Novell NE1000 &
92 NE2000; 3Com 3C503; HP PC Lan+
93 eg0 310 5 dyn dyn 3Com 3C505
94 ep0 300 10 dyn dyn 3Com 3C509
95 ex0 dyn dyn dyn n/a Intel EtherExpress Pro/10 cards
96 fe0 300 dyn n/a n/a Allied-Telesyn AT1700, RE2000 and
97 Fujitsu FMV-180 series cards.
98 fxp0 dyn dyn n/a dyn Intel EtherExpress Pro/100B
99 ie0 300 10 dyn d0000 AT&T StarLAN 10 and EN100;
101 Intel EtherExpress (8/16,16[TP]) cards
102 le0 300 5 dyn d0000 Digital Equipment EtherWorks
104 lnc0 280 10 n/a dyn Lance/PCnet cards
105 (Isolan, Novell NE2100, NE32-VL,
106 some PCnet-PCI cards)
107 rl0 dyn dyn n/a dyn RealTek 8129/8139 fast ethernet
108 sf0 dyn dyn n/a dyn Adaptec AIC-6915 fast ethernet
109 sis0 dyn dyn n/a dyn SiS 900/SiS 7016 fast ethernet
110 ste0 dyn dyn n/a dyn Sundance ST201 fast ethernet
111 tl0 dyn dyn n/a dyn TI TNET100 'ThunderLAN' cards.
112 wb0 dyn dyn n/a dyn Winbond W89C840F PCI based cards.
113 vr0 dyn dyn n/a dyn VIA VT3043/VT86C100A PCI based cards.
114 vx0 dyn dyn n/a dyn 3Com 3c59x ((Fast) Etherlink III)
115 xl0 dyn dyn n/a dyn 3Com 3c900, 3c905, 3c905B, 3c905C,
116 3c980, 3cSOHO100 ((Fast) Etherlink XL)
117 cs0 0x300 dyn n/a n/a Crystal Semiconductor CS89x0-based
122 If the hardware in your computer is not set to the same settings as
123 those shown in the table and the item in conflict is not marked 'dyn',
124 you will have to either reconfigure your hardware or use UserConfig
125 to reconfigure the kernel to match the way your hardware is currently set
126 (see the next section).
128 If the settings do not match, the kernel may be unable to locate
129 or reliably access the devices in your system.
132 2. LINT - other possible configurations
133 -- ------------------------------------
135 The following drivers are not in the GENERIC kernel but remain
136 available to those who do not mind compiling a custom kernel (see
137 section 6 of FreeBSD.FAQ). The LINT configuration file
138 (/sys/i386/conf/LINT) also contains prototype entries for just about
139 every device supported by FreeBSD and is a good general reference.
141 The device names and a short description of each are listed below. The port
142 numbers, etc, are not meaningful here since you will need to compile a
143 custom kernel to gain access to these devices anyway and can thus
144 adjust the addresses to match the hardware in your computer in the process.
145 The LINT file contains prototype entries for all of the below which you
146 can easily cut-and-paste into your own file (or simply copy LINT and edit
149 ctx: Cortex-I frame grabber
150 cx: Cronyx/Sigma multiport sync/async
151 cy: Cyclades high-speed serial driver
153 fea: DEC DEFEA EISA FDDI adapter
154 fpa: DEC DEFPA PCI FDDI adapter
155 gp: National Instruments AT-GPIB and AT-GPIB/TNT board
156 gsc: Genius GS-4500 hand scanner
157 gus: Gravis Ultrasound - Ultrasound, Ultrasound 16, Ultrasound MAX
158 gusxvi: Gravis Ultrasound 16-bit PCM
159 hea: Efficient ENI-155p ATM PCI adapter
160 hfa: FORE PCA-200E ATM PCI adapter
161 isic: isdn4bsd Siemens ISDN Chipset driver
163 labpc: National Instrument's Lab-PC and Lab-PC+
164 meteor: Matrox Meteor frame-grabber card
165 bktr: Brooktree Bt848 / Bt 878 based frame-grabber cards.
166 mpu: Roland MPU-401 stand-alone card
167 mse: Microsoft, Logitech, ATI bus mouse ports
168 mss: Microsoft Sound System
169 opl: Yamaha OPL-2 and OPL-3 FM - SB, SB Pro, SB 16, ProAudioSpectrum
170 pas: ProAudioSpectrum PCM and MIDI
171 pca: PCM audio ("/dev/audio") through your PC speaker
172 pcm: PCM audio on most modern ISA audio codecs
174 rc: RISCom/8 multiport card
175 sb: SoundBlaster PCM - SoundBlaster, SB Pro, SB16, ProAudioSpectrum
176 sbmidi: SoundBlaster 16 MIDI interface
177 sbxvi: SoundBlaster 16
178 si: Specialix SI/XIO/SX (old and enhanced ISA, PCI, EISA) serial
179 spigot: Creative Labs Video Spigot video-acquisition board
180 uart: Stand-alone 6850 UART for MIDI
181 wds: Western Digital WD7000 IDE
186 3. Supported Hardware
187 -- ------------------
189 FreeBSD currently runs on a wide variety of ISA and PCI bus based
190 Alphas's. Support for generic IDE or ESDI drive configurations is
191 somewhat marginal and a SCSI controller is therefore recommended.
193 What follows is a list of all peripherals currently known to work with
194 FreeBSD. Other configurations may also work, we have simply not as yet
195 received confirmation of this.
198 4.1. Disk Controllers
199 ---- ----------------
201 WD1003 (any generic MFM/RLL)
202 WD1007 (any generic IDE/ESDI)
206 Adaptec 1535 ISA SCSI controllers
207 Adaptec 154x series ISA SCSI controllers
208 Adaptec 174x series EISA SCSI controller in standard and enhanced mode.
209 Adaptec 274X/284X/2920C/294x/2950/3940/3950 (Narrow/Wide/Twin) series
210 EISA/VLB/PCI SCSI controllers.
211 Adaptec AIC7850, AIC7860, AIC7880, AIC789x, on-board SCSI controllers.
212 Adaptec 1510 series ISA SCSI controllers (not for bootable devices)
213 Adaptec 152x series ISA SCSI controllers
214 Adaptec AIC-6260 and AIC-6360 based boards, which includes the AHA-152x
215 and SoundBlaster SCSI cards.
217 AdvanSys SCSI controllers (all models).
219 BusLogic MultiMaster controllers:
221 [ Please note that BusLogic/Mylex "Flashpoint" adapters are NOT yet supported ]
223 BusLogic MultiMaster "W" Series Host Adapters:
224 BT-948, BT-958, BT-958D
225 BusLogic MultiMaster "C" Series Host Adapters:
226 BT-946C, BT-956C, BT-956CD, BT-445C, BT-747C, BT-757C, BT-757CD, BT-545C,
228 BusLogic MultiMaster "S" Series Host Adapters:
229 BT-445S, BT-747S, BT-747D, BT-757S, BT-757D, BT-545S, BT-542D, BT-742A,
231 BusLogic MultiMaster "A" Series Host Adapters:
234 AMI FastDisk controllers that are true BusLogic MultiMaster clones are also
237 DPT SmartCACHE Plus, SmartCACHE III, SmartRAID III, SmartCACHE IV and
238 SmartRAID IV SCSI/RAID controllers are supported. The DPT SmartRAID/CACHE V
239 is not yet supported.
241 SymBios (formerly NCR) 53C810, 53C810a, 53C815, 53C820, 53C825a,
242 53C860, 53C875, 53C875j, 53C885, 53C895 and 53C896 PCI SCSI controllers:
244 Data Technology DTC3130 (all variants)
245 Diamond FirePort (all)
248 Tekram DC390W, 390U and 390F
252 QLogic 1020, 1040, 1040B and 2100 SCSI and Fibre Channel Adapters
254 DTC 3290 EISA SCSI controller in 1542 emulation mode.
256 With all supported SCSI controllers, full support is provided for
257 SCSI-I & SCSI-II peripherals, including hard disks, optical disks,
258 tape drives (including DAT and 8mm Exabyte), medium changers, processor
259 target devices and CDROM drives. WORM devices that support CDROM commands
260 are supported for read-only access by the CDROM driver. WORM/CD-R/CD-RW
261 writing support is provided by cdrecord, which is in the ports tree.
263 The following drivers were supported under the old SCSI subsystem, but are
264 NOT YET supported under the new CAM SCSI subsystem:
266 Tekram DC390 and DC390T controllers (maybe other cards based on the
269 NCR5380/NCR53400 ("ProAudio Spectrum") SCSI controller.
271 UltraStor 14F, 24F and 34F SCSI controllers.
273 Seagate ST01/02 SCSI controllers.
275 Future Domain 8xx/950 series SCSI controllers.
277 WD7000 SCSI controller.
279 [ Note: There is work-in-progress to port the UltraStor driver to
280 the new CAM SCSI framework, but no estimates on when or if it will
286 Adaptec Duralink PCI fast ethernet adapters based on the Adaptec
287 AIC-6915 fast ethernet controller chip, including the following:
288 ANA-62011 64-bit single port 10/100baseTX adapter
289 ANA-62022 64-bit dual port 10/100baseTX adapter
290 ANA-62044 64-bit quad port 10/100baseTX adapter
291 ANA-69011 32-bit single port 10/100baseTX adapter
292 ANA-62020 64-bit single port 100baseFX adapter
294 Allied-Telesyn AT1700 and RE2000 cards
296 Alteon Networks PCI gigabit ethernet NICs based on the Tigon 1 and Tigon 2
297 chipsets, including the following:
298 Alteon AceNIC (Tigon 1 and 2)
299 3Com 3c985-SX (Tigon 1 and 2)
300 Netgear GA620 (Tigon 2)
301 Silicon Graphics Gigabit Ethernet
302 DEC/Compaq EtherWORKS 1000
305 AMD PCnet/PCI (79c970 & 53c974 or 79c974)
307 SMC Elite 16 WD8013 ethernet interface, and most other WD8003E,
308 WD8003EBT, WD8003W, WD8013W, WD8003S, WD8003SBT and WD8013EBT
309 based clones. SMC Elite Ultra is also supported.
311 RealTek 8129/8139 fast ethernet NICs including the following:
312 Allied Telesyn AT2550
313 Allied Telesyn AT2500TX
314 Genius GF100TXR (RTL8139)
315 NDC Communications NE100TX-E
318 Netronix Inc. EA-1210 NetEther 10/100
319 KTX-9130TX 10/100 Fast Ethernet
320 Accton "Cheetah" EN1027D (MPX 5030/5038; RealTek 8139 clone?)
321 SMC EZ Card 10/100 PCI 1211-TX
323 Lite-On 82c168/82c169 PNIC fast ethernet NICs including the following:
324 LinkSys EtherFast LNE100TX
325 NetGear FA310-TX Rev. D1
326 Matrox FastNIC 10/100
329 Macronix 98713, 98713A, 98715, 98715A and 98725 fast ethernet NICs
330 NDC Communications SFA100A (98713A)
331 CNet Pro120A (98713 or 98713A)
335 Macronix/Lite-On PNIC II LC82C115 fast ethernet NICs including the following:
336 LinkSys EtherFast LNE100TX Version 2
338 Winbond W89C840F fast ethernet NICs including the following:
341 VIA Technologies VT3043 "Rhine I" and VT86C100A "Rhine II" fast ethernet
342 NICs including the following:
343 Hawking Technologies PN102TX
347 Silicon Integrated Systems SiS 900 and SiS 7016 PCI fast ethernet NICs
349 Sundance Technologies ST201 PCI fast ethernet NICs including
353 SysKonnect SK-984x PCI gigabit ethernet cards including the following:
354 SK-9841 1000baseLX single mode fiber, single port
355 SK-9842 1000baseSX multimode fiber, single port
356 SK-9843 1000baseLX single mode fiber, dual port
357 SK-9844 1000baseSX multimode fiber, dual port
359 Texas Instruments ThunderLAN PCI NICs, including the following:
360 Compaq Netelligent 10, 10/100, 10/100 Proliant, 10/100 Dual-Port
361 Compaq Netelligent 10/100 TX Embedded UTP, 10 T PCI UTP/Coax, 10/100 TX UTP
362 Compaq NetFlex 3P, 3P Integrated, 3P w/ BNC
363 Olicom OC-2135/2138, OC-2325, OC-2326 10/100 TX UTP
364 Racore 8165 10/100baseTX
365 Racore 8148 10baseT/100baseTX/100baseFX multi-personality
367 ADMtek AL981-based PCI fast ethernet NICs
368 ADMtek AN985-based PCI fast ethernet NICs
370 ASIX Electronics AX88140A PCI NICs, including the following:
374 DEC EtherWORKS III NICs (DE203, DE204, and DE205)
375 DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422)
376 DEC DC21040, DC21041, or DC21140 based NICs (SMC Etherpower 8432T, DE245, etc)
377 DEC FDDI (DEFPA/DEFEA) NICs
379 Davicom DM9100 and DM9102 PCI fast ethernet NICs, including the
381 Jaton Corporation XPressNet
383 Efficient ENI-155p ATM PCI
385 FORE PCA-200E ATM PCI
387 Fujitsu MB86960A/MB86965A
389 HP PC Lan+ cards (model numbers: 27247B and 27252A).
391 Intel EtherExpress (not recommended due to driver instability)
392 Intel EtherExpress Pro/10
393 Intel EtherExpress Pro/100B PCI Fast Ethernet
395 Isolan AT 4141-0 (16 bit)
398 Novell NE1000, NE2000, and NE2100 ethernet interface.
399 PCI network cards emulating the NE2000: RealTek 8029, NetVin 5000,
400 Winbond W89C940, Surecom NE-34, VIA VT86C926.
404 3Com 3C503 Etherlink II
406 3Com 3c505 Etherlink/+
408 3Com 3C507 Etherlink 16/TP
410 3Com 3C509, 3C579, 3C589 (PCMCIA), 3C590/592/595/900/905/905B/905C PCI
411 and EISA (Fast) Etherlink III / (Fast) Etherlink XL
413 3Com 3c980/3c980B Fast Etherlink XL server adapter
415 3Com 3cSOHO100-TX OfficeConnect adapter
417 Toshiba ethernet cards
419 PCMCIA ethernet cards from IBM and National Semiconductor are also
422 Note that NO token ring cards are supported at this time as we're
423 still waiting for someone to donate a driver for one of them. Any
430 A range of USB peripherals are supported. Owing to the generic nature
431 of most USB devices, with some exceptions any device of a given class
432 will be supported even if not explicitly listed here.
438 USB printers and USB to parallel printer conversion cables.
443 Motherboards chipsets:
447 Intel 82371SB (PIIX3).
448 Intel 82371AB and EB chipsets (PIIX4).
450 NEC uPD 9210 Host Controller.
452 VIA 83C572 USB Host Controller
454 and any other UHCI or OHCI compliant motherboard chipset (no exceptions
458 PCI plug-in USB host controllers:
460 ADS Electronics PCI plug-in card (2 ports).
462 Entrega PCI plug-in card (4 ports).
465 Specific devices reported to be working:
474 ATen parallel printer adapter.
476 Belkin F5U002 parallel printer adapter.
479 BTC BTC7935 keyboard with mouse port.
481 Cherry G81-3504 keyboard.
487 Entrega USB-to-parallel printer adapter.
491 Iomega USB Zip 100Mb.
493 Kensington Mouse-in-a-Box.
495 Logitech M2452 keyboard.
496 Logitech wheel mouse (3 buttons).
497 Logitech PS/2 / USB mouse (3 buttons).
499 MacAlly mouse (3 buttons).
500 MacAlly self powered hub (4 ports).
502 Microsoft IntelliMouse (3 buttons).
507 Trust Ami Mouse (3 buttons).
510 4.4. ISDN (European DSS1 [Q.921/Q.931] protocol)
511 ---- -------------------------------------------
513 Asuscom I-IN100-ST-DV (experimental, may work)
514 Asuscom ISDNlink 128K PnP
517 AVM Fritz!Card classic
520 AVM Fritz!Card PCMCIA
526 Dr.Neuhaus Niccy 1008
527 Dr.Neuhaus Niccy 1016
528 Dr.Neuhaus Niccy GO@ (ISA PnP)
530 Dynalink IS64PH (no longer maintained)
539 Sagem Cybermod (ISA PnP, may work)
545 Stollmann Tina-pp (under development)
549 Teles S0/16.3 (the "c" Versions - like 16.3c - are unsupported !)
550 Teles S0 PnP (experimental, may work)
552 3Com/USRobotics Sportster ISDN TA intern (non-PnP version)
558 AST 4 port serial card using shared IRQ.
560 ARNET 8 port serial card using shared IRQ.
561 ARNET (now Digiboard) Sync 570/i high-speed serial.
563 Boca BB1004 4-Port serial card (Modems NOT supported)
564 Boca IOAT66 6-Port serial card (Modems supported)
565 Boca BB1008 8-Port serial card (Modems NOT supported)
566 Boca BB2016 16-Port serial card (Modems supported)
568 Cyclades Cyclom-y Serial Board.
570 STB 4 port card using shared IRQ.
572 SDL Communications Riscom/8 Serial Board.
573 SDL Communications RISCom/N2 and N2pci high-speed sync serial boards.
575 Specialix SI/XIO/SX multiport serial cards, with both the older
576 SIHOST2.x and the new "enhanced" (transputer based, aka JET) host cards.
577 ISA, EISA and PCI are supported.
579 Stallion multiport serial boards: EasyIO, EasyConnection 8/32 & 8/64,
580 ONboard 4/16 and Brumby.
582 Adlib, SoundBlaster, SoundBlaster Pro, ProAudioSpectrum, Gravis UltraSound
583 and Roland MPU-401 sound cards.
586 Matrox Meteor Video frame grabber
587 Creative Labs Video Spigot frame grabber
588 Cortex1 frame grabber
589 Various Frame grabbers based on Brooktree Bt848 and Bt878 chip.
591 HP4020, HP6020, Philips CDD2000/CDD2660 and Plasmon CD-R drives.
599 X-10 power controllers
601 GPIB and Transputer drivers.
603 Genius and Mustek hand scanners.
605 Floppy tape drives (some rather old models only, driver rather stale)
607 Lucent Technologies WaveLAN/IEEE 802.11 PCMCIA and ISA standard speed
608 (2Mbps) and turbo speed (6Mbps) wireless network adapters and workalikes
609 (NCR WaveLAN/IEEE 802.11, Cabletron RoamAbout 802.11 DS). Note: the
610 ISA versions of these adapters are actually PCMCIA cards combined with
611 an ISA to PCMCIA bridge card, so both kinds of devices work with