화면 사용

LCD HDMI 화면 사용

LCD DSI 화면 사용

DSI 사용 방법

• 이미지 쓰기가 완료된 후, /boot/config.txt에 다음 명령어를 추가합니다.

dtoverlay=vc4-kms-dsi-7inch

• 저장 후 종료합니다

G2T와 함께 TFT 화면 사용

주의 사항:

• 확장 보드를 설치하기 전에 상위 컴퓨터의 전원을 꺼주세요.
• 습기나 먼지가 많은 환경에서 확장 보드를 사용하지 마세요.
• 화면을 설치할 때는 전원을 켠 상태에서 플러그를 뽑거나 삽입하지 말고, 화면 케이블 방향에 주의하세요.
• 팬을 설치할 때는 팬의 전류와 전압 사양에 주의하세요.
• UART1은 기본적으로 활성화되어 있으므로 설정할 필요가 없습니다.
• 최신 이미지로 업데이트하세요, 예를 들어 mainsailos, 커널 업그레이드가 아닙니다.
• 라즈베리 파이는 모든 인터페이스를 사용할 수 있습니다!!!
• 주의: 라즈베리 파이의 시스템 커널 버전은 5.17.x보다 커야 합니다. uname -r 명령어로 커널 버전을 확인하세요.

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

• 라즈베리 파이 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을 직접 설치해야 합니다.

시스템 설치

주의 사항

주의: 라즈베리 파이의 시스템 커널 버전은 5.17.x보다 커야 합니다. uname -r 명령어로 커널 버전을 확인하세요. 최신 이미지로 업데이트하세요, 예를 들어 mainsailos, 커널 업그레이드가 아닙니다.

• Raspberry Imager를 사용하여 최신 MainsailOS를 설치하세요.
  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는 주의가 필요합니다.

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