xref: /openbsd-src/share/man/man4/pcmcia.4 (revision f2da64fbbbf1b03f09f390ab01267c93dfd77c4c)
1.\"	$OpenBSD: pcmcia.4,v 1.64 2016/09/03 18:06:41 jmc 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: September 3 2016 $
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 "pcic*   at cbus?"
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 Miscellaneous
71.Bl -tag -width 12n -offset ind -compact
72.It Xr gpr 4
73GemPlus GPR400 smartcard reader
74.El
75.Ss Serial interfaces and modems
76.Bl -tag -width 12n -offset ind -compact
77.It Xr com 4
78serial communications interface
79.El
80.Ss Wired network interfaces
81.Bl -tag -width 12n -offset ind -compact
82.It Xr ep 4
833Com EtherLink III and Fast EtherLink III 10/100 Ethernet device
84.It Xr ne 4
85NE2000 and compatible 10/100 Ethernet device
86.It Xr sm 4
87SMC91C9x and SMC91C1xx-based 10/100 Ethernet device
88.It Xr xe 4
89Xircom-based 16-bit PCMCIA 10/100 Ethernet device
90.El
91.Ss Wireless network interfaces
92.Bl -tag -width 12n -offset ind -compact
93.It Xr an 4
94Aironet Communications 4500/4800 IEEE 802.11FH/b wireless network device
95.It Xr malo 4
96Marvell Libertas IEEE 802.11b/g wireless network device
97.It Xr wi 4
98WaveLAN/IEEE, PRISM 2-3, and Spectrum24 IEEE 802.11b wireless network device
99.El
100.Ss SCSI controllers
101.Bl -tag -width 12n -offset ind -compact
102.It Xr aic 4
103Adaptec AIC-6260 and AIC-6360 SCSI interface
104.El
105.Ss IDE controllers
106.Bl -tag -width 12n -offset ind -compact
107.It Xr wdc 4
108WD100x compatible hard disk controller driver
109.El
110.Pp
111The supported PCMCIA controllers are those that are i82365 compatible.
112.Sh NOTES
113On some
114.Nm
115adapters, for instance the
116.Xr sbus 4 Ns -based
117.Xr stp 4 ,
118the
119.Nm
120bus will be mapped in big-endian format instead of the natural (and
121preferred) little endian format.
122Unfortunately such controllers lack the hardware facility to swap bytes,
123and it is not efficient to convert all drivers to always know about this.
124While 8 bit drivers can invisibly work on such a bus, 16 bit
125drivers will need modification to handle this.
126So far,
127.Xr wi 4
128is the only driver to require these modifications.
129.Pp
130If the
131.Nm
132adapter is not detected, or if
133.Nm
134events (such as card insertion) do not occur, there may be a
135.Tn PCI
136card BIOS mapped in the same memory space the
137.Nm
138driver is configured to use (this is often the case with Ethernet
139card boot ROMs).
140The output from
141.Xr dmesg 8
142should contain a line beginning with
143.Dq bios0
144that lists the memory address and size of mapped regions.
145If there is a conflict, you can use
146.Xr boot_config 8
147to change the iomem parameter of the
148.Em pcic
149device to a non-overlapping address, such as 0xd8000 for
150.Em pcic0 .
151Some experimentation may be required to find a working value; in some
152cases the size parameter of the
153.Em pcic
154device may need to be decreased to avoid a conflict.
155.Sh SEE ALSO
156.Xr cardbus 4 ,
157.Xr intro 4 ,
158.Xr isa 4
159.Sh HISTORY
160The
161.Nm
162driver
163appeared in
164.Ox 2.3 .
165