clase WLAN – controla las interfaces WiFi integradas¶

La clase WLAN gobierna las radios WiFi integradas en las OpenMV Cam modernas. La misma clase envuelve dos controladores subyacentes diferentes según el MCU WiFi de la placa:

CYW43 (módulo WiFi Infineon CYW43xxx de Murata). Usado por la OpenMV Cam N6, la OpenMV Cam RT1062, la Arduino Portenta H7, la Arduino Nicla Vision y la Arduino Giga R1 WiFi.
NINA W10 (u-blox NINA-W10 / ESP32-WROOM). Usado por la Arduino Nano RP2040 Connect.

Ambos controladores exponen los mismos nombres de métodos pero difieren en algunos argumentos y en el conjunto de claves de config() aceptadas. Las diferencias se señalan a continuación.

Las cámaras OpenMV con un shield WiFi WINC1500 heredado (M4 / M7 / H7 / H7 Plus / Pure Thermal) usan WINC en su lugar.

Ejemplo de uso:

import network

# Enable the station interface and connect to a WiFi AP.
nic = network.WLAN(network.WLAN.IF_STA)
nic.active(True)
nic.connect("your-ssid", "your-key")
while not nic.isconnected():
    pass

print(nic.ipconfig("addr4"))

Constructores¶

class network.WLAN(interface_id: int = WLAN.IF_STA) → None¶

Crea un objeto de interfaz WLAN.

interface_id selecciona sobre qué interfaz operar:

WLAN.IF_STA – modo estación / cliente. Conéctate a un punto de acceso superior con connect(). Este es el valor predeterminado.

WLAN.IF_AP – modo punto de acceso. Configura el AP con config() y acepta conexiones de clientes.

La misma radio física respalda ambas interfaces; construir una no impide la otra.

Métodos¶

active(is_active: bool | None = None) → bool¶

Activa o desactiva la radio WiFi.

Sin argumentos, devuelve el estado actual – True mientras la radio está activa, False en caso contrario.

active(True) alimenta el MCU WiFi, carga su firmware (CYW43 obtiene el blob de firmware desde la memoria flash; NINA valida la versión de firmware actualmente grabada) y levanta la netif de lwIP para esta interfaz. Todos los demás métodos – connect(), scan(), ipconfig() y similares – requieren que la interfaz esté activa.

active(False) vuelve a apagar la radio. En la interfaz STA esto también desasocia del AP actual y libera la netif.

connect(ssid: str, key: str | None = None, *, security: int = -1, bssid: bytes | None = None, channel: int = -1) → None¶

Asocia la interfaz STA con el punto de acceso indicado.

ssid – el SSID de la red (cadena o bytes).

key – contraseña / clave precompartida. Pasa None para una red abierta.

security (solo por palabra clave) – una de las constantes SEC_*. -1 (el valor predeterminado) selecciona automáticamente: SEC_OPEN cuando key está vacía, SEC_WPA_WPA2 en caso contrario.

bssid (solo por palabra clave, solo CYW43) – restringe la asociación al AP con esta dirección MAC de 6 bytes. El controlador NINA lo ignora.

channel (solo por palabra clave) – canal de radio preferido. El valor predeterminado es «que el controlador elija».

disconnect() → None¶: En modo STA, desasocia del punto de acceso actualmente asociado. La interfaz permanece activa; llama a connect() de nuevo para volver a asociar, o a active() (False) para apagar la radio por completo. No hace nada cuando no hay una asociación actual.

isconnected() → bool¶

En modo STA devuelve True cuando está asociado a un punto de acceso y se ha obtenido una dirección IPv4 mediante DHCP (o asignada estáticamente a través de ipconfig()). Devuelve False mientras el enlace está todavía en la fase de autenticación/asociación/DHCP.

En modo AP devuelve True cuando al menos una estación se ha unido.

scan(*, passive: bool = False, ssid: bytes | None = None, bssid: bytes | None = None) → List[Tuple[bytes, bytes, int, int, int, int]]¶

