Solução da comunidade

Wi-Fi MediaTek MT7920 no ZimaOS: o controlador estava carregado, faltava o firmware e a versão 1.7.0 resolveu o 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.

Esta fonte apresenta um diagnóstico técnico invulgarmente claro. O ZimaOS conseguia ver o dispositivo PCIe MediaTek MT7920, e o controlador correto mt7921e o controlador do kernel já estava carregado. O Wi-Fi continuava sem aparecer porque faltavam na imagem do ZimaOS dois blobs de firmware necessários à placa, o que produzia repetidamente erro -2 falhas ao carregar o firmware.

Essa lacuna foi resolvida na linha ZimaOS 1.7. Um membro da comunidade confirmou que ambos os ficheiros de firmware existiam na versão beta 1.7.0, e o autor original regressou mais tarde, a 16 de agosto de 2026, para dizer que estava a executar a versão 1.7 e que agora conseguia ligar-se à sua rede através de Wi-Fi. Esse é um sucesso confirmado pela fonte.

O MT7920 foi detetado na PCIe

A fonte mostrava:

03:00.0 Controlador de rede [0280]:
MEDIATEK Corp. Device [14c3:7920]

Isto excluiu a possibilidade de a placa PCIe estar completamente invisível. O hardware foi enumerado corretamente.

O controlador mt7921e já estava em utilização

O utilizador publicou então:

Controlador do kernel em utilização: mt7921e
Módulos do kernel: mt7921e

Isto é importante porque o problema não era “o ZimaOS não tem qualquer controlador MediaTek”. O controlador estava presente e associado à placa.

O registo do kernel identificou ficheiros de firmware em falta

Os erros decisivos foram:

mediatek/WIFI_RAM_CODE_MT7961_1a.bin
mediatek/WIFI_MT7961_patch_mcu_1a_2_hdr.bin

Ambos falharam ao carregar, com o erro -2, seguido de a inicialização do hardware falhou. Neste contexto, o erro -2 significa que não foi possível encontrar o ficheiro solicitado.

Porque é que o nmtui não conseguia disponibilizar a interface Wi-Fi

nmcli radio wifi podia indicar que o Wi-Fi estava ativado enquanto nmtui continuava sem apresentar uma ligação sem fios utilizável. A política de rádio estava ativada, mas o hardware nunca concluía a inicialização do firmware, pelo que o sistema operativo nunca obtinha uma interface Wi-Fi funcional para configurar.

O ZimaOS 1.7.0 adicionou os ficheiros de firmware necessários

Em julho de 2026, piterdan afirmou que o ZimaOS 1.7.0 incluía o firmware MT7920 em falta. gelbuilding confirmou depois, num ZimaCube a executar a versão 1.7.0-beta1, que ambos os ficheiros necessários existiam em /lib/firmware/mediatek/.

O autor original aguardou pela versão estável em vez de avançar para a beta.

O autor original confirmou que a versão estável 1.7 funcionava

A 16 de agosto, djmiek regressou e disse que estava agora a executar a versão 1.7 e que conseguia ligar-se à sua rede através de Wi-Fi. Isto resolve a questão original de forma mais convincente do que simplesmente encontrar os ficheiros de firmware numa versão beta.

Os utilizadores atuais devem atualizar antes de tentar alterar os controladores

A versão atual do ZimaOS é a 1.7.1. Se um MT7920 num sistema 1.6.x mais antigo apresentar exatamente os erros de firmware em falta desta fonte, atualize para a versão estável atual antes de considerar a injeção de firmware personalizado.

Use the current ZimaOS release baseline.

Utilize a versão estável atual do ZimaOS como referência.

lspci -nnk | Se o MT7920 continuar a falhar numa versão atual, recolha as mesmas evidências
grep -A3 7920
dmesg | ip link
dmesg | grep -i mt79

grep -i firmware

Se o controlador e o firmware carregarem, mas a interface continuar a falhar, o problema já não é o mesmo erro da fonte e requer um novo diagnóstico.

O RTL8125 a mostrar 1 Gbps era uma questão separada de negociação da ligação

O utilizador também reparou que um RTL8125 de 2,5 GbE mostrava 1 Gbps na interface. Uma NIC de 2,5 GbE só negoceia 1 Gbps quando está ligada a uma porta de comutador/router de 1 GbE ou a um equipamento na outra extremidade incompatível. Isso não tem qualquer relação com a falha do firmware do MT7920.

O firmware e o controlador são componentes diferentes

Essa distinção é importante nos pedidos de suporte. A fonte sobre o MT7920 é um exemplo útil de como “controlador em falta” é frequentemente demasiado vago. O módulo do kernel Linux continha o código necessário para controlar a família MediaTek, mas a placa também exigia firmware binário carregado no dispositivo durante a inicialização. Um componente estava presente; o outro não. lspci -nnk mostra um controlador em utilização, mas dmesg se forem comunicados ficheiros de firmware em falta, pedir à IceWhale que os adicione é mais preciso do que solicitar um controlador de kernel completamente novo.

Não copie primeiro blobs de firmware aleatórios de outra distribuição

Como o ZimaOS distribui o kernel e o firmware como uma imagem de appliance, copiar manualmente blobs para caminhos do sistema pode ser substituído por atualizações OTA ou criar combinações incompatíveis de firmware/kernel. O problema da fonte acabou por ser resolvido pela versão normal do ZimaOS que incluía os ficheiros necessários.

O Wi-Fi e o Bluetooth podem ser funções separadas na mesma placa

As placas combinadas expõem mais do que uma função e podem exigir caminhos separados de firmware/USB para o Bluetooth. A fonte apenas prova que o Wi-Fi começou a funcionar no ZimaOS 1.7. Se o Bluetooth continuar a falhar, recolha o ID próprio do dispositivo e o registo do kernel, em vez de presumir que a correção do Wi-Fi garante o funcionamento de ambos os rádios.

Perguntas frequentes sobre o MT7920

Faltava o controlador MT7920?

Não. A fonte mostrou mt7921e carregado e associado ao dispositivo.

O que estava em falta?

Eram necessários dois ficheiros de firmware MediaTek para a inicialização do hardware.

O utilizador original confirmou que o ZimaOS 1.7 resolveu o problema?

Sim. Mais tarde, confirmaram uma ligação Wi-Fi funcional no ZimaOS 1.7 estável.