How do I debug this Wi-Fi crash?

[cdevidal]

I've got three custom PCBs with ESP32-WROVER-E and all three give the same behavior when trying to connect to Wi-Fi, without any error message. An ESP32-WROVER-IE devkit works just fine. How can I enable deep debugging to understand the crash?

>>> import network
>>> wlan = network.WLAN(network.STA_IF)
>>> wlan.active(True)     # Crashes here
MicroPython v1.25.0 on 2025-04-15; Generic ESP32 module with SPIRAM with ESP32
Type "help()" for more information.
>>> # Rebooted

[cdevidal]

Working devkit with an ESP32-WROVER-IE:

>>> import network
>>> wlan = network.WLAN(network.STA_IF)
>>> wlan.active(True)
True
>>>

[robert-hh]

It looks like a power supply problem, which causes Vcc to drop once RF is sent. What is the result of machine.reset_cause() after (re-)boot?

[cdevidal]

Do you mean a USB - UART bridge? Theses can usually not supply the current needed for an ESP32. You can try to add a large capacitor close to the WROOM module betwee4n 3V3 and GND.

I figured the breadboard supply would at least handle it, but the esp.osdebug output below shows I have a brownout, so you're probably correct. Perhaps the supply plus a larger cap together.

[cdevidal]

@robert-hh what power supply do you use? I added a 0.1uF ceramic and a 330uF electrolytic in parallel 10mm from the ESP32 module but it's still happening. Breadboard power supply has an AMS1117-3.3 with additional 100uF electrolytic. Regulates down a 12V 1A wall wart.

[robert-hh]

I just have ready-to-use boards from Wemos or epsressif with USB insterface, which take poer from USB and an on.board regulator. The AMS1117-3.3 should deliver sufficient current- It may not be the fastest regulator, but the cap close to the WROOM module should handle that. And it's used in that context.
Did you connect all GND pins of the WROOM module?

[cdevidal]

Indeed I did connect all three GND pins of the WROVER, and I used big beefy 0.8 mm/31 mil traces for GND, 1 oz copper on the PCB. Tried a third breadboard power supply and even a 10A bench power supply, same problem. My working DevKitC also uses an AMS1117. The resistance of the custom PCB between 3.3V and GND is 13.5kOhm so it's not idling with excess current.

[cdevidal]

That was the problem. There's definitely a problem in the PCB design. I connected the bench power supply directly to the bypass cap leads that I had soldered on and can now start Wi-Fi without crashing. So, something is wrong in the PCB design.

[Josverl]

You can enable esp tracing to see whats happening on the nic level

import network
import esp
esp.osdebug(0,esp.LOG_VERBOSE)

wl=network.WLAN()
wl.active(1)
wl.connect("SSID", "MicroPassword")

[cdevidal]

Very good. That told me that I'm experiencing a brownout. I think @robert-hh is correct, it's either power supply and/or it needs a larger bypass cap.

I BOD: Brownout detector was triggered