Skip to content

Python library to control an ST7735 TFT LCD display on the Raspberry PI 5. Allows simple drawing on the display without installing a kernel module.

License

Notifications You must be signed in to change notification settings

czenon1/ST7735_pi5

 
 

Repository files navigation

ST7735_pi5

PyPi Package Python Versions

A Python library to control the ST7735 display on a Raspberry Pi 5 using lgpio and spidev. Allows simple drawing on the display without installing a kernel module.

Designed specifically to work with a ST7735 based 128x160 pixel TFT SPI display. (Specifically the 0.96" SPI LCD from Pimoroni).

Building

Instructions from Pypa'sguide

Generating distribution archives

The next step is to generate :term:distribution packages <Distribution Package> for the package. These are archives that are uploaded to the Python Package Index and can be installed by :ref:pip.

Make sure you have the latest version of PyPA's :ref:build installed:

Unix/macOS :

    python3 -m pip install --upgrade build

Windows :

    py -m pip install --upgrade build

*If you have trouble installing these, see the *installing-packagestutorial.

Now run this command from the same directory where :file:pyproject.toml is located:

Unix/macOS :

    python3 -m build

Windows :

    py -m build

This command should output a lot of text and once completed should generate two files in the :file:dist directory:


    dist/
    ├── example_package_YOUR_USERNAME_HERE-0.0.1-py3-none-any.whl
    └── example_package_YOUR_USERNAME_HERE-0.0.1.tar.gz

The tar.gz file is a :term:source distribution <Source Distribution (or "sdist")> whereas the .whl file is a :term:built distribution <Built Distribution>. Newer :ref:pip versions preferentially install built distributions, but will fall back to source distributions if needed. You should always upload a source distribution and provide built distributions for the platforms your project is compatible with. In this case, our example package is compatible with Python on any platform so only one built distribution is needed.

Installing

You can install this library via pip:

pip install -r requirements.txt
pip install ST7735_pi5

Usage

from st7735_pi5 import ST7735
from PIL import Image

# Initialize the display
display = ST7735(port=0, cs=0, dc=24, backlight=18, rst=25)

# Display an image
image = Image.open('path_to_image.jpg')
display.image(image)

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Python library to control an ST7735 TFT LCD display on the Raspberry PI 5. Allows simple drawing on the display without installing a kernel module.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 48.3%
  • Shell 45.4%
  • Makefile 6.3%