Add 2in9 example

examples/embedded_linux_epd2in9/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "embedded_linux_eink_example"
+version = "0.1.0"
+authors = ["Christoph Groß <christoph-gross@mailbox.org>"]
+
+[dependencies]
+
+eink_waveshare_rs = { path = "../../", default-features = false, features = ["epd2in9", "graphics"]}
+
+linux-embedded-hal = "0.2.0"
+
+embedded-graphics = "0.4.3"
+
+embedded-hal = { version = "0.2.1", features = ["unproven"] }

examples/embedded_linux_epd2in9/src/main.rs

@@ -0,0 +1,198 @@
+// the library for the embedded linux device
+extern crate linux_embedded_hal as lin_hal;
+
+// the eink library
+extern crate eink_waveshare_rs;
+
+
+use eink_waveshare_rs::{
+    epd2in9::{
+        EPD2in9, 
+        Buffer2in9,
+    },
+    graphics::{Display, DisplayRotation},
+    prelude::*,
+};
+
+use lin_hal::spidev::{self, SpidevOptions};
+use lin_hal::{Pin, Spidev};
+use lin_hal::sysfs_gpio::Direction;
+use lin_hal::Delay;
+
+extern crate embedded_graphics;
+use embedded_graphics::coord::Coord;
+use embedded_graphics::fonts::{Font6x8};
+use embedded_graphics::prelude::*;
+//use embedded_graphics::primitives::{Circle, Line};
+use embedded_graphics::Drawing;
+
+extern crate embedded_hal;
+use embedded_hal::prelude::*;
+
+// activate spi, gpio in raspi-config
+// needs to be run with sudo because of some sysfs_gpio permission problems and follow-up timing problems
+// see https://github.com/rust-embedded/rust-sysfs-gpio/issues/5 and follow-up issues
+
+
+// DigitalIn Hack as long as it's not in the linux_embedded_hal
+// from https://github.com/rudihorn/max31865/blob/extra_examples/examples/rpi.rs
+// (slightly changed now as OutputPin doesn't provide is_high and is_low anymore)
+use embedded_hal::digital::{InputPin};
+
+//TODO: Remove when linux_embedded_hal implements InputPin 
+struct HackInputPin<'a> {
+    pin: &'a Pin
+}
+
+//TODO: Remove when linux_embedded_hal implements InputPin 
+impl<'a> HackInputPin<'a> {
+    fn new(p : &'a Pin) -> HackInputPin {
+        HackInputPin {
+            pin: p
+        }
+    }
+}
+
+//TODO: Remove when linux_embedded_hal implements InputPin 
+// for now it defaults to is_low if an error appears
+// could be handled better!
+impl<'a> InputPin for HackInputPin<'a> {
+    fn is_low(&self) -> bool {
+        self.pin.get_value().unwrap_or(0) == 0
+    }
+
+    fn is_high(&self) -> bool {
+        !self.is_low()
+    }
+}
+
+//TODO: Test this implemenation
+//BE CAREFUL: this wasn't tested yet
+fn main() {
+
+    run().unwrap();
+}
+
+fn run() -> Result<(), std::io::Error> {
+    // Configure SPI
+    // SPI settings are from eink-waveshare-rs documenation
+    let mut spi = Spidev::open("/dev/spidev0.0").expect("spidev directory");
+    let options = SpidevOptions::new()
+        .bits_per_word(8)
+        .max_speed_hz(4_000_000)
+        .mode(spidev::SPI_MODE_0)
+        .build();
+    spi.configure(&options).expect("spi configuration");
+
+    // Configure Digital I/O Pin to be used as Chip Select for SPI
+    let cs_pin = Pin::new(26);//BCM7 CE0
+    cs_pin.export().expect("cs_pin export");
+    while !cs_pin.is_exported() {}
+    cs_pin.set_direction(Direction::Out).expect("cs_pin Direction");
+    cs_pin.set_value(1).expect("cs_pin Value set to 1");
+
+    // Configure Busy Input Pin
+    let busy = Pin::new(5);//pin 29
+    busy.export().expect("busy export");
+    while !busy.is_exported() {}
+    busy.set_direction(Direction::In).expect("busy Direction");
+    //busy.set_value(1).expect("busy Value set to 1");
+    let busy_in = HackInputPin::new(&busy);
+
+    // Configure Data/Command OutputPin
+    let dc = Pin::new(6); //pin 31 //bcm6
+    dc.export().expect("dc export");
+    while !dc.is_exported() {}
+    dc.set_direction(Direction::Out).expect("dc Direction");
+    dc.set_value(1).expect("dc Value set to 1");
+
+    // Configure Reset OutputPin
+    let rst = Pin::new(16); //pin 36 //bcm16
+    rst.export().expect("rst export");
+    while !rst.is_exported() {}
+    rst.set_direction(Direction::Out).expect("rst Direction");
+    rst.set_value(1).expect("rst Value set to 1");   
+
+    // Configure Delay
+    let mut delay = Delay {};
+
+
+    // Setup of the needed pins is finished here
+    // Now the "real" usage of the eink-waveshare-rs crate begins
+    let mut epd = EPD2in9::new(&mut spi, cs_pin, busy_in, dc, rst, &mut delay)?;
+
+    // Clear the full screen
+    epd.clear_frame(&mut spi).expect("clear frame 1");
+    epd.display_frame(&mut spi).expect("disp 1");
+
+    println!("Test all the rotations");
+    let mut buffer = Buffer2in9::default();
+    let mut display = Display::new(epd.width(), epd.height(), &mut buffer.buffer);
+    display.set_rotation(DisplayRotation::Rotate0);
+    display.draw(
+            Font6x8::render_str("Rotate 0!")
+                .with_stroke(Some(Color::Black))
+                .with_fill(Some(Color::White))                
+                .translate(Coord::new(5, 50))
+                .into_iter(),
+    );
+
+    display.set_rotation(DisplayRotation::Rotate90);
+    display.draw(
+            Font6x8::render_str("Rotate 90!")
+                .with_stroke(Some(Color::Black))
+                .with_fill(Some(Color::White))
+                .translate(Coord::new(5, 50))
+                .into_iter(),
+    );
+
+    display.set_rotation(DisplayRotation::Rotate180);
+    display.draw(
+            Font6x8::render_str("Rotate 180!")
+                .with_stroke(Some(Color::Black))
+                .with_fill(Some(Color::White))
+                .translate(Coord::new(5, 50))
+                .into_iter(),
+    );
+
+    display.set_rotation(DisplayRotation::Rotate270);
+    display.draw(
+            Font6x8::render_str("Rotate 270!")
+                .with_stroke(Some(Color::Black))
+                .with_fill(Some(Color::White))
+                .translate(Coord::new(5, 50))
+                .into_iter(),
+    );
+
+    // Display updated frame
+    epd.update_frame(&mut spi, &display.buffer()).unwrap();
+    epd.display_frame(&mut spi).expect("display frame new graphics");
+    delay.delay_ms(5000u16);
+
+    // a quickly moving `Hello World!`
+    display.set_rotation(DisplayRotation::Rotate0);
+    epd.set_lut_quick(&mut spi).expect("SET LUT QUICK error");
+    let limit = 20;
+    for i in 0..limit {
+        println!("Moving Hello World. Loop {} from {}", (i+1), limit);
+
+        display.draw(
+            Font6x8::render_str("  Hello World! ")
+                .with_style(Style {
+                    fill_color: Some(Color::White),
+                    stroke_color: Some(Color::Black),
+                    stroke_width: 0u8, // Has no effect on fonts
+                })
+                .translate(Coord::new(5 + i*6, 50))
+                .into_iter(),
+        );        
+
+        epd.update_frame(&mut spi, &display.buffer()).unwrap();
+        epd.display_frame(&mut spi).expect("display frame new graphics");
+    }
+
+    // Set the EPD to sleep
+    epd.sleep(&mut spi).expect("sleep");
+
+    Ok(())
+}