화면 사용
- LCD HDMI 화면 사용
- LCD DSI 화면 사용
- G2T와 함께 사용하는 TFT 화면


주의 사항:
- 확장 보드를 설치하기 전에 상위 기계의 전원을 꺼주세요.
- 습기나 먼지가 많은 환경에서는 확장 보드를 사용하지 마세요.
- 화면을 설치할 때, 전원이 켜진 상태에서 화면 케이블을 뽑거나 삽입하지 말고, 화면 케이블 방향에 주의하세요. 손상되는 것을 방지하기 위해.
- 팬을 설치할 때, 팬의 전류 및 전압 사양에 주의하여 손상되지 않도록 하세요.
- UART1은 기본적으로 활성화되어 있으므로 구성에서 추가로 활성화할 필요가 없습니다.
- 최신 이미지를 업데이트하세요. 예:
mainsailos
, 커널 업데이트가 아닙니다. - 라즈베리파이는 모든 인터페이스를 사용할 수 있습니다!!
- 주의: 라즈베리파이에서 사용하는 시스템 커널 버전은
5.17.x
이상이어야 합니다. 커널 버전을 확인하려면 명령어uname -r
을 실행하세요.
라즈베리파이 사전 설치된 TFTV2 시스템 다운로드 링크
-
라즈베리파이 3B/3B+/4B/CM4/5B용 시스템 이미지
-
아래의 다운로드 링크를 클릭하세요
-
Loading...
화면 드라이버 설치
- 사전에 설치된 시스템을 직접 사용할 수 있습니다.
- 프로젝트 주소: FLY-TFT
소개
FLY-TFT-V2는 st7796 기반의 TFT 액정 디스플레이로, 터치 감지(전기 용량 및 저항)를 지원하며 해상도는 320x480이며, SPI 인터페이스를 사용합니다.
- KlipperScreen을 자체적으로 설치해야 합니다.
시스템 설치
주의: 라즈베리파이에서 사용하는 시스템 커널 버전은 5.17.x
이상이어야 합니다. 커널 버전을 확인하려면 명령어 uname -r
을 실행하세요.
최신 이미지를 업데이트하세요. 예: mainsailos
, 커널 업데이트가 아닙니다.
- 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를 클릭하여 설치가 완료될 때까지 기다리세요.
드라이버 설치
- 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
입니다.
- 드라이버를 설치한 후 config.txt 파일에
dtoverlay=fly-tft-v2
오버레이 지원을 추가해야 합니다. /boot/config.txt
(bookworm 시스템은/boot/firmware/config.txt
)를 열고sudo nano /boot/config.txt
- 파일 끝에 다음 설정을 추가하세요
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의 터치 방향은 표시 방향에 따라 자동으로 회전되며, 시스템 내부의 터치 설정을 수정할 필요가 없습니다.
- 파일 끝에 추가한 후
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