Joy-it 1656364 User manual

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
3.2" / 3.5" TOUCH-DISPLAY
For the pinning on the Raspberry Pi
1. GENERAL INFORMATION
Dear customer,
Thank you for purchasing our product. In the following, we will show you
which things should be noted during the use.
Should you encounter any unexpected problems, do not hesitate to contact
us

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
2. OVERVIEW
3.2" Display 3.5" Display
Controller XPT2046
Resolution 320 x 240 480 x 320
Colors 65.536
3. CONNECTION
Pin the 3.2" / 3.5" TFT- Display on the Raspberry Pi so that the first 26
pins of the GPIO pin header are plugged in. Aer that, the
backgroundlight of the display is turned on.
4. INSTALLATION OF THE SOFTWARE
Install the TFT-image on your SD-card with the Win32-Disk-Imager which you
can download via the following links:
For the 3.2" display, you find the downloads here.
For the 3.5" display, you find the downloads here.

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
Manual installation
If you use already another Raspbian image and you want it to expand it
with the 3.2" / 3.5" touchscreen-TFT, then you can install the modules on
your system subsequently.Therefore, you must edit the file config.txt .
You have to open the terminal on your Raspberry Pi and follow the
instructions:
sudo nano /boot/config.txt
Add here, dependingon the display, the following lines at the beginning of
the opened file:
For the 3.2" TFT-display:
dtparam=spi=on
dtoverlay=joy-IT-Display-Driver32b-overlay:rotate=270,swapxy=1
dtparam=audio=on
max_usb_current=1
hdmi_force_hotplug=1
config_hdmi_boost=7
hdmi_drive=1
hdmi_ignore_edid=0xa5000080
For the 3.5" TFT-display:
dtparam=spi=on
dtoverlay=joy-IT-Display_Driver35a-overlay:rotate=270,swapxy=1
dtparam=audio=on
max_usb_current=1
hdmi_force_hotplug=1
config_hdmi_boost=7
hdmi_drive=1
hdmi_ignore_edid=0xa5000080
At the Raspberry Pi 4 ,you must do some additional settings. For that, you
have to comment out in the file config.txt beneath point [pi4] the command
dtoverlay=vc4-fkms-v3d so it looks like the following:
[pi4]
# Enable DRM VC4 V3D driver on top of the dispmanx display stack
#
#dtoverlay=vc4-fkms-v3d <---- Diese Einstellung muss mit einer # auskommentiert werden
max_framebuffers=2
Save now the file with the key combination CTRL + O, confirm with Enter
and leave the file with CTRL + X. Now the file cmdline.txt must be edited:
sudo nano /boot/comdline.txt

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
Therefore, you have to add in the first line the following command:
fbcon=map:10
Save the file, leave the editor and create the file 99-calibration.conf :
sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf
The following lines must be added in the file:
Section "InputClass"
Identifier "calibration"
MatchProduct "ADS7846 Touchscreen"
Option "Calibration" "160 3723 3896 181"
Option "SwapAxes" "0"
EndSection
Also this file has to be saved and terminated with CTRL + X with a following
Y and Enter. As the last step, the file
/usr/share/X11/xorg.conf.d/99fbturbo.conf has to be edited. Therefore, en-
ter the following command:
sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf
Change this line …
Option "fbdev" "/dev/fb0"
… from fb0 to fb1 so that the line looks like the following:
Option "fbdev" "/dev/fb1"
Also this file has to be saved and terminated with CTRL + X with a following
Y and Enter.
Now the necessary drivers will be downloaded and installed. Therefore,the
Raspberry Pi must be connected with the internet. Enter the following three
commands into the console and confirm them each one of the with Enter.
Commands for the 3.2" LCD:
cd /tmp
wget https://joyiteurope-my.sharepoint.com/:u:/g/personal/
onedrive_joyiteurope_onmicrosoft_com/EZRHk4EMVQZPrF_eEDAmeicBmmRBm7dIXvmvIj
-H5Pt98g?e=RJYLqC
sudo cp joy-IT-Display-Driver-32b-overlay.dtb /boot/overlays/joy-IT-
Display_Driver-32b-overlay.dtbo
Commands for the das 3.5" LCD:
cd /tmp
wget https://joyiteurope-my.sharepoint.com/:u:/g/personal/
onedrive_joyiteurope_onmicrosoft_com/
EUe_jgASjBpHvhoJRUudCIQBh5gyRrnkLm_RQI34fYW1QA?e=mm6VCf
sudo cp joy-IT-Display-Driver-35a-overlay.dtb /boot/overlays/joy-IT-
Display_Driver-35a-overlay.dtbo

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
Then, install teh package for the touch function as well as copy a file:
sudo apt-get install xserver-xorg-input-evdev
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf /
usr/share/X11/xorg.conf.d/45-evdev.conf
Restart the Raspberry Pi:
sudo reboot
5. USAGE OF THE BUTTONS AT THE 3.2"
At the side of 3.2" display ais mounted three buttons.
These can be controlled and used via the GPIO.
If the button is pressed, the signal is pulled to ground (Active_LOW).
The buttons are connected like that:
TFT Raspberry Pi
Key 1 GPIO 12
Key 2 GPIO 16
Key 3 GPIO 18
6. CALIBRATION OF THE TOUCHSCREEN
Calibration of the 3.2" displays:
If a calibration of the touchscreen should be necessary, it can be performed
like in the following steps. First of all, you must download the calibration
tool. Open the terminal and enter the following command:
sudo apt-get install -y xinput-calibrator
Restart the Raspberry Pi, so that the display is identified correctly:
sudo reboot
Now you can start the calibration with the following command:
DISPLAY=:0.0 xinput_calibrator
Four points will be light up aer another which must be pressed to calibrate
the display. Aerwards, the terminal issues four calibration values. To save
the calibration, the adjustment must be saved in a file.
For that create a new folder:
sudo mkdir /etc/X11/xorg.conf.d

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
Create now the file in which the setting will be saved in.
sudo nano /etc/X11/xorg.conf.d/99-calibration.conf
The listing should look like the following (The values aer Calibration can be
dier from yours):
Section "InputClass"
Identifier "calibration"
MatchProduct "ADS7846 Touchscreen"
Option "Calibration" "171 3720 3899 196"
Option "SwapAxes" "0"
EndSection
Calibration of the 3.5" display:
If a calibration of the touchscreen should be necessary, it can be done with
the following steps. First, you have to download the calibration tool. For
that, open the terminal and enter the following command:
sudo apt-get install -y xinput-calibrator
Restart the Raspberry Pi to identify the touchdisplay properly:
sudo reboot
Then, you can start the calibration with the following command:
DISPLAY=:0.0 xinput_calibrator
Now, four points will light up aer another which have to be pressed to
calibrate the display. Aer that, the terminal will issue four values from the
calibration which have to be written in the file 99-calibration.conf .
Therefore, open the file:
sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf
Enter the values in the following line:
Option "Calibration" "215 3947 3901 244"
Thereby, the first value complies with MinX, the second value with MaxX, the
third with MinY and the fourth with MaxY. Aer saving the file and restarting
the device, the new calibration values will be set.

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
7. USE OF LCD AND HDMI AT THE SAME TIME
To output the image signal with the TFT display and with the HDMI output at
the same time, you must perform additional steps. In the first step, the
program Framebuer-Copy must be compiled and installed with the follo-
wing commands.
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
So that the program can start during the ramp-up of the Raspberry Pi, you
must add this in the file /etc/rc.local .
sudo nano /etc/rc.local
Add a new line with the following content in front of the statement exit 0:
fbcp &
Now, you have to add the following text block in /boot/config.txt beneath
the recently added settings. In this file, you can edit the resolution of the
HDMI and the display which is issued by both, by commenting out the
respective threesome pad from hdmi_group, hdmi_mode and hdmi_cvt: (In
the following example is the resolution 800 x 600 set by default)
For 4 : 3 resolution:
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

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
For 16 : 9 resolution:
## 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
################################
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
###############################
As the last step, you must edit the file
/usr/share/X11/xorg.conf.d/99-calibration.conf again. For that, open the file
with the following command:
sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf
Change there the following line …
Option "fbdev" "/dev/fb1"
… , so that fb1 is changed back to its original state fb0(this is mandatory
necessarily for the Framebuer-Copy operation):
Option "fbdev" "/dev/fb0"

