static/freebsd/man4/mtw.4 4.html


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

<table class="head">
  <tr>
    <td class="head-ltitle">MTW(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">MTW(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">mtw</code> &#x2014; <span class="Nd">MediaTek
    MT7601U USB IEEE 802.11n wireless network driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">device usb</code>
  <br/>
  <code class="Cd">device mtw</code>
  <br/>
  <code class="Cd">device wlan</code></p>
<p class="Pp">In <a class="Xr">rc.conf(5)</a>:
  <br/>
  <code class="Cd">kld_list=&quot;if_mtw&quot;</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This module provides support for MediaTek MT7601U USB wireless
    network adapters. If the appropriate hardware is detected, the driver will
    be automatically loaded with <a class="Xr">devmatch(8)</a>. If driver
    autoloading is explicitly disabled, enable the module in
    <a class="Xr">rc.conf(5)</a>. The <code class="Nm">mtw</code> driver can be
    configured at runtime with <a class="Xr">ifconfig(8)</a> or at boot with
    <a class="Xr">rc.conf(5)</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">mtw</code> driver supports MediaTek MT7601U
    based USB wireless network adapters including (but not all of them
  tested):</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
  <li>ASUS USB-N10 v2</li>
  <li>D-Link DWA-127 rev B1</li>
  <li>Edimax EW-7711UAn v2</li>
  <li>Foxconn WFU03</li>
  <li>Tenda U2</li>
  <li>Tenda W311MI v2</li>
  <li>TP-LINK TL-WN727N v4 (tested working)</li>
  <li>Yealink WF40</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<p class="Pp">The <code class="Nm">mtw</code> driver requires firmware from
    <span class="Pa">ports/net/wifi-firmware-mt7601u-kmod</span>. This firmware
    package will be installed automatically with <a class="Xr">fwget(8)</a> if
    the appropriate hardware is detected at installation or runtime.</p>
</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">usb(4)</a>, <a class="Xr">wlan(4)</a>,
    <a class="Xr">networking(7)</a>, <a class="Xr">fwget(8)</a>,
    <a class="Xr">wpa_supplicant(8)</a></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">mtw</code> driver first appeared in
    <span class="Ux">OpenBSD 7.1</span> and <span class="Ux">FreeBSD
    15.0</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">mtw</code> driver was written by
    <span class="An">James Hastings</span>
    &lt;<a class="Mt" href="mailto:hastings@openbsd.org">hastings@openbsd.org</a>&gt;
    and ported to <span class="Ux">FreeBSD</span> by <span class="An">Jesper
    Schmitz Mouridsen</span>
    &lt;<a class="Mt" href="mailto:jsm@FreeBSD.org">jsm@FreeBSD.org</a>&gt;.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp"><code class="Nm">mtw</code> only works in
    <code class="Cm">station</code> mode and <code class="Cm">monitor</code>
    mode. The firmware does not always reinitialize when reloading the module,
    or when rebooting, without first unplugging the device.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">May 3, 2025</td>
    <td class="foot-os">FreeBSD 15.0</td>
  </tr>
</table>