OrangePi.ST7789 1.1.1

Library to control ST7789 TFT LCD displays on the Orange Pi.

Python ST7789 for OrangePi

Python library to control ST7789 TFT LCD displays on the Orange Pi.

Designed to work with the following ST7789 based SPI breakouts and Orange Pi Extension:

• Orange PI Hi-Fi Hat

Installation

First, make sure you have the following dependencies:

sudo apt update
sudo apt install python3-spidev python3-pip python3-pil

Install this library by running:

sudo pip3 install OrangePi.ST7789

You will also need to make sure SPI is enabled in armbian-config (sudo armbian-config) - you can find them under Interface Options.

Examples

You can find some examples of use in the examples folder. Clone this repo with:

git clone https://github.com/sonocotta/st7789-orangepi-python

and navigate into the examples folder with:

cd ~/st7789-orangepi-python/library/examples/

You can pass most of them a parameter (square, rect, round, or dhmini) to specify the size/shape/rotation of screen, like this:

python3 shapes.py dhmini

Licensing & History

This library is a modification of a modification of code originally written by Tony DiCola for Adafruit Industries, and modified to work with the ST7735 by Clement Skau.

To create this ST7789 driver, it has been hard-forked from st7735-python which was originally modified by Pimoroni to include support for their 160x80 SPI LCD breakout.

Modifications include:

• PIL/Pillow has been removed from the underlying display driver to separate concerns- you should create your own PIL image and display it using display(image)
• width, height, rotation, invert, offset_left and offset_top parameters can be passed into __init__ for alternate displays
• Adafruit_GPIO has been replaced with OPi.GPIO and spidev to closely align with our other software (IE: Orange Pi only)

Modified from 'Adafruit Python ILI9341' written by Tony DiCola for Adafruit Industries.

MIT license, all text above must be included in any redistribution