Displays¶

pydisplay provides several display driver classes. All expose a drawing surface compatible with MicroPython's framebuf API.

See Architecture for how drivers connect to board_config.py.

Pick a driver¶

Your target	Driver class	Board config example
MicroPython MCU (SPI/I80)	`BusDisplay`	`board_configs/busdisplay/spi/...`
CPython / MicroPython Unix desktop	`SDL2Display`	`board_configs/sdldisplay/`
Windows / Chromebook (PyGame easier)	`PGDisplay`	`board_configs/pgdisplay/`
CircuitPython RGB / USB video	`FBDisplay`	varies
Jupyter notebook	`JNDisplay`	`board_configs/jndisplay/`
PyScript browser	`PSDisplay`	`board_configs/psdisplay/`

Install the matching board config — it constructs the driver for you.

For microcontrollers on MicroPython and CircuitPython.

MicroPython: uses spibus / i80bus or community C bus drivers (lvgl_micropython).
CircuitPython: uses Adafruit FourWire / ParallelBus — see CircuitPython guide.

Preferred desktop backend (CPython / MicroPython Unix). Uses an SDL texture as GRAM. Config: board_configs/sdldisplay/.

Optional desktop backend using PyGame surfaces. Easier on Windows; avoids some SDL glitches on Chromebooks. Config: board_configs/pgdisplay/.

Works with CircuitPython framebufferio.FramebufferDisplay — dotclock (RGB), USB Video, RGB Matrix.

USB Video lets a board stream the framebuffer as a USB webcam (RP2040; host support varies).

Jupyter Notebook output. No input devices yet. Config: board_configs/jndisplay/.

PyScript browser canvas. Touch only. Config: board_configs/psdisplay/. See PyScript.

Planned — community help wanted.

Anything you can draw on implements the framebuf API:

pydisplay does not include a task scheduler. Options:

BusDisplay uses CircuitPython-style rotation degrees (0, 90, 180, 270).

Known issues: Unix SDL rotation clears the screen; scrolling while rotated has edge cases on desktop and MCU — see roadmap.