Difference between revisions of "7inch HDMI LCD"

From Waveshare Wiki
Jump to: navigation, search
Line 19: Line 19:
|More = [http://www.waveshare.com/7inch-hdmi-lcd.htm More]}}
|More = [http://www.waveshare.com/7inch-hdmi-lcd.htm More]}}
<!--{{7inch HDMI LCD User Manual}}-->
{{7inch HDMI LCD User Manual}}
== Resources ==
== Resources ==
===User Manual===
===User Manual===

Latest revision as of 10:39, 13 July 2019

7inch HDMI LCD

7inch Resistive Touch Screen LCD, HDMI interface, Designed for Raspberry Pi




Primary Attribute
Category: OLEDs / LCDs, LCD, Raspberry Pi LCD
{{{userDefinedInfo}}}: {{{userdefinedvalue}}}
Brand: Waveshare
English: Website
Chinese: 官网
Onboard Interfaces
Related Products


7inch Resistive Touch Screen LCD, HDMI interface, Designed for Raspberry Pi


Button description

7inch HDMI LCD APP02.png

Power: Turn on or turn off the LCD screen.

Menu: Open the OSD menu (when using the menu, this button can be served as Confirm)

Up/Left: Direction button.

Down/Right: Direction button.

Return: Close the OSD menu.

  • If the LCD is not in use for a long time, you can press the Power button to turn off the LCD and lower the power consumption.
  • You can press the Menu button to open the OSD menu as the figure shown, then press the direction button to select. Some of the options are reserved and without any effect, e.g. in fact the Volume option won't affect the volume.

7inch HDMI LCD APP01.png

Getting Started

Hardware Connection

Hardware connection for Raspberry Pi Model A+/B+/2 B/3 B
Plug the HDMI Connector
  1. Plug the LCD to your Raspberry Pi:
    • There are 40 pins on Raspberry Pi Model A+/B+/2 B/3 B but only 26 pins on the LCD, so you should pay attention to connecting the pins to your Pi accordingly.
  2. Connect the HDMI Connector to both the HDMI interfaces on the LCD and the Pi.
    • You should connect the LCD to Raspberry Pi Model B or Raspberry Pi Zero with an HDMI cable rather than an HDMI Connector.
  3. Turn on the "backlight" switch on the back of the LCD.

You can enable the touch in two ways: Method 1. install driver to your Raspbian/Ubuntu Mate OS. Method 2. use the Ready-to-use image file of which LCD driver was pre-installed.

Method 1. Driver installation

Description: The driver can be downloaded from github

git clone https://github.com/waveshare/LCD-show.git

1) Download the Raspbian / Ubuntu Mate image from Raspberry Pi website and extract it on a PC.

2) Connect your micro SD card to the PC and write the image to the card using Win32DiskImager. How to write an image to a micro SD card for your Pi? See RPi Image Installation Guides for more details)

3) Copy the LCD driver to the micro SD card (or copy the driver to the system of Pi using a USB drive).

4) Append the following lines to the config.txt file which is located in the root of the card:

hdmi_cvt 1024 600 60 6 0 0 0

If you use the LCD with Raspberry Pi 4B, you need to remove line dtoverlay=vc4-fkms-V3D from config.txt file

5) The LCD will display after booting up. Then open a terminal to install the touch driver which can be found in the /boot/ directory.

git clone https://github.com/waveshare/LCD-show.git 
cd LCD-show/
chmod +x LCD7-1024x600-show

Touch function will work after restart. For ease of use, you can set the screen orientation, see: #Screen orientation settings.

Method 2. Using Ready-to-use image

The image file with pre-installed driver is located in the IMAGE directory of the CD, or you can download it from #Image. Extract the .7z file and you will get an .img file. Write the image to your micro SD card (How to write an image to a micro SD card for your Pi? See RPi Image Installation Guides for more details). Then insert the card to your Pi, power up and enjoy it.

Screen orientation settings

After touch driver installed, the screen orientation can be set by these commands:

  • 0 degree rotation
cd LCD-show/
./LCD7-1024x600-show 0
  • 90 degree rotation
cd LCD-show/
./LCD7-1024x600-show 90
  • 180 degree rotation
