class WINC – driver pentru shield WiFi#

Clasa WINC controlează modulul WiFi Atmel WINC1500 802.11 b/g/n de pe OpenMV WiFi Shield. Disponibil pe OpenMV Cam M4, M7, H7, H7 Plus și Pure Thermal (plăcile STM32 pentru care a fost proiectat shield-ul WiFi). Pentru plăcile cu WiFi încorporat (OpenMV Cam N6, OpenMV Cam RT1062, Arduino Giga) folosiți WLAN în schimb.

Exemplu – conectarea la un punct de acces și afișarea adresei:

import network

wlan = network.WINC()
wlan.connect("SSID", "KEY", security=network.WINC.WPA_PSK)

print("status:    ", "connected" if wlan.isconnected() else "off")
print("rssi:      ", wlan.rssi(), "dBm")
print("interface: ", wlan.ifconfig())
print("netinfo:   ", wlan.netinfo())

Exemplu – pornirea unui punct de acces deschis și așteptarea unui client:

import network

wlan = network.WINC(mode=network.WINC.MODE_AP)
wlan.start_ap("OpenMV-Cam", security=network.WINC.OPEN, channel=6)

print("waiting for a station to associate...")
print(wlan.wait_for_sta(timeout=None))

Constructori#

class network.WINC(mode: int = WINC.MODE_STA) → None#

Creează un obiect driver WINC și pornește shield-ul WiFi.

mode selectează modul de operare în care pornește modulul:

WINC.MODE_STA – stație / client. Conectați-vă la un punct de acces cu connect(). Acesta este modul implicit.
WINC.MODE_AP – punct de acces. Configurați AP-ul cu start_ap(), apoi acceptați conexiunile clienților.
WINC.MODE_P2P – WiFi Direct.
WINC.MODE_BSP – pornește doar BSP-ul (fără radio).
WINC.MODE_FIRMWARE – mod de actualizare a firmware-ului; necesar pentru fw_dump() și fw_update().

Notă

În modul AP, WINC1500 are limite hardware:

Se poate conecta un singur client la un moment dat.
Sunt acceptate doar securitatea OPEN sau WEP.
O eroare în firmware-ul modulului WiFi face ca orice socket legat să nu mai funcționeze atunci când clientul se deconectează. Setați un timeout pe socket-ul serverului astfel încât acesta să genereze o excepție pe care o puteți folosi pentru a-l redeschide.

Metode#

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

Activează sau dezactivează shield-ul WiFi.

Fără argument, returnează starea curentă – True cât timp shield-ul este inițializat și radioul este activ, False în caz contrar.

active(True) efectuează handshake-ul firmware-ului WINC1500 prin SPI și pornește radioul în mode-ul configurat. Este o operație fără efect dacă interfața este deja activă. connect() apelează automat acest lucru dacă nu a fost încă apelat; pentru orice altă metodă (scan(), rssi(), netinfo(), …) trebuie să apelați mai întâi active(True).

active(False) oprește din nou radioul (WINC trece în modul doar-BSP) și eliberează pinii SPI.

connect(ssid: str, key: str | None = None, *, security: int = WINC.WPA_PSK, channel: int = 1) → None#

Se asociază cu rețeaua WiFi ssid folosind parola key, modul de securitate security (una dintre OPEN, WPA_PSK sau constanta 802.1X) pe canalul radio channel. security și channel sunt exclusiv de tip cuvânt-cheie.

După conectare, folosiți modulul socket pentru a deschide porturi TCP/UDP.

Această metodă blochează execuția până când asocierea se finalizează sau eșuează.

config(ssid: str, key: str | None = None, *, security: int = WINC.WPA_PSK, channel: int = 1) → None#: Alias pentru connect(). Furnizat pentru compatibilitate cu codul care apelează config pe alte interfețe network.

start_ap(ssid: str, key: str | None = None, *, security: int = WINC.OPEN, channel: int = 1) → None#: Alias pentru connect() folosit după construirea obiectului cu mode=MODE_AP pentru a configura și porni punctul de acces. AP-ul acceptă doar securitatea OPEN sau WEP; dacă se folosește WEP, key este obligatoriu.

disconnect() → None#: În modul STA, se dezasociază de la punctul de acces cu care este asociat în prezent. Shield-ul rămâne activ; apelați connect() pentru a vă reasocia. Operație fără efect atunci când nu este asociat în prezent.

isconnected() → bool#: În modul STA, returnează True atunci când este asociat cu un punct de acces și a fost obținută o adresă IPv4 (prin DHCP sau ifconfig()). Returnează False cât timp se află încă în faza de autentificare / asociere / DHCP.

connected_sta() → List[str]#: În modul AP, returnează o listă conținând adresa IP a clientului conectat în prezent (sau o listă goală dacă niciun client nu este conectat).

