xref: /openbsd/share/man/man4/isapnp.4 (revision 133306f0)
1.\"	$OpenBSD: isapnp.4,v 1.20 2000/12/21 21:01:17 aaron 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 July 12, 1998
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.Pp
41An
42.Nm
43bus can be configured for each supported ISA bus.
44.Sh DESCRIPTION
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.Pp
54.Ss Disk controllers
55.Bl -tag -width speakerxx -offset ind -compact
56.It Xr aic 4
57Adaptec AHA-1520B SCSI controller card.
58.It Xr aha 4
59Adaptec AHA-154x SCSI controller card.
60.It Xr wdc 4
61IDE controllers (typically found on sound cards).
62.El
63.Pp
64.Ss Serial and parallel interfaces
65.Bl -tag -width speaker -offset ind -compact
66.It Xr com 4 , Xr pccom 4
678250/16450/16550/16650/16850-compatible ISA PnP serial cards and internal
68modems.
69Winmodems are not supported.
70.El
71.Pp
72.Ss Network interfaces
73.Bl -tag -width speaker -offset ind -compact
74.It Xr ep 4
753Com 3c509B EtherLink-III Ethernet interfaces.
76.It Xr le 4
77Ethernet driver for Lance based Ethernet interfaces.
78.It Xr ne 4
79NE2000-compatible Ethernet interfaces.
80.It Xr we 4
81SMC EtherEZ Ethernet interfaces.
82.El
83.Ss Sound
84.Bl -tag -width speaker -offset ind -compact
85.It Xr sb 4
86SoundBlaster series sound cards (SB16 PnP through AWE64).
87.It Xr gus 4
88Gravis Ultrasound PnP sound cards.
89.It Xr ym 4
90Yamaha OPL3-SA3 sound cards.
91.It Xr wss 4
92Windows Sound System cards.
93.It Xr mpu 4
94MIDI interfaces.
95.El
96.Ss Misc devices
97.Bl -tag -width speaker -offset ind -compact
98.It Xr joy 4
99Joystick driver.
100.El
101.Sh CAVEATS
102From time to time an
103.Nm
104device will be found which the kernel does not recognize.
105The kernel matches
106.Nm
107devices to device drivers based on identifiers which each device
108provides.
109For example, this device:
110.Pp
111joy0 at isapnp0 <Creative SB16 PnP, CTL7001, PNPB02F, Game> port 0x200/8
112.Pp
113This joystick calls itself by the two names
114.Dq CTL7001
115and
116.Dq PNPB02F .
117The latter is a standard name (which the kernel automatically recognizes),
118but
119.Dq CTL7001
120is a vendor-specific name which needs to be added to a table.
121Unfortunately,
122some devices advertise only their vendor-specific name; for instance:
123.Pp
124isapnp0: <PnP Sound Chip, @P@1001, , > port 0x200/8 not configured
125.Pp
126Testing will show that this device is actually a joystick.
127To resolve the issue, the actual name
128.Dq @P@1001
129has to be entered into the database found in
130.Pa /sys/dev/isa/pnpdevs
131and a new kernel must be built.
132Then the device will probe like this:
133.Pp
134joy0 at isapnp0 <PnP Sound Chip, @P@1001, , > port 0x200/8
135.Sh SEE ALSO
136.Xr cardbus 4 ,
137.Xr intro 4 ,
138.Xr isa 4 ,
139.Xr pci 4 ,
140.Xr pcmcia 4 ,
141.Xr usb 4
142.Sh HISTORY
143The
144.Nm
145driver
146appeared in
147.Nx 1.3 .
148