라즈베리 파이 사용 안내
주의사항:
- 확장 보드를 장착하기 전에 상위 기기의 전원을 끄십시오.
- 습하거나 먼지가 많은 환경에서 확장 보드를 사용하지 마십시오.
- 화면을 장착할 때 전력을 차단하고 화면 연결선 방향에 주의하여 플러그를 뽑아 넣지 않도록 하십시오.
- 팬을 장착할 때 팬의 전류 및 전압 사양을 확인하여 손상이 발생하지 않도록 하십시오.
- 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 사용
-
라즈베리 파이 40핀 제어 장치를 사용하려면 Klipper 튜토리얼에 따라 설치해야 합니다 RPi 마이크로 컨트롤러
[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%
화면 사용 방법
- GitHub 주소 FLY-TFT
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
입니다.
- 드라이버 설치 후에는
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
명령어를 실행하여 시스템을 재부팅해야 합니다.- 하드웨어 연결이 정확한지 확인하십시오.
- 드라이버가 설치되었는지 확인하십시오.
/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
화면 설치
