xref: /openbsd/share/man/man4/pcmcia.4 (revision 4cfece93)
1.\"	$OpenBSD: pcmcia.4,v 1.66 2019/12/13 20:57:54 deraadt 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: December 13 2019 $
29.Dt PCMCIA 4
30.Os
31.Sh NAME
32.Nm pcmcia ,
33.Nm pcic
34.Nd introduction to PCMCIA (PC Card) support
35.Sh SYNOPSIS
36.Cd "# i386"
37.Cd "pcic0   at isa? port 0x3e0 iomem 0xd0000 iosiz 0x10000"
38.Cd "pcic1   at isa? port 0x3e2 iomem 0xe0000 iosiz 0x4000"
39.Cd "pcic2   at isa? port 0x3e4 iomem 0xe0000 iosiz 0x4000"
40.Cd "pcic*   at isapnp?"
41.Cd "pcic*   at pci? dev?"
42.Cd "pcmcia* at pcic?"
43.Pp
44.Cd "# i386"
45.Cd "tcic0   at isa? port 0x240 iomem 0xd0000 iosiz 0x10000"
46.Cd "pcmcia* at tcic?"
47.Pp
48.Cd "# luna88k"
49.Cd "pcic0   at cbus? port 0x3e0 iomem 0xd0000 iosiz 0x10000"
50.Cd "pcmcia* at pcic?"
51.Pp
52.Cd "# sparc64"
53.Cd "stp*    at sbus?"
54.Cd "pcmcia* at stp?"
55.Pp
56.Cd "# all architectures"
57.Cd "cbb*      at pci?"
58.Cd "cardslot* at cbb? flags 0x0000"
59.Cd "pcmcia*   at cardslot?"
60.Sh DESCRIPTION
61The
62.Nm
63subsystem provides machine-independent bus support and
64drivers for PCMCIA (PC Card)
65devices.
66.Pp
67.Ox
68provides support for the following devices.
69Note that not all architectures support all devices.
70.Ss Serial interfaces and modems
71.Bl -tag -width 12n -offset ind -compact
72.It Xr com 4
73serial communications interface
74.El
75.Ss Wired network interfaces
76.Bl -tag -width 12n -offset ind -compact
77.It Xr ep 4
783Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
79.It Xr ne 4
80NE2000 and compatible 10/100 Ethernet device
81.It Xr sm 4
82SMC91C9x and SMC91C1xx-based 10/100 Ethernet device
83.It Xr xe 4
84Xircom-based 16-bit PCMCIA 10/100 Ethernet device
85.El
86.Ss Wireless network interfaces
87.Bl -tag -width 12n -offset ind -compact
88.It Xr an 4
89Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device
90.It Xr malo 4
91Marvell Libertas IEEE 802.11b/g wireless network device
92.It Xr wi 4
93WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network device
94.El
95.Ss SCSI controllers
96.Bl -tag -width 12n -offset ind -compact
97.It Xr aic 4
98Adaptec AIC-6260 and AIC-6360 SCSI interface
99.El
100.Ss IDE controllers
101.Bl -tag -width 12n -offset ind -compact
102.It Xr wdc 4
103WD100x compatible hard disk controller driver
104.El
105.Pp
106The supported PCMCIA controllers are those that are i82365 compatible.
107.Sh NOTES
108On some
109.Nm
110adapters, for instance the
111.Xr sbus 4 Ns -based
112.Xr stp 4 ,
113the
114.Nm
115bus will be mapped in big-endian format instead of the natural (and
116preferred) little endian format.
117Unfortunately such controllers lack the hardware facility to swap bytes,
118and it is not efficient to convert all drivers to always know about this.
119While 8 bit drivers can invisibly work on such a bus, 16 bit
120drivers will need modification to handle this.
121So far,
122.Xr wi 4
123is the only driver to require these modifications.
124.Pp
125If the
126.Nm
127adapter is not detected, or if
128.Nm
129events (such as card insertion) do not occur, there may be a
130.Tn PCI
131card BIOS mapped in the same memory space the
132.Nm
133driver is configured to use (this is often the case with Ethernet
134card boot ROMs).
135The output from
136.Xr dmesg 8
137should contain a line beginning with
138.Dq bios0
139that lists the memory address and size of mapped regions.
140If there is a conflict, you can use
141.Xr boot_config 8
142to change the iomem parameter of the
143.Em pcic
144device to a non-overlapping address, such as 0xd8000 for
145.Em pcic0 .
146Some experimentation may be required to find a working value; in some
147cases the size parameter of the
148.Em pcic
149device may need to be decreased to avoid a conflict.
150.Sh SEE ALSO
151.Xr cardbus 4 ,
152.Xr intro 4 ,
153.Xr isa 4
154.Sh HISTORY
155The
156.Nm
157driver
158appeared in
159.Ox 2.3 .
160