st7789


Namest7789 JSON
Version 1.0.1 PyPI version JSON
download
home_pageNone
SummaryDriver for ST7789-based TFT LCD displays.
upload_time2024-06-17 12:50:46
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseThe MIT License (MIT) Copyright (c) 2014 Adafruit Industries Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords pi raspberry
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # Python ST7789

[![Build Status](https://img.shields.io/github/actions/workflow/status/pimoroni/st7789-python/test.yml?branch=main)](https://github.com/pimoroni/st7789-python/actions/workflows/test.yml)
[![Coverage Status](https://coveralls.io/repos/github/pimoroni/st7789-python/badge.svg?branch=main)](https://coveralls.io/github/pimoroni/st7789-python?branch=main)
[![PyPi Package](https://img.shields.io/pypi/v/st7789.svg)](https://pypi.python.org/pypi/st7789)
[![Python Versions](https://img.shields.io/pypi/pyversions/st7789.svg)](https://pypi.python.org/pypi/st7789)

Python library to control an ST7789 TFT LCD display

Designed specifically to work with a ST7789 based 240x240 pixel TFT SPI display. (Specifically the [1.3" SPI LCD from Pimoroni](https://shop.pimoroni.com/products/1-3-spi-colour-lcd-240x240-breakout)).

![Animated GIF showing the ST7789 SPI LCD displaying Deploy/Rainbows in alternating frames](https://raw.githubusercontent.com/pimoroni/st7789-python/master/square-lcd-breakout-1.gif)

# Installation

Make sure you have the following dependencies:

````
sudo apt-get update
sudo apt-get install python-rpi.gpio python-spidev python-pip python-pil python-numpy
````

Install this library by running:

````
sudo pip install st7789
````

You might also need to enable I2C and SPI in raspi-config. See example of usage in the examples folder.


# 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 `RPi.GPIO` and `spidev` to closely align with our other software (IE: Raspberry Pi only)
* Test fixtures have been added to keep this library stable

Pimoroni invests time and resources forking and modifying this open source code, please support Pimoroni and open-source software by purchasing products from us, too!

Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!

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

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

1.0.1
-----

* Add spidev and numpy dependencies.

1.0.0
-----

* Repackage to hatch/pyproject.toml
* Port to gpiod/gpiodevice

0.0.4
-----

* Add support for 320x240 2.0" LCD (Display HAT Mini)
* Add support for 240x135 1.14" LCD (@slabua)
* Rework numpy RGB888 to RGB565
* Support displaying numpy arrays (@zecktos)

0.0.3
-----

* Add support for RLCD
* Brought back `offset_left` and `offset_top` parameters

0.0.2
-----

* Fix for image retention
* Drop defunct parameters

0.0.1
-----

* Initial Release

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "st7789",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "Philip Howard <phil@pimoroni.com>",
    "keywords": "Pi, Raspberry",
    "author": null,
    "author_email": "Philip Howard <phil@pimoroni.com>",
    "download_url": "https://files.pythonhosted.org/packages/71/20/ed062044f737a8fe2aaef7815584a690c24d6af9a1385c0c9cd1298f5cf9/st7789-1.0.1.tar.gz",
    "platform": null,
    "description": "# Python ST7789\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/pimoroni/st7789-python/test.yml?branch=main)](https://github.com/pimoroni/st7789-python/actions/workflows/test.yml)\n[![Coverage Status](https://coveralls.io/repos/github/pimoroni/st7789-python/badge.svg?branch=main)](https://coveralls.io/github/pimoroni/st7789-python?branch=main)\n[![PyPi Package](https://img.shields.io/pypi/v/st7789.svg)](https://pypi.python.org/pypi/st7789)\n[![Python Versions](https://img.shields.io/pypi/pyversions/st7789.svg)](https://pypi.python.org/pypi/st7789)\n\nPython library to control an ST7789 TFT LCD display\n\nDesigned specifically to work with a ST7789 based 240x240 pixel TFT SPI display. (Specifically the [1.3\" SPI LCD from Pimoroni](https://shop.pimoroni.com/products/1-3-spi-colour-lcd-240x240-breakout)).\n\n![Animated GIF showing the ST7789 SPI LCD displaying Deploy/Rainbows in alternating frames](https://raw.githubusercontent.com/pimoroni/st7789-python/master/square-lcd-breakout-1.gif)\n\n# Installation\n\nMake sure you have the following dependencies:\n\n````\nsudo apt-get update\nsudo apt-get install python-rpi.gpio python-spidev python-pip python-pil python-numpy\n````\n\nInstall this library by running:\n\n````\nsudo pip install st7789\n````\n\nYou might also need to enable I2C and SPI in raspi-config. See example of usage in the examples folder.\n\n\n# Licensing & History\n\nThis 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.\n\nTo 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.\n\n## Modifications include:\n\n* 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)`\n* `width`, `height`, `rotation`, `invert`, `offset_left` and `offset_top` parameters can be passed into `__init__` for alternate displays\n* `Adafruit_GPIO` has been replaced with `RPi.GPIO` and `spidev` to closely align with our other software (IE: Raspberry Pi only)\n* Test fixtures have been added to keep this library stable\n\nPimoroni invests time and resources forking and modifying this open source code, please support Pimoroni and open-source software by purchasing products from us, too!\n\nAdafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!\n\nModified from 'Modified from 'Adafruit Python ILI9341' written by Tony DiCola for Adafruit Industries.' written by Clement Skau.\n\nMIT license, all text above must be included in any redistribution\n\n1.0.1\n-----\n\n* Add spidev and numpy dependencies.\n\n1.0.0\n-----\n\n* Repackage to hatch/pyproject.toml\n* Port to gpiod/gpiodevice\n\n0.0.4\n-----\n\n* Add support for 320x240 2.0\" LCD (Display HAT Mini)\n* Add support for 240x135 1.14\" LCD (@slabua)\n* Rework numpy RGB888 to RGB565\n* Support displaying numpy arrays (@zecktos)\n\n0.0.3\n-----\n\n* Add support for RLCD\n* Brought back `offset_left` and `offset_top` parameters\n\n0.0.2\n-----\n\n* Fix for image retention\n* Drop defunct parameters\n\n0.0.1\n-----\n\n* Initial Release\n",
    "bugtrack_url": null,
    "license": "The MIT License (MIT)  Copyright (c) 2014 Adafruit Industries  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
    "summary": "Driver for ST7789-based TFT LCD displays.",
    "version": "1.0.1",
    "project_urls": {
        "GitHub": "https://www.github.com/pimoroni/st7789-python",
        "Homepage": "https://www.pimoroni.com"
    },
    "split_keywords": [
        "pi",
        " raspberry"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e3dd4fe563f2a757425a3460eee92f9a19ba893ed90f9d85f1be3d7dc91df305",
                "md5": "71458376f01546165ec5f5c3330ea08e",
                "sha256": "816ee227984b2f5b4647f7c4ab241c57b495d1502e27a8127f27388d5e8f861f"
            },
            "downloads": -1,
            "filename": "st7789-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "71458376f01546165ec5f5c3330ea08e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 10593,
            "upload_time": "2024-06-17T12:50:44",
            "upload_time_iso_8601": "2024-06-17T12:50:44.696337Z",
            "url": "https://files.pythonhosted.org/packages/e3/dd/4fe563f2a757425a3460eee92f9a19ba893ed90f9d85f1be3d7dc91df305/st7789-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7120ed062044f737a8fe2aaef7815584a690c24d6af9a1385c0c9cd1298f5cf9",
                "md5": "0a6a6a5e22a393d26c3f72c0c35d0642",
                "sha256": "f204983d19d35e26650455ac7e29bd7b26d422d470f093994403f6df8ecddc1b"
            },
            "downloads": -1,
            "filename": "st7789-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0a6a6a5e22a393d26c3f72c0c35d0642",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 1141161,
            "upload_time": "2024-06-17T12:50:46",
            "upload_time_iso_8601": "2024-06-17T12:50:46.805731Z",
            "url": "https://files.pythonhosted.org/packages/71/20/ed062044f737a8fe2aaef7815584a690c24d6af9a1385c0c9cd1298f5cf9/st7789-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-17 12:50:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pimoroni",
    "github_project": "st7789-python",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "tox": true,
    "lcname": "st7789"
}
        
Elapsed time: 3.76904s