← Back to Product Introduction

Table of Contents

1. Supported Hardware & OS

Item Details
Display Panels OSOYOO 7″ DSI Touchscreen (#2025001200)
Supported Boards Raspberry Pi 5, Compute Module 5 (CM5)
Operating System Ubuntu 24.04, Ubuntu 25.10
Supported Kernels 6.8.x, 6.17.x and newer

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

2. Driver Installation

Run the following commands on your Raspberry Pi to install the driver:

cd ~
sudo apt update
sudo apt install git -y
git clone https://github.com/osoyoo/osoyoo_dsi_ubuntu.git
cd osoyoo_dsi_ubuntu
sudo ./install-direct.sh

Wait for the installation to complete before proceeding to the configuration step.

3. Configuration

After installation, edit /boot/firmware/config.txt:

sudo nano /boot/firmware/config.txt

Make the following changes:

  1. Find the line display_auto_detect=1 and change it to: 
    display_auto_detect=0
  2. After the i2c settings section, add: 
    dtparam=i2c_arm_baudrate=100000
  3. Add the overlay for the 7″ panel: 
    dtoverlay=osoyoo-panel-dsi-7inch

    If your board uses DSI1 with 4 lanes (e.g. CM5), use instead:

    dtoverlay=osoyoo-panel-dsi-7inch,dsi1,4lane

Save and close the file (in nano: Ctrl+O, then Enter, then Ctrl+X).

4. Reboot & Verify

Reboot the system:

sudo reboot

After rebooting, verify that the driver is loaded:

lsmod | grep osoyoo

If the driver is loaded correctly, the display should be active and showing the Ubuntu desktop.

5. Troubleshooting

Issue Possible Cause Solution
Display does not turn on after reboot Overlay missing or incorrect Verify the overlay line in /boot/firmware/config.txt; ensure display_auto_detect=0 is set
lsmod | grep osoyoo returns nothing Driver not loaded Re-run sudo ./install-direct.sh and check for errors during installation
Installation script fails Missing build tools or kernel headers Run sudo apt install build-essential linux-headers-$(uname -r) and retry
Touch not working I2C baudrate not configured Ensure dtparam=i2c_arm_baudrate=100000 is present in config.txt
Board not detected Unsupported board or OS version This driver supports Raspberry Pi 5 and CM5 only with Ubuntu 24.04 / 25.10

6. Support

← Back to Product Introduction