blinkstick-rs

blinkstick-rs provides an interface to control any BlinkStick device using Rust.

Examples

:exclamation: For the non-published updates, please refer to function documentation for the latest examples.

Sets the color of a single led to red ```rust use blinkstick_rs::{BlinkStick, Color};

let blinkstick = BlinkStick::new();

blinkstick.setledcolor(0, Color {r: 50, g: 0, b: 0}); ```

Sets a random color to every led on the BlinkStick device ```rust use blinkstick_rs::{BlinkStick, Color};

let blinkstick = BlinkStick::new();

let mut colors: Vec = blinkstick.getcolorvec(); for led in 0..blinkstick.maxleds as usize { colors[led] = BlinkStick::getrandomcolor(); } blinkstick.setallledscolors(&colors); ```

Makes the 1st, 3rd, 5th led blink 2 times, once every 200 miliseconds, with a yellow glow ```rust use blinkstick_rs::{BlinkStick, Color};

let blinkstick = BlinkStick::new();

blinkstick.blinkmultipleledscolor(&vec![1, 3, 5], std::time::Duration::frommillis(200), 2, Color {r: 50, g: 50, b: 0}); ```

Makes every led pulse between beeing turned off and a green color ```rust use blinkstick_rs::{BlinkStick, Color};

let blinkstick = BlinkStick::new();

let color = Color {r: 0, g: 25, b: 0}; blinkstick.pulseallledscolor(std::time::Duration::fromsecs(2), 50, Color {r: 0, g: 25, b: 0}); ```

Makes the first led transform from a red color into a green color over a period of five seconds, with 50 color updates. ```rust use blinkstick_rs::{BlinkStick, Color};

let blinkstick = BlinkStick::new();

blinkstick.setledcolor(1, Color {r: 50, g: 0, b: 0}); blinkstick.transformledcolor(1, std::time::Duration::from_secs(5), 50, Color {r: 0, g: 50, b: 0}); ```

Running tests

Tests are only runnable when a BlinkStick device is plugged in. Furthermore, tests should be run using cargo test -- --test-threads=1 or cargo test -- --test-threads=1 or they might fail.