Waveshare 3.5inch RPi LCD (A)
Product Link
Introduction
3.5 inch Touch Screen TFT LCD is designed for Raspberry Pi.
Features
480 × 320 hardware resolution.
Resistive touch control.
It is compatible and can be directly inserted into any version of Raspberry Pi.
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.
Its size is the same as your Raspberry Pi.
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 bullseye 32bit 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.
Note: The Raspberry Pi must be connected to the network, or else the touch driver won't be successfully installed.
The touch function will work after restarting. 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 Raspbian-lite, the command of the touch driver installation should be:
For bullseye 64bit and Bookworm systems, manual configuration is required as follows: 3.5inch RPi LCD (A) Manual Configuration.
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 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.
The rotation command under Raspbian-lite is as follows:
Touch Screen Calibration
This LCD can be calibrated through the xinput-calibrator demo. Note: The Raspberry Pi must be connected to the network, or else the demo won't be successfully installed.
Run the following command to install:
Click the "Menu" button on the taskbar, and 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 the file exists).
Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:
Install Virtual Keyboard
1. Install matchbox-keyboard.
2. Copy the statements below to toggle-matchbox-keyboard.sh and save.
3. Execute the commands:
4. Copy the statements to toggle-matchbox-keyboard.desktop and save.
5. Execute commands as below. Note that you need to use "Pi " user permission instead of root to execute this command.
6. Find the statement which is similar to below: (It may be different in a different version.)
7. Append these statements to add a button option:
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.
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
Preinstall-image
Description: if you felt hard to install the driver, try the image with the driver pre-installed.
Driver
The driver can be downloaded from github
Software
LCD Panel Dimension
FAQ
Last updated