13.3inch DSI LCD

Features

• 13.3inch DSI touch screen, supports ten-point capacitive touch control
• IPS display panel with hardware resolution of 1920×1080
• Equipped with 6H hardness tempered glass touch cover
• Compatible with Raspberry Pi 5/CM5/4B/CM4/3B+/3A+/3B/CM3+/CM3
• Directly drive the LCD through the Raspberry Pi's DSI interface
• When used with Raspberry Pi, it is compatible with Bookworm system
• Supports software to adjust the brightness of the backlight

Video

Hardware Connection

Working with Raspberry Pi 5

1. Use the 22PIN DSI FFC cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard.
2. Use the 3PIN cable to connect the POWER interface of the display to the 5V, 5V and GND pins of the Raspberry Pi motherboard. (Red for 5V, black for GND)
3. Use M2.5 screws to secure the Raspberry Pi to the back panel of the display.

The installation effect is as follows:

Note: Make sure that the FFC cable is connected in correct direction and 5V power is supplied through the cable.

Working with Raspberry Pi4B/3B+/3B/3A+

1. Use the MIPI-DSI-Cable-12cm cable to connect the DSI port of the display to the DSI port of the Raspberry Pi motherboard.
2. Use the 3PIN cable to connect the POWER interface of the display to the 5V, 5V and GND pins of the Raspberry Pi motherboard. (Red for 5V, black for GND)
3. Use M2.5 screws to secure the Raspberry Pi to the back panel of the display.

The installation effect is as follows:

Note: Make sure that the FPC cable is connected in correct direction and 5V power is supplied through the cable.

Working with CM5/CM4/CM3

1. Use the 22PIN FFC cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard.
2. Use the 3PIN cable to connect the POWER interface of the display to the 5V, 5V and GND pins of the Raspberry Pi motherboard. (Red for 5V, black for GND)

The installation effect is as follows:

Note: Make sure that the FFC cable is connected in correct direction and 5V power is supplied through the cable.

Software Settings

Working with Trixie/Bookworm

Method 1: Install Driver Manually (Recommended)

• 1. Connect the TF card to the PC, download and use Raspberry Pi Imager to flash the corresponding system image.

• 2. After the image flashing is completed, open the config.txt file in the root directory of the TF card, add the following code to the end of the config.txt file, save and safely eject the TF card.

Depending on the Raspberry Pi model, the recommended DSI lane settings are as follows:

Raspberry Pi 3 / 4

dtoverlay=vc4-kms-v3d
dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_2lane

Raspberry Pi 5 / CM3/3+/4/5

dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_4lane
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_4lane,dsi0

Note: Since Pi5/CM4/CM3+/CM3 have two MIPI DSI interfaces, please note that the correct DSI interfaces and commands are used, DSI1 is recommended by default.

• 3. Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and wait for a few seconds normally to enter the display. After the system starts, it can be touched normally.

Method 2: Flash Pre-installed Image

1. Select your corresponding Raspberry Pi version image, download and unzip it as .img file.
Raspberry Pi 5 Version Download: Waveshare DSI LCD - Pi5 pre-installed image
Raspberry Pi 4B/CM4/3B+/CM3 Version Download: 13.3inch DSI LCD - Pi4 pre-installed image
2. After the image flashing is completed, connect the TF card to the Raspberry Pi, start the Raspberry Pi, and wait for about 30 seconds for it to be displayed and touched normally.

Adjust Backlight Brightness

Graphical Interface Backlight Adjustment

The following steps are based on the Trixie system:

• 1. Click the menu in the upper left corner, then go to "Preferences" → "Control Center", and select "Screens";
  

• 2. Go to "Screen" -> "DSI-2" -> "Brightness", select and adjust the desired backlight brightness, and finally click "Apply" to save the settings.

In the Bookworm system, this setting entry is located at "Screen Configuration" → "Screen".

Use Waveshare Backlight Adjustment Application

You can also use the graphical backlight adjustment tool provided by Waveshare:

wget https://files.waveshare.com/wiki/common/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh

After the installation is completed, you can open the demo in the Start Menu -> Accessories -> Brightness, as shown below:

Adjust Backlight Brightness Using Terminal

