esp-backtrace - backtrace for ESP32 bare-metal
- supports ESP32, ESP32C3, ESP32S2, ESP32S3
- optional features:
panic-handler
,exception-handler
(will enableesp-println
depdendency) - work-in-progress, yet already useable
Please note: On RISCV you need to force frame pointers (i.e. "-C", "force-frame-pointers",
in your .cargo/config.toml
)
You can get an array of backtrace addresses (currently limited to 10) via arch::backtrace()
if you want to create a backtrace yourself (i.e. not using the panic or exception handler).
When using the panic and/or exception handler make sure to include use esp_backtrace as _;
.
When using this together with esp-println
make sure to use the same output kind for both dependencies. (Or don't specify the output for esp-backtrace
)
Features
Feature | Description |
---|---|
esp32 | Target ESP32 |
esp32c3 | Target ESP32C3 |
esp32s2 | Target ESP32S2 |
esp32s3 | Target ESP32S3 |
panic-handler | Include a panic handler, will add esp-println as a dependency |
exception-handler | Include an exception handler, will add esp-println as a dependency |
print-uart | Use UART to print messages (*) |
print-jtag-serial | Use JTAG-Serial to print messages (*) |
print-rtt | Use RTT to print messages (*) |
(*) only used for panic and exception handlers
License
Licensed under either of:
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.