라즈베리 파이 디스플레이가 안 될 때? Pi 4·Pi 5를 위한 DSI, HDMI, 터치 문제 해결 가이드

먼저 확인: 어떤 연결 방식을 사용하시나요?

사용 중인 연결 방식에 해당하는 섹션을 순서대로 진행하세요. 각 단계는 원인을 하나씩 배제해 나가며, 초반 단계가 가장 자주 문제가 되는 부분입니다.

DSI 디스플레이: 검은 화면 또는 백라이트만 표시

1. Pi에 맞는 플랫 케이블을 사용하세요

Raspberry Pi 5는 이전 모델보다 DSI 커넥터가 작기 때문에 구형 디스플레이에 동봉된 케이블은 맞지 않습니다. Raspberry Pi 공식 문서에 따르면:

• Raspberry Pi 4 및 이전 모델: 15핀-15핀 FFC(플랫 플렉시블 케이블).
• Raspberry Pi 5: 22핀-15핀 FFC(Standard – Mini). 22핀 쪽이 작은 단자로 Pi에 연결되고, 큰 단자는 디스플레이 쪽에 연결됩니다.
• 터치 디스플레이 2 10인치 + Raspberry Pi 5: 동봉된 22핀-22핀 Mini – Mini FFC.

Raspberry Pi Zero 모델에는 DSI 커넥터가 없으므로 DSI 디스플레이를 사용할 수 없습니다.

2. 케이블이 완전히, 올바른 방향으로 삽입되었는지 확인

커넥터의 고정 클립을 열고 케이블을 끝까지 밀어 넣은 뒤 클립을 닫으세요. Raspberry Pi 4B 및 이전 모델에서 디스플레이 커넥터는 DISPLAY로 표시되어 있고(CAMERA가 아님), 금속 접점이 이더넷 및 USB-A 포트 쪽을 향해야 합니다. 케이블이 거꾸로 삽입되었거나 반쯤 들어가 있거나 카메라 커넥터에 꽂혀 있어도 패널이 완전히 고장난 것과 똑같은 증상이 나타납니다.

3. 디스플레이에 별도의 5 V 전원 공급

공식 디스플레이는 DSI 케이블과 별도로 전원을 공급받습니다:

• 기존 터치 디스플레이: Pi의 GPIO 헤더에서 점퍼 와이어로 연결, 검은색은 6번 핀(GND), 빨간색은 4번 핀(5 V)에 연결하며, 4번 핀이 사용 중이면 2번 핀에 연결합니다. 마이크로 USB 전원 어댑터를 사용할 수도 있지만, 그 경우 GPIO 전원 와이어는 절대 함께 연결하지 마세요.
• 터치 디스플레이 2: 동봉된 GPIO 전원 케이블의 작은 단자를 디스플레이의 J1 포트에 연결하고, 빨간색은 2번 핀, 검은색은 6번 핀에 연결합니다.

백라이트가 전혀 켜지지 않는다면 전원이 첫 번째 의심 대상입니다. 서드파티 패널은 백라이트에 별도 전원이 필요한 경우가 많으므로 제조사의 배선도를 확인하세요.

4. 필요 없는 dtoverlay 라인은 추가하지 마세요

Raspberry Pi OS에는 /boot/firmware/config.txt에 display_auto_detect=1이 기본 포함되어 있어, 인식되는 DSI 디스플레이용 오버레이를 펌웨어가 자동으로 로드합니다. 따라서 표준 라즈베리 파이에서는 공식 디스플레이에 dtoverlay 라인이 필요 없습니다. 잘못된 크기나 잘못된 포트용 라인을 수동으로 추가하는 것이 검은 화면의 흔한 원인입니다.

Raspberry Pi Compute 모듈은 다릅니다. DSI 디스플레이를 자동 감지하지 않으므로 직접 오버레이를 추가해야 합니다:

• 터치 디스플레이 2, 5인치: dtoverlay=vc4-kms-dsi-ili9881-5inch
• 터치 디스플레이 2, 7인치: dtoverlay=vc4-kms-dsi-ili9881-7inch
• 터치 디스플레이 2, 10인치: dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• 기존 7인치 터치 디스플레이: dtoverlay=vc4-kms-dsi-7inch

기본값은 1로 표시된 포트이며, 0번 포트를 사용하려면 ,dsi0을 추가합니다(예: dtoverlay=vc4-kms-dsi-7inch,dsi0). 기존 디스플레이의 경우 display_auto_detect 라인도 모두 제거하세요.

5. 서드파티 DSI 패널에는 전용 오버레이가 필요합니다

자동 감지는 펌웨어가 인식하는 디스플레이에만 적용됩니다. 서드파티 MIPI DSI 패널은 컨트롤러, 레인 수, 타이밍에 맞는 디바이스 트리 오버레이가 필요하며, 이는 일반적으로 패널 제조사에서 제공합니다. 제조사의 오버레이가 구형 커널이나 다른 Pi 모델을 대상으로 한다면, 배선이 올바르더라도 패널이 검은 화면으로 남을 수 있습니다. 사용하시는 정확한 Pi 모델과 OS 릴리스에서 테스트된 오버레이를 요청하세요. 당사의 Raspberry Pi 5 디스플레이 노트와 MIPI DSI 디스플레이 개요에서 요청 시 확인할 사항을 다루고 있습니다.

