Struct ButtonEsp 

pub struct ButtonEsp<'d> { /* private fields */ }

A device abstraction for a button with debouncing and press duration detection.

Hardware Requirements

The button can be wired in two ways:

• PressedTo::Voltage: Button connects pin to 3.3V when pressed (uses pull-down)
• PressedTo::Ground: Button connects pin to GND when pressed (uses pull-up)

Usage

Use Button::wait_for_press when you only need a debounced press event. It returns on the down edge and does not wait for release.

Use Button::wait_for_press_duration when you need to distinguish short vs. long presses. It returns as soon as it can decide, so long presses are reported before the button is released.

Example

use device_envoy_esp::{
    button::{Button as _, ButtonEsp, PressDuration, PressedTo},
    init_and_start, Result,
};

async fn example() -> Result<Infallible> {
    init_and_start!(p);
    let mut button = ButtonEsp::new(p.GPIO6, PressedTo::Ground);

    // Wait for a press without measuring duration.
    button.wait_for_press().await;

    // Measure press durations in a loop
    loop {
        match button.wait_for_press_duration().await {
            PressDuration::Short => {
                // Handle short press
            }
            PressDuration::Long => {
                // Handle long press (fires before button is released)
            }
        }
    }
}

Implementations

impl<'d> ButtonEsp<'d>

pub fn new(button_pin: impl InputPin + 'd, pressed_to: PressedTo) -> Self

Creates a new ButtonEsp instance from a pin.

The pin is configured based on the connection type:

• PressedTo::Voltage: Uses internal pull-down (button to 3.3V)
• PressedTo::Ground: Uses internal pull-up (button to GND)

Trait Implementations

impl Button for ButtonEsp<'_>

Available on target_os=none only.

fn is_pressed(&self) -> bool

Returns whether the button is currently pressed.

async fn wait_for_press(&mut self)

Waits for the next press (button goes down, debounced). Does not wait for release.

async fn wait_for_press_duration(&mut self) -> PressDuration

Waits for the next press and returns whether it was short or long (debounced).