Difference between revisions of "5inch HDMI LCD"

From Waveshare Wiki
Jump to: navigation, search
(Resources)
(3 intermediate revisions by the same user not shown)
Line 12: Line 12:
 
|brand=Waveshare
 
|brand=Waveshare
 
|{{#urlget:amazon|default}}=display
 
|{{#urlget:amazon|default}}=display
|website_cn=[http://www.waveshare.net/ 官方中文站点]
+
|website_cn=[https://www.waveshare.net/shop/5inch-HDMI-LCD.htm 5inch HDMI LCD]
|website_en=[http://www.waveshare.com/ Waveshare website]
+
|website_en=[https://www.waveshare.com/5inch-hdmi-lcd.htm 5inch HDMI LCD]
 
|interface1 =RPi I/Os
 
|interface1 =RPi I/Os
 
|interface2 =HDMI
 
|interface2 =HDMI
Line 19: Line 19:
 
{{Product List|Mini PC/Raspberry Pi/Displays}}
 
{{Product List|Mini PC/Raspberry Pi/Displays}}
 
}}
 
}}
== Introduction ==
+
== '''Introduction''' ==
 
5 inch Resistive Touch Screen LCD, HDMI interface, Designed for Raspberry Pi
 
5 inch Resistive Touch Screen LCD, HDMI interface, Designed for Raspberry Pi
  
 
{{Amazon|{{#urlget:amazon|default}}=display
 
{{Amazon|{{#urlget:amazon|default}}=display
 
|More = [http://www.waveshare.com/5inch-HDMI-LCD.htm More]}}
 
|More = [http://www.waveshare.com/5inch-HDMI-LCD.htm More]}}
 +
 +
=='''Features'''==
 +
*800x480 hardware resolution.
 +
*Resistive touch control.
 +
*It is compatible and can be directly inserted in any version of Raspberry Pi (For the Raspberry Pi 1 B and Raspberry Pi Zero, HDMI cable is required and should be purchase separately).
 +
*Provide driver. (support Raspbian\Ubuntu\Kali and Retropie system).
 +
*Only used for display, does not occupy any I/O resources (using touch function will occupy I/O resources).
 +
*Support backlight control, more power saving.
  
 
==Video==
 
==Video==
Line 29: Line 37:
  
 
{{5inch HDMI LCD User Manual}}
 
{{5inch HDMI LCD User Manual}}
== Resources ==
+
== '''Resources''' ==
 
*[https://www.waveshare.com/w/upload/4/4a/5inch_HDMI_LCD_User_Manual_EN.pdf 5inch HDMI LCD User manual]
 
*[https://www.waveshare.com/w/upload/4/4a/5inch_HDMI_LCD_User_Manual_EN.pdf 5inch HDMI LCD User manual]
 
*[http://www.waveshare.com/w/upload/e/ef/5inch-HDMI-LCD-Bicolor-Holder-LCD-assemble.jpg How to install 5inch Bicolor case]
 
*[http://www.waveshare.com/w/upload/e/ef/5inch-HDMI-LCD-Bicolor-Holder-LCD-assemble.jpg How to install 5inch Bicolor case]
Line 50: Line 58:
 
*[https://www.waveshare.com/w/upload/c/cd/5inch_HDMI_LCD_3D_Drawing.7z 5inch HDMI LCD 3D drawing]
 
*[https://www.waveshare.com/w/upload/c/cd/5inch_HDMI_LCD_3D_Drawing.7z 5inch HDMI LCD 3D drawing]
  
==FAQ==
+
=='''FAQ'''==
 
{{RPI HDMI GPIO LCD FAQ}}
 
{{RPI HDMI GPIO LCD FAQ}}
 
{{FAQ|What are the power requirements?
 
{{FAQ|What are the power requirements?
 
|When working with 5V input, the current is about 235mA with back light on and 45mA with back light off.}}
 
|When working with 5V input, the current is about 235mA with back light on and 45mA with back light off.}}
== Anti-Piracy ==
+
 
 +
== '''Anti-Piracy''' ==
 
{{RPi LCD Anti-Piracy}}
 
{{RPi LCD Anti-Piracy}}
== <font color=red>Beware of knock-offs</font> ==
+
== <font color=red>'''Beware of knock-offs'''</font> ==
 
{{Beware of knock-offs}}
 
{{Beware of knock-offs}}
==Support==
+
=='''Support'''==
{{Service00}}
+
{{Service02}}
  
 
[[Category:OLEDs / LCDs|OLEDs / LCDs]] [[Category:LCD|LCD]] [[Category:Raspberry Pi|Raspberry Pi]] [[Category:Raspberry Pi LCD|Raspberry Pi LCD]]
 
[[Category:OLEDs / LCDs|OLEDs / LCDs]] [[Category:LCD|LCD]] [[Category:Raspberry Pi|Raspberry Pi]] [[Category:Raspberry Pi LCD|Raspberry Pi LCD]]

Revision as of 10:16, 31 July 2020

5inch HDMI LCD
Designed for Raspberry Pi
5inch-HDMI-LCD l.jpg

5 inch Resistive Touch Screen LCD, HDMI interface, Designed for Raspberry Pi
5inch HDMI LCD (with bicolor case)
5inch-HDMI-LCD-Bicolor-Holder-3.jpg

5inch HDMI LCD + Bicolor case
{{{name3}}}

{{{name4}}}

{{{name5}}}

Primary Attribute
Category: OLEDs / LCDs, LCD, Raspberry Pi LCD
{{{userDefinedInfo}}}: 5inch HDMI LCD
Brand: Waveshare
Website
English: 5inch HDMI LCD
Chinese: 5inch HDMI LCD
Onboard Interfaces
RPi I/Os HDMI
Related Products

Introduction

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

More

Features

  • 800x480 hardware resolution.
  • Resistive touch control.
  • It is compatible and can be directly inserted in any version of Raspberry Pi (For the Raspberry Pi 1 B and Raspberry Pi Zero, HDMI cable is required and should be purchase separately).
  • Provide driver. (support Raspbian\Ubuntu\Kali and Retropie system).
  • Only used for display, does not occupy any I/O resources (using touch function will occupy I/O resources).
  • Support backlight control, more power saving.

Video

Getting Started

Hardware Connection

  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.
Hardware connection
Plug the HDMI Connector

Note: This product can only work on a Raspberry Pi but not work on a PC. If the HDMI interface of the LCD is connected to the HDMI interface on a PC, the LCD will not display anything.

Enable touch function

You can enable the touch function in two ways: Method 1. install the driver to your Raspbian/Ubuntu Mate/Kail/Retropie 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/Kail/Retropie 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:

max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 800 480 60 6 0 0 0
hdmi_drive=1

Note: If you use the LCD with Raspberry Pi 4B, you also need to remove or comment out the 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. Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed. The result is that a small area at the border cannot be touched. If you have installed the touch driver but without a network connection, how to solve the problem? See: #Touch screen calibration part.

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

The 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 the 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 a .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/
./LCD5-show 0
  • 90 degree rotation
cd LCD-show/
./LCD5-show 90
  • 180 degree rotation
cd LCD-show/
./LCD5-show 180
  • 270 degree rotation
cd LCD-show/
./LCD5-show 270
If you are using Raspbian-lite, the commands should be
  • 0 degree rotation
cd LCD-show/
./LCD5-show lite 0
  • 90 degree rotation
cd LCD-show/
./LCD5-show lite 90
  • 180 degree rotation
cd LCD-show/
./LCD5-show lite 80
  • 270 degree rotation
cd LCD-show/
./LCD5-show lite 270

Touch screen calibration

If the latest Raspbian OS is in used, you should connect your Pi to the internet and install xserver-xorg-input-evdev.

sudo apt-get install xserver-xorg-input-evdev
  • Just be sure that evdev.conf has a higher number than 40-libinput.conf. For example, rename 10-evdev.conf to 45-evdev.conf. this forces evdev to load after libinput.
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).
/ect/X11/xorg.conf.d/99-calibration.conf
  • Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:

5inch HDMI LCD FAQ1.jpg

Install virtual keyboard

1.Execute the following code to install the corresponding software.

sudo apt-get update
sudo apt-get install matchbox-keyboard
sudo nano /usr/bin/toggle-matchbox-keyboard.sh

2.Copy the following content to toggle-matchbox-keyboard.sh, save and exit.

#!/bin/bash
#This script toggle the virtual keyboard
PID=`pidof matchbox-keyboard`
if [ ! -e $PID ]; then
killall matchbox-keyboard
else
matchbox-keyboard &
fi

3.Execute the following code.

sudo chmod +x /usr/bin/toggle-matchbox-keyboard.sh
sudo mkdir /usr/local/share/applications
sudo nano /usr/local/share/applications/toggle-matchbox-keyboard.desktop

4.Copy the following content to toggle-matchbox-keyboard.desktop, save and exit.

[Desktop Entry]
Name=Toggle Matchbox Keyboard
Comment=Toggle Matchbox Keyboard`
Exec=toggle-matchbox-keyboard.sh
Type=Application
Icon=matchbox-keyboard.png
Categories=Panel;Utility;MB
X-MB-INPUT-MECHANSIM=True

5.Execute the following code, this step must use the "pi" user authority, if you use the administrator authority, the file will not be found.

sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel

6.Find the code similar to the following.(the icon of different versions may be different)

Plugin {
type = launchbar
Config {
Button {
id=lxde-screenlock.desktop
}
Button {
id=lxde-logout.desktop
}
}

7. Add the following code to add a Button item, as shown below.

Button {
id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop
}

RPILCD-INSTALL-KEYBOARD01.png

8. Execute the following code to restart the system, you can see a virtual keyboard icon in the upper left corner of the LCD.

sudo reboot

Interface

PIN NO. SYMBOL DESCRIPTION
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

Resources

Software

Driver

The driver can be downloaded from github

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

Image

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

LCD Panel Dimension

3D drawing

FAQ

Question:
Why does the touchscreen not work well?
Answer:

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


Question:
Why does the image provided on the wiki does not work on my Pi?
Answer:
  • 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 than just copy and paste.
  • When the Raspberry Pi starts normally, the PWR light is always on and the ACT light is blinking. If you find that both lights are always on, it may be that the TF card failed to burn the image or the TF card is in poor contact with the Raspberry Pi.
  • 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.


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


Question:
What is the working temperature of this LCD?
Answer:
The working temperature is 0°C -- 70°C


Question:
What are the power requirements?
Answer:
When working with 5V input, the current is about 235mA with back light on and 45mA with back light off.



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:

RPi-LCD-Anti-Piracy.jpg

(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.

Support

Please contact us by Email/Skype/WeChat for technology support. Because of jet lag, our response may be late, you can just leave your questions, we will reply to you as soon as possible in working time.

Service email.png [email protected]
Service skype.png [email protected]
Service wechat.png Webchat Linzeru.png
Service time.png 09:00 - 18:00 (UTC+8 Monday to Staturday)