1.\" $OpenBSD: we.4,v 1.16 2015/09/10 15:16:43 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: September 10 2015 $ 33.Dt WE 4 34.Os 35.Sh NAME 36.Nm we 37.Nd Western Digital/SMC WD80x3, SMC Elite Ultra, and SMC EtherEZ Ethernet device 38.Sh SYNOPSIS 39.Cd "we0 at isa? port 0x280 iomem 0xd0000 irq 9" 40.Cd "we1 at isa? port 0x300 iomem 0xcc000 irq 10" 41.Cd "we* at isapnp?" 42.Sh DESCRIPTION 43The 44.Nm 45device driver supports Western Digital/SMC WD80x3, SMC Elite Ultra, and 46SMC EtherEZ Ethernet cards. 47.Sh MEDIA SELECTION 48The ability to select media from software is dependent on the particular 49model of WD/SMC card. 50The following models support only manual configuration: WD8003S, WD8003E, 51and WD8013EBT. 52.Pp 53Other WD/SMC 80x3 interfaces support two types of media on a single card. 54All support the AUI media type. 55The other media is either BNC or UTP being a transceiver. 56Software cannot differentiate between BNC and UTP cards. 57On some models, the AUI port is always active. 58.Pp 59The SMC Elite Ultra and SMC EtherEZ interfaces support three media on 60a single card: AUI, BNC, and UTP. 61If the transceiver is active, the BNC media is selected. 62Otherwise, the AUI and UTP ports are both active. 63Cards of this vintage may also be found which lack one or two of the 64connectors. 65These cards also know what interrupt they are configured for, and will 66correct such problems (for further interrupt issues, see 67.Xr isa 4 68and 69.Xr pci 4 ) . 70.Pp 71The SMC EtherEZ does not yet work correctly in 72.Xr isapnp 4 73mode. 74The SMC Elite Ultra does not work in 75.Dq soft configuration 76mode. 77.Pp 78To enable the AUI media, select the 79.Em 10base5 80or 81.Em aui 82media type with 83.Xr ifconfig 8 Ns 's 84.Sq media 85directive. 86To select the other media (transceiver), select the 87.Em 10base2 88or 89.Em bnc 90media type. 91.Sh DIAGNOSTICS 92.Bl -diag 93.It "we0: overriding IRQ <n> to <m>" 94The IRQ specified in the kernel configuration file is different from that 95found in the card's configuration registers. 96The value in the kernel configuration file is being overridden by the one 97configured into the card. 98.It "we0: can't wildcard IRQ on a <model>" 99The IRQ was wildcarded in the kernel configuration file, and the card is 100a WD8003S, WD8003E, or WD8013EBT, which do not support software IRQ 101configuration. 102.It "we0: failed to clear shared memory at offset <off>" 103The memory test was unable to clear the interface's shared memory 104region. 105This often indicates that the card is configured at a conflicting 106.Em iomem 107address. 108.El 109.Sh SEE ALSO 110.Xr arp 4 , 111.Xr ifmedia 4 , 112.Xr intro 4 , 113.Xr isa 4 , 114.Xr isapnp 4 , 115.Xr netintro 4 , 116.Xr hostname.if 5 , 117.Xr ifconfig 8 118