Busca puntos de acceso cercanos y devuelve una lista de tuplas de 6 elementos:

[0] SSID (bytes; vacío para redes ocultas).

[1] BSSID (MAC de 6 bytes, bytes). Conviértelo con binascii.hexlify().

[2] Número de canal.

[3] RSSI en dBm.

[4] Modo de seguridad (una de las constantes SEC_*).

[5] Reservado (siempre 1).

Todos los argumentos de palabra clave son solo para CYW43:

passive – si es True, usa un escaneo pasivo en lugar del escaneo activo predeterminado por solicitud de sondeo.

ssid – restringe el escaneo a un único SSID.

bssid – restringe el escaneo a un único BSSID.

El escaneo solo tiene sentido en una interfaz STA.

status() → int¶

status(param: str) → Any

Consulta el estado de la conexión.

Sin argumentos, devuelve el estado del enlace como un entero pequeño (codificación específica del controlador – un valor verdadero significa «asociado»).

Con un argumento de cadena:

"rssi" – en modo STA, devuelve el RSSI actual en dBm.

"stations" – en modo AP, devuelve una lista de estaciones conectadas. CYW43 devuelve [(mac_bytes,), ...]; NINA devuelve [ip_string, ...].

ifconfig(config: Tuple[str, str, str, str] | None = None) → Tuple[str, str, str, str] | None¶

Obtiene o establece los parámetros IPv4 de la interfaz como una tupla de 4 elementos de cadenas en notación de cuádruple punto (ip, subnet, gateway, dns).

Nota

Prefiere ipconfig() para código nuevo:

nic.ipconfig(addr4="192.168.0.4/24", gw4="192.168.0.1")
network.ipconfig(dns="8.8.8.8")

ipconfig(param: str) → Any¶
ipconfig(**kwargs: Any) → None: Obtiene o establece los parámetros IPv4 / IPv6 de la interfaz. El controlador CYW43 delega en la implementación estándar de lwIP y admite el conjunto completo de claves documentado en AbstractNIC.ipconfig(). El controlador NINA implementa un subconjunto más pequeño por interfaz – dhcp4 y has_dhcp4 (solo lectura), además de addr4 y gw4 para obtener / establecer.

config(param: str) → Any¶

config(**kwargs: Any) → None

Obtiene o establece los parámetros de la interfaz específicos de WiFi.

Con un único argumento posicional de cadena, devuelve el valor de ese parámetro. Con argumentos de palabra clave, establece uno o más parámetros a la vez – los cambios que afectan a un AP en ejecución hacen que el AP se apague y se vuelva a levantar automáticamente.

Ejemplo:

# Set up the access-point name and channel.
ap.config(ssid="My AP", channel=11)
# Query params one at a time.
print(ap.config("ssid"))
print(ap.config("mac"))

Controlador CYW43 – parámetros obtenibles:

"antenna" – selector de antena (entero).

"channel" – canal actual.

"ssid" / "essid" – el SSID actual (cadena).

"security" – el modo de autenticación del AP (uno de SEC_*).

"mac" – dirección MAC de la interfaz (6 bytes).

"pm" – valor de gestión de energía.

"txpower" – potencia de transmisión en dBm.

"hostname" – nombre de host DHCP/mDNS. Obsoleto; usa network.hostname() en su lugar.

Controlador CYW43 – parámetros configurables:

antenna=<int> – selector de antena.

channel=<int> – canal del AP.

ssid=<str> / essid=<str> – SSID del AP.

key=<str> / password=<str> – clave precompartida del AP.

security=<int> – modo de autenticación del AP (uno de SEC_*).

pm=<int> – modo de gestión de energía (uno de PM_NONE, PM_PERFORMANCE, PM_POWERSAVE).

monitor=<int> – habilita el modo monitor / multidifusión total.

txpower=<int> – potencia de transmisión en dBm.

trace=<int> – máscara de bits de trazado interno del controlador.

