1.\" $NetBSD: fxp.4,v 1.10 2002/04/05 20:01:41 thorpej Exp $ 2.\" 3.\" Copyright (c) 1998, 2002 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility, 8.\" NASA Ames Research Center. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 3. All advertising materials mentioning features or use of this software 19.\" must display the following acknowledgement: 20.\" This product includes software developed by the NetBSD 21.\" Foundation, Inc. and its contributors. 22.\" 4. Neither the name of The NetBSD Foundation nor the names of its 23.\" contributors may be used to endorse or promote products derived 24.\" from this software without specific prior written permission. 25.\" 26.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 27.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 28.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 29.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 30.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 31.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 32.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 33.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 34.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 35.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 36.\" POSSIBILITY OF SUCH DAMAGE. 37.\" 38.Dd April 5, 2002 39.Dt FXP 4 40.Os 41.Sh NAME 42.Nm fxp 43.Nd Intel i8255x 10/100 Ethernet device driver 44.Sh SYNOPSIS 45.Cd "fxp* at cardbus? dev ? function ?" 46.Cd "fxp* at pci? dev ? function ?" 47.Sh DESCRIPTION 48The 49.Nm 50device driver supports Ethernet interfaces based on the Intel i82557, 51i82558, i82559, and i82550 10/100 PCI Ethernet chips. 52.Pp 53Certain versions of the i8255x support loading microcode which implements 54a receive interrupt mitigation function, known as 55.Dq CPUSaver . 56Use of this option can improve performance in some situations by reducing 57interrupt load on the host. This option is available on the following 58chip versions: 59.Pp 60.Bl -bullet -compact 61.It 62i82558 step A4 (rev 4) 63.It 64i82558 step B0 (rev 5) 65.It 66i82559 step A0 (rev 8) 67.It 68i82559S step A (rev 9) 69.It 70i82550 (rev 12) 71.It 72i82550 step C (rev 13) 73.El 74.Pp 75This option is enabled by setting the 76.Dq link0 77option with 78.Xr ifconfig 8 . 79.Sh HARDWARE 80Cards supported by the 81.Nm 82driver include: 83.Pp 84.Bl -bullet -compact 85.It 86Intel EtherExpress Pro 10+ 87.It 88Intel EtherExpress Pro 100B 89.It 90Intel EtherExpress Pro 100+ 91.It 92Intel InBusiness 10/100 93.It 94Intel PRO/100 S 95.El 96.Sh MEDIA SELECTION 97Media selection is supported via MII. See 98.Xr ifmedia 4 99and 100.Xr mii 4 101for more information. 102.Pp 103EtherExpress Pro 10+ boards may use a Seeq 80c24 AutoDUPLEX(tm) 104media interface. Boards with these chips do not support media 105selection, as the 80c24 has no programming interface, and no 106way to read link status. These boards claim a media of "manual" 107since they self-configure based on the configuration of the link 108partner (hub or switch). 109.Pp 110.Sh DIAGNOSTICS 111.Bl -diag 112.It "fxp0: WARNING: SCB timed out!" 113The driver timed out waiting for the chip's command interface to 114become ready. 115.It "fxp0: too many segments, aborting" 116The driver encountered a packet that included too many DMA segments, 117and was not able to allocate a new buffer to transmit the packet from. 118The packet has been dropped. 119.It "fxp0: too many segments, retrying" 120The driver encountered a packet that included too many DMA segments, 121and allocated a new buffer to transmit the packet from. 122.It "fxp0: can't load mbuf chain, error = %d" 123The driver was unable to load a transmit DMA map, and has reported the 124errno value. 125.It "fxp0: device timeout" 126The device failed to generate a transmit complete interrupt for the 127last packet transmitted. The device has been reset. 128.It "fxp0: can't load rx buffer, error = %d" 129The driver was unable to load the DMA map for a receive buffer, and 130has reported the errno value. This error is currently fatal, and will 131panic the system. 132.It "fxp0: fxp_mdi_read: timed out" 133The MDIO failed to become ready during an MII read operation. 134.It "fxp0: fxp_mdi_write: timed out" 135The MDIO failed to become ready during an MII write operation. 136.El 137.Sh SEE ALSO 138.Xr cardbus 4 , 139.Xr ifmedia 4 , 140.Xr intro 4 , 141.Xr mii 4 , 142.Xr pci 4 , 143.Xr ifconfig 8 144