This library is for using CircuitPython with e-ink displays with built in SRAM.
This driver depends on:
Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.
import digitalio import busio import board from adafruit_epd.epd import Adafruit_EPD from adafruit_epd.il0373 import Adafruit_IL0373 # create the spi device and pins we will need spi = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO) ecs = digitalio.DigitalInOut(board.D10) dc = digitalio.DigitalInOut(board.D9) srcs = digitalio.DigitalInOut(board.D8) rst = digitalio.DigitalInOut(board.D7) busy = digitalio.DigitalInOut(board.D6) # give them all to our driver display = Adafruit_IL0373(152, 152, rst, dc, busy, srcs, ecs, spi) # clear the buffer display.clear_buffer() r_width = 5 r_pos = display.height #draw some rectangles! color = Adafruit_EPD.BLACK while r_pos > display.height/2: if r_pos < display.height - 50: color = Adafruit_EPD.RED display.rect(display.width - r_pos, display.height - r_pos, display.width - 2*(display.width - r_pos), display.height - 2*(display.height - r_pos), color) r_pos = r_pos - r_width display.display()Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.
To build this library locally you'll need to install the circuitpython-build-tools package.
python3 -m venv .env source .env/bin/activate pip install circuitpython-build-toolsOnce installed, make sure you are in the virtual environment:
source .env/bin/activateThen run the build:
circuitpython-build-bundles --filename_prefix adafruit-circuitpython-epd --library_location .Sphinx is used to build the documentation based on rST files and comments in the code. First, install dependencies (feel free to reuse the virtual environment from above):
python3 -m venv .env source .env/bin/activate pip install Sphinx sphinx-rtd-themeNow, once you have the virtual environment activated:
cd docs sphinx-build -E -W -b html . _build/htmlThis will output the documentation to docs/_build/html. Open the index.html in your browser to view them. It will also (due to -W) error out on any warning like Travis will. This is a good way to locally verify it will pass.