https://github.com/usbalbin/probe-plotter
Plot variables in embedded targets as graphs with very low overhead using debug probe
https://github.com/usbalbin/probe-plotter
debugging embedded-rust
Last synced: 5 months ago
JSON representation
Plot variables in embedded targets as graphs with very low overhead using debug probe
- Host: GitHub
- URL: https://github.com/usbalbin/probe-plotter
- Owner: usbalbin
- License: apache-2.0
- Created: 2025-07-23T00:33:11.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-12-31T01:39:24.000Z (6 months ago)
- Last Synced: 2026-01-02T11:56:32.550Z (6 months ago)
- Topics: debugging, embedded-rust
- Language: Rust
- Homepage:
- Size: 1.54 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# probe-plotter
A set of tools to plot values from the target to graph in rerun with minimal performance impact. This project is based on code from `defmt` and `cortex_m`'s `singleton` macro. It also uses rerun for visualization.
* probe-plotter - The target side library
* probe-plotter-tools - The host side application
```rust
#![no_std]
#![no_main]
use cortex_m_rt::entry;
use panic_halt as _;
#[entry]
fn main() -> ! {
use probe_plotter::make_metric;
let mut sawtooth = make_metric!(SAWTOOTH: i32 = 42, "(x / 10) % 100").unwrap();
let mut sine = make_metric!(SINE: i32 = 42, "100 * sin(2 * pi * x / 4000)").unwrap();
loop {
for i in 0..i32::MAX {
sawtooth.set(i);
sine.set(i);
cortex_m::asm::delay(100_000);
}
}
}
```
The formulas seen in the `make_metric` macro invocation are computed by the host and will thus have zero impact on the targets performance. The `set` method on the metrics object is simply a volatile store which is quite cheap. The host will then read that value using the debug probe at regular intervals and update the graph on any changes.
##### Prerequisits
probe-plotter uses the Rerun viewer for visualizing the graphs. Please [make sure to have that installed](https://rerun.io/docs/getting-started/installing-viewer#installing-the-viewer). Also make sure to have libudev installed.
##### To run the tool
```
cd probe-plotter-host
cargo run /path/to/elf chip_name
```
So for example plotting the example in examples/simple on a Nucleo-G474RE
```
cd examples/simple
cargo run # Let it flash and then cancel (Ctrl+C) to let the target continue running in the background while giving up access to the probe
cd ../probe-plotter-tools
cargo run ../examples/simple/target/thumbv7em-none-eabihf/debug/simple stm32g474retx
# Rerun will open with a graph showing all created metrics objects
```
