Skip to main content

Working with Raspberry Pi

Hardware Connection​

Wiring Precautions

Before connecting or disconnecting the DSI cable, shut down the Raspberry Pi and disconnect power. Make sure the ribbon cable is oriented correctly when connecting.

When inserting or removing the DSI connector, handle it gently, avoiding excessive force or angled insertion/removal, to prevent damage to the connector or poor contact.

The following uses the default I2C0 touch communication; for dual DSI interface mainboards, DSI1 is used as an example. The screen also needs a 5 V power supply. For power supply methods and the I2C1 wiring, see Power Supply and Touch Communication.

Raspberry Pi 5​

  1. Use the "DSI-Cable-12cm" ribbon cable to connect the display's DSI interface to the Raspberry Pi 5's 22PIN DSI1 (CAM/DISP1) interface.
  2. Secure the Raspberry Pi to the back of the screen, and confirm that the spring pogo pins make proper contact with the GPIO power contacts.
  3. Confirm that the touch interface selection switch is set to I2C0, check the ribbon cable orientation and power polarity, and then power on.

6.25inch DSI LCD (B) Connecting to Raspberry Pi 5

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

  1. Use a double-headed 15PIN FPC cable to connect the display's DSI interface to the 15PIN DSI interface on the Raspberry Pi.
  2. Secure the Raspberry Pi to the back of the screen, and confirm that the spring pogo pins make proper contact with the GPIO power contacts.
  3. Confirm that the touch interface selection switch is set to I2C0, check the ribbon cable orientation and power polarity, and then power on.

6.25inch DSI LCD (B) Connecting to Raspberry Pi 4B

Compute Module IO Board​

  1. Use the "DSI-Cable-12cm" ribbon cable to connect the display's DSI interface to the DSI1 interface of the Compute Module IO Board.
  2. Use the 4PIN PH2.0 cable, connect the display's 5V and GND pins to the Raspberry Pi's 5V and GND pins respectively. (The internal I2C0 of the DSI interface is used by default, so SDA1 and SCL1 do not need to be connected.)

6.25inch DSI LCD (B) Connecting to Compute Module IO Board

Software Setup​

Flashing the System​

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

    Raspberry Pi Imager Flashing the System

  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. If dtoverlay=vc4-kms-v3d already exists, keep just one instance.

    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​

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

    DSI Screen Brightness Adjustment GUI Entry

  2. Go to "Screen" > "DSI-2" > "Brightness", check and adjust the desired backlight brightness. The brightness changes immediately.

    DSI Screen Brightness Adjustment GUI

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".

DSI Screen Brightness Adjustment Application

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

GUI Interface Rotation​

Display Rotation on Trixie​

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

    DSI Screen Rotation Setting Entry

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

    DSI Screen Touch Rotation Settings

  3. Go to "Screen" > "DSI-2" > "Orientation", select the desired orientation, and click "Apply" to synchronously rotate both the display and touch.

    DSI Screen Display Rotation Settings

Display Identifier

The actual display identifier may be DSI-1 or DSI-2; use the one detected by the system.

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 rotated 90 degrees
video=DSI-1:720x1560M@60,rotate=90

# Display rotated 180 degrees
video=DSI-1:720x1560M@60,rotate=180

# Display rotated 270 degrees
video=DSI-1:720x1560M@60,rotate=270
Rotation Limitations

When using both DSI and HDMI displays simultaneously, the cmdline.txt method cannot rotate the DSI display independently from the HDMI display.

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 rotated 90 degrees
    ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 -1 1 1 0 0"

    # Touch rotated 180 degrees
    ENV{ID_INPUT_TOUCHSCREEN}=="1", ENV{LIBINPUT_CALIBRATION_MATRIX}="-1 0 1 0 -1 1"

    # Touch rotated 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 supports two touch modes, which can be toggled in "Screen Configuration" > "Touchscreen".

DSI Screen Touch Mode Selection

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​

Raspberry Pi OS Trixie 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.

Squeekboard On‑Screen Keyboard

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

Trixie On‑Screen Keyboard Settings