1
0
mirror of https://github.com/morrownr/8821cu-20210916.git synced 2024-11-01 01:05:25 +00:00

Compare commits

...

2 Commits

Author SHA1 Message Date
morrownr
de36dfeff8 update docs 2023-09-24 14:59:23 -05:00
morrownr
0f5a50f919 fix (again) the -am_NOT_a_driver problem- 2023-09-24 14:58:10 -05:00
4 changed files with 102 additions and 37 deletions

71
FAQ.md
View File

@ -8,7 +8,7 @@ driver is installed but does not seem to be working. What is wrong?
Answer: This question often comes up after installing the driver to a Answer: This question often comes up after installing the driver to a
system that has Secure Boot on. To test if there is a Secure Boot related system that has Secure Boot on. To test if there is a Secure Boot related
problem, turn secure boot off in the system BIOS and reboot. If the driver problem, turn secure boot off in the system BIOS and reboot. If the driver
works as expected after reboot, them the problem is likely related to works as expected after reboot, then the problem is likely related to
Secure Boot. Secure Boot.
What will increase my chances of having a sucessessful installation on a What will increase my chances of having a sucessessful installation on a
@ -20,7 +20,7 @@ the easiest solution is likely to do a clean reinstallation with Secure Boot
on. on.
Ubuntu is used as the example but other distros should be similar to one Ubuntu is used as the example but other distros should be similar to one
degree or another. During the installation there will be a box on one of degree or another. During the installation there may be a box on one of
installation pages that will appear if the installation program detects installation pages that will appear if the installation program detects
that Secure Boot is on. You will need to check the appropriate box and that Secure Boot is on. You will need to check the appropriate box and
supply a password. You can use the same password that you use for the system supply a password. You can use the same password that you use for the system
@ -41,8 +41,43 @@ Here is a link regarding Debian and Secure Boot:
https://wiki.debian.org/SecureBoot https://wiki.debian.org/SecureBoot
There is work underway to add Secure Boot support for systems that do not If you are using a basic command line (non-dkms) installation, see the
have `dkms` available or if a manual installation is desired. following section in the Installation Steps part of the README:
If you use the `install-driver.sh` script and see the following message
`SecureBoot enabled - read FAQ about SecureBoot`
You need to read the following:
The MOK managerment screen will appear during boot:
`Shim UEFI Key Management"
`Press any key...`
Select "Enroll key"
Select "Continue"
Select "Yes"
When promted, enter the password you entered earlier.
If you enter the wrong password, your computer will not be bootable. In
this case, use the BOOT menu from your BIOS to boot then as follows:
```
sudo mokutil --reset
```
Restart your computer and use the BOOT menu from BIOS to boot. In the MOK
managerment screen, select `reset MOK list`. Then Reboot and retry the
driver installation.
Manual Installation Instructions
It provides secure boot instructions.
----- -----
@ -158,6 +193,34 @@ dtoverlay=disable-wifi
----- -----
Question: When running `sudo sh install-driver.sh` on my RasPi 4B or
400, I see the following:
```
Your kernel header files aren't properly installed.
Please consult your distro documentation or user support forums.
Once the header files are properly installed, please run...
```
Answer: The Pi 4/400 firmware now prefers the 64-bit kernel if one
exists so even if you installed the 32 bit version of the RasPiOS,
you may now have the 64 bit kernel active.
The fix:
add the following to /boot/config.txt and reboot:
arm_64bit=0
Reference:
https://forums.raspberrypi.com/viewtopic.php?p=2091532&hilit=Tp+link#p2091532
Note to RasPiOS devs: We really really wish you would consider the
consequences of the changes you make. Thank you.
-----
Question: I have an adapter with the 8821cu chipset and it supports Question: I have an adapter with the 8821cu chipset and 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?

View File

@ -1352,20 +1352,8 @@ ifeq ($(CONFIG_PLATFORM_AUTODETECT), y)
EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN
EXTRA_CFLAGS += -DCONFIG_IOCTL_CFG80211 -DRTW_USE_CFG80211_STA_EVENT EXTRA_CFLAGS += -DCONFIG_IOCTL_CFG80211 -DRTW_USE_CFG80211_STA_EVENT
SUBARCH := $(shell uname -m) #SUBARCH := $(shell uname -m)
SUBARCH := $(shell uname -m | sed -e "s/i.86/i386/; s/ppc/powerpc/; s/armv.l/arm/; s/aarch64/arm64/; s/riscv.*/riscv/;")
ifeq ($(SUBARCH), aarch64)
SUBARCH := arm64
endif
ifeq ($(SUBARCH), armv7l)
SUBARCH := arm
endif
ifeq ($(SUBARCH), armv6l)
SUBARCH := arm
endif
ARCH ?= $(SUBARCH) ARCH ?= $(SUBARCH)
CROSS_COMPILE ?= CROSS_COMPILE ?=

View File

@ -44,7 +44,7 @@ confirm that this is the correct driver for your adapter.
### Not supported ### Not supported
- hcxdumptool - hcxdumptool (see hcxdumptool documentation)
### A FAQ is available in this repo with the name `FAQ.md` ### A FAQ is available in this repo with the name `FAQ.md`
@ -54,24 +54,27 @@ confirm that this is the correct driver for your adapter.
### Compatible CPU Architectures ### Compatible CPU Architectures
- x86, i686 - x86, i386, i686
- x86-64, amd64 - x86-64, amd64
- armv6l, armv7l (arm) - armv6l, armv7l (arm)
- aarch64 (arm64) - aarch64 (arm64)
Note: Additional CPU architectures may work but I currently only have
the hardware to test the above.
### Compatible Kernels ### Compatible Kernels
- Kernels: 4.19 - 5.11 (Realtek) - Kernels: 4.19 - 5.11 (Realtek)
- Kernels: 5.12 - 6.5 (community support) - Kernels: 5.12 - 6.6 (community support)
### Tested Compilers ### Tested Compilers
- gcc 10, 11 and 12 - gcc 10, 11, 12 and 13
### Tested Linux Distributions ### Tested Linux Distributions
Note: The information in this section depends largely on user reports which can Note: The information in this section depends largely on user reports
be provided via PR or message in Issues. which can be provided via PR or message in Issues.
- [Arch Linux](https://www.archlinux.org) (kernels 5.4 and 5.11) - [Arch Linux](https://www.archlinux.org) (kernels 5.4 and 5.11)
@ -81,13 +84,13 @@ be provided via PR or message in Issues.
- [Fedora](https://getfedora.org) Fedora 38 (6.2.13-300) - [Fedora](https://getfedora.org) Fedora 38 (6.2.13-300)
- [Kali Linux](https://www.kali.org/) (kernel 5.10) - [Kali Linux](https://www.kali.org/) (kernel 6.3)
- [Manjaro](https://manjaro.org) (kernel 5.13) - [Manjaro](https://manjaro.org) (kernel 5.15)
- [openSUSE](https://www.opensuse.org/) Tumbleweed (rolling) (kernel 5.15) - [openSUSE](https://www.opensuse.org/) Tumbleweed (rolling) (kernel 5.15)
- [Raspberry Pi OS](https://www.raspberrypi.org) (2023-05-03) (ARM 32 bit and 64 bit) (kernel 6.1.38) - [Raspberry Pi OS](https://www.raspberrypi.org) (2023-05-03)(ARM 32 bit and 64 bit) (kernel 6.1.38)
- [Raspberry Pi Desktop](https://www.raspberrypi.org) (2022-07-01) (x86 32 bit) (kernel 5.10) - [Raspberry Pi Desktop](https://www.raspberrypi.org) (2022-07-01) (x86 32 bit) (kernel 5.10)
@ -97,17 +100,27 @@ be provided via PR or message in Issues.
- [Void Linux](https://voidlinux.org/) (kernel 5.18) - [Void Linux](https://voidlinux.org/) (kernel 5.18)
Note: Red Hat Enterprise Linux (RHEL) and distros based on RHEL are not Note: Red Hat Enterprise Linux (RHEL) and distros based on RHEL are
supported due to the way kernel patches are handled. I will support supported by Red Hat devs due to the way kernel patches are handled in
knowledgable RHEL developers if they want to merge the required Red Hat. I support knowledgable RHEL developers if they want to merge
support and keep it current. I reserve the right to delete this support the required support and keep it current. I reserve the right to delete
if it causes any problems. this support without notice if it causes any problems.
Current RHEL maintainer: none
Note: Android is supported in the driver according to Realtek. I will Note: Android is supported in the driver according to Realtek. I will
support knowledgable Android developers if they want to merge and keep support knowledgable Android developers if they want to merge and keep
current the required support (most likely just instructions about how to current the required support (most likely just instructions about how to
compile and maybe a modification or two to the Makefile). compile and maybe a modification or two to the Makefile).
Current Android maintainer: none
Note: OpenWRT is not supported. OpenWRT provides drivers for USB WiFi
adapters. OpenWRT provided drivers include support for the MT7921au
(AXE3000), MT7612u (AC1200), MT7610u (AC600) chipsets. It is a challenge
to use Realtek based adapters that use out-of-kernel drivers with
OpenWRT so it is strongly advised to use the already supported chipsets.
### Compatible Devices ### Compatible Devices
- EDUP EP-AC1651 (nano) (single-state, single-function) - EDUP EP-AC1651 (nano) (single-state, single-function)
@ -604,11 +617,12 @@ as good as it.
----- -----
To-Do: To Contribute:
- Test for installation in VM's. Fork this repository.
- Reduce the size of the README while keeping the needed information. Make your edits.
- Optimize scripts. TEST THEM!
Create a pull request.
----- -----

View File

@ -27,7 +27,7 @@ MODULE_VERSION(DRIVERVERSION);
* This declaration was created to resolve an error on Rockchip. * This declaration was created to resolve an error on Rockchip.
* You can modify or add flags in the fs/Makefile. * You can modify or add flags in the fs/Makefile.
*/ */
#if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 4, 0) #if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 10, 0)
MODULE_IMPORT_NS(VFS_internal_I_am_really_a_filesystem_and_am_NOT_a_driver); MODULE_IMPORT_NS(VFS_internal_I_am_really_a_filesystem_and_am_NOT_a_driver);
#endif #endif