1.\" $NetBSD: cardbus.4,v 1.24 2005/09/09 14:03:51 drochner Exp $ 2.\" 3.\" Copyright (c) 1999-2005 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.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgement: 19.\" This product includes software developed by the NetBSD 20.\" Foundation, Inc. and its contributors. 21.\" 4. Neither the name of The NetBSD Foundation nor the names of its 22.\" contributors may be used to endorse or promote products derived 23.\" from this software without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35.\" POSSIBILITY OF SUCH DAMAGE. 36.\" 37.Dd September 9, 2005 38.Dt CARDBUS 4 39.Os 40.Sh NAME 41.Nm cardbus , 42.Nm cardslot , 43.Nm cbb 44.Nd CardBus driver 45.Sh SYNOPSIS 46.Cd "cbb* at pci? dev? function ?" 47.Cd "cardslot* at cbb?" 48.Cd "cardbus* at cardslot?" 49.Cd "pcmcia* at cardslot?" 50.Cd "XX* at cardbus? function ?" 51.Sh DESCRIPTION 52.Nx 53provides machine-independent bus support and 54drivers for CardBus devices. 55.Pp 56The 57.Cm cbb 58device represents the CardBus controller. 59Each controller has a number 60of slots, represented by the 61.Cm cardslot 62devices. A slot can have either a CardBus card or a 63.Tn PCMCIA 64card, which are attached with the 65.Cm cardbus 66or 67.Cm pcmcia 68devices, respectively. 69.Sh SUPPORTED DEVICES 70.Nx 71includes the following machine-independent CardBus 72drivers, sorted by function and driver name: 73.Ss Network interfaces 74.Bl -tag -width speaker -offset indent -compact 75.It ex 763Com 3c575TX and 3c575BTX 77.It fxp 78Intel i8255x 79.It rtk 80Realtek 8129/8139 81.It tlp 82DECchip 21143 83.El 84.Ss Serial interfaces 85.Bl -tag -width speaker -offset indent -compact 86.It com 87Modems and serial cards 88.El 89.Ss SCSI controllers 90.Bl -tag -width speaker -offset indent -compact 91.It adv 92AdvanSys 1200[A,B], 9xx[U,UA] 93.It ahc 94Adaptec ADP-1480 95.El 96.Ss USB controllers 97.Bl -tag -width speaker -offset indent -compact 98.It ehci 99Enhanced Host Controller (2.0) 100.It ohci 101Open Host Controller 102.It uhci 103Universal Host Controller 104.El 105.Ss IEEE1394 controllers 106.Bl -tag -width speaker -offset indent -compact 107.It fwohci 108OHCI controller 109.El 110.Sh DIAGNOSTICS 111.Nm cbb 112devices may not be properly handled by the system BIOS on i386-family 113systems. 114If, on an i386-family system, the 115.Nm cbb 116driver reports 117.Dl cbb0: NOT USED because of unconfigured interrupt 118then enabling 119.Bl -item -offset indent -compact 120.It 121.Cd options PCI_ADDR_FIXUP 122.It 123.Cd options PCI_BUS_FIXUP 124.It 125.Cd options PCI_INTR_FIXUP 126.El 127in the kernel configuration might be of use. 128.Sh SEE ALSO 129.Xr adv 4 , 130.Xr ahc 4 , 131.Xr com 4 , 132.Xr ehci 4 , 133.Xr ex 4 , 134.Xr fxp 4 , 135.Xr ohci 4 , 136.Xr options 4 , 137.Xr pci 4 , 138.Xr pcmcia 4 , 139.Xr rtk 4 , 140.Xr tlp 4 , 141.Xr uhci 4 142.Sh HISTORY 143The 144.Nm 145driver appeared in 146.Nx 1.5 . 147.Sh BUGS 148.Ss Memory space conflicts 149.Nx 150maps memory on Cardbus and PCMCIA cards in order to access the cards 151(including reading CIS tuples on PCMCIA cards) 152and access the devices using the 153.Tn RBUS 154abstraction. 155When the mapping does not work, PCMCIA cards are typically ignored on 156insert, and Cardbus cards are recognized but nonfunctional. 157The location is machine-specific, and the default location does not 158work on all hardware. 159On i386, the following kernel configuration line, which maps Cardbus 160space at 512M rather than 1GB, has been found to make Cardbus support 161(including PCMCIA attachment under a cbb) work on some notebook 162models, including the IBM Thinkpad 600E (2645-4AU) and the Compaq 163ARMADA M700: 164.Pp 165.Cd options RBUS_MIN_START="0x20000000" 166