xref: /netbsd-src/share/man/man4/we.4 (revision 2a399c6883d870daece976daec6ffa7bb7f934ce)
1.\"	$NetBSD: we.4,v 1.2 1997/11/11 05:11:30 thorpej Exp $
2.\"
3.\" Copyright (c) 1997 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 October 20, 1997
39.Dt WE 4
40.Os NetBSD
41.Sh NAME
42.Nm we
43.Nd device driver for Western Digital/SMC WD80x3, SMC Elite Ultra,
44and SMC EtherEZ Ethernet cards
45.Sh SYNOPSIS
46.Cd "we0 at isa? port 0x280 iomem 0xd0000 irq 9"
47.Cd "we1 at isa? port 0x300 iomem 0xcc000 irq 10"
48.Sh DESCRIPTION
49The
50.Nm
51device driver supports Western Digital/SMC WD80x3, SMC Elite Ultra, and
52SMC EtherEZ Ethernet cards.
53.Sh MEDIA SELECTION
54The ability to select media from software is dependent on the particular
55model of WD/SMC card.  The following models support only manual configuration:
56WD8003S, WD8003E, and WD8013EBT.
57.Pp
58Other WD/SMC 80x3 interfaces support two types of media on a single card.
59All support the AUI media type.  The other media is either BNC or UTP
60beind a transciever.  Sofware cannot differentiate between BNC and UTP
61cards.  On some models, the AUI port is always active.
62.Pp
63The SMC Elite Ultra and SMC EtherEZ interfaces support three media
64a single card: AUI, BNC, and UTP.  If the transciever is active, the BNC
65media is selected.  Otherwise, the AUI and UTP ports are both active.
66.Pp
67To enable the AUI media, select the
68.Em 10base5
69or
70.Em aui
71media type with
72.Xr ifconfig 8 's
73.Sq media
74directive.  To select the other media (transciever), select the
75.Em 10base2
76or
77.Em bnc
78media type.
79.Sh DIAGNOSTICS
80.Bl -diag
81.It "we0: overriding IRQ <n> to <m>"
82The IRQ specified in the kernel configuration file is different from that
83found in the card's configuration registers.  The value in the kernel
84configuration file is being overridden by the one configured into the card.
85.It "we0: can't wildcard IRQ on a <model>"
86The IRQ was wildcarded in the kernel configuration file, and the card is
87a WD8003S, WD8003E, or WD8013EBT, which do not support software IRQ
88configuration.
89.It "we0: failed to clear shared memory at offset <off>"
90The memory test was unable to clear shared the interface's shared memory
91region.  This often indicates that the card is configured at a conflicting
92.Em iomem
93address.
94.El
95.Sh SEE ALSO
96.Xr ifconfig 8 ,
97.Xr intro 4 ,
98.Xr isa 4
99