Backtrace decoder
Turns the addresses in an ESP32 crash into function names and source lines, like the exception decoder in the old Arduino IDE or addr2line, without installing anything. Works with Xtensa chips (ESP32, S2, S3) and RISC-V chips (C3, C6, H2). Your files stay in this browser.
1. The firmware's .elf file
Where is the .elf file?
- Arduino IDE 2: Sketch, Export Compiled Binary. The
buildfolder next to your sketch then holdsyoursketch.ino.elf. - PlatformIO:
.pio/build/<env>/firmware.elfin the project. - ESP-IDF:
build/<project>.elf.
2. The crash output
Decoded frames
| # | From | Address | Function | Source |
|---|
Your sketch rows are code you wrote; start reading there.Library and Core rows are code it called. The first row is where the chip was when it crashed. Stack rows on RISC-V are values on the stack that point into code: likely return addresses, but not guaranteed.
Need the meaning of the crash rather than the line? See the error reference. For a live board, the bench explains crashes as they print.