1.\" $OpenBSD: run.4,v 1.52 2018/07/15 10:44:49 phessler Exp $ 2.\" 3.\" Copyright (c) 2008 Damien Bergamini <damien.bergamini@free.fr> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: July 15 2018 $ 18.Dt RUN 4 19.Os 20.Sh NAME 21.Nm run 22.Nd Ralink Technology/MediaTek USB IEEE 802.11a/b/g/n wireless network device 23.Sh SYNOPSIS 24.Cd "run* at uhub? port ?" 25.Sh DESCRIPTION 26The 27.Nm 28driver supports USB 2.0 wireless adapters based on the Ralink RT2700U, 29RT2800U, RT3000U and RT3900E chipsets. 30.Pp 31The RT2700U chipset consists of two integrated chips, an RT2770 MAC/BBP and 32an RT2720 (1T2R) or RT2750 (dual-band 1T2R) radio transceiver. 33.Pp 34The RT2800U chipset consists of two integrated chips, an RT2870 MAC/BBP and 35an RT2820 (2T3R) or RT2850 (dual-band 2T3R) radio transceiver. 36.Pp 37The RT3000U is a single-chip solution based on an RT3070 MAC/BBP and 38an RT3020 (1T1R), RT3021 (1T2R), RT3022 (2T2R) or RT3052 (dual-band 2T2R) 39radio transceiver. 40.Pp 41The RT3900E is a single-chip solution based on an RT3593, RT5390, 42RT5392 or an RT5592 MAC/BBP and an RT3053 (dual-band 3T3R), 43RT5370 (1T1R), RT5372 (2T2R), or RT5572 (dual-band 2T2R) 44radio transceiver. 45.Pp 46These are the modes the 47.Nm 48driver can operate in: 49.Bl -tag -width "IBSS-masterXX" 50.It BSS mode 51Also known as 52.Em infrastructure 53mode, this is used when associating with an access point, through 54which all traffic passes. 55This mode is the default. 56.It monitor mode 57In this mode the driver is able to receive packets without 58associating with an access point. 59This disables the internal receive filter and enables the card to 60capture packets from networks which it wouldn't normally have access to, 61or to scan for access points. 62.El 63.Pp 64The 65.Nm 66driver can be configured to use 67Wired Equivalent Privacy (WEP) or 68Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). 69WPA is the current encryption standard for wireless networks. 70It is strongly recommended that WEP 71not be used as the sole mechanism 72to secure wireless communication, 73due to serious weaknesses in it. 74The 75.Nm 76driver offloads both encryption and decryption of data frames to the 77hardware for the WEP40, WEP104, TKIP(+MIC) and CCMP ciphers. 78.Pp 79The 80.Nm 81driver can be configured at runtime with 82.Xr ifconfig 8 83or on boot with 84.Xr hostname.if 5 . 85.Sh FILES 86The driver needs the following firmware files, 87which are loaded when an interface is brought up: 88.Pp 89.Bl -tag -width Ds -offset indent -compact 90.It /etc/firmware/run-rt2870 91.It /etc/firmware/run-rt3071 92.El 93.Sh HARDWARE 94The following adapters should work: 95.Pp 96.Bl -tag -width Ds -offset indent -compact 97.It Airlink101 AWLL6090 98.It ASUS USB-N11 99.It ASUS USB-N13 ver. A1 100.It ASUS USB-N53 101.It ASUS USB-N66 102.It ASUS WL-160N 103.It Belkin F5D8051 ver 3000 104.It Belkin F5D8053 105.It Belkin F5D8055 106.It Belkin F6D4050 ver 1 107.It Belkin F6D4050 ver 2 108.It Belkin F7D1101 ver 2 109.It Belkin F9L1103 110.It Buffalo WLI-UC-AG300N 111.It Buffalo WLI-UC-G300N 112.It Buffalo WLI-UC-G301N 113.It Buffalo WLI-UC-GN 114.It Buffalo WLI-UC-GNHP 115.It Buffalo WLI-UC-GNM 116.It Buffalo WLI-UC-GNM2 117.It Cisco AM10 118.It Corega CG-WLUSB2GNL 119.It Corega CG-WLUSB2GNR 120.It Corega CG-WLUSB300AGN 121.It Corega CG-WLUSB300GNM 122.It D-Link DWA-125 rev B2 123.It D-Link DWA-127 124.It D-Link DWA-130 rev B1, F1 125.It D-Link DWA-140 rev B1, B2, B3, \&D1 126.It D-Link DWA-160 rev B2 127.It D-Link DWA-162 128.It DrayTek Vigor N61 129.It Edimax EW-7711UAn 130.It Edimax EW-7711USn 131.It Edimax EW-7711UTn 132.It Edimax EW-7717Un 133.It Edimax EW-7718Un 134.It Edimax EW-7722UTn 135.It Edimax EW-7733UnD 136.It Gigabyte GN-WB30N 137.It Gigabyte GN-WB31N 138.It Gigabyte GN-WB32L 139.It Hawking HWDN1 140.It Hawking HWUN1 141.It Hawking HWUN2 142.It Hercules HWNU-300 143.It Keebox W150NU 144.It Linksys AE1000 145.It Linksys WUSB54GC v3 146.It Linksys WUSB600N 147.It LogiLink WL0084B 148.It Logitec gLAN-W150NU2BK 149.It Logitec LAN-W150N/U2 150.It Logitec LAN-W300N/U2 151.It Logitec LAN-W300N/U2S 152.It Mvix Nubbin MS-811N 153.It Planex GW-USMicroN 154.It Planex GW-US300MiniS 155.It Sitecom WL-182 156.It Sitecom WL-188 157.It Sitecom WL-301 158.It Sitecom WL-302 159.It Sitecom WL-315 160.It Sitecom WLA-4000 161.It Sitecom WLA-5000 162.It SMC SMCWUSBS-N2 163.It Sweex LW153 164.It Sweex LW303 165.It Sweex LW313 166.It Tenda W311M 167.It TP-LINK TL-WDN3200 168.It TP-LINK TL-WN727N v3 169.It TRENDnet TEW-645UB 170.It Unex DNUR-81 171.It Unex DNUR-82 172.It ZyXEL NWD-211AN 173.It ZyXEL NWD-271N 174.It ZyXEL NWD2105 175.It ZyXEL NWD210N 176.It ZyXEL NWD2205 177.It ZyXEL NWD270N 178.It ZyXEL NWD2705 179.El 180.Sh EXAMPLES 181The following example scans for available networks: 182.Pp 183.Dl # ifconfig run0 scan 184.Pp 185The following 186.Xr hostname.if 5 187example configures run0 to join network 188.Dq mynwid , 189using WPA key 190.Dq mywpakey , 191obtaining an IP address using DHCP: 192.Bd -literal -offset indent 193nwid mynwid wpakey mywpakey 194dhcp 195.Ed 196.Sh DIAGNOSTICS 197.Bl -diag 198.It "run0: error N, could not read firmware ..." 199For some reason, the driver was unable to read the microcode file from the 200filesystem. 201The file might be missing or corrupted. 202.It "run0: could not load 8051 microcode" 203An error occurred while attempting to upload the microcode to the onboard 8051 204microcontroller unit. 205.It "run0: device timeout" 206A frame dispatched to the hardware for transmission did not complete in time. 207The driver will reset the hardware. 208This should not happen. 209.El 210.Sh SEE ALSO 211.Xr arp 4 , 212.Xr ifmedia 4 , 213.Xr intro 4 , 214.Xr netintro 4 , 215.Xr usb 4 , 216.Xr hostname.if 5 , 217.Xr ifconfig 8 218.Sh HISTORY 219The 220.Nm 221driver first appeared in 222.Ox 4.5 . 223.Sh AUTHORS 224The 225.Nm 226driver was written by 227.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 228.Sh CAVEATS 229The 230.Nm 231driver does not support any of the 802.11n capabilities offered by the 232RT2800 and RT3000 chipsets. 233Additional work is required in 234.Xr ieee80211 9 235before those features can be supported. 236