Solução da comunidade

Wi-Fi MediaTek no ZimaOS: histórico dos controladores MT7921/MT7925, resultados da versão 1.5.4 e limitações atuais do suporte

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.

Este tópico de origem mostra progressos reais ao nível dos controladores, mas não constitui uma promessa geral de que todos os adaptadores Wi-Fi MediaTek funcionam em todas as versões atuais do ZimaOS. O utilizador original do MT7921 descobriu que o firmware, por si só, não era suficiente, porque o próprio módulo de kernel mt7921e estava em falta. Zima-Jerry afirmou que a IceWhale o adicionaria na versão seguinte.

Mais tarde, a IceWhale também se comprometeu a disponibilizar controladores relacionados com o MT7925, e um utilizador de um MT7925 PCIe comunicou explicitamente que a placa começou a funcionar no ZimaOS 1.5.4. Posteriormente, um utilizador de um MT7925 USB informou que o adaptador funcionou apenas durante alguns dias antes de desaparecer até ao reinício, pelo que “detetado” e “estável a longo prazo” não eram equivalentes.

A Falha Original do MT7921 Devia-se à Ausência de um Módulo de Kernel

O utilizador executou modprobe mt7921e e o ZimaOS 1.5.3 informou que o módulo não existia no kernel em execução. Zima-Jerry respondeu que o adicionaria.

A IceWhale Também Concordou em Adicionar Suporte para os Controladores MT7925

Outro utilizador solicitou suporte para MT7925 PCIe e, mais tarde, outro utilizador solicitou as variantes USB utilizadas pelos adaptadores Wi-Fi 7. Zima-Jerry afirmou que esses controladores deveriam ser adicionados na nova versão.

Um Utilizador de MT7925 Confirmou o Sucesso no ZimaOS 1.5.4

Em 4 de fevereiro de 2026, esahin regressou e afirmou que a sua placa MediaTek MT7925 começou a funcionar no ZimaOS 1.5.4. Esta é uma confirmação de utilizador, baseada na fonte, para esse percurso de hardware.

Um Adaptador MT7925 USB Apresentou Posteriormente Problemas de Estabilidade

Um utilizador de um adaptador USB MT7925 da Netgear afirmou que o dispositivo foi detetado após a adição do controlador, mas deixou de funcionar passados vários dias e precisou de um reinício, além de uma nova configuração através do nmtui. Não foi publicada qualquer solução final no tópico.

O MT7922 Era um Caso Diferente

Zima-Jerry afirmou que o controlador MT7922 já estava incluído. Ainda assim, um utilizador da versão 1.5.3 comunicou que não existiam redes Wi-Fi visíveis e que faltava um módulo, demonstrando que é necessário verificar o chipset exato, o tipo de barramento, o ID do dispositivo e o módulo de kernel.

Consola do ZimaOS numa motherboard MSI de terceiros, sem endereço de rede, enquanto prosseguia a resolução de problemas do Wi-Fi MediaTek
O sistema de origem arrancou o ZimaOS, mas não conseguiu obter acesso à rede através do percurso sem fios não suportado.

As Orientações Oficiais Atuais para Wi-Fi São Mais Sólidas para o Intel AX210

A documentação de hardware atual da IceWhale inclui um guia dedicado do AX210 para o ZimaOS e uma lista de adaptadores compatíveis. As variantes MediaTek deste tópico não estão todas enumeradas nessa lista como adaptadores atuais garantidos.

Consulte a lista atual de adaptadores de rede compatíveis com o ZimaOS ao comprar hardware novo.

Verifique o Dispositivo e o Módulo Exatos numa Versão Atual

lspci -nn
lsusb
uname -r
modinfo mt7921e
ip link

Depois, utilize o nmtui apenas quando o kernel expuser uma interface sem fios utilizável.

Os Ficheiros de Firmware e os Módulos de Kernel São Dependências Diferentes

O utilizador original do MT7921 já tinha copiado o firmware, mas modprobe mt7921e continuava a falhar porque o próprio módulo de kernel estava ausente. O firmware não pode compensar um controlador que não tenha sido integrado no kernel em execução nem disponibilizado para o mesmo.

Ao resolver problemas, verifique tanto o ID do dispositivo como a existência do módulo correspondente antes de substituir repetidamente os ficheiros de firmware.

Os Adaptadores MediaTek PCIe e USB Necessitam de Percursos de Controlador Diferentes

Dois adaptadores vendidos com uma designação comercial MT7925 semelhante podem utilizar barramentos e módulos de kernel diferentes. Um relato de sucesso com PCIe não valida automaticamente um dongle USB, e a fonte demonstrou mais tarde exatamente essa distinção com um dispositivo USB que falhava intermitentemente.

Mantenha uma Ligação de Recuperação Com Fios ao Testar o Wi-Fi

Se o ZimaOS depender de um adaptador sem fios experimental como única ligação à rede, uma falha do controlador pode remover o acesso à WebUI e ao SSH. Durante a configuração, mantenha a Ethernet ligada ou garanta acesso local à consola, para que seja possível recolher registos depois de o Wi-Fi desaparecer.

A Deteção é Apenas o Primeiro Teste de Compatibilidade

Uma validação útil do Wi-Fi deve incluir a persistência após reinícios, vários dias de funcionamento contínuo, a reconexão após o reinício do ponto de acesso, transferências prolongadas e a recuperação após transições de suspensão ou de estado de energia, caso sejam utilizadas. No caso do MT7925 USB da fonte, o dispositivo funcionou inicialmente, mas falhou após alguns dias, razão pela qual uma única procura bem-sucedida não é suficiente.

Prefira um Adaptador Incluído na Lista de Compatibilidade Atual para um NAS de Produção

As adições comunitárias de controladores são valiosas para experiências, mas um NAS destinado a fornecer cópias de segurança ou acesso remoto beneficia de um chipset documentado ativamente pela IceWhale. Se o Wi-Fi for opcional, a Ethernet com fios continua a ser a opção de servidor mais simples e determinística.

Perguntas Frequentes sobre o Wi-Fi MediaTek

O MT7925 funcionou para pelo menos um utilizador da fonte na versão 1.5.4?

Sim.

Todos os adaptadores MT7925 permaneceram estáveis?

Não. Um utilizador de um adaptador USB informou que este desapareceu após vários dias e só voltou depois de um reinício.

A fonte prova que todos os dispositivos MT7921/MT7922/MT7925 funcionam nas versões atuais do ZimaOS?

Não. O ID exato do dispositivo, o tipo de barramento, o módulo e a versão atual continuam a precisar de verificação.