mirror of
https://github.com/morrownr/8821cu-20210916.git
synced 2024-09-16 11:41:44 +00:00
updates to docs
This commit is contained in:
parent
7ae65c7150
commit
dc14ef61aa
67
README.md
67
README.md
@ -55,19 +55,13 @@ confirm that this is the correct driver for your adapter.
|
|||||||
|
|
||||||
### Tested Linux Distributions
|
### Tested Linux Distributions
|
||||||
|
|
||||||
Note: One of the goals of this project is to provide driver support that
|
Note: The information in this section depends largely on user reports which can
|
||||||
is easy to install and works reliably on many distros. Meeting this goal
|
be provided via PR or message in Issues.
|
||||||
depends on you to report your recommendations and updated information.
|
|
||||||
If you see information that needs to be updated, please report the
|
|
||||||
updated information and if you do not see adequate support for
|
|
||||||
items such as Installation Steps 2 and 3, and you know what updates
|
|
||||||
need to added or you can get that information, please provide it so that
|
|
||||||
the installation steps can be improved.
|
|
||||||
|
|
||||||
- Armbian_22.11.1 (kernel 5.15) (Rock 4 SE (Rock 4b image with xfce))
|
|
||||||
|
|
||||||
- Arch Linux (kernels 5.4 and 5.11)
|
- Arch Linux (kernels 5.4 and 5.11)
|
||||||
|
|
||||||
|
- Armbian_22.11.1 (kernel 5.15) (Rock 4 SE (Rock 4b image with xfce))
|
||||||
|
|
||||||
- Debian 11 (kernels 5.10 and 5.15)
|
- Debian 11 (kernels 5.10 and 5.15)
|
||||||
|
|
||||||
- Fedora (kernel 5.11)
|
- Fedora (kernel 5.11)
|
||||||
@ -93,10 +87,8 @@ supported due to the way kernel patches are handled. I will support
|
|||||||
knowledgable RHEL developers if they want to merge the required
|
knowledgable RHEL developers if they want to merge the required
|
||||||
support and keep it current.
|
support and keep it current.
|
||||||
|
|
||||||
Note: Android is not supported due to the tremendous amount of changes
|
Note: Android is not supported due but I will support Android developers if
|
||||||
that Google has made to the mainline Linux kernel. I will support
|
they want to merge the required support and keep it current.
|
||||||
knowledgable Android developers if they want to merge the required
|
|
||||||
support and keep it current.
|
|
||||||
|
|
||||||
|
|
||||||
### Download Locations for Tested Linux Distributions
|
### Download Locations for Tested Linux Distributions
|
||||||
@ -120,12 +112,7 @@ support and keep it current.
|
|||||||
|
|
||||||
### Compatible Devices
|
### Compatible Devices
|
||||||
|
|
||||||
Warning: Adapters listed here are not recommended for purchase as I do
|
Warning: If you are looking for information about what adapter to buy,
|
||||||
not recommend Linux users buy Realtek based USB WiFi adapters due to the
|
|
||||||
lack of mac80211 technology drivers that are supported in-kernel as
|
|
||||||
called for by Linux Wireless Standards. This repo is supported for the
|
|
||||||
benefit of Linux users who already have adapters based on the supported
|
|
||||||
chipsets. 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.
|
||||||
|
|
||||||
@ -436,14 +423,46 @@ Note: Documentation for Driver Options is included in the file `8821cu.conf`.
|
|||||||
|
|
||||||
-----
|
-----
|
||||||
|
|
||||||
|
### Upgrading the Driver
|
||||||
|
|
||||||
|
Note: Linux development is continuous therefore work on this driver is continuous.
|
||||||
|
|
||||||
|
Note: Upgrading the driver is advised in the following situations:
|
||||||
|
|
||||||
|
- if a new or updated version of the driver needs to be installed
|
||||||
|
- if a distro version upgrade is going to be installed (i.e. going from kernel 5.10 to kernel 5.15)
|
||||||
|
|
||||||
|
#### Step 1: Move to the driver directory
|
||||||
|
|
||||||
|
```
|
||||||
|
cd ~/src/8821cu-20210916
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Step 2: Remove the currently installed driver
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo ./remove-driver.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Step 3: Pull updated code from this repo
|
||||||
|
|
||||||
|
```
|
||||||
|
git pull
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Step 4: Install the driver
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo ./install-driver.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
-----
|
||||||
### Removal of the Driver ( remove-driver.sh )
|
### Removal of the Driver ( remove-driver.sh )
|
||||||
|
|
||||||
Note: Removing the driver is advised in the following situations:
|
Note: Removing the driver is advised in the following situations:
|
||||||
|
|
||||||
- if driver installation fails
|
- if driver installation fails
|
||||||
- if the driver is no longer needed
|
- if the driver is no longer needed
|
||||||
- if a new or updated version of the driver needs to be installed
|
|
||||||
- if a distro version upgrade is going to be installed (i.e. going from kernel 5.10 to kernel 5.15)
|
|
||||||
|
|
||||||
Note: The following removes everything that has been installed, with the
|
Note: The following removes everything that has been installed, with the
|
||||||
exception of the packages installed in Step 3 and the driver directory.
|
exception of the packages installed in Step 3 and the driver directory.
|
||||||
@ -454,7 +473,7 @@ The driver directory can be deleted after running this script.
|
|||||||
#### Step 2: Move to the driver directory
|
#### Step 2: Move to the driver directory
|
||||||
|
|
||||||
```
|
```
|
||||||
cd ~/src/8821cu-20210118
|
cd ~/src/8821cu-20210916
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Step 3: Run the removal script
|
#### Step 3: Run the removal script
|
||||||
@ -485,7 +504,7 @@ Note: These are general recommendations, some of which may not apply to your spe
|
|||||||
|
|
||||||
- Best location for the WiFi router/access point: Near center of apartment or house, at least a couple of feet away from walls, in an elevated location. You may have to test to see what the best location is in your environment.
|
- Best location for the WiFi router/access point: Near center of apartment or house, at least a couple of feet away from walls, in an elevated location. You may have to test to see what the best location is in your environment.
|
||||||
|
|
||||||
- Check congestion: There are apps available for smart phones that allow you to check the congestion levels on WiFi channels. The apps generally go by the name of ```WiFi Analyzer``` or something similar.
|
- Check congestion: There are apps available for smart phones that allow you to get an idea of the congestion levels on WiFi channels. The apps generally go by the name of ```WiFi Analyzer``` or something similar.
|
||||||
|
|
||||||
After making and saving changes, reboot the router.
|
After making and saving changes, reboot the router.
|
||||||
|
|
||||||
|
@ -91,19 +91,22 @@ Herzegovina BA
|
|||||||
|
|
||||||
Botswana BW
|
Botswana BW
|
||||||
|
|
||||||
Bouvet Island BV
|
Bouvet
|
||||||
|
Island BV
|
||||||
|
|
||||||
Brazil BR
|
Brazil BR
|
||||||
|
|
||||||
British Indian
|
British Indian
|
||||||
Ocean Territory IO
|
Ocean
|
||||||
|
Territory IO
|
||||||
|
|
||||||
Brunei
|
Brunei
|
||||||
Darussalam BN
|
Darussalam BN
|
||||||
|
|
||||||
Bulgaria BG
|
Bulgaria BG
|
||||||
|
|
||||||
Burkina Faso BF
|
Burkina
|
||||||
|
Faso BF
|
||||||
|
|
||||||
Burundi BI
|
Burundi BI
|
||||||
|
|
||||||
@ -143,11 +146,13 @@ Congo CG
|
|||||||
|
|
||||||
Congo CD
|
Congo CD
|
||||||
|
|
||||||
Cook Islands CK
|
Cook
|
||||||
|
Islands CK
|
||||||
|
|
||||||
Costa Rica CR
|
Costa Rica CR
|
||||||
|
|
||||||
Côte d'Ivoire CI
|
Côte
|
||||||
|
d'Ivoire CI
|
||||||
|
|
||||||
Croatia HR
|
Croatia HR
|
||||||
|
|
||||||
@ -188,7 +193,8 @@ Falkland
|
|||||||
Islands
|
Islands
|
||||||
(Malvinas) FK
|
(Malvinas) FK
|
||||||
|
|
||||||
Faroe Islands FO
|
Faroe
|
||||||
|
Islands FO
|
||||||
|
|
||||||
Fiji FJ
|
Fiji FJ
|
||||||
|
|
||||||
@ -206,40 +212,40 @@ French
|
|||||||
Southern
|
Southern
|
||||||
Territories TF
|
Territories TF
|
||||||
|
|
||||||
><
|
Gabon GA
|
||||||
|
|
||||||
Gabon GA
|
Gambia GM
|
||||||
|
|
||||||
Gambia GM
|
Georgia GE
|
||||||
|
|
||||||
Georgia GE
|
Germany DE
|
||||||
|
|
||||||
Germany DE
|
Ghana GH
|
||||||
|
|
||||||
Ghana GH
|
Gibraltar GI
|
||||||
|
|
||||||
Gibraltar GI
|
Greece GR
|
||||||
|
|
||||||
Greece GR
|
Greenland GL
|
||||||
|
|
||||||
Greenland GL
|
Grenada GD
|
||||||
|
|
||||||
Grenada GD
|
Guadeloupe GP
|
||||||
|
|
||||||
Guadeloupe GP
|
Guam GU
|
||||||
|
|
||||||
Guam GU
|
Guatemala GT
|
||||||
|
|
||||||
Guatemala GT
|
Guernsey GG
|
||||||
|
|
||||||
Guernsey GG
|
Guinea GN
|
||||||
|
|
||||||
Guinea GN
|
|
||||||
|
|
||||||
Guinea-
|
Guinea-
|
||||||
Bissau GW
|
Bissau GW
|
||||||
|
|
||||||
Guyana GY
|
Guyana GY
|
||||||
|
|
||||||
|
><
|
||||||
|
|
||||||
Haiti HT
|
Haiti HT
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user