Installer carte MediaTek MT7902

Procédure pour faire fonctionner la carte Wi-Fi/Bluetooth MediaTek MT7902 (Filogic 310) sur LMDE 7 (base Debian 13 « trixie »)

1. Symptômes

• Aucune icône Wi-Fi dans la barre des tâches.
• nmcli device ne montre que lo (aucune interface Wi-Fi).
• rfkill list ne renvoie rien.
• dmesg affiche en boucle :

  bluetooth hci0: firmware: failed to load mediatek/BT_RAM_CODE_MT7902_1_1_hdr.bin (-2)
  

2. Cause

2. Firmware absent : le paquet Debian firmware-mediatek (version 20250410) ne contient pas les fichiers MT7902.

3. Prérequis

Il faut un accès internet temporaire par :

• câble Ethernet, ou
• partage de connexion USB depuis un téléphone (Android : Paramètres → Partage de connexion → USB).

4. Identifier la carte

lspci
lspci -k -s 01:00.0

On doit voir : MEDIATEK Corp. MT7902 802.11ax PCIe Wireless Network Adapter [Filogic 310].

5. Installer un noyau récent (backports)

Si les backports ne sont pas encore activés, ajouter dans /etc/apt/sources.list.d/backports.list :

deb http://deb.debian.org/debian trixie-backports main

Puis :

sudo apt update
sudo apt install -t trixie-backports linux-image-amd64 linux-headers-amd64
sudo reboot

Vérifier après redémarrage :

uname -r

Résultat attendu : un noyau 7.x (ici 7.2.12+deb13-amd64).

Si GRUB démarre sur l'ancien noyau : Options avancées → choisir le noyau récent.

Après cette étape, lspci -k -s 01:00.0 affiche Kernel driver in use: mt7921e. C'est normal : le pilote mt7921e prend en charge la MT7902 dans les noyaux récents. Mais sans firmware, l'interface ne se crée pas.

6. Récupérer le firmware MT7902

On clone uniquement le dossier mediatek du dépôt officiel linux-firmware.

sudo apt install git
cd ~
git clone --depth 1 --filter=blob:none --sparse https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git
cd linux-firmware
git sparse-checkout set mediatek
find ~/linux-firmware -iname "*7902*"

Fichiers attendus :

mediatek/BT_RAM_CODE_MT7902_1_1_hdr.bin
mediatek/WIFI_MT7902_patch_mcu_1_1_hdr.bin
mediatek/WIFI_RAM_CODE_MT7902_1.bin

7. Installer le firmware

sudo mkdir -p /lib/firmware/mediatek
sudo cp ~/linux-firmware/mediatek/*7902* /lib/firmware/mediatek/
sudo reboot

8. Vérification

nmcli device
rfkill list
sudo dmesg | grep -i -E "mt79|wifi"

• Une interface de type wlan0 / wlp1s0 doit apparaître.
• L'icône Wi-Fi doit apparaître dans la barre des tâches.
• Les erreurs Bluetooth failed to load ... BT_RAM_CODE_MT7902 doivent disparaître.

9. Notes

• Le firmware copié à la main dans /lib/firmware/ survit aux mises à jour du noyau. Il peut être remplacé plus tard par une version plus récente du paquet firmware-mediatek de Debian.