유선 연결 Klipper 구성
- STM32F072에 펌웨어를 업데이트한 후 Klipper에 연결해야 하며, 그렇지 않으면 유선 연결 작업을 지원하지 않습니다.
컴파일 시작
klipper
서비스가 설치된 상위기기를 사용해야 합니다. 네트워크를 통해 SSH 연결하기- 그리고 장치를 상위기에 잘 연결해야 합니다.
- 주의: 일반적인 상위기기를 사용하십시오. 예를 들어 라즈베리 파이 FLY 패 등입니다. WiFi 스틱, 홍미폰 등의 모modified 상위기는 지원 문제가 많아 기술 지원을 제공할 수 없습니다.
ROOT
사용자를 일반 사용자로 전환하려면 아래 명령어를 입력할 수 있습니다.ROOT
사용자는 사용하지 마십시오.- fly 사용자는 다음을 입력할 수 있습니다:
su fly
. fly 사용자가 아닌 경우<상위기기 사용자 이름>
을 상위기기의 사용자 이름으로 바꾸십시오!
su <상위기기 사용자 이름>
- 상위기기(Up Host)가 정상적으로 네트워크에 연결되어 있는지 확인하세요.
- 펌웨어 컴파일 전에 SSH를 통해 상위기기에 네트워크로 로그인해야 합니다.
- 상위기기에 시리얼 포트(Serial Tool)를 사용하지 마세요.
Klipper 펌웨어 컴파일 및 구성 페이지 작동 설명
키보드 입력 모드를 반각(Half-width) 모드로 설정해 주세요. 즉, 영문 모드입니다.
- 키보드의
↑
(위쪽 화살표),↓
(아래쪽 화살표)는 메뉴 항목을 선택하기 위해 커서를 위아래로 이동시킵니다. - 확인 키
Enter
또는 공백 키Space
는 메뉴를 선택하거나 하위 메뉴로 진입합니다. - 종료 키
ESC
는 상위 메뉴로 돌아갑니다. Q
키는 Klipper 펌웨어 구성 페이지를 종료합니다.- Klipper 펌웨어 구성 페이지를 종료할 때
Y
키를 눌러 구성 파일을 저장할 수 있습니다.
구성 페이지 옵션이 적을 경우, Enable extra low-level configuration options
항목을 선택([ ]
)하여 일부 숨겨진 옵션을 표시할 수 있습니다.
아래는 펌웨어를 컴파일하는 방법입니다:
-
SSH에 연결한 후 다음 명령어를 입력하고 Enter를 누릅니다:
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig
-
여기서
rm -rf ~/klipper/.config && rm -rf ~/klipper/out
는 이전에 컴파일된 데이터와 펌웨어를 삭제하고,make menuconfig
는 펌웨어를 컴파일합니다. 실행한 후 아래와 같은 화면이 나타나야 합니다. -
Enable extra low-level configuration options를 선택하고 Enter를 누릅니다.
-
Micro-controller Architecture 메뉴로 들어가서 STMicroelectronics STM32를 선택하고 Enter를 누릅니다.
-
Processor model 메뉴로 들어가서 STM32F072를 선택하고 Enter를 누릅니다.
-
Bootloader offset를 선택하고: **(No bootloader)**을 선택합니다.
-
Communication interface를 선택하고: **USB (on PA11/PA12)**을 선택합니다.
-
Q
키를 누르면 Save configuration가 나타나며, 그 후Y
키를 누릅니다. -
이제 설정을 저장하고 명령 프롬프트 화면으로 나와야 합니다.
-
make -j4
를 입력하여 컴파일을 시작합니다. 시간이 조금 걸립니다. -
마지막으로 다음 내용이 출력되면 컴파일이 성공적으로 완료되었습니다.
Linking out/klipper.elf
Creating hex file out/klipper.bin
프로그래밍 모드 진입
- AirClick을 전원을 끈 상태에서 STM32의 BOOT 버튼을 누른 채 STM32의 프로그래밍 포트를 Typec로 상위 기기와 연결합니다.
프로그래밍 모드 진입 여부 확인
-
상위 기기의 정상적인 네트워크 연결을 확인하십시오
-
하위 기기의 상위 기기와 연결된 데이터선이 데이터 전송 기능을 가지고 있는지 확인하십시오
-
SSH로 상위 기기에 연결한 후
lsusb
를 입력하고 Enter를 누르면 아래 세 가지 경우 중 하나가 나타날 수 있습니다- 이미 인식된 USB 장치가 표시됩니다
ls
명령어가 없어서 이 명령어를 실행하여 설치할 수 있습니다sudo apt-get install usbutils
- 오류가 없고 다른 정보도 없습니다 (시스템 문제로 인해 시스템을 변경해야 합니다)
-
lsusb
를 입력한 후 아무런 반응도 없는 경우 시스템 문제로 여기서는 도움을 드릴 수 없습니다. 정상적인 시스템을 사용해야 합니다 -
아래 그림에서 둘러싼 정보가 나타나면 다음 단계로 진행할 수 있습니다
-
0843:df11
은 이번에 사용해야 하는 장치입니다. 나머지 팁은 시스템 문제로 인해 일부만 표시되거나 아예 표시되지 않을 수 있으므로 무시하십시오 -
없으면 데이터선이 제대로 연결되었는지 또는 메인보드에 DFU가 들어갔는지 스스로 확인하십시오
0483:df11
이 있을 때만 다음 단계로 진행하십시오
펌웨어 프로그래밍
- 프로그래밍 도구 설치
- FLY 상위기기에서는 프로그래밍 도구 설치가 필요하지 않습니다.
- 설치가 필요한 경우 주의하세요: 상위기기는 인터넷에 연결되어 있어야 정상적으로 설치할 수 있습니다.
- 이미 설치된 경우 다시 설치할 필요가 없습니다.
sudo apt update
sudo apt install dfu-util -y
- 다음 명령을 실행하여 연결이 성공했는지 확인하세요.
lsusb
-
DFU 장치가 없으면 다시 프로그래밍 모드로 진입해보세요.
-
시스템 버전 문제로 다른 이름이 표시될 수 있습니다.
0483:df11
이 표시되면 프로그래밍 모드에 진입한 것입니다.
- 펌웨어 프로그래밍
- 아래 코드를 실행하여 프로그래밍을 시작하세요.
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/klipper/out/klipper.bin
- 아래 그림 화살표 부분에 표시된 내용
File downloaded successfully
이 나타나면 프로그래밍이 성공한 것입니다.

