본문으로 건너뛰기

라즈베리 파이 사용 안내

주의사항:​

  • 확장 보드를 장착하기 전에 상위 기기의 전원을 끄십시오.
  • 습하거나 먼지가 많은 환경에서 확장 보드를 사용하지 마십시오.
  • 화면을 장착할 때 전력을 차단하고 화면 연결선 방향에 주의하여 플러그를 뽑아 넣지 않도록 하십시오.
  • 팬을 장착할 때 팬의 전류 및 전압 사양을 확인하여 손상이 발생하지 않도록 하십시오.
  • UART1은 기본적으로 활성화되어 있으므로 시스템 내에서 구성할 필요가 없습니다.
  • 최신 이미지를 븷러, 예를 들어 mainsailos를 사용하십시오. 커널 업그레이드는 아닙니다.
  • 라즈베리 파이는 모든 인터페이스를 사용할 수 있습니다!!
  • 주의: 라즈베리 파이에 사용되는 시스템 커널 버전은 5.17.x보다 커야하며, 커널 버전을 확인하려면 명령어 uname -r을 실행하십시오.

라즈베리 파이 사전 설치된 TFTV2 시스템 다운로드 링크​

  • 라즈베리 파이 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 연결 도구판 사용 방법​

  • 라즈베리 파이에 최신 시스템을 깔았다면 boot 디스크의 config.txt 파일을 편집해야 합니다.
  • 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 사용​

[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                   #최대 속도, full power 운행시의 80%
min_speed: 0.3                    #최소 속도, full power 운행시의 30%

화면 사용 방법​

1. 소개​

FLY-TFT-V2는 ST7796 기반의 TFT 액정 디스플레이로, 전기식 터치와 저항식 터치를 지원하며, 해상도는 320x480이고 SPI 인터페이스를 사용합니다.

2. 시스템 설치​

팁
  • 주의: 라즈베리 파이에 사용되는 시스템 커널 버전은 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. 사용​

팁
  • 터치를 사용하려면 I2C 지원이 필요합니다. 해당 설정은 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 # 270도 가로, 가로(반전)
    dtoverlay=fly-tft-v2,r0   # 0도 세로, 세로
    dtoverlay=fly-tft-v2,r180 # 180도 세로, 세로(반전)
    • 한 가지 설정만 추가할 수 있으며 여러 개의 설정은 추가할 수 없습니다.
    • 일반적으로 TFT의 터치 방향은 표시 방향에 따라 자동으로 회전하므로 시스템 내 터치 설정을 수정할 필요가 없습니다.

  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 장치를 활성화하기 위해 다음 명령어를 실행하십시오.
    • 기본 설정을 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 **필요한 매개변수: TFT의 최대 SPI 클럭 주파수를 설정합니다. 단위는 Hz이며, 기본값은 96000000입니다. (심각한 스캔 문제 발생 시 이 값을 낮추십시오.)

  • 예: dtoverlay=fly-tft-v2,speed=80000000

  • r0/r90/r180/r270 **선택적 매개변수: TFT의 표시 및 터치 방향을 설정합니다. 기본 값은 90도이며, 선택 가능한 값은 0, 90, 180, 270 입니다. (하나의 설정만 추가할 수 있음)

  • 예: dtoverlay=fly-tft-v2,r90 또는 dtoverlay=fly-tft-v2,r180

  • disable_touch **선택적 매개변수: TFT의 터치 기능을 비활성화합니다. 기본값은 활성화입니다.

  • 예: dtoverlay=fly-tft-v2,disable_touch

  • invx,invy **선택적 매개변수: TFT의 터치 방향을 설정합니다. invx는 X 방향 반전, invy는 Y 방향 반전입니다.

  • 예: dtoverlay=fly-tft-v2,invx 또는 dtoverlay=fly-tft-v2,invy 또는 dtoverlay=fly-tft-v2,invx,invy

  • swapxy **선택적 매개변수: TFT의 터치 방향을 설정합니다. X축과 Y축이 교환되며, 즉 가로모습입니다.

    • 예: dtoverlay=fly-tft-v2,swapxy
팁
  • 주의: 모든 매개변수를 동시에 설정할 수 있습니다 (선택적 매개변수는 하나만 선택할 수 있습니다). 여러 매개변수는 쉼표로 구분되며 여러 매개변수는 한 줄에만 추가할 수 있습니다.
  • 경고: 일반적인 상황에서는 r0, r90, r180, r270 네 가지 매개변수만 사용하며, 특히 invx, invy, swapxy 같은 다른 매개변수는 특별한 경우에만 사용됩니다.
  • 예: dtoverlay=fly-tft-v2,speed=80000000,r270

라즈베리 파이 zero2와 zero2W 주의사항​

  • 이 주의사항은 G2T와 함께 FLY-TFT 화면을 사용하는 데 대한 설명입니다.
  • 라즈베리 파이 zero2와 zero2w는 기본 표시 장치를 수정해야 합니다. 아래 코드를 실행하여 직접 수정하지 않으면 화면이 표시되지 않습니다.
  • 실행이 완료되면 재부팅해야 사용할 수 있습니다.
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf

화면 설치​