Como instalar, identificar e testar um dongle USB Wi-Fi no Raspberry Pi 5

1. Introdução

O Raspberry Pi 5 possui uma interface wireless integrada, mas podemos adicionar uma segunda interface Wi-Fi utilizando um adaptador USB (dongle wireless).

Essa possibilidade é especialmente interessante para aplicações de monitoramento e análise de redes sem fio, permitindo comparar o desempenho de dois adaptadores, identificar redes Wi-Fi, analisar canais e medir a intensidade dos sinais recebidos.

Neste tutorial vamos apresentar o procedimento completo para instalar e testar um adaptador USB Wi-Fi no Raspberry Pi 5.

O procedimento foi desenvolvido a partir de testes reais utilizando:

  • Raspberry Pi 5.
  • Debian GNU/Linux 13 (Trixie).
  • Kernel Linux 6.18.34.
  • Adaptador USB Realtek com identificador 0bda:c811.
  • Driver Linux rtw88_8821cu.

Ao final teremos duas interfaces independentes:

  • wlan0: interface Wi-Fi interna do Raspberry Pi 5.
  • wlan1: interface Wi-Fi adicional, conectada à porta USB.

 

2. Verificando o ambiente Linux

Antes de conectar o adaptador, é interessante conhecer a versão do sistema operacional e do kernel.

Comando 1 — Identificar a versão do kernel

uname -a

Função:

Apresenta informações sobre o kernel Linux, arquitetura e compilação.

Resultado esperado:

Linux RaspPI5 6.18.34+rpt-rpi-2712
#1 SMP PREEMPT Debian
aarch64 GNU/Linux

O parâmetro aarch64 confirma que estamos utilizando a arquitetura ARM64.

Comando 2 — Identificar a distribuição Linux

cat /etc/os-release

Função:

Apresenta a identificação da distribuição Linux instalada.

Resultado esperado:

PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
VERSION_ID="13"
VERSION="13 (trixie)"

Essas informações são importantes porque a compatibilidade dos drivers depende da distribuição e da versão do kernel.

3. Conectando o dongle USB Wi-Fi

Conecte o adaptador USB a uma das portas USB do Raspberry Pi 5.

Aguarde alguns segundos para que o Linux reconheça o dispositivo.

Comando 3 — Identificar os dispositivos USB

lsusb

Função:

Lista os dispositivos USB conectados ao Raspberry Pi.

Resultado obtido no teste:

Bus 001 Device 002: ID 0bda:c811
Realtek Semiconductor Corp. 802.11ac NIC

O identificador USB é composto por dois campos:

  • VID: Vendor ID, identificador do fabricante.
  • PID: Product ID, identificador do produto.

Neste caso:

CampoValor
FabricanteRealtek
VID0bda
PIDc811
Dispositivo802.11ac NIC

Esse resultado indica que o adaptador foi reconhecido eletricamente pelo sistema.

Importante: reconhecer o dispositivo USB não significa necessariamente que o driver wireless já esteja funcionando.

4. Verificando a topologia USB e o driver

Comando 4 — lsusb -t

lsusb -t

Função:

Apresenta a topologia dos dispositivos USB, mostrando o barramento, a velocidade e o driver associado a cada dispositivo.

Resultado obtido:

/: Bus 001.Port 001:
   Dev 001, Class=root_hub,
   Driver=xhci-hcd/2p, 480M

   |__ Port 002: Dev 002,
       If 0, Class=Vendor Specific Class,
       Driver=rtw88_8821cu, 480M

O resultado confirma:

  • O dongle está conectado ao barramento USB.
  • A conexão está operando em USB 2.0 High Speed (480 Mbps).
  • O driver rtw88_8821cu está associado ao dispositivo.

Esse é um dos principais comandos para diagnosticar adaptadores wireless USB.

5. Verificando as mensagens do kernel

Comando 5 — dmesg

