Soluzione della community

Wi-Fi MediaTek su ZimaOS: cronologia dei driver MT7921/MT7925, risultati della versione 1.5.4 e attuali limiti del supporto

A December 2025-April 2026 driver-request thread where MT7921 failed because mt7921e was missing, IceWhale promised to add MediaTek modules, and one MT7925 user later confirmed their card started working on ZimaOS 1.5.4. Other MediaTek variants remained mixed or unverified.

Questo thread della community mostra progressi concreti sui driver, ma non garantisce in modo generale che ogni adattatore Wi‑Fi MediaTek funzioni su ogni build attuale di ZimaOS. L’utente originale con MT7921 ha scoperto che il solo firmware non era sufficiente, perché mancava proprio il modulo del kernel mt7921e. Zima-Jerry ha dichiarato che IceWhale lo avrebbe aggiunto nella versione successiva.

In seguito, IceWhale si è impegnata anche a supportare i driver relativi a MT7925 e un utente PCIe con MT7925 ha riferito esplicitamente che la scheda aveva iniziato a funzionare su ZimaOS 1.5.4. Un utente con MT7925 USB ha poi segnalato che l’adattatore aveva funzionato solo per alcuni giorni prima di scomparire fino al riavvio, quindi “rilevato” e “stabile a lungo termine” non erano equivalenti.

Il problema originale dell’MT7921 era la mancanza di un modulo del kernel

L’utente ha eseguito modprobe mt7921e e ZimaOS 1.5.3 ha segnalato che il modulo non esisteva nel kernel in esecuzione. Zima-Jerry ha risposto che lo avrebbe aggiunto.

IceWhale ha accettato di aggiungere anche il supporto per i driver MT7925

Un altro utente ha richiesto il supporto PCIe per MT7925 e, in seguito, un altro utente ha richiesto le varianti USB utilizzate dagli adattatori Wi‑Fi 7. Zima-Jerry ha dichiarato che questi driver sarebbero stati aggiunti nella nuova versione.

Un utente con MT7925 ha confermato il funzionamento su ZimaOS 1.5.4

Il 4 febbraio 2026, esahin è tornato riferendo che la propria scheda MediaTek MT7925 aveva iniziato a funzionare su ZimaOS 1.5.4. Si tratta di una verifica dell’utente confermata dalla fonte per quel percorso hardware.

Un adattatore MT7925 USB ha mostrato in seguito problemi di stabilità

Un utente con un adattatore USB Netgear MT7925 ha riferito che il dispositivo era stato rilevato dopo l’aggiunta del driver, ma aveva smesso di funzionare dopo alcuni giorni e richiedeva un riavvio e una nuova configurazione tramite nmtui. Nel thread non è stata pubblicata alcuna soluzione definitiva.

L’MT7922 era un caso diverso

Zima-Jerry ha dichiarato che il driver MT7922 era già incluso. Un utente con la versione 1.5.3 ha comunque segnalato l’assenza di reti Wi‑Fi e un modulo mancante, dimostrando che è necessario verificare il chipset esatto, il tipo di bus, l’ID del dispositivo e il modulo del kernel.

Console di ZimaOS su una scheda madre MSI di terze parti che mostra l’assenza di un indirizzo di rete mentre continuava la risoluzione dei problemi del Wi‑Fi MediaTek
Il sistema d’origine ha avviato ZimaOS, ma non è riuscito a ottenere l’accesso alla rete tramite il percorso wireless non supportato.

Le indicazioni ufficiali attuali sul Wi‑Fi sono più solide per Intel AX210

La documentazione hardware attuale di IceWhale include una guida dedicata di ZimaOS per AX210 e un elenco degli adattatori compatibili. Le varianti MediaTek citate in questo thread non sono tutte elencate come adattatori attualmente garantiti.

Quando acquisti nuovo hardware, consulta l’elenco attuale degli adattatori di rete compatibili con ZimaOS.

Verifica il dispositivo e il modulo esatti su una build aggiornata

lspci -nn
lsusb
uname -r
modinfo mt7921e
ip link

Usa quindi nmtui solo dopo che il kernel ha reso disponibile un’interfaccia wireless utilizzabile.

I file firmware e i moduli del kernel sono dipendenze diverse

L’utente originale con MT7921 aveva già copiato il firmware, ma modprobe mt7921e continuava a non funzionare perché il modulo del kernel era assente. Il firmware non può compensare l’assenza di un driver che non è stato incluso nel kernel in esecuzione o fornito per quel kernel.

Durante la risoluzione dei problemi, verifica sia l’ID del dispositivo sia l’esistenza del modulo corrispondente prima di sostituire ripetutamente i file firmware.

Gli adattatori MediaTek PCIe e USB richiedono percorsi driver diversi

Due adattatori venduti con un nome commerciale MT7925 simile possono utilizzare bus e moduli del kernel diversi. Un risultato positivo su PCIe non convalida automaticamente un dongle USB, e la fonte ha dimostrato in seguito proprio questa distinzione con un dispositivo USB soggetto a malfunzionamenti intermittenti.

Mantieni un percorso di ripristino cablato durante i test del Wi‑Fi

Se ZimaOS dipende da un adattatore wireless sperimentale come unica connessione di rete, un arresto anomalo del driver può rendere inaccessibili sia la WebUI sia SSH. Durante la configurazione, mantieni collegata la rete Ethernet oppure assicurati di avere accesso alla console locale, così da poter raccogliere i log dopo la perdita del Wi‑Fi.

Il rilevamento è solo il primo test di compatibilità

Una verifica utile del Wi‑Fi dovrebbe includere la persistenza dopo il riavvio, diversi giorni di funzionamento, la riconnessione dopo il riavvio del punto di accesso, trasferimenti prolungati e il ripristino dopo le transizioni di sospensione o degli stati di alimentazione, se utilizzate. Nel caso dell’MT7925 USB riportato dalla fonte, il dispositivo aveva funzionato inizialmente ma aveva smesso di funzionare dopo alcuni giorni: per questo una singola scansione riuscita non è sufficiente.

Per un NAS di produzione, preferisci un adattatore presente nell’elenco di compatibilità attuale

Le aggiunte di driver della community sono preziose per la sperimentazione, ma un NAS destinato a fornire backup o accesso remoto trae vantaggio da un chipset documentato attivamente da IceWhale. Se il Wi‑Fi è opzionale, la rete Ethernet cablata resta la soluzione server più semplice e deterministica.

Domande frequenti sul Wi‑Fi MediaTek

MT7925 ha funzionato almeno per un utente della fonte sulla versione 1.5.4?

Sì.

Ogni adattatore MT7925 è rimasto stabile?

No. Un utente con un adattatore USB ha riferito che il dispositivo era scomparso dopo alcuni giorni fino al riavvio.

La fonte dimostra che ogni dispositivo MT7921/MT7922/MT7925 funziona sulle versioni attuali di ZimaOS?

No. È ancora necessario verificare l’ID esatto del dispositivo, il tipo di bus, il modulo e la versione attuale.