Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/saibatizoku/sensehat-stick-rs

A Rust library for the Raspberry Pi Sense HAT Joystick.
https://github.com/saibatizoku/sensehat-stick-rs

evdev input-device-controller joystick rust rust-lang rust-library sense-hat sensehat

Last synced: about 2 months ago
JSON representation

A Rust library for the Raspberry Pi Sense HAT Joystick.

Awesome Lists containing this project

README

        

A Rust library for the Raspberry Pi Sense HAT Joystick.
=======================================================

[![crates.io](https://img.shields.io/crates/v/sensehat-stick.svg)](https://crates.io/crates/sensehat-stick)
[![docs](https://docs.rs/sensehat-stick/badge.svg)](https://docs.rs/sensehat-stick)

The joystick integrated on the [Raspberry Pi Sense HAT](https://www.raspberrypi.org/products/sense-hat/), is well integrated to Linux systems. The Sense HAT hardware provides a driver for `evdev`, or `event device` interface in the Linux kernel.

As such, the `evdev` file-descriptor for the joystick, can be read for events issued by someone pushing the joystick.

This library provides a thread-safe, strong-typed, high-level API for the joystick, treating it as you would any other input device using `evdev`.

# Usage

To use this crate with the default features, add this to your `Cargo.toml`:
```cargo
[dependencies]
sensehat-stick = "0.1"
```

or, to manually specify the features::

```cargo
[dependencies]
sensehat-stick = { version = "0.1", default-features = false, features = ["poll"] }
```

# Features

`default`
---------
By default, the `linux-evdev`, and `poll` features are included.

`linux-evdev`
-------------
In `default`. Makes use of the `evdev` interface.

`poll`
------
In `default`. Provides efficient-polling capabilities by implementing `mio::Evented` for `JoyStick`.

# Example
```rust
//! Prints out the events received from the joystick, in a
//! blocking fashion.
extern crate sensehat_stick;

use sensehat_stick::JoyStick;

fn main() {
let mut stick = JoyStick::open().unwrap();
loop {
// This call will block the current thread until
// an event is triggered on the joystick.
for ev in &stick.events().unwrap() {
println!("{:?}", ev);
}
}
}
```

For more, read the indiviual [examples](./examples/).