#devices #evdev #libevdev #bindings #wrapper #interface #ioctl

evdev-rs

Bindings to libevdev for interacting with evdev devices. It moves the common tasks when dealing with evdev devices into a library and provides a library interface to the callers, thus avoiding erroneous ioctls, etc.

9 releases (breaking)

0.6.1 Oct 22, 2022
0.6.0 Jul 24, 2022
0.5.0 Apr 5, 2021
0.4.0 Apr 26, 2020
0.0.1 Sep 2, 2017

#115 in Hardware support

Download history 665/week @ 2023-11-20 716/week @ 2023-11-27 674/week @ 2023-12-04 670/week @ 2023-12-11 480/week @ 2023-12-18 318/week @ 2023-12-25 364/week @ 2024-01-01 462/week @ 2024-01-08 753/week @ 2024-01-15 593/week @ 2024-01-22 660/week @ 2024-01-29 807/week @ 2024-02-05 723/week @ 2024-02-12 733/week @ 2024-02-19 897/week @ 2024-02-26 760/week @ 2024-03-04

3,171 downloads per month
Used in 12 crates

MIT/Apache

495KB
13K SLoC

C 8K SLoC // 0.0% comments Rust 4K SLoC // 0.0% comments Python 486 SLoC // 0.0% comments Automake 195 SLoC M4 191 SLoC // 0.2% comments Shell 110 SLoC // 0.2% comments JavaScript 64 SLoC // 0.3% comments

evdev-rs

Build Status Latest Version Documentation

Documentation

A Rust wrapper for libevdev

# Cargo.toml
[dependencies]
evdev-rs = "0.6.1"

to enable serialization support, enable the feature "serde"

# Cargo.toml
[dependencies]
evdev-rs = { version = "0.6.1", features = ["serde"] }

With a newer libevdev version (>= 1.10) enable the feature `libevdev-1-10` to
allow disabling a property. It also extends the `Enable` trait to `InputProp`,
enabling the use of `enable()`, `disable()` and `has()` for `InputProp` as well.

Why a libevdev wrapper?

The evdev protocol is simple, but quirky, with a couple of behaviors that are non-obvious. libevdev transparently handles some of those quirks.

The evdev crate is an implementation of libevdev in Rust which provides most of the same features.

evdev-rs crate closely follows libevdev and hence enjoys all the complex handling that libevdev does. Some of the things that libevdev handles transparently, which may or may not be in evdev crate:

  • handling of fake multitouch devices
  • synching of slots and per-slot state
  • transparent generation of missing tracking ids after SYN_DROPPED
  • various boundary checks with defined error codes if you request invalid data (e.g. event codes that don't exist on the device)
  • fd swapping on the same context
  • disabling/enabling events on a per-context basis, so you can disable/enable ABS_FOO and then not care about quirks in the client-side code.

Development

src/enums.rs can be generated by running ./tools/make-enums.sh.

Dependencies

~100–570KB
~12K SLoC