↓ Ir para o conteúdo principal

Como escolher o driver Linux para a placa de rede USB ALFA: MediaTek sem compilação vs Realtek que requer compilação

Documento de Suporte Técnico · 3 de setembro de 2026 - Versão Inicial (conforme as regras de escrita do blog-writing-rules.md v1.0) Matriz de Avaliação: A matriz deste documento técnico inclui 6 modelos de cartas de rede USB ALFA atuais (3 modelos MediaTek, 3 modelos Realtek). Artigos Relacionados: Carta de Rede Wireless ALFA suporta NVIDIA DGX Spark? | Carta de Rede Wireless ALFA suporta OpenWrt? | Carta de Rede Wireless ALFA suporta NVIDIA Jetson Nano? | Carta de Rede Wireless ALFA suporta Tomato? | Carta de Rede Wireless ALFA suporta DD-WRT?

Conclusão em uma frase
#

Entre os 6 modelos analisados, 3 utilizam chips MediaTek (MT7610U / MT7612U / MT7921AUN), que já possuem drivers integrados no kernel moderno, permitindo uso imediato após a instalação; os outros 3, com chips Realtek (RTL8812AU / RTL8821CU / RTL8832BU), exigem a compilação manual de drivers out-of-tree em kernels antigos. Os drivers Realtek entraram no kernel mainline por etapas: rtw88_8821cu (EACS) desde o 6.2, ACH/ACS desde o 6.13 e AX/AXER desde o 6.17; no GX10 com kernel 6.17 todos funcionam sem instalação. Se preferir facilidade, analise o chip antes de fazer o pedido.


Primeiro Acto: Cenário - Por que alguém conecta e já funciona, enquanto outro leva duas horas para compilar
#

Duas situações reais:

  • Cliente A conecta o AWUS036ACM a uma máquina desktop Ubuntu, executa lsusb e o NetworkManager já detecta wlan0 — sem a necessidade de instalar nada.
  • Cliente B conecta o AWUS036ACH à mesma máquina, mas a placa de rede não responde. É necessário acessar o GitHub para baixar o código-fonte, instalar ferramentas de build, compilar e reiniciar o sistema.

A diferença não está na sorte, nem no sistema operacional Linux, mas sim na camada de chipsets a que pertence: o driver do chipsets de WiFi USB da MediaTek (série mt76) já está integrado no kernel Linux mainline; enquanto o driver de chipsets de WiFi USB da Realtek, de alto nível, ainda se encontra em formato out-of-tree (fora do núcleo), distribuído de forma independente e necessitando de manutenção comunitária para instalação manual.

Segundo Acto: Mecanismos — O que há de diferente entre in-kernel e out-of-tree
#

MediaTek: mt76 driver de linha principal, plugue e use
#

O driver do chip USB MediaTek é coberto pelo subsistema mt76 do kernel:

ModeloChipsetMódulo de driver do kernelCondições de compilação
AWUS036ACHMMT7610Umt76x0uIntegrado no kernel, sem restrições de versão
AWUS036ACMMT7612Umt76x2uIntegrado no kernel, sem restrições de versão
AWUS036AXML / AXMMT7921AUNmt7921uRequer kernel 5.18+

⚠️ Única armadilha: O limite de kernel para o MT7921AUN é 5.18+. Plataformas antigas (como Jetson Nano com JetPack 4.x, kernel 4.9) não podem ser backported e não são compatíveis diretamente — essa é a conclusão verificada em nossos documentos técnicos para o Jetson Nano (veja Compatibilidade do cartão Wi-Fi ALFA com NVIDIA Jetson Nano §7.4).

Realtek: out-of-tree, compilação manual
#

Em kernels antigos, o chip USB Realtek não possui driver mainline disponível e depende de repositórios de driver mantidos pela comunidade (o rtw88_8821cu do EACS é nativo desde o kernel 6.2, ACH/ACS desde o 6.13 e AX/AXER desde o 6.17; os repositórios abaixo são necessários apenas em kernels anteriores a essas versões). Atualmente, o mantenedor mais ativo é morrownr, e esta análise cobre 3 chips correspondendo a 3 repositórios:

ModeloChipsetRepositório de driver (mantido por morrownr)Verificação em 03/09/2026
AWUS036ACHRTL8812AU8812au-20210820✅ Verificado
AWUS036EACSRTL8821CU8821cu-20210916 (só para kernel anterior ao 6.2)✅ Verificado
AWUS036AX / AXERRTL8832BUrtl8852bu-20250826✅ Verificado

Aplicação em três ambientes típicos
#

AmbienteKernelCampo MediaTek (3 modelos)Campo Realtek (3 modelos)
GB10 / DGX Spark6.x + aarch64Todos disponíveis (mt76 integrado)Todos precisam ser compilados (ARM64 pode ser suportado)
Jetson Nano (JetPack 4.x)4.97610U/7612U disponíveis; MT7921AUN não disponível8812au pode ser compilado (suporte ARM64); os outros não foram verificados
Roteador OpenWrtVersão dependenteTodos disponíveis (MT7921AUN precisa de 23.05+)Precisa de kmod correspondente ou compilação, nível de dificuldade alto

(Matriz de verificação completa para cada ambiente está disponível em Compatibilidade do cartão Wi-Fi ALFA com NVIDIA DGX Spark, Compatibilidade do cartão Wi-Fi ALFA com NVIDIA Jetson Nano, Compatibilidade do cartão Wi-Fi ALFA com Roteador OpenWrt.)

Terceiro Acto: Ferramentário - Processo de Determição em Três Minutos e Passos de Instalação
#

Tabela de Determição: Ao Receber a Placa de Rede, Faça Esses Três Passos
#

# Passo 1: Confirme se o sistema vê a placa de rede (anote VID:PID)
lsusb

