1
0
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:
morrownr 2022-12-16 09:35:10 -06:00
parent 7ae65c7150
commit dc14ef61aa
2 changed files with 73 additions and 48 deletions

View File

@ -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.

View File

@ -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