🛠 Se connecter au Wi-Fi (et comprendre les limites 2,4 GHz / WPA2)

Objetivos

Configurar y diagnosticar la conexión Wi-Fi de la Zero 2 W: el combo de radio integrado (chip Cypress/Infineon clase 43430) está limitado a 2,4 GHz 802.11n (máximo 35 Mb/s) y a WPA2 — no admite 5 GHz, ni WPA3 (bug de origen abierto desde 2021, raspberrypi/linux#4718). Saber leer la calidad del enlace es la base de cualquier proyecto IoT fiable.

Material

• 1 Raspberry Pi Zero 2 W ya iniciada en modo headless (ver el tutorial de instalación)
• Un punto de acceso 2,4 GHz en WPA2 (si su router está solo en WPA3, cree una red de invitados WPA2/2.4 GHz — la Zero 2 W no podrá unirse a la red principal)
• Antena integrada bajo la blindaje metálico: no hay conector de antena externa (la huella u.FL en la placa es solo para la certificación) — la ubicación de la placa es por tanto muy importante.

Código completo

# Avec wpa_cli (Raspberry Pi OS Lite) :
sudo wpa_cli -i wlan0 scan
sudo wpa_cli -i wlan0 scan_results | grep -i "mon_reseau"
sudo wpa_cli -i wlan0 add_network
sudo wpa_cli -i wlan0 set_network 0 ssid '"mon_reseau"'
sudo wpa_cli -i wlan0 set_network 0 psk '"motdepassewifi"'
sudo wpa_cli -i wlan0 select_network 0

# Diagnostic du lien :
iw dev wlan0 link          # état + signal en dBm
iw dev wlan0 info          # canal, bitrate
ip -4 addr show wlan0      # adresse IP obtenue (DHCP ?)
ping -c 4 1.1.1.1          # connectivité hors DNS

Verificación esperada

« iw dev wlan0 link » muestra « Connected to » con una señal: por encima de -70 dBm es cómodo, por debajo de -85 dBm es marginal en 2,4 GHz. El ping a 1.1.1.1 pasa. Si la red objetivo está en WPA3, el escaneo la ve pero la asociación falla eternamente — es el límite de hardware documentado, no su contraseña.

Errores frecuentes

• Router en modo solo WPA3: el chip no sabe hacerlo; mantenerse en WPA2 o WPA2/WPA3 mixto.
• Red de empresa 802.1X: wpa_cli en PSK no es suficiente, se necesita un archivo wpa_supplicant dedicado (EAP-PEAP + identificador).
• Conectar solo la banda de 5 GHz: la Zero 2 W es ciega a 5 GHz; si el router solo emite un SSID de 5 GHz, nunca lo verá.
• Interferencias en 2,4 GHz (vecinos, microondas): las velocidades y la latencia se desploman sin desconexión visible — compare la tasa de bits con « iw dev wlan0 info ».
• Errores « brcmfmac ... failed: -5 » y cortes tras la actualización a Bookworm: bug conocido (raspberrypi/firmware#1962); pruebe un núcleo/firmware anterior o registre el log con dmesg antes de sospechar de la antena.