🛠 Se connecter au Wi-Fi en ligne de commande (nmcli)

Objetivos

Diagnosticar y configurar la Wi-Fi de la Zero W desde una terminal: la tarjeta incorpora el chip Cypress CYW43438 (802.11n solo 2,4 GHz, ~35 Mb/s, + Bluetooth 4.0/BLE), interfaz wlan0.

Material

• 1 Raspberry Pi Zero W con Raspberry Pi OS (sesión SSH o pantalla + teclado mediante adaptadores mini-HDMI / micro-USB)
• Un punto de acceso de 2,4 GHz

Pasos

1. Configure el país de la radio: sudo raspi-config → 5 Localización → L4 País WLAN. Un dominio incorrecto = canales/potencia incorrectos, legalidad y rendimiento degradados.
2. Verifique la radio: nmcli radio wifi debe mostrar enabled.
3. Escanee: nmcli dev wifi list (SSID, SIGNAL, SECURITY).
4. Conéctese: sudo nmcli --ask dev wifi connect <ssid_del_punto_de_acceso> y luego introduzca la contraseña.
5. Controle la conexión y el nivel de señal: iw dev wlan0 link (línea signal: en dBm).

nmcli -t -f IP4.ADDRESS dev show wlan0   # bail DHCP
ping -c 3 1.1.1.1                        # sortie Internet

Verificación

iw dev wlan0 link muestra SSID, canal y señal; el ping sale a Internet.

Errores frecuentes

• Buscar 5 GHz: la Zero W es single-band 2,4 GHz, chip idéntico al del Pi 3 B.
• Caja metálica: la antena es una simple traza PCB (plano de masa recortado); el metal la debilita fuertemente.
• País WLAN no configurado: red «no encontrada» aunque se emita en un canal fuera del dominio.