1.\" $OpenBSD: we.4,v 1.5 2001/03/01 16:11:20 aaron 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. The following models support only manual configuration: 58WD8003S, WD8003E, and WD8013EBT. 59.Pp 60Other WD/SMC 80x3 interfaces support two types of media on a single card. 61All support the AUI media type. The other media is either BNC or UTP 62being a transceiver. Software cannot differentiate between BNC and UTP 63cards. On some models, the AUI port is always active. 64.Pp 65The SMC Elite Ultra and SMC EtherEZ interfaces support three media on 66a single card: AUI, BNC, and UTP. If the transceiver is active, the BNC 67media is selected. Otherwise, the AUI and UTP ports are both active. 68Cards of this vintage may also be found which lack one or two of the 69connectors. These cards also know what interrupt they are configured 70for, and will correct such problems (for further interrupt issues, see 71.Xr isa 4 72and 73.Xr pci 4 ). 74.Pp 75The SMC EtherEZ does not yet work correctly in 76.Xr isapnp 4 77mode. 78The SMC Elite Ultra does not work in 79.Dq soft configuration 80mode. 81.Pp 82.Pp 83To enable the AUI media, select the 84.Em 10base5 85or 86.Em aui 87media type with 88.Xr ifconfig 8 's 89.Sq media 90directive. To select the other media (transceiver), select the 91.Em 10base2 92or 93.Em bnc 94media type. 95.Sh DIAGNOSTICS 96.Bl -diag 97.It "we0: overriding IRQ <n> to <m>" 98The IRQ specified in the kernel configuration file is different from that 99found in the card's configuration registers. The value in the kernel 100configuration file is being overridden by the one configured into the card. 101.It "we0: can't wildcard IRQ on a <model>" 102The IRQ was wildcarded in the kernel configuration file, and the card is 103a WD8003S, WD8003E, or WD8013EBT, which do not support software IRQ 104configuration. 105.It "we0: failed to clear shared memory at offset <off>" 106The memory test was unable to clear shared the interface's shared memory 107region. This often indicates that the card is configured at a conflicting 108.Em iomem 109address. 110.El 111.Sh SEE ALSO 112.Xr ifmedia 4 , 113.Xr intro 4 , 114.Xr isa 4 , 115.Xr isapnp 4 , 116.Xr ifconfig 8 117