1.\" $OpenBSD: isapnp.4,v 1.43 2023/04/27 19:01:01 miod 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: April 27 2023 $ 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 aic 4 56Adaptec AIC-6260 and AIC-6360 SCSI interface 57.It Xr wdc 4 58WD100x compatible hard disk controller driver 59.El 60.Ss Serial and parallel interfaces 61.Bl -tag -width 12n -offset ind -compact 62.It Xr com 4 63serial communications interface 64.El 65.Ss Network interfaces 66.Bl -tag -width 12n -offset ind -compact 67.It Xr an 4 68Aironet 4500/4800 IEEE 802.11FH/b wireless interfaces 69.It Xr ef 4 703Com Fast EtherLink ISA (3c515) 10/100 Ethernet device 71.It Xr ep 4 723Com EtherLink III and Fast EtherLink III 10/100 Ethernet device 73.It Xr le 4 74AMD LANCE Ethernet device 75.It Xr ne 4 76NE2000 and compatible 10/100 Ethernet device 77.It Xr we 4 78Western Digital/SMC WD80x3, SMC Elite Ultra, and SMC EtherEZ Ethernet device 79.El 80.Ss Sound 81.Bl -tag -width 12n -offset ind -compact 82.It Xr ess 4 83ESS Technology AudioDrive family audio device 84.It Xr gus 4 85Gravis UltraSound/UltraSound MAX audio device 86.It Xr mpu 4 87Roland/Yamaha MPU401 MIDI UART device 88.It Xr sb 4 89SoundBlaster family audio device 90.El 91.Ss Miscellaneous devices 92.Bl -tag -width 12n -offset ind -compact 93.It Xr joy 4 94games adapter 95.It Xr pcic 4 96ISA PCMCIA controllers 97.El 98.Sh SEE ALSO 99.Xr intro 4 , 100.Xr isa 4 101.Sh HISTORY 102The 103.Nm 104driver 105appeared in 106.Nx 1.3 . 107.Sh CAVEATS 108From time to time an 109.Nm 110device will be found which the kernel does not recognize. 111The kernel matches 112.Nm 113devices to device drivers based on identifiers which each device 114provides. 115For example, this device: 116.Pp 117joy0 at isapnp0 "Creative SB16 PnP, CTL7001, PNPB02F, Game" port 0x200/8 118.Pp 119This joystick calls itself by the two names 120.Dq CTL7001 121and 122.Dq PNPB02F . 123The latter is a standard name (which the kernel automatically recognizes), 124but 125.Dq CTL7001 126is a vendor-specific name which needs to be added to a table. 127Unfortunately, 128some devices advertise only their vendor-specific name; for instance: 129.Pp 130"PnP Sound Chip, @P@1001, , " at isapnp0 port 0x200/8 not configured 131.Pp 132Testing will show that this device is actually a joystick. 133To resolve the issue, the actual name 134.Dq @P@1001 135has to be entered into the database found in 136.Pa /sys/dev/isa/pnpdevs 137and a new kernel must be built. 138Then the device will probe like this: 139.Pp 140joy0 at isapnp0 "PnP Sound Chip, @P@1001, , " port 0x200/8 141