ESP32 'LAN' Network Interface 'status' code explanation?

[Jibun-no-Kage]

ESP32 'LAN' Network Interface 'status' code explanation? Specifically network.LAN().status(), and interface instance of, returns 5 after isconnected() returns 5, after .active(False) also returns 5. Was expecting something different? Searched the ESP32 network docs... no reference the values status() returns?

[scruss]

Are there any network.LAN.STAT_* entries available to you? For WLAN (and yes, I know you're asking about the phy) on ESP32, I see:

STAT_ASSOC_FAIL: 203
STAT_BEACON_TIMEOUT: 200
STAT_CONNECT_FAIL: 203
STAT_CONNECTING: 1001
STAT_GOT_IP: 1010
STAT_HANDSHAKE_TIMEOUT: 204
STAT_IDLE: 1000
STAT_NO_AP_FOUND: 201
STAT_NO_AP_FOUND_IN_AUTHMODE_THRESHOLD: 211
STAT_NO_AP_FOUND_IN_RSSI_THRESHOLD: 212
STAT_NO_AP_FOUND_W_COMPATIBLE_SECURITY: 210
STAT_WRONG_PASSWORD: 202

which I can use like:

sta_if = network.WLAN(network.STA_IF)
if sta_if.status() == network.STAT_GOT_IP:
    print("Got IP!")

Maybe there are similar defs for the LAN?

[Jibun-no-Kage]

Should be exposed via dir('module') once imported right? That published the list of defined constants... but not the values for each. :) If they are defined in 'network' would think they are common to WLAN and LAN based connection right? After a successful connection via LAN, i.e. Ethernet based connection, I get 5. But print(network.STAT_GOT_IP) results in 1010.

Connect?
Connect!
5
Ip Address 192.168.1.213, Mask 255.255.255.0, Gateway 192.168.1.3, Name Server 192.168.1.251
Media Access Control DC:DA:0C:19:6B:2B

Where...

theConnectOrNot = theInterface.isconnected()
if (theConnectOrNot):
    if (theTimeOut != TIMEOUT):
        print()
        
    print('Connect!')
    print(theInterface.status())
    
    theAddress,theMask,theGateway,theNameServer = theInterface.ifconfig()
    print(f"Ip Address {theAddress}, Mask {theMask}, Gateway {theGateway}, Name Server {theNameServer}")
    
    print('Media Access Control', hexlify(theInterface.config('mac'), ':').decode().upper())
    
else:
    print(f"Connect? {theConnectOrNot}")

Of course I have a while loop watching for successful connect or not, redacted that code.

[Josverl]

Fwiw, users of the MicroPython-stubs could have found both that symbol and the value.

https://github.com/Josverl/micropython-stubs/blob/95264a62f5d8a52adcee4fe5627cbbc4f2722c45/publish/micropython-v1_25_0-esp32-stubs/network.pyi#L98

Still, depending on the context the number 5 could also mean network.PHY_KSZ8041

[Jibun-no-Kage]

But 5 for PHY_KSZ8041... is a type not a status... I would think network.LAN.status() or network.WLAN.status() would only return status enum values, not interface/adapter types, right?

[Josverl]

Concur, that is the context I was referring to.
There are a lot of flags and values in both the APIs and the protocols. Not all are represented as symbols in MicroPython, and afaik when returned, you just get the (int) 5, rather than the MicroPython object, as that has been optimized/folded to its minimal essense

[scruss]

Fwiw, users of the MicroPython-stubs could have found both that symbol and the value.

this is something I'd need to stop using emacs to use, though

[Josverl]

this is something I'd need to stop using emacs to use, though

If I understand correctly Emacs supports LSP servers through lsp-mode or lsp-gui

No personal experience with that though

[Jibun-no-Kage]

Oh... Just for reference...

from network import LAN, PHY_W5500

theBus = SPI(BUS, sck=Pin(CLOCK), mosi=Pin(MOSI), miso=Pin(MISO))
theInterface = LAN(phy_type=PHY_W5500, spi=theBus, phy_addr=1, cs=Pin(CARRIER), int=Pin(INTERRUPT))

theInterface.active(True)

[Jibun-no-Kage]

Google A.I. seems half confused... It completely ignored the LAN vs. WLAN qualification....

In MicroPython (wlan.status()):
The return value is one of the network module constants:

    network.STAT_IDLE: No connection and no activity.
    network.STAT_CONNECTING: Connection process is ongoing.
    network.STAT_WRONG_PASSWORD: Failed due to an incorrect password.
    network.STAT_NO_AP_FOUND: Failed because no access point replied.
    network.STAT_CONNECT_FAIL: Failed due to other problems.
    network.STAT_GOT_IP: Connection successful and an IP address has been obtained.

[Jibun-no-Kage]

Found it... I have not used "help('module name')" much... dir(module) always seemed to be sufficient. But reading through the MP sources, I rediscovered the help(module) feature. Gave some interesting results:

ETH_INITIALIZED -- 0
ETH_STARTED -- 1
ETH_STOPPED -- 2
ETH_CONNECTED -- 3
ETH_DISCONNECTED -- 4
ETH_GOT_IP -- 5

Likely given the nature of ESP32 modules 99% of the time WLAN nic abstraction is used... not LAN. It does raise the question... why common constants are not used when applicable.