프로그래밍이 완료되면, 메인보드에 완전히 전원을 차단해야 합니다.
USBID 검색
- AirClick의 프로그래밍 포트를 상위 기기의 USB 포트와 연결해야 합니다. BOOT 버튼을 누르지 마세요. 그렇지 않으면 ID를 검색할 수 없습니다.
USB 교육 자료 검색
장치 검색 전 주의사항
- USB ID를 검색하기 전에 먼저 SSH 연결을 수행하세요.
- 네트워크를 통해 SSH에 로그인했는지 확인하세요 (시리얼 포트로 로그인하지 않았는지 확인).
- USB 펌웨어가 설치된 메인보드와 데이터 전송 기능이 있는 상위기기를 정확히 연결했는지 확인하세요.
장치 검색
- 상위 기기(PC)가 정상적으로 네트워크에 연결되었는지 확인하고, 하위 기기와 연결된 데이터선이 데이터 전송을 할 수 있는지 확인하세요.
- 상위 기기에 SSH 접속 후
lsusb
명령어를 입력하고 Enter 키를 누릅니다. 아래 이미지에서 원으로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.- 아무런 정보도 반환되지 않는 경우, 이는 상위 기기의 시스템 문제입니다. 해결이 불가능하므로 정상적인 시스템으로 교체하거나 상위 기기를 교체해야 합니다.
lsusb
명령어를 찾을 수 없다는 메시지가 나오면 다음 명령어를 실행하여 설치할 수 있습니다.sudo apt-get install usbutils
1d50:614e
는 이번에 사용할 장치입니다.- 일부 상위 기기는 시스템 문제로 인해 완전히 표시되지 않거나 전혀 표시되지 않을 수 있습니다.
lsusb
명령어를 입력했을 때 장치가 표시되지만1d50:614e
가 보이지 않는 경우, 데이터선을 교체하거나 상위 기기의 다른 USB 포트에 연결해 보세요.
- 만약 이전에 위 단계를 수행하고 Klipper 펌웨어를 성공적으로 번역한 적이 있으며, 현재는 Klipper 펌웨어를 업데이트하는 경우, 오른쪽 메뉴 바의
펌웨어 업데이트
섹션을 참조하세요.
반드시 1d50:614e
장치 중 하나를 찾은 후에 다음 단계로 진행할 수 있습니다.
USBID 검색
ls /dev/serial/by-id/*
- 아래 명령어를 입력하고 Enter를 누릅니다. 문제가 없다면 아래 색상이 파란색으로 표시되는 ID가 나타납니다. (아래는 예시입니다.)

- 아래 명령어를 입력했지만 ID가 나타나지 않으며,
lsusb
에는 장치가 보인다면 상위기기를 교체하거나 상위기기 시스템을 변경하세요.
여러 개의 ID가 나타난 경우, 각각의 메인보드 MCU 모델에 맞는 ID를 선택하세요.
USB ID를 설정 파일에 입력
![]() |
![]() |
참고: 문서에서 나타나는 모든 ID는 예시입니다. 실제 각 메인보드의 ID는 모두 다릅니다. 실제로 얻은 ID로 수정하여 입력하세요. :::
USB ID 입력
[mcu]
를 찾아서 대체하세요.
- 설정 파일에서 다음 내용을:
[mcu]
serial: <위에서 검색한 ID로 대체>
- 참고:
![]() |
![]() |
- 오른쪽 위의
SAVE & RESTART
를 클릭하면 자동으로 저장되고 klipper가 재시작됩니다.