Skip to main content

Driver Registry

The Driver Registry maps each wireless chipset to the ALFA adapters that use it, the driver type, and the in-kernel status on modern Linux kernels. This mirrors the linux-compatibility-matrix and the per-chip driver guides under /alfa-network/drivers/.

Chipset Table

ChipsetAdaptersDriver bindingIn-kernel?Driver guide
MT7612UAWUS036ACMmt76x2u✅ In-kernelGuide
MT7610UAWUS036ACHMmt76x0u✅ In-kernelGuide
MT7921AUNAWUS036AXM, AWUS036AXMLmt7921u✅ In-kernelGuide
RTL8812AUAWUS036ACHOut-of-tree / DKMS❌ Not in-kernelGuide
RTL8811AUAWUS036ACSOut-of-tree / DKMS❌ Not in-kernelGuide
RTL8832BUAWUS036AX, AWUS036AXEROut-of-tree / DKMS❌ Not in-kernelGuide
RTL8821CUAWUS036EACSOut-of-tree / DKMS❌ Not in-kernelGuide

Driver Types

  • In-kernel (mainline) — Included in the Linux kernel; the adapter typically works out of the box on a current kernel with no extra installation. MediaTek (mt76x2u / mt76x0u / mt7921u) adapters fall into this category.
  • Out-of-tree / DKMS — The driver source is maintained outside the kernel. It must be compiled and installed, ideally via DKMS so it survives kernel updates. All Realtek chipsets in this registry fall into this category.

Kernel Updates

For out-of-tree drivers, the single most common failure is a kernel update breaking the module because the pre-built module no longer matches the running kernel.

# Rebuild DKMS modules for the currently running kernel
sudo dkms autoinstall

# Or, for a convenient apt-managed rebuild on Debian/Ubuntu
sudo apt install --reinstall linux-headers-$(uname -r)

See also the FAQ and troubleshooting.

Driver Setup Guides

Maintenance

Keep this registry in sync whenever a driver guide, adapter product page, or the compatibility matrix is edited, so the cross-references never drift.