mirrors/8821cu-20210916
1
0
Fork 0
mirror of https://github.com/morrownr/8821cu-20210916.git synced 2024-12-22 06:15:50 +00:00
Code Releases Activity

continued updates

Browse Source
This commit is contained in:
morrownr 2023-01-01 12:53:37 -06:00
parent d38fe7ffa0
commit 6f60a5dbb0
5 changed files with 48 additions and 649 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
8821cu.conf
View File

@ -132,6 +132,21 @@ options 8821cu rtw_drv_log_level=1 rtw_led_ctrl=1 rtw_vht_enable=1 rtw_power_mgn
# #
# ----- # -----
# #
# Country Code options ( rtw_country_code )
#
# Note: Allows the Country Code to be set in cases where it is unable to
# be obtained otherwise.
#
# URL: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
#
# Example for the US: rtw_country_code=US
# Example for Panama: rtw_country_code=PA
# Example for Norway: rtw_country_code=NO
# Example for Kuwait: rtw_country_code=KW
# Example for Taiwan: rtw_country_code=TW
#
# -----
#
# To see all options that are available: # To see all options that are available:
# #
# $ ls /sys/module/8821cu/parameters/ # $ ls /sys/module/8821cu/parameters/

53
README.md
View File

@ -121,16 +121,20 @@ a modification or two to the Makefile).
### Compatible Devices ### Compatible Devices
* EDUP EP-AC1651 (nano) (single-state, single-function)
* EDUP EP-AC1635 (single-state, single-function)
* Numerous adapters that are based on the supported chipset.
Note: If you are looking for information about what adapter to buy, Note: If you are looking for information about what adapter to buy,
click [here](https://github.com/morrownr/USB-WiFi) and look for Main Menu 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. item 2 which will show information about and links to recommended adapters.
* Cudy WU700 Note: If you decide to buy an adapter that is supported by this driver, I
* EDUP EP-AC1651 (nano) recommend you search for an adapter that is `single-state and single-function`.
* EDUP EP-AC1635 Multi-function adapters, wifi and bluetooth, can be problematic. The rtl8821cu
* TOTOLINK A650UA v3 chipset is multi-fuction. The rtl8811cu chipset is single-function. For advice
* Mercusys MU6H (multi-state) about single-state and multi-state adapaters. click
* Numerous adapters that are based on the supported chipset. [here](https://github.com/morrownr/USB-WiFi) and look for Main Menu item 1.
### Installation Information ### Installation Information
@ -205,24 +209,6 @@ install this driver and, after a reboot, the driver is not working, you
can go into the BIOS and temporarily turn secure boot off to see if can go into the BIOS and temporarily turn secure boot off to see if
secure boot is the problem. secure boot is the problem.
Please ensure the ISO 3166-1 alpha-2 Country Code is set in your Linux distro.
If it is not set, you will likely have problems accessing some channels, especially
5 Ghz and 6 GHz channels. To set your Country Code:
```
sudo iw reg set US
```
If you are not in the US, please use the country code for your country. See:
ISO 3166-1 alpha-2 codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
To check if your country code is properly set:
```
iw reg get
```
### Installation Steps ### Installation Steps
Note: The installation instructions are for the novice user. Experienced users are Note: The installation instructions are for the novice user. Experienced users are
@ -567,17 +553,16 @@ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
Question: Is WPA3 supported? Question: Is WPA3 supported?
Answer: WPA3-SAE support is in this driver according to Realtek and it Answer: WPA3-SAE is supported. It works well on most modern Linux distros but
works well on some Linux distros but not all. Generally the reason for not all. Generally the reason for WPA3 not working on Linux distros is that the
WPA3 not working on Linux distros is that the distro has an old version distro has an old version of wpa_supplicant or Network Manager. Your options
of wpa_supplicant or Network Manager. Your options are to upgrade to a are to upgrade to a more modern distro (distros released after mid 2022) or
more modern distro (most distros released after mid 2022) or compile and compile and install new versions of wpa_supplicant and/or Network Manager.
install new versions of the wpa_supplicant and Network Manager utilities.
----- -----
Question: I bought two rtl8811cu based adapters and am planning to use Question: I bought two usb wifi adapters based on this chipset and am planning
both in the same computer. How do I set that up? to use both in the same computer. How do I set that up?
Answer: Realtek drivers do not support more than one adapter with the Answer: Realtek drivers do not support more than one adapter with the
same chipset in the same computer. You can have multiple Realtek based same chipset in the same computer. You can have multiple Realtek based
@ -681,8 +666,8 @@ and post in `Discussions` or `Issues`.
Question: I have an adapter with the 8821cu chipset which means it supports Question: I have an adapter with the 8821cu chipset which means it supports
bluetooth. The bluetooth works but the wifi does not. What is wrong? bluetooth. The bluetooth works but the wifi does not. What is wrong?
Answer: There appears to be a hardware bug in some 8821cu based adapters Answer: There appears to be an issue where adapters can be set up differently
and the fix is to set the driver option ( `rtw_RFE_type` ) in 8821cu.conf. by makers. The fix is to set the driver option ( `rtw_RFE_type` ) in 8821cu.conf.
The easiest way to edit 8821cu.conf is to run the following from the driver The easiest way to edit 8821cu.conf is to run the following from the driver
directory: directory:

603
alpha-2_Country_Codes
View File

@ -1,603 +0,0 @@
2022-12-26
Instructions for setting the ISO 3166-1 alpha-2 Country Code in your Linux
distro. If it is not set, you may have problems using some channels, especially
5 Ghz and 6 GHz channels. To set your Country Code from the command line
interface:
Note: Package "iw" must be installed.
```
sudo iw reg set XX
```
Where XX is the country code for your country. See the list of country codes
below.
To check if your country code is properly set:
```
iw reg get
```
```
ISO 3166-1 alpha-2 Country Codes
Code Name
AF Afghanistan
AX Aland Islands
AL Albania
DZ Algeria
AS American Samoa
AD Andorra
AO Angola
AI Anguilla
AQ Antarctica
AG Antigua and Barbuda
Argentina AR
Armenia AM
Aruba AW
Australia AU
Austria AT
Azerbaijan AZ
Bahamas BS
Bahrain BH
Bangladesh BD
Barbados BB
Belarus BY
Belgium BE
Belize BZ
Benin BJ
Bermuda BM
Bhutan BT
Bolivia BO
Bonaire, Sint
Eustatius and
Saba BQ
Bosnia and
Herzegovina BA
Botswana BW
Bouvet
Island BV
Brazil BR
British Indian
Ocean
Territory IO
Brunei
Darussalam BN
Bulgaria BG
Burkina
Faso BF
Burundi BI
Cambodia KH
Cameroon CM
Canada CA
Cape Verde CV
Cayman
Islands KY
Central
African
Republic CF
Chad TD
Chile CL
China CN
Christmas
Island CX
Cocos
(Keeling)
Islands CC
Colombia CO
Comoros KM
Congo CG
Congo CD
Cook
Islands CK
Costa Rica CR
Côte
d'Ivoire CI
Croatia HR
Cuba CU
Curaçao CW
Cyprus CY
Czech
Republic CZ
Denmark DK
Djibouti DJ
Dominica DM
Dominican
Republic DO
Ecuador EC
Egypt EG
El Salvador SV
Equatorial
Guinea GQ
Eritrea ER
Estonia EE
Ethiopia ET
Falkland
Islands
(Malvinas) FK
Faroe
Islands FO
Fiji FJ
Finland FI
France FR
French
Guiana GF
French
Polynesia PF
French
Southern
Territories TF
Gabon GA
Gambia GM
Georgia GE
Germany DE
Ghana GH
Gibraltar GI
Greece GR
Greenland GL
Grenada GD
Guadeloupe GP
Guam GU
Guatemala GT
Guernsey GG
Guinea GN
Guinea-
Bissau GW
Guyana GY
Haiti HT
Heard Island
and
McDonald
Islands HM
Holy See
(Vatican City
State) VA
Honduras HN
Hong Kong HK
Hungary HU
Iceland IS
India IN
Indonesia ID
Iran, Islamic
Republic of IR
Iraq IQ
Ireland IE
Isle of Man IM
Israel IL
Italy IT
Jamaica JM
Japan JP
Jersey JE
Jordan JO
Kazakhstan KZ
Kenya KE
Kiribati KI
Korea,
Democratic
People's
Republic of KP
Korea,
Republic of KR
Kuwait KW
Kyrgyzstan KG
Lao People's
Democratic
Republic LA
Latvia LV
Lebanon LB
Lesotho LS
Liberia LR
Libya LY
LI Liechtenstein
Lithuania LT
Luxembourg LU
Macao MO
Macedonia,
the Former
Yugoslav
Republic of MK
Madagascar MG
Malawi MW
Malaysia MY
Maldives MV
Mali ML
Malta MT
Marshall
Islands MH
Martinique MQ
Mauritania MR
Mauritius MU
Mayotte YT
Mexico MX
Micronesia,
Federated
States of FM
Moldova,
Republic of MD
Monaco MC
Mongolia MN
Montenegro ME
Montserrat MS
Morocco MA
Mozambique MZ
Myanmar MM
Namibia NA
Nauru NR
Nepal NP
Netherlands NL
New
Caledonia NC
New Zealand NZ
Nicaragua NI
Niger NE
Nigeria NG
Niue NU
NF Norfolk Island
Northern
Mariana
Islands MP
Norway NO
><
Oman OM
Pakistan PK
Palau PW
Palestine PS
Panama PA
Papua New
Guinea PG
Paraguay PY
Peru PE
Philippines PH
Pitcairn PN
Poland PL
Portugal PT
Puerto Rico PR
Qatar QA
Réunion RE
Romania RO
Russia RU
Rwanda RW
Saint
Barthélemy BL
Saint Helena,
Ascension
and Tristan
da Cunha SH
Saint Kitts
and Nevis KN
Saint Lucia LC
MF Saint Martin (French part)
PM Saint Pierre and Miquelon
Saint Vincent
and the
Grenadines VC
Samoa WS
San Marino SM
ST Sao Tome and Principe
SA Saudi Arabia
Senegal SN
Serbia RS
Seychelles SC
SL Sierra Leone
Singapore SG
SX Sint Maarten (Dutch part)
Slovakia SK
Slovenia SI
Solomon
Islands SB
Somalia SO
ZA South Africa
South
Georgia and
the South
Sandwich
Islands GS
South Sudan SS
Spain ES
Sri Lanka LK
Sudan SD
Suriname SR
Svalbard and
Jan Mayen SJ
Swaziland SZ
Sweden SE
Switzerland CH
Syrian Arab
Republic SY
Taiwan TW
Tajikistan TJ
Tanzania,
United
Republic of TZ
Thailand TH
Timor-Leste TL
Togo TG
Tokelau TK
Tonga TO
Trinidad and
Tobago TT
Tunisia TN
Turkey TR
TM Turkmenistan
Turks and
Caicos
Islands TC
Tuvalu TV
Uganda UG
Ukraine UA
United Arab
Emirates AE
GB United Kingdom
US United States
United States
Minor
Outlying
Islands UM
Uruguay UY
Uzbekistan UZ
Vanuatu VU
Venezuela VE
Viet Nam VN
Virgin Islands,
British VG
Virgin Islands,
U.S. VI
WF Wallis and Futuna
EH Western Sahara
YE Yemen
ZM Zambia
ZW Zimbabwe
```

6
include/autoconf.h
View File

@ -22,7 +22,7 @@
#define RTL871X_MODULE_NAME "8821CU" #define RTL871X_MODULE_NAME "8821CU"
#define DRV_NAME "rtl8821cu" #define DRV_NAME "rtl8821cu"
/* kills AP mode /* nrm - don't activate, kills AP mode
* #define CONFIG_REGD_SRC_FROM_OS * #define CONFIG_REGD_SRC_FROM_OS
*/ */
@ -46,7 +46,7 @@
#endif #endif
#ifdef CONFIG_80211N_HT #ifdef CONFIG_80211N_HT
/* nrm */ /* nrm - activate beamforming */
#define CONFIG_BEAMFORMING #define CONFIG_BEAMFORMING
#endif #endif
@ -172,6 +172,7 @@
#define CONFIG_RTW_LED #define CONFIG_RTW_LED
#ifdef CONFIG_RTW_LED #ifdef CONFIG_RTW_LED
/* nrm */
// #define CONFIG_RTW_SW_LED // #define CONFIG_RTW_SW_LED
#ifdef CONFIG_RTW_SW_LED #ifdef CONFIG_RTW_SW_LED
/* #define CONFIG_RTW_LED_HANDLED_BY_CMD_THREAD */ /* #define CONFIG_RTW_LED_HANDLED_BY_CMD_THREAD */
@ -180,6 +181,7 @@
#define CONFIG_GLOBAL_UI_PID #define CONFIG_GLOBAL_UI_PID
/* nrm */
#define CONFIG_RTW_80211K #define CONFIG_RTW_80211K
/*#define CONFIG_ADAPTOR_INFO_CACHING_FILE */ /* now just applied on 8192cu only, should make it general... */ /*#define CONFIG_ADAPTOR_INFO_CACHING_FILE */ /* now just applied on 8192cu only, should make it general... */

20
install-driver.sh
View File

@ -16,7 +16,7 @@
# GNU General Public License for more details. # GNU General Public License for more details.
SCRIPT_NAME="install-driver.sh" SCRIPT_NAME="install-driver.sh"
SCRIPT_VERSION="20221228" SCRIPT_VERSION="20230101"
MODULE_NAME="8821cu" MODULE_NAME="8821cu"
DRV_VERSION="5.12.0.4" DRV_VERSION="5.12.0.4"
@ -115,7 +115,7 @@ do
done done
# displays script name and version # displays script name and version
echo "Script: ${SCRIPT_NAME} version ${SCRIPT_VERSION}" echo "Script: ${SCRIPT_NAME} v${SCRIPT_VERSION}"
# check for and remove non-dkms installations # check for and remove non-dkms installations
# standard naming # standard naming
@ -171,14 +171,14 @@ gcc_ver=$(gcc --version | grep -i gcc)
echo "gcc: "${gcc_ver} echo "gcc: "${gcc_ver}
# display ISO 3166-1 alpha-2 Country Code # display ISO 3166-1 alpha-2 Country Code
a2_country_code=$(iw reg get | grep -i country) #a2_country_code=$(iw reg get | grep -i country)
echo "Country: "${a2_country_code} #echo "Country: "${a2_country_code}
if [[ $a2_country_code == *"00"* ]]; #if [[ $a2_country_code == *"00"* ]];
then #then
echo "The Country Code may not be properly set." # echo "The Country Code may not be properly set."
echo "File alpha-2_Country_Codes is located in the driver directory." # echo "File alpha-2_Country_Codes is located in the driver directory."
echo "Please read and follow the directions in the file after installation." # echo "Please read and follow the directions in the file after installation."
fi #fi
# display secure mode status # display secure mode status
# run if mokutil is installed # run if mokutil is installed