summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/pcmcia.4
diff options
context:
space:
mode:
Diffstat (limited to 'static/netbsd/man4/pcmcia.4')
-rw-r--r--static/netbsd/man4/pcmcia.4213
1 files changed, 213 insertions, 0 deletions
diff --git a/static/netbsd/man4/pcmcia.4 b/static/netbsd/man4/pcmcia.4
new file mode 100644
index 00000000..c923ad5b
--- /dev/null
+++ b/static/netbsd/man4/pcmcia.4
@@ -0,0 +1,213 @@
+.\" $NetBSD: pcmcia.4,v 1.39 2021/03/11 16:43:01 nia Exp $
+.\"
+.\" Copyright (c) 1999, 2002 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Lennart Augustsson.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd January 3, 2009
+.Dt PCMCIA 4
+.Os
+.Sh NAME
+.Nm pcmcia
+.Nd
+introduction to
+.Tn PCMCIA
+.Pq Tn "PC Card"
+support
+.Sh SYNOPSIS
+.Cd "pcmcia* at pcic? controller ? socket ?"
+.Cd "pcmcia* at tcic? controller ? socket ?"
+.Cd "pcmcia* at cardslot?"
+.Pp
+.Cd options PCMCIAVERBOSE
+.Ss amiga
+.Cd "pcmcia* at pccard0"
+.Ss hpcmips
+.Cd "pcmcia* at it8368e? controller ? socket ?"
+.Cd "pcmcia* at plumpcmcia? controller ? socket ?"
+.Ss hpcsh
+.Cd "pcmcia* at hd64461pcmcia? controller ? socket ?"
+.Ss sh3
+.Cd "pcmcia* at shpcic? controller ? socket ?"
+.Ss sparc
+.Cd "pcmcia* at nell?"
+.Sh DESCRIPTION
+.Nx
+provides machine-independent bus support and drivers for
+.Tn PCMCIA
+.Pq Personal Computer Memory Card International Association
+a.k.a.
+.Tn "PC Card" ,
+.Tn CardBus
+devices.
+.Sh HARDWARE
+.Nx
+includes the following machine-independent
+.Tn PCMCIA
+drivers, sorted by function and driver name:
+.Ss Serial interfaces and modems
+.Bl -tag -width speaker(4) -offset indent
+.It Xr com 4
+8250/16450/16550-compatible PCMCIA serial cards and modems.
+.El
+.Ss Network interfaces
+.Bl -tag -width speaker(4) -offset indent
+.It Xr an 4
+Aironet 4500/4800 and Cisco 340 series 802.11 controller.
+.It Xr awi 4
+802.11 controller based on the AMD PCnetMobile chipset.
+.It Xr cnw 4
+Netwave AirSurfer Wireless LAN interface.
+.It Xr ep 4
+3Com 3c589 EtherLink III Ethernet card.
+.It Xr mbe 4
+Ethernet card based on the Fujitsu MB86960A/MB86965A chipset.
+.It Xr mhzc 4
+Megahertz Ethernet/Modem combo cards
+.It Xr ne 4
+NE2000 compatible cards.
+.It Xr ray 4
+Raytheon Raylink and WebGear Aviator2.4 802.11 controller.
+.It Xr sm 4
+Megahertz Ethernet card.
+.It Xr wi 4
+Lucent WaveLAN/IEEE and PRISM-II based 802.11 controller.
+.It Xr xi 4
+Xircom CreditCard Ethernet
+.El
+.Ss SCSI controllers
+.Bl -tag -width speaker(4) -offset indent
+.It Xr aic 4
+Adaptec APA-1460
+.Tn SCSI
+controller card.
+.It Xr esp 4
+NCR 53C9x, Emulex ESP406, and Qlogic FAS408
+.Tn SCSI
+controllers.
+.It Xr spc 4
+Fujitsu MB87030/MB89352
+.Tn SCSI
+controllers.
+.El
+.Ss IDE controllers
+.Bl -tag -width speaker(4) -offset indent
+.It Xr wdc 4
+Digital Hinote Ultra Mobile Media Adapter
+.El
+.Ss Bluetooth devices
+.Bl -tag -width speaker(4) -offset indent
+.It Xr bt3c 4
+3Com 3CRWB6096 Bluetooth PC Card driver.
+.It Xr btbc 4
+AnyCom Bluetooth BlueCard driver.
+.El
+.Ss USB Controller
+.Bl -tag -width speaker(4) -offset indent
+.It Xr slhci 4
+Cypress/ScanLogic SL811HS USB Host Controller driver.
+.El
+.Sh SEE ALSO
+.Xr cardbus 4 ,
+.Xr intro 4 ,
+.Xr isa 4 ,
+.Xr options 4 ,
+.Xr pcic 4 ,
+.Xr tcic 4 ,
+.Xr pcmcia 9
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Nx 1.3 .
+.Sh BUGS
+.Ss IO space conflicts
+.Nx
+probes the
+.Tn PCMCIA
+IO bus width and uses that information to decide
+where to map
+.Tn PCMCIA
+IO space.
+For 10-bit wide cards, 0x300-0x3ff is used.
+For 12-bit wide cards, 0x400-0x4ff is used.
+.Pp
+Neither choice is perfect.
+In the 12-bit case, 0x400 appears to work
+in substantially more devices than 0x300.
+In the event that
+.Tn PCMCIA
+devices are mapped in 0x400-0x4ff and appear to be nonfunctional,
+remapping to 0x300-0x3ff may be appropriate; consult
+.Cd options PCIC_ISA_ALLOC_IOBASE
+and
+.Cd options PCIC_ISA_ALLOC_IOSIZE
+in
+.Xr options 4 .
+Example:
+.Bd -literal -offset indent
+# Avoid PCMCIA bus space conflicts with the default IO space
+# allocation on 12-bit wide busses (base 0x300 size 0xff).
+options PCIC_ISA_ALLOC_IOBASE=0x300
+options PCIC_ISA_ALLOC_IOSIZE=0x0ff
+.Ed
+.Ss Interrupt conflicts
+.Nx
+attempts to probe for available interrupts to assign to
+.Tn PCMCIA
+devices.
+In some cases, it is not possible to detect
+all interrupts in use; in such cases, use of
+.Cd options PCIC_ISA_INTR_ALLOC_MASK
+may be necessary.
+See
+.Xr options 4 .
+.Ss Unconfigured devices
+During autoconfiguration, if a message is displayed saying that your card
+is "not configured" it indicates that there isn't support for your card
+compiled into the kernel.
+To fix this problem, it may simply be a matter
+of adding the manufacturer and product IDs to the
+.Tn PCMCIA
+database or adding a front-end attachment to an existing driver.
+In the latter case, it is normally always necessary to get a dump
+of the CIS table from the card.
+You can do this by adding
+.Cd options PCMCIACISDEBUG
+and
+.Cd options PCMCIADEBUG
+into your kernel config file.
+Additionally, you will have to patch the kernel to enable run-time
+debugging.
+This can be done in the source by changing the variables
+.Va pcmcia_debug
+and
+.Va pcmciacis_debug
+to 0xff.
+Alternatively, you can patch the same variables at run-time using
+.Xr ddb 4 .
+For most drivers you should also consider enabling any driver-specific
+debugging options.