Requirements¶
System Requirements¶
Kernel Version¶
Minimum Kernel: 6.17
The DKMS package requires kernel 6.17 or newer. For older kernels, use the patch method instead.
| Kernel | DKMS Support | Notes |
|---|---|---|
| 6.19-rc | Yes | Release candidate |
| 6.18.x | Yes | Recommended |
| 6.17.x | Yes | Minimum supported |
| 6.8 - 6.16 | No | Use kernel patches |
| < 6.8 | No | Not supported |
Dependencies¶
The following packages are required:
Clang-Built Kernels¶
Some distributions (like CachyOS) build their kernels with Clang instead of GCC. DKMS modules must be built with the same compiler.
To check if your kernel uses Clang:
If it shows CONFIG_CC_IS_CLANG=y, install clang and lld. The DKMS build system auto-detects this.
Hardware Requirements¶
Supported Chipsets¶
| Chipset | Interface | WiFi Standard | Status |
|---|---|---|---|
| MT7925 | PCIe | WiFi 7 (802.11be) | Full support |
| MT7921 | PCIe | WiFi 6E (802.11ax) | Full support |
| MT7921 | USB | WiFi 6E (802.11ax) | Full support |
| MT7921 | SDIO | WiFi 6E (802.11ax) | Full support |
Identifying Your Hardware¶
# Check for PCIe devices
lspci -nn | grep -i "14c3:7925\|14c3:7921"
# Check for USB devices
lsusb | grep -i "0e8d:7961"
Example output for MT7925:
Firmware¶
The driver requires firmware files from linux-firmware:
| Chipset | Firmware Files |
|---|---|
| MT7925 | /lib/firmware/mediatek/mt7925/WIFI_* |
| MT7921 | /lib/firmware/mediatek/WIFI_*_MT7921* |
Verify firmware is installed:
ls /lib/firmware/mediatek/mt7925/ 2>/dev/null || echo "MT7925 firmware not found"
ls /lib/firmware/mediatek/WIFI_*MT7921* 2>/dev/null || echo "MT7921 firmware not found"
Update linux-firmware
If firmware files are missing, update your linux-firmware package to the latest version.
Secure Boot¶
If Secure Boot is enabled, DKMS modules must be signed with a Machine Owner Key (MOK).
Check Secure Boot Status¶
Configure MOK for DKMS¶
Most distributions configure this automatically. If you see signature errors:
- Generate a MOK key pair (if not exists)
- Enroll the key with
mokutil --import - Reboot and complete enrollment
- Rebuild DKMS modules
See your distribution's documentation for specific instructions.