sudo dmesg | tail -40

Função:

Apresenta as últimas mensagens do kernel Linux.

É utilizado para identificar problemas durante a inicialização do dispositivo e o carregamento do driver.

Podemos encontrar mensagens relacionadas a:

  • Reconhecimento USB.
  • Inicialização do driver.
  • Carregamento de firmware.
  • Criação da interface wireless.
  • Erros de inicialização.

Para filtrar mensagens relevantes:

sudo dmesg | grep -iE \
'usb|rtl|rtw|wlan|firmware|80211'

O resultado esperado é não apresentar erros persistentes de inicialização ou firmware.

6. Identificando as interfaces de rede

Comando 6 — ip -br link

ip -br link

Função:

Lista as interfaces de rede de maneira resumida.

Resultado esperado:

lo       UNKNOWN
eth0     DOWN
wlan0    UP
wlan1    DOWN

Nesse exemplo:

InterfaceDescrição
loLoopback
eth0Ethernet
wlan0Wi-Fi interno
wlan1Dongle USB

A interface wlan1 representa o adaptador adicional.

O estado DOWN não indica necessariamente uma falha. Significa apenas que a interface ainda não foi ativada.

Importante: não altere a interface wlan0 se ela estiver sendo utilizada para acessar o Raspberry Pi remotamente por SSH.

Comando 7 — Identificar interfaces wireless

iw dev

Função:

Apresenta as interfaces reconhecidas pelo subsistema wireless do Linux.

Resultado esperado:

phy#0
    Interface wlan0
        type managed

phy#1
    Interface wlan1
        type managed

O comando também apresenta o PHY associado a cada interface.

Isso permite confirmar que temos dois dispositivos wireless reconhecidos pelo sistema.

7. Identificando o driver instalado

Comando 8 — ethtool

sudo ethtool -i wlan1

Função:

Apresenta informações sobre o driver associado à interface.

Resultado obtido:

driver: rtw88_8821cu
version: 6.18.34+rpt-rpi-2712
firmware-version: N/A
bus-info: 1-2:1.0

Interpretação:

CampoSignificado
driverDriver utilizado
versionVersão do kernel
firmware-versionIdentificação do firmware
bus-infoLocalização no barramento

O resultado confirma que o driver rtw88_8821cu está carregado.

O campo firmware-version: N/A não significa automaticamente que exista um problema.

Podemos também verificar diretamente o driver associado à interface:

readlink -f /sys/class/net/wlan1/device/driver

Esse comando apresenta o caminho do driver utilizado pelo dispositivo.

8. Verificando os módulos carregados

Comando 9 — lsmod

lsmod | grep -E 'rtw88|rtl'

Função:

Lista os módulos do kernel relacionados à família Realtek.

Permite verificar quais módulos do driver estão carregados.

A ausência de um resultado não significa necessariamente que o driver esteja ausente, pois ele pode estar compilado diretamente no kernel.

9. Verificando os recursos do adaptador

Comando 10 — iw list

iw list

Função:

Apresenta os recursos e as capacidades do adaptador wireless.

É um dos comandos mais importantes para avaliar um dongle Wi-Fi.

Devemos procurar as seguintes informações:

Bandas de frequência

Band 1:
    Frequencies:
        * 2412 MHz
        * 2437 MHz
        * 2462 MHz

Essas frequências pertencem à banda de 2,4 GHz.

Para a banda de 5 GHz, poderemos encontrar frequências como:

5180 MHz
5200 MHz
5220 MHz

A disponibilidade depende do hardware, driver e domínio regulatório.

Modos de operação

Procure:

Supported interface modes:
    * managed
    * monitor
    * AP

Significado:

  • managed: conexão normal a uma rede Wi-Fi.
  • monitor: captura de quadros wireless.
  • AP: funcionamento como ponto de acesso.

Nem todos os adaptadores oferecem todos esses recursos.

