Joy-it RB-TFT3.5 User manual

3
3.2“ / 3.5“ Touch-Display
for Raspberry Pi

Published: 29.11.2018 Copyright by Joy-IT 2
3.2“ / 3.5“ Touch-Display
1. Overview
2. Connecon
3. Installing the soware
4. Using the buons
5. Touchscreen calibraon
6. Simultaneous use of LCD and HDMI
7. Informaon- and take-back obligaons
8. Support
TABLE OF CONTENTS

Published: 29.11.2018 Copyright by Joy-IT 3
3.2“ / 3.5“ Touch-Display
Dear customer,
Thank you very much for choosing our product.
In the following we will show you what has to be observed during commissioning and use. Should you
encounter any unexpected problems during use, please feel free to contact us.
Plug the 3.2"/3.5" TFT display onto the Raspberry Pi so that it is plugged onto the rst 26 pins of the GPIO
connector. Aer that the backlight of the display should already light up.
1. OVERVIEW
3.2“ Display 3.5“ Display
Controller XPT2046
Resoluon 320x240 480x320
Colors 65.536
2. CONNECTION

Published: 29.11.2018 Copyright by Joy-IT 4
3.2“ / 3.5“ Touch-Display
Install the FBTFT image on your SD card with the help of the „Win32 Disk Imager“ program, which can be
downloaded from the following links:
• 3,2“ LCD Image-Download
• 3,5“ LCD Image-Download
Alternave download links:
• 3,2“ LCD Image-AlternaveDownload
• 3,5“ LCD Image-AlternaveDownload
Are you already using another Raspbian Image and would like to use it with the 3.2"/3.5" touchscreen-
TFT, then you can install the FBTFT modules on your system aerwards. To do this, the "cong.txt" le
must rst be edited. Open a terminal window on your Raspberry Pi and follow the instrucons:
Depending on your display, add the following lines to the end of the opened le:
For the 3.2“ TFT:
For the 3.5“ TFT:
3. INSTALLING THE SOFTWARE
sudo nano /boot/config.txt
dtparam=spi=on
dtoverlay=joy-IT-Display-Driver32b-overlay:rotate=270,swapxy=1
dtparam=spi=on
dtoverlay=joy-IT-Display_Driver35a-overlay:rotate=270,swapxy=1

Published: 29.11.2018 Copyright by Joy-IT 5
3.2“ / 3.5“ Touch-Display
Now save the le with the key combinaon CTRL+O, conrm with Enter and exit the editor with the
combinaon CTRL+X. Now the le "cmdline.txt" must be edited:
The following command must be added to the end of the rst line:
Save the le, quit the editor and create the le "99-calibraon.conf":
The following lines must be added to the le:
This le can now also be saved and exited. Now edit the le "99-tubro.conf":
Change the following line,...
... so that you change "0" to "1" and the line looks like this:
Save and exit the le.
sudo nano /boot/cmdline.txt
fbcon=map:10
sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf
Section "InputClass"
Identifier "calibration"
MatchProduct "ADS7846 Touchscreen"
Option "Calibration" "160 3723 3896 181"
Option "SwapAxes" "1"
Option "TransformationMatrix" "1 0 0 0 -1 1 0 0 1"
EndSection
sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf
Option "fbdev" "/dev/fb0"
Option "fbdev" "/dev/fb1"

Published: 29.11.2018 Copyright by Joy-IT 6
3.2“ / 3.5“ Touch-Display
Now the required drivers have to be downloaded and installed. Please note that the following commands
dier for the dierent displays:
Commands for the 3.2" LCD:
Commands for the 3.5" LCD:
Now restart your Raspberry Pi:
On the edge of the 3.2" display there are three addional buons.
These can be controlled and used via the GPIO.
When a buon is pressed, the applied signal is pulled to ground (Acve_LOW).
The buons are connected as follows:
cd /tmp
wget anleitung.joy-it.net/upload/joy-IT-Display-Driver-32b-overlay.dtb
sudo cp joy-IT-Display-Driver-32b-overlay.dtb /boot/overlays/joy-IT-Display-Driver-
32b-overlay.dtbo
cd /tmp
wget anleitung.joy-it.net/upload/joy-IT-Display_Driver-35a-overlay.dtb
sudo cp joy-IT-Display_Driver-35a-overlay.dtb /boot/overlays/joy-IT-Display_Driver-
35a-overlay.dtbo
4. USING THE BUTTONS
TFT Raspberry Pi
Taste 1 GPIO12
Taste 2 GPIO16
Taste 3 GPIO18
sudo reboot

