Skip to content
Firmware Debugging

ESP32 Diagnostics and Crash Decoder

Understand the root cause of Brownout, Guru Meditation, Watchdog, and Stack Overflow crashes, and apply engineering solutions instead of workarounds.

Paste the log to see the cause

Copy the serial monitor output snippet. Diagnostics appear instantly.

Test with

Fault catalog

Symptom

Area

10 faults

Pre-deployment checklist

Essential items to validate on hardware and firmware before shipping a product.

Hardware and Power Supply

  • 10 µF to 100 µF low-ESR capacitor on VCC, plus a 100 nF ceramic capacitor close to the chip.
  • LDO regulator sized for 600 mA to 1 A current spikes, with adequate thermal margin.
  • No external peripherals forcing logic levels on strapping pins during reset and boot.
  • 10 µF or 1 µF capacitor on the EN (RST) pin for stable auto-reset flashing.

Firmware and FreeRTOS

  • Every FreeRTOS task yields CPU time with vTaskDelay, queues, or semaphores.
  • Every ISR marked with IRAM_ATTR with zero blocking calls.
  • Avoid continuous heap reallocations using Arduino Strings in tight loops.
  • Clock synchronized via SNTP before attempting TLS/HTTPS handshakes.