| Acquista da OSOYOO | Acquista negli USA |
Hardware: Raspberry Pi 3/4B / 5
Schermo: OSOYOO Touchscreen DSI 3,5″ 480×800 V4.0 (N° modello: 2026005500)
Sistema: Raspberry Pi OS Bookworm / Trixie 64bit (Versione: 2025-10-01 e successive)
IndiceScelta della scheda e del cavo: i Raspberry Pi 4B / 3B+ / 3B / 2B hanno un unico connettore DISPLAY a 15 pin e usano un cavo da 15 a 15 pin; il Raspberry Pi 5 ha due connettori DISP0 / DISP1 a 22 pin e richiede un cavo da 22 a 15 pin. Il Compute Module (CM4 / CM5) dipende dal connettore della scheda portante. I Raspberry Pi Zero / Zero 2 W non hanno connettori DSI e non sono compatibili.
Nota: collega e scollega sempre il cavo a dispositivo spento. Se l’alimentazione tramite il cavo è insufficiente (sfarfallio / touch non reattivo / schermo nero), usa il cavo in dotazione per collegare il 5V del display al pin 5V del Raspberry Pi e GND al pin GND (vedi il Manuale del prodotto, Alimentazione).

Nota: questo prodotto richiede l’installazione del driver prima dell’uso. Il driver è open source e un unico script fa tutto (rileva automaticamente il modello di Pi, installa le dipendenze, compila e aggiorna /boot/firmware/config.txt).
Prima di installare il driver del display, assicurati che il tuo Raspberry Pi sia configurato correttamente e accessibile da remoto.
1. Apri un terminale sul tuo PC tramite il client SSH ed esegui i seguenti comandi uno alla volta:
sudo apt update git clone https://github.com/osoyoo/osoyoo-dsi-panel.git cd osoyoo-dsi-panel ./install-direct.sh display3.5inch
2. Lo script chiede di riavviare alla fine — scegli sì (oppure esegui sudo reboot). Dopo il riavvio il display funziona e il touch è attivo.




3. Pi 5 / CM5 (due porte DSI): aggiungi dsi0 o dsi1 a seconda della porta a cui è collegato il cavo:
./install-direct.sh display3.5inch dsi0 # pannello sulla porta DISP0 ./install-direct.sh display3.5inch dsi1 # pannello sulla porta DISP1

4. Il Pi 3 / Pi 4 ha una sola porta DSI, quindi questo argomento non è necessario. In caso di dubbio, esegui senza argomento; se il pannello rimane nero, riesegui con l’altra porta. Il Compute Module (CM4 / CM5) si installa allo stesso modo (una piattaforma CM non rileva automaticamente il DSI — deve essere impostato in config.txt, il che viene fatto automaticamente dallo script).
Verifica dopo il riavvio:
cat /sys/class/backlight/*/display_name # mostra un connettore DSI, es. DSI-1 / DSI-2 sudo dmesg | grep -i osoyoo # mostra il pannello associato
Suggerimento: esegui come utente normale — non compilare come root (sudo su); lo script usa sudo solo dove necessario. Sii paziente al primo avvio; se lo schermo rimane nero a lungo, verifica che il cavo sia inserito correttamente, che l’alimentazione sia sufficiente e che la porta DSI corrisponda al comando.
(Nei menu sottostanti, DSI-1 potrebbe apparire come DSI-2 su un Pi 5 — usa il connettore mostrato.)
1) Regolazione tramite interfaccia grafica
Sul desktop, apri Menu principale → Preferenze → Configurazione schermo, seleziona Schermo → DSI-1 → Luminosità, trascina il cursore per regolare in tempo reale e clicca su Applica per salvare.



2) Regolazione della luminosità dal terminale
Senza desktop o per un controllo tramite script, usa la riga di comando:
#install the brightnessctl sudo apt-get install brightnessctl -y # set brightness by percentage brightnessctl set 60% # You can change 60 to a value between 0 and 100. # or write the brightness value directly (max value depends on the device, the max value is 31) echo 20 | sudo tee /sys/class/backlight/*/brightness # You can change 20 to a value between 0 and 31.
1) Rotazione tramite interfaccia grafica
Sul desktop, per fare in modo che il touch ruoti insieme al display, associa il dispositivo touch una volta:






Suggerimento: una volta associato, il touch segue automaticamente ogni rotazione del display. Se è collegato anche un monitor HDMI, il touch potrebbe estendersi su tutto il desktop multi-monitor e finire nel posto sbagliato; in tal caso associa il touch all’uscita di questo pannello (vedi la nota labwc nel README del repository open source).
2) Rotazione in versione Lite (senza interfaccia grafica)
Su Raspberry Pi OS Lite (riga di comando), aggiungi un parametro di rotazione alla riga dtoverlay che lo script di installazione ha inserito in /boot/firmware/config.txt, ad esempio:
# rotate 90 degrees (0 / 90 / 180 / 270) dtoverlay=osoyoo-panel-st7701s-3p5inch,rotation=90
Salva e riavvia per applicare le modifiche.
Il touch è calibrato sull’orientamento predefinito in fabbrica. Se, in un particolare orientamento di montaggio, la direzione del touch non corrisponde al movimento del dito, aggiungi un parametro di direzione touch alla riga dtoverlay in /boot/firmware/config.txt:
# append as needed: invx (flip left/right) / invy (flip up/down) / swapxy (swap X/Y) dtoverlay=osoyoo-panel-st7701s-3p5inch,invx
Salva, riavvia e prova le opzioni una alla volta finché il touch non corrisponde al dito.
Multi-touch: con il Raspberry Pi OS ufficiale, questo display funziona come schermo single-touch; il supporto al multi-touch e ai gesti dipende dalla versione del sistema operativo e dall’applicazione specifica.
Quando non è disponibile una tastiera fisica, abilita la tastiera su schermo: apri Preferenze → Configurazione Raspberry Pi → Display e attiva la Tastiera su schermo; tocca un campo di testo per farla comparire.
Pagine correlate: Manuale del prodotto | Guida installazione driver Ubuntu | Utilizzo con ESP32‑P4
Supporto: [email protected] | osoyoo.com
OSOYOO Touchscreen DSI da 3,5 pollici – versione documento v1.2
DownLoad Url osoyoo.com