- 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
- 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.
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
#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.
#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.
#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.
#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)
Method 1: Graphical Interface Dimming
Using the application provided by Waveshare:
#Determine the kernel version currently in use, e.g. 5.15.61 kernel, and run the following command:
#Check the bits of the system, the 32-bit system enters 32 directory, and the 64-bit system enters 64 directory
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.)
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.
Dear Customers, There may be a lag of several hours before we could process your order, depending on the time difference between your location and ours. Sincerely hoping your understanding!