• sales

    +86-0755-88291180

Raspberry Pi 3.4inch DSI LCD (C) User Guide

Feature

  • 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.
dtoverlay=WS_xinchDSI_Screen,SCREEN_type=9,I2C_bus=10
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy,I2C_bus=10
5. Insert the TF card into the Raspberry Pi, boot it, and then it can display and be touched normally after 30 seconds.

Rotation

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
video=DSI-1:800x800M@60,rotate=90
#Display rotates 180 degrees
video=DSI-1:800x800M@60,rotate=180
#Display rotates 270 degrees
video=DSI-1:800x800M@60,rotate=270

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)
#90°:
dtoverlay=WS_xinchDSI_Touch,invertedx,invertedy
#180°:
dtoverlay=WS_xinchDSI_Touch,invertedy,swappedxy
#270°:
dtoverlay=WS_xinchDSI_Touch
#0°:
dtoverlay=WS_xinchDSI_Touch,invertedx,swappedxy

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

Note

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.

FAQ

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

 Answer:
Replace the custom image with the image in this directory /usr/share/plymouth/themes/pix/splash.png.
TAG: JSON Command Meaning ADXL355BEZ wide dynamic range D-Robotics RDK X3 Module Core MD Module Horizon Sunrise Pi ARM Cortex-A53 5Tops Size Compatible With Raspberry Pi CM4 Size E-Paper Raspberry Pi 5 RTC Horizontal Drag Instructions DeepSeek AI Voice Chat ESP32 C6 Development Board 1.83 inch TouchScreen Display 240x284 Raspberry Pi Pico 2 RP2350 1.8 inch AMOLED Development Board Display 368×448 TouchScreen Programmable Watch QSPI Raspberry Pi Pico 2 RP2350 0.85inch LCD Display Development Board RGB Lighting 128×128 Raspberry Pi Camera Raspberry Pi DA7212 I2S Audio For XiaoZhi AI Expansion Board Dul-mic Free-Driver For PI5/PI4/Zero Raspberry Pi 4.26 inch e-Paper link (G) RYBW 800x480 For Arduino / Jetson / STM32 /ESP32 Raspberry Pi 5 DSI display 14 inch Dual LCD Computer PC Monitor Display Double Secondary Screen Type C Mini HDMI 1080P For Windows/MacOS ESP32-S3R2 Raspberry Pi 5 LIR2032 Raspberry Pi 5 TTL Sipeed NanoCluster Mini Cluster Board mini data center For Raspberry Pi CM45 / Computer /LM3H /M4N Luckfox Pico ST7789