Parameters

(Please make sure the power supply voltage and logic voltage are the same, otherwise it will not work properly.)

Interface Description

• 13PIN connector:

• 18PIN FPC slot:

Working with Raspberry Pi

Please note that the following example is run on Raspberry Pi 4.

Hardware Connection

• 13PIN connector:

Enable SPI & I2C Interface

• Open the Raspberry Pi terminal and input the following commands to enter the config interface:
  

sudo raspi-config

• Select "Interfacing Options -> SPI -> Yes" to enable the SPI interface.

• Continue to enter the config interface:
  

sudo raspi-config

• Select "Interfacing Options -> I2C -> Yes" to enable the I2C interface:

• Reboot the Raspberry Pi:
  

sudo reboot

• Check /boot/config.txt, you can see 'dtparam=i2c_arm=on' and 'dtparam=spi=on' are written.
  

more  /boot/config.txt

• To ensure SPI is not occupied, it is recommended to disable other drivers. You can use "ls /dev/spi*" to check whether SPI is occupied, and when the terminal outputs "/dev/spidev0.0" and "/dev/spidev0.1", SPI works normally.

ls /dev/spi* 

Python Environment Usage

Install Libraries

• Install libraries:

sudo apt-get update
sudo apt-get install python3-pip
sudo apt-get install python3-pil
sudo apt-get install python3-numpy
sudo pip3 install spidev
sudo pip3 install Pillow

Examples

• Download the following demos:

cd
wget https://files.waveshare.com/wiki/2.8inch-Capacitive-Touch-LCD/2.8inch_Capacitive_Touch_LCD_RaspberryPi.zip

• Install unzip environment (optional, skip this step if using the command to unzip):

sudo apt-get install unzip

• Enter the file location, and execute the command to unzip:

unzip 2.8inch_Capacitive_Touch_LCD_RaspberryPi.zip -d ./2.8inch_Capacitive_Touch_LCD

• Enter Python file folder:

cd 2.8inch_Capacitive_Touch_LCD/Python

• Run the sample demo and you can see the LCD displays three pictures, and then input:

sudo python 2inch8_LCD_test.py

Usage in C Environment

Install Libraries

• Install libraries:

git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v

• Run "gpio -v" to check whether it is 2.70 version, if not, the installation fails.
• Download example files.
• Enter the file directory, and run the demo.

Example Operation

• Download the sample demo:

cd
wget https://files.waveshare.com/wiki/2.8inch-Capacitive-Touch-LCD/2.8inch_Capacitive_Touch_LCD_RaspberryPi.zip

• Install unzip environment (optional, skip this step if using the command to unzip):

sudo apt-get install unzip

• Enter the file location, and execute the command to unzip:

unzip 2.8inch_Capacitive_Touch_LCD_RaspberryPi.zip -d ./2.8inch_Capacitive_Touch_LCD

• Enter C file folder:

cd 2.8inch_Capacitive_Touch_LCD/C

• Clean compilation files and compile again:

sudo make clean
sudo make -j

• Run the sample demo and you can see the LCD displays three pictures, and then input:

sudo ./main

Working with Raspberry Pi Pico

Hardware Connection

• 13PIN header:

Python Environment

Preparation

1. Install Thonny. (Thonny Python IDE (Windows V3.3.3))
2. Press the "BOOTSEL" key on the Raspberry Pi Pico, and release it after powering.
3. A new disk will appear on your computer, extract the Raspberry Pi Pico firmware and copy the firmware (suffix uf2) to that disk (the disk will automatically disappear if the copy is successful).
4. Open Thonny, click on "Python x.x.x" at the bottom right, and select "Configure interpreter".
5. Select "Interpreter" in the pop-up window -> select "MicroPython (Raspberry Pi Pico)" as the interpreter -> select "Auto-detect port" as the port.
6. Click on "Stop", and the Shell window will show "MicroPython v1.20.0-50-g786013d46 on 2023-05-04; Raspberry Pi Pico with RP2040 Type "help()" for more information. " is a successful connection.

The following is the procedure for points 4 and 5:

The successful connection is shown below:

Sample Demo

• Download the sample demo.
• Unzip the sample demo and open Thonny.
• Enter the sample file folder and open "RaspberryPi_Pico/Python" file folder.
• Upload the " LCD_2inch8_Touch.py" file to "Raspberry Pi Pico".

• Open the uploaded file:

• Run the demo to realize touchpad functions:

• Please modify the file name "LCD_2inch8_Touch.py" as "main.py " if you want the demo to automatically run after powering on.

Working with ESP32S3

Please note that the following examples use firmware version 2.0.11. Higher versions may cause the functions to be incompatible and fail to display.

Hardware Connection

• 13PIN connector:

Environment Set-up

• Install Arduino IDE.

• Enter Arduino IDE after installation.

• Go to the board manager, search for esp32, select the latest version of esp32 by Espressif Systems at the bottom, and click install (if it doesn't install correctly, you can try using a phone hotspot).

• Restart the Arduino IDE after installation, and then you can use it.

Install Libraries

• Please note whether the library has been previously installed, if so, please save the original library to prevent errors and failures when running other programs.
• Enter "2.8inch_Capacitive_Touch_LCD\ESP32S3\LVGL_Arduino" file folder, double-click LVGL_Arduino.ino to open the example.
• Search the lvgl library and install it (this step is for setting the library file folder in Arduino environment, if you have installed other libraries (the following file folders exist), you do not need to execute this step.)

• Enter the storage path of the library file: "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" ("Waveshare" is the computer username).

• Delete the lvgl library downloaded before (skip this step if not installed):

• Install two libraries in the sample file.
• Copy the provided library to "c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries" ("Waveshare" is the computer username):

• Finish library installation.

Sample Demo

• Open the sample demo again.
• Select the model and COM port, compile and program the sample.

• Three operation interfaces can be observed after successful programming.

Working with Arduino

Hardware Connection

• 13PIN connector:

Sample Demo

• Download and unzip sample demo.
• Enter the sample demo file folder "2.8inch_Capacitive_Touch_LCD\Arduino\LCD_2inch8_Touch", double click on LCD_2inch8_Touch.ino to open the sample:

• Select the device and the port, compile and program the demo:

Resource

Document

Schematic

• Schematic

Datasheet

• ST7789T3 Datasheet

Drawing

• 2.8inch Capacitive Touch LCD 3D Drawing
• 2.8inch Capacitive Touch LCD 2D Drawing

Demo

• Sample Demo

FAQ

Support

To：

Dear Customers, There may be a lag of several hours before we could process your order, depending on the time difference between your location and ours. Sincerely hoping your understanding!

Email(support)

services01@spotpear.com