echo X | sudo tee /sys/class/backlight/*/brightness

Where X represents any number from 0 to 255. 0 means the darkest backlight, and 255 means the brightest backlight. For example:

echo 100 | sudo tee /sys/class/backlight/*/brightness
echo 0 | sudo tee /sys/class/backlight/*/brightness
echo 255 | sudo tee /sys/class/backlight/*/brightness

Trixie/Bookworm Display Rotation

GUI interface rotation
The following steps are based on the Trixie system:

• 1. Click the menu in the upper left corner, then go to "Preferences" -> "Control Center", and select "Screens";
  

• 2. Go to "Screen" -> "DSI-1" -> "Touchscreen" and check "10-0014 Goodix Capacitive TouchScreen";
  

• 3. Go to "Screen" -> "DSI-2" -> "Orientation", check the direction you need to rotate, and finally click "Apply" to complete the display and touch synchronous rotation.
  

• In the Bookworm system, this setting entry is located at "Screen Configuration" -> "Screen".

Note: The above synchronous rotation method is only supported on Trixie/Bookworm system systems. For the Bullseye/Buster system, the touch rotation needs to be set manually and individually after the rotation is displayed.

lite Version Display Rotation

sudo nano /boot/firmware/cmdline.txt
#Add a command to display the rotation angle at the beginning of the cmdline.txt file, and save it to take effect after restarting
#Display rotation 90 degrees
video=DSI-1:1920x1080M@60,rotate=90
#Display rotation 180 degrees
video=DSI-1:1920x1080M@60,rotate=180
#Display rotation 270 degrees
video=DSI-1:1920x1080M@60,rotate=270

Note: If you are using Pi5/CM5/CM4, the actual recognized DSI display number will prevail, for example DSI-2.

Touch Rotation

sudo nano /etc/udev/rules.d/99-waveshare-touch.rules

#Set the command of touch rotation angle within the file, and it will take effect after the restart
#90°:
ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"

#180°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"

#270°:
#ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"

#Save, exit, and reboot
sudo reboot

Touch Mode Selection

The Bookworm system supports two touch modes, which can be switched in the Screen Configuration > Touchscreen menu:

• 1. Mouse Emulation (default)

Click = Left mouse button function
Long press = Right mouse button function
Supports double-click
Does not support page swiping and multi-touch functionality

Note: This mode is suitable for scenarios that require mouse operation, such as double clicking to open the file manager and long pressing to achieve right-click functionality.

• 2. Multitouch

Supports multi-touch functionality
Supports swiping pages
Does not support double-click and right-click long press functions

Note: This mode is suitable for touch-optimized scenarios, such as web browsing and scrolling lists.

Set Screen Off and On

Run the following command on the Raspberry Pi terminal and the screen will be turned off:

wlr-randr --output DSI-2 --off
# DSI-2 needs to be modified to the actual display in use, e.g. "DSI-1" or "HDMI-A-1"

Run the following command on the Raspberry Pi terminal and the screen will be turned on:

wlr-randr --output DSI-2 --on
# DSI-2 needs to be modified to the actual display in use, e.g. "DSI-1" or "HDMI-A-1"

Note: This command is only applicable to the Labwc and Wayfire graphical interfaces and not to the X11 graphical interface.

Screen Sleep

Run the following command on the Raspberry Pi terminal and the screen will enter sleep mode:

xset dpms force off

Note: This command is only applicable to the X11 graphical interface and not to the Labwc and Wayfire graphical interfaces.

Disable Touch

At the end of the config.txt file, add the following command corresponding to disabling touch (the config file is located in the root directory of the TF card, which can also be accessed via the command: sudo nano /boot/config.txt):

disable_touchscreen=1

Note: After adding a command, it needs to be restarted to take effect.

Resources

FAQ

Question: How to replace Raspberry Pi boot logo image?

 Answer:

Replace the image in the directory (/usr/share/plymouth/themes/pix/splash.png) with your customized image

Question:Why does the screen go black and cannot display after updating the system kernel?

 Answer:

Please try to delete the original driver in the config.txt file, and add the following overlay statement instead:

dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_2lane
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,13_3_inch_2lane,dsi0

Support

Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)

Submit Now