QUERY · ISSUE

Add extra WLAN authmode in docs

openby eliclementopened 2020-09-10updated 2024-10-01

docsneeds-info

The current docs on the WLAN.scan() method indicates the following 5 authmode modes:

0 – open
1 – WEP
2 – WPA-PSK
3 – WPA2-PSK
4 – WPA/WPA2-PSK

I recently scanned for networks and found one with an authmode 5 which should correspond to a WIFI-AUTH/WPA2-ENTERPRISE authmode but the network authmode module constants available are:

AUTH_MAX (6)
AUTH_OPEN (0)
AUTH_WEP (1)
AUTH_WPA2_PSK (3)
AUTH_WPA_PSK (2)
AUTH_WPA_WPA2_PSK (4)

CANDIDATE · ISSUE

RP2040: wlan.scan results disconnected from documentation and faulty

openby Flipje1955opened 2023-03-16updated 2023-09-09

bugport-rp2

When running wlan.scan on a Pico_w (MicroPython v1.19.1-966-g05bb26010 on 2023-03-13; Raspberry Pi Pico W with RP2040, also on earlier nightly builds), the output is disconnect from the documentation. Examples:

"security": value 5 is returned (whereas doc offers only values 0..4);
"hidden": values 2, 3 sometimes 5 is returned - on a non_hidden network - whereas doc offers only value 0,1;

script used:
import network
station = network.WLAN(network.STA_IF)
station.active(True)
active_ssid = station.scan()
for item in enumerate(active_ssid):
print(item)
station.disconnect()

Assessment

S Sonnet · high

Both issues share the core symptom of wlan.scan() returning security/authmode value 5 which is undocumented (documented range is 0-4). The query (#6430) is an ESP32 documentation request to add WPA2-ENTERPRISE (mode 5) to the docs. The candidate (#11048) is an RP2040 bug report where the same undocumented value 5 appears, plus an additional issue with the hidden field returning values outside 0-1. They are connected by the same documentation gap but are distinct: different ports (ESP32 vs RP2040), different framing (docs request vs bug report), and the candidate has a separate unresolved issue with the hidden field that the query does not address. Neither resolves the other.

Suggested action

Cross-reference these issues. Fixing the documentation gap identified in #6430 would partially address #11048's security field confusion, but #11048 also requires investigation of the hidden field returning values 2, 3, 5 on non-hidden networks on RP2040, which is a separate problem. Link them for context when working on WLAN scan documentation or RP2 network driver fixes.

Add extra WLAN authmode in docs

RP2040: wlan.scan results disconnected from documentation and faulty

Keyboard