USB 펌웨어 컴파일
스위치 설정 확인
- 일반적인 사용 시,
스위치를 위로 올려주세요
- 스위치를 설정할 때는 반드시
완전히 위쪽으로 올려주세요
, 그렇지 않으면 하위 기기를 연결할 수 없을 수 있습니다!!!

SSH를 통해 상위 기기 연결
- 펌웨어 컴파일 전에 반드시
와이파이를 사용하여 상위 기기에 SSH 연결해야 합니다
- 먼저 다음을 수행하세요: 상위기기에 WiFi로 SSH 연결하기
- USB 펌웨어 켜기
- USB 펌웨어 수동 컴파일
USB 펌웨어 켜기
- FLYOS-FAST 시스템에는 미리 컴파일된 USB 펌웨어가 포함되어 있으므로, 수동으로 펌웨어를 컴파일할 필요가 없습니다. 아래 명령어를 실행하면 바로 켜질 수 있습니다.
- 또한
수동으로 USB 펌웨어 컴파일
을 선택하여 직접 펌웨어를 컴파일할 수 있습니다.
- SSH를 통해 상위 기기에 연결한 후 아래 명령어를 입력하세요
fly-flash -d c5 -h -f /usr/lib/firmware/klipper-h723-128k-usb.bin

USB ID 입력
- 상위 기기의 웹 인터페이스를 열고, 좌측 메뉴에서 설정 옵션을 찾아보세요.
![]() |
![]() |
- 파란색 ID를 복사하고,
printer.cfg
파일에서[mcu]
옵션 아래의serial:
뒤에 검색한ID
를 입력합니다. 저장하고 재시작하면 보드에 연결됩니다.
- 아래 설정에서 ID를 MCU 구성 중에 대체하세요.
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
- Klipper가
ADC 범위 초과
라는 경고를 표시하면 이는 정상적인 현상입니다. 열판과 온도 센서를 보드에 연결하고, 노즐 및 열판의 온도 센서 핀을 올바르게 구성한 후 저장하고 재시작하면 됩니다.
USB 펌웨어 수동 컴파일
Klipper 펌웨어 컴파일 및 구성 페이지 작업 설명
:::팁
키보드 입력 모드를 반각 모드(영문 모드)로 설정해 주세요.
:::
- 키보드의 위쪽 화살표 키
↑
, 아래쪽 화살표 키↓
는 메뉴 항목을 선택하기 위해 커서를 상하로 이동시킵니다. - 확인 키
Enter
또는 공백 키Space
는 메뉴를 선택하거나 하위 메뉴로 진입합니다. - 종료 키
ESC
는 상위 메뉴로 돌아갑니다. Q
키는 Klipper 펌웨어 구성 페이지를 종료합니다.- Klipper 펌웨어 구성 페이지를 종료할 때, 만약 저장 여부에 대한 메시지가 표시된다면
Y
키를 눌러 구성 파일을 저장합니다.
:::경고
구성 페이지 옵션 수가 적은 경우, [ ] Enable extra low-level configuration options
를 먼저 선택하여 일부 숨겨진 옵션이 표시되도록 해야 합니다.
:::
다음은 펌웨어를 컴파일하는 방법입니다:
-
SSH에 연결한 후 아래의 명령어를 입력하고 엔터를 누릅니다:
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig
-
여기서
rm -rf ~/klipper/.config && rm -rf ~/klipper/out
는 이전에 컴파일된 데이터와 펌웨어를 삭제하며,make menuconfig
는 펌웨어를 컴파일합니다. 실행 후 아래와 같은 인터페이스가 나타나야 합니다. -
Extra low-level configuration options을 활성화하고 엔터를 누릅니다.
-
Micro-controller Architecture 메뉴로 들어간 후 STMicroelectronics STM32를 선택하고 엔터를 누릅니다.
-
Processor model 메뉴로 들어가서 STM32H723를 선택하고 엔터를 누릅니다.
-
Bootloader offset를 선택하고 128KiB bootloader를 선택합니다.
-
**Clock Reference (8 MHz crystal)**를 선택하고 25 MHz crystal를 선택합니다.
-
Communication interface를 선택하고 **USB (on PA11/PA12)**를 선택합니다.
Q
키를 누르면구성 저장
이 나타나고, 그 후에Y
키를 누릅니다.
-
이제 구성이 저장되었으며 명령줄 환경으로 돌아왔습니다.
-
make -j4
를 입력하여 컴파일을 시작합니다. 시간이 다소 걸립니다.

- 마지막에 아래 내용이 출력되면 컴파일 성공입니다.

펌웨어 켜기
아래 명령어를 실행하여 펌웨어를 켜세요.
fly-flash -d c5 -h -f ~/klipper/out/klipper.bin

USB ID 검색하기
- 브라우저를 열고 주소 표에 호스트 컴퓨터의 IP 주소를 입력합니다. 예를 들어, 호스트 컴퓨터의 IP가
192.168.101.179
라면 이 주소를 입력하고 Enter 키를 누릅니다.

- 호스트 컴퓨터의 웹 인터페이스를 열고 좌측 사이드바의 설정 옵션에서 찾아보세요:
![]() |
![]() |
printer.cfg
를 클릭한 후 오른쪽 상단의DEVICES
를 클릭하세요.
![]() | ![]() |
SERIAL
을 클릭한 후 새로 고침하세요.
![]() |
![]() |
- ID를 복사합니다. 화살표로 가리키는 곳을 클릭하면 복사됩니다.
![]() |
![]() |
USB ID 입력하기
DEVICES
를 닫고 ID를 입력하세요.
- 구성 파일에서 다음 부분을 수정하세요:
[mcu]
serial: /tmp/klipper_host_mcu
수정된 내용은 다음과 같습니다:
[mcu host]
serial: /tmp/klipper_host_mcu
- 다음 항목을 추가하세요:
[mcu]
serial: <여기에는 방금 검색한 ID를 입력하세요>
![]() |
![]() |
- ID를 구성 파일에 입력하세요.
- ID를 입력한 후 오른쪽 상단의
SAVE & RESTART
를 클릭하세요.
![]() | ![]() |
- Klipper에서
ADC out of range
라는 메시지가 나타나면 이는 정상적인 현상입니다. 핫베드와 센서를 메인보드에 연결하고 헤드, 핫베드의 센서 핀을 구성한 후 다시 저장하고 재부팅하세요.
주의: 문서에서 나온 모든 ID는 예제입니다. 각 메인보드의 ID는 모두 다르므로 실제로 얻은 ID를 입력하세요.