Solución de la comunidad

Wi-Fi de MediaTek en ZimaOS: historial de controladores MT7921/MT7925, resultados de la versión 1.5.4 y límites actuales de compatibilidad

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 hilo de origen muestra avances reales en los controladores, pero no promete de forma general que todos los adaptadores Wi-Fi de MediaTek funcionen en cualquier versión actual de ZimaOS. El usuario original de MT7921 descubrió que el firmware por sí solo no era suficiente porque faltaba el módulo del kernel mt7921e. Zima-Jerry dijo que IceWhale lo añadiría en la siguiente versión.

Más adelante, IceWhale también se comprometió a añadir controladores relacionados con MT7925, y un usuario de MT7925 PCIe informó explícitamente que la tarjeta empezó a funcionar en ZimaOS 1.5.4. Después, un usuario de MT7925 USB informó que el adaptador solo funcionó durante unos días antes de desaparecer hasta reiniciar el sistema, por lo que «detectado» y «estable a largo plazo» no eran equivalentes.

El fallo original del MT7921 se debía a la falta de un módulo del kernel

El usuario ejecutó modprobe mt7921e y ZimaOS 1.5.3 indicó que el módulo no existía en el kernel en ejecución. Zima-Jerry respondió que lo añadiría.

IceWhale también aceptó añadir compatibilidad con el controlador MT7925

Otro usuario solicitó compatibilidad con MT7925 PCIe y, posteriormente, otro usuario solicitó las variantes USB utilizadas por los adaptadores Wi-Fi 7. Zima-Jerry dijo que esos controladores deberían añadirse en la nueva versión.

Un usuario de MT7925 confirmó que funcionaba en ZimaOS 1.5.4

El 4 de febrero de 2026, esahin regresó e indicó que su tarjeta MediaTek MT7925 empezó a funcionar en ZimaOS 1.5.4. Esto constituye una verificación de usuario confirmada por la fuente para esa configuración de hardware.

Posteriormente, un adaptador MT7925 USB mostró problemas de estabilidad

Un usuario de un adaptador USB MT7925 de Netgear indicó que el dispositivo se detectó después de añadir el controlador, pero dejó de funcionar tras varios días y necesitó reiniciar el sistema y volver a configurarlo mediante nmtui. El hilo no incluye una solución definitiva.

El MT7922 era un caso diferente

Zima-Jerry dijo que el controlador MT7922 ya estaba incluido. Sin embargo, un usuario de la versión 1.5.3 siguió informando de que no aparecían redes Wi-Fi y de que faltaba un módulo, lo que demuestra que es necesario comprobar el chipset exacto, el tipo de bus, el ID del dispositivo y el módulo del kernel.

Consola de ZimaOS en una placa base MSI de terceros que muestra que no hay ninguna dirección de red mientras continuaba la resolución de problemas del Wi-Fi de MediaTek
El sistema de origen inició ZimaOS, pero no pudo obtener acceso a la red mediante la conexión inalámbrica no compatible.

Las directrices oficiales actuales sobre Wi-Fi son más completas para Intel AX210

La documentación actual de hardware de IceWhale incluye una guía específica de ZimaOS para AX210 y una lista de adaptadores compatibles. Las variantes de MediaTek de este hilo no aparecen todas allí como adaptadores actuales garantizados.

Consulta la lista actual de adaptadores de red compatibles con ZimaOS al comprar hardware nuevo.

Verifica el dispositivo y el módulo exactos en una versión actual

lspci -nn
lsusb
uname -r
modinfo mt7921e
ip link

Después, usa nmtui solo cuando el kernel exponga una interfaz inalámbrica utilizable.

Los archivos de firmware y los módulos del kernel son dependencias diferentes

El usuario original de MT7921 ya había copiado el firmware, pero modprobe mt7921e seguía fallando porque el módulo del kernel no estaba presente. El firmware no puede compensar la ausencia de un controlador que no se haya integrado en el kernel en ejecución o que no se haya proporcionado para él.

Al solucionar problemas, comprueba tanto el ID del dispositivo como la existencia del módulo correspondiente antes de sustituir repetidamente los archivos de firmware.

Los adaptadores MediaTek PCIe y USB requieren rutas de controladores diferentes

Dos adaptadores comercializados con un nombre similar, MT7925, pueden utilizar buses y módulos del kernel diferentes. Un informe positivo de PCIe no valida automáticamente un dongle USB, y la fuente demostró posteriormente exactamente esa diferencia con un dispositivo USB que fallaba de forma intermitente.

Mantén una ruta de recuperación cableada mientras pruebas el Wi-Fi

Si ZimaOS depende de un adaptador inalámbrico experimental como única conexión de red, un fallo del controlador puede interrumpir tanto el acceso a la interfaz web como a SSH. Durante la configuración, mantén conectado Ethernet o conserva acceso a la consola local para poder recopilar registros después de que desaparezca el Wi-Fi.

La detección es solo la primera prueba de compatibilidad

Una validación útil del Wi-Fi debería incluir la persistencia después de reiniciar, varios días de funcionamiento continuo, la reconexión después de reiniciar el punto de acceso, transferencias sostenidas y la recuperación tras transiciones de suspensión o estados de energía, si se utilizan. El caso del MT7925 USB de la fuente funcionó inicialmente, pero falló después de varios días; por eso, un único escaneo correcto no es suficiente.

Para un NAS de producción, prefiere un adaptador incluido en la lista de compatibilidad actual

Las incorporaciones de controladores por parte de la comunidad son valiosas para experimentar, pero un NAS que deba proporcionar copias de seguridad o acceso remoto se beneficia de un chipset documentado activamente por IceWhale. Si el Wi-Fi es opcional, Ethernet cableado sigue siendo la opción de servidor más sencilla y determinista.

Preguntas frecuentes sobre el Wi-Fi de MediaTek

¿Funcionó MT7925 para al menos un usuario de la fuente en la versión 1.5.4?

Sí.

¿Todos los adaptadores MT7925 permanecieron estables?

No. Un usuario de un adaptador USB informó que este desapareció después de varios días hasta que se reinició el sistema.

¿Demuestra la fuente que todos los dispositivos MT7921, MT7922 y MT7925 funcionan en las versiones actuales de ZimaOS?

No. Aún es necesario verificar el ID exacto del dispositivo, el tipo de bus, el módulo y la versión actual.