Il display del Raspberry Pi non funziona? Correzioni per DSI, HDMI e touch su Pi 4 e Pi 5

Iniziate da qui: quale connessione state usando?

Procedete in ordine nella sezione relativa alla vostra connessione. Ogni passaggio esclude una causa, e i primi passaggi sono quelli che più spesso risolvono il problema.

Display DSI: schermo nero o solo retroilluminazione

1. Usate il nastro flessibile adatto al vostro Pi

Il Raspberry Pi 5 ha un connettore DSI più piccolo rispetto ai modelli precedenti, quindi il cavo in dotazione con i display più datati non è compatibile. Secondo la documentazione di Raspberry Pi:

• Raspberry Pi 4 e precedenti: cavo flessibile (FFC) a 15 vie per 15 vie.
• Raspberry Pi 5: FFC da 22 vie a 15 vie (Standard – Mini). L'estremità a 22 vie è quella più piccola e va inserita nel Pi; l'estremità più grande va inserita nel display.
• Touch Display 2 da 10 pollici su Raspberry Pi 5: il cavo FFC Mini – Mini a 22 vie per 22 vie fornito in dotazione.

I modelli Raspberry Pi Zero sono privi di connettore DSI, quindi su di essi non è possibile usare affatto un display DSI.

2. Verificate che il cavo sia ben inserito e nel verso corretto

Aprite la clip di ritenzione del connettore, inserite a fondo il cavo e richiudete la clip. Su Raspberry Pi 4B e modelli precedenti il connettore del display è etichettato DISPLAY (non CAMERA), e i contatti metallici devono essere rivolti verso le porte Ethernet e USB-A. Un cavo invertito, inserito solo a metà o collegato al connettore della camera produce esattamente lo stesso sintomo di un pannello guasto.

3. Alimentate il display separatamente a 5 V

I display ufficiali si alimentano in modo separato rispetto al cavo DSI:

• Touch Display originale: fili jumper dall'header GPIO del Pi, nero al pin 6 (GND) e rosso al pin 4 (5 V), oppure al pin 2 se il pin 4 è occupato. In alternativa potete usare un alimentatore micro USB, ma in tal caso non collegate anche i fili di alimentazione GPIO.
• Touch Display 2: il cavo di alimentazione GPIO in dotazione, estremità piccola nella porta J1 del display, rosso al pin 2 e nero al pin 6.

Se la retroilluminazione non si accende mai, l'alimentazione è il primo sospetto. I pannelli di terze parti richiedono spesso un'alimentazione separata per la retroilluminazione; verificate lo schema di collegamento del fornitore.

4. Non aggiungete una riga dtoverlay di cui non avete bisogno

Raspberry Pi OS include display_auto_detect=1 in /boot/firmware/config.txt, e grazie a questa impostazione il firmware carica automaticamente l'overlay per i display DSI riconosciuti. Su un Raspberry Pi standard, i display ufficiali quindi non richiedono alcuna riga dtoverlay. Aggiungerne una a mano, con dimensioni o porta errate, è una causa frequente di schermo nero.

I Raspberry Pi Compute Modules sono diversi: non rilevano automaticamente i display DSI, quindi l'overlay va aggiunto manualmente:

• Touch Display 2, 5 pollici: dtoverlay=vc4-kms-dsi-ili9881-5inch
• Touch Display 2, 7 pollici: dtoverlay=vc4-kms-dsi-ili9881-7inch
• Touch Display 2, 10 pollici: dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• Touch Display originale da 7 pollici: dtoverlay=vc4-kms-dsi-7inch

La porta predefinita è quella etichettata 1; aggiungete ,dsi0 per usare la porta 0 (ad esempio dtoverlay=vc4-kms-dsi-7inch,dsi0). Per il display originale rimuovete inoltre qualsiasi riga display_auto_detect.

5. I pannelli DSI di terze parti richiedono un overlay dedicato

Il rilevamento automatico copre solo i display riconosciuti dal firmware. Un pannello MIPI DSI di terze parti richiede un device-tree overlay compatibile con il suo controller, il numero di lane e i timing, normalmente fornito dal produttore del pannello. Se l'overlay del fornitore è destinato a un kernel più vecchio o a un altro modello di Pi, il pannello può restare nero anche con cablaggio corretto. Richiedete un overlay testato sul vostro esatto modello di Pi e versione di OS. Le nostre note sui display per Raspberry Pi 5 e la panoramica sui display MIPI DSI illustrano cosa richiedere.

