diff --git a/8821cu.conf b/8821cu.conf index 9087137..a920e65 100644 --- a/8821cu.conf +++ b/8821cu.conf @@ -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: # # $ ls /sys/module/8821cu/parameters/ diff --git a/README.md b/README.md index a81e151..0594df4 100644 --- a/README.md +++ b/README.md @@ -121,16 +121,20 @@ a modification or two to the Makefile). ### 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, 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 (nano) -* EDUP EP-AC1635 -* TOTOLINK A650UA v3 -* Mercusys MU6H (multi-state) -* Numerous adapters that are based on the supported chipset. +Note: If you decide to buy an adapter that is supported by this driver, I +recommend you search for an adapter that is `single-state and single-function`. +Multi-function adapters, wifi and bluetooth, can be problematic. The rtl8821cu +chipset is multi-fuction. The rtl8811cu chipset is single-function. For advice +about single-state and multi-state adapaters. click +[here](https://github.com/morrownr/USB-WiFi) and look for Main Menu item 1. ### 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 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 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? -Answer: WPA3-SAE support is in this driver according to Realtek and it -works well on some Linux distros but not all. Generally the reason for -WPA3 not working on Linux distros is that the distro has an old version -of wpa_supplicant or Network Manager. Your options are to upgrade to a -more modern distro (most distros released after mid 2022) or compile and -install new versions of the wpa_supplicant and Network Manager utilities. +Answer: WPA3-SAE is supported. It works well on most modern Linux distros but +not all. Generally the reason for WPA3 not working on Linux distros is that the +distro has an old version of wpa_supplicant or Network Manager. Your options +are to upgrade to a more modern distro (distros released after mid 2022) or +compile and install new versions of wpa_supplicant and/or Network Manager. ----- -Question: I bought two rtl8811cu based adapters and am planning to use -both in the same computer. How do I set that up? +Question: I bought two usb wifi adapters based on this chipset and am planning +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 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 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 -and the fix is to set the driver option ( `rtw_RFE_type` ) in 8821cu.conf. +Answer: There appears to be an issue where adapters can be set up differently +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 directory: diff --git a/alpha-2_Country_Codes b/alpha-2_Country_Codes deleted file mode 100644 index e2d43e3..0000000 --- a/alpha-2_Country_Codes +++ /dev/null @@ -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 - -``` diff --git a/include/autoconf.h b/include/autoconf.h index d40b948..3f13eda 100644 --- a/include/autoconf.h +++ b/include/autoconf.h @@ -22,7 +22,7 @@ #define RTL871X_MODULE_NAME "8821CU" #define DRV_NAME "rtl8821cu" -/* kills AP mode +/* nrm - don't activate, kills AP mode * #define CONFIG_REGD_SRC_FROM_OS */ @@ -46,7 +46,7 @@ #endif #ifdef CONFIG_80211N_HT - /* nrm */ + /* nrm - activate beamforming */ #define CONFIG_BEAMFORMING #endif @@ -172,6 +172,7 @@ #define CONFIG_RTW_LED #ifdef CONFIG_RTW_LED +/* nrm */ // #define CONFIG_RTW_SW_LED #ifdef CONFIG_RTW_SW_LED /* #define CONFIG_RTW_LED_HANDLED_BY_CMD_THREAD */ @@ -180,6 +181,7 @@ #define CONFIG_GLOBAL_UI_PID +/* nrm */ #define CONFIG_RTW_80211K /*#define CONFIG_ADAPTOR_INFO_CACHING_FILE */ /* now just applied on 8192cu only, should make it general... */ diff --git a/install-driver.sh b/install-driver.sh index 5d04dce..29b3ba1 100755 --- a/install-driver.sh +++ b/install-driver.sh @@ -16,7 +16,7 @@ # GNU General Public License for more details. SCRIPT_NAME="install-driver.sh" -SCRIPT_VERSION="20221228" +SCRIPT_VERSION="20230101" MODULE_NAME="8821cu" DRV_VERSION="5.12.0.4" @@ -115,7 +115,7 @@ do done # 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 # standard naming @@ -171,14 +171,14 @@ gcc_ver=$(gcc --version | grep -i gcc) echo "gcc: "${gcc_ver} # display ISO 3166-1 alpha-2 Country Code -a2_country_code=$(iw reg get | grep -i country) -echo "Country: "${a2_country_code} -if [[ $a2_country_code == *"00"* ]]; -then - echo "The Country Code may not be properly set." - echo "File alpha-2_Country_Codes is located in the driver directory." - echo "Please read and follow the directions in the file after installation." -fi +#a2_country_code=$(iw reg get | grep -i country) +#echo "Country: "${a2_country_code} +#if [[ $a2_country_code == *"00"* ]]; +#then +# echo "The Country Code may not be properly set." +# echo "File alpha-2_Country_Codes is located in the driver directory." +# echo "Please read and follow the directions in the file after installation." +#fi # display secure mode status # run if mokutil is installed