Elegoo 3.5"" TFT User Manual

Elegoo 3.5’’ TFT

Touch Screen User

Manual

Content

1. Get Prepared .......................................................................................................................... 4

1.1. Product Description .................................................................................................. 4

1.2. Hardware Preparation ............................................................................................. 5

1.3. Software Preparation ............................................................................................... 8

1.3.1. Software Needed ........................................................................................... 8

1.3.2. Download System Image ........................................................................... 10

2. Installation System ............................................................................................................. 11

2.1. Install Configured Raspbian system .................................................................... 11

2.2. Install Official Raspbian System ........................................................................... 14

3. Advanced Function ............................................................................................................. 20

3.1. Touch Screen Calibration ....................................................................................... 20

3.2. Install Virtual Keyboard .......................................................................................... 22

3.3. Modify Display Orientation ................................................................................... 26

4. FAQ ......................................................................................................................................... 27

4.1. Compatible Systems ............................................................................................... 27

4.2. White /Blank Screen ............................................................................................... 27

4.3. Kernel Crash ............................................................................................................. 29

4.4. Touch Screen Issue ................................................................................................. 29

4.5. Performance Issue .................................................................................................. 30

4.6. NOOBS Issue ............................................................................................................ 31

Statement

This manual is used only for our Elegoo 3.5 inch screen for Raspberry Pi and

Raspbian system. If you are using Linux system this manual wouldn’t be a perfect
reference and if you are using no-Linux system then you can skip this manual.

1. Get Prepared

1.1. Product Description

（1）Product Features：

（2）3.5 inch touch screen size：

（3）Specifications：

Type

TFT Touch
Interface

Touch panel control IC

XPT2046

Color gradation index

65536 colors

Back Light style

LED

Resolution

320 X 480 (Pixel)

Size Ratio

 3.5inch touch screen，480×320 resolution ratio
 Resistive touch screen function
 Compatible with all versions of Raspberry Pi
 CE and RoHS certificated

Screen

SPI

8 : 5

Power Consumption

TBD

Back-light current

Operating
temperature(℃)

（4）Raspberry Pi GPIOs used by 3.5 inch touch screen

INTERFACE

RPi PIN NO.

SYMBOL

DESCRIPTION

1.2. Hardware Preparation

TBD
TBD

1,17 3.3V Power positive(3.3V input)

2.4 5V Power positive(5V input)

3,5,7,8,10,12,13,15,16 NC NC

6,9,14,20,25 GND GND

11 TP_IRQ

18 LCD_RS

19 LCD_SI/TP_SI SPI data input of LCD/Touch Panel

21 TP_SO SPI data output Touch Panel

22 RST Reset

23

24 LCD_CS LCDs chip selection, low active

26 TP_CS Touch Panel's chip selection, low active

LCD_SCK/TP_SC

K

Touch Panel interrupt, low level while the

Touch Panel detects touching

LCD instruction control, Instruction/Data

Register selection

SPI clock of LCD/Touch Panel

