ESP32 error messages, explained

The Guru Meditation Errors, watchdog messages, reset reasons, WiFi disconnect reasons and esp_err_t codes an ESP32 prints: what each means, why it usually happens, and what to do.

Each page has the message exactly as the ESP32 prints it, what it means, the usual causes and how to find the line in your code. All of it from ESP-IDF's panic handler and Espressif's own guides.

Guru Meditation Errors

Other errors and restarts

Flashing and uploading

WiFi disconnects

esp_err_t codes

Decode a crash now

Paste the crash and drop in the ELF: the free ESP32 exception decoder and core dump decoder run in your browser and send nothing anywhere.

When it happens in the field

On your desk the crash prints to the serial monitor. On a device in someone else's building it prints to a port nobody is reading, the chip restarts, and all you hear is that it "sometimes hangs". Pinscope keeps the panic reason and backtrace across the restart, sends them on the next connection and decodes them with the ELF of the build that crashed, so you get the function and line without anyone at the device. Free for three devices. How crash reporting from the field works.

More