1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
<table class="head">
<tr>
<td class="head-ltitle">NGE(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">NGE(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">nge</code> — <span class="Nd">National
Semiconductor PCI Gigabit Ethernet adapter driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device miibus</code>
<br/>
<code class="Cd">device nge</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>if_nge_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">nge</code> driver provides support for
various NICs based on the National Semiconductor DP83820 and DP83821 Gigabit
Ethernet controller chips.</p>
<p class="Pp">The DP83820 supports TBI (ten bit interface) and GMII
transceivers, which means it can be used with either copper or 1000baseX
fiber applications. The DP83820 supports TCP/IP checksum offload and VLAN
tagging/insertion as well as a 2048-bit multicast hash filter and up to 4
pattern match buffers.</p>
<p class="Pp">Most cards also use the DP83861 10/100/1000 copper gigabit
transceiver chip, which supports autonegotiation of 10, 100 and 1000Mbps
modes in full or half duplex.</p>
<p class="Pp">The DP83820 and DP83821 also support jumbo frames, which can be
configured via the interface MTU setting. Selecting an MTU larger than 1500
bytes with the <a class="Xr">ifconfig(8)</a> utility configures the adapter
to receive and transmit jumbo frames. Using jumbo frames can greatly improve
performance for certain tasks, such as file transfers and data
streaming.</p>
<p class="Pp">The <code class="Nm">nge</code> driver supports the following
media types:</p>
<dl class="Bl-tag">
<dt id="autoselect"><a class="permalink" href="#autoselect"><code class="Cm">autoselect</code></a></dt>
<dd>Enable autoselection of the media type and options. The user can manually
override the autoselected mode by adding media options to
<a class="Xr">rc.conf(5)</a>.</dd>
<dt id="10baseT/UTP"><a class="permalink" href="#10baseT/UTP"><code class="Cm">10baseT/UTP</code></a></dt>
<dd>Set 10Mbps operation. The <a class="Xr">ifconfig(8)</a>
<code class="Ic">mediaopt</code> option can also be used to select either
<code class="Cm">full-duplex</code> or <code class="Cm">half-duplex</code>
modes.</dd>
<dt id="100baseTX"><a class="permalink" href="#100baseTX"><code class="Cm">100baseTX</code></a></dt>
<dd>Set 100Mbps (Fast Ethernet) operation. The <a class="Xr">ifconfig(8)</a>
<code class="Ic">mediaopt</code> option can also be used to select either
<code class="Cm">full-duplex</code> or <code class="Cm">half-duplex</code>
modes.</dd>
<dt id="1000baseTX"><a class="permalink" href="#1000baseTX"><code class="Cm">1000baseTX</code></a></dt>
<dd>Set 1000baseTX operation over twisted pair.
<code class="Cm">full-duplex</code> and
<code class="Cm">half-duplex</code> modes are supported.</dd>
<dt id="1000baseSX"><a class="permalink" href="#1000baseSX"><code class="Cm">1000baseSX</code></a></dt>
<dd>Set 1000Mbps (Gigabit Ethernet) operation. Both
<code class="Cm">full-duplex</code> and
<code class="Cm">half-duplex</code> modes are supported.</dd>
</dl>
<p class="Pp">The <code class="Nm">nge</code> driver supports the following
media options:</p>
<dl class="Bl-tag">
<dt id="full-duplex"><a class="permalink" href="#full-duplex"><code class="Cm">full-duplex</code></a></dt>
<dd>Force full duplex operation.</dd>
<dt id="half-duplex"><a class="permalink" href="#half-duplex"><code class="Cm">half-duplex</code></a></dt>
<dd>Force half duplex operation.</dd>
</dl>
<p class="Pp">For more information on configuring this device, see
<a class="Xr">ifconfig(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">nge</code> driver supports National
Semiconductor DP83820 and DP83821 based Gigabit Ethernet adapters
including:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
<li>Addtron AEG320T</li>
<li>Ark PC SOHO-GA2500T (32-bit PCI) and SOHO-GA2000T (64-bit PCI)</li>
<li>Asante FriendlyNet GigaNIX 1000TA and 1000TPC</li>
<li>D-Link DGE-500T</li>
<li>Linksys EG1032, revision 1</li>
<li>Netgear GA621</li>
<li>Netgear GA622T</li>
<li>SMC EZ Card 1000 (SMC9462TX)</li>
<li>Surecom Technology EP-320G-TX</li>
<li>Trendware TEG-PCITX (32-bit PCI) and TEG-PCITX2 (64-bit PCI)</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL
VARIABLES</a></h1>
<p class="Pp">The following variables are available as both
<a class="Xr">sysctl(8)</a> variables and <a class="Xr">loader(8)</a>
tunables:</p>
<dl class="Bl-tag">
<dt id="dev.nge._d.int_holdoff"><var class="Va">dev.nge.%d.int_holdoff</var></dt>
<dd>Maximum amount of time to delay interrupt processing in units of 100us.
The accepted range is 0 to 255, the default is 1(100us). Value 0
completely disables the interrupt moderation. The interface has to be
brought down and up again before a change takes effect.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
<dt>nge%d: couldn't map memory</dt>
<dd>A fatal initialization error has occurred.</dd>
<dt>nge%d: couldn't map ports</dt>
<dd>A fatal initialization error has occurred.</dd>
<dt>nge%d: couldn't map interrupt</dt>
<dd>A fatal initialization error has occurred.</dd>
<dt>nge%d: no memory for softc struct!</dt>
<dd>The driver failed to allocate memory for per-device instance information
during initialization.</dd>
<dt>nge%d: failed to enable memory mapping!</dt>
<dd>The driver failed to initialize PCI shared memory mapping. This might
happen if the card is not in a bus-master slot.</dd>
<dt>nge%d: no memory for jumbo buffers!</dt>
<dd>The driver failed to allocate memory for jumbo frames during
initialization.</dd>
<dt>nge%d: watchdog timeout</dt>
<dd>The device has stopped responding to the network, or there is a problem
with the network connection (cable).</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">altq(4)</a>, <a class="Xr">arp(4)</a>,
<a class="Xr">miibus(4)</a>, <a class="Xr">netintro(4)</a>,
<a class="Xr">ng_ether(4)</a>, <a class="Xr">polling(4)</a>,
<a class="Xr">vlan(4)</a>, <a class="Xr">ifconfig(8)</a></p>
<p class="Pp"><cite class="Rs"><span class="RsT">National Semiconductor DP83820
datasheet</span>.</cite></p>
<p class="Pp"><cite class="Rs"><span class="RsT">National Semiconductor DP83861
datasheet</span>.</cite></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">nge</code> device driver first appeared in
<span class="Ux">FreeBSD 4.4</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">nge</code> driver was written by
<span class="An">Bill Paul</span>
<<a class="Mt" href="mailto:wpaul@bsdi.com">wpaul@bsdi.com</a>>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 23, 2010</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
