Pular para o conteúdo
Notícias e tutoriais sobre Linux
Drivers para Linux

Linux prepara suporte funcional a Wi-Fi USB com Qualcomm QCA9377

Série de seis patches propõe correções para inicialização de firmware e autenticação em redes protegidas, buscando retirar o status experimental do hardware após quase nove anos!

linux suporte funcional wifi usb ath10k qca9377

Depois de quase nove anos marcado como experimental no kernel Linux, o suporte a dispositivos Wi-Fi USB controlados pelo driver ath10k pode finalmente se tornar utilizável. Uma nova série de seis patches enviada à lista de desenvolvimento wireless tenta resolver as falhas de conexão e inicialização que impediam o funcionamento normal de módulos baseados no chip Qualcomm Atheros QCA9377-7.

A alteração foi submetida no dia 14 de novembro de 2026 pelo desenvolvedor Tomas Paukrt. Se as modificações forem aceitas e integradas ao código principal, hardware que hoje depende de drivers fornecidos pelas fabricantes poderá funcionar nativamente no sistema.

Nove anos de status experimental

O suporte inicial para interfaces USB no driver ath10k foi introduzido em 2017 por Erik Stromdahl. Naquela época, o código base permitia que a camada de comunicação funcionasse e o firmware fosse carregado, mas a conexão com redes ainda apresentava falhas críticas.

Por causa dessas limitações, a opção no kernel foi rotulada como experimental. Os usuários que tentavam utilizar adaptadores USB compatíveis com o ath10k recebiam uma mensagem direta do sistema avisando que o suporte estava incompleto e que o dispositivo não funcionaria adequadamente.

Apesar de algumas melhorias pontuais no caminho USB realizadas em 2022, a documentação oficial do Linux Wireless e o código principal do kernel mantiveram o alerta. Até a metade de novembro de 2026, a compilação do driver para USB continua descrita como um trabalho em andamento.

O que muda para o hardware QCA9377-7

A nova série de patches foca no comportamento específico de módulos reais que utilizam a variante QCA9377-7 com interface USB. Entre os dispositivos citados pelo autor estão o 8devices Blue Bean (que também possui Bluetooth via USB) e o SparkLAN WUBQ-159ACN.

Atualmente, fabricantes como a 8devices oferecem documentação e patches próprios para viabilizar o uso do módulo em kernels recentes. A inclusão do identificador físico 0cf3:9378 no driver oficial elimina essa barreira inicial de reconhecimento do hardware.

O funcionamento do QCA9377-7 no Linux exige contornar particularidades do firmware. Segundo os testes de Paukrt, o firmware deste chip não suporta o fluxo padrão do ath10k, que consiste em iniciar o componente, consultar suas capacidades e reiniciá-lo antes da operação. Tentar executar esse procedimento resulta em travamentos. A solução proposta no terceiro patch da série impõe que o firmware seja iniciado apenas uma vez e mantido em execução até que o dispositivo seja removido fisicamente ou desativado pelo sistema.

Outro problema resolvido pela série ocorre no momento de descarregar o driver. O núcleo USB do Linux costuma desativar os pontos de comunicação antes de sinalizar a desconexão, mas o ath10k ainda tentava enviar comandos internos, gerando erros. O segundo patch ajusta essa sequência para manter os canais abertos até o fim do processo.

O desafio das redes protegidas e a discussão upstream

linux suporte funcional wifi usb ath10k qca9377 1
Linux prepara suporte funcional a Wi-Fi USB com Qualcomm QCA9377 3

Um dos obstáculos mais complexos para o funcionamento do Wi-Fi USB com esse chip acontecia durante a conexão em redes protegidas. O problema estava na instalação das chaves de segurança (group keys).

O driver ath10k aguardava uma confirmação de conclusão do firmware utilizando um indicador específico (HTT). No entanto, em dispositivos USB, essa confirmação demorava muito ou sequer chegava no prazo esperado, causando falha após três segundos de espera. O primeiro patch da nova série substitui essa verificação por um evento diferente (WMI), que relata a conclusão quase instantaneamente.

Essa correção abriu um debate técnico importante na lista de desenvolvimento. Felix Kaechele observou que falha semelhante também afeta chips conectados por outras vias, como o QCA9379 SDIO. David Heidelberg complementou indicando que a causa real talvez não seja uma limitação do barramento USB, mas sim uma diferença no comportamento dos firmwares desenvolvidos para esses chips.

Em testes adicionais relatados por Paukrt no dia 15 de novembro, a abordagem focada no evento WMI garantiu 211 conexões seguidas sem nenhum erro de tempo limite. Em comparação, uma alternativa sugerida anteriormente por outros desenvolvedores apresentou falhas em cerca de 35% das tentativas. Os testes foram realizados utilizando a versão 0.0.0.111 do firmware, presente no ambiente do desenvolvedor.

Entenda sem termos técnicos

O Linux já possuía há anos parte do código necessário para conversar com placas Wi-Fi Atheros pela porta USB, mas esse caminho nunca chegou ao mesmo nível de estabilidade das placas conectadas internamente nas placas-mãe (PCIe).

O novo conjunto de ajustes tenta resolver detalhes bem específicos de funcionamento de módulos QCA9377-7. As mudanças ensinam o Linux a não reiniciar a placa de forma incorreta, a autenticar redes protegidas sem que o sistema desista por tempo limite e a desligar a conexão de forma limpa. Se os patches forem aceitos de forma definitiva, alguns adaptadores que hoje dependem de instalações manuais e drivers baixados de fora do Linux poderão funcionar logo ao serem conectados.

Próximos passos e disponibilidade

O sexto e último patch sugere a remoção do status experimental do driver USB, já que o adaptador agora consegue inicializar, conectar a redes protegidas e ser desativado corretamente nos testes reportados.

Entretanto, é fundamental destacar que a série ainda está sob revisão. A discussão apontando que o problema das chaves de segurança pode afetar interfaces SDIO gerou pedidos de novos testes e levanta a possibilidade de que o autor precise enviar uma segunda versão (v2) dos patches.

Até o momento desta publicação, as modificações não foram integradas ao repositório principal (mainline) comandado por Linus Torvalds. Para que cheguem a usuários de distribuições como Ubuntu, Debian e Fedora, os patches precisam primeiro ser aprovados pelo mantenedor do subsistema wireless, entrar nas árvores de desenvolvimento do kernel e, por fim, integrar um lançamento estável do Linux.

É importante lembrar que esta correção é voltada exclusivamente para as variantes USB do QCA9377. Notebooks e computadores que utilizam versões PCIe deste mesmo chip já possuem suporte funcional pelo driver ath10k há bastante tempo e não dependem desta atualização.

RECURSOS DO ARTIGO

Links e recursos

Materiais oficiais e referências técnicas relacionadas à matéria.
QUEM ESCREVE
Emanuel Negromonte

Sobre o autor

Emanuel Negromonte é Jornalista, Mestre em Tecnologia da Informação e atualmente cursa a segunda graduação em Engenharia de Software. Com 14 anos de experiência escrevendo sobre GNU/Linux, Software Livre e Código Aberto, dedica-se a descomplicar o universo tecnológico para entusiastas e profissionais. Seu foco é em notícias, tutoriais e análises aprofundadas, promovendo o conhecimento e a liberdade digital no Brasil.