epdlib v0.6

EpdLib provides an interface for creating and displaying scalable layouts that work with most of WaveShare's EPaper displays (EPD). The Layout module can also be used for generating layouts for any screen-buffered display that does not require fast updates.

EpdLib provides classes for interfacing with the screen (Screen), building layouts that will work at any resolution (Layout), and blocks that are used to assemble layouts (Block). EpdLib makes it trivial to build a project that will work on almost any WaveShare display without worrying about the resolution or recoding the display functions.

EpdLib supports almost all of WaveShare's EPD screens. See the Supported Screens below.

• 7-Color screens are supported in full color
• HD Screens are supported in 8 bit gray and support partial refresh (~1 second)
• All 2 and 3 color screens are supported in 1 bit (black and white) only

Changes

See the ChangeLog for details

v0.6

• Add support for 8-Color WaveShare screens to Block, Screen and Layout
• All Blocks and Layouts now support "RGB" content
• Layouts and blocks can now be dynamically updated during runtime
• Layout.layout dictionaries must contain key type that matches the block type
• Layouts support HTML standard color names and map [RED, ORANGE, YELLOW, GREEN, BLUE, BLACK, WHITE] to proper WaveShare Values

Dependencies

Python Modules:

• Pillow: System dependencies for Pillow:
  • libopenjp2-7
  • libtiff5
• RPi.GPIO
• spidev: ensure SPI is enabled on the pi
• waveshare-epd (Non IT8951 based panels): see notes below for installation instructions
  • this is for interacting with waveshare epaper displays and is not strictly needed to use the Block and Layout objects.
• IT8951 (IT8951 based panels): see notes below for installation instructions

Modules:

• Block - image and text blocks that can be used to create a layout
• Layout - create layouts from Blocks that will work on nearly any WaveShare screen automagically
• Screen - simple interface for writing to WaveShare EPD devices

Supported Screens

Add your enthusiasm to standardize the epd1in02 screen to this Pull Request.

The epd3in7 is an oddball that has several issues:

• 'Non-standard, unsupported EPD.Clear() function',
• 'AttributeError: module does not support standard EPD.display() function

Notes

WaveShare non-IT8951 Screens

The waveshare-epd library is required for non-IT8951 screens and can be installed from the Git repo:

pip install -e "git+https://github.com/waveshare/e-Paper.git#egg=waveshare_epd&subdirectory=RaspberryPi_JetsonNano/python"

IT8951 basee Screens

Greg D Meyer's IT8951 library is required and can be installed from the Git repo:

pip install -e "git+https://github.com/GregDMeyer/IT8951#egg=IT8951"

getting ready for pypi: https://medium.com/@joel.barmettler/how-to-upload-your-python-package-to-pypi-65edc5fe9c56