Как подключить TFT-дисплей к Raspberry Pi: HDMI, DSI и SPI без путаницы
Под названием «TFT-дисплей для Raspberry Pi» продаются очень разные устройства. Один экран работает как обычный HDMI-монитор, другой подключается к DSI, третий занимает GPIO и передаёт изображение по SPI. Поэтому универсальная инструкция вида «подключите шлейф и установите драйвер» часто только запутывает.
Сначала определите интерфейс экрана
- HDMI — самый понятный вариант: видеосигнал идёт как на обычный монитор, а touch при наличии обычно подключается отдельным USB.
- DSI — интерфейс для дисплеев, подключаемых плоским FFC-шлейфом к display-коннектору Raspberry Pi.
- SPI/GPIO — небольшие дисплеи, которые получают данные через GPIO. Им часто нужен конкретный Device Tree overlay или драйвер производителя.
Почему важно знать модель Raspberry Pi
Разъёмы у разных поколений отличаются. Например, Raspberry Pi 5 использует более компактные FFC-коннекторы для камеры/дисплея, поэтому для старого официального 7-дюймового Touch Display нужен подходящий 22-to-15-way кабель. Нельзя ориентироваться только на внешне похожий шлейф.
Вариант 1: HDMI-дисплей
Обычно это лучший выбор для первого проекта. Выключите Raspberry Pi, подключите HDMI и питание дисплея, затем загрузите систему. Современная Raspberry Pi OS обычно определяет монитор автоматически. Если есть touch по USB, подключите его отдельным кабелем и проверьте устройство ввода.
Вариант 2: DSI-дисплей
Официальные Touch Display и Touch Display 2 используют DSI. Для совместимых моделей Raspberry Pi B+ и новее дисплей обычно определяется автоматически. Compute Module — отдельный случай: там может понадобиться явная настройка Device Tree overlay и выбор DSI-порта.
Перед подключением FFC полностью отключите питание. Шлейф вставляется в разъём с правильной ориентацией контактов и фиксируется защёлкой. Криво установленный FFC — одна из самых частых причин чёрного экрана.
Вариант 3: SPI-дисплей через GPIO
Здесь особенно важно знать точную модель контроллера: ILI9341, ST7789 и другие дисплеи могут иметь одинаковый размер, но требовать разных overlays и параметров. Не устанавливайте случайный скрипт из старой статьи только потому, что диагональ совпадает.
Сначала найдите документацию производителя и выясните: какие GPIO используются, какое напряжение питания допустимо, нужен ли SPI0/SPI1, поддерживается ли DRM/KMS и какой overlay рассчитан на вашу модель.
Питание — отдельная часть подключения
Не считайте, что любой экран можно безопасно питать от случайного GPIO-пина. Проверьте напряжение и потребление. Большие дисплеи с подсветкой часто требуют заметный ток. Официальный Touch Display допускает питание от 5 В Raspberry Pi или отдельного блока питания по предусмотренному разъёму, но для сторонних модулей правила определяет их производитель.
Чёрный экран: порядок проверки
- Полностью выключите питание и переподключите кабель.
- Проверьте, что используется правильный разъём и совместимый FFC.
- Убедитесь, что дисплей действительно получает питание.
- Проверьте загрузку Raspberry Pi по SSH или обычному HDMI.
- Посмотрите, обнаружен ли display/DRM device.
- Для SPI/стороннего DSI проверьте overlay и документацию конкретного контроллера.
Не копируйте старые настройки framebuffer вслепую
Много старых инструкций для маленьких TFT строятся вокруг ручного framebuffer, старых kernel modules и копирования файлов в /boot. Современная Raspberry Pi OS использует KMS/DRM, а загрузочные файлы обычно находятся в /boot/firmware. Старый installer может не только не помочь, но и сломать загрузку видео.
Поворот экрана и touch
Поворот изображения и координат touch — это две разные настройки. В desktop-версии Raspberry Pi OS официальный дисплей удобнее поворачивать через настройки экранов. Для console-only проектов параметры зависят от интерфейса и драйвера, поэтому ориентируйтесь на актуальную документацию устройства.
Итог: перед настройкой TFT выясните три вещи: интерфейс, контроллер дисплея и точную модель Raspberry Pi. После этого подключение становится обычной технической задачей, а не лотереей с чужими install-скриптами.