# Passo 2: Verifique se o kernel já carregou o driver correspondente
lsmod | grep -E "mt76|rtl8"

# Passo 3: Confirme a versão do kernel (determina se o MT7921AUN pode ser usado)
uname -r

Lógica de Determição (Mãe: Tabela 6 Modelos):

  1. lsusb mostra MediaTek / MT76xx → no grupo do kernel, kernel ≥ 5.18 (modelos MT7921AUN) ou qualquer kernel recente, plug and play.
  2. lsusb mostra Realtek RTL88xx → no grupo out-of-tree, siga os passos de instalação a seguir.
  3. lsusb não mostra novos dispositivos → troque o porta USB / fio para excluir problemas de hardware, e verifique se o modelo é RTL8832BU de Wi-Fi 6 (alguns lotes precisam de usb_modeswitch, esse passo é problema de alguns modelos específicos, não incluído na análise atual, não será expandido).

Instalação Comum para o Grupo Realtek (com exemplo AWUS036ACH)
#

# Passo 1: Instale as dependências de compilação (Debian/Ubuntu)
sudo apt install build-essential dkms linux-headers-$(uname -r)

# Passo 2: Obtenha o código-fonte do driver (repo correspondente ao modelo, veja a tabela acima)
git clone https://github.com/morrownr/8812au-20210820
cd 8812au-20210820

# Passo 3: Instale (DKMS registro, não é necessário reinstalar ao trocar o kernel)
sudo ./install-driver.sh

# Passo 4: Verifique após a reinicialização
lsmod | grep 88XXau
ip link   # Deve aparecer uma nova interface wlan

Tabela 1 Conclusão: Determição antes da Instalação - Veja o chip primeiro, decida em 90 segundos se você é “plug and play” ou precisa “compilar no repo”, sem precisar bater na parede.

Sugestões de Compra (Conclusão)
#

  • Sem Compilação: Escolha o grupo MediaTek (AWUS036ACHM / ACM / AXML), todos os kernels recentes são plug and play.
  • Wi-Fi 6 e Sem Compilação: Escolha AWUS036AXML (MT7921AUN), mas confirme se o kernel ≥ 5.18.
  • Necessidade Especial e Não Realtek: Reserve 20-40 minutos para compilar o driver, e confirme se a plataforma alvo tem headers do kernel.

Condições Conhecidas e Contras
#

A conclusão deste artigo não se aplica nas seguintes condições, favor adotar alternativas:

  1. kernel 5.17 ou anterior + MT7921AUN: O mt7921u não pode ser backportado (depende de infraestrutura de kernel moderno), a conclusão é revertida para “não disponível”. Este é o excepcional mais importante deste artigo.
  2. Não x86/ARM64 Linux (como alguns roteadores MIPS): O repositório morrownr não garante a compilação, deve-se priorizar o kmod do OpenWrt (veja Suporte do ALFA Wireless Network Card para OpenWrt).
  3. Versão de evolução do repositório de drivers: O repositório morrownr é nomeado por data (como rtl8852bu-20250826), pode haver futuras versões ou remoções; verifique a situação atual do repositório antes da instalação.
  4. Capacidade de modo monitor / AP: A capacidade varia dependendo da versão do kernel do mesmo chip (por exemplo, o rtl8812au-ct no OpenWrt 22.03+ teve relatos de crashes no 24.10), a matriz de capacidade detalhada deve ser consultada em artigos específicos para cada ambiente.
  5. O RTL8832BU (AWUS036AX/AXER) não está entre os 6 modelos deste levantamento, mas o suporte ao cliente costuma receber perguntas sobre ele: o driver rtw89_8852bu está no mainline desde o kernel 6.17; no GX10 (kernel 6.17) o monitor funcionou, injeção em 2,4 GHz: AX 96 %, AXER 73 %. Somente kernels antigos precisam do driver da comunidade morrownr/rtl8852bu. Ao responder ao cliente, confirme primeiro a versão do kernel.

Fontes de Referência
#

FonteDescriçãoURLStatus de VerificaçãoData de Verificação
morrownr/8812au GitHubDriver RTL8812AU para Linuxhttps://github.com/morrownr/8812au-20210820✅ Verificado03/09/2026
morrownr/8821cu GitHubDriver RTL8821CU para Linux (necessário só em kernel anterior ao 6.2; nativo a partir do 6.2)https://github.com/morrownr/8821cu-20210916✅ Verificado03/09/2026
morrownr/rtl8852bu GitHubDriver RTL8832BU para Linuxhttps://github.com/morrownr/rtl8852bu-20250826✅ Verificado03/09/2026
Yopitek ALFA Product OverviewModelos atuais e especificações/pt/products/alfa/✅ Verificado03/09/2026
Yopitek Blog: Guia Soft APDocumentação de verificação do modo AP/pt/blog/alfa-soft-ap-wifi-hotspot-linux-guide/✅ Verificado03/09/2026
Documentos Técnicos do Site 9Matrizes de decisão e bases de verificação ambientalLink Relativo (veja “Artigos Relacionados” no início do texto)✅ Verificado03/09/2026

Página oficial do wiki kernel mt76: https://wireless.wiki.kernel.org/en/users/drivers/mediatek (Verificado, lista as versões de kernel inicial suportadas por cada chip, pode ser usado como base para verificação rápida)

Declaração de Isenção de Responsabilidade
#

Este arquivo foi organizado pela Suporte Técnico da Yopitek Ltd, e as especificações e status dos drivers podem variar conforme as atualizações do kernel e dos repositórios de drivers. Antes da instalação, por favor, utilize os repositórios oficiais e as páginas de especificações do fabricante como referência. A ALFA Network é uma marca oficialmente autorizada pela nossa empresa.