Дисплей Raspberry Pi не работает? Решения проблем DSI, HDMI и сенсорного ввода для Pi 4 и Pi 5

Начните с этого: какое подключение вы используете?

Пройдите по порядку раздел, соответствующий вашему типу подключения. Каждый шаг исключает одну причину, а именно первые шаги чаще всего оказываются источником сбоя.

Дисплей DSI: чёрный экран или только подсветка

1. Используйте подходящий шлейф для вашей модели Pi

У Raspberry Pi 5 разъём DSI меньше, чем у прежних моделей, поэтому шлейф, идущий в комплекте со старыми дисплеями, не подходит. Согласно документации Raspberry Pi:

• Raspberry Pi 4 и более ранние: гибкий шлейф FFC 15-контактный с обеих сторон.
• Raspberry Pi 5: шлейф FFC 22-контактный — 15-контактный (Standard – Mini). 22-контактный конец — меньший — вставляется в Pi; больший конец подключается к дисплею.
• Touch Display 2, 10 дюймов, с Raspberry Pi 5: входящий в комплект шлейф FFC 22-контактный — 22-контактный (Mini – Mini).

У моделей Raspberry Pi Zero разъёма DSI нет вообще, поэтому DSI-дисплей на них использовать невозможно.

2. Убедитесь, что кабель вставлен до конца и правильной стороной

Откройте фиксирующую защёлку разъёма, вставьте кабель до упора и закройте защёлку. На Raspberry Pi 4B и более ранних моделях разъём дисплея обозначен DISPLAY (а не CAMERA), и металлические контакты должны быть обращены к портам Ethernet и USB-A. Перевернутый, вставленный не до конца или подключённый в разъём камеры кабель даёт ровно тот же симптом, что и неисправная панель.

3. Обеспечьте дисплею отдельное питание 5 В

Официальные дисплеи питаются отдельно, а не по кабелю DSI:

• Оригинальный Touch Display: проводами от разъёма GPIO на Pi — чёрный к контакту 6 (GND), красный к контакту 4 (5 В) или к контакту 2, если контакт 4 занят. Вместо этого можно использовать блок питания с разъёмом micro USB, но тогда провода питания GPIO подключать не нужно.
• Touch Display 2: входящий в комплект кабель питания GPIO, малый разъём — в порт J1 дисплея, красный провод к контакту 2, чёрный к контакту 6.

Если подсветка так и не загорается, питание — первый подозреваемый. Сторонние панели часто требуют отдельного питания для подсветки; сверьтесь со схемой подключения поставщика.

4. Не добавляйте строку dtoverlay, которая вам не нужна

В Raspberry Pi OS в /boot/firmware/config.txt по умолчанию задан параметр display_auto_detect=1, благодаря которому прошивка автоматически загружает overlay для распознанных DSI-дисплеев. На стандартной Raspberry Pi официальным дисплеям поэтому не нужна строка dtoverlay. Добавленная вручную строка — с неверным размером или для неверного порта — частая причина чёрного экрана.

С Compute-модулями Raspberry Pi иначе: они не определяют DSI-дисплеи автоматически, поэтому overlay добавляется вручную:

• 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-панели требуют собственного overlay

Автоопределение распространяется только на дисплеи, распознаваемые прошивкой. Сторонней панели MIPI DSI нужен device-tree overlay, соответствующий её контроллеру, числу lanes и таймингам, — обычно его предоставляет поставщик панели. Если overlay поставщика рассчитан на более старое ядро или другую модель Pi, панель может оставаться чёрной даже при правильном подключении. Запрашивайте overlay, проверенный именно на вашей модели Pi и версии ОС. Наши материалы заметки по дисплеям для Raspberry Pi 5 и обзор дисплеев MIPI DSI подскажут, о чём спрашивать.

HDMI-дисплей: «нет сигнала» или неправильное разрешение

1. Используйте первый HDMI-порт

На Raspberry Pi 4B и 5 порт, обозначенный на плате как HDMI0, является первым видеовыходом (HDMI-A-1 в Linux). Подключите единственный дисплей именно туда, прежде чем проверять что-либо ещё.

2. Старые настройки HDMI в config.txt больше не работают

Многие руководства по-прежнему советуют задавать hdmi_force_hotplug, hdmi_group и hdmi_mode в config.txt. В документации Raspberry Pi эти параметры теперь отнесены к устаревшим и «не работают в Raspberry Pi OS Bookworm и новее». При использовании графического драйвера KMS конвейером вывода изображения управляет Linux, включая HDMI-выходы.

3. Принудительно задайте режим через video= в cmdline.txt

Если режим не задан, Pi считывает EDID дисплея и выбирает разрешение сама. Небольшие HDMI-платы драйверов иногда сообщают EDID, не соответствующий панели, что приводит к «нет сигнала» или обрезанному изображению. Принудительно задайте родной режим панели, добавив параметр video= в единственную строку файла /boot/firmware/cmdline.txt, например video=HDMI-A-1:1024x600M@60 для панели 1024×600 при 60 Гц.

Формат: video=<дисплей>:<ширина>x<высота>M@<частота>. Для второго HDMI-порта используйте HDMI-A-2, а для дисплея DSI или DPI — DSI-1. Разрешение и частоту обновления берите из даташита панели. Всё содержимое 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= поворачивает только текстовую консоль. Приложениям, рисующим напрямую через DRM, например cvlc или утилитам libcamera, нужна собственная опция поворота.

Сенсорный ввод не совпадает с изображением

На рабочем столе задайте ориентацию в 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 отмечают, что поворот сенсора в device tree может конфликтовать с вашей библиотекой ввода, поэтому по возможности поворачивайте события сенсора в самой библиотеке или на рабочем столе.

Экран гаснет через десять минут

Это гашение экрана (screen blanking), а не неисправность. Когда оно включено, Raspberry Pi OS гасит экран после 600 секунд бездействия. Отключите его в Control Centre (переключатель Screen Blanking) или через sudo raspi-config > 2 Display Options > D2 Screen Blanking. Для текстовой консоли добавьте consoleblank=0 в cmdline.txt, чтобы экран не гас вовсе.

Когда проблема в панели, а не в Pi

Если панель остаётся тёмной на заведомо исправной Pi с правильным кабелем, питанием и настройками, измерьте напряжение питания подсветки и подставьте вторую панель, прежде чем переделывать ПО. Для серийного продукта, а не разовой сборки, выбирайте панель, поставщик которой предоставляет оверлей, тайминги и последовательность питания именно для вашего хоста. Наш сравнительный обзор интерфейсов дисплеев объясняет, когда для дизайна на Raspberry Pi лучше подойдёт DSI, а когда HDMI.