Features

• 6.25inch DSI touch screen, supports five-point capacitive touch control
• IPS display panel with hardware resolution of 720×1560
• Adopt optical bonding process, the picture quality is clearer
• Equipped with 6H hardness tempered glass touch cover
• Compatible with Raspberry Pi 5/4B/CM4/3B+/3A+/3B/CM3+/CM3
• Directly drive the LCD through the Raspberry Pi's DSI interface, with a refresh rate of up to 60Hz
• When used with Raspberry Pi, it is compatible with Bookworm/Bullseye/Buster systems
• Supports software to adjust the brightness of the backlight

Hardware connection

Working with Raspberry Pi 5

1. Use the DSI-Cable-12cm cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard.
2. Secure the Raspberry Pi to the display with M2.5 screws, ensuring that the spring pins make good contact with the Raspberry Pi.

The installation effect is as follows:

Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the spring pins.

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

1. Use a double-headed 15PIN FPC cable to connect the DSI interface of the display to the DSI interface of the Raspberry Pi motherboard.
2. Secure the Raspberry Pi to the display with M2.5 screws, ensuring that the spring pins make good contact.

The installation effect is as follows:

Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the spring pins.

Working with CM4/CM3

1. Use the DSI-Cable-12cm cable to connect the DSI port of the display to the 22PIN DSI1 port of the Raspberry Pi motherboard.
2. Using the 4PIN PH2.0 cable, connect the 5V and GND of the display to the 5V and GND pins of the Raspberry Pi respectively.
(I2C0 touch communication is used by default, if you switch to I2C1 touch communication, you need to connect SDA1 and SCL1 pins additionally)

The installation effect is as follows:

Note: Ensure that the DSI cable is connected in the correct direction and supplies 5V power to the display via the cable.

Software settings

For Bookworm system

• 1. Insert the TF card into your PC, download and use Raspberry Pi Imager to burn the system image.

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

Note: For Pi5/CM4/CM3+/CM3, since there are two MIPI DSI display interfaces, please make sure to use the correct display interface and instructions, the DSI1 display interface is recommended by default. 

dtoverlay=vc4-kms-v3d
#DSI1 Use
dtoverlay=vc4-kms-dsi-waveshare-panel,6_25_inch
#DSI0 Use
#dtoverlay=vc4-kms-dsi-waveshare-panel,6_25_inch,dsi0

• 3. Insert the TF card into the Raspberry Pi, power on and start, wait for a few seconds to enter the system display, and the touch function can also work normally.

Adjusting Backlight Brightness

• 1. Open the "Screen Configuration" application;
  

• 2. Go to "Screen" -> "DSI-2" -> "Brightness", check the backlight brightness you need to set, and finally click "Apply" to complete the backlight setting.

Waveshare also provides a corresponding demo (the demo is only used for Bookworm and Bullseye systems), users can download, install and use in the following way:

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:

In addition, you can also control the brightness of the backlight by entering the following command on the 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

Bookworm Touch Screen Rotation

• 1. Open the Screen Configuration application;
  

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

• 3.Click Apply, then close the current window, and reboot according to the pop-up prompts to complete the specified touch screen;

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

Note: Only the Bookworm system supports the above synchronization rotation method. For the Bullseye and Butser systems, manual separate settings for touch rotation are required after displaying the rotation.

lite version display rotation

sudo nano /boot/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:720x1560M@60,rotate=90
#Display rotation 180 degrees
video=DSI-1:720x1560M@60,rotate=180
#Display rotation 270 degrees
video=DSI-1:720x1560M@60,rotate=270

Turn off/on the screen

Run the following command on the Raspberry Pi terminal to turn off the screen:

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 to turn the screen 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 instruction is only applicable to Labwc and Wayfire graphical interfaces and not to X11 graphical interfaces.

Screen sleep

Run the following command on the Raspberry Pi terminal and the screen will go to sleep:

xset dpms force off

Note: This command is only available for the X11 GUI, not for Labwc and Wayfire.

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 by the command: sudo nano /boot/config.txt):

disable_touchscreen=1

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

Resources

• 6.25inch DSI LCD 3D Drawing
• 6.25inch DSI LCD 2D Drwing PDF

FAQ

Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com