-

2.8 inch Touch Screen for Pi zero: Difference between revisions

From Geekworm Wiki
Jump to navigation Jump to search
Line 49: Line 49:


==Use Guide==
==Use Guide==
ZERO PIN:  
*ZERO PIN:
{| class="wikitable"
{| class="wikitable"
! FUN !! Symbol !! Descriptions Remark       
! FUN !! Symbol !! Descriptions Remark       

Revision as of 18:33, 30 April 2026

 ⚠️  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

  • ZERO PIN:
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

File:ZERO-PIN.xls

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.

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:

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

<comments/>