Novos chips Bluetooth da Realtek exigem uma nova forma de carregar firmware no Linux

Novos chips Bluetooth da Realtek exigem uma nova forma de carregar firmware no Linux

A Realtek está introduzindo uma nova geração do formato de firmware utilizado por seus controladores Bluetooth. Para acompanhar a mudança, o driver do kernel Linux precisa ser significativamente ampliado. A versão 10 da série de patches enviada em 20 de novembro de 2026 pela desenvolvedora Hilda Wu prepara o terreno para o novo padrão, chamado de formato v3. O primeiro chip a exigir essa estrutura é o RTL8922D, e o processo revela que garantir o funcionamento de um novo hardware exige muito mais do que apenas adicionar uma linha de código com um identificador USB.

Realtek mudou a forma como novos controladores recebem firmware

Até agora, os firmwares Bluetooth da Realtek utilizados pelo Linux seguiam formatos anteriores (v1 e v2) com uma estrutura relativamente plana, baseada em um contêiner chamado epatch. Esse modelo servia para armazenar as imagens e permitir que o driver selecionasse o trecho apropriado para o hardware.

A nova versão abandona essa simplicidade. O formato v3 organiza o conteúdo em seções e subseções, permitindo que a fabricante empacote várias imagens e configurações independentes dentro do mesmo arquivo.

Entenda sem termos técnicos o que acontececeu e o que precisa ser feito!

novo firmware bluetooth realtek linux 1
Novos chips Bluetooth da Realtek exigem uma nova forma de carregar firmware no Linux 10

Imagine que antes o Linux recebia uma caixa contendo algumas peças e uma etiqueta direta dizendo qual componente instalar. Agora, a Realtek passou a enviar uma caixa maior e mais complexa, organizada em vários compartimentos fechados.

Dentro dela podem existir peças para revisões diferentes do mesmo equipamento, ajustes específicos, configurações extras e componentes opcionais. O sistema operacional não pode simplesmente pegar a primeira peça que encontrar. Ele precisa identificar exatamente qual versão física do hardware está conectada, abrir o compartimento correspondente, escolher os componentes corretos e aplicar as configurações exatas antes de inicializar o Bluetooth. O firmware v3 é essencialmente essa nova caixa.

Por que simplesmente adicionar o chip ao Linux não basta?

Para o Bluetooth funcionar adequadamente no Linux, o kernel precisa saber conversar com o dispositivo através do driver e também precisa enviar um código interno para o próprio chip, conhecido como firmware.

Se um controlador utiliza um formato de firmware que o driver ainda não compreende, adicionar apenas o identificador USB não resolve o problema. O Linux precisa aprender a abrir o novo pacote, descobrir qual revisão do hardware está instalada, selecionar somente as partes compatíveis e aplicar os ajustes necessários. A série de patches propõe exatamente isso, dividida em duas etapas dependentes entre si: ensinar o formato v3 ao sistema e, em seguida, habilitar o RTL8922D.

O que muda tecnicamente no firmware v3?

Segundo a documentação enviada pela fabricante, o novo formato permite armazenar várias imagens independentes com seleção baseada em uma chave de identificação (key ID) e na revisão física do chip (chamada de IC cut).

A estrutura também suporta correções de registradores específicas e arquivos de configuração opcionais para cada imagem. O driver precisa interpretar essas variáveis e decidir corretamente qual combinação aplicar durante a inicialização.

RTL8922D é o primeiro hardware a depender da mudança

A própria Realtek confirma que o RTL8922D é o primeiro controlador a utilizar a infraestrutura v3. O patch adiciona suporte à comunicação por interface USB. O hardware utilizado nos testes é identificado pelo Vendor ID 0bda, Product ID a82d e chip ID 55.

Nos dados apresentados na série, o controlador aparece em um dispositivo descrito como 802.11be WLAN NIC. O padrão 802.11be está associado ao Wi-Fi 7, mas a série foca especificamente no funcionamento do Bluetooth através do driver btusb e btrtl.

Compatibilidade com chips antigos continua

Quem possui hardware baseado em controladores Realtek de gerações anteriores não será prejudicado. A fabricante afirma explicitamente que o suporte aos formatos v1 e v2 permanece inalterado.

A nova lógica implementada no driver apenas detecta quando o equipamento exige o formato v3 e altera o fluxo de leitura de acordo. O objetivo não é substituir os firmwares antigos imediatamente, mas ensinar o Linux a reconhecer uma terceira via necessária para a nova geração.

A mudança adiciona quase 800 linhas em um novo arquivo

A complexidade de implementar um novo processador de firmware fica evidente no tamanho do código. A série v10 modifica cinco arquivos, mas o destaque é a criação do arquivo drivers/bluetooth/btrtl_enh.c, que sozinho recebe cerca de 795 linhas.

A lógica específica de leitura e download do firmware v3 foi separada para evitar que o código principal do btrtl crescesse excessivamente. No total, a alteração introduz aproximadamente 1.056 linhas de código e remove apenas 81.

Durante as dez revisões da série, o suporte passou por refinamentos importantes, incluindo correções de vazamentos de memória e leituras fora dos limites. O detalhe é que várias dessas melhorias estruturais entre as versões foram motivadas por feedbacks da ferramenta de revisão assistida por IA Sashiko, algo que a própria fabricante registrou no changelog do projeto.

Até o nome do módulo precisará mudar

A introdução do novo arquivo afeta o resultado da compilação. Como a lógica foi dividida, o módulo final btrtl.ko passará a ser construído sob o nome btrtl_core.ko, unindo as partes originais e o novo código aprimorado.

A opção de configuração no kernel (CONFIG_BT_RTL) permanece a mesma e os símbolos exportados não sofrem alteração, mas a mudança no nome do arquivo pode exigir atenção de distribuições caso utilizem ferramentas, sistemas initramfs ou scripts que referenciem o módulo original diretamente.

O firmware ainda precisa chegar ao projeto linux-firmware

O código avaliado na série utiliza o arquivo binário rtl8922du_fw.bin, que possui aproximadamente 260 KB, além de buscar arquivos de configuração específicos. Nos testes informados pela empresa, o processo completo de carregamento e inicialização desse firmware levou cerca de 454 milissegundos.

No entanto, o envio do firmware binário para o repositório linux-firmware ocorrerá separadamente. Isso significa que o suporte completo sempre dependerá de três fatores alinhados: o kernel atualizado, o driver preparado e o arquivo binário disponível no sistema.

Quando os usuários terão acesso à novidade?

No momento, a proposta enviada em 20 de novembro de 2026 encontra-se na versão 10 e já carrega marcações de testes bem-sucedidos (Tested-by) de desenvolvedores independentes, como Veysi Özgün, obtidas em revisões anteriores.

O código aguarda aprovação final dos mantenedores do subsistema Bluetooth do Linux. Mesmo após a integração na árvore principal do kernel, a disponibilidade prática para os usuários finais dependerá do ritmo de cada distribuição em atualizar o kernel e empacotar o novo binário na árvore oficial de firmwares.