Display HDMI: "nessun segnale" o risoluzione errata

1. Usare la prima porta HDMI

Su Raspberry Pi 4B e 5, la porta etichettata HDMI0 sulla scheda è la prima uscita video (HDMI-A-1 in Linux). Collegare un singolo display lì prima di eseguire qualsiasi altro test.

2. Le vecchie impostazioni HDMI di config.txt non funzionano più

Molte guide raccomandano ancora di impostare hdmi_force_hotplug, hdmi_group e hdmi_mode in config.txt. La documentazione di Raspberry Pi ora li elenca come opzioni legacy che "non funzionano con Raspberry Pi OS Bookworm e versioni successive". Con il driver grafico KMS, Linux gestisce l'intera pipeline del display, comprese le uscite HDMI.

3. Forzare una modalità con video= in cmdline.txt

Senza una modalità impostata, il Pi legge l'EDID del display e sceglie una risoluzione. Le piccole schede driver HDMI a volte riportano un EDID che non corrisponde al pannello, con conseguente "nessun segnale" o immagine tagliata. Forzare la modalità nativa del pannello aggiungendo un parametro video= alla singola riga in /boot/firmware/cmdline.txt, ad esempio video=HDMI-A-1:1024x600M@60 per un pannello da 1024×600 a 60 Hz.

Il formato è video=<display>:<width>x<height>M@<refresh>. Usare HDMI-A-2 per la seconda porta HDMI e DSI-1 per un display DSI o DPI. Prendere risoluzione e frequenza di aggiornamento dal datasheet del pannello. Mantenere tutto in cmdline.txt su una sola riga.

Immagine ruotata o specchiata

• Desktop: Preferences > Control Centre > Screens, selezionare il display, quindi impostare Orientation su Normal, Left, Inverted o Right.
• Solo console: estendere il parametro video=, ad esempio video=DSI-1:720x1280@60,rotate=90. Usare reflect_x, reflect_y o reflect_xy per ottenere l'effetto specchio.

Due limitazioni: tutti i display collegati condividono la stessa impostazione rotate=, e rotate= ruota solo la console testuale. Le applicazioni che disegnano direttamente su DRM, come cvlc o le app libcamera, richiedono una propria opzione di rotazione.

Il touch non corrisponde all'immagine

Sul desktop, impostando l'orientamento nel Control Centre, il touch segue automaticamente. In una configurazione non desktop con display ruotato, aggiungere i parametri touch all'overlay del display in config.txt: invx e invy invertono un asse, swapxy li scambia, e disable_touch disattiva il touch. Ad esempio, dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy inverte entrambi gli assi su un Touch Display 2 da 7 pollici.

Per il display originale da 7 pollici, rimuovere display_auto_detect=1 quando si aggiunge un overlay touch in questo modo. Raspberry Pi segnala che la rotazione del touch nel device tree può entrare in conflitto con la propria libreria di input, quindi ruotare gli eventi touch nella libreria o nel desktop dove possibile.

Lo schermo diventa nero dopo dieci minuti

Si tratta dello screen blanking, non di un guasto. Quando è attivo, Raspberry Pi OS spegne lo schermo dopo 600 secondi di inattività. Disattivarlo in Control Centre (interruttore Screen Blanking) o con sudo raspi-config > 2 Display Options > D2 Screen Blanking. Per una console testuale, aggiungere consoleblank=0 a cmdline.txt per non spegnere mai lo schermo.

Quando è il pannello, non il Pi

Se il pannello resta scuro su un Pi funzionante con cavo, alimentazione e impostazioni corretti, misurare l'alimentazione della retroilluminazione e sostituire il pannello con un secondo prima di intervenire sul software. Per un prodotto piuttosto che un prototipo singolo, scegliere un pannello il cui fornitore fornisca overlay, timing e sequenza di alimentazione per lo specifico host. Il nostro confronto tra interfacce display spiega quando DSI o HDMI è la scelta migliore per un design basato su Raspberry Pi.