1.\" $NetBSD: pcmcia.4,v 1.39 2021/03/11 16:43:01 nia Exp $ 2.\" 3.\" Copyright (c) 1999, 2002 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Lennart Augustsson. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd January 3, 2009 31.Dt PCMCIA 4 32.Os 33.Sh NAME 34.Nm pcmcia 35.Nd 36introduction to 37.Tn PCMCIA 38.Pq Tn "PC Card" 39support 40.Sh SYNOPSIS 41.Cd "pcmcia* at pcic? controller ? socket ?" 42.Cd "pcmcia* at tcic? controller ? socket ?" 43.Cd "pcmcia* at cardslot?" 44.Pp 45.Cd options PCMCIAVERBOSE 46.Ss amiga 47.Cd "pcmcia* at pccard0" 48.Ss hpcmips 49.Cd "pcmcia* at it8368e? controller ? socket ?" 50.Cd "pcmcia* at plumpcmcia? controller ? socket ?" 51.Ss hpcsh 52.Cd "pcmcia* at hd64461pcmcia? controller ? socket ?" 53.Ss sh3 54.Cd "pcmcia* at shpcic? controller ? socket ?" 55.Ss sparc 56.Cd "pcmcia* at nell?" 57.Sh DESCRIPTION 58.Nx 59provides machine-independent bus support and drivers for 60.Tn PCMCIA 61.Pq Personal Computer Memory Card International Association 62a.k.a. 63.Tn "PC Card" , 64.Tn CardBus 65devices. 66.Sh HARDWARE 67.Nx 68includes the following machine-independent 69.Tn PCMCIA 70drivers, sorted by function and driver name: 71.Ss Serial interfaces and modems 72.Bl -tag -width speaker(4) -offset indent 73.It Xr com 4 748250/16450/16550-compatible PCMCIA serial cards and modems. 75.El 76.Ss Network interfaces 77.Bl -tag -width speaker(4) -offset indent 78.It Xr an 4 79Aironet 4500/4800 and Cisco 340 series 802.11 controller. 80.It Xr awi 4 81802.11 controller based on the AMD PCnetMobile chipset. 82.It Xr cnw 4 83Netwave AirSurfer Wireless LAN interface. 84.It Xr ep 4 853Com 3c589 EtherLink III Ethernet card. 86.It Xr mbe 4 87Ethernet card based on the Fujitsu MB86960A/MB86965A chipset. 88.It Xr mhzc 4 89Megahertz Ethernet/Modem combo cards 90.It Xr ne 4 91NE2000 compatible cards. 92.It Xr ray 4 93Raytheon Raylink and WebGear Aviator2.4 802.11 controller. 94.It Xr sm 4 95Megahertz Ethernet card. 96.It Xr wi 4 97Lucent WaveLAN/IEEE and PRISM-II based 802.11 controller. 98.It Xr xi 4 99Xircom CreditCard Ethernet 100.El 101.Ss SCSI controllers 102.Bl -tag -width speaker(4) -offset indent 103.It Xr aic 4 104Adaptec APA-1460 105.Tn SCSI 106controller card. 107.It Xr esp 4 108NCR 53C9x, Emulex ESP406, and Qlogic FAS408 109.Tn SCSI 110controllers. 111.It Xr spc 4 112Fujitsu MB87030/MB89352 113.Tn SCSI 114controllers. 115.El 116.Ss IDE controllers 117.Bl -tag -width speaker(4) -offset indent 118.It Xr wdc 4 119Digital Hinote Ultra Mobile Media Adapter 120.El 121.Ss Bluetooth devices 122.Bl -tag -width speaker(4) -offset indent 123.It Xr bt3c 4 1243Com 3CRWB6096 Bluetooth PC Card driver. 125.It Xr btbc 4 126AnyCom Bluetooth BlueCard driver. 127.El 128.Ss USB Controller 129.Bl -tag -width speaker(4) -offset indent 130.It Xr slhci 4 131Cypress/ScanLogic SL811HS USB Host Controller driver. 132.El 133.Sh SEE ALSO 134.Xr cardbus 4 , 135.Xr intro 4 , 136.Xr isa 4 , 137.Xr options 4 , 138.Xr pcic 4 , 139.Xr tcic 4 , 140.Xr pcmcia 9 141.Sh HISTORY 142The 143.Nm 144driver appeared in 145.Nx 1.3 . 146.Sh BUGS 147.Ss IO space conflicts 148.Nx 149probes the 150.Tn PCMCIA 151IO bus width and uses that information to decide 152where to map 153.Tn PCMCIA 154IO space. 155For 10-bit wide cards, 0x300-0x3ff is used. 156For 12-bit wide cards, 0x400-0x4ff is used. 157.Pp 158Neither choice is perfect. 159In the 12-bit case, 0x400 appears to work 160in substantially more devices than 0x300. 161In the event that 162.Tn PCMCIA 163devices are mapped in 0x400-0x4ff and appear to be nonfunctional, 164remapping to 0x300-0x3ff may be appropriate; consult 165.Cd options PCIC_ISA_ALLOC_IOBASE 166and 167.Cd options PCIC_ISA_ALLOC_IOSIZE 168in 169.Xr options 4 . 170Example: 171.Bd -literal -offset indent 172# Avoid PCMCIA bus space conflicts with the default IO space 173# allocation on 12-bit wide busses (base 0x300 size 0xff). 174options PCIC_ISA_ALLOC_IOBASE=0x300 175options PCIC_ISA_ALLOC_IOSIZE=0x0ff 176.Ed 177.Ss Interrupt conflicts 178.Nx 179attempts to probe for available interrupts to assign to 180.Tn PCMCIA 181devices. 182In some cases, it is not possible to detect 183all interrupts in use; in such cases, use of 184.Cd options PCIC_ISA_INTR_ALLOC_MASK 185may be necessary. 186See 187.Xr options 4 . 188.Ss Unconfigured devices 189During autoconfiguration, if a message is displayed saying that your card 190is "not configured" it indicates that there isn't support for your card 191compiled into the kernel. 192To fix this problem, it may simply be a matter 193of adding the manufacturer and product IDs to the 194.Tn PCMCIA 195database or adding a front-end attachment to an existing driver. 196In the latter case, it is normally always necessary to get a dump 197of the CIS table from the card. 198You can do this by adding 199.Cd options PCMCIACISDEBUG 200and 201.Cd options PCMCIADEBUG 202into your kernel config file. 203Additionally, you will have to patch the kernel to enable run-time 204debugging. 205This can be done in the source by changing the variables 206.Va pcmcia_debug 207and 208.Va pcmciacis_debug 209to 0xff. 210Alternatively, you can patch the same variables at run-time using 211.Xr ddb 4 . 212For most drivers you should also consider enabling any driver-specific 213debugging options. 214