ws281x 0.1.0

Bindings and wrapper for rpi-ws281x.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
//                    Version 2, December 2004
//
// Copyleft (ↄ) meh. <meh@schizofreni.co> | http://meh.schizofreni.co
//
// Everyone is permitted to copy and distribute verbatim or modified
// copies of this license document, and changing it is allowed as long
// as the name is changed.
//
//            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
//   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
//
//  0. You just DO WHAT THE FUCK YOU WANT TO.

use std::{mem, ptr};
use libc::{c_int, uint32_t};
use {ffi, Handle, Channel};

pub struct Builder(ffi::ws2811_t);

impl Builder {
	#[doc(hidden)]
	pub fn new() -> Self {
		unsafe {
			let mut handle: ffi::ws2811_t = mem::zeroed();
			handle.freq = ffi::WS2811_TARGET_FREQ;

			Builder(handle)
		}
	}

	/// Set the frequency, if unset it picks a proper default.
	pub fn frequency(&mut self, value: u32) -> &mut Self {
		self.0.freq = value as uint32_t;
		self
	}

	/// Set the DMA number.
	pub fn dma(&mut self, value: i32) -> &mut Self {
		self.0.dmanum = value as c_int;
		self
	}

	/// Define a new channel.
	pub fn channel(&mut self, index: usize, value: Channel) -> &mut Self {
		unsafe {
			self.0.channel[index] = value.into_inner();
		}

		self
	}

	/// Build the `Handle`.
	pub fn build(&mut self) -> Result<Handle, ()> {
		unsafe {
			Handle::new(ptr::read(&self.0))
		}
	}
}