You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
80 lines
1.9 KiB
Rust
80 lines
1.9 KiB
Rust
//! A simple Driver for the Waveshare E-Ink Displays via SPI
|
|
//!
|
|
//! This driver was built using [`embedded-hal`] traits.
|
|
//!
|
|
//! [`embedded-hal`]: https://docs.rs/embedded-hal/~0.1
|
|
//!
|
|
//! # Requirements
|
|
//!
|
|
//! ### SPI
|
|
//!
|
|
//! - MISO is not connected/available
|
|
//! - SPI_MODE_0 is used (CPHL = 0, CPOL = 0)
|
|
//! - 8 bits per word, MSB first
|
|
//! - Max. Speed tested by myself was 8Mhz but more should be possible (Ben Krasnow used 18Mhz with his implemenation)
|
|
//!
|
|
//! ### Other....
|
|
//!
|
|
//! - Buffersize: Wherever a buffer is used it always needs to be of the size: `width / 8 * length`,
|
|
//! where width and length being either the full e-ink size or the partial update window size
|
|
//!
|
|
//! # Examples
|
|
//!
|
|
//! ```ignore
|
|
//! use eink-waveshare-rs::epd4in2::EPD4in2;
|
|
//!
|
|
//! let mut epd4in2 = EPD4in2::new(spi, cs, busy, dc, rst, delay).unwrap();
|
|
//!
|
|
//! let mut buffer = [0u8, epd4in2.get_width() / 8 * epd4in2.get_height()];
|
|
//!
|
|
//! // draw something into the buffer
|
|
//!
|
|
//! epd4in2.display_and_transfer_buffer(buffer, None);
|
|
//!
|
|
//! // wait and look at the image
|
|
//!
|
|
//! epd4in2.clear_frame(None);
|
|
//!
|
|
//! epd4in2.sleep();
|
|
//! ```
|
|
//!
|
|
//!
|
|
#![no_std]
|
|
|
|
#[cfg(feature = "graphics")]
|
|
pub mod graphics;
|
|
|
|
mod traits;
|
|
|
|
pub mod color;
|
|
|
|
/// Interface for the physical connection between display and the controlling device
|
|
mod interface;
|
|
|
|
#[cfg(feature = "epd4in2")]
|
|
pub mod epd4in2;
|
|
|
|
#[cfg(feature = "epd1in54")]
|
|
pub mod epd1in54;
|
|
|
|
#[cfg(feature = "epd2in9")]
|
|
pub mod epd2in9;
|
|
|
|
#[cfg(any(feature = "epd1in54", feature = "epd2in9"))]
|
|
pub(crate) mod type_a;
|
|
|
|
pub mod prelude {
|
|
pub use crate::color::Color;
|
|
pub use crate::traits::{RefreshLUT, WaveshareDisplay};
|
|
pub use crate::SPI_MODE;
|
|
}
|
|
|
|
use embedded_hal::spi::{Mode, Phase, Polarity};
|
|
|
|
/// SPI mode -
|
|
/// For more infos see [Requirements: SPI](index.html#spi)
|
|
pub const SPI_MODE: Mode = Mode {
|
|
phase: Phase::CaptureOnFirstTransition,
|
|
polarity: Polarity::IdleLow,
|
|
};
|