1.\" $OpenBSD: we.4,v 1.7 2001/10/05 14:45:53 mpech 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.\" 3. All advertising materials mentioning features or use of this software 20.\" must display the following acknowledgement: 21.\" This product includes software developed by the NetBSD 22.\" Foundation, Inc. and its contributors. 23.\" 4. Neither the name of The NetBSD Foundation nor the names of its 24.\" contributors may be used to endorse or promote products derived 25.\" from this software without specific prior written permission. 26.\" 27.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 28.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 29.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 30.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 31.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 32.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 33.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 34.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 35.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 36.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 37.\" POSSIBILITY OF SUCH DAMAGE. 38.\" 39.Dd September 22, 1998 40.Dt WE 4 41.Os 42.Sh NAME 43.Nm we 44.Nd device driver for Western Digital/SMC WD80x3, SMC Elite Ultra, 45and SMC EtherEZ Ethernet cards 46.Sh SYNOPSIS 47.Cd "we0 at isa? port 0x280 iomem 0xd0000 irq 9" 48.Cd "we1 at isa? port 0x300 iomem 0xcc000 irq 10" 49.Cd "we* at isapnp?" 50.Sh DESCRIPTION 51The 52.Nm 53device driver supports Western Digital/SMC WD80x3, SMC Elite Ultra, and 54SMC EtherEZ Ethernet cards. 55.Sh MEDIA SELECTION 56The ability to select media from software is dependent on the particular 57model of WD/SMC card. 58The following models support only manual configuration: WD8003S, WD8003E, 59and WD8013EBT. 60.Pp 61Other WD/SMC 80x3 interfaces support two types of media on a single card. 62All support the AUI media type. 63The other media is either BNC or UTP being a transceiver. 64Software cannot differentiate between BNC and UTP cards. 65On some models, the AUI port is always active. 66.Pp 67The SMC Elite Ultra and SMC EtherEZ interfaces support three media on 68a single card: AUI, BNC, and UTP. 69If the transceiver is active, the BNC media is selected. 70Otherwise, the AUI and UTP ports are both active. 71Cards of this vintage may also be found which lack one or two of the 72connectors. 73These cards also know what interrupt they are configured for, and will 74correct such problems (for further interrupt issues, see 75.Xr isa 4 76and 77.Xr pci 4 ) . 78.Pp 79The SMC EtherEZ does not yet work correctly in 80.Xr isapnp 4 81mode. 82The SMC Elite Ultra does not work in 83.Dq soft configuration 84mode. 85.Pp 86.Pp 87To enable the AUI media, select the 88.Em 10base5 89or 90.Em aui 91media type with 92.Xr ifconfig 8 's 93.Sq media 94directive. 95To select the other media (transceiver), select the 96.Em 10base2 97or 98.Em bnc 99media type. 100.Sh DIAGNOSTICS 101.Bl -diag 102.It "we0: overriding IRQ <n> to <m>" 103The IRQ specified in the kernel configuration file is different from that 104found in the card's configuration registers. 105The value in the kernel configuration file is being overridden by the one 106configured into the card. 107.It "we0: can't wildcard IRQ on a <model>" 108The IRQ was wildcarded in the kernel configuration file, and the card is 109a WD8003S, WD8003E, or WD8013EBT, which do not support software IRQ 110configuration. 111.It "we0: failed to clear shared memory at offset <off>" 112The memory test was unable to clear shared the interface's shared memory 113region. 114This often indicates that the card is configured at a conflicting 115.Em iomem 116address. 117.El 118.Sh SEE ALSO 119.Xr ifmedia 4 , 120.Xr intro 4 , 121.Xr isa 4 , 122.Xr isapnp 4 , 123.Xr ifconfig 8 124