Solution communautaire

Wi-Fi MediaTek MT7920 sur ZimaOS : le pilote était chargé, le micrologiciel manquait, et la version 1.7.0 a résolu le problème

A May-August 2026 thread where the MT7920 PCIe device was visible and mt7921e loaded, but two required MediaTek firmware files were missing with error -2. Community members verified those files were present in ZimaOS 1.7.0 beta, and the original poster later confirmed stable 1.7.0 connected successfully over Wi-Fi.

Cette source présente un diagnostic technique particulièrement clair. ZimaOS pouvait détecter le périphérique PCIe MediaTek MT7920, et le pilote approprié mt7921e le pilote du noyau était déjà chargé. Le Wi-Fi n’apparaissait toujours pas, car deux fichiers binaires de micrologiciel requis par la carte manquaient dans l’image ZimaOS, ce qui produisait de manière répétée erreur -2 échecs de chargement du micrologiciel.

Cet écart a été comblé dans la branche ZimaOS 1.7. Un membre de la communauté a vérifié que les deux fichiers de micrologiciel existaient dans la version bêta 1.7.0, puis l’auteur d’origine est revenu le 16 août 2026 pour dire qu’il utilisait la version 1.7 et pouvait désormais se connecter à son réseau en Wi-Fi. Il s’agit d’une réussite confirmée par la source.

Le MT7920 a été détecté sur le bus PCIe

La source indiquait :

03:00.0 Contrôleur réseau [0280] :
MEDIATEK Corp. Device [14c3:7920]

Cela excluait une carte PCIe totalement invisible. Le matériel était correctement énuméré.

Le pilote mt7921e était déjà utilisé

L’utilisateur a ensuite publié :

Pilote du noyau utilisé : mt7921e
Modules du noyau : mt7921e

C’est important, car le problème n’était pas que « ZimaOS n’a aucun pilote MediaTek ». Le pilote était présent et associé à la carte.

Le journal du noyau a identifié les fichiers de micrologiciel manquants

Les erreurs déterminantes étaient les suivantes :

mediatek/WIFI_RAM_CODE_MT7961_1a.bin
mediatek/WIFI_MT7961_patch_mcu_1a_2_hdr.bin

Les deux ont échoué lors du chargement avec l’erreur -2, suivi de échec de l’initialisation du matérielDans ce contexte, l’erreur -2 signifie que le fichier demandé est introuvable.

Pourquoi nmtui ne pouvait pas proposer l’interface Wi-Fi

nmcli radio wifi pouvait indiquer que le Wi-Fi était activé alors que nmtui affichait toujours aucune connexion sans fil utilisable. La politique radio était activée, mais le matériel n’a jamais terminé son initialisation du micrologiciel ; le système d’exploitation n’a donc jamais obtenu d’interface Wi-Fi fonctionnelle à configurer.

ZimaOS 1.7.0 a ajouté les fichiers de micrologiciel requis

En juillet 2026, piterdan a indiqué que ZimaOS 1.7.0 incluait le micrologiciel MT7920 manquant. gelbuilding a ensuite vérifié sur un ZimaCube exécutant 1.7.0-beta1 que les deux fichiers requis se trouvaient sous /lib/firmware/mediatek/.

L’auteur d’origine a attendu la version stable plutôt que de passer à la version bêta.

L’auteur d’origine a confirmé que la version stable 1.7 fonctionnait

Le 16 août, djmiek est revenu pour dire qu’il utilisait désormais la version 1.7 et pouvait se connecter à son réseau en Wi-Fi. Cela clôt le problème initial de manière plus probante que la simple découverte des fichiers de micrologiciel dans une version bêta.

Les utilisateurs actuels doivent effectuer la mise à jour avant toute tentative de modification du pilote

La version actuelle de ZimaOS est la 1.7.1. Si un MT7920 sur un système 1.6.x plus ancien affiche les erreurs exactes de micrologiciel manquant de cette source, mettez à jour vers la version stable actuelle avant d’envisager l’injection d’un micrologiciel personnalisé.

Use the current ZimaOS release baseline.

Utilisez la version stable actuelle de ZimaOS comme référence.

lspci -nnk | Si le MT7920 ne fonctionne toujours pas avec une version actuelle, recueillez les mêmes éléments
grep -A3 7920
dmesg | ip link
dmesg | grep -i mt79

grep -i firmware

Si le pilote et le micrologiciel se chargent tous deux, mais que l’interface ne fonctionne toujours pas, le problème ne correspond plus au même bogue initial et nécessite un nouveau diagnostic.

Le RTL8125 affichant 1 Gbit/s concernait un problème distinct de négociation de liaison

L’utilisateur a également remarqué qu’un RTL8125 2,5 GbE affichait 1 Gbit/s dans l’interface. Une carte réseau 2,5 GbE ne négociera que 1 Gbit/s lorsqu’elle est connectée au port d’un commutateur ou d’un routeur 1 GbE, ou à un équipement distant incompatible. Cela n’a rien à voir avec le problème de micrologiciel du MT7920.

Le micrologiciel et le pilote sont deux éléments distincts

Cette distinction est importante dans les rapports d’assistance. La source concernant le MT7920 est un bon exemple de la raison pour laquelle « pilote manquant » est souvent trop vague. Le module du noyau Linux contenait le code nécessaire pour contrôler la famille MediaTek, mais la carte nécessitait également un micrologiciel binaire chargé dans le périphérique pendant l’initialisation. Un composant était présent ; l’autre ne l’était pas. lspci -nnk indique qu’un pilote est utilisé, mais dmesg signale un micrologiciel manquant, demander à IceWhale d’ajouter les fichiers de micrologiciel est plus précis que de demander un tout nouveau pilote de noyau.

Ne copiez pas d’abord des fichiers binaires de micrologiciel provenant au hasard d’une autre distribution

Comme ZimaOS regroupe son noyau et son micrologiciel dans une image dédiée, la copie manuelle de fichiers binaires dans les chemins système peut être écrasée par les mises à jour OTA ou créer des combinaisons incompatibles de micrologiciel et de noyau. Le problème a finalement été corrigé par la version normale de ZimaOS contenant les fichiers requis.

Le Wi-Fi et le Bluetooth peuvent être des fonctions distinctes sur la même carte

Les cartes combinées exposent plusieurs fonctions et peuvent nécessiter des chemins distincts pour le micrologiciel et l’USB afin d’activer le Bluetooth. La source prouve uniquement que la partie Wi-Fi a commencé à fonctionner sous ZimaOS 1.7. Si le Bluetooth ne fonctionne toujours pas, relevez son propre identifiant de périphérique et son journal du noyau au lieu de supposer que la correction du Wi-Fi garantit le fonctionnement des deux radios.

FAQ MT7920

Le pilote MT7920 manquait-il ?

Non. La source indiquait mt7921e chargé et associé au périphérique.

Qu’est-ce qui manquait ?

Deux fichiers de micrologiciel MediaTek requis pour l’initialisation matérielle.

L’utilisateur initial a-t-il confirmé que ZimaOS 1.7 avait résolu le problème ?

Oui. Ils ont ensuite signalé une connexion Wi-Fi fonctionnelle sur la version stable de ZimaOS 1.7.