🛠 Se connecter à un réseau Wi-Fi (station, WPA2/WPA3)

Objetivos

Primer paso real de red de la Pico W: unirse a un punto de acceso Wi-Fi en modo estación. El CYW43439 es una radio Wi-Fi 4 (802.11n) de banda única de 2,4 GHz únicamente — olvida las redes de 5 GHz — con soporte para WPA3. Vas a utilizar el módulo network de MicroPython (el camino recomendado por la hoja de datos: MicroPython es «the fastest way to get code running on Pico W»), entender el ciclo active → connect → isconnected, y obtener la dirección IP.

Material

• 1 × Raspberry Pi Pico W + cable micro-USB de datos
• Firmware MicroPython raspberry_pi_pico_w (build _picow, incluye el controlador cyw43)
• Un punto de acceso 2,4 GHz (WPA2 o WPA3) — nada de 5 GHz
• Consola serie (Thonny, picocom…) a 115200 baudios

Código completo

# main.py — connexion Wi-Fi station sur Pico W (MicroPython)
# Sauvegardé sous main.py, il se lance à chaque mise sous tension.
import machine, network, time

def do_connect:
    wlan = network.WLAN          # interface station (par défaut)
    wlan.active(True)              # alimente l'interface du CYW43439
    if not wlan.isconnected:
        print('connecting to network...')
        wlan.connect('my_ssid', 'my_password')   # identifiants WPA2/WPA3
        while not wlan.isconnected:
            machine.idle         # dort entre les tentatives (économise)
    print('network config:', wlan.ipconfig('addr4'))

do_connect
# Dépannage : wlan.status donne le code d'échec d'association.
# Après wlan.connect, MicroPython réessaie indéfiniment par défaut.

Verificación esperada

La consola muestra network config: ('192.168.x.x', '255.255.255.0', ...): la Pico W ha obtenido su concesión DHCP. Puedes hacerle ping desde tu PC (misma red). El LED del CYW43 puede parpadear durante la asociación. Prueba WPA3 si tu router lo ofrece: el controlador cyw43 lo gestiona.

Errores frecuentes

• Red de 5 GHz: el CYW43439 es únicamente de 2,4 GHz — la conexión falla silenciosamente o por timeout. Verifica el SSID de la banda de 2,4 GHz de tu router.
• Firmware MicroPython estándar (no _picow): network.WLAN devuelve un error o ninguna interfaz — vuelve a flashear el build Pico W.
• Credenciales con caracteres especiales mal escapados en la cadena Python: prueba primero con una contraseña simple.
• Bucle de espera sin machine.idle: funciona, pero saturas la CPU innecesariamente; idle pone el núcleo en espera entre dos intentos.
• Antena obstruida: la zona de exclusión (keep-out) de 14 × 9 mm en el borde de la placa no debe estar cubierta por nada, especialmente no por metal (carcasa metálica = jaula de Faraday, ganancia degradada — documentado en la hoja de datos).
• Usar wlan.status en lugar de quedarse bloqueado en isconnected: es la herramienta de diagnóstico de los fallos de asociación (contraseña incorrecta, AP no encontrado…).