Published: 29.11.2018 Copyright by Joy-IT 7
3.2“ / 3.5“ Touch-Display
If a calibraon of the touch screen is necessary, this can be done with the following
steps can be performed. First the calibraon tool must be downloaded.
Open a terminal window and enter the following command:
Now the calibraon can be started with the following command:
Now four points light up one aer the other, which must be pressed to calibrate the display. Then four
calibraon values are output in the terminal, which must be entered into the le "99-calibraon.conf".
Open the le:
Enter the values in the following line:
MinX" corresponds to the rst value, "MaxX" to the second value, "MinY" to the third value and "MaxY" to
the fourth value. Aer saving the le and restarng, the new calibraon data are accepted.
5. TOUCHSCREEN CALIBRATION
sudo apt-get install -y xinput-calibrator
DISPLAY=:0.0 xinput_calibrator
sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf
“Option "Calibration" "160 3723 3896 181"

Published: 29.11.2018 Copyright by Joy-IT 8
3.2“ / 3.5“ Touch-Display
In order to be able to output the picture signal simultaneously on the TFT display and on the HDMI
output, addional steps must be completed. In the rst step, the program "Framebuer-Copy" must be
compiled and installed using the following commands.
So that the program can start when the Raspberry Pi is started, it must be added to the le "/etc/rc.local".
Add a new line with the following content before the statement "exit 0":
Now the following text block must be added to the "/boot/cong.txt" - in this the resoluon, which is
output by HDMI and Display, can be set, by commenng out the respecve block of three from
"hmdi_group", "hdmi_mode" and "hdmi_cvt":
(In the following example the resoluon 800x600 is preset)
6. SIMULTANEOUS USE OF LCD AND HDMI
cd /tmp
sudo apt-get install -y cmake
git clone https://github.com/tasanakorn/rpi-fbcp
mkdir -p rpi-fbcp/build
cd rpi-fbcp/build
cmake ..
make
sudo install fbcp /usr/local/bin/fbcp
sudo nano /etc/rc.local
fbcp &

Published: 29.11.2018 Copyright by Joy-IT 9
3.2“ / 3.5“ Touch-Display
For 4:3 resoluons:
hdmi_ignore_edid=0xa5000080
hdmi_force_hotplug=1
###########################################################################
#### Aufloesungseinstellungen - betreffende Gruppe muss aukommentiert werden ####
##### 4:3 ######
## Einstellungen für 320x240 (native Aufloesung des 3.2"TFT-Displays) ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=320 240 60 1 0 0 0
## Einstellungen für 640x480 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=640 480 60 1 0 0 0
## Einstellungen für 720x540 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=720 540 60 1 0 0 0
## Einstellungen für 800x600 ##
hdmi_group=2
hdmi_mode=87
hdmi_cvt=800 600 60 1 0 0 0
## Einstellungen für 1024x768 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=1024 768 60 1 0 0 0
################################

Published: 29.11.2018 Copyright by Joy-IT 10
3.2“ / 3.5“ Touch-Display
For 16:9 resoluons:
The last step is to edit the le "/usr/share/X11/xorg.conf.d/99-calibraon.conf" again. Open the le with
the following command:
And change the following line...
..., so that you change "1" to "0" again, as in the original state (this is mandatory in framebuer copy
mode):
hdmi_ignore_edid=0xa5000080
hdmi_force_hotplug=1
###########################################################################
#### Aufloesungseinstellungen - betreffende Gruppe muss aukommentiert werden ####
##### 16:9 #####
## Einstellungen für 1280x720 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=1280 720 60 3 0 0 0
## Einstellungen für 1600x900 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=1600 900 60 3 0 0 0
## Einstellungen für 1920x1080 ##
#hdmi_group=2
#hdmi_mode=87
#hdmi_cvt=1920 1080 60 3 0 0 0
###############################
sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf
Option "fbdev" "/dev/fb1"
Option "fbdev" "/dev/fb0"