hostname=<str> – nombre de host DHCP/mDNS. Obsoleto; usa network.hostname() en su lugar.

Controlador NINA – parámetros obtenibles:

"ssid" – el SSID actual (cadena).

"security" – el modo de autenticación del AP.

"mac" / "bssid" – dirección MAC de la interfaz (6 bytes).

"fw_version" – una tupla de 3 elementos (major, minor, patch).

Controlador NINA – parámetros configurables: la llamada se reenvía a connect() y acepta los mismos argumentos de palabra clave (ssid, key, security, channel). Solo válido en la interfaz AP.

deinit() → None¶: Reinicia la alimentación del MCU WiFi y libera todos los recursos que mantiene el controlador (búferes de firmware, netif de lwIP, bus SPI/SDIO). Después de llamar a esto, el objeto WLAN debe reconstruirse antes de usarse. Usa esto en lugar de active() (False) cuando necesites un reinicio completo (por ejemplo, antes de regrabar el firmware de la radio o para recuperarte de un estado bloqueado del controlador). Solo CYW43.

send_ethernet(buf: bytes) → None¶: Inyecta el fotograma Ethernet sin procesar buf directamente en la ruta de transmisión del controlador, evitando la pila IP. Pensado para consumidores de solo L2 – puentes, protocolos EtherType personalizados y similares. El fotograma debe incluir las MAC de destino/origen y el EtherType (sin FCS – el hardware lo añade). Solo CYW43.

ioctl(cmd: int, buf: bytearray) → None¶: Emite un comando de control específico del controlador. cmd es el código ioctl numérico definido por el firmware de la radio subyacente y buf es un búfer mutable usado tanto para la carga útil del comando como para la respuesta. El conjunto de valores cmd válidos es específico del controlador y no es portable entre CYW43 y NINA. Lo usan principalmente los scripts de prueba de bajo nivel y el código de puesta en marcha del chip.

Constantes¶

IF_STA: int¶: Identificador de la interfaz de estación / cliente. Pásalo al constructor para seleccionar el modo STA.

IF_AP: int¶: Identificador de la interfaz de punto de acceso. Pásalo al constructor para seleccionar el modo AP.

SEC_OPEN: int¶: Valor de seguridad para una red sin cifrar. Disponible en ambos controladores.

SEC_WPA_WPA2: int¶: Valor de seguridad para WPA / WPA2 con una clave precompartida. El valor predeterminado cuando se proporciona una clave a connect(). Disponible en ambos controladores.

SEC_WPA3: int¶: Valor de seguridad para WPA3 (SAE) con una clave precompartida. Solo CYW43.

SEC_WPA2_WPA3: int¶: Valor de seguridad para el modo de transición WPA2 / WPA3. Solo CYW43.

SEC_WEP: int¶: Valor de seguridad para WEP (Wired Equivalent Privacy). Se proporciona por compatibilidad con puntos de acceso heredados – WEP está roto criptográficamente y no debe usarse en implementaciones nuevas. Solo NINA.

OPEN: int¶: Alias de retrocompatibilidad para SEC_OPEN. El código nuevo debe usar SEC_OPEN. Solo NINA.

WEP: int¶: Alias de retrocompatibilidad para SEC_WEP. El código nuevo debe usar SEC_WEP. Solo NINA.

WPA_PSK: int¶: Alias de retrocompatibilidad para SEC_WPA_WPA2. El código nuevo debe usar SEC_WPA_WPA2. Solo NINA.

PM_NONE: int¶: Pásalo a config(pm=...) para deshabilitar la gestión de energía WiFi. Solo CYW43.

PM_PERFORMANCE: int¶: Pásalo a config(pm=...) para habilitar la gestión de energía WiFi ajustada para el rendimiento. Solo CYW43.

PM_POWERSAVE: int¶: Pásalo a config(pm=...) para habilitar la gestión de energía WiFi ajustada para la máxima duración de la batería. Solo CYW43.