wait_for_sta(timeout: int | None) → List[str]#: În modul AP, blochează execuția până când un client se conectează și returnează o listă conținând adresa IP a clientului. timeout este timpul maxim de așteptare în milisecunde; transmiteți None pentru a aștepta la nesfârșit.

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

Obține sau setează parametrii interfeței IPv4. Tuplul de 4 elemente conține (ip, subnet, gateway, dns) ca șiruri în notație cu punct.

Apelată fără argument: returnează configurația curentă.

Apelată cu un tuplu de 4 elemente: setează o configurație IP statică în locul celei obținute prin DHCP.

Exemplu – fixarea unei adrese IP statice înainte de conectare:

wlan = network.WINC()
wlan.ifconfig(("192.168.1.100", "255.255.255.0",
               "192.168.1.1", "192.168.1.1"))
wlan.connect(SSID, key=KEY, security=network.WINC.WPA_PSK)

Notă

WINC nu implementează API-ul modern AbstractNIC.ipconfig(); folosiți ifconfig() aici.

netinfo() → Tuple[int, int, str, str, str]#

Returnează un tuplu de 5 elemente care descrie asocierea curentă:

[0] RSSI ca număr întreg (dBm).
[1] Mod de securitate – una dintre constantele de securitate.
[2] Șirul SSID.
[3] BSSID ca șir MAC "XX:XX:XX:XX:XX:XX".
[4] Adresa IPv4 ca șir în notație cu punct.

scan() → List[Tuple[str, str, int, int, int, int]]#

Scanează punctele de acces din apropiere. Returnează o listă de tupluri de 6 elemente:

[0] Șirul SSID.
[1] BSSID ca șir MAC "XX:XX:XX:XX:XX:XX".
[2] Numărul canalului.
[3] RSSI în dBm.
[4] Mod de securitate – una dintre constantele de securitate.
[5] Rezervat (întotdeauna 1).

Poate fi apelată fără a fi mai întâi asociat cu o rețea.

rssi() → int#: Returnează RSSI în dBm al punctului de acces cu care este asociat în prezent. Aproximativ: -30 este excelent, -67 este acceptabil pentru streaming, -80 este marginal, -90 și mai jos este inutilizabil. Are sens doar în modul STA cât timp isconnected() este True.

fw_version() → Tuple[int, int, int, int, int, int, int]#

Returnează un tuplu de 7 elemente care descrie versiunile de firmware și driver ale WINC1500:

[0] Versiunea majoră a firmware-ului.
[1] Versiunea minoră a firmware-ului.
[2] Patch-ul firmware-ului.
[3] Versiunea majoră a driverului.
[4] Versiunea minoră a driverului.
[5] Patch-ul driverului.
[6] Revizia hardware a cipului.

fw_dump(path: str) → None#

Citește memoria flash internă a WINC1500 și scrie imaginea de firmware rezultată în fișierul de la path pe sistemul de fișiere al OpenMV. Folosiți acest lucru pentru a face o copie de rezervă a imaginii instalate în prezent înainte de a apela fw_update().

Necesită ca modulul să fi fost construit cu mode=MODE_FIRMWARE.

fw_update(path: str) → None#

Șterge memoria flash internă a WINC1500 și o programează cu imaginea binară de la path. Imaginea trebuie să corespundă structurii așteptate de firmware-ul OpenMV (de obicei furnizată de Atmel / Microchip împreună cu WINC SDK).

Apelul blochează execuția timp de câteva secunde cât timp memoria flash este programată și verificată. Reporniți alimentarea OpenMV Cam după ce apelul returnează, astfel încât WINC1500 să pornească din noua imagine.

Necesită ca modulul să fi fost construit cu mode=MODE_FIRMWARE.

Constante#

OPEN: int#: Valoare de securitate pentru o rețea necriptată. Transmiteți la argumentul security al connect() / start_ap().

WPA_PSK: int#: Valoare de securitate pentru WPA/WPA2 cu o cheie pre-partajată. Valoarea implicită pentru connect().

Notă

Există și o valoare de securitate WPA/WPA2 Enterprise (802.1X). Firmware-ul o expune sub numele 802_1X, care nu este un identificator Python valid – accesați-o prin getattr(network.WINC, "802_1X").

MODE_STA: int#: Mod stație – conectare la un punct de acces ca client. Modul implicit al constructorului.

MODE_AP: int#: Mod punct de acces – WINC devine AP-ul cu care se asociază clienții.

MODE_P2P: int#: Mod WiFi-Direct (peer-to-peer).

MODE_BSP: int#: Inițializează doar pachetul de suport al plăcii WINC – radioul nu este pornit. Folosit de fluxul de actualizare a firmware-ului.

MODE_FIRMWARE: int#: Mod de actualizare a firmware-ului. Necesar pentru fw_dump() și fw_update().