Drivers used in nano-gui, micro-gui and micropython-touch are identical. These displays and drivers are also compatible with the Writer class.

Note that most ePaper/eInk displays are unsuitable for interactive use owing to their long update time. The one exception is the Waveshare pico 4.2 inch which is quick enough to work with micro-gui.

Displays using drivers in this repo

Size is diagonal in inches. C/M/GS color/1-bit monochrome/greyscale.
Displays with a touch overlay are denoted by T, K, R or S depending on the touch hardware. See Touch Displays below.
Width and height are pixels.

Size	Width	Height	Tech	Driver	Description	Notes
0.96C	94	64	OLED	SSD1331	Adafruit 684
1.12GS	96	96	OLED	SSD1327	Seeed 104030011	Obsolescent.
1.27C	128	96	OLED	SSD1351	Adafruit 1673
1.5C	128	128	OLED	SSD1351	Adafruit 1431
1.4M	128	64	LCD	SSD7567s	ST7567s	Similar to SSD1306
1.44C	128	128	TFT	ST7735R	Adafruit 2088
1.5C	160	128	TFT	ST7735R	Adafruit 358
1.3C	240	240	TFT	ST7789	Adafruit 4313
1.28C Q	240	240	TFT	GC9A01	W'share 1.28 touch LCD	Round touch display
1.28C Q	240	240	TFT	GC9A01	W'share 1.28 touch LCD	Round touch display with embedded RP2 chip
1.5GS	128	128	OLED	SSD1327	Waveshare 13992
2.0C	320	240	TFT	ST7789	Waveshare Pico LCD 2	For Pi Pico.
1.54C	240	240	TFT	ST7789	Adafruit 3787
1.14C	240	135	TFT	ST7789	T-Display	ESP32 with attached display.
2.8C K	240	320	TFT	ILI9341	Adafruit touch shield	Arduino shield format capacitive touch.
2.8C T	320	240	TFT	ST7789	Waveshare pico 2.8	Display for Pi Pico. (Touch support).
2.8C V	320	240	TFT	ST7789	Waveshare ESP32-S3 2.8	Waveshare ESP32-S3 2.8 inch touch LCD
1.14C	240	135	TFT	ST7789	Waveshare pico 1.14	For Pi Pico. Buttons good for micro-gui.
1.14C	240	135	TFT	ST7789	Pimoroni pico 1.14	For Pi Pico. Buttons good for micro-gui.
1.47C	320	172	TFT	ST7789	DFR0995
1.3C	240	240	TFT	ST7789	Waveshare Pico 1.3
1.9C	320	170	TFT	ST7789	Adafruit 5395
3.2C S	320	240	TFT	ILI9341	ESP32-2432S024C	Cheap yellow display 3.2" capacitive touch
3.2C R	320	240	TFT	ILI9341	Adafruit 1743	Big touch unit. eBay equivalents work here.
3.5C T	480	320	TFT	ILI9486	Waveshare Rpi 3.5 LCD	Pi HAT. Many pixels. Needs plenty of RAM.
3.5C R	480	320	TFT	ILI9486	Adafruit 3.5 LCD	3.5" HX8357D touch, notes as above.
3.5C T	480	320	TFT	ILI9486	Waveshare Pico 3.5	3.5" Pico ILI9488 (touch).
2.13M	250	120	eInk	SSD1680	Waveshare Pico 2.13	Mono ePaper display, Pico plugs in rear.
2.9M	296	128	eInk	?	Waveshare Pico 2.9	Pico plugs in, others via cable see.
2.9M	296	128	eInk	UC8151D	Adafruit 4262	Flexible ePaper display.
2.9M	296	128	eInk	UC8151D	Adafruit 4777	FeatherWing ePaper display.
2.9M	296	128	eInk	SSD1680	WeAct Studio ePaper	WeAct Studio ePaper display.
4.2M	400	300	eInk	WS	Waveshare pico 4.2	Pico plugs in, others via cable see.
4.2M	400	300	RLCD	ST7305	W'sh ESP32-S3-RLCD-4.2	Reflective mono display, faster than eInk.
2.7M	274	176	eInk	HAT	Waveshare HAT	HAT designed for Raspberry Pi, repurposed.
2.7M	400	240	Sharp	Sharp	Adafruit 4694	Micropower monochrome display.
1.3M	168	144	Sharp	Sharp	Adafruit 3502	Ditto.

Displays using compatible drivers

Monochrome OLED displays based on the SSD1306 chip are supported via the official driver. Displays are available from various sources and can use I2C or SPI interfaces. An example is Adafruit 938. The SSD1306 driver in this repo has minor additions to support demos intended for color displays.

Monochrome OLED displays based on the SH1106 chip are supported via the unofficial driver. The SH1106 driver in this repo has minor additions to support demos intended for color displays. Displays are available from various sources and can use I2C or SPI interfaces. An exmaple is the Inland IIC SPI 1.3" 128x64 OLED V2.0 AKA KeyStudio.

Nokia 5110 (PCD8544) displays. This driver is compatible.

Waveshare have published drivers for their other products, claiming nano-gui compatibility. Lacking the relevant hardware I am not in a position to assess or support these but feel free to use them. They have re-published nano-gui which they are entitled to do, but their copy may not include the latest bugfixes or enhancements.

User contributed drivers

The following drivers were contributed by users. I am unable to support these as I don't possess the relevant hardware. SSD7567s contributed by EnricoRoss98 PR SSD1680.py contributed by EnricoRoss98 PR

Adafruit displays

See these notes for wiring details, pin names and hardware issues.

Unlisted displays

Displays whose controller is listed above

An untested display that uses a supported controller is not guaranteed to work. This is because a controller can be connected to the display in a variety of ways. In some cases the existing driver can be persuaded to work, sometimes by using nonstandard constructor arguments. In other cases the driver itself needs to be adapted.

Other controllers

For an unlisted controller the first step is to see if there is an existing driver that can be ported. Adafruit publish CircuitPython drivers for their hardware: these are easy to port to MicroPython. Only a minimal subset is needed to support these GUI's, with the result that the drivers can be very simple. See this doc for details.

Touch displays

Label	Controller	Comments
R	TSC2007	Resistive touch needs external controller
T	XPT2046	Resistive touch, XPT2046 controller.
K	FT6206	Capacitive touch controller.
Q	CST816S	Capacitive touch controller.
S	CST820	Capacitive touch controller.
V	CST328	Capacitive touch controller.

Links

Device driver document.

nano-gui

micro-gui

micropython-touch

Writer and CWriter