（1）A computer(better with desktop)；
（2）A Raspberry Pi (Pi3 is recommended which is also used in next tutorial）

（3）Elegoo 3.5 inch TFT screen；

（4）One Micro SD with at least 4 GB space，32GB is preferred；

（5）One Micro USB cable (USB type-A to USB type B Micro)

（6）One SD card reader

（7）One network cable

1.3. Software Preparation

1.3.1. Software Needed

（1）SDFormatter.exe，used to format SD card

Attention: The above 3 software are available in CD Where there is a file named
Software

（2）Win32DiskImager.exe，used to write system into SD card

（3）Putty.exe，textual interface used on PC

（4）Advanced IP Scanner，go to

1.3.2. Download System Image

http://download.cnet.com/Advanced-IP-Scanner/3000-18508_4-10115592.html

download the local area network (LAN) IP scanner software which can be used
directly.

and

（1）Download the configured Raspbian system image (with drivers pre-installed)
from below link:

Https://github.com/goodtft/LCD-show/wiki/Images-Download-address

（2）Download the official Raspbian System Image from Raspberry official website --

https://www.raspberrypi.org/downloads/raspbian/

and choose the zip file with PIXEL.

Attention: You will only need to use one of the above system.

2. Installation System

2.1. Install Configured Raspbian system

Format

（1）Put SD card into SD card reader and connect it with your PC

（2）

Run SDFormatter.exe and choose your SD card on your computer. Click

and there will be notifications popping up and click

Yes

Complete

until you click

.

（3）Unzip the system image downloaded and run Win32DiskInage.exe. Choose the
*.img file you just unzipped and choose your SD card then click write till it finish and
exit.

（4）Open your CD or tutorial downloaded from our web(Elegoo.com/download)
Copy SSH file to your SD card and paste.

（5）Take out SD card and insert into Raspberry Pi and then plug 3.5 inch screen.
Use your USB cable to connect the Raspberry Pi with your computer and wait a few
seconds your system will start successfully.

Pic 2.5

FAQ：I got blank/white screen in this step, what should I do?

Pic 26

Pic 27

（1）Your SD card might be defective. Please change a new SD card and re-write the
system

（2）If the screen still keeps black/white please contact us with your order number

2.2. Install Official Raspbian System

at [e-mail] / [e-mail]

Official Raspbian system means you will need to download the pure system image
from Raspberry website (https://www.raspberrypi.org
pre-installed.

（1）Put SD card into SD card reader and connect it with your PC；

) which doesn’t have drivers

（2）Run SDFormatter.exe and choose your SD card on your computer. Click Format
and there will be notifications popping up and click confirm until you click complete.

（3）Unzip the system image downloaded and run Win32DiskInage.exe. Choose the
*.img file you just unzipped and choose your SD card then click write till it finish and
exit.

（4）Open your SD card and you will find the system image. Right click and create a
new .txt file and name it SSH (NO suffix, like below)

（5）Check your IP address on your computer and click the network icon on the
below right area and choose network setting. Check your IP address as below:

（6）Take out SD card and plug your Raspberry Pi. Use your USB cable to connect
your Pi with your computer and wait for a while then run ipscan24.exe, input the LAN
segment of your computer and Pi as shown in Pic2.13 to acquire the IP address of

your Pi.

Open

Yes

pi

raspberry

Pic 2.13

（6）

Input the IP address you acquired into putty and select SSH, click

will be notifications popping up in your first connection, just click

. There

as shown in Pic

2.14. You will need to login in account and password as shown in Pic 2.15, input
login as and the password is

. Then you will get in the textual interface for

your Raspbian remote login.

for

Pic 2.14

Pic 2.15

（9）Input below commands in turn:

sudo apt-mark hold raspberrypi-bootloader
sudo apt-get update
sudo apt-get upgrade
git clone https://github.com/goodtft/LCD-show.git

chmod -R 755 LCD-show

cd LCD-show/

FAQ：I got blank/white screen in this step, what should I do ?

Solution：

sudo ./LCD35-show

It will take a while updating so please choose Y when you were asked to make a
choice. Raspberry Pi will restart once you input your last command and then the Pi
and touch screen will work properly.

（1）Please refer Chapter 2.0 and use our configured system and make sure there is
no error in the function of your screen. If anything please change your SD card to a
new one and rewrite our configured system and then test again. If the blank/white
screen still exists please contact us at [e-mail]

for further technical

support.

(2) If your touch screen works fine with our configured system, it means the
driver program is not compatible with system. In this case you can use our
configured system or send us an email at [e-mail]

and we will inform
you when the driver program updates at the first place. You will need remote login
and delete previous driver files (sudo rm -rf LCD-show) and input below commands
in turn:
sudo apt-mark hold raspberrypi-bootloader

sudo apt-get update
sudo apt-get upgrade

git clone https://github.com/goodtft/LCD-show.git
chmod -R 755 LCD-show
cd LCD-show/

sudo ./LCD35-show

3. Advanced Function

3.1. Touch Screen Calibration

（1）Open the where the driver is and install Xinput then input below commands:
cd LCD-show
sudo dpkg -i -B xinput-calibrator_0.7.5-1_armhf.deb

You will get results as shown in Pic 3.1:

Pic 3.1

（2）calibrate touch screen and input：

DISPLAY=:0.0 xinput_calibrator

Use your stylus pen and click the red cross that appears on the screen (as shown in
Pic 3.2) to get calibration data(as shown in Pic 3.3)

Pic 3.2

Pic 3.3

Ctrl+X

Enter

FAQ：

（1）There are errors or no response after I input DISPLAY=:0.0 xinput_calibrator in
putty, what should I do?

Solution:

（3）Record your calibration data and open your configuration files

sudo nano /etc/X11/xorg.conf.d/99-calibration.conf

Replace the data after “Calibration” (as shown in Pic 3.4) and press

Y

and then press

, then save and exit.

, then press

Pic 3.4
（4）Restart your Raspberry Pi and now your touch screen will respond to each
touch correctly.

Calibration command must run in the file of LCD-show, which means before
you run calibration command you will need first input cd:/LCD-show then input
calibration command.

(2) After calibration the touch function works very well but after I restart system, the
screen is back to old problems again?

Solution:

3.2. Install Virtual Keyboard

Attention:

and if problems still exists please contact us at [e-mail]

This happens because might forgot to save in step 3. Please go try again

（1）Install and download the virtual keyboard code below and compile:

sudo apt-get update
sudo apt-get install libfakekey-dev libpng-dev autoconf libxft-dev libtool automake -y
git clone https://github.com/mwilliams03/matchbox-keyboard.git
cd matchbox-keyboard
./autogen.sh

below if everything goes well. If you didn't get below results you will need to check
whether there are any error options.

./autogen.sh will take several minutes to run and you will get results like

（2）Install Virtual Keyboard
sudo make
sudo make install
（3）Install shared library for virtual keyboard
sudo apt-get install libmatchbox1

Ctrl+X,

Y

Enter

Ctrl+X,

Y

Enter

（4）Create the startup script for virtual keyboard

sudo nano /usr/bin/toggle-matchbox-keyboard.sh

Copy and paste below content and press

then

then

then save and exit.

#!/bin/bash
#This script toggle the virtual keyboard
PID=`pidof matchbox-keyboard`
if [ ! -e $PID ]; then
killall matchbox-keyboard
else
matchbox-keyboard -s 100 extended&
fi

Grant the oggle-matchbox-keyboard.sh script executable permissions

sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh

（5）Add the script in step 4 into Start menu.

sudo nano /usr/share/applications/toggle-matchbox-keyboard.desktop

Copy and paste below content and press

then

then

then save and exit.

[Desktop Entry]
Name=Toggle Matchbox Keyboard
Comment=Toggle Matchbox Keyboard
Exec=toggle-matchbox-keyboard.sh
Type=Application
Icon=matchbox-keyboard.png
Categories=Panel;Utility;MB

X-MB-INPUT-MECHANSIM=True

Ctrl+X,

Y

Enter

（6）Create icon on task bar

Please noted that you must use Pi user permission in the step which means you
don't need to add sudo before nano; if you use admin permission you won’t be able
to find this file.

Input below command:

nano ~/.config/lxpanel/LXDE-pi/panels/panel

Find below codes in the file:

Plugin {
type=launchbar
Config {
Button {
id=/usr/share/applications/lxde-x-www-browser.desktop
}
Button {
id=/usr/share/raspi-ui-overrides/applications/pcmanfm.desktop
}
Button {
id=/usr/share/raspi-ui-overrides/applications/lxterminal.desktop
}
Button {
id=/usr/share/applications/wolfram-mathematica.desktop
}
Button {
id=/usr/share/applications/wolfram-language.desktop
}
}
}
Add below codes before the first ‘’Button’’
Button {
id=toggle-matchbox-keyboard.desktop
}

Press

then

then

then save and exit.

Input command:

sudo reboot

Extra Skills

FAQ：

Solution:

And Raspberry Pi will restart to complete installation. Click the icon in the red box
(see Pic 3.7) and you are free to use the virtual keyboard.

Pic 3.7

：

Login via SSH and input below commands to change the size of virtual keyboard

DISPLAY=:0.0 matchbox-keyboard -s 50 extended
DISPLAY=:0.0 matchbox-keyboard -s 100 extended

If you are using mouse and keyboard please input below commands in the terminal

console marked in yellow circle in Pic 3.7:

matchbox-keyboard -s 50 extended
matchbox-keyboard -s 100 extended

When I use virtual keyboard to input and click no-keyboard area, the keyboard
disappeared, what should I do?

Technically virtual keyboard is a software so if you click no-keyboard area
the keyboard will “disappear” or hide because it’s under other windows or interfaces.
Click the keyboard icon again or change the upper window or interface to a smaller
one then you will find the keyboard again.

3.3. Modify Display Orientation

Ctrl + X

FAQ：

Solution:

（1）Open configuration file – config.txt and input

sudo nano /boot/config.txt

（2）Find ”dtoverlay=tft35a” in config.txt and add rotate parameter in below formats:

dtoverlay=tft35a:rotate=value

When value is 0, it means to rotate 0 degree, in this case screen is vertical display
When value is 90, it means to rotate 90 degree, in this case screen is horizontal
display
When value is 180, it means to rotate 180 degree, in this case screen is vertical
display
When value is 270, it means to rotate 270 degree, in this case screen is horizontal
display

（3）

Press

accordingly to your modification.

After I changed the display orientation, the touch screen function is not working,
what should I do?

Please refer Chapter 3.0 and calibrate your screen again.

and choose Y. Save and exit and restart you will see changes

4. FAQ

4.1. Compatible Systems

4.2. White /Blank Screen

Problem：

Analysis：

（1）Failure in writing system

Solution：

（2）SD card format error or SD card is defective：

Solution:

Elegoo 3.5 inch touch screen can work with Raspbian system, Ubuntu-mate system
and kali Linux system.

Systems that won’t work with this screen are recalbox, RetoPie, Kodi because this 35
inch screen is connected with Raspberry Pi through SPI buses not HDMI buses and
those systems that won’t work require HDMI buses for display and touch screen.
Besides as a starter screen, its frame rate and image quality may not be suitable for
arcade game simulator or multimedia playback center.

 Quality issue of screen
 Drivers are not compatible with system
 Failure in writing system
 SD card format error or SD card is defective
 Drivers are not installed
 System is out of date or the firmware program of bootloader was changed when

updating system

Connect your Raspberry Pi with your desktop display using HDMI cable and the

system won’t show up in the display.

card format might be wrong or SD card is defective.

Rewrite system many times and system still won’t start

Choose SD card in your computer and right click --choose property—make sure your
SD card format is FAT32. If SD card is defective please change it to a new and

When charged，the screen is white and shows nothing in there.

White/blank screen might happen because of below reasons:

Rewrite system and if problem still exists after rewriting then you SD

Wrong SD card format: Run SDFormatter.exe and format your card.

functional one.

（3）System is out of date or the firmware program of bootloader was changed
when updating system：

Solution：

（4）Drivers are not installed：

Solution：

（5）Drivers are not compatible with system：

Solution：

（6）Quality issue of screen：

Solution:

below commands before updating:

sudo apt-mark hold raspberrypi-bootloader

Make sure bootloader won’t be changed and then input below commands:

sudo apt-get upgrade
sudo apt-get update

Update system in the right way and restart then reinstall drivers.

You will need to update system when you first start system. Input

3.5 inch screen works with the configured Raspbian system but not on the

official Raspbian system.

Please refer Chapter2.2 and install drivers.

3.5 inch screen works with the configured Raspbian system. After installing

drivers for official Raspbian system the screen is still white/blank.

[e-mail]

how to install drivers.

Excluding reason（1）to（5）then you might have received a defective scree.

tell us where you bought this screen. We will arrange a replacement and send it to
you for free very soon.

Please install the latest version of Raspbian system and contact us at

. We will inform you once the drivers is updated and show you

Please send us an email with your order ID at [e-mail] and

4.3. Kernel Crash

Problem:

Analysis

（1）Drivers not compatible with system：

Solution:

（2）SD card functionality is not stable and has bad contact:

Solution：

（3）Raspbian system is not compatible with drivers：

Solution：

4.4. Touch Screen Issue

Analysis：

（1）Compatibility issue between drivers and system：

there are some start info on the screen but in the last line it says kernel crash.

with your system; Second, SD card functionality is not stable and has bad contact.
Third, your Raspbian system is out of date and not compatible with drivers.

after installing drivers and restart, the system won’t start. On the screen

：There are 3 reasons from Kennel crash: First, drivers are not compatible

If your screen works well with our configured Raspbian system, it means the

system you installed before is not compatible with our drivers.

Kali as well. The latter two system will need some adjustments to installing
commands. We recommend systems of Raspbian, Ubuntu-mate and Kali. As to the
other systems please contact us for solutions and we’ll try our best to help out.

Our drivers are compatible with Raspbian system, Ubuntu-mate and

SD card takes a very long time to be recognized by computer even can’t be

recognized sometimes. Or the files in SD card cannot open and some are broken.

Please get a new SD card.

Please install the configured Raspbian system and test whether you can use the

screen.

drivers.

Please install the latest Raspbian system and contact us for the latest

Drivers installed and screen shows system windows but touch screen function is not
working, cursor and touch point doesn’t match.

and system；Two，Didn’t calibrate screen after modifying screen orientation; Three,
Quality issue.

There are 3 reasons for this issue：One，Compatibility issue between drivers

Install the configured system and if touch screen function works well it means

the drivers you installed are not compatible with the system you installed previously。

Solution：

（2）Didn’t calibrate screen after modifying screen orientation：

Solution：

（3）Quality issue：

Solution：

4.5. Performance Issue

（1）This 3.5 inch screen has taken up too many GPIO ports.

Analysis：

（2）Arcade game systems like RetroPie，recalbox won’t work well on this screen

Analysis：

（3）Multimedia playback center like Kodi won’t work on this screen

Analysis ：

（4）Cannot play HD videos on this 3.5 inch screen
Analysis：

（1）Use the configured system we provided；
（2）Install the latest Raspbian system and contact us for the latest drivers.

Touch screen function is working well before modifying screen orientation.

screen.

After modifying screen orientation please refer Chapter3.1 to calibrate

After installing configured system the touch screen function is still not working.

marketplace you bought this screen. We will send you a new one for free.

Please send us an email with your order ID and tell us which Amazon

symbol) taken up by screen (Please refer to the chart in Chapter 1.1 Section (4)
Raspberry Pi GPIOs used by 3.5 inch touch screen)

so the frame rate is not very fast and the image quality is of ordinary level. RetroPie
and recalbox requires HDMI buses communication and fast frame rate. So if you use
this screen with these arcade game system there would be frame drop and not
smooth in playing games.

communicate while this screen uses SPI buses.

resolution ratio so playing HD videos on this screen won’t be a pleasant experience.

Please use Raspberry Pi extension board to use those GPIO ports(with NC

3.5 inch screen use SPI buses to communicate and the speed is kind of slow

The same reason as above, Kodi system also uses HDMI buses to

This screen is a starter screen for Raspberry Pi and has only 480*320

We suggest to use average quality videos and play on this screen.

4.6. NOOBS Issue

Problem:

Solution:

drivers the screen is still white.

system, just like installation boot software on Windows system. So we cannot install
drivers on NOOBS. We could install Raspbian system using NOOBS then install
drivers on Raspbian. This way you can use Raspbian system on the screen.

There is NOOBS in SD card, Raspberry Pi can start but after installing

NOOBS is short got New Out of Box Software and it’s a software not a