10. Verificando bloqueios da interface

Comando 11 — rfkill

rfkill list

Função:

Verifica se existe algum bloqueio de rádio.

Resultado esperado:

Wireless LAN
    Soft blocked: no
    Hard blocked: no

Caso apareça Soft blocked: yes, podemos tentar liberar o rádio:

sudo rfkill unblock wifi

Depois execute novamente:

rfkill list

11. Ativando a interface wlan1

Comando 12 — Ativar o adaptador

sudo ip link set wlan1 up

Função:

Ativa a interface wireless.

Para verificar:

ip -br link show wlan1

Resultado esperado:

wlan1    UP

Essa operação não exige desativar a interface interna wlan0.

12. Verificando o domínio regulatório

O domínio regulatório determina quais canais e frequências podem ser utilizados em cada país.

Comando 13 — iw reg get

iw reg get

Função:

Apresenta as regras regulatórias aplicadas ao sistema.

Para configurar o domínio brasileiro:

sudo iw reg set BR

Depois:

iw reg get

O resultado deverá indicar:

country BR:

A lista de frequências e canais dependerá das regras regulatórias vigentes e dos recursos do adaptador.

A configuração do domínio regulatório não transforma um adaptador de 2,4 GHz em um adaptador dual-band e não libera canais não suportados pelo hardware.

13. Desativando a economia de energia

Comando 14 — Power Save

sudo iw dev wlan1 set power_save off

Função:

Desativa a economia de energia da interface wireless.

Isso pode ser útil em aplicações que realizam varreduras frequentes.

Para verificar:

iw dev wlan1 get power_save

Resultado esperado:

Power save: off

A configuração poderá precisar ser reaplicada depois de reinicializações ou reconexões.

14. Realizando a primeira varredura Wi-Fi

Agora vamos testar se o dongle consegue detectar redes wireless.

Comando 15 — nmcli

nmcli device wifi list --rescan yes ifname wlan1

Função:

Solicita uma nova varredura utilizando especificamente a interface wlan1.

Resultado ilustrativo:

IN-USE  SSID          MODE   CHAN  RATE       SIGNAL
        sulwifi       Infra  1     195 Mbit/s  85
        sulwifiBeach  Infra  6     195 Mbit/s  72
        MinhaRede     Infra  36    433 Mbit/s  65

Campos:

  • SSID: nome da rede.
  • MODE: modo de operação.
  • CHAN: canal.
  • RATE: taxa de transmissão anunciada.
  • SIGNAL: intensidade relativa do sinal.

O campo SIGNAL normalmente utiliza uma escala de 0 a 100.

Comando 16 — iw scan

sudo iw dev wlan1 scan

Função:

Executa uma varredura detalhada diretamente pela interface wireless.

Apresenta informações sobre os pontos de acesso encontrados.

Resultado ilustrativo:

BSS 3c:64:cf:6c:be:ae
    freq: 2422
    signal: -48.00 dBm
    SSID: sulwifi

As informações mais importantes são:

CampoSignificado
BSSEndereço MAC do ponto de acesso
freqFrequência em MHz
signalIntensidade em dBm
SSIDNome da rede

Para visualizar somente as informações relevantes:

sudo iw dev wlan1 scan |
grep -E 'BSS |freq:|signal:|SSID:'

Interpretação do sinal

IntensidadeAvaliação aproximada
-30 a -50 dBmExcelente
-51 a -60 dBmMuito bom
-61 a -70 dBmBom
-71 a -80 dBmFraco
Abaixo de -80 dBmMuito fraco

Quanto mais próximo de zero, maior é a potência recebida.

15. Comparando o Wi-Fi interno com o dongle USB

Uma das grandes vantagens de utilizar dois adaptadores é comparar a capacidade de recepção.

Teste da interface interna

sudo iw dev wlan0 scan |
grep -E 'BSS |freq:|signal:|SSID:'

