Skip to main content

displayio driver for ST7789 TFT-LCD displays.

Project description

Introduction

Documentation Status Discord Build Status Code Style: Ruff

displayio driver for ST7789 TFT-LCD displays.

Dependencies

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.

Usage Example

import board
import displayio
# Starting in CircuitPython 9.x fourwire will be a seperate internal library
# rather than a component of the displayio library
try:
    from fourwire import FourWire
except ImportError:
    from displayio import FourWire

from adafruit_st7789 import ST7789

displayio.release_displays()

spi = board.SPI()
while not spi.try_lock():
    pass
spi.configure(baudrate=24000000) # Configure SPI for 24MHz
spi.unlock()
tft_cs = board.D5
tft_dc = board.D6

display_bus = FourWire(spi, command=tft_dc, chip_select=tft_cs, reset=board.D9)

display = ST7789(display_bus, width=240, height=240, rowstart=80, bgr=True, invert=True)

# Make the display context
splash = displayio.Group()
display.root_group = splash

color_bitmap = displayio.Bitmap(240, 240, 1)
color_palette = displayio.Palette(1)
color_palette[0] = 0xFF0000

bg_sprite = displayio.TileGrid(color_bitmap,
                               pixel_shader=color_palette,
                               x=0, y=0)
splash.append(bg_sprite)

while True:
    pass

Documentation

API documentation for this library can be found on Read the Docs.

For information on building library documentation, please check out this guide.

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adafruit_circuitpython_st7789-2.1.2.tar.gz (25.2 kB view details)

Uploaded Source

Built Distribution

adafruit_circuitpython_st7789-2.1.2-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file adafruit_circuitpython_st7789-2.1.2.tar.gz.

File metadata

File hashes

Hashes for adafruit_circuitpython_st7789-2.1.2.tar.gz
Algorithm Hash digest
SHA256 3945e81dd3a0fd1c23bbf282b800883e545f0477ea779e59a6d3d2f0a98b7dfe
MD5 4d3fab0ac08d932c898408594b490a78
BLAKE2b-256 01968d0448af33413106eb2e32c4f56aa5f2ca689641b9f713d88dc7c5464c29

See more details on using hashes here.

File details

Details for the file adafruit_circuitpython_st7789-2.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for adafruit_circuitpython_st7789-2.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a3f29bbd2103202a1ef00db300bc2ef791559c796b1a6c164ff5ea07df1983fb
MD5 ac179d4cbacd2ff3299617ca4b3f97b0
BLAKE2b-256 2d0427674a19a8b04ed151187aca5a5825c4e35f2ef8fdcd7fdac8db27663f11

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page