1.\" $OpenBSD: we.4,v 1.15 2011/12/03 23:01:21 schwarze Exp $ 2.\" $NetBSD: we.4,v 1.4 1998/08/09 00:39:02 thorpej Exp $ 3.\" 4.\" Copyright (c) 1997 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" This code is derived from software contributed to The NetBSD Foundation 8.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility, 9.\" NASA Ames Research Center. 10.\" 11.\" Redistribution and use in source and binary forms, with or without 12.\" modification, are permitted provided that the following conditions 13.\" are met: 14.\" 1. Redistributions of source code must retain the above copyright 15.\" notice, this list of conditions and the following disclaimer. 16.\" 2. Redistributions in binary form must reproduce the above copyright 17.\" notice, this list of conditions and the following disclaimer in the 18.\" documentation and/or other materials provided with the distribution. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 21.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 22.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 23.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 24.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30.\" POSSIBILITY OF SUCH DAMAGE. 31.\" 32.Dd $Mdocdate: December 3 2011 $ 33.Dt WE 4 34.Os 35.Sh NAME 36.Nm we 37.Nd Western Digital/SMC WD80x3, SMC Elite Ultra, 38and SMC EtherEZ Ethernet device 39.Sh SYNOPSIS 40.Cd "we0 at isa? port 0x280 iomem 0xd0000 irq 9" 41.Cd "we1 at isa? port 0x300 iomem 0xcc000 irq 10" 42.Cd "we* at isapnp?" 43.Sh DESCRIPTION 44The 45.Nm 46device driver supports Western Digital/SMC WD80x3, SMC Elite Ultra, and 47SMC EtherEZ Ethernet cards. 48.Sh MEDIA SELECTION 49The ability to select media from software is dependent on the particular 50model of WD/SMC card. 51The following models support only manual configuration: WD8003S, WD8003E, 52and WD8013EBT. 53.Pp 54Other WD/SMC 80x3 interfaces support two types of media on a single card. 55All support the AUI media type. 56The other media is either BNC or UTP being a transceiver. 57Software cannot differentiate between BNC and UTP cards. 58On some models, the AUI port is always active. 59.Pp 60The SMC Elite Ultra and SMC EtherEZ interfaces support three media on 61a single card: AUI, BNC, and UTP. 62If the transceiver is active, the BNC media is selected. 63Otherwise, the AUI and UTP ports are both active. 64Cards of this vintage may also be found which lack one or two of the 65connectors. 66These cards also know what interrupt they are configured for, and will 67correct such problems (for further interrupt issues, see 68.Xr isa 4 69and 70.Xr pci 4 ) . 71.Pp 72The SMC EtherEZ does not yet work correctly in 73.Xr isapnp 4 74mode. 75The SMC Elite Ultra does not work in 76.Dq soft configuration 77mode. 78.Pp 79To enable the AUI media, select the 80.Em 10base5 81or 82.Em aui 83media type with 84.Xr ifconfig 8 Ns 's 85.Sq media 86directive. 87To select the other media (transceiver), select the 88.Em 10base2 89or 90.Em bnc 91media type. 92.Sh DIAGNOSTICS 93.Bl -diag 94.It "we0: overriding IRQ <n> to <m>" 95The IRQ specified in the kernel configuration file is different from that 96found in the card's configuration registers. 97The value in the kernel configuration file is being overridden by the one 98configured into the card. 99.It "we0: can't wildcard IRQ on a <model>" 100The IRQ was wildcarded in the kernel configuration file, and the card is 101a WD8003S, WD8003E, or WD8013EBT, which do not support software IRQ 102configuration. 103.It "we0: failed to clear shared memory at offset <off>" 104The memory test was unable to clear the interface's shared memory 105region. 106This often indicates that the card is configured at a conflicting 107.Em iomem 108address. 109.El 110.Sh SEE ALSO 111.Xr arp 4 , 112.Xr ifmedia 4 , 113.Xr intro 4 , 114.Xr isa 4 , 115.Xr isapnp 4 , 116.Xr netintro 4 , 117.Xr hostname.if 5 , 118.Xr ifconfig 8 119