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

Objectifs

Diagnostiquer et configurer le Wi-Fi de la Zero W depuis un terminal : la carte embarque la puce Cypress CYW43438 (802.11n 2,4 GHz seul, ~35 Mb/s, + Bluetooth 4.0/BLE), interface wlan0.

Matériel

• 1 Raspberry Pi Zero W sous Raspberry Pi OS (session SSH ou écran + clavier via adaptateurs mini-HDMI / micro-USB)
• Un point d'accès 2,4 GHz

Étapes

1. Réglez le pays radio : sudo raspi-config → 5 Localisation → L4 WLAN Country. Mauvais domaine = canaux/puissance incorrects, légalité et perfs dégradées.
2. Vérifiez la radio : nmcli radio wifi doit afficher enabled.
3. Scannez : nmcli dev wifi list (SSID, SIGNAL, SECURITY).
4. Connectez-vous : sudo nmcli --ask dev wifi connect <ssid_du_spot> puis entrez la passphrase.
5. Contrôlez le lien et le niveau de signal : iw dev wlan0 link (ligne signal: en dBm).

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

Vérification

iw dev wlan0 link affiche SSID, canal et signal ; le ping sort sur Internet.

Erreurs fréquentes

• Chercher du 5 GHz : la Zero W est single-band 2,4 GHz, puce identique à celle du Pi 3 B.
• Boîtier métallique : l'antenne est une simple trace PCB (plan de masse découpé) ; le métal l'affaiblit fortement.
• Pays WLAN non réglé : réseau « introuvable » alors qu'il est émis sur un canal hors domaine.