Features​

• 6.25inch DSI touchscreen with 5-point capacitive touch.
• IPS display panel with hardware resolution of 720 × 1560.
• Portrait display by default; display orientation can be switched via system display settings.
• Optical bonding process with toughened glass touch panel, 6H hardness.
• DSI display interface, I2C touch interface.
• Compatible with Raspberry Pi, supporting plug-and-play (driver-free) on Raspberry Pi OS new systems.
• Backlight brightness adjustable via software or onboard buttons.

Electrical Specifications​

• Note 1: Exceeding the maximum input voltage or improper operation may cause permanent damage to the device.
• Note 2: Input current must be ≥400mA, otherwise it will cause startup failure or display abnormalities. Prolonged abnormal operation may cause permanent damage to the device.
• Note 3: Do not store the display in high-temperature, high-humidity environments for extended periods. The display must operate within the specified limits to avoid damage.

Interface Introduction​

Dimensions​

Hardware Connection​

Raspberry Pi 5​

1. Use the "DSI-Cable-12cm" cable to connect the DSI interface of the display to the 22PIN DSI interface on the Raspberry Pi.
2. Secure the Raspberry Pi to the standoffs on the back of the display.
3. Ensure the pogo pins make proper contact with the Raspberry Pi. The display draws 5 V power through these pogo pins.

Raspberry Pi 4B / 3B+ / 3B / 3A+​

1. Use a double-headed 15PIN FPC cable to connect the DSI interface of the display to the 15PIN DSI interface on the Raspberry Pi.
2. Secure the Raspberry Pi to the standoffs on the back of the display.
3. Ensure the pogo pins make proper contact with the Raspberry Pi. The display draws 5 V power through these pogo pins.

Compute Module IO Board​

1. Use the "DSI-Cable-12cm" cable to connect the DSI interface of the display to the DSI interface on the Compute Module IO Board.
2. Use the 4PIN PH2.0 cable, connect the 5V and GND of the display to the 5V and GND pins of the Raspberry Pi respectively. (By default, the built-in I2C0 on the DSI interface is used, so SDA1 and SCL1 can be left unconnected.)

Software Settings​

Flashing the System​

1. Connect the TF card to the PC, download and use Raspberry Pi Imager to flash the latest Raspberry Pi OS.

   
   

2. After flashing, open the config.txt file in the root directory of the TF card, add the following configuration at the end of the file, save, and safely eject the TF card.

   DSI INTERFACE SELECTION

   Raspberry Pi 5 / CM5 / CM4 / CM3+ / CM3 have two MIPI DSI interfaces. DSI1 is recommended by default. If the screen is connected to DSI0, enable the corresponding configuration for DSI0.

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

3. Insert the TF card into the Raspberry Pi and power it on. After the system boots, display and touch functions will work normally.

Backlight Brightness Adjustment​

GUI Brightness Adjustment​

The following steps use Raspberry Pi OS Trixie as an example:

1. Click the top-left menu, go to "Preferences" > "Control Center", and select "Screens".

   
   

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

   
   

Using the 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 installation, you can open the program from "Accessories" > "Brightness".

Adjusting Backlight via Terminal​

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

Where X represents any number between 0 and 255. 0 means the darkest, and 255 means the brightest. 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 Rotation​

The following steps use Raspberry Pi OS Trixie as an example:

1. Click the top-left menu, 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", select the desired orientation, and click "Apply" to synchronously rotate both the display and touch.

   
   

Lite Version Display Rotation​

Edit cmdline.txt:

sudo nano /boot/firmware/cmdline.txt

Add the corresponding rotation parameter at the beginning of the file, save, and reboot for the change to take effect.

# Display rotation 90 degrees
video=DSI-1:720x1560M@60,rotate=90

# Rotate display 180 degrees
video=DSI-1:720x1560M@60,rotate=180

# Rotate display 270 degrees
video=DSI-1:720x1560M@60,rotate=270

Touch Rotation​

If you rotate using the GUI, you can check the "Touchscreen" option in the screen layout editor to synchronize touch rotation. For command-line touch rotation, you can configure it via udev rules.

1. Create the 99-waveshare-touch.rules file.

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

2. Add the following rule as needed, save, and reboot for the change to take effect.

   # Touch rotation 90 degrees
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"
   
   # Touch rotation 180 degrees
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"
   
   # Touch rotation 270 degrees
   ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"
   

3. Reboot the Raspberry Pi.

   sudo reboot
   

Touch Mode Selection​

Raspberry Pi OS Trixie and Bookworm support two touch modes, which can be switched under "Screen Configuration" > "Touchscreen".

Mouse Emulation​

• Single tap = left mouse click.
• Long press = right mouse click.
• Supports double-click.
• Does not support page scrolling or multi-touch.

Multitouch​

• Supports multi-touch.
• Supports page scrolling.
• Does not support double-click or long-press right-click.

On-Screen Keyboard​

Starting from Raspberry Pi OS Bookworm, the system includes the Squeekboard on-screen keyboard by default.

• The keyboard automatically appears when text input is possible and hides when input is not possible.
• You can also manually show or hide it using the keyboard icon in the top-right corner of the taskbar.

In Trixie, you can set the on-screen keyboard to show or hide via "Preferences" > "Control Center" > "Display".

In Bookworm, you can set the on-screen keyboard to show or hide via "Raspberry Pi Configuration" > "Display" or raspi-config > "Display".

Support

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

Email: services01@spotpear.com