JOY-iT SBC-LCD01 1.3 Inch HD-IPS-TFT-LCD Display Instruction Manual
- June 6, 2024
- JOY-It
Table of Contents
- JOY-iT SBC-LCD01 1.3 Inch HD-IPS-TFT-LCD Display
- GENERAL INFORMATION
- USAGE WITH THE NODEMCU
- USAGE WITH THE RASPBERRY PI
- ifndef DISPLAY_SPI_DRIVE_SETTINGS
- define DISPLAY_SPI_DRIVE_SETTINGS (1 | BCM2835_SPI0_CS_CPOL |
- FURTHER INFORMATION
- SUPPORT
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
JOY-iT SBC-LCD01 1.3 Inch HD-IPS-TFT-LCD Display
GENERAL INFORMATION
Dear customer,
thank you for choosing our product. In the following, we will show you how to
use this device.
Should you encounter any unexpected problems during use, please do not
hesitate to contact us.
Note that before you can use the display, you must solder the pin header!
USAGE WITH THE NODEMCU
Connection
NodeMCU | LCD |
---|---|
D1 (GPIO 5) | DC |
D2 (GPIO 4) | RES |
D5 (SCLK) | SCL |
D7 (MOSI) | SDA |
G | GND |
3V | VCC |
Code example
The SBC-LCD01 has a logic level of 3.3V, making a NodeMCU recommended for this
application. To use a NodeMCU with the Arduino IDE, you must first add the
board. To do this click on File → Preferences. There you add the following
link Additional board administrator URLs.
http://arduino.esp8266.com/stable/package_esp8266com_index.json
Now you can download the library in the Arduino IDE. There you go to the
library manager, which you can find under Sketch → Include library … → Manage
libraries …. There you install Adafruit ST7735 and ST7789 Library and the
Adafruit GFX Library using the search bar. Now you can download a sample code
here, where an image is displayed on the screen.
Make sure that you select the NodeMCU as board also under Tools, as well as
the correct port.
Please note, if you want to upload the code, you have to keep the flash button pressed!
USAGE WITH THE RASPBERRY PI
Connection
Raspberry Pi | LCD |
---|
Pin 22
(GPIO 25)
| DC
Pin 13
(GPIO 27)
| RES
Pin 23 (SCLK)| SCL
Pin 19 (MOSI)| SDA
GND| GND
3, 3 V| VCC
Pin 12
(GPIO 18)
| BLK
Code example with SPI
We offer you two sample codes for the Raspberry Pi. One is a control via SPI
and the other one via a frame buffer. In this part the operation via SPI is
explained.
First enter the following command to enable SPI on your Raspberry Pi.
sudo raspi-config
There you activate SPI under 5 Interfacing Options → P4 SPI. Then run the
following command to restart the Raspberry Pi to put the changes into effect.
sudo reboot
For this code example we use the library RPI ST7789, which was publis-hed under the MIT Lizenz. To do this, insert the following commands one after the other to successfully install the library.
sudo apt-get update
sudo apt-get install python3-rpi.gpio python3-spidev python3-pip python3-pil
python3-numpy git clone https://github.com/rusconi/Rpi-ST7789.git
cd Rpi-ST7789
sudo python3 setup.py install
Now you have successfully downloaded the library. You can download the sample
code here or use the following command to download it di-rectly to your
Raspberry Pi.
wget https://joy-it.net/files/files/Produkte/SBC-LCD01/SBC-LCD01-Python.zip
You must download this file to have the image file on your Raspberry Pi. Now you can execute the following commands to project the image file on your LCD.
unzip SBC-LCD01-Python
cd SBC-LCD01-Python
sudo python3 image.py Joy-IT-240×240.png
In the following you will additionally find our code:
Use with a Framebuffer
We explain here how to set up the frame buffer fbcp-ili9341 to use it with
this LCD screen. This library was published under the MIT-Lizenz.
You must first deactivate SPI, if you have activated it earlier. Therefore, go
back to the configuration of the Raspberry Pi.
sudo raspi-config
There you deactivate SPI under 5 Interfacing Options → P4 SPI. Now you have to
edit the config.txt and comment out a command. You open the config.txt with :
sudo nano /boot/config.txt
There you remove the hash at hdmi_force_hotplug=1. You can save with CTRL + O
and leave the editor with CTRL + X. Now you must restart the Raspberry Pi with
the following command.
sudo reboot
Now you can install fbcp-ili9341 by executing the following commands one after
the other:
sudo apt-get install cmake cd ~
git clone clone https://github.com/juj/fbcp-ili9341.git
cd fbcp-ili3941
mkdir build
You must edit the display.h before continuing with the setup. Therefore, open
the display.h with the following command:
sudo nano display.h
There you exchange line 83 #define DISPLAY_SPI_DRIVE_SETTINGS (0) with #define DISPLAY_SPI_DRIVE_SETTINGS (1 | BCM2835_SPI0_CS_CPOL | BCM2835_SPI0_CS_CPHA)
ifndef DISPLAY_SPI_DRIVE_SETTINGS
define DISPLAY_SPI_DRIVE_SETTINGS (1 | BCM2835_SPI0_CS_CPOL |
BCM2835_SPI0_CS_CPHA) #endif
You save again with CTRL + O and leave the editor with CTRL + X. You can now continue with the setup by executing the following commands one after the other.
cd build
cmake -DST7789VW=ON -DGPIO_TFT_DATA_CONTROL=25 -DGPIO_TFT_RESET_PIN=27
-DGPIO_TFT_BACKLIGHT=18 -DSPI_BUS_CLOCK_DIVISOR=8 -DBACKLIGHT_CONTROL=ON ..
make -j
sudo ./fbcp-ili9341
Now you will see your desktop on your 1.3″ display.
FURTHER INFORMATION
Our information and redemption obligation according to the Electrical and Electronic Equipment Act (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 office. Before you can hand over the old appliance, you must
remove used batteries and accumulators which are not enclosed by the device.
Return options :
As the end user, you can hand over with the purchase of a new device your old
appliance (which has essentially the same functions as the new one) free of
charge for disposal. Small devices which do not have outer dimensions greater
than 25 cm can be submitted independently of the purchase of a new product in
normal household quantities.
Possibility of restitution at our company location during our opening
hours:
Simac GmbH, Pascalstr. 8, D-47506 Neukirchen-Vluyn
Possibility of restitution nearby :
We send you a parcel stamp with which you can send us your old appliance free
of charge. For this possibility, you must contact us via e-mail at service
@joy-it.net or via telephone.
Information about packaging:
Please package your old appliance safe during transport. Should you not have a
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.
SUPPORT
If any questions remain open or problems arise after your purchase, we are
available by email, telephone and ticket support system to answer these.
E-Mail: service@joy-it.net
Ticket-System: http://support.joy-it.net
Telephone: +49 (0)2845 98469 – 66 (10 – 17 o‘clock)
For more information visit our website: www.joy-it.net
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>