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.
Go to file
Christoph Groß 9791e1b727 Renaming of a few Traits and changing the ConnectionInterface::new() variables 5 years ago
ci added ci 5 years ago
examples/embedded_linux Stablised traits and interfaces, converted epd4in2 to it, and started real work on epd2in9 5 years ago
src Renaming of a few Traits and changing the ConnectionInterface::new() variables 5 years ago
.gitignore some changes 5 years ago
.travis.yml another try at the travis.yml 5 years ago
Cargo.toml added a comment 5 years ago Create 5 years ago Added a note with the two possible display "configs" to the readme 5 years ago

eink-waveshare-rs Build Status

This library contains a driver for the 4.2 Inch E-Paper Module from Waveshare.

Support for more (especially the smaller and faster ones) should follow after the library around the 4.2" EInk is stable and tested enough.

(Supported) Devices

Device (with Link) Colors Flexible Partial Refresh Supported Tested
4.2 Inch B/W (A) Black, White Not officially [1]
1.54 Inch B/W (A) Black, White
2.13 Inch B/W (A) Black, White
2.9 Inch B/W (A) Black, White

4.2 Inch E-Ink Black/White

Out of the Box the original driver from Waveshare only supports full updates.

  • [1]: Be careful with the quick refresh updates:
    It's possible with this driver but might lead to ghosting / burn-in effects therefore it's hidden behind a feature.


Interface Description
VCC 3.3V
CS SPI chip select (Low active)
DC Data/Command control pin (High for data, and low for command)
RST External reset pin (Low for reset)
BUSY Busy state output pin (Low for busy)

Display Configs

There are two types of Display Configurations used in Wavedshare EPDs, which also needs to be set on the "new" E-Paper Driver HAT. They are also called A and B, but you shouldn't get confused and mix it with the Type A,B,C and D of the various Displays, which just describe different types (colored variants) or new versions. In the Display Config the seperation is most likely due to included fast partial refresh of the displays. In a Tabular form:

Type A Tybe B
1.54in (A) 1.54in (B)
2.13in (A) 1.54in (C)
2.13in (D) 2.13in (B)
2.9in (A) 2.13in (C)
2.7in (A)
2.7in (B)
2.9in (B)
2.9in (C)
4.2in (A)
4.2in (B)
4.2in (C)
7.5in (A)
7.5in (B)
7.5in (C)


  • add more examples (e.g. for f3)
  • improve the partial drawing/check the timings/timing improvements/....
  • for later: add support for the smaller waveshare epds
  • License: Stay with ISC (=MIT) or go to the Apache+MIT Dual License as used in many other projects?



  • Lines
  • Squares
  • Circles
  • Pixels
  • Chars
  • Strings

Chars and Strings work with a 8x8-Font.

Support for bigger sized/independent Fonts is in work.


There is an example for Raspberry Pi in the example folder.