화면 사용

LCD HDMI 화면 사용

LCD DSI 화면 사용

DSI 사용 방법

• 미러링 플래싱이 완료된 후 /boot/config.txt에 아래 명령어를 추가합니다.

dtoverlay=vc4-kms-dsi-7inch

• 저장하고 종료합니다.

G2T와 함께 사용하는 TFT 화면

주의사항:

• 확장보드를 설치하기 전에, 상위 기기의 전원을 끈 것을 확인하세요.
• 습기나 먼지가 많은 환경에서 확장보드를 사용하지 마세요.
• 화면을 설치할 때, 전력을 끊고 화면 배선 방향을 주의하여 뽑아 넣지 않도록 유의하세요. 이를 어길 경우 손상이 발생할 수 있습니다.
• 팬을 설치할 때, 팬의 전류와 전압 사양을 주의하여 설치하십시오. 이를 어길 경우 손상이 발생할 수 있습니다.
• UART1은 기본적으로 활성화되어 있으므로 설정하지 않아도 됩니다.
• 최신 이미지를 플래시하세요, 예를 들어 mainsailos를 플래시하고 커널을 업그레이드하지 마세요.
• 라즈베리 파이는 모든 인터페이스를 사용할 수 있습니다!!
• 주의: 라즈베리 파이가 사용하는 시스템 커널 버전은 5.17.x 보다 커야 합니다. 커널 버전을 확인하려면 uname -r 명령어를 실행하세요.

라즈베리 파이 TFTV2 시스템 다운로드 링크

• Raspberry Pi 3B/3B+/4B/CM4/5B용 시스템 이미지

https://cdn.mellow.klipper.cn/IMG/Beta/RPI-TFT-IMG-new.img.xz

화면 드라이버 설치

• 미리 설치된 시스템을 직접 사용할 수 있습니다.
• 프로젝트 주소: FLY-TFT

소개

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

• KlipperScreen를 직접 설치해야 합니다. 설치 방법은 KlipperScreen을 참조하세요.

시스템 설치

주의사항

주의: 라즈베리 파이가 사용하는 시스템 커널 버전은 5.17.x 보다 커야 합니다. 커널 버전을 확인하려면 uname -r 명령어를 실행하세요. 최신 이미지를 플래시하세요, 예를 들어 mainsailos를 플래시하고 커널을 업그레이드하지 마세요.

• 최신 MainsailOS를 설치하기 위해 Raspberry Imager 사용
  1. Raspberry Imager를 다운로드하고 설치합니다.
  2. Raspberry Imager를 엽니다.
  3. CHOOSE DEVICE를 클릭합니다.
  4. 장치에 맞게 모델을 선택합니다.
  5. CHOOSE OS를 클릭합니다.
  6. Other specific-purpose OS를 선택합니다.
  7. 3D printing을 선택합니다.
  8. Mainsail OS를 선택합니다.
  9. 최신 버전을 선택합니다. 64비트 시스템을 지원하는 경우 rpi64를 선택합니다.
  10. CHOOSE STORAGE를 클릭합니다.
  11. SD 카드와 같은 저장 장치를 선택합니다.
  12. NEXT를 클릭하고 설치가 완료될 때까지 기다립니다.

드라이버 설치

• FLY-TFT-V2 드라이버 설치

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

TFT 표시 활성화

• 터치를 활성화하려면 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의 터치 방향은 표시 방향에 자동으로 따라갑니다. 시스템 내 터치 구성은 수정할 필요가 없습니다.

4. 파일 마지막에 구성 추가 후, sudo reboot 명령어를 실행하여 시스템을 재부팅하세요.

TFT 사용

• 하드웨어 연결이 올바른지 확인하세요.
• 드라이버를 설치했습니다.
• /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

KlipperScreen 사용

• MainsailOS는 KlipperScreen를 기본적으로 설치하지 않았습니다. 수동으로 설치해야 합니다.
• 설치 방법은 KlipperScreen 또는 kiauh를 참조하세요.
• KlipperScreen를 성공적으로 설치하고, 5단계를 올바르게 완료한 경우, KlipperScreen 화면이 표시되어야 합니다.

모든 사용 가능한 구성

• 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는 특별한 상황에서만 사용됩니다.