Display do Raspberry Pi não funciona? Correções de DSI, HDMI e touch para Pi 4 e Pi 5

Comece por aqui: qual conexão você está usando?

Percorra a seção da sua conexão na ordem apresentada. Cada passo elimina uma causa, e os primeiros passos são os que resolvem as falhas mais frequentes.

Display DSI: tela preta ou só backlight

1. Use o cabo flat correto para o seu Pi

O Raspberry Pi 5 tem um conector DSI menor do que os modelos anteriores, então o cabo que acompanha displays mais antigos não se encaixa nele. De acordo com a documentação do Raspberry Pi:

• Raspberry Pi 4 e anteriores: cabo flat flexível (FFC) de 15 vias para 15 vias.
• Raspberry Pi 5: FFC de 22 vias para 15 vias (Standard – Mini). A extremidade de 22 vias é a menor e vai conectada ao Pi; a extremidade maior vai conectada ao display.
• Touch Display 2, 10 polegadas, no Raspberry Pi 5: o FFC de 22 vias para 22 vias Mini – Mini fornecido com o produto.

Os modelos Raspberry Pi Zero não têm conector DSI, portanto um display DSI não pode ser usado neles de forma alguma.

2. Verifique se o cabo está bem encaixado e na posição correta

Abra a trava do conector, empurre o cabo até o fim e feche a trava. No Raspberry Pi 4B e anteriores, o conector do display é identificado como DISPLAY (não CAMERA), e os contatos metálicos ficam voltados para as portas Ethernet e USB-A. Um cabo invertido, parcialmente inserido ou conectado ao conector da câmera apresenta exatamente o mesmo sintoma de um painel defeituoso.

3. Alimente o display com 5 V próprios

Os displays oficiais são alimentados separadamente do cabo DSI:

• Touch Display original: jumper wires do header GPIO do Pi, preto no pino 6 (GND) e vermelho no pino 4 (5 V), ou no pino 2 se o pino 4 estiver em uso. Você pode usar uma fonte micro USB em vez disso, mas nesse caso não conecte também os fios de alimentação do GPIO.
• Touch Display 2: o cabo de alimentação GPIO fornecido, com a extremidade pequena na porta J1 do display, vermelho no pino 2 e preto no pino 6.

Se o backlight nunca acende, a alimentação é a primeira suspeita. Painéis de terceiros geralmente precisam de uma fonte separada para o backlight; consulte o diagrama de ligação do fabricante.

4. Não adicione uma linha dtoverlay que você não precisa

O Raspberry Pi OS vem com display_auto_detect=1 em /boot/firmware/config.txt, e com ele o firmware carrega automaticamente o overlay para displays DSI reconhecidos. Em um Raspberry Pi padrão, os displays oficiais portanto não precisam de linha dtoverlay. Adicionar uma manualmente, com o tamanho ou a porta errados, é uma causa comum de tela preta.

Os Raspberry Pi Compute Modules são diferentes: eles não fazem detecção automática de displays DSI, então você adiciona o overlay manualmente:

• Touch Display 2, 5 polegadas: dtoverlay=vc4-kms-dsi-ili9881-5inch
• Touch Display 2, 7 polegadas: dtoverlay=vc4-kms-dsi-ili9881-7inch
• Touch Display 2, 10 polegadas: dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• Touch Display original de 7 polegadas: dtoverlay=vc4-kms-dsi-7inch

O padrão é a porta identificada como 1; acrescente ,dsi0 para usar a porta 0 (por exemplo, dtoverlay=vc4-kms-dsi-7inch,dsi0). Para o display original, remova também qualquer linha display_auto_detect.

5. Painéis DSI de terceiros precisam do próprio overlay

A detecção automática cobre apenas os displays que o firmware reconhece. Um painel MIPI DSI de terceiros precisa de um device-tree overlay compatível com seu controlador, número de lanes e temporização, normalmente fornecido pelo fabricante do painel. Se o overlay do fabricante for voltado para um kernel mais antigo ou outro modelo de Pi, o painel pode permanecer preto mesmo com a fiação correta. Solicite um overlay testado no seu modelo exato de Pi e versão do sistema operacional. Nossas notas sobre displays para Raspberry Pi 5 e a visão geral de displays MIPI DSI explicam o que solicitar.

