xref: /openbsd-src/share/man/man4/pcmcia.4 (revision d13be5d47e4149db2549a9828e244d59dbc43f15)
1.\"	$OpenBSD: pcmcia.4,v 1.58 2008/06/26 05:42:06 ray Exp $
2.\"	$NetBSD: pcmcia.4,v 1.4 1998/06/07 09:10:30 enami Exp $
3.\"
4.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
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.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
17.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
18.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
20.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26.\" POSSIBILITY OF SUCH DAMAGE.
27.\"
28.Dd $Mdocdate: June 26 2008 $
29.Dt PCMCIA 4
30.Os
31.Sh NAME
32.Nm pcmcia
33.Nd introduction to PCMCIA (PC Card) support
34.Sh SYNOPSIS
35.Cd "# i386"
36.Cd "pcic0   at isa? port 0x3e0 iomem 0xd0000 iosiz 0x10000"
37.Cd "pcic1   at isa? port 0x3e2 iomem 0xe0000 iosiz 0x4000"
38.Cd "pcic2   at isa? port 0x3e4 iomem 0xe0000 iosiz 0x4000"
39.Cd "pcic*   at isapnp?"
40.Cd "pcic*   at pci? dev?"
41.Cd "pcmcia* at pcic?"
42.Pp
43.Cd "# i386"
44.Cd "tcic0   at isa? port 0x240 iomem 0xd0000 iosiz 0x10000"
45.Cd "pcmcia* at tcic?"
46.Pp
47.Cd "# sparc"
48.Cd "tslot*  at sbus?"
49.Cd "pcmcia* at tslot?"
50.Pp
51.Cd "# sparc/sparc64"
52.Cd "stp*    at sbus?"
53.Cd "pcmcia* at stp?"
54.Pp
55.Cd "# zaurus"
56.Cd "pxapcic0 at pxaip?"
57.Cd "pcmcia*  at pxapcic?"
58.Pp
59.Cd "# all architectures"
60.Cd "cbb*      at pci?"
61.Cd "cardslot* at cbb? flags 0x0000"
62.Cd "pcmcia*   at cardslot?"
63.Sh DESCRIPTION
64The
65.Nm
66subsystem provides machine-independent bus support and
67drivers for PCMCIA (PC Card)
68devices.
69.Pp
70.Ox
71provides support for the following devices.
72Note that not all architectures support all devices.
73.Ss Miscellaneous
74.Bl -tag -width 12n -offset ind -compact
75.It Xr gpr 4
76GemPlus GPR400 smartcard reader
77.El
78.Ss Serial interfaces and modems
79.Bl -tag -width 12n -offset ind -compact
80.It Xr com 4
81serial communications interface
82.El
83.Ss Wired network interfaces
84.Bl -tag -width 12n -offset ind -compact
85.It Xr ep 4
863Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
87.It Xr ne 4
88NE2000 and compatible 10/100 Ethernet device
89.It Xr sm 4
90SMC91C9x and SMC91C1xx-based 10/100 Ethernet device
91.It Xr xe 4
92Xircom-based 16-bit PCMCIA 10/100 Ethernet device
93.El
94.Ss Wireless network interfaces
95.Bl -tag -width 12n -offset ind -compact
96.It Xr an 4
97Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device
98.It Xr cnw 4
99Xircom CreditCard Netwave wireless network device
100.It Xr malo 4
101Marvell Libertas IEEE 802.11b/g wireless network device
102.It Xr ray 4
103Raytheon Raylink/WebGear Aviator IEEE 802.11FH wireless network device
104.It Xr wi 4
105WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network device
106.El
107.Ss SCSI controllers
108.Bl -tag -width 12n -offset ind -compact
109.It Xr aic 4
110Adaptec AIC-6260 and AIC-6360 SCSI interface
111.El
112.Ss IDE controllers
113.Bl -tag -width 12n -offset ind -compact
114.It Xr wdc 4
115WD100x compatible hard disk controller driver
116.El
117.Pp
118The supported PCMCIA controllers are those that are i82365 compatible.
119.Sh NOTES
120On some
121.Nm
122adapters, for instance the
123.Xr sbus 4 Ns -based
124.Xr stp 4 ,
125the
126.Nm
127bus will be mapped in big-endian format instead of the natural (and
128preferred) little endian format.
129Unfortunately such controllers lack the hardware facility to swap bytes,
130and it is not efficient to convert all drivers to always know about this.
131While 8 bit drivers can invisibly work on such a bus, 16 bit
132drivers will need modification to handle this.
133So far,
134.Xr wi 4
135is the only driver to require these modifications.
136.Pp
137If the
138.Nm
139adapter is not detected, or if
140.Nm
141events (such as card insertion) do not occur, there may be a
142.Tn PCI
143card BIOS mapped in the same memory space the
144.Nm
145driver is configured to use (this is often the case with Ethernet
146card boot ROMs).
147The output from
148.Xr dmesg 8
149should contain a line beginning with
150.Dq bios0
151that lists the memory address and size of mapped regions.
152If there is a conflict, you can use
153.Xr boot_config 8
154to change the iomem parameter of the
155.Em pcic
156device to a non-overlapping address, such as 0xd8000 for
157.Em pcic0 .
158Some experimentation may be required to find a working value; in some
159cases the size parameter of the
160.Em pcic
161device may need to be decreased to avoid a conflict.
162.Sh SEE ALSO
163.Xr cardbus 4 ,
164.Xr intro 4 ,
165.Xr isa 4
166.Sh HISTORY
167The
168.Nm
169driver
170appeared in
171.Ox 2.3 .
172