1.9inch Touch LCD

From Waveshare Wiki
Jump to: navigation, search
1.9inch Touch LCD
1.9inch Touch LCD

170×320, I2C / SPI
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

{{{name6}}}

Overview

Introduction

The 1.9inch Touch LCD features a 170 × 320 resolution capacitive touchscreen, supporting either a 12PIN terminal interface or an 18PIN FPC slot for connection. It also provides example documentation for Raspberry Pi, ESP32, Pico, Arduino, etc.

Features

  • 170×320 resolution, 262K RGB colors, clear and colorful displaying effect
  • High touch screen transmittance, fast response and long lifetime
  • Embedded with ST7789V2 driver chip and CST816 capacitive touch control chip, using SPI and I2C communication respectively, minimizes required IO pins
  • Lead out LCD control interface, you can choose 12PIN terminal interface or 18PIN FPC slot access display screen
  • Onboard level conversion chip, supports 3.3V/5V two operating levels

Interfaces

LCD Pin Pin description
VCC Power positive (3.3V / 5V power input)
GND Ground
LCD_DIN SPI communication MOSI pin
LCD_LCK SPI communication SCLK pin
LCD_CS LCD chip select pin, active low
LCD_DC LCD data/command pin, low level indicates command, high level indicates data
LCD_RST LCD reset pin, active low
LCD_BL LCD backlight pin
TP_SDA TP data pin
TP_SCL TP clock pin
TP_RST TP reset pin, active low
TP_IRQ TP interrupt pin

Dimensions

600px-1.9inch-Touch-LCD-details-size.jpg

Specifications

(Please ensure that the supply voltage and logic voltage are consistent, otherwise, it may fail to function properly)

Parameter Name Parameter
Supply voltage 3.3V/5V
LCD type IPS
Communication interface Display: SPI
Touch: I2C
Controller Chip Display: ST7789V2
Touch: CST816
Resolution 170 (H) x 320 (V)


Working with Raspberry Pi

Hardware Connection

  • 12PIN cable connector
LCD Pin Raspberry Pi (BCM)
VCC 3.3V
GND GND
LCD_DIN 10
LCD_CLK 11
LCD_CS 8
LCD_DC 25
LCD_RST 27
LCD_BL 18
TP_SDA 2
TP_SCL 3
TP_IRQ 4
TP_RST 17

Enable SPI and I2C Interfaces

  • Open the Raspberry Pi terminal and enter the following command to enter the configuration interface: 
sudo raspi-config
  • Select Interface Options -> SPI -> Yes to enable the SPI interface

1.47inch Touch LCD Pi 1.png

1.47inch Touch LCD Pi 2.png

1.47inch Touch LCD Pi 3.png

  • Continue to enter the config interface: 
sudo raspi-config
  • Select Interface Options -> I2C -> Yes to enable the I2C interface

1.47inch Touch LCD Pi 4.png

1.47inch Touch LCD Pi 5.png

1.47inch Touch LCD Pi 6.png

  • Restart 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

2.8inch Capacitive Touch LCD RaspberryPi explain 6.png

  • To ensure that SPI is not occupied, it is recommended that other driver overlays be temporarily turned off. You can use ls /dev/spi* to check the SPI occupancy. The terminal output /dev/spidev0.0 and /dev/spidev0.1 indicates that the SPI situation is normal
ls /dev/spi*

1.47inch Touch LCD Pi 7.png

Python Environment

Install Libraries Files

  • 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 apt-get install python3-spidev

Demo Operations

  • Download the demo
cd
wget https://files.waveshare.com/wiki/1.9inch_Touch_LCD/1.9inch_Touch_LCD_Pi.zip
  • Install decompression environment (optional, skip this step if you have used the command to unzip)
sudo apt-get install unzip
  • Enter the file location, and execute the command to unzip
unzip 1.9inch_Touch_LCD_Pi.zip -d ./1.9inch_Touch_LCD
  • Enter Python file folder
cd 1.9inch_Touch_LCD/Python
  • Run the example demo will display 3 images on the screen, and it will then enter the drawing function upon completion
sudo python 1.9inch_Touch_LCD.py

C Environment

Install Libraries Files

  • Install libraries
git clone https://github.com/WiringPi/WiringPi
cd WiringPi
./build
gpio -v
  • Run gpio -v and corresponding version will appear. If it does not appear, there is an installation error.
  • Download the demo file
  • Enter the file directory, and run the demo

Demo Operations

  • Download the demo
cd
wget https://files.waveshare.com/wiki/1.9inch_Touch_LCD/1.9inch_Touch_LCD_Pi.zip
  • Install decompression environment (optional, skip this step if you have used the command to unzip)
sudo apt-get install unzip
  • Enter the file location, and execute the command to unzip
unzip 1.9inch_Touch_LCD_Pi.zip -d ./1.9inch_Touch_LCD
  • Enter C file folder
cd 1.9inch_Touch_LCD/C
  • Clean compilation files and compile again
sudo make clean
sudo make -j
  • Successfully compiled, run the example demo to perform RGB refresh on the screen, and it will then enter the drawing function upon completion
sudo ./main

Working with Raspberry Pi Pico

Hardware Connection

  • 12PIN cable connector
LCD Pin Raspberry Pi Pico
VCC 3.3V
GND GND
LCD_DIN GP11
LCD_CLK GP10
LCD_CS GP9
LCD_DC GP14
LCD_RST GP13
LCD_BL GP15
TP_SDA GP6
TP_SCL GP7
TP_IRQ GP8
TP_RST GP5

