1.8" TFT Touch Display RB-TFT1.8-T

1. General Information

Dear customer, thank you for choosing our product. In the following, we will show you what you need to bear in mind during commissioning and use. Should you encounter any unexpected problems during use, please do not hesitate to contact us.

2. Usage with Arduino

2.1 Connection

Since the display operates at a logic level of 3.3 V and the Arduino operates at 5 V, a logic level converter is needed to prevent permanent damage to the display. This example uses two COM-KY051VT converters from Joy-IT. Connect your display as shown in the diagram and table:

Diagram Description: The diagram shows an Arduino board connected to two COM-KY051VT logic level converters, which in turn are connected to the TFT display. Pins are routed between the Arduino, converters, and display, with specific connections detailed in the accompanying table.

2.2 Installation of the required libraries

Search for and install the following libraries in your Arduino IDE's library manager:

• XPT2046_Touchscreen by Paul Stoffregen
• Adafruit BusIO by Adafruit
• Adafruit GFX Library by Adafruit
• Adafruit ST7735 and ST7789 Library by Adafruit

2.3 Sample code

You can download the sample code here.

In the sample code, the display is first filled with the colors black, red, blue, green, and white in sequence. Then, the coordinates of the recognized touch input are output via the serial monitor, and the color on the display is changed.

3. Usage with Raspberry Pi

3.1 Connection

Connect your display as shown in the diagram and table:

Diagram Description: The diagram illustrates a Raspberry Pi board connected directly to the TFT display. Pins are routed between the Raspberry Pi and the display, with specific connections detailed in the accompanying table.

3.2 Installation

The Adafruit_CircuitPython_RGB_Display library from Adafruit is used with the Raspberry Pi, published under the MIT license. First, install pip to perform installations without problems. Execute the following commands in your console:

sudo apt-get install python3-pip

Now activate SPI on your Raspberry Pi. Execute the following command:

sudo raspi-config

Navigate to 3 Interface Options → P4 SPI. Answer the question "Would you like the SPI interface to be enabled?" with <Yes> to activate SPI.

Now change the configuration file of the Raspberry Pi OS with the following command:

sudo nano /boot/firmware/config.txt

Add the following line at the end of the file:

dtoverlay=spi0-0cs

Save with CTRL+S and close the window with CTRL+X.

Then restart your Raspberry Pi with the following command:

sudo reboot

3.3 Code example

Sample code is provided to display an image on the screen. First, download the following file:

wget https://www.joy-it.net/public/RB-TFT1.8-T_Codeexample_RaspberryPi.zip

Unzip the file using the following command. Ensure you are in the correct file path:

unzip RB-TFT1.8-T_Codeexample_RaspberryPi.zip

Navigate to the code example folder:

cd RB-TFT1.8-T_Codeexample_RaspberryPi

Install the following dependency:

sudo apt-get install fonts-dejavu

Activate a virtual environment:

python -m venv --system-site-packages env

source env/bin/activate

Install the remaining libraries in the virtual environment:

pip3 install adafruit-circuitpython-rgb-display

pip3 install Pillow

Execute the code:

python3 RB-TFT1.8-T.py

Your display should now show an image and output the coordinates of the recognized touch input via the console. If the image displayed is shifted (a pixel border is visible), you can use x_offset and y_offset in line 43 to adjust the software for correct display.

3. Other Information

Information and take-back obligations according to the Electrical and Electronic Equipment Act (ElektroG):

Symbol on electrical and electronic equipment: ?️ (Crossed-out dustbin symbol) means that electrical and electronic appliances do not belong in household waste. Old appliances must be returned to a collection point. Waste batteries and accumulators not enclosed by waste equipment must be separated before handover.

Return options:

• As an end user, you can return your old device (fulfilling the same function as the new device purchased) free of charge for disposal when purchasing a new device.
• Small appliances with no external dimensions greater than 25 cm can be disposed of in normal household quantities independently of the purchase of a new appliance.

Possibility of return at company location during opening hours: SIMAC Electronics GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn, Germany.

Possibility of return in your area: Contact Service@joy-it.net by e-mail or by telephone to receive a parcel stamp for free return shipping.

Information on packaging: If you do not have suitable packaging material, please contact Joy-IT for suitable packaging.

4. Support

If you have any questions or encounter problems after your purchase, Joy-IT is available by e-mail, telephone, and ticket support system.

• E-Mail: service@joy-it.net
• Ticket-System: http://support.joy-it.net
• Telephone: +49 (0)2845 9360 – 50

For further information, visit the website: www.joy-it.net