Skip to content

Display drivers

MicroPython display controller drivers for use with displaysys.busdisplay.BusDisplay.

Source: drivers/display/

Init sequence formats

Three formats are supported:

  1. CircuitPython DisplayIO bytearray — e.g. gc9a01.py
  2. List of tuples — e.g. st7789.py
  3. Manual init sequence — e.g. st7796.py

Constructor API

Drivers follow CircuitPython DisplayIO conventions, including rotation as 0, 90, 180, 270 (not 0–3).

Installing drivers

Board config packages install the drivers they need. To install individually:

mip.install("github:PyDevices/pydisplay/drivers/display/st7789.py", target="./drivers/display")

Precompiled drivers are also on the micropython-lib index (e.g. mip.install("st7789", index=...)).

CircuitPython

On CircuitPython, prefer Adafruit's display drivers and pydisplay's BusDisplay wrapper — see CircuitPython platform guide.