www.joy-it.net
Pascalstr. 8 47506 Neukirchen-Vluyn
PR
8. OTHER INFORMATION
Our Information and Take-back Obligations according to the
German Electronic Law (ElektroG)
Symbol on Electrial and Electronic Products:
This crossed-out bin means that electrical and electronic products
do not belong into the household waste. You must hand over your old
appliance to a registration place. Before you can hand over the old
appliance, you must remove used batteries and replacement batteries
which are not enclosed by the device.
Return Options:
As the end user, you can hand over your old appliance (which has
essentially the same functions as the new one bought with us) free of
charge for disposal with the purchase of a new device.
Small devices, which do not have outer dimensions bigger than 25 cm
can be handed in for disposal independently of the
purchase of a new product in normal household quantities.
1. Possibility of return at our company location during our opening hours
Simac Electronics Handel GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn
2. Possibility of return nearby
We will send you a parcel stamp with which you can send us your old
appliance free of charge. For this possibility, please contact us via e-mail
at [e-mail] or via telephone.
Information about Package:
Please package your old appliance safe for transport. Should you not
have suitable packaging material or you do not want to use your own
material, you can contact us and we will send you an appropriate
package.
9. SUPPORT
If any questions remained open or problems may arise aer your
purchase,we are available by e-mail, telephone and ticket
support system to answer these.
E-Mail: [e-mail]
Ticket-system: http://support.joy-it.net
Telephone: [phone] – 66 (10 - 17 o'clock)
For further information visit our website:
www.joy-it.net
Published: 05.12.2019
www.joy-it.net
Simac Electronics Handel GmbH
Pascalstr. 8 47506 Neukirchen-Vluyn