39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
`evdev`
|
|
=======
|
|
|
|
[](https://travis-ci.org/cmr/evdev)
|
|
[](https://crates.io/crates/evdev)
|
|
|
|
[Documentation](https://docs.rs/evdev)
|
|
|
|
Nice(r) access to `evdev` devices.
|
|
|
|
What is `evdev`?
|
|
===================
|
|
|
|
`evdev` is the Linux kernel's generic input interface, also implemented by other
|
|
kernels such as FreeBSD.
|
|
|
|
This crate exposes access to these sorts of input devices. There is some trickery
|
|
involved, so please read the crate documentation.
|
|
|
|
What does this library support?
|
|
===============================
|
|
|
|
This library exposes raw evdev events, but uses the Rust `Iterator` trait to
|
|
do so, and will handle `SYN_DROPPED` events properly for the client. I try to
|
|
match [libevdev](https://www.freedesktop.org/software/libevdev/doc/latest/)
|
|
closely, where possible.
|
|
|
|
Writing to devices is not yet supported (eg, turning LEDs on).
|
|
|
|
There is no abstraction for gamepad-like devices that allows mapping button
|
|
numbers to logical buttons, nor is one planned. Such a thing should take place
|
|
in a higher-level crate, likely supporting multiple platforms.
|
|
|
|
Example
|
|
=======
|
|
|
|
See <examples/evtest.rs> for an example of using this library (which roughly
|
|
corresponds to the userspace [evtest](https://cgit.freedesktop.org/evtest/)
|
|
tool.
|