HDMI 디스플레이: "신호 없음" 또는 잘못된 해상도

1. 첫 번째 HDMI 포트를 사용하세요

라즈베리 파이 4B와 5에서는 보드에 HDMI0로 표시된 포트가 첫 번째 디스플레이 출력(Linux에서 HDMI-A-1)입니다. 다른 것을 테스트하기 전에 디스플레이를 이 포트 하나에 연결하세요.

2. 예전 config.txt HDMI 설정은 더 이상 작동하지 않습니다

많은 가이드에서 아직도 config.txt에 hdmi_force_hotplug, hdmi_group, hdmi_mode를 설정하라고 안내합니다. 라즈베리 파이 공식 문서는 이제 이 옵션들을 "Raspberry Pi OS Bookworm 이상에서는 작동하지 않는" 레거시 옵션으로 분류합니다. KMS 그래픽 드라이버에서는 Linux가 HDMI 출력을 포함한 전체 디스플레이 파이프라인을 관리합니다.

3. cmdline.txt에서 video=로 모드 강제 지정

모드를 지정하지 않으면 Pi는 디스플레이의 EDID를 읽어 해상도를 결정합니다. 소형 HDMI 드라이버 보드는 패널과 일치하지 않는 EDID를 보고하는 경우가 있어 "신호 없음" 또는 잘린 화면이 나타날 수 있습니다. /boot/firmware/cmdline.txt의 한 줄에 video= 파라미터를 추가해 패널의 네이티브 모드를 강제 지정하세요. 예를 들어 1024×600 60 Hz 패널이라면 video=HDMI-A-1:1024x600M@60을 사용합니다.

형식은 video=<display>:<width>x<height>M@<refresh>입니다. 두 번째 HDMI 포트에는 HDMI-A-2, DSI 또는 DPI 디스플레이에는 DSI-1을 사용하세요. 해상도와 재생률(refresh rate)은 패널 데이터시트에서 확인하고, cmdline.txt의 모든 내용은 반드시 한 줄에 유지하세요.

화면이 회전되거나 미러링되는 경우

• 데스크톱: Preferences > Control Centre > Screens에서 해당 디스플레이를 선택한 뒤 Orientation을 Normal, Left, Inverted 또는 Right로 설정합니다.
• 콘솔 전용: video= 파라미터를 확장합니다. 예를 들어 video=DSI-1:720x1280@60,rotate=90과 같이 지정합니다. 미러링하려면 reflect_x, reflect_y 또는 reflect_xy를 사용합니다.

두 가지 제한이 있습니다. 연결된 모든 디스플레이가 동일한 rotate= 설정을 공유하며, rotate=는 텍스트 콘솔만 회전합니다. cvlc나 libcamera 앱처럼 DRM에 직접 출력하는 애플리케이션은 자체 회전 옵션을 사용해야 합니다.

터치가 화면과 일치하지 않는 경우

데스크톱에서는 Control Centre에서 방향을 설정하면 터치가 이를 따라갑니다. 회전된 디스플레이를 쓰는 비(非)데스크톱 환경에서는 config.txt의 해당 디스플레이 오버레이에 터치 파라미터를 추가합니다. invx와 invy는 축을 반전하고, swapxy는 축을 맞바꾸며, disable_touch는 터치를 비활성화합니다. 예를 들어 dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy는 7인치 Touch Display 2에서 두 축을 모두 반전합니다.

초기 7인치 디스플레이의 경우, 이 방식으로 터치 오버레이를 추가할 때는 display_auto_detect=1을 제거하세요. 라즈베리 파이에 따르면 디바이스 트리에서 터치를 회전하면 입력 라이브러리와 충돌할 수 있으므로, 가능하면 라이브러리나 데스크톱 쪽에서 터치 이벤트를 회전하는 것이 좋습니다.

10분 후 화면이 검게 꺼지는 경우

이것은 고장이 아니라 화면 블랭킹입니다. 활성화된 경우 Raspberry Pi OS는 600초 동안 입력이 없으면 화면을 블랭킹합니다. Control Centre의 Screen Blanking 토글에서 끄거나, sudo raspi-config > 2 Display Options > D2 Screen Blanking에서 끌 수 있습니다. 텍스트 콘솔에서는 cmdline.txt에 consoleblank=0을 추가하면 화면이 꺼지지 않습니다.

Pi가 아니라 패널이 문제인 경우

정상 동작이 확인된 Pi에 올바른 케이블, 전원, 설정을 갖춰도 패널이 계속 어두우면, 소프트웨어를 손보기 전에 백라이트 전원을 측정하고 다른 패널로 교체해 보세요. 일회성 제작이 아닌 제품용이라면, 사용하는 호스트에 맞는 오버레이, 타이밍, 전원 시퀀스를 제공하는 공급사의 패널을 선택하세요. 디스플레이 인터페이스 비교에서 라즈베리 파이 설계에 DSI와 HDMI 중 어느 쪽이 더 적합한지 설명합니다.