Soluzione della community

MediaTek MT7920 Wi-Fi su ZimaOS: il driver era caricato, mancava il firmware e la versione 1.7.0 ha risolto il problema

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.

Questa fonte presenta una diagnosi tecnica insolitamente chiara. ZimaOS riusciva a vedere il dispositivo PCIe MediaTek MT7920 e il corretto mt7921e il driver del kernel era già stato caricato. Il Wi-Fi continuava a non comparire perché nell'immagine di ZimaOS mancavano due blob firmware richiesti dalla scheda, causando ripetuti errore -2 errori di caricamento del firmware.

Questa lacuna è stata colmata nella linea ZimaOS 1.7. Un membro della community ha verificato che entrambi i file firmware erano presenti nella versione beta 1.7.0 e l'autore originale del post è poi tornato il 16 agosto 2026 per dire che utilizzava la versione 1.7 e ora riusciva a connettersi alla rete tramite Wi-Fi. Si tratta di un successo confermato dalla fonte.

L'MT7920 è stato rilevato su PCIe

La fonte mostrava:

03:00.0 Controller di rete [0280]:
MEDIATEK Corp. Device [14c3:7920]

Questo ha escluso che la scheda PCIe fosse completamente invisibile. L'hardware era stato enumerato correttamente.

Il driver mt7921e era già in uso

L'utente ha quindi pubblicato:

Driver del kernel in uso: mt7921e
Moduli del kernel: mt7921e

Questo è importante perché il problema non era che “ZimaOS non disponeva affatto di un driver MediaTek”. Il driver era presente e associato alla scheda.

Il log del kernel ha identificato i file firmware mancanti

Gli errori decisivi erano:

mediatek/WIFI_RAM_CODE_MT7961_1a.bin
mediatek/WIFI_MT7961_patch_mcu_1a_2_hdr.bin

Entrambi non sono riusciti a essere caricati con l'errore -2, seguito da inizializzazione dell'hardware non riuscitaIn questo contesto, l'errore -2 significa che non è stato possibile trovare il file richiesto.

Perché nmtui non poteva offrire l'interfaccia Wi-Fi

nmcli radio wifi poteva indicare che il Wi-Fi era abilitato mentre nmtui continuava a non mostrare alcuna connessione wireless utilizzabile. La policy radio era abilitata, ma l'hardware non completava mai l'inizializzazione del firmware, quindi il sistema operativo non disponeva di un'interfaccia Wi-Fi funzionante da configurare.

ZimaOS 1.7.0 ha aggiunto i file firmware richiesti

A luglio 2026, piterdan ha riferito che ZimaOS 1.7.0 includeva il firmware mancante dell'MT7920. gelbuilding ha poi verificato su uno ZimaCube con ZimaOS 1.7.0-beta1 che entrambi i file richiesti erano presenti in /lib/firmware/mediatek/.

L'autore originale del post ha aspettato la versione stabile invece di passare alla beta.

L'autore originale del post ha confermato che la versione stabile 1.7 funzionava

Il 16 agosto, djmiek è tornato e ha riferito che ora utilizzava la versione 1.7 e riusciva a connettersi alla rete tramite Wi-Fi. Questo chiude la questione originale in modo più solido rispetto al semplice ritrovamento dei file del firmware in una versione beta.

Gli utenti attuali dovrebbero aggiornare prima di tentare interventi sui driver

La versione attuale di ZimaOS è la 1.7.1. Se un MT7920 su un sistema 1.6.x precedente mostra gli esatti errori relativi al firmware mancante riportati in questa fonte, aggiorna alla versione stabile attuale prima di valutare l'iniezione di firmware personalizzato.

Use the current ZimaOS release baseline.

Usa la versione stabile attuale di ZimaOS come riferimento.

lspci -nnk | Se l’MT7920 continua a non funzionare su una build attuale, acquisisci le stesse informazioni
grep -A3 7920
dmesg | ip link
dmesg | grep -i mt79

grep -i firmware

Se driver e firmware vengono caricati entrambi, ma l’interfaccia continua a non funzionare, il problema non è più lo stesso bug della fonte e richiede una nuova diagnosi.

La velocità di 1 Gbps mostrata dall’RTL8125 era una questione separata di negoziazione del collegamento

L’utente ha inoltre notato che un RTL8125 da 2,5 GbE mostrava 1 Gbps nell’interfaccia. Una scheda di rete da 2,5 GbE negozierà solo 1 Gbps quando è collegata a una porta di uno switch/router da 1 GbE o a un dispositivo con velocità di collegamento incompatibile. Questo non ha nulla a che vedere con il problema del firmware MT7920.

Firmware e driver sono componenti diversi

Questa distinzione è importante nelle segnalazioni all’assistenza. La fonte sull’MT7920 è un esempio utile del motivo per cui “driver mancante” è spesso troppo vago. Il modulo del kernel Linux conteneva il codice necessario per controllare la famiglia MediaTek, ma la scheda richiedeva anche il firmware binario da caricare nel dispositivo durante l’inizializzazione. Un componente era presente; l’altro no. lspci -nnk mostra un driver in uso, ma dmesg segnala firmware mancante, chiedere a IceWhale di aggiungere i file firmware è più preciso che richiedere un driver del kernel completamente nuovo.

Non copiare prima blob firmware casuali da un’altra distribuzione

Poiché ZimaOS include kernel e firmware in un’immagine appliance, la copia manuale dei blob nei percorsi di sistema può essere sovrascritta dagli aggiornamenti OTA o creare combinazioni firmware/kernel non corrispondenti. Il problema della fonte è stato infine risolto dalla normale versione di ZimaOS contenente i file richiesti.

Wi-Fi e Bluetooth possono essere funzioni separate sulla stessa scheda

Le schede combo espongono più di una funzione e possono richiedere percorsi firmware/USB separati per il Bluetooth. La fonte dimostra solo che la parte Wi-Fi ha iniziato a funzionare su ZimaOS 1.7. Se il Bluetooth continua a non funzionare, acquisisci il relativo ID del dispositivo e il log del kernel invece di presumere che la correzione del Wi-Fi garantisca il funzionamento di entrambe le radio.

FAQ su MT7920

Mancava il driver MT7920?

No. La fonte mostrava mt7921e caricato e associato al dispositivo.

Che cosa mancava?

Erano necessari due file firmware MediaTek per l’inizializzazione dell’hardware.

L’utente originale ha confermato che ZimaOS 1.7 ha risolto il problema?

Sì. In seguito hanno segnalato una connessione Wi-Fi funzionante su ZimaOS 1.7 stabile.