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
|
<table class="head">
<tr>
<td class="head-ltitle">OTUS(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">OTUS(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">otus</code> — <span class="Nd">Atheros
AR9170 USB IEEE 802.11a/b/g/n 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">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 ehci</code>
<br/>
<code class="Cd">device uhci</code>
<br/>
<code class="Cd">device ohci</code>
<br/>
<code class="Cd">device usb</code>
<br/>
<code class="Cd">device otus</code>
<br/>
<code class="Cd">device wlan</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_otus_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">otus</code> driver supports USB 2.0 wireless
network devices based on the Atheros AR9170 chipset.</p>
<p class="Pp">The Atheros AR9170 is a draft-802.11n adapter that uses an
external radio to operate in either 2.4GHz only or 2.4GHz and 5GHz.</p>
<p class="Pp">The AR9101 radio supports 1T1R operation in 2GHz only.</p>
<p class="Pp">The AR9102 radio supports 2T2R operation in 2GHz only.</p>
<p class="Pp">The AR9104 radio supports 2T2R operation both 2GHz and 5GHz.</p>
<p class="Pp">These are the modes the <code class="Nm">otus</code> driver can
operate in:</p>
<dl class="Bl-tag">
<dt id="infrastructure">BSS mode</dt>
<dd>Also known as
<a class="permalink" href="#infrastructure"><i class="Em">infrastructure</i></a>
mode, this is used when associating with an access point, through which
all traffic passes. This mode is the default.</dd>
</dl>
<p class="Pp">The <code class="Nm">otus</code> driver can be configured to use
Wired Equivalent Privacy (WEP) or Wi-Fi Protected Access (WPA-PSK and
WPA2-PSK). WPA is the de facto encryption standard for wireless networks. It
is strongly recommended that WEP not be used as the sole mechanism to secure
wireless communication, due to serious weaknesses in it.</p>
<p class="Pp">The <code class="Nm">otus</code> driver can be configured at
runtime with <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">otus</code> driver provides support for
Atheros AR9170 USB IEEE 802.11b/g/n wireless network adapters,
including:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bd-indent Bl-compact">
<li>3Com 3CRUSBN275</li>
<li>Arcadyan WN7512</li>
<li>CACE AirPcap Nx</li>
<li>D-Link DWA-130 rev D1</li>
<li>D-Link DWA-160 rev A1</li>
<li>D-Link DWA-160 rev A2</li>
<li>IO-Data WN-GDN/US2</li>
<li>NEC Aterm WL300NU-G</li>
<li>Netgear WNDA3100</li>
<li>Netgear WN111 v2</li>
<li>Planex GW-US300</li>
<li>SMC Networks SMCWUSB-N2</li>
<li>TP-Link TL-WN821N v1, v2</li>
<li>Ubiquiti SR71 USB</li>
<li>Unex DNUA-81</li>
<li>Z-Com UB81</li>
<li>Z-Com UB82</li>
<li>ZyXEL NWD-271N</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<p class="Pp">The driver needs at least version 1.0 of the following firmware
files, which is loaded when an interface is attached:</p>
<p class="Pp"></p>
<div class="Bd-indent">
<dl class="Bl-tag Bl-compact">
<dt><span class="Pa">/boot/kernel/otusfw-init.ko</span></dt>
<dd style="width: auto;"> </dd>
<dt><span class="Pa">/boot/kernel/otusfw-main.ko</span></dt>
<dd style="width: auto;"> </dd>
</dl>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">Join an existing BSS network (i.e., connect to an access
point):</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev otus0
inet 192.0.2.20/24</code></div>
<p class="Pp">Join a specific BSS network with network name
<var class="Ar">my_net</var>:</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev otus0
ssid my_net up</code></div>
<p class="Pp">Join a specific BSS network with 64-bit WEP encryption:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan create wlandev otus0 ssid my_net \
wepmode on wepkey 0x1234567890 weptxkey 1 up</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
<dt>%s: failed load firmware of file otusfw-main</dt>
<dd>For some reason, the driver was unable to read the microcode file from the
filesystem. The file might be missing or corrupted.</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">intro(1)</a>, <a class="Xr">netintro(4)</a>,
<a class="Xr">otusfw(4)</a>, <a class="Xr">usb(4)</a>,
<a class="Xr">wlan(4)</a>, <a class="Xr">arp(8)</a>,
<a class="Xr">hostapd(8)</a>, <a class="Xr">ifconfig(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">otus</code> driver first appeared in
<span class="Ux">OpenBSD 4.6</span> and <span class="Ux">FreeBSD
11</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">otus</code> driver was written by
<span class="An">Damien Bergamini</span>
<<a class="Mt" href="mailto:damien@openbsd.org">damien@openbsd.org</a>>
and ported by <span class="An">Adrian Chadd</span>
<<a class="Mt" href="mailto:adrian@freebsd.org">adrian@freebsd.org</a>>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
<p class="Pp">The <code class="Nm">otus</code> driver only supports 802.11a/b/g
operations. 802.11n operation is not supported at this time.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 10, 2024</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
