← Back to Product Introduction

Table of Contents

1. Supported Hardware & OS

Item Details
Display Panels OSOYOO 7″ DSI Touchscreen (#2025001200)
Supported Boards Raspberry Pi 3 / 4 / 5, CM3 / CM4 / CM5
Operating System Raspberry Pi OS Bookworm / Trixie (Kernel 6.12+)

Note: Make sure your hardware is connected correctly before proceeding. Refer to the Hardware Connection section in the product introduction if needed.

2 Direct Installation via Git (Recommended)

This is the recommended method. Run the following commands on your Raspberry Pi:

# Clone the repository
git clone https://github.com/osoyoo/osoyoo-dsi-panel.git
cd osoyoo-dsi-panel

# Run direct installation script
bash install-direct.sh display7inch

In the end, the bash program will ask you to confirm reboot, after you reboot the Raspberry Pi, the 7″ 720×800 screen will display OS UI.



 




3. Backlight Brightness Control


3.1 GUI Method


Screen Configuration


    

  1. Open the Screen Configuration application from the desktop menu.
    2. 

  2. Click Screen → DSI-2 (or DSI-1 depending on your setup) → Brightness.
    3. 

  3. Adjust the slider and click Apply.
    4. 



Brightness settings


Brightness control


3.2 Command Line Method


Set brightness via terminal (value range: 0 = darkest, 255 = brightest):


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



Replace X with your desired value, for example:


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



Brightness control demo


3.3 Brightness Demo Application


A demo application is also available:


wget https://osoyoo.com/driver/Brightness.zip
unzip Brightness.zip
cd Brightness
sudo chmod +x install.sh
./install.sh





4. Touchscreen Rotation (Bookworm & Trixie)


Touchscreen configuration


    

  1. Open Screen Configuration.
    2. 

  2. Click Screen → DSI-1 → Touchscreen.
    3. 

  3. Select 10-0014 Goodix Capacitive TouchScreen and click Apply.
    4. 

  4. Reboot when prompted.
    5. 



Apply settings


Rotation prompt


After reboot, to change screen orientation:


    

  1. Open Screen Configuration → Screen → DSI-1 → Orientation.
    2. 

  2. Select your desired direction and click Apply.
    3. 



Orientation settings




5. Uninstallation


To remove the driver, navigate to the cloned repository folder and run:


cd osoyoo-dsi-panel
sudo ./uninstall.sh



Or if installed via .deb package:


sudo dpkg -r osoyoo-dsi-panel-dkms





6. Troubleshooting






Issue
Possible Cause
Solution




Display does not turn on
Driver not loaded or overlay missing
Run lsmod | grep osoyoo to check; verify overlay is added to config.txt




Driver build fails
Kernel headers missing
Run sudo apt install raspberrypi-kernel-headers




Touch not working
Touchscreen not configured
Follow the Touchscreen Rotation section to configure the Goodix touch device




Model detection error
Incompatible board or kernel
Ensure you are using Raspberry Pi OS Bookworm or Trixie with Kernel 6.12+








7. Support



← Back to Product Introduction