CircuitPython Display Support Using displayio

User friendly guide to CircuitPython's native display library - displayio.

by Carter Nelson

published April 30, 2019, last edited December 02, 2025
last major update February 27, 2021

posted in LCDs & Displays Arduino Compatibles CircuitPython

Save Download

195

Beginner

Project guide

FAQs

Is there an easy way to draw bar graphs?

Yes! We have the Adafruit CircuitPython ProgressBar library available. Examples can be found here.

How did displayio naming change in CircuitPython 9?

The names for various components of displayio were changed in CircuitPython 9. The different kinds of displays were split into separate top-level modules. Using the old names in CircuitPython 9 will generate warnings, but will still work. In CircuitPython 10 the old names will be removed completely.

displayio.Display is now busdisplay.BusDisplay.
displayio.FourWire is now fourwire.FourWire.
displayio.EPaperDisplay is now epaperdisplay.EPaperDisplay.
displayio.I2CDisplay is now i2cdisplaybus.I2CDisplayBus.

Why doesn't display.show() work anymore?

In CircuitPython 8, display.show(some_group) was replaced by display.root_group = some_group. You can also read the current root group with display.root_group. show() no longer works in CircuitPython 9.

Page last edited March 25, 2024

Text editor powered by tinymce.

Search