라즈베리파이 사용 설명서
주의 사항:
- 확장 보드 설치 전 상위 장치의 전원이 꺼져 있는지 확인하십시오.
- 습기 또는 먼지가 많은 환경에서 확장 보드를 사용하지 마십시오.
- 화면 설치 시 핀 방향에 주의하여 라이브 핀을 꽂지 않도록 하여 손상을 방지하십시오.
- 팬 설치 시 팬의 전류 및 전압 사양에 주의하여 손상을 방지하십시오.
- UART1은 기본으로 활성화되어 있으므로 별도로 설정할 필요가 없습니다.
mainsailos
와 같은 최신 이미지를 플래시하십시오. 커널 업그레이드가 아닙니다.- 라즈베리파이의 모든 인터페이스를 사용할 수 있습니다!!!
- 주의: 라즈베리파이에서 사용하는 시스템 커널 버전은 반드시
5.17.x
이상이어야 합니다. 커널 버전 확인은uname -r
명령어로 확인하십시오.
라즈베리파이용 TFTV2 시스템 이미지 다운로드 링크
-
라즈베리파이 zero2/zero2W/2B/3B/3B+/4B/CM4/5B에 적합한 시스템 이미지
-
이 이미지는 사전에 klipper, moonraker, mainsail, fluidd, klipper-screen 등이 설치되어 있습니다.
-
아래 다운로드 링크 클릭
-
Loading...
G2T 설치 방법
- 아래는 참고 사항입니다.
- 배선 참고
보드 내장 RS232를 이용한 툴보드 연결 방법

- 최신 시스템을 플래시한 후 라즈베리파이에서 부트 디스크의 config.txt 파일을 편집해야 합니다.
- UART1은 기본으로 활성화되어 있으므로 시스템 내에서 별도 설정이 필요 없으며, UART3은 아래 단계를 수행해야 합니다.
- config.txt에 다음 내용을 추가하십시오.
dtoverlay=uart3
- UART1을 사용하는 경우 ID 설정 예시:
[mcu]
serial: /dev/ttyAMA0
baud: 250000
restart_method:command
- UART3을 사용하는 경우 ID 설정 예시:
[mcu]
serial: /dev/ttyAMA1
baud: 250000
restart_method:command
보드 내장 5V FAN 사용 방법
-
라즈베리파이 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 # 최대 속도, 최대 출력의 80%
min_speed: 0.3 # 최소 속도, 최대 출력의 30%
화면 사용 방법
- Github 주소 FLY-TFT
1. 소개
FLY-TFT-V2는 ST7796 기반의 TFT LCD 화면으로, 정전용량식 및 저항식 터치를 모두 지원하며, 해상도는 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도 세로 방향(뒤집기)- 설정 중 하나만 추가할 수 있으며, 여러 개를 동시에 추가할 수 없습니다.
- 정상적으로 작동하면 터치 방향이 화면 방향에 자동으로 따라갑니다. 시스템 내 터치 설정을 변경할 필요가 없습니다.
-
파일 끝에 추가한 후,
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
화면 설치
