# EspExceptionDecoder

**Repository Path**: summer_xu/EspExceptionDecoder

## Basic Information

- **Project Name**: EspExceptionDecoder
- **Description**: Exception Stack Trace Decoder for ESP8266
- **Primary Language**: Java
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-07
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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.


## Installation
- Make sure you use one of the supported versions of Arduino IDE and have ESP8266 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 `<home_dir>/Arduino/tools/EspExceptionDecoder/tool/EspExceptionDecoder.jar)`.
- 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)

## 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.