https://github.com/me-no-dev/EspExceptionDecoder

Exception Stack Trace Decoder for ESP8266 and ESP32
https://github.com/me-no-dev/EspExceptionDecoder

Last synced: 8 days ago
JSON representation

Exception Stack Trace Decoder for ESP8266 and ESP32

• Host: GitHub
• URL: https://github.com/me-no-dev/EspExceptionDecoder
• Owner: me-no-dev
• License: gpl-2.0
• Created: 2016-01-28T10:20:53.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2023-04-08T01:21:51.000Z (over 1 year ago)
• Last Synced: 2024-10-29T20:50:20.222Z (15 days ago)
• Language: Java
• Homepage:
• Size: 1.17 MB
• Stars: 1,042
• Watchers: 40
• Forks: 138
• Open Issues: 57
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Arduino ESP8266/ESP32 Exception Stack Trace Decoder [![Build Status](https://travis-ci.org/me-no-dev/EspExceptionDecoder.svg?branch=master)](https://travis-ci.org/me-no-dev/EspExceptionDecoder)

Arduino plugin which lets you get a more meaningful explanation of the stack traces you get on ESP8266/ESP32.

## Installation

- Make sure you use one of the supported versions of Arduino IDE and have ESP8266/ESP32 core installed.

- Download the tool archive from [releases page](https://github.com/me-no-dev/EspExceptionDecoder/releases/latest).

- In your Arduino sketchbook directory, create tools directory if it doesn't exist yet.

- Unpack the tool into tools directory (the path will look like `/Arduino/tools/EspExceptionDecoder/tool/EspExceptionDecoder.jar)`.

- On newer versions of linux (Ubuntu 20.04), you may need to install the libncurses5 and libpython2.7 packages: `sudo apt install libncurses5 libpython2.7`

- Restart Arduino IDE.

## Usage

- Open a sketch and build it.

- Upload the sketch and monitor the Serial port for Exceptions

- When you get an Exception, open *Tools > ESP Exception Decoder* menu item. This will open a new window.

- Paste the stack trace into the window's top pane and the result will show in the bottom.

- Every time you enter new address or stack trace, the results will refresh

![EspExceptionDecoder.png](EspExceptionDecoder.png)

### Exception decoded on ESP32

![esp32-exception.png](esp32-exception.png)

## Gedit Highlighting

You can use the *StackTrace* utility to have gedit highlight the above stack trace for easy viewing. More details can be found here: https://github.com/electronicsguy/ESP8266/tree/master/Misc/StackTrace

## Credits and license

- Copyright (c) 2015 Hristo Gochkov (ficeto at ficeto dot com)

- Licensed under GPL v2 ([text](LICENSE))

## Command line version

If you are searching for a command line version, look at [EspStackTraceDecoder] (https://github.com/littleyoda/EspStackTraceDecoder). EspStackTraceDecoder is based on the EspExceptionDecoder, but was completely rewritten for the command line usage.