From 309059e9d7d2fd051a31aa97c3bd252e924d51f5 Mon Sep 17 00:00:00 2001 From: morrownr Date: Tue, 27 Dec 2022 13:18:38 -0600 Subject: [PATCH] update docs --- 8821cu.conf | 32 +++++++++++++++++++++++++++----- README.md | 27 +++++++++++++++++---------- 2 files changed, 44 insertions(+), 15 deletions(-) diff --git a/8821cu.conf b/8821cu.conf index 9138c92..4b6ba9e 100644 --- a/8821cu.conf +++ b/8821cu.conf @@ -9,7 +9,7 @@ blacklist rtw88_8821cu # # Edit the following line to change, add or delete options: -options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 +options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 rtw_power_mgnt=1 # # After editing is complete, save this file (if using nano: Ctrl + x, y, Enter) # and reboot to activate the changes. @@ -71,6 +71,28 @@ options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 # # ----- # +# Beamforming options ( rtw_beamform_cap ) +# +# 0 = Disable +# 1 = SU Beamformer +# 2 = SU Beamformee +# 3 = SU Beamformer and SU Beamformee +# 10= SU Beamformee and MU Beamformee (default) +# 11= SU Beamformer and SU Beamformee and MU Beamformee +# +# Note: MU Beamformer is not supported. +# +# /* /os_dep/linux/os_intfs.c +# * BIT0: Enable VHT SU Beamformer +# * BIT1: Enable VHT SU Beamformee +# * BIT2: Enable VHT MU Beamformer, depend on VHT SU Beamformer +# * BIT3: Enable VHT MU Beamformee, depend on VHT SU Beamformee +# * BIT4: Enable HT Beamformer +# * BIT5: Enable HT Beamformee +# */ +# +# ----- +# # ISO 3166-1 alpha-2 Country Code options ( rtw_country_code ) # # Note: Allows the Country Code to be set in cases where it is unable to @@ -83,7 +105,7 @@ options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 # Example for Taiwan: rtw_country_code=TW # # ISO 3166-1 alpha-2 codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 -# +# # ----- # # DFS Options ( rtw_dfs_region_domain ) @@ -107,7 +129,7 @@ options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 # Select P2P interface in concurrent mode ( rtw_sel_p2p_iface ) # # 0 = Sets interface 0 to be p2p interface -# 1 = Sets interface 1 to be p2p interface (default) +# 1 = Sets interface 1 to be p2p interface (default) # # ----- # @@ -122,10 +144,10 @@ options 8821cu rtw_drv_log_level=0 rtw_led_ctrl=1 rtw_vht_enable=1 # 6 = (2-Ant), (2G_WLG, iPA, iLNA, iSW), (5G, iPA, iLNA, iSW) # 7 = (1-Ant), (2G_BTG, iPA, iLNA, iSW), (5G, iPA, iLNA, iSW) (try this setting first) # 64 = this appears to be the default on adapters that do not support bluetooth -# +# # Note: RFE Type is used to set antenna isolation and the BT coexistence # mechanism. Some adapters require this setting and some do not. If wifi -# does not work without this setting, the setting probably needs to be +# does not work without this setting, the setting probably needs to be # set. It may be necessary to try different settings to determine # which setting is optimal for your adapter. # diff --git a/README.md b/README.md index 97d742c..a00e419 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ ## 8821cu ( 8821cu.ko ) :rocket: -## Linux Driver for USB WiFi Adapters that are based on the RTL8811CU, RTL8821CU and RTL8731AU Chipsets +## Linux Driver for USB WiFi Adapters that are based on the RTL8811CU, RTL8821CU, RTL8821CUH and RTL8731AU Chipsets - v5.12.0.4 (Realtek) (20210916) plus updates from the Linux community @@ -11,18 +11,25 @@ confirm that this is the correct driver for your adapter. - IEEE 802.11 b/g/n/ac WiFi compliant - 802.1x, WEP, WPA TKIP and WPA2 AES/Mixed mode for PSK and TLS (Radius) -- WPA3 (see FAQ) +- WPA3-SAE (Personal) (see FAQ) +- WPA3-Enterprise (Suite-B 192-bit) +- WAPI 1.0 station mode +- WPS - PIN and PBC Methods - IEEE 802.11b/g/n/ac Client mode * Supports wireless security for WEP, WPA TKIP and WPA2 AES PSK * Supports site survey scan and manual connect * Supports WPA/WPA2 TLS client - Power saving modes +- WiFi-Direct +- Miracast +- MU-MIMO +- Mesh +- Wake on WLAN - Wireshark compatible - Aircrack-ng compatible - Packet injection - hostapd compatible - AP mode DFS channel support -- Miracast - Supported interface modes * Managed * Monitor (see FAQ) @@ -78,7 +85,7 @@ be provided via PR or message in Issues. - SkiffOS for Odroid XU4 (ARM 32 bit) (kernel 6.0.7) -- Ubuntu 22.04 (kernel 5.15) and 22.10 (kernel 5.19) +- Ubuntu 22.04 (kernel 5.15) and 22.10 (kernel 5.19) (kernel 6.2 rc1) - Void Linux (kernel 5.18) @@ -87,10 +94,10 @@ supported due to the way kernel patches are handled. I will support knowledgable RHEL developers if they want to merge the required support and keep it current. -Note: Android is not supported but I will support knowledgable Android -developers if they want to merge and keep current the required support -(most likely just instructions about how to compile and maybe a modification -or two to the Makefile). +Note: Android is supported in the driver according to Realtek. I will support +knowledgable Android developers if they want to merge and keep current the +required support (most likely just instructions about how to compile and maybe +a modification or two to the Makefile). ### Download Locations for Tested Linux Distributions @@ -109,7 +116,7 @@ or two to the Makefile). ### Tested Hardware -- EDUP EP-AC1651 USB WiFi Adapter AC650 Dual Band USB 2.0 Nano +- EDUP EP-AC1651 USB WiFi Adapter AC650 Dual Band USB 2.0 (nano) - EDUP EP-AC1635 USB WiFi Adapter AC600 Dual Band USB 2.0 ### Compatible Devices @@ -119,7 +126,7 @@ click [here](https://github.com/morrownr/USB-WiFi) and look for Main Menu item 2 which will show information about and links to recommended adapters. * Cudy WU700 -* EDUP EP-AC1651 +* EDUP EP-AC1651 (nano) * EDUP EP-AC1635 * TOTOLINK A650UA v3 * Mercusys MU6H (multi-state)