ESP32 Backtrace Decoder

The tool decodes ESP32 backtraces by mapping addresses from a crash dump to function names, source files, and line numbers using a user-supplied symbol map or ELF image. It targets embedded developers, firmware engineers, and hardware teams debugging ESP32-based devices. It accepts raw backtrace strings from Xtensa cores and returns a structured decoded report.
Core logic parses addresses, normalizes formats, and consults a symbol table, ELF symbol table, or prebuilt map to resolve each address to a symbol, offset, and source location. It supports multiple images, architecture variants, and optional demangling. Output includes module name, address, function name, file path, and line number.
Unique value and use cases: Distills multi-line traces into readable frames, supports batch decoding, and bridges offline symbol data with debugging workflows. Typical users include firmware teams performing post-mortem analysis, performance profiling, and crash triage for ESP32 applications in IoT, sensors, and edge devices.
Core features and workflow: input of raw addresses or a full backtrace, optional symbol map or ELF path, configurable base address, and output in a structured, parseable format. The tool emphasizes accuracy, gracefully handles missing symbols, and provides offset notes for mismatches.