まずはここから：どの接続方式を使っていますか？
接続方式 | 代表的な症状 | 最初に確認する項目 |
|---|---|---|
MIPI DSIフレキケーブル（公式Touch Display、5〜10インチ級パネルの多く） | バックライトが点かない、または点いているのに真っ暗 | ケーブルの種類と向き、ディスプレイの電源、 |
HDMI（モニター、HDMIドライバーボード） | 「信号なし」、解像度がおかしい、起動後に真っ暗 | 使用ポート、 |
GPIOヘッダーのSPI（2.4〜3.5インチの小型パネル） | ホワイト画面、デスクトップ起動後に何も表示されない | パネルベンダー提供のドライバーとオーバーレイ |
お使いの接続方式のセクションを順番に進めてください。各ステップで原因を一つずつ切り分けられます。特に前半のステップは、実際に失敗しているケースが最も多い項目です。
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に接続します。大きい側はディスプレイに接続します。
- Raspberry Pi 5でTouch Display 2（10インチ）を使う場合：付属の22芯〜22芯 Mini – Mini FFC。
Raspberry Pi ZeroシリーズにはDSIコネクターがなく、DSIディスプレイは一切使用できません。
2. ケーブルの挿し込みと向きを確認する
コネクターの固定クリップを開き、ケーブルを奥までしっかり挿し込んでからクリップを閉じます。Raspberry Pi 4B以前では、ディスプレイ用コネクターは DISPLAY と表示されています（CAMERA ではありません）。金属端子（接点）はEthernetおよびUSB-Aポート側を向きます。逆挿し、途中までの挿し込み、誤ってカメラコネクターに挿した場合も、パネル故障とまったく同じ症状になります。
3. ディスプレイに専用の5 V電源を供給する
公式ディスプレイは、DSIケーブルとは別に電源を供給します：
- 初代Touch Display：PiのGPIOヘッダーからジャンパーワイヤで、黒を6番ピン（GND）、赤を4番ピン（5 V）に接続します。4番ピンが使用中の場合は2番ピンでも構いません。micro USB給電も使えますが、その場合はGPIOからの給電ワイヤは接続しないでください。
- Touch Display 2：付属のGPIO電源ケーブルを使い、小さい側をディスプレイの
J1ポートに、赤を2番ピン、黒を6番ピンに接続します。
バックライトがまったく点かない場合は、まず電源を疑ってください。サードパーティーのパネルではバックライト用に別電源が必要なことが多く、ベンダーの配線図を確認してください。
4. 不要なdtoverlay行は追加しない
Raspberry Pi OSには /boot/firmware/config.txt に display_auto_detect=1 が含まれており、これによりファームウェアが認識済みのDSIディスプレイ用オーバーレイを自動的に読み込みます。そのため、標準的なRaspberry Piでは、公式ディスプレイに dtoverlay 行は不要です。手動で追加したり、サイズやポートの違う行を書いたりすることが、真っ暗な画面のよくある原因になります。
Raspberry Pi Compute Moduleは挙動が異なり、DSIディスプレイは自動検出されないため、オーバーレイを自分で追加します：
- Touch Display 2（5インチ）：
dtoverlay=vc4-kms-dsi-ili9881-5inch - Touch Display 2（7インチ）：
dtoverlay=vc4-kms-dsi-ili9881-7inch - Touch Display 2（10インチ）：
dtoverlay=vc4-kms-dsi-ili79600-10-1inch - 初代7インチTouch Display：
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ポートを使用する
Raspberry Pi 4Bおよび5では、基板上で HDMI0 とラベルされたポートが最初のディスプレイ出力です（Linuxでは HDMI-A-1）。他のテストを行う前に、単体のディスプレイをそこに接続してください。
2. 旧式のconfig.txtのHDMI設定は動作しない
多くの解説では、config.txt に hdmi_force_hotplug、hdmi_group、hdmi_mode を設定するよう案内されています。しかしRaspberry Piの公式ドキュメントでは、これらは「Raspberry Pi OS Bookworm以降では動作しない」レガシーオプションとして扱われています。KMSグラフィックスドライバでは、HDMI出力を含むディスプレイパイプライン全体をLinuxが管理します。
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> です。2番目のHDMIポートには HDMI-A-2 を、DSIまたはDPIディスプレイには DSI-1 を使用します。解像度とリフレッシュレートはパネルのデータシートを参照してください。cmdline.txt の内容は必ず1行にまとめてください。
画面が回転する、または反転する
- デスクトップ：Preferences > Control Centre > Screens を開き、対象のディスプレイを選択して、Orientation を Normal、Left、Inverted、Right のいずれかに設定します。
- コンソールのみ：
video=パラメータを拡張します。例：video=DSI-1:720x1280@60,rotate=90。ミラー表示にはreflect_x、reflect_y、reflect_xyを使用します。
注意点が2つあります。接続されているすべてのディスプレイが同じ 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 を削除してください。Raspberry Piの公式情報によると、デバイスツリーでのタッチ回転は入力ライブラリと競合することがあるため、可能であればライブラリまたはデスクトップ側でタッチイベントを回転させてください。
10分後に画面が真っ黒になる
これは故障ではなく、スクリーンブランキング（画面消灯）です。有効な場合、Raspberry Pi OSは600秒間無操作だと画面を消灯します。Control Centre のScreen Blankingトグル、または sudo raspi-config > 2 Display Options > D2 Screen Blanking で無効にできます。テキストコンソールでは、cmdline.txt に consoleblank=0 を追加すれば画面は消灯しなくなります。
原因がパネルにある場合（Piではない）
動作確認済みのPiで正しいケーブル・電源・設定を使用してもパネルが暗いままの場合は、バックライトの電源電圧を測定し、ソフトウェアの修正に着手する前に別のパネルと交換して確認してください。試作ではなく製品として採用する場合は、お使いのホストに適したオーバーレイ、タイミング、電源シーケンスを提供できるサプライヤーのパネルを選定してください。当社のディスプレイインターフェース比較では、Raspberry Pi設計においてDSIとHDMIのどちらが適しているかを解説しています。
よくある質問
Raspberry Pi 5のディスプレイが、旧ディスプレイ用のケーブルでは動作しないのはなぜですか？
Raspberry Pi 5は、より小さい22ピンのDSIコネクタを採用しています。15ピンコネクタのディスプレイには22ピン→15ピンのフラットケーブルが必要で、小さい側の22ピン端をPiに接続します。
公式Raspberry Pi Touch Displayにもdtoverlay行が必要ですか？
標準的なRaspberry Piでは不要です。Raspberry Pi OSのデフォルト設定であるdisplay_auto_detect=1により、ファームウェアがオーバーレイを自動的にロードします。Compute ModulesはDSIディスプレイの自動検出に対応していないため、dtoverlay=vc4-kms-dsi-ili9881-7inch などのオーバーレイを自分で追加してください。
hdmi_modeが動作しなくなったのはなぜですか？
hdmi_group、hdmi_mode、hdmi_force_hotplugは、Raspberry Pi OS Bookworm以降では動作しないconfig.txtのレガシーオプションです。cmdline.txtのvideo=でモードを強制してください。例：video=HDMI-A-1:1024x600M@60。
Raspberry Piの画面が消灯しないようにするには？
Control Centre、またはraspi-configの「2 Display Options > D2 Screen Blanking」でScreen Blankingをオフにしてください。テキストコンソールでは、cmdline.txtにconsoleblank=0を追加します。