Support WiFi et Bluetooth des chipsets Mediatek MT7902 sous Linux 24.04

Le mois dernier, selon cnx-software, les utilisateurs ont découvert que les chipsets Mediatek MT7902 équipés de WiFi 6E et de Bluetooth 5.x avaient enfin obtenu des pilotes sous Linux principal, devant figurer dans la version Linux 7.0.

Ces modules sans fil sont intégrés dans de nombreux ordinateurs portables Windows, mais les pilotes Linux étaient attendus depuis près de deux ans. Bien que l’on puisse attendre l’intégration des pilotes dans votre distribution, l’utilisateur « hmtheyboy154 » a pris l’initiative de rétroporter les pilotes des versions Linux 6.6 à 6.19. Étant moi-même propriétaire d’un ordinateur portable ASUS Vivobook 16, j’ai testé ces pilotes sur Ubuntu 24.04, et ils devraient également fonctionner sur d’autres distributions Linux.

Il est important de noter que cette méthode d’installation ne fonctionne qu’avec le pilote PCIe. Si vous possédez un module SDIO, vous devrez chercher une autre solution. Mon ordinateur portable avec Ubuntu 24.04 utilise le module PCIe MT7902 (AW-XB552NF) :

Installation rapide des pilotes en 4 étapes sur Ubuntu 24.04

L’installation des pilotes nécessite quelques étapes simples :

Tout d’abord, clonez le dépôt GitHub avec la commande suivante :

<br /> git clone https://github.com/hmtheboy154/mt7902<br /> cd mt7902/<br /> make -j8<br /> sudo make install<br />

Pour confirmer le bon fonctionnement, assurez-vous que le firmware est bien installé, même si celui-ci est souvent déjà inclus dans votre distribution.

Après l’installation, il suffit de redémarrer votre portable, ou d’utiliser la commande modprobe pour initialiser le module :

Ainsi, une fois le WiFi activé sur Ubuntu 24.04, je peux me connecter à mon point d’accès avec succès.

Le journal du noyau indique des connexions réussies comme suit :

<br /> [1014428.026033] wlo1 : désauthentification à partir de 3c:cd:57:f5:af:91 par choix local (Raison : 3=DEAUTH_LEAVING)<br /> [1014439.871042] mt7902e 0000:02:00.0 : révision ASIC : 79020000<br /> [1014439.966746] mt7902e 0000:02:00.0 : version matérielle/logicielle : 0x8a108a10, heure de construction : 20251212032046a<br /> [1014439.988460] mt7902e 0000:02:00.0 : version du micrologiciel WM : ____000000, heure de construction : 20251212032127<br /> [1014440.940270] mt7902e 0000:02:00.0 wlo1 : renommé de wlan0<br /> [1014443.452779] wlo1 : authentifier avec 3c:cd:57:f5:af:91 (adresse locale=10:68:38:3a:0d:da)<br /> [1014443.452797] wlo1 : envoyer l’authentification à 3c:cd:57:f5:af:91 (essai 1/3)<br /> [1014443.467182] wlo1 : authentifié<br /> [1014443.468008] wlo1 : associer avec 3c:cd:57:f5:af:91 (essai 1/3)<br /> [1014443.507278] wlo1 : RX AssocResp de 3c:cd:57:f5:af:91 (capab=0x511 status=0 aid=3)<br /> [1014443.543479] wlo1 : associé<br /> [1014443.545773] wlo1 : limitation de la puissance d’émission à 27 (30 – 3) dBm comme annoncé par 3c:cd:57:f5:af:91<br />

Performances du MT7902 : 400 à 450 Mbps sur WiFi 5 GHz

Lors d’un test rapide avec iperf3 via une connexion WiFi 5 GHz à environ 2 mètres d’un Xiaomi Mi Router AX6000, les résultats étaient impressionnants. Au téléchargement, les débits ont atteint en moyenne :

<br /> jaufranc@Raspberryme-LAPTOP-5:~$ iperf3 -t 60 -c 192.168.31.12 -i 10 -R<br /> Connexion à l’hôte 192.168.31.12, port 5201<br /> Mode inversé, l’hôte distant 192.168.31.12 envoie<br /> [ 5] port local 192.168.31.152 41870 connecté au port 192.168.31.12 5201<br /> [ ID] Débit de transfert par intervalle<br /> [ 5] 0,00-10,01 s 528 Mo 443 Mbits/s<br /> [ 5] 10.01-20.01 s 530 Mo 444 Mbits/s<br /> [ 5] 20.01-30.01 s 477 Mo 400 Mbits/s<br /> [ 5] 30,01-40,01 s 484 Mo 406 Mbits/s<br /> [ 5] 40,01-50,01 s 432 Mo 362 Mbits/s<br /> [ 5] 50,01-60,01 s 493 Mo 414 Mbits/s<br /> – – – – – – – – – – – – – – – – – – – – – – – – – – – –<br /> [ ID] Retrait du débit binaire de transfert par intervalle<br /> [ 5] 0,00-60,01 s 2,88 Go 412 Mbits/s<br /> iperf Terminé.<br />

Le débit télécharge et reçoit des vitesses très satisfaisantes, oscillant autour de 400 à 450 Mbps, ce qui est suffisant compte tenu de ma connexion avec une vitesse totale de 600 Mbps et un forfait de mon FAI limité à 300 Mbps en téléchargement et en envoi.

Concernant le Bluetooth, initialement, je n’ai pas réussi à l’activer dans les paramètres. J’ai finalement découvert qu’il fallait utiliser une autre branche du même dépôt GitHub :

<br /> git clone https://github.com/hmtheboy154/mt7902 -b bluetooth_backport btusb_mt7902<br /> cd btusb_mt7902/<br /> make -j8<br /> sudo make install<br /> sudo make install_fw<br /> sudo rmmod btusb<br /> sudo rmmod btmtk<br /> sudo modprobe btusb_mt7902<br />

Cette commande m’a permis d’activer le Bluetooth et de coupler mon smartphone au portable pour le transfert de fichiers.

Il est à noter que les modules btusb et btmtk entrent en conflit avec btusb_mt7902, ce qui m’a contraint à les supprimer. Sinon, une erreur apparaissait :

<br /> jaufranc@Raspberryme-LAPTOP-5:~/btusb_mt7902$ sudo modprobe btusb_mt7902<br /> modprobe : ERREUR : impossible d’insérer ‘btusb_mt7902’ : erreur de format d’exécution<br />

Pour éviter tout conflit à l’avenir, il convient de créer un fichier /etc/modprobe.d/blacklist_btusb.conf.

Finalement, bien que la prise en charge WiFi et Bluetooth sous Linux pour les modules MT7902 ait été longue à se mettre en place, le processus d’installation est désormais simple sur Ubuntu 24.04, permettant une utilisation rapide sans attendre la version officielle.