Solución de la comunidad

Wi‑Fi MediaTek MT7920 en ZimaOS: el controlador se cargaba, faltaba el firmware y la versión 1.7.0 lo solucionó

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 fuente presenta un diagnóstico técnico excepcionalmente claro. ZimaOS podía detectar el dispositivo PCIe MediaTek MT7920, y el controlador correcto mt7921e el controlador del kernel ya estaba cargado. El Wi‑Fi seguía sin aparecer porque faltaban en la imagen de ZimaOS dos blobs de firmware requeridos por la tarjeta, lo que producía repetidos error -2 fallos de carga del firmware.

Esa brecha se resolvió en la línea ZimaOS 1.7. Un miembro de la comunidad verificó que ambos archivos de firmware existían en la versión beta 1.7.0, y el autor original volvió el 16 de agosto de 2026 para decir que ejecutaba la versión 1.7 y ahora podía conectarse a su red mediante Wi‑Fi. Es un éxito confirmado por la fuente.

El MT7920 fue detectado en PCIe

La fuente mostró:

03:00.0 Network controller [0280]:
MEDIATEK Corp. Device [14c3:7920]

Esto descartó que la tarjeta PCIe fuera completamente invisible. El hardware se enumeraba correctamente.

El controlador mt7921e ya estaba en uso

El usuario publicó entonces:

Controlador del kernel en uso: mt7921e
Módulos del kernel: mt7921e

Esto es importante porque el problema no era que «ZimaOS no tuviera ningún controlador de MediaTek». El controlador estaba presente y asociado a la tarjeta.

El registro del kernel identificó archivos de firmware faltantes

Los errores determinantes fueron:

mediatek/WIFI_RAM_CODE_MT7961_1a.bin
mediatek/WIFI_MT7961_patch_mcu_1a_2_hdr.bin

Ambos fallaron al cargarse con el error -2, seguido de falló la inicialización del hardware. En este contexto, el error -2 significa que no se encontró el archivo solicitado.

Por qué nmtui no podía ofrecer la interfaz Wi‑Fi

nmcli radio wifi podía indicar que el Wi‑Fi estaba habilitado mientras nmtui seguía sin mostrar una conexión inalámbrica utilizable. La política de radio estaba habilitada, pero el hardware nunca completaba la inicialización del firmware, por lo que el sistema operativo nunca obtuvo una interfaz Wi‑Fi funcional que pudiera configurar.

ZimaOS 1.7.0 añadió los archivos de firmware requeridos

En julio de 2026, piterdan dijo que ZimaOS 1.7.0 incluía el firmware faltante de MT7920. Luego, gelbuilding verificó en un ZimaCube con 1.7.0-beta1 que ambos archivos requeridos existían en /lib/firmware/mediatek/.

El autor original esperó a la versión estable en lugar de pasar a la beta.

El autor original confirmó que la versión estable 1.7 funcionaba

El 16 de agosto, djmiek volvió y dijo que ahora ejecutaba la versión 1.7 y podía conectarse a su red mediante Wi‑Fi. Eso resuelve el problema original con más solidez que simplemente encontrar los archivos de firmware en una versión beta.

Los usuarios actuales deben actualizar antes de intentar modificar los controladores

La versión actual de ZimaOS es la 1.7.1. Si un MT7920 en un sistema 1.6.x anterior muestra exactamente los errores de firmware faltante de esta fuente, actualiza a la versión estable actual antes de considerar inyectar firmware personalizado.

Use the current ZimaOS release baseline.

Usa la versión estable actual de ZimaOS como referencia.

lspci -nnk | Si el MT7920 sigue fallando en una versión actual, recopila las mismas pruebas
grep -A3 7920
dmesg | ip link
dmesg | grep -i mt79

grep -i firmware

Si el controlador y el firmware se cargan correctamente, pero la interfaz sigue fallando, el problema ya no es el mismo error de la fuente y requiere un diagnóstico nuevo.

El RTL8125 que mostraba 1 Gbps era una cuestión independiente de negociación del enlace

El usuario también observó que un RTL8125 de 2,5 GbE mostraba 1 Gbps en la interfaz. Una NIC de 2,5 GbE solo negociará 1 Gbps cuando esté conectada a un puerto de switch/router de 1 GbE o a un dispositivo remoto incompatible. Eso no tiene nada que ver con el fallo del firmware del MT7920.

El firmware y el controlador son componentes distintos

Esa distinción es importante en los informes de soporte. El origen del MT7920 es un ejemplo útil de por qué “falta el controlador” suele ser demasiado impreciso. El módulo del kernel de Linux contenía el código necesario para controlar la familia MediaTek, pero la tarjeta también requería firmware binario cargado en el dispositivo durante la inicialización. Un componente estaba presente; el otro no. lspci -nnk muestra un controlador en uso, pero dmesg informa de firmware faltante, pedir a IceWhale que añada los archivos de firmware es más preciso que solicitar un controlador de kernel completamente nuevo.

No copies primero blobs de firmware aleatorios de otra distribución

Como ZimaOS empaqueta su kernel y firmware como una imagen integral, copiar manualmente blobs en las rutas del sistema puede sobrescribirse con actualizaciones OTA o crear combinaciones incompatibles de firmware y kernel. En última instancia, el problema de la fuente se solucionó mediante la versión normal de ZimaOS que incluía los archivos necesarios.

Wi‑Fi y Bluetooth pueden ser funciones independientes de la misma tarjeta

Las tarjetas combinadas exponen más de una función y pueden requerir rutas de firmware/USB independientes para Bluetooth. La fuente solo demuestra que la conexión Wi‑Fi comenzó a funcionar en ZimaOS 1.7. Si Bluetooth sigue fallando, captura su propio ID de dispositivo y registro del kernel en lugar de asumir que la solución de Wi‑Fi garantiza el funcionamiento de ambas radios.

Preguntas frecuentes sobre MT7920

¿Faltaba el controlador MT7920?

No. La fuente mostraba mt7921e cargado y vinculado al dispositivo.

¿Qué faltaba?

Se necesitaban dos archivos de firmware de MediaTek para la inicialización del hardware.

¿El usuario original confirmó que ZimaOS 1.7 lo solucionó?

Sí. Posteriormente informaron de una conexión Wi‑Fi funcional en ZimaOS 1.7 estable.