BIGTREETECH
Voron V0 Display
OLED 1,3″ · энкодер · подключение по USB
BIGTREETECH Voron V0 Display — компактная панель с графическим OLED-экраном, поворотным энкодером и RGB-индикатором для принтера Voron 0.1 на Klipper. Плата содержит собственный микроконтроллер STM32F042 и подключается по USB к хосту системы. Она позволяет видеть состояние принтера и работать с локальным меню; в конфигурации Klipper дисплей регистрируется как отдельное MCU-устройство.
Модель из карточки «для SKR PICO» используется в общей системе с этой платой. При стандартном подключении дисплей и SKR Pico связаны с хостом отдельно. Команды меню обрабатывает Klipper, а двигателями и нагревателями управляет основная плата принтера.
Температуры и параметры работы доступны на небольшом локальном экране.
Энкодер используется для навигации и выбора пунктов меню Klipper.
Дисплей подключается к хосту независимо от контроллера механики.
Для чего нужна панель
V0 Display подходит для компактной сборки Voron, где требуется базовое управление рядом с машиной. OLED выводит текст и графические элементы меню, а физический энкодер позволяет менять значения и выбирать команды. Содержимое экрана определяется конфигурацией Klipper и доступными функциями принтера.
Панель дополняет веб-интерфейс, через который удобно загружать файлы и выполнять настройку. Она не предоставляет самостоятельный файловый сервер или сенсорную среду KlipperScreen. Для работы нужны настроенные хост, контроллер принтера и конфигурация дисплея.
Основные характеристики
| Аппаратная основа | Проект Voron V0 Display |
|---|---|
| Экран | Графический OLED 1,3 дюйма; профиль SH1106 в штатной конфигурации |
| Управление | Поворотный энкодер с нажатием, отдельная передняя кнопка |
| Микроконтроллер | STM32F042F6P6, собственная прошивка Klipper |
| Связь с хостом | USB; на показанной плате установлен micro-USB |
| Питание | 5 В от USB хоста; на плате формируется питание 3,3 В |
| Связь OLED с MCU | I²C внутри панели |
| Индикация | Один RGB NeoPixel, управляемый конфигурацией |
| Служебные элементы | BOOT0, RESET, SWD; GPIO и вывод NeoPixel по схеме проекта |
| Программная среда | Klipper; отдельная секция mcu display |
Версия Voron 0.1 в названии карточки обозначает применение в принтере. Маркировку самой платы, расположение USB и посадку в корпус сверяйте по изделию.
Подключение вместе со SKR Pico
Соедините micro-USB дисплея с USB-портом Raspberry Pi или другого совместимого Linux-хоста. Кабель должен поддерживать передачу данных: кабель только для зарядки может включить питание, но не обеспечит обнаружение MCU.
SKR Pico подключается к этому же хосту по своей документированной схеме. Между OLED-панелью и Pico не требуется прямой EXP-шлейф. USB, питание и конфигурация хоста должны обеспечивать устойчивую работу обоих устройств.
Кнопки, энкодер и световой индикатор
В штатном файле V0Display.cfg поворот энкодера задаёт переход по меню и изменение значений, а нажатие подтверждает выбор. Если направление неудобно, в примере предусмотрена перестановка сигналов энкодера программной настройкой.
Отдельная передняя кнопка назначена на kill_pin. Её назначение нужно учитывать при проверке интерфейса: это не обычная кнопка возврата. RESET на обратной стороне перезапускает микроконтроллер дисплея и используется в том числе при прошивке.
NeoPixel — самостоятельный RGB-светодиод. Цвет и яркость задаются в секции [neopixel displayStatus]; изменение цвета индикатора не меняет цвет OLED. Сам по себе светодиод не определяет состояние печати: нужную логику задают настройками или макросами.
Подготовка прошивки
Официальный Setup and Flashing Guide описывает сборку прошивки дисплея из исходников Klipper. Для аппаратного проекта выбраны STM32F042, отсутствие загрузочного смещения, внутренний тактовый источник и USB на PA9/PA10. Сверяйте эти параметры с маркировкой своего MCU и актуальным руководством.
Для платы с уже установленной прошивкой инструкция переводит устройство в DFU установкой BOOT-перемычки и сбросом. Затем хост должен обнаружить STM32 в DFU, после чего выполняется запись. Не используйте случайный идентификатор устройства из чужого примера: он определяется для подключённой платы.
После записи перемычку снимают и перезапускают дисплей. В системе должен появиться путь вида /dev/serial/by-id/usb-Klipper_stm32f042x6…. Прошивка SKR Pico на RP2040 не подходит для MCU этой панели.
Добавление дисплея в Klipper
- Скопируйте официальный
V0Display.cfgв каталог конфигурации принтера. - В секции
[mcu display]укажите реальный serial-путь своей панели. - Подключите файл строкой
[include V0Display.cfg]вprinter.cfg. - Сверьте профиль OLED, энкодер, кнопку и NeoPixel с аппаратной ревизией.
- Перезапустите Klipper и проверьте отсутствие ошибок конфигурации.
Штатный пример использует lcd_type: sh1106 и I²C на MCU дисплея. Эти параметры не означают, что нужно прокладывать отдельный I²C-кабель к Raspberry Pi: связь между платой панели и хостом остаётся USB.
Монтаж в корпус
В официальном репозитории доступны модели платы и печатных деталей, включая крепления для V0 и V0.1. Выбирайте вариант по конкретному принтеру и ориентации USB. Оставьте доступ к кабелю и запас места за OLED-модулем.
Рамка не должна давить на стекло или ограничивать ход энкодера и передней кнопки. USB-кабель закрепляют так, чтобы движение и натяжение не передавались на маленький разъём. Защитите обратную сторону от контакта с металлической рамой.
Проект имеет перемычки выбора питания и земли для разных OLED-модулей. На собранной панели не меняйте их наугад: при замене экрана нужно сверить порядок контактов нового модуля со схемой.
Проверка первого запуска
| Наблюдение | Что проверить |
|---|---|
| Нет MCU в системе | USB-кабель с данными, порт хоста, режим BOOT и результат прошивки. |
| MCU найден, OLED пуст | Подключение V0Display.cfg, профиль SH1106 и настройки I²C. |
| Неверное направление энкодера | Порядок encoder_pins в официальном примере. |
| Вертикальные полосы на OLED | Комментарии к vcomh и x_offset в V0Display.cfg, без произвольной замены всего профиля. |
Сначала проверьте меню и корректность температур без движения и нагрева. Изменение параметров через экран допустимо после полной проверки конфигурации самого принтера.
Комплектация и документация
В карточке показана собранная плата с OLED, энкодером, кнопкой и RGB-индикатором. Наличие ручки, USB-кабеля, корпуса и крепежа сверяйте с заказом. Хост и SKR Pico являются отдельными частями системы.
- Voron V0 Display — схема, устройство платы, CAD и крепления.
- Setup and Flashing Guide — подготовка MCU и прошивка.
- Официальный V0Display.cfg — конфигурация дисплея, энкодера и NeoPixel.
- Klipper: настройки дисплея.
