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.

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 linkDepois, 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.
