1 .\" $NetBSD: stge.4,v 1.7 2003/02/14 15:20:20 grant Exp $
3 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
4 .\" All rights reserved.
6 .\" This code is derived from software contributed to The NetBSD Foundation
7 .\" by Jason R. Thorpe.
9 .\" Redistribution and use in source and binary forms, with or without
10 .\" modification, are permitted provided that the following conditions
12 .\" 1. Redistributions of source code must retain the above copyright
13 .\" notice, this list of conditions and the following disclaimer.
14 .\" 2. Redistributions in binary form must reproduce the above copyright
15 .\" notice, this list of conditions and the following disclaimer in the
16 .\" documentation and/or other materials provided with the distribution.
17 .\" 3. All advertising materials mentioning features or use of this software
18 .\" must display the following acknowledgement:
19 .\" This product includes software developed by the NetBSD
20 .\" Foundation, Inc. and its contributors.
21 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
22 .\" contributors may be used to endorse or promote products derived
23 .\" from this software without specific prior written permission.
25 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 .\" POSSIBILITY OF SUCH DAMAGE.
44 .Nd Sundance/Tamarack TC9021 Gigabit Ethernet adapter driver
46 To compile this driver into the kernel,
47 place the following lines in your
48 kernel configuration file:
49 .Bd -ragged -offset indent
54 Alternatively, to load the driver as a
55 module at boot time, place the following line in
57 .Bd -literal -offset indent
63 device driver provides support for various NICs based on the
64 Sundance/Tamarack TC9021 Gigabit Ethernet controller chip.
66 The Sundance/Tamarack TC9021 is found on the D-Link DGE-550T
67 and the Antares Microsystems Gigabit Ethernet board.
68 It uses an external PHY or an external 10-bit interface.
70 All NICs supported by the
72 driver have TCP/UDP/IP checksum offload for both receive and
73 transmit, hardware VLAN tag stripping/insertion features, and
74 receive interrupt moderation mechanism as well as a 64-bit
75 multicast hash filter.
76 The Sundance/Tamarack TC9021 supports TBI (ten bit interface)
77 and GMII transceivers, which means it can be used with either
78 copper or 1000baseX fiber applications.
80 The Sundance/Tamarack TC9021 also supports jumbo frames, which can be
81 configured via the interface MTU setting.
82 Selecting an MTU larger than 1500 bytes with the
84 utility configures the adapter to receive and transmit jumbo frames.
88 driver supports the following media types:
89 .Bl -tag -width ".Cm 10baseT/UTP"
91 Enable autoselection of the media type and options.
92 The user can manually override
93 the autoselected mode by adding media options to
100 option can also be used to select either
106 Set 100Mbps (Fast Ethernet) operation.
110 option can also be used to select either
116 Set 1000baseTX operation over twisted pair.
117 The Sundance/Tamarack supports 1000Mbps in
120 .\" .It Cm 1000baseSX
121 .\" Set 1000Mbps (Gigabit Ethernet) operation.
126 .\" modes are supported.
131 driver supports the following media options:
132 .Bl -tag -width ".Cm full-duplex"
134 Force full duplex operation.
136 Force half duplex operation.
139 For more information on configuring this device, see
144 driver provides support for various NICs based on the Sundance/Tamarack
145 TC9021 based Gigabit Ethernet controller chips, including:
149 Antares Microsystems Gigabit Ethernet
151 ASUS NX1101 Gigabit Ethernet
153 D-Link DL-4000 Gigabit Ethernet
155 IC Plus IP1000A Gigabit Ethernet
157 Sundance ST-2021 Gigabit Ethernet
159 Sundance ST-2023 Gigabit Ethernet
161 Sundance TC9021 Gigabit Ethernet
163 Tamarack TC9021 Gigabit Ethernet
166 The following variables are available as both
171 .Bl -tag -width indent
172 .It Va dev.stge.%d.rxint_nframe
173 Number of frames between RxDMAComplete interrupts.
174 The accepted range is 1 to 255, default value is 8 frames.
175 The interface has to be brought down and up again before a change takes effect.
176 .It Va dev.stge.%d.rxint_dmawait
177 Maximum amount of time to wait in 1us increments before issuing
178 an Rx interrupt if the number of frames received is less than
180 The accepted range is 0 to 4194, default value is 30 microseconds.
181 The interface has to be brought down and up again before a change takes effect.
195 driver was ported from
197 and first appeared in
201 version was written by
203 .Aq thorpej@NetBSD.org .
209 .Aq yongari@FreeBSD.org .