↓ Ir al contenido

Cómo seleccionar el controlador Linux para la tarjeta de red USB ALFA: MediaTek sin necesidad de compilación versus Realtek con necesidad de compilación

Documento de Soporte Técnico · Versión 1.0 (redactado según blog-writing-rules.md v1.0) Máquina madre: En el cuadro de este documento técnico de Yopitek se incluyen 6 modelos de tarjetas de red USB ALFA en servicio (3 modelos MediaTek, 3 modelos Realtek). Artículos relacionados: ¿Soporta la tarjeta de red inalámbrica ALFA la NVIDIA DGX Spark? | ¿Soporta la tarjeta de red inalámbrica ALFA OpenWrt? | ¿Soporta la tarjeta de red inalámbrica ALFA la NVIDIA Jetson Nano? | ¿Soporta la tarjeta de red inalámbrica ALFA Tomato? | ¿Soporta la tarjeta de red inalámbrica ALFA DD-WRT?

Resumen en una frase
#

De los 6 modelos revisados, 3 con procesadores MediaTek (MT7610U / MT7612U / MT7921AUN) ya tienen los controladores integrados en el kernel moderno, por lo que son plug and play; mientras que los 3 con procesadores Realtek (RTL8812AU / RTL8821CU / RTL8832BU) requieren la compilación manual de controladores out-of-tree en kernels antiguos. Los controladores en kernel llegaron así: EACS (rtw88_8821cu) desde el kernel 6.2, ACH/ACS desde el 6.13 y AX/AXER desde el 6.17; en GX10 con kernel 6.17 los tres modelos Realtek no necesitan instalación. Solo los kernels anteriores requieren repositorios de la comunidad como morrownr/8821cu. Si prefiere la facilidad, primero revise el procesador antes de realizar el pedido.


Primer Acto: Escena - Por qué alguien lo conecta y funciona, y alguien lo compila dos horas
#

Dos situaciones reales:

  • Cliente A conecta AWUS036ACM a una máquina de escritorio Ubuntu, ejecuta lsusb y NetworkManager muestra wlan0 directamente - sin instalar nada.
  • Cliente B conecta AWUS036ACH a la misma máquina, la tarjeta de red no responde, debe ir a GitHub para descargar el código fuente, instalar herramientas de compilación, compilar y reiniciar.

La diferencia no radica en la suerte ni en la versión del sistema operativo Linux, sino en a qué campamento pertenece el chip: El chip USB WiFi de MediaTek (serie mt76) ya ha sido incluido en el kernel principal de Linux; el chip USB WiFi de Realtek, en cambio, sigue distribuyéndose en forma out-of-tree (fuera del núcleo), dependiendo de la mantenimiento de los repositorios de controladores de la comunidad para su instalación manual.

Segundo Acto: Mecanismos - ¿En qué se diferencian el in-kernel y el out-of-tree?
#

MediaTek: Controlador mt76 de línea principal, listo para usar
#

El controlador de chip USB de MediaTek está cubierto por el subsistema mt76 del kernel:

ModeloChipsetMódulo de controlador del kernelCondiciones de compilación
AWUS036ACHMMT7610Umt76x0uIntegrado en el kernel, sin consideraciones de versión
AWUS036ACMMT7612Umt76x2uIntegrado en el kernel, sin consideraciones de versión
AWUS036AXML / AXMMT7921AUNmt7921uRequiere kernel 5.18+

⚠️ Única trampa: El umbral del kernel para MT7921AUN es 5.18+. Las plataformas antiguas (como JetPack 4.x de Jetson Nano, kernel 4.9) no pueden realizar backport y no son compatibles directamente. Este es el resultado verificado en los documentos técnicos de Jetson Nano (ver ¿Es compatible el adaptador inalámbrico ALFA con NVIDIA Jetson Nano? §7.4).

Realtek: Out-of-tree con kernels antiguos (compilación manual)
#

