Mellow FLY TFT35
3,5″ · 480×320 · SPI для KlipperScreen
Mellow FLY TFT35 — сенсорный дисплей 3,5 дюйма с разрешением 480×320 для локального управления 3D-принтером через KlipperScreen. Экран семейства FLY-TFT-V2 подключается по SPI к совместимому Linux-хосту и показывает температуры, состояние печати, файлы и команды управления. В этой карточке показана резистивная версия: команды выбираются нажатием на экран.
Панель удобно установить на корпусе принтера, чтобы запускать подготовленные файлы и пользоваться меню без постоянного обращения к компьютеру или телефону. Графический интерфейс запускается на Raspberry Pi или другом поддерживаемом хосте; сам дисплей не заменяет этот компьютер.
Возможности в KlipperScreen
KlipperScreen даёт сенсорный доступ к состоянию принтера, температурам, файлам печати и доступным командам. Набор меню зависит от настроенного Klipper, Moonraker и версии интерфейса. Через эти же средства доступны пользовательские макросы и сервисные действия, если они уже настроены на принтере.
Сенсорный экран полезен как постоянно доступная панель рядом с рабочей зоной. При этом команды движения и нагрева всё равно выполняет контроллер принтера, а KlipperScreen связывается с Klipper через Moonraker. Подключить только экран вместо управляющей платы или Linux-хоста недостаточно.
Технические характеристики
| Семейство платы | Mellow FLY-TFT-V2 |
|---|---|
| Экран | Цветной TFT LCD, диагональ 3,5 дюйма |
| Разрешение | 480×320 в альбомной ориентации; 320×480 в книжной |
| Контроллер изображения | ST7796 |
| Интерфейс изображения | SPI |
| Сенсор показанной версии | Резистивный; SPI-обработчик семейства ADS7846 в драйвере |
| Разъёмы на плате | Шлейфовые разъёмы с маркировками V2 и V1; выбор по схеме соединения |
| Питание | Через штатное соединение с совместимым хостом / переходником |
| Габариты платы | 98×56 мм по изображению производителя |
| Крепление | 4 отверстия Ø3 мм, межосевое расстояние 92,33×50,42 мм |
| Программная часть | Драйвер FLY-TFT-V2 для Linux; KlipperScreen устанавливается отдельно |
Размер 98×56 мм относится к плате. Для корпуса учитывайте выступающие разъёмы, толщину экрана и доступ к защёлкам шлейфа.
Сенсор: резистивная и ёмкостная версии
Производитель выпускает FLY-TFT-V2 с двумя типами сенсора. Резистивный вариант с фотографий реагирует на нажатие и использует отдельный канал SPI. Нажимайте пальцем или мягким стилусом, не применяя острые предметы и избыточное усилие.
Для ёмкостного варианта в исходниках драйвера предусмотрен узел Goodix GT911 на I²C. Поэтому инструкции по поиску адресов I²C и настройке ёмкостного сенсора нельзя считать обязательными шагами для резистивного экрана. Положение переключателя Cap/Res и подключение должны соответствовать установленному варианту, а не выбранному произвольно режиму.
Как устроено подключение
Для Raspberry Pi применяют совместимый GPIO-переходник, например FLY G2T, и предназначенный для этой связки шлейф. У соединителей V1/V2 различаются назначение и способ подключения. Выбирайте разъём по инструкции конкретного хоста и переходника; одинаковая ширина FPC не подтверждает совместимость.
Подключайте экран при выключенном питании. Откройте защёлку, вставьте шлейф ровно и зафиксируйте его без перекоса. Сторону контактов проверьте по схеме соединения. Питание подаётся через предусмотренное производителем соединение; силовые 12/24 В принтера напрямую к дисплею не подключают.
Совместимые хосты и программные условия
| Хост | Условие применения |
|---|---|
| Raspberry Pi Zero 2 / Zero 2 W | Указаны в репозитории драйвера. Поддержку обычного первого Zero авторы не подтверждают. |
| Raspberry Pi 3B / 3B+ / 4B / 5 | Перечислены Mellow; требуется подходящий переходник, драйвер и конфигурация системы. |
| Raspberry Pi CM4IO | Также указан в списке поддерживаемых устройств; распиновку и подключение проверяют для используемой платы. |
| Другие Linux-хосты | Нужна отдельная инструкция для конкретной платы и образа ОС. Поддержка Raspberry Pi не доказывает совместимость с любым GPIO или FPC-разъёмом. |
Официальное руководство драйвера требует ядро Linux новее 5.17.x и описывает установку на MainsailOS. Проверить ядро можно командой uname -r. Даже при подходящем номере ядра драйвер должен соответствовать используемому образу ОС; после обновлений системы проверяйте актуальные указания Mellow.
Порядок настройки
- Подготовьте совместимый Linux-хост, убедитесь, что Klipper и Moonraker доступны, и сохраните рабочую конфигурацию.
- Установите драйвер из официального репозитория
Mellow-3D/FLY-TFTпо его README. Для Raspberry Pi в репозитории предусмотренscripts/install.sh. - В нужном файле
config.txtвключите один вариант наложенияdtoverlay=fly-tft-v2. На системах Bookworm документация указывает/boot/firmware/config.txt; на более старых образах —/boot/config.txt. - Перезагрузите хост и проверьте появление изображения и сенсорного устройства.
- Установите KlipperScreen отдельно и настройте его связь с Moonraker. Наличие MainsailOS само по себе не гарантирует установленный KlipperScreen.
Экран не настраивается выбором UART-дисплея в Marlin. Также к нему не применяется профиль от BIGTREETECH TFT35 SPI: это другая плата и другой драйвер.
Ориентация изображения и устройство вывода
По умолчанию драйвер использует альбомную ориентацию r90. Варианты r270, r0 и r180 позволяют перевернуть изображение или поставить экран вертикально. В файле конфигурации должна быть только одна строка выбранного варианта, например dtoverlay=fly-tft-v2,r270.
Если в системе несколько framebuffer-устройств, дисплей может получить имя /dev/fb1 вместо /dev/fb0. Команда ls /dev/fb* помогает увидеть доступные устройства. Править конфигурацию X11 следует под фактическое устройство экрана, а не заменять номер вслепую. Касания проверяют после настройки ориентации изображения.
Первый запуск и поиск причины неполадок
| Признак | Что проверить |
|---|---|
| Экран остаётся пустым | Подключение шлейфа, выбранный разъём V1/V2, питание переходника, установку драйвера и строку overlay. |
| Изображение есть, касания не работают | Точный тип сенсора и соответствующую цепь драйвера; для резистивной версии не начинать с поиска ёмкостного устройства на I²C. |
| Видно рабочий стол, но нет панели принтера | Установку и запуск KlipperScreen, его конфигурацию и доступность Moonraker. |
| Экран работает, но изображение перевёрнуто | Единственный выбранный параметр r0/r90/r180/r270 и согласование ориентации касаний. |
| Появляются графические помехи | Надёжность соединения и настройки SPI по документации текущего драйвера. |
После загрузки проверьте касания по разным участкам меню, обновление температур и связь с принтером. Команды движения и нагрева запускайте после проверки конфигурации самого принтера. Скорость обновления зависит от SPI, драйвера и хоста; фиксированную частоту кадров для любой системы обещать нельзя.
Монтаж и состав подключения
Установите плату на стойки, не допуская контакта задней стороны с металлом. Оставьте доступ к шлейфу и исключите натяжение кабеля. Четыре крепёжных отверстия позволяют зафиксировать модуль в собственном корпусе или панели; крепёж не должен давить на стекло.
Основное изделие — дисплей FLY-TFT-V2 в резистивном исполнении, показанном в карточке. Переходник, кабель и Linux-хост должны подходить друг к другу. Их наличие в поставке проверяют по выбранному комплекту: фотографии подключённой системы не означают, что Raspberry Pi, G2T или корпус входят в цену экрана.
