RTWN(4) | Device Drivers Manual | RTWN(4) |
rtwn
— Realtek
RTL8188CE/RTL8188EE/RTL8192CE/RTL8723AE PCIe IEEE 802.11b/g/n wireless
network device
rtwn* at pci? port ?
The rtwn
driver supports PCIe wireless
network devices based on the Realtek RTL8188CE, RTL8188EE, RTL8192CE and
RTL8723AE chipsets.
The RTL8188CE, RTL8188EE and RTL8723AE are highly integrated 802.11n adapters that combine a MAC, a 1T1R capable baseband and an RF in a single chip. The RTL8723AE also includes a Bluetooth 2.1/3.0/4.0 controller.
The RTL8192CE is a highly integrated multiple-in, multiple-out (MIMO) 802.11n adapter that combines a MAC, a 2T2R capable baseband and an RF in a single chip.
These devices operate in the 2GHz spectrum only.
These are the modes the rtwn
driver can
operate in:
The rtwn
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 rtwn
driver can be configured at
runtime with ifconfig(8) or on boot
with hostname.if(5).
The driver needs at least version 1.0 of the following firmware files, which are loaded when an interface is brought up:
A prepackaged version of the firmware can be installed using fw_update(1).
The following example scans for available networks:
# ifconfig rtwn0 scan
The following hostname.if(5) example configures rtwn0 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), pci(4), hostname.if(5), ifconfig(8)
The rtwn
driver first appeared in
OpenBSD 5.8.
The rtwn
driver was written by
Stefan Sperling
<stsp@openbsd.org>.
It was based on the urtwn(4) driver
written by Damien Bergamini
<damien.bergamini@free.fr>.
The rtwn
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 10, 2019 | OpenBSD-current |