En kernels antiguos, el chip USB de Realtek no tiene un controlador de línea principal disponible y depende de los repositorios de mantenimiento comunitario (el EACS ya lo tiene en el kernel desde la versión 6.2, ACH/ACS desde la 6.13 y AX/AXER desde la 6.17). Actualmente, el mantenedor más activo es morrownr, y esta revisión cubre 3 chips y 3 repositorios:

ModeloChipsetRepositorio de controladores (mantenido por morrownr)Revisión del 3 de septiembre de 2026
AWUS036ACHRTL8812AU8812au-20210820✅ Revisado
AWUS036EACSRTL8821CU (rtw88_8821cu integrado desde kernel 6.2)8821cu-20210916✅ Revisado
AWUS036AX / AXERRTL8832BUrtl8852bu-20250826✅ Revisado

Aplicación en tres entornos típicos
#

EntornoKernelCampaña MediaTek (3 modelos)Campaña Realtek (3 modelos)
GB10 / DGX Spark6.x + aarch64Todos disponibles (mt76 integrado)Todos necesitan compilación (ARM64 compatible)
Jetson Nano (JetPack 4.x)4.97610U/7612U disponibles; MT7921AUN no disponible8812au قابل برای ترجمه (پشتیبانی ARM64); بقیه تایید نشده
Router OpenWrtVersiónTodos disponibles (MT7921AUN necesita 23.05+)Necesita kmod correspondiente o compilación, dificultad alta

(Matriz de determinación completa de cada entorno en ¿Es compatible el adaptador inalámbrico ALFA con NVIDIA DGX Spark?, ¿Es compatible el adaptador inalámbrico ALFA con NVIDIA Jetson Nano?, ¿Es compatible el adaptador inalámbrico ALFA con OpenWrt?.)

Tercera Escena: Herramientas - Proceso de Detección en Tres Minutos y Pasos de Instalación
#

Tabla de Detección: Al obtener una tarjeta de red, realice estos tres pasos
#

# Paso 1: Verifique que el sistema reconozca la tarjeta de red (registre VID:PID)
lsusb

# Paso 2: Verifique si el kernel ha cargado el controlador correspondiente
lsmod | grep -E "mt76|rtl8"

# Paso 3: Verifique la versión del kernel (determine si el MT7921AUN puede utilizarse)
uname -r

Lógica de detección (matriz principal: los 6 modelos de la tabla superior):

  1. lsusb muestra MediaTek / MT76xx → campamento in-kernel, kernel ≥ 5.18 (modelos MT7921AUN) o cualquier kernel reciente, plug and play.
  2. lsusb muestra Realtek RTL88xx → campamento out-of-tree, siga los pasos de instalación a continuación.
  3. lsusb no muestra nuevos dispositivos → primero cambie el puerto / cable USB para descartar problemas de hardware, luego verifique si el modelo es RTL8832BU de Wi-Fi 6 (algunos lotes requieren usb_modeswitch, este paso es un problema de modelo individual, no se detalla aquí, no se incluye en la matriz de revisión).

Instalación General para el Campamento Realtek (a ejemplo de AWUS036ACH)
#

# Paso 1: Instale las dependencias de compilación (Debian/Ubuntu)
sudo apt install build-essential dkms linux-headers-$(uname -r)

# Paso 2: Obtenga el código fuente del controlador (repo correspondiente al modelo, véase la tabla superior)
git clone https://github.com/morrownr/8812au-20210820
cd 8812au-20210820

# Paso 3: Instale (registre DKMS, no es necesario reinstalar al cambiar el kernel)
sudo ./install-driver.sh

# Paso 4: Verifique después de reiniciar
lsmod | grep 88XXau
ip link   # Debería aparecer una nueva interfaz wlan

Tabla 1: Conclusión: La detección precede a la instalación - primero revise el chip, 90 segundos para determinar si es “plug and play” o “compilar en el repo”, sin necesidad de golpear una pared.

