• Overview
• Feature
• Specifications
• Package includes
• Install
  • Hardware Connection with Raspberry Pi 5
  • Hardware Connection with Raspberry Pi 4B/3B+/3B/3A+
• Software Settings
  • Method 1: Flash the Pre-installed Image (recommended)
  • Method 2: Flash Latest Bookworm System & Install the Driver Manually
• Adjust Rotation
• Adjusting Backlight Brightness

Buy from OSOYOO	Buy from US	Buy from UK	Buy from DE	Buy from IT	Buy from FR	Buy from ES	Buy from JP

Overview

With OSOYOO 10.1″ IPS DSI Touchscreen Display, experience breathtaking visuals on a vibrant 800×1280 IPS screen with an expansive 170° wide viewing angle, ensuring consistent, accurate colors from almost any perspective. Its durable 6H tempered glass panel provides superior scratch resistance and protection for long-lasting clarity. From its native HD portrait resolution perfect for developers, to its compatibility with the latest Bookworm OS, every feature is designed to enhance your workflow. The innovative all-in-one design features a protective back housing and a pair of easy-on, easy-off stands, creating a clean, grab-and-go workstation in seconds.

Whether you’re building a mobile server, a custom tablet, or a compact coding station, this display provides the performance, flexibility, and portability you need to bring your ideas to life.

Features

• 10.1 inch DSI touch screen
• IPS display panel with hardware resolution of 800×1280
• Toughened glass capacitive touch panel, hardness up to 6H
• Support drives the LCD directly via the DSI interface of the Raspberry Pi, and the refresh rate is up to 60Hz.
• Driver needed. Easy driver installation, and only supports the latest Bookworm system (Kernel 6.12 and later versions, Released on 2025-05-13)
• Supports all Raspberry Pi computers with DSI interfaces (Raspberry Pi 5/4/3/2)
• HIGH-SPEED DSI CONNECTION: Experience a flawless, low-latency display with the direct DSI interface. Supporting both 2-lane and 4-lane configurations, it delivers superior performance and lower power consumption compared to HDMI, freeing up your Pi’s HDMI port for other uses.
• ALL-IN-ONE PORTABLE DESIGN: OSOYOO 10.1″ IPS DSI monitor transform your Raspberry Pi into a sleek, portable workstation! Our custom-designed and non-detachable back case securely mounts your Pi (models 2/3/4/5); while the tool-free, detachable stand offers sturdy support anywhere you go. It’s the ultimate solution for a clutter-free, mobile setup.

Specifications

Note: Unmarked tolerance: ±0.20

Package includes:

Install

Hardware Connection with Raspberry Pi 5

1. Use the 22pin-0.5mm to 22pin-0.5mm DSI cable (for Pi5) to connect the DSI port of the display to the 22PIN DSI port of the Raspberry Pi motherboard.

2. Use 2pin connector to connect the power connector of the display to the 5V GND pin header of the Raspberry Pi motherboard.

3. Secure the Raspberry Pi to the display with M2.5 screws.

Note: Make sure that the DSI cable is connected in correct direction and 5V power is supplied through the GPIO pins.

Hardware Connection with Pi4B/3B+/3B/3A+

1. Use the 15pin-1mm to 22pin-0.5mm DSI cable (for Pi3/4) to connect the DSI port of the display to the 15PIN DSI port of the Raspberry Pi motherboard.

2. Use the 2pin connector to connect the power connector of the display to the 5V GND pin header of the Raspberry Pi motherboard.

3. Secure the Raspberry Pi to the display with M2.5 screws.

Note: Make sure that the DSI cable is connected in correct direction and 5V power is supplied through the GPIO pins.

Software Settings

Method 1: Flash the Pre-installed Image (recommended)

Note:
1.   This pre-install image is combined touch driver and Raspberry Pi OS with desktop (BOOKWORM version). If you have installed OS image, please don’t following this tutorial.
2.   If you want to learn how to install OS image, please follow our tutorial: https://osoyoo.com/?p=60151

Step 1: Download OSOYOO 800×1280 10.1 inch DSI Display pre-installed image file and unzip it. (Please download the file according to your Raspberry Pi board)

• OSOYOO-10-Pi3-4-2025-05-13-raspios-bookworm-arm64(For Rpi 3&4)
• OSOYOO-10-P5-2025-05-13-raspios-bookworm-arm64(For Rpi 5)

Step 2: Prepare a newly MicroSD memory card (TF card) with USB microSD card reader, recommend sizes are 8G, 16G, and 32G. Insert Micro SD card in USB micro SD card reader,  and connect USB micro SD card reader with your PC.

Method 2: Flash Latest Bookworm System Install the Driver Manually

Note:

