pub struct Button { /* private fields */ }
Available on crate feature ev3 only.
Expand description

Ev3 brick button handler. Opens the corresponding /dev/input file handlers.

This implementation depends on the availability of the EVIOCGKEY ioctl to be able to read the button state buffer. See Linux kernel source in /include/uapi/linux/input.h for details.

use ev3dev_lang_rust::Button;
use std::thread;
use std::time::Duration;

let button = Button::new()?;

loop {
    button.process();

    println!("Is 'up' pressed: {}", button.is_up());
    println!("Pressed buttons: {:?}", button.get_pressed_buttons());

    thread::sleep(Duration::from_millis(100));
}

Implementations§

source§

impl Button

source

pub fn new() -> Ev3Result<Self>

Ev3 brick button handler. Opens the corresponding /dev/input file handlers.

Examples found in repository?
examples/buttons.rs (line 6)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn process(&self)

Check for currently pressed buttons. If the new state differs from the old state, call the appropriate button event handlers.

Examples found in repository?
examples/buttons.rs (line 9)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn get_pressed_buttons(&self) -> HashSet<String>

Get all pressed buttons by name.

Examples found in repository?
examples/buttons.rs (line 20)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_up(&self) -> bool

Check if ‘up’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 13)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_down(&self) -> bool

Check if ‘down’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 14)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_left(&self) -> bool

Check if ‘left’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 15)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_right(&self) -> bool

Check if ‘right’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 16)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_enter(&self) -> bool

Check if ‘enter’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 17)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}
source

pub fn is_backspace(&self) -> bool

Check if ‘backspace’ button is pressed.

Examples found in repository?
examples/buttons.rs (line 18)
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
fn main() -> Ev3Result<()> {
    let button = Button::new()?;

    loop {
        button.process();

        println!(
            "{}, {}, {}, {}, {}, {}",
            button.is_up(),
            button.is_down(),
            button.is_left(),
            button.is_right(),
            button.is_enter(),
            button.is_backspace(),
        );
        println!("{:?}", button.get_pressed_buttons());

        std::thread::sleep(std::time::Duration::from_secs(1));
    }
}

Trait Implementations§

source§

impl Clone for Button

source§

fn clone(&self) -> Button

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Button

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !RefUnwindSafe for Button

§

impl !Send for Button

§

impl !Sync for Button

§

impl Unpin for Button

§

impl !UnwindSafe for Button

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.