유선 연결 Klipper 설정
- STM32F072에 펌웨어를 플래시한 후 Klipper에 연결해야 유선 연결이 지원됩니다.
컴파일 시작
- 설치된
klipper
서비스를 사용해야 합니다. 웹을 통해 SSH 연결 - 그리고 장치를 상위 기계에 연결해야 합니다.
- 주의: 일반적인 상위 기계, 예를 들어 라즈베리파이 FLY파이 등을 사용하십시오. 마이크로 변형 상위 기계(예: WiFi 스틱, 홍미 등)는 문제점이 많아 지원을 제공할 수 없습니다.
- FlyOS-Armbian 시스템과 일반 시스템 주의사항
- FlyOS-FAST 시스템 주의사항
FlyOS-Armbian
시스템과 일반 시스템 주의사항- 라즈베리파이, FLY파이 등 일반적인 상위 기계 시스템은 이와 같습니다.
- 이 종류의 상위 기계에서는
ROOT
사용자로 아무 작업도 하지 마십시오. - 일반 사용자로 작업하십시오.
- 사용자 전환 방법,
FlyOS-Armbian
시스템의 경우su fly
명령어를 사용하여 일반 사용자로 전환하십시오. - 다른 시스템의 경우
su <상위 기계 사용자 이름>
명령어를 사용하여 일반 사용자로 전환하십시오.
su <상위 기계 사용자 이름>
FlyOS-FAST
시스템 주의사항FAST 시스템
의 기본 사용자는root
이며, 비밀번호는mellow
입니다.- 펌웨어를 컴파일하는 것은
root
사용자만이 수행할 수 있습니다. - 또한
FAST 시스템
에는ROOT
사용자만 존재하며, 사용자를 전환할 필요가 없습니다!!!
- 상위기기(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 버튼을 누른 채로 Type-C 포트를 통해 STM32를 호스트 컴퓨터에 연결합니다.
플래싱 모드 진입 확인
-
상위 기기의 정상적인 네트워크 연결을 확인하십시오
-
하위 기기의 상위 기기와 연결된 데이터선이 데이터 전송 기능을 가지고 있는지 확인하십시오
-
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
이 나타나면 프로그래밍이 성공한 것입니다.

프로그래밍이 완료되면, 메인보드에 완전히 전원을 차단해야 합니다.
USB ID 검색
- AirClick의 플래싱 포트를 호스트 컴퓨터의 USB 포트에 연결해야 합니다. BOOT 버튼을 누르지 마세요. ID를 검색할 수 없습니다.
주의사항
- 작업 전에 툴보드에
USB
펌웨어가 이미 플래시되어 있는지 확인하십시오. - 본 튜토리얼은 툴보드 ID 검색용이며, 메인보드 ID 검색에는 사용할 수 없습니다.
- 상위 컴퓨터와 툴보드가 올바르게 연결된 후에 후속 작업을 진행하십시오.
SSH 연결
- 먼저 네트워크를 통해
SSH
에 로그인하십시오. - 네트워크 로그인을 통해
SSH
에 접속해야 하며, 직렬 포트 로그인은 사용할 수 없습니다.
장치 검색
- 상위 컴퓨터가 정상적으로 인터넷에 연결될 수 있는지 확인하시고, 하위 장치가 상위 컴퓨터와 연결된 데이터 케이블이 데이터 전송 기능을 가지고 있는지 확인하시기 바랍니다.
- SSH로 상위 컴퓨터에 연결한 후
lsusb
를 입력하고 엔터를 누르면, 아래 이미지에서 동그라미 친 정보가 표시된다면 다음 단계로 진행할 수 있습니다.- 아무런 정보가 표시되지 않는 경우, 이는 상위 컴퓨터의 시스템 문제로 인한 것이며, 이쪽에서는 해결할 방법이 없습니다. 정상적인 시스템으로 교체하거나 다른 상위 컴퓨터를 사용하십시오.
lsusb
명령어가 없다는 메시지가 표시되면, 아래 명령어를 실행하여 설치할 수 있습니다.sudo apt-get install usbutils
1d50:614e
는 이번에 사용할 장치입니다.- 일부 상위 컴퓨터에서는 시스템 문제로 인해 장치가 전부 표시되지 않거나 표시되지 않을 수도 있습니다.
lsusb
명령어로 장치는 표시되지만1d50:614e
가 표시되지 않는 경우, 데이터 케이블을 교체하거나 메인보드를 상위 컴퓨터의 다른 USB 포트에 연결해 보십시오.
하나의 1d50:614e
장치를 조회한 후에야 다음 단계로 진행해야 합니다.
USB ID 검색
ls /dev/serial/by-id/*
- 아래 명령어를 입력하고 엔터를 누르면 정상적으로 작동할 경우 아래와 같은 파란색 ID 한 줄이 나타납니다. (아래는 예시입니다.)

- 아래 명령어를 입력한 후 ID가 나타나지 않고
lsusb
에서 장치가 보인다면 다른 상위 컴퓨터 또는 다른 운영체제를 사용해 보십시오.
여러 개의 ID가 나타날 경우, 해당 ID는 사용 중인 메인보드의 MCU 모델에 따라 선택하시기 바랍니다.
USB ID를 설정에 입력하기
![]() |
![]() |
참고: 문서에 표시된 모든 ID는 예시입니다. 실제 각 메인보드의 ID는 서로 다릅니다. 실제 획득한 ID로 수정하여 입력하시기 바랍니다.
툴보드 USB ID 입력
-
아래는 참고 설정입니다.
주의사항- 아래 설정의
toolboard
는 툴보드 이름을 의미합니다. 다른 이름을 사용하는 경우 해당 이름으로 대체하십시오.
위험[mcu toolboard]
serial: <방금 검색한 ID로 여기를 대체하십시오>- 툴보드의
ID
를 입력할 때는 반드시[mcu toolboard]
뒤에serial:
을 추가하고 검색한 툴보드 ID를 입력해야 합니다.
- 아래는 참고 설정입니다.
- 본 튜토리얼은 툴보드 ID 검색 및 설정을 위한 것이며, 정상적으로 메인보드에 연결되어 있다고 가정합니다.
- 메인보드는 반드시
[mcu]
로, 툴보드는[mcu toolboard]
로 설정되어야 합니다.
- fluidd 참고 설정
- mainsail 참고 설정
- 오른쪽 상단의
SAVE & RESTART
버튼을 클릭하면 자동으로 저장되고 Klipper가 재시작됩니다.
- 아래 설정의