11 breaking releases

0.12.0 Jun 4, 2024
0.11.1 Mar 11, 2024
0.11.0 Feb 7, 2024
0.9.0 Oct 26, 2023
0.3.0 Oct 6, 2022

#75 in Embedded development

Download history 3422/week @ 2024-02-26 3303/week @ 2024-03-04 5735/week @ 2024-03-11 5530/week @ 2024-03-18 4892/week @ 2024-03-25 5446/week @ 2024-04-01 4719/week @ 2024-04-08 5778/week @ 2024-04-15 5257/week @ 2024-04-22 4982/week @ 2024-04-29 3961/week @ 2024-05-06 3454/week @ 2024-05-13 3910/week @ 2024-05-20 3373/week @ 2024-05-27 3071/week @ 2024-06-03 3293/week @ 2024-06-10

14,046 downloads per month
Used in 17 crates

MIT/Apache

32KB
688 lines

esp-backtrace - backtrace for ESP32 bare-metal

Crates.io docs.rs MSRV Crates.io Matrix

Supports the ESP32, ESP32-C2/C3/C6, ESP32-H2, ESP32-P4, and ESP32-S2/S3. Optional exception and panic handlers are included, both of which can be enabled via their respective features.

Please note that when targeting a RISC-V device, you need to force frame pointers (i.e. "-C", "force-frame-pointers", in your .cargo/config.toml); this is not required for Xtensa.

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 _;.

Features

Feature Description
esp32 Target ESP32
esp32c2 Target ESP32-C2
esp32c3 Target ESP32-C3
esp32c6 Target ESP32-C6
esp32h2 Target ESP32-H2
esp32p4 Target ESP32-P4
esp32s2 Target ESP32-S2
esp32s3 Target ESP32-S3
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
println Use esp-println to print messages
defmt Use defmt logging to print messages* (check example)
colors Print messages in red*
halt-cores Halt both CPUs on ESP32 / ESP32-S3 instead of doing a loop {} in case of a panic or exception
semihosting Call semihosting::process::abort() on panic.
custom-halt Invoke the extern function custom_halt() instead of doing a loop {} in case of a panic or exception

* only used for panic and exception handlers

defmt Feature

Please note that defmt does not provide MSRV guarantees with releases, and as such we are not able to make any MSRV guarantees when this feature is enabled. For more information refer to the MSRV section of defmt's README: https://github.com/knurling-rs/defmt?tab=readme-ov-file#msrv

License

Licensed under either of:

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.

Dependencies

~0.3–1.6MB
~24K SLoC