Teste do dongle USB

sudo iw dev wlan1 scan |
grep -E 'BSS |freq:|signal:|SSID:'

Compare os resultados.

Devemos observar:

  1. Quantidade de redes detectadas.
  2. Redes encontradas exclusivamente por cada interface.
  3. Intensidade do sinal das redes comuns.
  4. Canais identificados.
  5. Frequências disponíveis.

Para uma comparação justa, realize as varreduras no mesmo local e em horários próximos.

Evite executar varreduras simultâneas inicialmente.

Também é importante lembrar que o resultado depende da antena, chipset, driver, posição física do adaptador e condições de propagação.

16. Diagnóstico quando o adaptador não funciona

Se o dongle aparecer no lsusb, mas não surgir uma interface wireless, execute:

lsusb
lsusb -t
sudo dmesg | tail -50
ip -br link
iw dev
lsmod | grep -E 'rtw88|rtl'

Esses comandos ajudam a determinar se o problema está relacionado ao reconhecimento USB, driver, firmware ou criação da interface.

Não recomendamos instalar drivers externos aleatoriamente.

Primeiro devemos identificar o chipset e verificar se o kernel já oferece suporte.

17. Resultado do teste realizado no Raspberry Pi 5

O adaptador utilizado neste tutorial apresentou os seguintes resultados:

CaracterísticaResultado
PlataformaRaspberry Pi 5
SistemaDebian 13 Trixie
Kernel6.18.34
ArquiteturaARM64
FabricanteRealtek
USB ID0bda:c811
Dispositivo802.11ac NIC
Driverrtw88_8821cu
Interface criadawlan1
BarramentoUSB 2.0
Velocidade USB480 Mbps

O Linux reconheceu o dispositivo, carregou o driver e criou a interface wlan1 sem necessidade de compilar um driver externo.

A interface interna wlan0 permaneceu funcionando normalmente.

18. Aplicação prática: Wi-Fi Spectrum Analyzer

A instalação de um segundo adaptador wireless abre novas possibilidades para aplicações de análise de redes.

Podemos utilizar o Raspberry Pi 5 como uma plataforma de monitoramento Wi-Fi.

Uma aplicação Node.js pode permitir selecionar qual interface será utilizada para realizar a varredura.

Exemplo de arquitetura:

             RASPBERRY PI 5
                   |
          +--------+--------+
          |                 |
        wlan0              wlan1
          |                 |
      Wi-Fi interno     Realtek USB
          |                 |
          +--------+--------+
                   |
             Node.js API
                   |
          Wi-Fi Spectrum
              Analyzer
                   |
             Web Interface

Funcionalidades possíveis:

  • Selecionar a interface wireless.
  • Listar redes detectadas.
  • Identificar canais de 2,4 GHz.
  • Identificar canais de 5 GHz.
  • Apresentar intensidade de sinal.
  • Comparar a recepção entre adaptadores.
  • Registrar resultados históricos.
  • Construir gráficos de distribuição de canais.

É importante distinguir a análise de redes por varredura da análise de espectro RF propriamente dita. Um adaptador Wi-Fi convencional identifica redes e quadros wireless, mas não mede continuamente toda a energia do espectro como um analisador de espectro dedicado.

19. Conclusão

A instalação de um dongle USB Wi-Fi no Raspberry Pi 5 é uma maneira simples de adicionar uma segunda interface wireless ao sistema.

Neste experimento conseguimos identificar um adaptador Realtek, verificar seu driver, confirmar a criação da interface wlan1 e preparar o ambiente para realizar testes comparativos de recepção.

O principal benefício é poder trabalhar com duas interfaces wireless independentes, ampliando as possibilidades de desenvolvimento de aplicações de monitoramento e diagnóstico de redes Wi-Fi.

O Raspberry Pi 5 passa, assim, a funcionar como uma pequena plataforma de análise e monitoramento de redes sem fio.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *