• sales


Raspberry Pi 3.4inch DSI LCD (C) User Guide


  • 3.4-inch IPS round display with a hardware resolution of 800×800.
  • Support 10-point capacitive touch control, up to 6H hardness toughened glass panel.
  • Optical bonding technology for clearer imaging.
  • Directly drive LCD via Raspberry Pi's DSI interface, refresh rate up to 60Hz.
  • Raspberry Pi OS system driver is provided for use with Raspberry Pi.
  • Support Pi 4B/3B+/3A+, some CM3+/4 need to be used with adapter cable.
  • Support adjusting the backlight via the software.

Working with Raspberry Pi

Hardware Connection

1. Connect the DSI connector of the display to the DSI connector on the Raspberry Pi board with a 15PIN FPC cable.
2. Install the Raspberry Pi back side down to the display backplane and connect the 5V power supply and I2C communication through the 4PIN.
3. The final connection is shown in the following figure.

Software Setting

Method 1: Install Driver Manually

1. Download the latest image from the Raspberry Pi website, download the compressed file to the PC, and then unzip it to get the ".img" file.
2. Connect the TF card to the PC, and format the TF card with the SDFormatter.
3. Open Win32DiskImager, choose the system image prepared in the first step, and click 'Write' to program the system image.
4. After programming, connect the TF card to the Raspberry Pi, boot the Raspberry Pi, and then log in to the terminal of the Raspberry Pi (you can connect the Raspberry Pi to an HDMI display or log in remotely with ssh).
#Step 1: Download and enter the Waveshare-DSI-LCD driver folder.
git clone https://github.com/waveshare/Waveshare-DSI-LCD
cd Waveshare-DSI-LCD
#Step 2: Enter uname -a in the terminal to check the kernel version and type cd to the corresponding file directory
#For 5.15.61, run the following command.
cd 5.15.61
#Step 3: Please check the system bits you are currently using, the 32 directory is for a 32-bit system, the 64 directory is for a 64-bit system.
cd 32
#cd 64
#Step 4: Enter your corresponding model command to install the driver, pay attention to the I2C dip switch selection
#3.4inch DSI LCD 800×800 driver.
sudo bash . /WS_xinchDSI_MAIN.sh 34 I2C0
#Step 5: Wait for a few seconds, when the driver installation is finished and there is no error, reboot to load the DSI driver for normal use.
sudo reboot

#Note: The above steps need to ensure that the Raspberry Pi can be connected to the Internet properly.

5. After the system reboots, it can display and be touched normally.

Method 2: Program the Pre-install Image

1. Click to download Waveshare DSI LCD - Pi4 pre-install image and then unzip it to get the ".img" file.
2. Connect the TF card to the PC, and format the TF card with SDFormatter.
3. Open Win32DiskImager, choose the system image prepared in the first step, and click "write" to program the system image.
4. After writing, open the config.txt file in the TF card root directory. Add the following code under [all], save and then safely remove the TF card.
5. Insert the TF card into the Raspberry Pi, boot it, and then it can display and be touched normally after 30 seconds.


Method 1: Graphical Interface Rotation

In the start menu, select: Preferences->Screen Configuration->Configure->Screens->DSI-1->Orientation, select the corresponding angle in it, click "√", select Yes, and restart.

Method 2: Display Rotation In Lite Version

sudo nano /boot/cmdline.txt
#Add a command to display the rotation angle at the beginning of the cmdline.txt file, save and reboot to take effect.
#Display rotates 90 degrees
#Display rotates 180 degrees
#Display rotates 270 degrees

Touch to Rotate

sudo nano /boot/config.txt
#Modify the instruction of touch rotation angle at the end of the config.txt file and take effect after reboot (default instruction of 0° touch direction exists)

Backlight Control

Method 1: Graphical Interface Dimming

Using the application provided by Waveshare:

cd Waveshare-DSI-LCD
#Determine the kernel version currently in use, e.g. 5.15.61 kernel, and run the following command:
cd 5.15.61
#Check the bits of the system, the 32-bit system enters 32 directory, and the 64-bit system enters 64 directory
cd 32
#cd 64
cd Backlight
sudo ./install.sh

After the installation is complete, you can open the program in the Start menu - > Accessories - > Brightness, as shown below:

Method 2: Lite Version Dimming Command

To adjust the system command of the lite version, after entering the root privilege, execute the following command on the Raspberry Pi terminal:

echo X > /sys/waveshare/rpi_backlight/brightness

(X value in the range of 0~255.)
For example:

sudo su root
echo 100 > /sys/waveshare/rpi_backlight/brightness


1. Update the system and run the following commands:
sudo apt-get update
sudo apt-get full-upgrade

After updating, some driver files installed before may be covered, and you need to reinstall the driver so that it can display normally.

2. Replace the Board:

If the driver was originally installed on Raspberry Pi 4 Model B and the user replaces the board, such as modifying it to Raspberry Pi 3 Model B+, it will cause the display to not display properly.
Because Pi4 and Pi3 need to load different driver files, you need to reinstall the driver on the new board according to the #software settings before the display can be displayed properly.


Question:How to replace the logo image of Raspberry Pi Booting?

Replace the custom image with the image in this directory /usr/share/plymouth/themes/pix/splash.png.