#esp32 #esp8266 #cargo #cargo-subcommand #serial #monitoring

app cargo-espmonitor

Cargo subcommand for monitoring ESP8266 and ESP32 execution over serial

17 releases (9 breaking)

0.10.0 Jun 10, 2022
0.8.1 May 29, 2022
0.7.0 Mar 18, 2022
0.6.0 Nov 4, 2021
0.1.0 Mar 19, 2021

#394 in Cargo plugins

GPL-3.0 license

29KB
623 lines

ESPMonitor

ESP32 and ESP8266 serial monitor.

Features

  • Resets chip on startup.
  • Can match hex sequences in output to function names in a binary.
  • Optionally builds and flashes before starting the monitor.
  • cargo integration.

Usage

Install with:

cargo install cargo-espmonitor

Run cargo espmonitor --help for details.

If you prefer the standalone monitor app without cargo integration, you can instead install espmonitor.

Keyboard Commands

While monitoring, ESPMonitor accepts the following keyboard commands:

  • CTRL+R: Reset chip
  • CTRL+C: Quit

Contributing

Hooks

Before you start writing code, run this in the root of the repo:

mkdir -p .git/hooks && (cd .git/hooks && ln -s ../../hooks/* .)

This will set up a pre-commit hook that will run cargo clippy and cargo fmt before each commit, to save you some time getting frustrated with failed PR checks.

Releasing

See RELEASING for instructions.

Dependencies

~12–22MB
~326K SLoC