Introduction

Working with PC

Turn on the "backlight" switch then connect the LCD to your PC (USB Port of LCD -> USB Port of PC; HDMI Port of LCD -> HDMI Port of PC. Please first connect the USB Ports then connect the HDMI Port). A new touch drive will be recognized by Windows and you can use the LCD as a human interface device. When multiple displays are detected by your PC, the LCD can only be used to control the cursor on main display. So it is proposed to set the LCD as the main display.

Working with Raspberry Pi

For the Windows OS on PC, the resolution of the LCD is automatically identified. Hence, you do not need to make the relative settings. When working with Raspberry Pi, you should set the resolution of the LCD by yourself, or else the LCD screen will not work. For more detail information, please read the following section.

Turn on the "backlight" switch then connect the LCD to your Pi (HDMI Port of LCD -> HDMI Port of Pi; USB Port of LCD -> USB Port of Pi; 5V~2A power supply). Download the Raspbian image from Raspberry Pi web site. Write the image to a TF card and append the following lines to the config.txt file which is located in the root of your TF card:

This LCD can be calibrated using a program called xinput_calibrator and you should get and install the program manually with

sudo apt-get install -y xinput-calibrator

Enter the following commands for touch screen calibration:

sudo DISPLAY=:0.0 xinput_calibrator

or select Menu -> Preferences -> Calibrate Touchscreen.

After running these commands, there will be a prompt for four-point calibration shown in the LCD screen. Click the points one by one to finish the touch calibration. Then, the new calibration data will be displayed in the terminal, as shows below. Please get these data for future use.

Press the keys Ctrl+X, and select the option Y to save the modification.

The modification will be valid after rebooting the system. Enter the following command for system reboot:

sudo reboot

About LCD revision

An LCD with Rev 2.1 firmware does not require any drivers, that is, touch function works properly without installing any software. So we did not provide any drivers and images for Rev 2.1 LCDs. The following drivers are only available for the LCD with Rev 1.1 firmware. But if you install the driver for the Rev 2.1 one, it will lead touch function not to work.

Rev2.1 New Features

Standard HID protocol, easy to be integrated into your system.

For the Raspberry Pi, supports Raspbian, Ubuntu Mate, single touch, and driver free.

When work as a computer monitor, supports Windows 10/8.1/8/7, single points touch, and driver free.

Rev1.1 and before

For the Raspberry Pi, comes with Raspbian driver (works with your Raspbian directly), and Ubuntu image

When work as a computer monitor, touch function is unavailable

How to distinguish

Generally speaking, a LCD shipped after June 2016 is often a Rev 2.1 one.

Note:
The only difference between Rev 1.1 and Rev 2.1 is the firmware, but hardware solutions, placement and routing are all the same. (PCB printings might be different due to different production batches.)

You can verify the firmware by these steps:

1. Using Raspberry Pi: Connect the LCD to your Pi (HDMI Port of LCD -> HDMI Port of Pi; USB Port of LCD -> USB Port of Pi; 5V~2A power supply). Download the image, e.g. Raspbian 2015-11-21 jessie or Raspbian 2015-05-05 wheezy, from Raspberry Pi web site. Write the image to a TF card and add the following code to the end of /boot/config.txt:

You must make sure that there are no spaces on either side of the equal sign.

Save and connect the TF card to your Pi then power up. If touch works, that means the firmware revision is Rev 2.1.

2. Without Raspberry Pi: A PC (Windows 10/8.1/8/7) is required which cannot connect with other display device. Connect the LCD to your PC (USB Port of LCD -> USB Port of PC; HDMI Port of LCD -> HDMI Port of PC. Please first connect the USB Ports then connect the HDMI Port). If a new touch drive is recognized by Windows, that means the firmware revision is Rev 2.1. In this case, after the driver successfully installed, you can use the LCD as a human interface device.

Detailed information

Depending on the firmware, please view the instructions of different revision:

Resources

An LCD with Rev 2.1 firmware does not require any drivers, that is, touch function works properly without installing any software. So we did not provide any drivers and images for Rev 2.1 LCDs. The following drivers are only available for the LCD with Rev 1.1 firmware. But if you install the driver for the Rev 2.1 one, it will lead touch function not to work.

LCD Panel Dimension

Anti-Piracy

Since the first-generation Raspberry Pi released, Waveshare has been working on designing, developing, and producing various fantastic touch LCDs for the Pi. Unfortunately, there are quite a few pirated/knock-off products in the market. They're usually some poor copies of our early hardware revisions, and comes with none support service.

To avoid becoming a victim of pirated products, please pay attention to the following features when purchasing: