Difference between revisions of "4inch RPi LCD (C)"

From Waveshare Wiki
Jump to: navigation, search
m (Text replacement - "http://www.waveshare.com/w/upload/" to "https://files.waveshare.com/upload/")
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
<div class="wiki-pages jet-green-color">
 
<div class="wiki-pages jet-green-color">
 
{{Infobox item
 
{{Infobox item
−
|img=[[File:4inch-RPi-LCD-C-1.jpg|300px |alt=4inch-RPi-LCD-C-1.jpg|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=http://www.waveshare.com/4inch-RPi-LCD-C.htm}} | 4inch RPi LCD (C)]]
+
|img=[[File:4inch-RPi-LCD-C-1.jpg|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=http://www.waveshare.com/4inch-RPi-LCD-C.htm?amazon}} | 4inch RPi LCD (C)]]
 
|caption=4 inch Touch Screen TFT LCD Designed for Raspberry Pi
 
|caption=4 inch Touch Screen TFT LCD Designed for Raspberry Pi
 
|platform=Raspberry Pi
 
|platform=Raspberry Pi
Line 13: Line 13:
 
{{Product List|Mini PC/Raspberry Pi/Displays}}
 
{{Product List|Mini PC/Raspberry Pi/Displays}}
 
}}
 
}}
−
=Overview=
+
='''Overview'''=
 
== '''Introduction''' ==
 
== '''Introduction''' ==
 
4 inch Touch Screen TFT LCD Designed for Raspberry Pi, High-Speed SPI transmission.
 
4 inch Touch Screen TFT LCD Designed for Raspberry Pi, High-Speed SPI transmission.
  
 
== '''Features''' ==
 
== '''Features''' ==
−
* The hardware resolution is 480×320.
+
* The hardware resolution is 480 × 320.
 
* Resistive touch control.
 
* Resistive touch control.
−
* It is compatible and can be directly inserted in any version of Raspberry Pi.
+
* It is compatible and can be directly inserted into any version of Raspberry Pi.
 
* Support 125MHz high-speed SPI signal transmission, which makes the screen display clear and stable.
 
* Support 125MHz high-speed SPI signal transmission, which makes the screen display clear and stable.
−
* Provides drivers(works with your own Raspbian/Ubuntu/Kali and Retropie system directly).
+
* Provides drivers (works with your own Raspbian/Ubuntu/Kali and Retropie system directly).
−
* Support FBCP software driver, which can set the software resolution and dual screen display.
+
* Support FBCP software driver, which can set the software resolution and dual-screen display.
−
* Gold sinking process, fine carving.
+
* Immersion gold design, fine carving.
 +
<!--
 
{{RPi LCD User Manual}}
 
{{RPi LCD User Manual}}
 +
-->
 +
 +
== '''Getting Started''' ==
 +
=== Hardware Connection ===
 +
* There are 40 pins on Raspberry Pi, but there are 26 pins on the LCD, so you should pay attention to connecting the pins to your Pi accordingly.
 +
 +
===Install the touch driver===
 +
The RPi LCD can be driven in two ways: <br/>
 +
Method 1. Install a driver to your Raspbian OS. <br/>
 +
Method 2. Use the Ready-to-use image file of which the LCD driver was pre-installed.
 +
 +
''' Method 1. Driver installation'''
 +
 +
Please download the latest version of the image on the [https://www.raspberrypi.org/downloads/ Raspberry Pi official website.] (Raspbian/Ubuntu Mate/Kali or Retropie)
 +
 +
1) Download the compressed image file to the PC, and unzip it to get the .img file.
 +
 +
2) Connect the TF card to the PC, open the [https://files.waveshare.com/upload/7/76/Win32DiskImager.zip Win32DiskImager] software, select the system image downloaded in step 1, and click 'Write' to write the system image. ( How to write an image to a micro SD card for your Pi? See [[RPi-Image-Installation-Guides|RPi Image Installation Guides]] for more details)
 +
 +
3) Connect the TF card to the Raspberry Pi, and start the Raspberry Pi. The LCD will display after booting up, and then log in to the Raspberry Pi terminal,(You may need to connect a keyboard and HDMI LCD to Pi for driver installation, or log in remotely with SSH)
 +
 +
4) Then open the terminal of Raspberry Pi to install the touch driver.
 +
<pre>
 +
git clone https://github.com/waveshare/LCD-show.git
 +
cd LCD-show/
 +
</pre>
 +
'''Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed.'''
 +
 +
{{#switch: {{FULLPAGENAME}}
 +
| 2.8inch RPi LCD (A) =
 +
<pre>
 +
chmod +x LCD28-show
 +
If it is an old version, execute the following code:
 +
sudo ./LCD28-show
 +
If it is a new version, execute the following code:
 +
sudo ./LCD28-show-V2
 +
</pre>
 +
| 3.2inch RPi LCD (B) =
 +
<pre>
 +
chmod +x LCD32-show
 +
./LCD32-show
 +
</pre>
 +
| 3.2inch RPi LCD (C) =
 +
<pre>
 +
chmod +x LCD32C-show
 +
./LCD32C-show
 +
</pre>
 +
| 3.5inch RPi LCD (A) =
 +
<pre>
 +
chmod +x LCD35-show
 +
./LCD35-show
 +
</pre>
 +
| 3.5inch RPi LCD (B) =
 +
<pre>
 +
#if old version, use this command:
 +
chmod +x LCD35B-show
 +
./LCD35B-show
 +
</pre>
 +
 +
<pre>
 +
#if new version, use this command:
 +
chmod +x LCD35B-show-V2
 +
./LCD35B-show-V2
 +
</pre>
 +
| 3.5inch RPi LCD (C) =
 +
<pre>
 +
chmod +x LCD35C-show
 +
./LCD35C-show
 +
</pre>
 +
| 4inch RPi LCD (A) =
 +
<pre>
 +
chmod +x LCD4-show
 +
./LCD4-show
 +
</pre>
 +
| 4inch RPi LCD (C) =
 +
<pre>
 +
chmod +x LCD4C-show
 +
./LCD4C-show
 +
</pre>
 +
| #default =
 +
* For 2.8inch RPi LCD (A):
 +
./LCD28-show
 +
* For 3.2inch RPi LCD (B):
 +
./LCD32-show
 +
* For 3.2inch RPi LCD (C):
 +
./LCD32C-show
 +
* For 3.5inch RPi LCD (A):
 +
./LCD35-show
 +
* For 3.5inch RPi LCD (B):
 +
./LCD35B-show
 +
* For 3.5inch RPi LCD (C):
 +
./LCD35C-show
 +
* For 4inch RPi LCD (A):
 +
./LCD4-show
 +
* For 4inch RPi LCD (C):
 +
./LCD4C-show
 +
}}
 +
 +
The touch function will work after restart. For ease of use, you can set the screen orientation, see: [[#Screen orientation settings]].
 +
 +
'''Notes:'''
 +
*1. Executing apt-get upgrade will cause the LCD to fail to work properly. In this case, you need to edit the config.txt file in the SD card and delete this sentence: dtoverlay=ads7846.
 +
*2. When working with Raspbian-lite, the command of the touch driver installation should be:
 +
{{#switch: {{FULLPAGENAME}}
 +
| 2.8inch RPi LCD (A) =
 +
<pre>
 +
./LCD28-show lite
 +
</pre>
 +
| 3.2inch RPi LCD (B) =
 +
<pre>
 +
./LCD32-show lite
 +
</pre>
 +
| 3.2inch RPi LCD (C) =
 +
<pre>
 +
./LCD32C-show lite
 +
</pre>
 +
| 3.5inch RPi LCD (A) =
 +
<pre>
 +
./LCD35-show lite
 +
</pre>
 +
| 3.5inch RPi LCD (B) =
 +
<pre>
 +
#if old version, use this command:
 +
./LCD35B-show lite
 +
</pre>
 +
 +
<pre>
 +
#if new version, use this command:
 +
./LCD35B-show-V2 lite
 +
</pre>
 +
| 3.5inch RPi LCD (C) =
 +
<pre>
 +
./LCD35C-show lite
 +
</pre>
 +
| 4inch RPi LCD (A) =
 +
<pre>
 +
./LCD4-show lite
 +
</pre>
 +
| 4inch RPi LCD (C) =
 +
<pre>
 +
./LCD4C-show lite
 +
</pre>
 +
| #default =
 +
* For 2.8inch RPi LCD (A):
 +
./LCD28-show lite
 +
* For 3.2inch RPi LCD (B):
 +
./LCD32-show lite
 +
* For 3.2inch RPi LCD (C):
 +
./LCD32C-show lite
 +
* For 3.5inch RPi LCD (A):
 +
./LCD35-show lite
 +
* For 3.5inch RPi LCD (B):
 +
./LCD35B-show lite
 +
* For 3.5inch RPi LCD (C):
 +
./LCD35C-show lite
 +
* For 4inch RPi LCD (A):
 +
./LCD4-show lite
 +
* For 4inch RPi LCD (C):
 +
./LCD4C-show lite
 +
}}
 +
'''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 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|RPi Image Installation Guides]] for more details). Then insert the card into your Pi, power up, and enjoy it.
 +
 +
<!-- 
 +
== '''Toggle between LCD and HDMI display''' ==
 +
Once this LCD is enabled, meanwhile the default settings for HDMI are changed. If you want to use another HDMI monitor, please run the following command:
 +
cd LCD-show/
 +
  ./LCD-hdmi
 +
This toggles the mode to LCD display:
 +
{{#switch: {{FULLPAGENAME}}
 +
| 2.8inch RPi LCD (A) =
 +
<pre>
 +
./LCD28-show
 +
</pre>
 +
| 3.2inch RPi LCD (B) =
 +
<pre>
 +
./LCD32-show
 +
</pre>
 +
| 3.2inch RPi LCD (C) =
 +
<pre>
 +
./LCD32C-show
 +
</pre>
 +
| 3.5inch RPi LCD (A) =
 +
<pre>
 +
./LCD35-show
 +
</pre>
 +
| 3.5inch RPi LCD (B) =
 +
<pre>
 +
#if old version, use this command:
 +
./LCD35B-show
 +
</pre>
 +
<!-- 
 +
<pre>
 +
#if new version, use this command:
 +
./LCD35B-show-V2
 +
</pre>
 +
| 3.5inch RPi LCD (C) =
 +
<pre>
 +
./LCD35C-show
 +
</pre>
 +
| 4inch RPi LCD (A) =
 +
<pre>
 +
./LCD4-show
 +
</pre>
 +
| 4inch RPi LCD (C) =
 +
<pre>
 +
./LCD4C-show
 +
</pre>
 +
| #default =
 +
* For 2.8inch RPi LCD (A):
 +
./LCD28-show
 +
* For 3.2inch RPi LCD (B):
 +
./LCD32-show
 +
* For 3.2inch RPi LCD (C):
 +
./LCD32C-show
 +
* For 3.5inch RPi LCD (A):
 +
./LCD35-show
 +
* For 3.5inch RPi LCD (B):
 +
./LCD35B-show
 +
* For 3.5inch RPi LCD (C):
 +
./LCD35C-show
 +
* For 4inch RPi LCD (A):
 +
./LCD4-show
 +
* For 4inch RPi LCD (C):
 +
./LCD4C-show
 +
}}
 +
-->
 +
 +
== '''Screen orientation settings''' ==
 +
 +
After installing the touch driver, you can modify the screen rotation direction by running the following commands.
 +
 +
<syntaxhighlight lang="c">
 +
cd LCD-show/
 +
#X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively.
 +
#If it is an old version, execute the following code:
 +
sudo ./LCD28-show X
 +
#If it is a new version, execute the following code:
 +
sudo ./LCD28-show-V2 X
 +
</syntaxhighlight>
 +
 +
The rotation command under Raspbian-lite is as follows:
 +
<syntaxhighlight lang="c">
 +
cd LCD-show/
 +
#X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively.
 +
#If it is an old version, execute the following code:
 +
sudo ./LCD28-show lite X
 +
#If it is a new version, execute the following code:
 +
sudo ./LCD28-show-V2 lite X
 +
</syntaxhighlight>
 +
 +
== '''Touch screen calibration''' ==
 +
This LCD can be calibrated through the xinput-calibrator program. '''Note: The Raspberry Pi must be connected to the network, or else the program won't be successfully installed.'''
 +
 +
*Run the following command to install:
 +
sudo apt-get install xinput-calibrator
 +
* Click the "Menu" button on the taskbar, 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).
 +
sudo nano /etc/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:
 +
[[File:5inch_HDMI_LCD_FAQ1.jpg]]
 +
==Control Backlight Brightness with GPIO==
 +
Use a 0R resistor or solder to connect this pad.<br/>
 +
 +
[[File:Virtual Keyboard Install02.png]]<br/>
 +
Execute the following command on the Raspberry Pi terminal to control the backlight brightness:<br/>
 +
<syntaxhighlight lang="c">
 +
gpio -g pwm 18 1024
 +
gpio -g mode 18 pwm (the occupied pins are PWM pins)
 +
gpio pwmc 1000
 +
gpio -g pwm 18 X (control brightness, X value is between 0~1024)
 +
</syntaxhighlight>
 +
 +
<!--
 +
== '''2.8inch RPi LCD (A) - Rev2.1 PWM backlight adjustment function''' ==
 +
For Pi4, you need to update the wiringPi version first. The operation method is as follows (for 3B+ and earlier versions, there is no need to update):
 +
<pre>
 +
wget https://project-downloads.drogon.net/wiringpi-latest.deb
 +
sudo dpkg -i wiringpi-latest.deb
 +
gpio -v
 +
# Run gpio -v and version 2.52 will appear. If it does not appear, the installation is wrong
 +
</pre>
 +
After the wiringPi is updated successfully, the backlight brightness can be controlled by the following commands.
 +
<pre>
 +
gpio -g mode 18 pwm #Occupied pins are PWM pins
 +
gpio pwmc 100
 +
gpio -g pwm 18 0 #the darkest
 +
gpio -g pwm 18 1023 #brightest
 +
gpio -g mode 18 out #Release as output
 +
</pre>
 +
-->
 +
 +
== '''Install Virtual Keyboard''' ==
 +
1.  Install matchbox-keyboard. <br />
 +
<pre>
 +
sudo apt-get install update
 +
sudo apt-get install matchbox-keyboard
 +
sudo nano /usr/bin/toggle-matchbox-keyboard.sh
 +
</pre>
 +
 +
2. Copy the statements below to toggle-matchbox-keyboard.sh and save.
 +
<pre>
 +
#!/bin/bash
 +
#This script toggle the virtual keyboard
 +
PID=`pidof matchbox-keyboard`
 +
if [ ! -e $PID ]; then
 +
killall matchbox-keyboard
 +
else
 +
matchbox-keyboard -s 50 extended&
 +
fi
 +
</pre>
 +
3. Execute the commands:
 +
<pre>
 +
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
 +
</pre>
 +
4. Copy the statements to toggle-matchbox-keyboard.desktop and save.
 +
<pre>
 +
[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
 +
</pre>
 +
5. Execute commands as below. '''Note that you need to use "Pi " user permission instead of root to execute this command.'''
 +
<pre>
 +
sudo nano /etc/xdg/lxpanel/LXDE-pi/panels/panel
 +
</pre>
 +
6. Find the statement which is similar to the one below: (It may be different in different versions)
 +
<pre>
 +
Plugin {
 +
type = launchbar
 +
Config {
 +
Button {
 +
id=lxde-screenlock.desktop
 +
}
 +
Button {
 +
id=lxde-logout.desktop
 +
}
 +
}
 +
</pre>
 +
7. Append these statements to add a button option:
 +
<pre>
 +
Button {
 +
id=/usr/local/share/applications/toggle-matchbox-keyboard.desktop
 +
}
 +
</pre>
 +
[[File:RPILCD-INSTALL-KEYBOARD01.png|400px]] <br />
 +
 +
8. Reboot your Raspberry Pi. If the virtual keyboard is installed correctly, you can find that there is a keyboard icon on the left of the bar
 +
sudo reboot
 +
<br />
 +
 +
<!-- 
 +
== '''How to work with a camera''' ==
 +
 +
<!--
 +
RPi LCD can also work with an external camera to take photos. In this operation, a Raspberry Pi camera is required, which should be purchased separately.
 +
 +
If you use the image provided from us, after camera attached, you can open the camera by command lines.
 +
cd /home/pi/camera/
 +
Camera
 +
 +
Then, waiting several seconds, the camera application will be started automatically. Now, you can capture pictures by double clicking the screen.
 +
 +
If you use the image with clean installation, you can setup the camera driver with:
 +
-->
 +
<!-- 
 +
1. Select "Enable Camera" -> "<YES>"
 +
sudo raspi-config
 +
 +
2. Copy the [[:File:RPi-Camera-Driver-for-GPIO-LCD.zip|Camera driver]] to the OS of Pi then:
 +
unzip camera.zip
 +
cd camera
 +
sudo chmod 777 Camera
 +
sudo cp update\ camera/95-stmpe.rules /etc/udev/rules.d/
 +
 +
3. Create a file called wheezy.list.
 +
sudo nano /etc/apt/sources.list.d/wheezy.list
 +
Append:
 +
deb http<nowiki></nowiki>://archive.raspbian.org/raspbian wheezy main
 +
Exit with save.
 +
 +
4. Create a file called 10defaultRelease.
 +
sudo nano /etc/apt/apt.conf.d/10defaultRelease
 +
Append:
 +
APT::Default-release \"stable";
 +
Exit with save.
 +
 +
5. Create a file called libsdl.
 +
sudo nano /etc/apt/preferences.d/libsdl
 +
Append:
 +
Package: libsdl1.2debian
 +
Pin: release n=jessie
 +
Pin-Priority: -10
 +
Package: libsdl1.2debian
 +
Pin: release n=wheezy
 +
Pin-Priority: 900
 +
Exit with save.
 +
 +
6. Last, execute the commands:
 +
sudo apt-get update
 +
sudo apt-get -y --force-yes install libsdl1.2debian/wheezy
 +
sudo apt-get install evtest tslib libts-bin xinput
 +
sudo apt-get install python-pip
 +
sudo apt-get install python2.7-dev
 +
sudo pip install picamera==1.10
 +
sudo reboot
 +
sudo TSLIB_FBDEVICE=/dev/fb1 TSLIB_TSDEVICE=/dev/input/touchscreen ts_calibrate
 +
Camera will be enabled by the steps above.
 +
-->
  
 
== '''Interface''' ==
 
== '''Interface''' ==
Line 62: Line 480:
 
= '''Resources''' =
 
= '''Resources''' =
 
===Documents===
 
===Documents===
−
*[https://www.waveshare.com/w/upload/1/1e/RPi_LCD_User_Manual_EN.pdf RPi LCD User Manual]
+
*[https://files.waveshare.com/upload/1/1e/RPi_LCD_User_Manual_EN.pdf RPi LCD User Manual]
 
<!-- *[[:File:4inch-RPi-LCD-A-Schematic.pdf|Schematic]] -->
 
<!-- *[[:File:4inch-RPi-LCD-A-Schematic.pdf|Schematic]] -->
 
=== Image ===
 
=== Image ===
−
Description: if you felt hard to install driver, try the image with driver pre-installed.
+
Description: if you felt hard to install the driver, try the image with the driver pre-installed.
  
 
*[https://drive.google.com/open?id=11wP7RoQzKkb6mtHSMrRh6n-_lSD0RSX6 Raspbian for 4inch RPi LCD (C)]
 
*[https://drive.google.com/open?id=11wP7RoQzKkb6mtHSMrRh6n-_lSD0RSX6 Raspbian for 4inch RPi LCD (C)]
Line 71: Line 489:
 
<!--* [https://docs.google.com/uc?id=0B-Z1UZhyKaZ0elBUbkk5amJQLVk&export=download RPi-4inch-LCD-Raspbian-160728.7z]
 
<!--* [https://docs.google.com/uc?id=0B-Z1UZhyKaZ0elBUbkk5amJQLVk&export=download RPi-4inch-LCD-Raspbian-160728.7z]
 
{{4inch_RPI_IMAGE}}-->
 
{{4inch_RPI_IMAGE}}-->
−
===Vieing area===
+
===Displaying Area===
−
*[[:File:4inch_RPi_LCD_C_panel_dimension.pdf|Panel dimension]]
+
*[https://files.waveshare.com/upload/6/6c/4inch_RPi_LCD_C_panel_dimension.pdf Panel dimension]
 +
 
 
=== Driver ===
 
=== Driver ===
 
{{RPI LCD DRIVER}}
 
{{RPI LCD DRIVER}}
 
=== Software ===
 
=== Software ===
−
* [http://www.waveshare.com/w/upload/d/d7/Panasonic_SDFormatter.zip Panasonic SDFormatter]
+
* [https://files.waveshare.com/upload/d/d7/Panasonic_SDFormatter.zip Panasonic SDFormatter]
−
* [http://www.waveshare.com/w/upload/7/76/Win32DiskImager.zip Win32DiskImager]
+
* [https://files.waveshare.com/upload/7/76/Win32DiskImager.zip Win32DiskImager]
−
* [http://www.waveshare.com/w/upload/5/56/Putty.zip PuTTY]
+
* [https://files.waveshare.com/upload/5/56/Putty.zip PuTTY]
 
</div>
 
</div>
 
<div class="tabbertab" title="FAQ">
 
<div class="tabbertab" title="FAQ">
Line 86: Line 505:
 
= '''FAQ''' =
 
= '''FAQ''' =
 
{{RPI HDMI GPIO LCD FAQ}}
 
{{RPI HDMI GPIO LCD FAQ}}
−
{{FAQ|What are the power requirements?
 
−
|when working with 5V input, the current is about 200mA.}}
 
 
<!--  
 
<!--  
 
== '''Anti-Piracy''' ==
 
== '''Anti-Piracy''' ==
Line 96: Line 513:
 
<div class="tabbertab" title="Support">
 
<div class="tabbertab" title="Support">
 
-->
 
-->
−
{{service00}}
+
='''Support'''=
 +
{{Servicebox1}}
 
[[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]]
 
</div>
 
</div>

Latest revision as of 06:42, 4 September 2023

4inch RPi LCD (C)
4inch RPi LCD (C)

4 inch Touch Screen TFT LCD Designed for Raspberry Pi
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

Overview

Introduction

4 inch Touch Screen TFT LCD Designed for Raspberry Pi, High-Speed SPI transmission.

Features

  • The hardware resolution is 480 × 320.
  • Resistive touch control.
  • It is compatible and can be directly inserted into any version of Raspberry Pi.
  • Support 125MHz high-speed SPI signal transmission, which makes the screen display clear and stable.
  • Provides drivers (works with your own Raspbian/Ubuntu/Kali and Retropie system directly).
  • Support FBCP software driver, which can set the software resolution and dual-screen display.
  • Immersion gold design, fine carving.

Getting Started

Hardware Connection

  • There are 40 pins on Raspberry Pi, but there are 26 pins on the LCD, so you should pay attention to connecting the pins to your Pi accordingly.

Install the touch driver

The RPi LCD can be driven in two ways:
Method 1. Install a driver to your Raspbian OS.
Method 2. Use the Ready-to-use image file of which the LCD driver was pre-installed.

Method 1. Driver installation

Please download the latest version of the image on the Raspberry Pi official website. (Raspbian/Ubuntu Mate/Kali or Retropie)

1) Download the compressed image file to the PC, and unzip it to get the .img file.

2) Connect the TF card to the PC, open the Win32DiskImager software, select the system image downloaded in step 1, and click 'Write' to write the system image. ( How to write an image to a micro SD card for your Pi? See RPi Image Installation Guides for more details)

3) Connect the TF card to the Raspberry Pi, and start the Raspberry Pi. The LCD will display after booting up, and then log in to the Raspberry Pi terminal,(You may need to connect a keyboard and HDMI LCD to Pi for driver installation, or log in remotely with SSH)

4) Then open the terminal of Raspberry Pi to install the touch driver. 

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

Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed. 

chmod +x LCD4C-show
 ./LCD4C-show

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

Notes:

  • 1. Executing apt-get upgrade will cause the LCD to fail to work properly. In this case, you need to edit the config.txt file in the SD card and delete this sentence: dtoverlay=ads7846.
  • 2. When working with Raspbian-lite, the command of the touch driver installation should be:
 ./LCD4C-show lite

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 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 into your Pi, power up, and enjoy it.


Screen orientation settings

After installing the touch driver, you can modify the screen rotation direction by running the following commands. 

cd LCD-show/
#X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively.
#If it is an old version, execute the following code:
sudo ./LCD28-show X
#If it is a new version, execute the following code:
sudo ./LCD28-show-V2 X

The rotation command under Raspbian-lite is as follows: 

cd LCD-show/
#X can be 0, 90, 180 and 270. Indicates that the LCD rotates 0 degrees, 90 degrees, 180 degrees and 270 degrees, respectively.
#If it is an old version, execute the following code:
sudo ./LCD28-show lite X
#If it is a new version, execute the following code:
sudo ./LCD28-show-V2 lite X

Touch screen calibration

This LCD can be calibrated through the xinput-calibrator program. Note: The Raspberry Pi must be connected to the network, or else the program won't be successfully installed.

  • Run the following command to install:
sudo apt-get install xinput-calibrator
  • Click the "Menu" button on the taskbar, 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).
sudo nano /etc/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

Control Backlight Brightness with GPIO

Use a 0R resistor or solder to connect this pad.

Virtual Keyboard Install02.png
Execute the following command on the Raspberry Pi terminal to control the backlight brightness:

gpio -g pwm 18 1024
gpio -g mode 18 pwm (the occupied pins are PWM pins)
gpio pwmc 1000
gpio -g pwm 18 X (control brightness, X value is between 0~1024)


Install Virtual Keyboard

1. Install matchbox-keyboard. 

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

2. Copy the statements below to toggle-matchbox-keyboard.sh and save. 

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

3. Execute the commands: 

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 statements to toggle-matchbox-keyboard.desktop and save. 

[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 commands as below. Note that you need to use "Pi " user permission instead of root to execute this command. 

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

6. Find the statement which is similar to the one below: (It may be different in different versions) 

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

7. Append these statements to add a button option: 

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

RPILCD-INSTALL-KEYBOARD01.png

8. Reboot your Raspberry Pi. If the virtual keyboard is installed correctly, you can find that there is a keyboard icon on the left of the bar 

sudo reboot



Interface

The pins labeled "NC" below means that those pins of Raspberry Pi are not occupied by the LCD, and the user can use them for other applications.

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, 12, 13, 15, 16 NC NC
6, 9, 14, 20, 25 GND Ground
11 TP_IRQ Touch Panel interrupt, low level while the Touch Panel detects touching
18 LCD_RS Command/data register selection
19 LCD_SI / TP_SI LCD display/SPI data input of Touch Panel
21 TP_SO SPI data output of Touch Panel
22 RST Reset
23 LCD_SCK / TP_SCK LCD display/SPI clock of Touch Panel
24 LCD_CS LCD chip selection, low active
26 TP_CS Touch Panel chip selection, low active

Resources

Documents

Image

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

Displaying Area

Driver

The driver can be downloaded from github 

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

Software

FAQ

Question:Why can not the LCD be used normally when using the official image provided by the Raspberry Pi?

 Answer:
The LCD must have a driver installed for normal use. For details, please refer to the relevant introduction in the user manual.
{{{3}}}
{{{4}}}

{{{5}}}


Question:Why can not the LCD be used normally when using the Raspberry Pi image provided by waveshare?

 Answer:
Since the Raspberry Pi image and version are frequently updated, if you encounter a situation where the LCD cannot be used normally, please download the latest version of the image provided by us or from the official website of Raspberry Pi and install the latest driver provided by us.
  • Make sure the hardware connection is correct and the contact is good.
  • Make sure that TF card programming is normal.
  • When the Raspberry Pi starts normally, the PWR light is always on, and the ACT light is flashing. If it is found that both lights are always on, it may be that the TF card is not successfully programmed to the image or the TF card is in poor contact with the Raspberry Pi.
  • It is recommended to use a 5V 2.5A power adapter for the Raspberry Pi. If the Raspberry Pi is powered by the USB port of the PC, the Raspberry Pi may not be able to start normally due to an insufficient power supply.
{{{3}}}
{{{4}}}

{{{5}}}


Question:What is the operating temperature of the 3.5inch RPi LCD (C)?

 Answer:
Commercial grade (0~70 degrees Celsius).
{{{3}}}
{{{4}}}

{{{5}}}


Question:What are the power requirements?

 Answer:
When working with 5V input, the current is about 200mA.
{{{3}}}
{{{4}}}

{{{5}}}


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 AM GMT+8 (Monday to Friday)

Retrieved from "https://www.waveshare.com/w/index.php?title=4inch_RPi_LCD_(C)&oldid=70121"