| Buy from OSOYOO |
Buy from US |
Buy from UK |
Buy from DE |
Buy from IT |
Buy from FR |
Buy from ES |
Buy from JP |
 |
 |
 |
 |
 |
 |
 |
 |
Caution
- The DSI port of the OSOYOO 3.5-inch DSI V3.0 screen uses the same connector as the Raspberry Pi Official 7-inch DSI screen, and it is compatible with the DSI cable for the Raspberry Pi Official 7-inch DSI screen. Please pay attention to the contact points at the end of the DSI cable.
- Compared with V2.0, the 3.5-inch DSI V3.0 is engineered for optimal performance without overheating, even during extended use, ensuring reliability and durability for power-intensive applications.
- Please make sure your TF card (Micro SD) has enough space to write the system image.
- Do not touch your Raspberry Pi board when the power is on or when your hand carries static charge. (You can discharge static by touching a metal faucet or tap.)
Introduction
The 3.5″ DSI touchscreen is an IPS LCD display that connects to the Raspberry Pi through the DSI connector. It supports 5-point capacitive touch and is a true plug-and-play device — no driver installation needed. The physical resolution is 800×480.
The IPS panel reduces glare and gives a wide, clear viewing angle from every direction.
Features
- Version: V3.0 (the 3.5-inch DSI V3.0 is engineered for optimal performance without overheating, even during extended use, ensuring reliability and durability for power-intensive applications)
- Connects to the Raspberry Pi using the DSI interface
- IPS screen
- Refresh rate: 60 Hz
- Physical resolution: 800×480, 24-bit color
- 5-point capacitive touch (Raspbian OS supports 1 touch point)
- Plug and play — no driver needed
- Compatible with Raspberry Pi OS, Ubuntu, RetroPie, OctoPrint, and more
- Strong anti-interference design
- Ultra-low power consumption; lossless long-distance signal transmission
- Auto-sleep function
- Viewing angle: 85°/85°/85°/85° (L/R/U/D)
Datasheet
Download the size and dimension datasheet from: https://osoyoo.com/picture/3.5inch_DSI/2024008300/datasheet.pdf
User Guide
Parts Needed
You will need the following parts:
- 1× Raspberry Pi board
- 1× USB power adapter
- 1× USB power cable
- 1× 3.5″ DSI touchscreen with DSI cable
- 1× Micro SD card (new, 16 GB or larger)
- 1× TF card reader
How to Install the DSI Cable
Note:
1. The DSI port of the OSOYOO 3.5-inch DSI screen uses the same connector as the Raspberry Pi Official 7-inch DSI screen, and it is compatible with the DSI cable for the Raspberry Pi Official 7-inch DSI screen. Please pay attention to the contact points at the end of the DSI cable.
2. The 15-pin, 1 mm end is for the DSI port of the OSOYOO 3.5-inch DSI screen. Insert it with the contact points (metal side) facing up.
How to Install the OS
The 3.5″ DSI LCD supports OS images such as Raspberry Pi OS, Ubuntu, RetroPie, and OctoPrint.
To install an OS on your Raspberry Pi, follow the steps below. (To learn more about flashing OS images, visit: https://osoyoo.com/?p=56660/#1)
First, download the OS image to your computer from the official Raspberry Pi website: https://www.raspberrypi.org/downloads/
Second, unzip the OS image and install an image writer tool. We recommend Raspberry Pi Imager: https://www.raspberrypi.com/software/
Third, insert the SD card into the card reader and connect it to your computer. Open Raspberry Pi Imager, select the OS image and your device, then click “Write,” as shown below:
Fourth, insert the SD card into the Raspberry Pi board and connect the 3.5″ DSI touchscreen.
Finally, power up the board and wait for the system to boot. (Note: Do not touch the Raspberry Pi board when the power is on or when your hand carries static charge.)
Advanced Tips
How to add a virtual keyboard on the screen
(Note: This method only supports older versions of Raspberry Pi OS. The latest Raspberry Pi Bookworm OS desktop comes with a virtual keyboard pre-installed.)
The touchscreen works as a mouse device. To type text on the Raspberry Pi, you normally need a USB keyboard, which can be inconvenient.
Is there a way to use the touchscreen itself as a text input device, just like a smartphone? Yes! You can install a virtual keyboard to replace the USB keyboard.
Here are the steps:
Step 1) Install matchbox-keyboard by typing the following commands in the Pi terminal:
sudo apt update
sudo apt upgrade
sudo apt install matchbox-keyboard
Step 2) Click the Raspberry Pi icon in the top-left corner:
Step 3) Click Accessories → Keyboard:
A virtual keyboard will pop up:
For more details about matchbox-keyboard installation, see:
https://osoyoo.com/2019/04/09/osoyoo-7inch-hdmi-touchscreen-keyboard-matchbox-keyboard/
How to adjust the virtual resolution
(Note: This method only works on Raspberry Pi Legacy OS. On Raspberry Pi Bookworm OS, the DSI screen resolution cannot be adjusted.)
The physical resolution is 800×480, but you can set the virtual resolution up to 1920×1080. Open the Micro SD card with your OS installed and open /boot/config.txt in Notepad++ or a text editor. Find these lines:
To use 1920×1080, change and save the file as follows:
framebuffer_width=1920
framebuffer_height=1080
Note: If you are using Raspberry Pi 4, you also need to comment out this line in /boot/config.txt: #dtoverlay=vc4-kms-v3d
How to adjust the display orientation
(Note: This method works with Raspberry Pi Legacy OS.)
LCD displays have an optimal viewing angle. Depending on how your screen is mounted, you may need to change the display orientation. By default, the Raspberry Pi display is set for viewing from slightly above. If viewing from below, physically rotate the display and configure the software to match.
To rotate the display, first run:
sudo nano /boot/config.txt
Add the lines for your desired rotation:
1) For 0° rotation: (no additional entries — default setting)
2) For 90° rotation (top to right):
display_lcd_rotate=1
dtoverlay=rpi-ft5406,touchscreen-swapped-x-y=1,touchscreen-inverted-x=1
3) For 180° rotation (upside down):
display_lcd_rotate=2
dtoverlay=rpi-ft5406,touchscreen-inverted-x=1,touchscreen-inverted-y=1
4) For 270° rotation (top to left):
display_lcd_rotate=3
dtoverlay=rpi-ft5406,touchscreen-swapped-x-y=1,touchscreen-inverted-y=1
After adding the lines, press Ctrl-X, then Y, then Enter to save, then run sudo reboot.
This rotates both the display and the touchscreen to match your physical mounting.
How to adjust the brightness
Method 1)
The following steps are based on Raspbian.
(1) Run the following command in the terminal to switch to administrator:
sudo su root
(2) Run the following command to set the display brightness (change 100 to any value from 0 to 255):
echo 100 > /sys/class/backlight/rpi_backlight/brightness
Note: If brightness adjustment fails, check for the line disable_touchscreen=1 in /boot/config.txt and comment it out: #disable_touchscreen=1
Method 2)
Step 1) Install the brightnessctl software:
sudo apt install brightnessctl
Step 2) Run the following command to change the brightness:
sudo brightnessctl set 100%
The value can range from 0% (darkest) to 100% (brightest).
