xref: /openbsd/share/man/man4/isapnp.4 (revision 17df1aa7)
1.\"	$OpenBSD: isapnp.4,v 1.38 2008/05/21 19:05:51 kettenis Exp $
2.\"	$NetBSD: isapnp.4,v 1.8 1998/06/07 09:08:46 enami Exp $
3.\"
4.\" Copyright (c) 1997 Jonathan Stone
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgements:
17.\"      This product includes software developed by Jonathan Stone
18.\" 3. The name of the author may not be used to endorse or promote products
19.\"    derived from this software without specific prior written permission
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.Dd $Mdocdate: May 21 2008 $
33.Dt ISAPNP 4
34.Os
35.Sh NAME
36.Nm isapnp
37.Nd introduction to ISA Plug-and-Play support
38.Sh SYNOPSIS
39.Cd "isapnp0 at isa?"
40.Sh DESCRIPTION
41An
42.Nm
43bus can be configured for each supported ISA bus.
44.Pp
45.Ox
46provides machine-independent bus support and drivers for ISA
47Plug-and-Play (isapnp) autoconfiguration of PnP-compatible
48devices on an ISA bus.
49.Sh SUPPORTED DEVICES
50.Ox
51includes machine-independent ISAPNP drivers, sorted by function
52and driver name:
53.Ss Disk controllers
54.Bl -tag -width 12n -offset ind -compact
55.It Xr aha 4
56Adaptec 154x SCSI interface
57.It Xr aic 4
58Adaptec AIC-6260 and AIC-6360 SCSI interface
59.It Xr wdc 4
60WD100x compatible hard disk controller driver
61.El
62.Ss Serial and parallel interfaces
63.Bl -tag -width 12n -offset ind -compact
64.It Xr com 4
65serial communications interface
66.El
67.Ss Network interfaces
68.Bl -tag -width 12n -offset ind -compact
69.It Xr an 4
70Aironet 4500/4800 IEEE 802.11FH/b wireless interfaces
71.It Xr ef 4
723Com Fast EtherLink ISA (3c515) 10/100 Ethernet device
73.It Xr ep 4
743Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
75.It Xr le 4
76AMD LANCE Ethernet device
77.It Xr ne 4
78NE2000 and compatible 10/100 Ethernet device
79.It Xr we 4
80Western Digital/SMC WD80x3, SMC Elite Ultra, and SMC EtherEZ Ethernet device
81.El
82.Ss Sound
83.Bl -tag -width 12n -offset ind -compact
84.It Xr ess 4
85ESS Technology AudioDrive family audio device
86.It Xr gus 4
87Gravis UltraSound/UltraSound MAX audio device
88.It Xr mpu 4
89Roland/Yamaha MPU401 MIDI UART device
90.It Xr sb 4
91SoundBlaster family audio device
92.It Xr wss 4
93Windows Sound System audio device
94.It Xr ym 4
95Yamaha OPL3-SAx audio device
96.El
97.Ss Miscellaneous devices
98.Bl -tag -width 12n -offset ind -compact
99.It Xr joy 4
100games adapter
101.It Xr pcic 4
102introduction to PCMCIA (PC Card) support
103.It Xr rt 4
104AIMS Lab Radiotrack FM radio device
105.El
106.Sh SEE ALSO
107.Xr intro 4 ,
108.Xr isa 4
109.Sh HISTORY
110The
111.Nm
112driver
113appeared in
114.Nx 1.3 .
115.Sh CAVEATS
116From time to time an
117.Nm
118device will be found which the kernel does not recognize.
119The kernel matches
120.Nm
121devices to device drivers based on identifiers which each device
122provides.
123For example, this device:
124.Pp
125joy0 at isapnp0 <Creative SB16 PnP, CTL7001, PNPB02F, Game> port 0x200/8
126.Pp
127This joystick calls itself by the two names
128.Dq CTL7001
129and
130.Dq PNPB02F .
131The latter is a standard name (which the kernel automatically recognizes),
132but
133.Dq CTL7001
134is a vendor-specific name which needs to be added to a table.
135Unfortunately,
136some devices advertise only their vendor-specific name; for instance:
137.Pp
138isapnp0: <PnP Sound Chip, @P@1001, , > port 0x200/8 not configured
139.Pp
140Testing will show that this device is actually a joystick.
141To resolve the issue, the actual name
142.Dq @P@1001
143has to be entered into the database found in
144.Pa /sys/dev/isa/pnpdevs
145and a new kernel must be built.
146Then the device will probe like this:
147.Pp
148joy0 at isapnp0 <PnP Sound Chip, @P@1001, , > port 0x200/8
149