2.8 inch Touch Screen for Pi zero

 ⚠️  Deprecated: This page is outdated and may contain inaccurate information. It is kept for reference only. 

Version-A 2.8 inch Touch Screen for Pi zero W

Version-A 2.8 inch Touch Screen for Pi zero W

Version-A 2.8 inch Touch Screen for Pi zero W

Version-B 2.8 inch Touch Screen for Pi zero W

Version-C 2.8 inch Touch Screen for Pi zero WH

Version-C 2.8 inch Touch Screen for Pi zero WH

Overview

Fastest 2.8 inch Touchscreen for Raspberry Pi Zero /W and Raspberry pi 3 model b+ /3B/2B/B+/CM3 etc,Super HD 640x480 Resolution,60+ fps

Perfect fit your Pi zero/ zero w, PORTABLE MONITOR

Customized circuit board for 2.8-inch

High speed Raspberry Pi screen

Working Current: 100 mA

Notice: Not including Raspberry Pi zero / Pi zero W board

In fact, this screen fits to Raspberry Pi 3B/2B/B+; but you must use the bread cables to connect them, because it's male pins on the this screen, and it's male pins on the pi 3B also;

Testimonial

"FWIW, got it working. This script should do the trick in case anyone else needs it.https://github.com/eat-sleep-code/tiny-tv/blob/master/install-mzdpi-display.sh

On Monday, April 27, 2026 at 08:03:55 PM MST, Jeffrey L. Edgett wrote:

Yeah, I have been fighting with it for the last day and Claude hasn't been able to figure out why it is blue-tinted. Tried adjusting the tint in vlc, but it has no effect as the display itself is blue tinted.

I have the old 2.8" iUniker/Geekworm DPI display and am using Pi OS Trixie.

I have gotten it to work as a display by running the following routine which puts the configuration over in the correct location.

https://github.com/eat-sleep-code/tiny-tv/blob/master/install-mzdpi-display.sh

but... the colors have a decidedly blue hue to them that didn't exist back in Bullseye (reds are shifted more toward purple, greens are shifted more towards blue, blacks are more navy than black). What tweaks can I make to make to bring the color back to the correct place?"

— Jeffrey L. Edgett, April 2026

Use Guide

FUN	Symbol	Descriptions Remark
3V3
5V0
GPIO2	VSYNC	Vertical synchronous for Display DATA
5V0
GPIO3	HSYNC	Horizontal synchronous for Display DATA
GND
GPIO4	B3	BLUE signal 3
GPIO14	G4	GREEN signal 4
GND
GPIO15	G5	GREEN signal 5
GPIO17	G7	GREEN signal 7
GPIO18	NC
GPIO27	TP-INT	touch int signal
GND
GPIO22	R5	RED signal 5
GPIO23	R6	RED signal 6
3V3
GPIO24	R7	RED signal 7
GPIO10	SPI-MOSI	SPI master output slave input
GND
GPIO9	SPI-MISO	SPI master input slave output
GPIO25	NC
GPIO11	SPI-SCLK	SPI cloclk
GPIO8	B7	BLUE signal 7
GND
GPIO7	B6	BLUE signal 6
GPIO1	DE	Enable signal for Display
GPIO0	PCLK	Clock signal for Display Data
GPIO5	B4	BLUE signal 4
GND
GPIO6	B5	BLUE signal 5
GPIO12	G2	GREEN signal 2
GPIO13	G3	GREEN signal 3
GND
GPIO19	NC
GPIO16	G6	GREEN signal 6
GPIO26	NC
GPIO20	R3	RED signal 3
GND
GPIO21	R4	RED signal 4

Github project: https://github.com/tianyoujian/MZDPI

Setup screen via script (Recommend)

cd ~/
git clone https://github.com/tianyoujian/MZDPI.git
cd MZDPI/vga
sudo chmod +x mzdpi-vga-autoinstall-online
sudo ./mzdpi-vga-autoinstall-online
sudo reboot

How to solve the blue/yellow on Raspberry pi 4?

Please run the following shell or refer to above github project:

sudo raspi-gpio set 8 a2
sudo raspi-gpio set 7 a2

For linux kernel 4.9 (old)

Download File:Mzdpi-vga-4.9.x.zip, and unzip it;

Copy the mzdpi.dtbo to the directory /boot/overlays, and copy the the other files to directory /boot;

then restart the raspberry pi;

Note: We only test the screen on Raspbian OS and Retropie now;

How to check the kernel version?

uname -a

For linux kernel4.4 or Earlier (old)

Which GPIO Pins are Occupied by this screen? Please refer to here: File:PI ZERO W LCD PIN.ZIP

Picture

For Version-B

What is the purpose of the NEW 2.8 inch display pins VBAT, AUX (with jumper), PWM and left-side pins ?

1.VBAT and AUX are the ADC inputs of the XPT2046 and can be used to measure voltage. The XPT2046 is a touch control chip.

2.The PWM pin is the control pin of the backlight. The brightness of the PMW signal can be adjusted externally.

3.The left-side pins (on New Version B photo) is no use.

• Driver: https://github.com/tianyoujian/MZDPI/tree/master/vga (mzdpi-vga-autoinstall-online)

FAQ of Version-B

Question: 1. How is it possible to control the backlight brightness with the pins on the back? Can I use an adjustable resistor? Do I need to solder those pins to the raspberry and use some software?

/How is it possible to turn off the screen in software on the raspberry? Is there a command? An external switch with the pins on the back? Perhaps just turning down the brightness to 0 level?

Answer:

1. Please use the short circuiter to connect the pin of PWM and GPIO 18, then can control the backlight brightness by software.

2.The Raspberry Pi GPIO 18 can output the signal of PWM.

3.When the GPIO 18 output low level (PWM duty cycle is 0), the backlight is off.

Question:

2.Is this screen is SPI? Or HDMI? 16 bit color or 24 or 32?

Answer:

The 2.8inch screen is consist of display screen and touch screen, The display screen is DPI, and the touch screen is SPI.And it is 16 bit color and RGB565 mode.

For Version-C

Update of the Version C:

• Ultra-thin Design, can directly use with Raspberry Pi Zero WH
• Special design that can use with Chewing Gum Battery
• Driver: https://github.com/tianyoujian/MZDPI/tree/master/vga (mzdpi-vga-autoinstall-online)

FAQ of Version-C

Question 1:

Why the LCD cannot light up?

Answer:

(1)It is directly control via software:

sudo raspi-gpio set 18 op dh (turn on the backlight)

sudo raspi-gpio set 18 op dl (turn off the backlight)

(2)Or you could add

gpio=18=op,dh

into the config.txt. then the backlight will be turned on as soon as the system is running.

Application

• Simpsons TV from from Brandon: https://www.reddit.com/r/3Dprinting/comments/p9lasb/i_designed_and_printed_a_working_simpsons_tv/
• Simpsons TV - Build Guide from Brandon: https://withrow.io/simpsons-tv-build-guide