Difference between revisions of "3.5inch RPi LCD (B)"

From Waveshare Wiki
Jump to: navigation, search
Line 127: Line 127:
 
</div>
 
</div>
 
<div class="tabbertab" title="FAQ">
 
<div class="tabbertab" title="FAQ">
== '''FAQ''' ==
+
= '''FAQ''' =
 
{{RPI HDMI GPIO LCD FAQ}}
 
{{RPI HDMI GPIO LCD FAQ}}
 
{{FAQ|What are the power requirements?
 
{{FAQ|What are the power requirements?

Revision as of 10:38, 23 June 2022

3.5inch RPi LCD (B)
320×480
3.5inch-RPi-LCD-B

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

{{{name3}}}

{{{name4}}}

{{{name5}}}

Overview

Introduction

3.5 inch Touch Screen TFT LCD Designed for Raspberry Pi

More

Features

  • The hardware resolution is 480×320.
  • Resistive touch control.
  • It is compatible and can be directly inserted in any version of Raspberry Pi.
  • Provide rivers (works with your own Raspbian/Ubuntu/Kali and Retropie system directly).
  • IPS screen, large viewing angle, excellent display effect.
  • Support FBCP software driver, which can set the software resolution and dual screen display.
  • As big as your raspberry pi.
  • Gold sinking process, fine carving.

Version Update

  • Because of stop production of old LCD, we update 3.5inch RPi LCD (B) to Rev2.0
  • The dimension of LCD is different, and driver is updated as well.(Please download the new driver if you have the new version)
  • You can recognize new and old version by the silk screen printing on the backside. The new version has screen printing Rev2.0.

3.5inch-RPi-LCD-B-Manual-21.png

  • The dimension of LCD are as below, left one is the new version. (download and open it if it is unclear on Wiki)

3.5inch-RPi-LCD-B-Manual-20.png

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 driver to your Raspbian OS. Method 2. use the Ready-to-use image file of which 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, 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 installing, 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.

#if old version, use this command:
chmod +x LCD35B-show
 ./LCD35B-show 
#if new version, use this command:
chmod +x LCD35B-show-V2
 ./LCD35B-show-V2 

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. Using with Raspbian-lite, the command of the touch driver installation should be:
#if old version, use this command:
 ./LCD35B-show lite
#if new version, use this command:
 ./LCD35B-show-V2 lite

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 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 Install01.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 below: (It maybe different in different version)

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

7. Append these statements to add an 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 definition

The pins marked as "NC" below indicate that the pins are not occupied by the LCD and can be used by the user for other applications.

Pin Number Identification Description
1 3.3V Power (3.3V input)
2 5V Power (5V input)
3 NC NC
4 5V Power (5V input)
5 NC NC
6 GND Ground
7 NC NC
8 NC NC
9 GND Ground
10 NC NC
11 TP_IRQ The touch panel is interrupted, and it is low when it is detected that the touch panel is pressed
12 NC NC
13 NC NC
14 GND Ground
15 NC NC
16 NC NC
17 3.3V Power (3.3V input)
18 LCD_RS Command/Data Register Select
19 LCD_SI / TP_SI LCD display / SPI data input of touch panel
20 GND Ground
21 TP_SO SPI data output of touch panel
22 RST Reset
23 LCD_SCK / TP_SCK SPI clock signal for LCD display / touch panel
24 LCD_CS LCD chip select signal, low level selects LCD
25 GND Ground
26 TP_CS Touch panel chip select signal, low level selects touch panel

Resource

User Manual

Image

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

Driver

The driver can be downloaded from github

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

Software

LCD Panel Dimension

FAQ

 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}}}


 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}}}


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

{{{5}}}


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

{{{5}}}


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

{{{5}}}


 Answer:
Please try to modify the boot/mark file, change 1 to 0, and then execute the driver installation command after reconnecting to the Internet.
{{{3}}}
{{{4}}}

{{{5}}}


Support

If you require technical support, please go to the Support page and open a ticket.