URTWN(4) | Device Drivers Manual | URTWN(4) |
urtwn
— Realtek
RTL8188CU/RTL8188EU/RTL8192CU/RTL8192EU USB IEEE 802.11b/g/n wireless
network device
urtwn* at uhub? port ?
The urtwn
driver supports USB 2.0 wireless
network devices based on Realtek RTL8188CU, RTL8188CE-VAU, RTL8188EU,
RTL8188RU, RTL8192CU and RTL8192EU chipsets.
The RTL8188CU and RTL8188EU are highly integrated 802.11n adapters that combine a MAC, a 1T1R capable baseband and an RF in a single chip. They operate in the 2GHz spectrum only. The RTL8188RU is a high-power variant of the RTL8188CU. The RTL8188CE-VAU is a PCI Express Mini Card adapter that attaches to the USB interface.
The RTL8192CU and RTL8192EU are highly integrated multiple-in, multiple-out (MIMO) 802.11n adapters that combine a MAC, a 2T2R capable baseband and an RF in a single chip. They operate in the 2GHz spectrum only.
These are the modes the urtwn
driver can
operate in:
The urtwn
driver can be configured to use
Wired Equivalent Privacy (WEP) or Wi-Fi Protected Access (WPA1 and WPA2).
WPA2 is the current encryption standard for wireless networks. It is
strongly recommended that neither WEP nor WPA1 are used as the sole
mechanism to secure wireless communication, due to serious weaknesses. WPA1
is disabled by default and may be enabled using the option
"wpaprotos
wpa1,wpa2". For standard WPA networks which use
pre-shared keys (PSK), keys are configured using the
"wpakey
" option. WPA-Enterprise networks
require use of the wpa_supplicant package.
The urtwn
driver can be configured at
runtime with ifconfig(8) or on boot
with hostname.if(5).
The driver needs at least version 1.1p0 of the following firmware files, which are loaded when an interface is attached:
A prepackaged version of the firmware can be installed using fw_update(1).
The following adapters should work:
The following example scans for available networks:
# ifconfig urtwn0 scan
The following hostname.if(5) example configures urtwn0 to join network “mynwid”, using WPA key “mywpakey”, obtaining an IP address using DHCP:
nwid mynwid wpakey mywpakey dhcp
arp(4), ifmedia(4), intro(4), netintro(4), usb(4), hostname.if(5), ifconfig(8)
The urtwn
driver first appeared in
OpenBSD 4.9.
The urtwn
driver was written by
Damien Bergamini
<damien.bergamini@free.fr>.
The urtwn
driver does not support any of
the 802.11n capabilities offered by the adapters. Additional work is
required in ieee80211(9) before those
features can be supported.
This driver does not support powersave mode.
November 15, 2020 | OpenBSD-current |