Display HDMI: "sem sinal" ou resolução errada

1. Use a primeira porta HDMI

No Raspberry Pi 4B e 5, a porta rotulada como HDMI0 na placa é a primeira saída de vídeo (HDMI-A-1 no Linux). Conecte um único display nela antes de testar qualquer outra coisa.

2. Configurações antigas de HDMI no config.txt não funcionam mais

Muitos guias ainda recomendam definir hdmi_force_hotplug, hdmi_group e hdmi_mode no config.txt. A documentação do Raspberry Pi agora lista essas opções como obsoletas, que "não funcionam com o Raspberry Pi OS Bookworm e versões posteriores". Com o driver gráfico KMS, o Linux gerencia todo o pipeline de vídeo, incluindo as saídas HDMI.

3. Force um modo com video= no cmdline.txt

Sem um modo definido, o Pi lê o EDID do display e escolhe uma resolução. Placas driver HDMI pequenas às vezes reportam um EDID que não corresponde ao painel, o que resulta em "sem sinal" ou imagem cortada. Force o modo nativo do painel adicionando um parâmetro video= à única linha do /boot/firmware/cmdline.txt, por exemplo video=HDMI-A-1:1024x600M@60 para um painel de 1024×600 a 60 Hz.

O formato é video=<display>:<width>x<height>M@<refresh>. Use HDMI-A-2 para a segunda porta HDMI e DSI-1 para um display DSI ou DPI. Obtenha a resolução e a taxa de atualização no datasheet do painel. Mantenha tudo no cmdline.txt em uma única linha.

Imagem rotacionada ou espelhada

• Desktop: Preferences > Control Centre > Screens, selecione o display e defina Orientation como Normal, Left, Inverted ou Right.
• Apenas console: estenda o parâmetro video=, por exemplo video=DSI-1:720x1280@60,rotate=90. Use reflect_x, reflect_y ou reflect_xy para espelhar.

Duas limitações: todos os displays conectados compartilham a mesma configuração de rotate=, e rotate= rotaciona apenas o console de texto. Aplicações que desenham diretamente via DRM, como cvlc ou os apps da libcamera, precisam da própria opção de rotação.

O toque não corresponde à imagem

No desktop, defina a orientação no Control Centre e o toque acompanha. Em uma configuração sem desktop com display rotacionado, adicione parâmetros de toque ao overlay do display no config.txt: invx e invy invertem um eixo, swapxy troca os eixos e disable_touch desliga o toque. Por exemplo, dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy inverte ambos os eixos em um Touch Display 2 de 7 polegadas.

Para o display original de 7 polegadas, remova display_auto_detect=1 ao adicionar um overlay de toque dessa forma. A Raspberry Pi observa que rotacionar o toque na device tree pode conflitar com sua biblioteca de entrada, então rotacione os eventos de toque na biblioteca ou no desktop sempre que possível.

A tela apaga após dez minutos

Isso é o screen blanking, não um defeito. Quando ativado, o Raspberry Pi OS apaga a tela após 600 segundos de inatividade. Desative em Control Centre (interruptor Screen Blanking) ou com sudo raspi-config > 2 Display Options > D2 Screen Blanking. Para um console de texto, adicione consoleblank=0 ao cmdline.txt para nunca apagar.

Quando o problema é o painel, não o Pi

Se o painel permanece escuro em um Pi sabidamente funcional com o cabo, a alimentação e as configurações corretas, meça a tensão do backlight e teste com um segundo painel antes de mexer no software. Para um produto, e não uma montagem única, escolha um painel cujo fornecedor forneça o overlay, o timing e a sequência de alimentação para o seu host exato. Nossa comparação de interfaces de display explica quando DSI ou HDMI é a melhor escolha para um projeto com Raspberry Pi.