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 -aFunçã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/LinuxO parâmetro aarch64 confirma que estamos utilizando a arquitetura ARM64.
Comando 2 — Identificar a distribuição Linux
cat /etc/os-releaseFunçã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
lsusbFunçã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 NICO identificador USB é composto por dois campos:
- VID: Vendor ID, identificador do fabricante.
- PID: Product ID, identificador do produto.
Neste caso:
| Campo | Valor |
|---|---|
| Fabricante | Realtek |
| VID | 0bda |
| PID | c811 |
| Dispositivo | 802.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 -tFunçã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, 480MO 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_8821cuestá 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 -40Funçã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 linkFunção:
Lista as interfaces de rede de maneira resumida.
Resultado esperado:
lo UNKNOWN
eth0 DOWN
wlan0 UP
wlan1 DOWNNesse exemplo:
| Interface | Descrição |
|---|---|
| lo | Loopback |
| eth0 | Ethernet |
| wlan0 | Wi-Fi interno |
| wlan1 | Dongle 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 devFunção:
Apresenta as interfaces reconhecidas pelo subsistema wireless do Linux.
Resultado esperado:
phy#0
Interface wlan0
type managed
phy#1
Interface wlan1
type managedO 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 wlan1Funçã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.0Interpretação:
| Campo | Significado |
|---|---|
| driver | Driver utilizado |
| version | Versão do kernel |
| firmware-version | Identificação do firmware |
| bus-info | Localizaçã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/driverEsse 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 listFunçã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 MHzEssas frequências pertencem à banda de 2,4 GHz.
Para a banda de 5 GHz, poderemos encontrar frequências como:
5180 MHz
5200 MHz
5220 MHzA disponibilidade depende do hardware, driver e domínio regulatório.
Modos de operação
Procure:
Supported interface modes:
* managed
* monitor
* APSignificado:
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 listFunção:
Verifica se existe algum bloqueio de rádio.
Resultado esperado:
Wireless LAN
Soft blocked: no
Hard blocked: noCaso apareça Soft blocked: yes, podemos tentar liberar o rádio:
sudo rfkill unblock wifiDepois execute novamente:
rfkill list11. Ativando a interface wlan1
Comando 12 — Ativar o adaptador
sudo ip link set wlan1 upFunção:
Ativa a interface wireless.
Para verificar:
ip -br link show wlan1Resultado esperado:
wlan1 UPEssa 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 getFunção:
Apresenta as regras regulatórias aplicadas ao sistema.
Para configurar o domínio brasileiro:
sudo iw reg set BRDepois:
iw reg getO 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 offFunçã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_saveResultado esperado:
Power save: offA 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 wlan1Funçã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 65Campos:
- 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 scanFunçã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: sulwifiAs informações mais importantes são:
| Campo | Significado |
|---|---|
| BSS | Endereço MAC do ponto de acesso |
| freq | Frequência em MHz |
| signal | Intensidade em dBm |
| SSID | Nome da rede |
Para visualizar somente as informações relevantes:
sudo iw dev wlan1 scan |
grep -E 'BSS |freq:|signal:|SSID:'Interpretação do sinal
| Intensidade | Avaliação aproximada |
|---|---|
| -30 a -50 dBm | Excelente |
| -51 a -60 dBm | Muito bom |
| -61 a -70 dBm | Bom |
| -71 a -80 dBm | Fraco |
| Abaixo de -80 dBm | Muito 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:
- Quantidade de redes detectadas.
- Redes encontradas exclusivamente por cada interface.
- Intensidade do sinal das redes comuns.
- Canais identificados.
- 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ística | Resultado |
|---|---|
| Plataforma | Raspberry Pi 5 |
| Sistema | Debian 13 Trixie |
| Kernel | 6.18.34 |
| Arquitetura | ARM64 |
| Fabricante | Realtek |
| USB ID | 0bda:c811 |
| Dispositivo | 802.11ac NIC |
| Driver | rtw88_8821cu |
| Interface criada | wlan1 |
| Barramento | USB 2.0 |
| Velocidade USB | 480 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 InterfaceFuncionalidades 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