Recomendaciones de Compra (conclusión)
#

  • Sin compilación: Elegir el campamento MediaTek (AWUS036ACHM / ACM / AXML), todos los kernel recientes son plug and play.
  • Wi-Fi 6 y sin compilación: Elegir AWUS036AXML (MT7921AUN), pero primero verifique que el kernel sea ≥ 5.18.
  • Tiene necesidades especiales y solo puede usar Realtek (como herramientas específicas de monitor mode): Reserve 20-40 minutos para la compilación del controlador, y verifique que la plataforma objetivo tenga los headers del kernel.

Condiciones conocidas y condiciones de objeción
#

La conclusión de este artículo no se aplica en las siguientes condiciones, por favor, adopte alternativas:

  1. Kernel 5.17 o anterior + MT7921AUN: mt7921u no puede realizar backport (depende de la infraestructura del kernel moderno), la conclusión se invierte a “no disponible”. Esto es la excepción más importante de este artículo.
  2. No x86/ARM64 Linux (como ciertos routers MIPS): el repositorio morrownr no garantiza que sea compilable, debe priorizarse el kmod de OpenWrt (ver ¿Soporta ALFA la tarjeta inalámbrica OpenWrt?).
  3. Versión evolutiva del repositorio de controladores: el repositorio morrownr se nombra con la fecha (como rtl8852bu-20250826), puede que en el futuro se modifique o elimine; antes de instalar, verifique la situación actual del repositorio.
  4. Capacidad de modo monitor / modo AP: las capacidades varían según el chip y la versión del kernel (por ejemplo, rtl8812au-ct en OpenWrt 22.03+ tiene informes de fallos en 24.10), la matriz de capacidades detallada se encuentra en artículos específicos para cada entorno.
  5. El RTL8832BU (AWUS036AX/AXER) no está entre los 6 modelos de este inventario, pero soporte al cliente suele recibir preguntas sobre él: el controlador rtw89_8852bu está en mainline desde el kernel 6.17; en el GX10 (kernel 6.17) monitor funcionó, inyección en 2,4 GHz: AX 96 %, AXER 73 %. Solo los kernels antiguos necesitan el controlador comunitario morrownr/rtl8852bu. Al responder a clientes, confirme primero la versión del kernel.

Referencias
#

FuenteDescripciónURLEstado de verificaciónFecha de verificación
morrownr/8812au GitHubControlador RTL8812AU para Linuxhttps://github.com/morrownr/8812au-20210820✅ Verificado2026-09-03
morrownr/8821cu GitHubControlador RTL8821CU para Linux (solo necesario con kernel anterior a 6.2)https://github.com/morrownr/8821cu-20210916✅ Verificado2026-09-03
morrownr/rtl8852bu GitHubControlador RTL8832BU para Linuxhttps://github.com/morrownr/rtl8852bu-20250826✅ Verificado2026-09-03
Yopitek ALFA ProductosCatálogo de modelos y especificaciones/es/products/alfa/✅ Verificado2026-09-03
Yopitek Blog: Guía Soft APDocumentación de verificación del modo AP/es/blog/alfa-soft-ap-wifi-hotspot-linux-guide/✅ Verificado2026-09-03
Documentos técnicos de este sitio 9 artículosMatrices de determinación y base de verificación del entornoEnlaces relativos (ver artículos relacionados en la parte superior de este documento)✅ Verificado2026-09-03

Página oficial de wiki kernel mt76: https://wireless.wiki.kernel.org/en/users/drivers/mediatek (Verificado, lista las versiones de kernel de inicio que soportan cada chip, puede usarse como referencia rápida)

Aviso Legal#

Este documento ha sido compilado por el departamento de soporte técnico de Yopitek Ltd, y las especificaciones y estado de los controladores pueden variar según las actualizaciones del kernel y los repositorios de controladores. Antes de la instalación, por favor, consulte los repositorios oficiales y las páginas de especificaciones del fabricante. ALFA Network es una marca autorizada por nuestra empresa.