Skip to main content

Stacktraces

Decoding Stacktraces​

You may encounter a situation where your device crashes and are left with a stacktrace, below are two methods of decoding them.

Manually​

info

This method uses the symbols of the firmware.elf file generated from your latest build, you may wish to rebuild to get up-to-date symbols.

  1. Save the backtrace string to a text file:

    backtrace.txt
    Backtrace: 0x....
  2. Run the exception decoder:

    bin/exception_decoder.py backtrace.txt

In Real-Time​

In order to decode stack traces in real time, keep the following command (replacing DEVICE_PORT with your device's port) running in your terminal with the target device connected:

pio device monitor --port DEVICE_PORT -f esp32_exception_decoder