Перейти к основному содержимому

Инструкция по использованию Raspberry Pi

Важные замечания:​

  • Убедитесь, что источник питания выключен перед установкой расширительной платы.
  • Избегайте использования расширительной платы в условиях высокой влажности или пыли.
  • При установке экрана убедитесь, что вы не включаете его во время подключения, обращайте внимание на направление шлейфа, чтобы избежать повреждений.
  • При установке вентилятора убедитесь, что его параметры тока и напряжения соответствуют требованиям, чтобы предотвратить повреждения.
  • UART1 уже включен по умолчанию, настройка в системе не требуется.
  • Обновите образ системы до последней версии, например, mainsailos. Не обновляйте ядро.
  • Raspberry Pi может использовать все интерфейсы!
  • Внимание: версия ядра системы должна быть выше 5.17.x. Проверьте версию ядра командой uname -r.

Ссылка на загрузку системы с предустановленным TFTV2 для Raspberry Pi​

  • Системный образ для Raspberry Pi zero2/zero2W/2B/3B/3B+/4B/CM4/5B
  • В этом образе уже установлены klipper, moonraker, mainsail, fulidd, klipper-screen и другие компоненты.
https://cdn.mellow.klipper.cn/IMG/Beta/RPI-TFT-IMG-new.img.xz

Установка G2T​

  • Ниже приведена ссылка на пример:
  • Пример соединения:

Метод подключения к RS232 с помощью встроенной инструментальной панели​

  • После успешной прошивки системы Raspberry Pi необходимо отредактировать файл config.txt на диске boot
  • Убедитесь, что UART1 уже включен по умолчанию, настройка в системе не требуется, UART3 требует выполнения следующих шагов
  • Добавьте следующую запись в файл config.txt
dtoverlay=uart3
  • Если используется uart1, вот пример конфигурации:
[mcu] 
serial: /dev/ttyAMA0
baud: 250000
restart_method:command
  • Если используется uart3, вот пример конфигурации:
[mcu] 
serial: /dev/ttyAMA1
baud: 250000
restart_method:command

Использование встроенного вентилятора 5VFAN​

  • Если необходимо управлять устройством через 40PIN Raspberry Pi, следуйте руководству по Klipper для установки: Микроконтроллер Raspberry Pi

[mcu host]       
serial: /tmp/klipper_host_mcu 

[temperature_sensor Raspberry Pi]
sensor_type: temperature_host

[temperature_fan core_fan] 
pin: host:gpio12
max_power: 1.0
sensor_type: temperature_host   # Настройка как основной контроллер температуры
control:watermark                  # Способ управления
target_temp: 48                   # Температура запуска вентилятора системы
min_temp: 0                     # Минимальная температура, при которой будет ошибка
max_temp: 90                    # Максимальная температура, при которой будет ошибка
off_below: 0.10
kick_start_time: 0.50
max_speed: 0.8                   # Максимальная скорость вентилятора
min_speed: 0.3                    # Минимальная скорость вентилятора

Метод использования экрана​

  • GitHub-адрес: FLY-TFT

1. Описание​

FLY-TFT-V2 — это TFT-экран на базе чипсета st7796, поддерживающий емкостное и резистивное сенсорное управление, разрешение 320x480, интерфейс SPI.

2. Установка системы​

подсказывать
  • Внимание: версия ядра системы Raspberry Pi должна быть выше 5.17.x. Проверьте версию ядра командой uname -r.
  • Обновите образ системы до последней версии, например, mainsailos. Не обновляйте ядро.
  • Необходимо самостоятельно установить KlipperScreen.
  • Используйте Raspberry Imager для установки последней версии MainsailOS
    • Скачайте и установите Raspberry Imager
    • Откройте Raspberry Imager
    • Нажмите CHOOSE DEVICE
    • Выберите подходящую модель устройства
    • Нажмите CHOOSE OS
    • Выберите Other specific-purpose OS
    • Выберите 3D printing
    • Выберите Mainsail OS
    • Выберите последнюю версию. Если ваше устройство поддерживает 64-битную систему, выберите rpi64
    • Нажмите CHOOSE STORAGE
    • Выберите ваше устройство хранения, например, SD-карту
    • Нажмите NEXT, дождитесь завершения установки

4. Установка драйверов​

  • Установка драйверов для FLY-TFT-V2

    git clone https://github.com/kluoyun/FLY-TFT.git
    cd FLY-TFT
    sudo chmod +x ./scripts/install.sh
    ./scripts/install.sh