1. This touch driver is based on Raspberry Pi OS with desktop (BOOKWORM version). Raspberry Pi OS Lite may not work with this touch driver.
2. If you want to learn how to install OS image, please follow our tutorial: https://osoyoo.com/?p=60151

Step 1. Burn the Raspberry Pi OS with desktop (BOOKWORM Version Kernel 6.12 and later versions, Released on 2025-05-13) (please download OS from Raspberry Pi official website,) in a TF card (more than 16GB), and insert this card in your raspberry Pi. (please confirm that the TF card have enough space for touch driver)

Note: If you use Raspberry Pi imager to burn OS, please select “use custom” to burn the Raspberry Pi OS (Legacy) with desktop you have download as following:

Step 2. Connect Raspberry Pi to your HDMI monitor or TV. Put a keyboard and mouse into Raspberry Pi USB ports, as following. (please don’t install 3.5″ SPI screen now, as it will show white screen)

Step 3. Getting the Raspberry Pi connected to the Internet (If you want to learn how to get the Raspberry Pi connected to the Internet, please visit https://osoyoo.com/2017/06/20/raspberry-pi-3-basic-tutorial/ )

Step 4. Open terminal, and enter the following command to get the Raspberry Pi’s IP address

hostname -I

Step 5. Use ssh tool to control Raspberry Pi remotely. Here we use putty. To learn more about how to use putty to control raspberry pi remotely, please click here.
Enter the IP address you got from the last step under Host Name (or IP address) and 22 under Port (by default it is 22) ,then click open, then login.

Step 6. Run the following command on the terminal to install the driver:

 wget https://osoyoo.com/driver/osoyoo_dsi.zip
 unzip osoyoo_dsi.zip
 cd osoyoo_dsi
 sudo su

When using the DSI1 interface or a device with only one DSI interface:

sudo bash ./install10.sh

When using the DSI0 interface:

sudo bash ./install10.sh dsi0

It will automatically detect the hardware model, kernel version, and install the appropriate driver files, and reboot.

Note

Since Pi5/CM5/CM4/CM3+/CM3 has two mipi DSI interfaces, please note that the correct DSI interfaces and commands are used, DSI1 is recommended by default.

Raspberry Pi5/CM5/CM4/CM3+/CM3 supports mipi dsi 4lanes mode, the 4lanes mode uses lower signal clock, and will reduce the EMI noises, increase the stability. They are recommended to use 4lanes mode.

The automatic driver installation uses the 2 Lanes MIPI mode by default. You can change the MIPI channel settings according to the DSI interface you are using by following these steps:

Please open /boot/firmware/config.txt file,

sudo nano /boot/firmware/config.txt

add the following overlay setting to the end of the file:

When using the DSI0 interface

dtoverlay=osoyoo-panel-dsi-10inch, dsi0, 4lane

When using the DSI1 interface

dtoverlay=osoyoo-panel-dsi-10inch, 4lane

Press “Ctrl + X” then “Y”, then enter to save this file, then run the following commend to reboot your Raspberry Pi

sudo reboot

Adjust Rotation

This screen support vertical view and horizontal view. Please follow the steps to change rotation:

1. Click “main menu” icon, then move to “Preferences” then to submenu “Screen Configuration”
   
2. In the pop window, click “Screens” thenmove to “DSI-2” (It’s different when you connect to different DSI port),then Orientation.Click the direction you need to rotate,and finally click Apply to complete the display and touch synchronous rotation.
   
3. click “OK” within 10 seconds to confirm your rotation
   

Adjusting Backlight Brightness

• 1. Open the “Screen Configuration” application;

• 2. Go to “Screen” -> “DSI-2” -> “Brightness”, check the backlight brightness you need to set, and finally click “Apply” to complete the backlight setting.

SAFETY INSTRUCTIONS

To avoid malfunction or damage to this product, please observe the following:
• Before connecting the device, shut down your Raspberry Pi computer and disconnect it from external power.
• Input voltages exceeding the maximum or improper operation may cause permanent damage to the device.
• The input current needs to be ≥ 0.5A, otherwise it will cause the startup failure or display abnormality, and staying in an abnormal state for a long time may cause permanent damage to the device.
• If the cable becomes detached, pull the locking mechanism forward on the connector, insert the ribbon cable with the metal contacts facing towards you, then push the locking mechanism back into place.
• This device should be operated in a dry environment at 0–50°C.
• Do not expose it to water or moisture, or place on a conductive surface whilst in operation.
• Do not expose it to excessive heat from any source.
• Care should be taken not to fold or strain the ribbon cable.
• Care should be taken when screwing in parts. A cross-thread can cause irreparable damage and void the warranty.
• Take care whilst handling to avoid mechanical or electrical damage to the printed circuit board and connectors.
• Store in a cool, dry location.
• Avoid rapid changes of temperature, which can cause moisture to build up in the device.
• The display surface is fragile and has the potential to shatter