pyILI9486 is a Python library to control an ILI9486 LCD. Based upon the deprecated Python ILI9341 from
Adafruit and the adapted version for ILI9486 from
Liqun Hu.
Rewritten to use spidev and either gpiod, lgpio or rpi-gpio instead of the discontinued Adafruit counterpart
libraries.
Install the lib with pip install pyili9486, or an equivalent for your python package manager.
This library can use various GPIO backends for internal GPIO control (data and command selection, reset handling). It is
recommended to use the same GPIO library, that you also use in the rest of your project to avoid resource locks. If you
aren't using any library yet, choose gpiod or lgpio, both are modern implementations with a wide compatibility with
modern Raspberry Pi boards.
rpi-lgpio is a special case. For a long time, RPi.GPIO was a widely used library for easy GPIO control. It is
considered outdated now, rpi-lgpio is a replacement package, wrapping lgpio behind a code facade, that exposes the
same API and namespace as RPi.GPIO, making it a drop-in replacement. Technically, the rpi-lgpio implementation of
this library will also work with the original RPi.GPIO being installed.
The necessary backend libraries can be automatically installed by providing it as an extra, e.g.
pip install pyili9486[lgpio] (or pyili9486[gpiod], pyili9486[rpi-lgpio]).
Call sudo raspi-config and then select Interface Options > SPI to enable SPI.
# config (should be the same for basically all displays you can buy)
DC_PIN = 24
RS_PIN = 25
SPI_BUS = 0
SPI_DEVICE = 0
# create SPI device
from spidev import SpiDev
spi = SpiDev(SPI_BUS, SPI_DEVICE)
spi.mode = 0b10 # [CPOL|CPHA] -> polarity 1, phase 0
spi.max_speed_hz = 64000000
# create GPIO facade (choose the one you already use in your project, or pick `gpiod` or `lgpio`)
from pyili9486.gpio.lgpio_facade import LGPIOFacade
gpio_facade = LGPIOFacade(DC_PIN, RS_PIN)
# create the LCD instance
from pyili9486 import ILI9486
lcd = ILI9486(spi, gpio_facade)
# draw some stuff
from PIL import Image
width, height = lcd.dimensions
red = Image.new(mode='RGB', size=(width // 2, height // 2), color=(255, 0, 0))
green = Image.new(mode='RGB', size=(width // 2, height // 2), color=(0, 255, 0))
blue = Image.new(mode='RGB', size=(width // 2, height // 2), color=(0, 0, 255))
white = Image.new(mode='RGB', size=(width // 2, height // 2), color=(255, 255, 255))
lcd.begin()
lcd.display(red, 0, 0)
lcd.display(green, width // 2, 0)
lcd.display(blue, 0, height // 2)
lcd.display(white, width // 2, height // 2)Brightness control is not implemented, because many displays using this driver chip have a hardwired backlight, that
cannot be controlled via the driver chip or a GPIO pin. Implementing it would require some hardware changes on the
display unit. To emulate shutting off the display you can use lcd.clear().display(), which makes the display to show
black pixels.
Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!
Written by Tony DiCola for Adafruit Industries.
Adapted for ILI9486 by Liqun Hu.
Modified and maintained by Thorben Yzer.
Support for MHS3528 variant by Craig Lamparter and hemna.
MIT license, all text above must be included in any redistribution