5. Использование​

подсказывать
  • Для активации сенсорного управления необходима поддержка I²C. Соответствующая настройка — dtparam=i2c_arm=on.
  1. После установки драйверов добавьте в файл config.txt запись поддержки слоя dtoverlay=fly-tft-v2
  2. Откройте файл /boot/config.txt (в системе bookworm — /boot/firmware/config.txt) 
    sudo nano /boot/config.txt
  3. В конце файла добавьте следующие настройки 
    dtoverlay=fly-tft-v2
  • По умолчанию экран отображается горизонтально под углом 90 градусов. Если требуется изменить ориентацию экрана, используйте следующие настройки 
    dtoverlay=fly-tft-v2,r90  # Горизонтальное положение экрана
    dtoverlay=fly-tft-v2,r270 # Горизонтальное положение экрана (перевернутое)
    dtoverlay=fly-tft-v2,r0   # Вертикальное положение экрана
    dtoverlay=fly-tft-v2,r180 # Вертикальное положение экрана (перевернутое)
    • Можно добавить только одну настройку, нельзя добавлять несколько
    • Обычно сенсорное управление автоматически адаптируется к ориентации экрана, изменения в системных настройках не требуются

  1. После добавления в конец файла выполните команду sudo reboot, чтобы перезагрузить систему

    • Убедитесь, что подключение аппаратного обеспечения выполнено правильно
    • Установлены драйверы
    • В файле /boot/config.txt (в системе bookworm — /boot/firmware/config.txt) добавлена запись поддержки слоя dtoverlay=fly-tft-v2
    • В некоторых системах может появиться устройство fb0 по умолчанию, FLY-TFT будет назначен устройством fb1. Необходимо включить устройство fb1
    • Выполните команду ls /dev/fb* для просмотра устройств. Если появляются два устройства fb0 и fb1, выполните следующую команду для включения устройства fb1 (по умолчанию используется fb0)
    • Выполните следующую команду для изменения настройки по умолчанию на устройство fb1 
      sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf

6. Использование KlipperScreen​

  • В системе MainsailOS KlipperScreen не установлен по умолчанию. Необходимо установить вручную
  • Следуйте инструкции на KlipperScreen или используйте kiauh для установки
  • Если KlipperScreen успешно установлен и выполнены все шаги из пункта 5, интерфейс KlipperScreen должен уже быть виден

7. Все доступные настройки​

  • speed Требуется параметр: задает максимальную частоту SPI для TFT, в Гц. По умолчанию 96000000 (если наблюдается серьезное искажение экрана, понизьте значение)

  • Пример: dtoverlay=fly-tft-v2,speed=80000000

  • r0/r90/r180/r270 Необязательные параметры: задают ориентацию экрана и сенсора. По умолчанию 90 градусов. Возможные значения: 0, 90, 180, 270. (можно указать только один параметр)

  • Пример: dtoverlay=fly-tft-v2,r90 или dtoverlay=fly-tft-v2,r180

  • disable_touch Не требует параметров: отключает функцию сенсорного управления. По умолчанию включена

  • Пример: dtoverlay=fly-tft-v2,disable_touch

  • invx,invy Не требуют параметров: задают направление сенсорного управления. invx — отражение по оси X, invy — отражение по оси Y

  • Пример: dtoverlay=fly-tft-v2,invx или dtoverlay=fly-tft-v2,invy или dtoverlay=fly-tft-v2,invx,invy

  • swapxy Не требует параметров: меняет направление сенсорного управления, поменяя местами оси X и Y, то есть делает экран горизонтальным

    • Пример: dtoverlay=fly-tft-v2,swapxy
подсказывать
  • Важно: Все параметры могут быть указаны одновременно (необязательные параметры можно указать только один). Параметры разделяются запятой, несколько параметров можно указать только в одной строке
  • Предупреждение: Обычно используются только параметры r0, r90, r180, r270. Остальные параметры используются только в особых случаях, особенно invx, invy, swapxy.
  • Пример: dtoverlay=fly-tft-v2,speed=80000000,r270

Особые замечания для Raspberry Pi zero2 и zero2W​

  • Эти замечания относятся к использованию FLY-TFT-экрана совместно с G2T
  • Для Raspberry Pi zero2 и zero2w необходимо изменить настройку стандартного вывода, выполнив следующий код, иначе экран не будет отображаться
  • Обратите внимание, что после выполнения кода необходима перезагрузка для использования
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf

Установка экрана​