3.5 inch SPI Touch Display is designed for Raspberry Pi.


Key Parameters

LCD Interface SPI(Fmax:24MHz)
Touch Screen Type Resistive
Touch Screen Controller XPT2046
Colors 262K
Driver IC ILI9488
Backlight LED
Resolution 320RGB(H)×480(V) (Pixel)
Backlight Current 120ma
Power Dissipation 0.13A*5V
Operating Temp. (℃) -20~60
Active Area 48.96×73.44(mm)待测
Product Size 85.42*55.60(mm)待测
Package Size 118*72*34 (mm)待测
Rough Weight(Package containing) 75 (g)待测

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)
4 5V Power (5V input)
6 GND Ground
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

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. You can also refer to the digram below :


Install the 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.

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.

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/osoyoo/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 lcd35b-show

The touch function will work after restart. For ease of use, you can set the screen orientation, see the next operations.

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. Then insert the card to your Pi, power up and enjoy it.

Rotate the display direction

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 you are using the 3.5inch LCD, execute the following code:
sudo ./lcd35b-show X

Touch screen calibration

This LCD can be calibrated using a program called xinput_calibrator.
This software is automatically installed when we install the screen driver.
Click the Menu button on the task bar, choose Preference -> Calibrate Touchscreen.
Finish the touch calibration following the prompts.

Save the touch parameters (may differ depending on LCD) to 99-calibration.conf, as shown in the picture:

5inch HDMI LCD FAQ1.jpg 提供我们自己操作的图片

Maybe rebooting is required to make calibration active.
You can replace the touch parameters in ../LCD-show/usr/99-calibration.conf-35b-0 folder.


We need calibrate 4 times for 0,90,180,270 rotation, and replace the conf files in the package.


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.

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

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`

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 {
Button {

7. Append these statements to add an button option:

Button {


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