Environment Setup

Python Environment Demo

  • Unzip the demo and open Thonny
  • Open the demo, the path is: 1.9inch_Touch_LCD_Pico/Python/1.9inch_Touch_LCD.py

1.9inch Touch LCD Pico 1.png

  • Run the demo to achieve the drawing board function on the screen

1.9inch Touch LCD Pico 2.png

  • If you want to run the demo automatically at power-on, change the file name to main.py

1.9inch Touch LCD Pico 3.png

Working with ESP32

(Please note that the following examples run with ESP32S3, please adjust the pin definition for other ESP32 models)

Hardware Connection

  • 12PIN cable connector
LCD Pin ESP32S3
VCC 3.3V
GND GND
LCD_DIN 2
LCD_CLK 1
LCD_CS 39
LCD_DC 41
LCD_RST 40
LCD_BL 6
TP_SDA 15
TP_SCL 7
TP_IRQ 17
TP_RST 16

Arduino Environment

Download and Install Arduino IDE

  • Click to visit the Arduino official website, select the corresponding system and system bit to download
    ESP32-S3-AMOLED-1.91-Ar-software-01.png
  • Run the installer and install all by default

Install Arduino-ESP32

  • To use ESP32-related motherboards in Arduino IDE, you must first install the Arduino-ESP32 Board library
  • In some areas, it may not be able to Install online due to network factors, and Install offline is generally recommended
  • To install the Arduino-ESP32 tutorial, please refer to Arduino board manager tutorial

Install Library

  • When installing Arduino libraries, there are usually two ways to choose from: Install online and Install offline.
    For most libraries, users can easily search and install them through the online library manager of the Arduino software. However, some open-source libraries or custom libraries are not synchronized to the Arduino Library Manager, so they cannot be acquired through online searches. In this case, users can only manually install these libraries offline.
  • For library installation tutorial, please refer to Arduino library manager tutorial
Library Name Description Version Library Installation Requirement
GFX_Library_for_Arduino LCD driver library --- Install Offline
CST816 Touch driver library --- "Install Offline"
lvgl Graphical library v8.4.0 "Install Offline"

Run the First Arduino Demo

Demo

  • Download the Demo and unzip it

LVGL_Arduino_v8

【Demo description】

This demo demonstrates how to use 1.9inch Touch LCD to run the lvgl demos

【Hardware connection】

  • Connect the board to the computer

【Code analysis】

  • Select the lvgl demos to run
lv_demo_widgets();
// lv_demo_benchmark();
// lv_demo_keypad_encoder();
// lv_demo_music();
// lv_demo_stress();

【Result demonstration】

200px-1.9inch Touch LCD ESP32 1.jpg


ESP-IDF Environment

Environment Setup

Demo

  • Download the Demo and unzip it

lvgl_exampla

【Demo description】

This demo demonstrates how ESP32S3 uses 1.9inch Touch LCD to run the lvgl demo in the ESP-IDF environment

【Hardware connection】

  • Connect the board to the computer

【Code analysis】 

    I2c_bus_init();         // Initialize I2C
    spi_bus_init();         // Initialize SPI
    display_init();          // Initialize display screen
    touch_init();           // Initialize touchscreen driver
    brightness_init();       // Initialize backlight control module
    brightness_set_level(20); // Set the backlight brightness to 20% (support 0-100 level adjustment)
    lv_port_init(); // Initialize LVGL
    if (lvgl_lock(-1)) // Obtain LVGL thread lock (-1 indicates blocking wait) to ensure multi-threaded safety
    {
        // lv_demo_benchmark();
        // lv_demo_music();
        lv_demo_widgets();  // Start LVGL demo
        lvgl_unlock();  // Release LVGL thread lock
    }

【Result demonstration】

200px-1.9inch Touch LCD ESP32 1.jpg


Working with Arduino UNO

Hardware Connection

  • 12PIN cable connector
LCD Pin Arduino
VCC 5V
GND GND
LCD_DIN 11
LCD_CLK 13
LCD_CS 10
LCD_DC 7
LCD_RST 8
LCD_BL 9
TP_SDA SDA
TP_SCL SCL
TP_IQR 3
TP_RST 4

Install Libraries

  • When installing Arduino libraries, there are usually two ways to choose from: Install online and Install offline.
    For most libraries, users can easily search and install them through the online library manager of the Arduino software. However, some open-source libraries or custom libraries are not synchronized to the Arduino Library Manager, so they cannot be acquired through online searches. In this case, users can only manually install these libraries offline.
  • For library installation tutorial, please refer to Arduino library manager tutorial
Library Name Description Library Installation Requirement
GFX_Library_for_Arduino LCD driver library "Install Online" or "Install Offline"
CST816 Touch driver library "Install Offline"

Demo

  • Download the Demo and unzip it
  • Enter the sample demo file 1.9inch_Touch_LCD_Arduino/examplas/1.9inch_Touch_LCD.ino, double click on 1.9inch_Touch_LCD.ino to open the demo

600px-1.9inch Touch LCD Arduino 1.png

  • Select the device and the port, compile and flash the demo

600px-1.9inch Touch LCD Arduino 2.png

  • Successfully flashed, and enter the drawing board function

Resources

Documents

Schematic Diagram

Datasheet

Demo

FAQ

Question: The demo fails to run and cannot communicate?

 Answer:

Please note whether the GPIO level on the board matches the power supply voltage of the product!


Support



Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)

Retrieved from "https://www.waveshare.com/w/index.php?title=1.9inch_Touch_LCD&oldid=100807"