meshtastic/docs/development/firmware/stacktraces.mdx
rcarteraz 4c0b8a95ad Squashed commit of the following:
commit 86bc3c93e5
Merge: 6cabd5fe cfec3e8e
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Wed Jun 19 18:48:14 2024 -0700

    Merge pull request #1301 from rcarteraz/1200bps-reset-button

    Add mention of 1200bps reset button in web flasher

commit cfec3e8eac
Merge: 59d71321 6cabd5fe
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Wed Jun 19 17:59:09 2024 -0700

    Merge branch 'master' into 1200bps-reset-button

commit 6cabd5fe95
Merge: f6a97b28 6c40c2e5
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Wed Jun 19 17:58:54 2024 -0700

    Merge pull request #1295 from geeksville/pr-nrf52-guide

    Add basic nrf52 guide

commit 6c40c2e555
Merge: 9cbea09e f6a97b28
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Wed Jun 19 17:56:57 2024 -0700

    Merge branch 'master' into pr-nrf52-guide

commit 59d71321e3
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Wed Jun 19 17:52:06 2024 -0700

    Add mention of 1200bps reset button in web flasher

commit 9cbea09e5c
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Tue Jun 18 13:53:25 2024 -0700

    formatting and minor changes

commit fad3a940d1
Merge: f3523b72 f95a398c
Author: rcarteraz <robert.l.carter2@gmail.com>
Date:   Tue Jun 18 13:01:01 2024 -0700

    Merge branch 'master' into pr-nrf52-guide

commit f3523b72f5
Merge: b2fcaa55 70638582
Author: geeksville <kevinh@geeksville.com>
Date:   Sun Jun 16 21:11:52 2024 -0700

    Merge branch 'master' into pr-nrf52-guide

commit b2fcaa5530
Author: geeksville <kevinh@geeksville.com>
Date:   Sun Jun 16 15:16:37 2024 -0700

    Add basic nrf52 guide
2024-06-19 18:50:33 -07:00

36 lines
892 B
Plaintext

---
id: stacktraces
title: Stacktraces
sidebar_label: Stacktraces
sidebar_position: 5
---
## 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:
```text title="backtrace.txt"
Backtrace: 0x....
```
2. Run the exception decoder:
```shell
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:
```shell
pio device monitor --port DEVICE_PORT -f esp32_exception_decoder
```