cd LCD-show/
./LCD7-1024x600-show 180
  • 270 degree rotation
cd LCD-show/
./LCD7-1024x600-show 270

Touch screen calibration

  • Install the X server first
sudo apt-get install xserver-xorg-input-evdev
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf /usr/share/X11/xorg.conf.d/45-evdev.conf
sudo reboot
  • This LCD can be calibrated using a program called xinput_calibrator which can be downloaded from Xinput-calibrator_0.7.5-1_armhf
  • Extract and copy the software Xinput-calibrator_0.7.5-1_armhf.deb to the Raspbian of your Pi.
  • Install it with the commands:
sudo dpkg -i -B xinput-calibrator_0.7.5-1_armhf.deb 
  • Click the "Menu" button on the task bar, choose "Preference" -> "Calibrate Touchscreen".
  • Finish the touch calibration following the prompts. Maybe rebooting is required to make calibration active.
  • You can create a 99-calibration.conf file to save the touch parameters (not necessary if file exists).
  • Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:

5inch HDMI LCD FAQ1.jpg

Right click emulation

  • Edit the 99-calibration.conf file.
sudo nano /etc/X11/xorg.conf.d/99-calibration.conf
  • Append the following lines between "Section" and "EndSection":
Option "EmulateThirdButton" "1"
Option "EmulateThirdButtonTimeout" "750"
Option "EmulateThirdButtonMoveThreshold" "100"


  • Exit with save and reboot the system.


Display images on Linux console

  • Install the fbi software.
sudo apt-get install fbi
  • Save image files to a specified direction (/dev/fb0 for example) and display them with:
fbi -T 2 -d /dev/fb0 -noverbose -a XXX.jpg

Play videos

  • Install the mplayer software.
sudo apt-get install mplayer
  • Save video files to the current directory and you can play them with:
mplayer XXX.mp4


1, 17 3.3V Power positive (3.3V power input)
2, 4 5V Power positive (5V power input)
3, 5, 7, 8, 10, 11, 12, 13, 15, 16, 18, 24 NC NC
6, 9, 14, 20, 25 GND Ground
19 TP_SI SPI data input of Touch Panel
21 TP_SO SPI data output of Touch Panel
22 TP_IRQ Touch Panel interrupt, low level while the Touch Panel detects touching
23 TP_SCK SPI clock of Touch Panel
26 TP_CS Touch Panel chip selection, low active


User Manual

Related Software


The driver can be downloaded from github

git clone https://github.com/waveshare/LCD-show.git


Description: if you felt hard to install driver, try the image with driver pre-installed.

LCD Panel Dimension


Why does the touchscreen not work well?

Now, we only provide touch screen drivers for Raspbian and Ubuntu Mate. How to install the driver? See:#Method_1._Driver_installation

Why does the image provided on wiki does not work on my Pi?
  • The image provided may differ depending on batches, however, some Images are just available for Pi 2 (or before, but not for Pi 3). In such cases you can download the latest version from Raspberry Pi website and install the driver. See:#Method_1._Driver_installation
  • Make sure the hardware connection is correct and connects fine.
  • Make sure you've written the image to your SD card using the software File:Win32DiskImager.zip rather then just copy and paste.
  • It is strongly recommended to use a stand-alone 5V/3A power adapter, because the USB port of PC might not have enough power to support the Pi and LCD.

Could I only connect the HDMI cable?
No, the HDMI interface is only used for display. You also need to inserted the GPIO for touching and power. BTW, you can also connect external power adapter to USB interface for power if LCD has external power interface.

What is working temperature of this LCD?
The working temperature is 0°C -- 70°C

What are the power requirements?
When working with 5V input, the current is about 200mA with back light on and 30mA with back light off.


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:


(Click to enlarge)

Beware of knock-offs

Please note that we've found some poor copies of this item in the market. They are usually made of inferior materials and shipped without any testing.

You might be wondering if the one you're watching or you've purchased in other non-official stores is original, feel free to contact us.


Mail.png Contact your seller (fast response and most recommended)

or send emails to [email protected] (not fast enough but please be patient) for help.

Our working time: 09:00-18:00 (UTC+8 Monday to Saturday)