← 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, Compute Module 3,4,5 |
| 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
bash install-direct.sh display7inch
note: if you are using OSOYOO 10.1 inch screen or 3.5″ DSI screen, you can change the parameter display7inch to display10inch or display3.5inch
Wait for the installation to complete before proceeding to the configuration step.
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
