Klipperr 연결
- 본 튜토리얼은 Fly-Buffer-Plus 버퍼에 KLIPPER 펌웨어를 플래싱하는 방법에 대한 설명입니다.
- 플래싱이 완료되면 압력 펌웨어 핀이 덮어쓰기됩니다.
- 이전 기능을 유지하려면 직접 매크로를 작성하거나 이전 펌웨어를 다시 플래싱해야 합니다.
- 모든 설정 및 사용하는 매크로는 직접 작성해야 합니다.
부트로더(Bootloader) 플래싱
플래싱 모드 진입 방법
- 플래싱 모드에 진입하는 방법은 두 가지가 있습니다.
- 첫 번째 방법: 보드의 전원이 완전히 꺼져 있는 상태에서 BOOT 버튼을 누른 채 데이터 전송이 가능한 TYPE-C 케이블을 한쪽은 메인보드에, 다른 쪽은 장치에 연결합니다.
- 두 번째 방법: 데이터 전송이 가능한 TYPE-C 케이블을 한쪽은 메인보드에, 다른 쪽은 장치에 연결한 상태에서 BOOT 버튼을 누르고 RST 버튼을 누른 후, RST 버튼을 먼저 떼고 BOOT 버튼을 뗍니다.
펌웨어 플래싱
- Windows 플래싱 튜토리얼
- 호스트 플래싱 튜토리얼
- 버퍼의 부트로더(Bootloader) 펌웨어
- 아래 다운로드 링크를 클릭하세요.
-
Loading...
USB3.0은(는) 플래싱에 실패할 가능성이 있으므로 컴퓨터의USB2.0포트를 사용하는 것이 좋습니다.- 여전히 플래싱이 되지 않는다면 호스트 컴퓨터를 변경하여 플래싱해 보세요.
- 아래와 같은 오류가 발생하면 USB 확장 허브를 사용해 주세요.
- 플래싱 툴 다운로드 링크
SetupSTM32CubeProgrammer및STM32 DFU 드라이버다운로드 필요- 펌웨어를 컴퓨터의 임의 디렉토리에 다운로드합니다.
- Type-C 데이터 케이블을 사용하여 메인보드를 컴퓨터에 연결하고, 반드시
dfu플래싱 모드에 진입했는지 확인합니다. - STM32CubeProgrammer에서 USB 모드를 선택하고 새로 고침 후 연결합니다.
- 오류 팝업이 발생하지 않았다면 연결이 성공한 것입니다.
경고
아래와 같은 화면이 나타난다면 컴퓨터 또는 소프트웨어 문제이므로 호스트 컴퓨터를 사용하여 플래싱해 주세요. 호스트 컴퓨터 플래싱 튜토리얼
- 왼쪽의 다운로드 아이콘을 클릭하고 아래의 항목들을 선택합니다.
- 화살표가 가리키는
Browse버튼을 클릭하고 플래싱할 펌웨어를 선택합니다.
Start address에0x08000000을 입력합니다.- 펌웨어가
HEX형식이라면 이 단계는 건너뛰어도 됩니다!
- 펌웨어가
- 아래쪽의
Start automatic mode버튼을 클릭하여 펌웨어 플래싱을 시작합니다.
- 아래와 같은 메시지가 나타나면 펌웨어 플래싱이 완료된 것입니다.
- 플래시 도구 설치
- FLY 상위기기는 플래시 도구 설치를 수행할 필요가 없습니다.
- 설치가 필요한 경우 주의하세요: 상위기기가 인터넷에 연결되어 있어야 정상적으로 설치됩니다.
- 이미 설치된 경우에는 다시 설치할 필요가 없습니다.
sudo apt update
sudo apt install dfu-util -y
- 다음 명령을 실행하여 연결이 성공했는지 확인합니다.
lsusb
- DFU 장치가 없으면 다시 플래시 모드로 진입해보세요.
- 시스템 버전 문제로 다른 이름이 표시될 수 있습니다. 만약
0483:df11이 표시되면 플래시 모드로 진입한 것입니다.
- 사전 컴파일된 펌웨어 가져오기
- 여기에는 모두 사전 컴파일된 펌웨어가 포함되어 있습니다.
- 상위기기가 인터넷에 연결되어 있어야 설치할 수 있습니다.
- 상위기기는 아래 명령을 실행하여 펌웨어 패키지를 다운로드해야 합니다 (상위기기의 네트워크 문제가 발생하여 파일을 가져올 수 없는 경우 관리자에게 문의하세요).
cd && git clone https://github.com/FengHua741/FLY_Katapult.git
- 이미 펌웨어 패키지를 다운로드한 경우 업데이트 후 나머지 작업을 진행하는 것이 좋습니다.
cd ~/FLY_Katapult && git pull
- 펌웨어 플래싱
하나의 펌웨어만 플래싱하면 됩니다.
- 펌웨어 플래싱 명령어
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/buffer/FLY_BUFFER.bin
-
아래 그림에서 화살표 부분에
File downloaded successfully라는 메시지가 나타나면 플래싱이 성공한 것입니다.
플래싱이 완료되면 메인보드의 전원을 완전히 끄고 다시 켜야 합니다.
USB 펌웨어 컴파일
컴파일 시작
- 설치된
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를 선택하고 8KiB bootloader를 선택합니다.
-
Communication interface를 선택하고 **USB (on PA11/PA12)**를 선택합니다.
-
다음 그림과 일치하는지 확인하고, 일치하면 다음 단계로 진행하세요.
Q키를 누르면 Save configuration 화면이 나옵니다. 이때Y키를 누릅니다.
- 설정이 저장되고 명령어 인터페이스로 나왔을 것입니다.
- 아래 명령어를 입력하여 컴파일을 시작합니다. 시간이 어느 정도 소요됩니다.
make -j4
-
마지막에 아래 내용이 출력되면 컴파일 성공입니다.
Linking out/klipper.elf
Creating hex file out/klipper.bin
- 컴파일 펌웨어 작업 기록
플래싱 모드 진입
RST버튼을 더블클릭하여 플래싱 모드에 진입합니다.
플래싱 모드 진입 확인
- 상위기기(Upstream)가 정상적으로 네트워크에 연결되어 있는지 확인하고, 하위기기가 상위기기와 데이터 전송 기능을 가진 데이터 케이블로 연결되어 있는지 확인하십시오.
- 상위기기에 SSH 접속 후 Enter 키를 누르고 명령어
lsusb를 입력하면 아래 이미지에서 빨간색으로 표시된 정보가 나타나면 다음 단계로 진행할 수 있습니다.- 아무런 정보도 반환되지 않는 경우, 이는 상위기기의 시스템 문제이며 해결이 불가능합니다. 정상적인 시스템으로 교체하거나 상위기기를 교체해야 합니다.
lsusb명령어가 없는 경우 다음 명령어를 실행하여 설치할 수 있습니다.sudo apt-get install usbutils
1d50:6177는 이번에 사용할 장치입니다.- 일부 상위기기는 시스템 문제로 인해 완전히 표시되지 않거나 전혀 표시되지 않을 수 있습니다.
- 만약
lsusb명령어를 입력했을 때 장치는 표시되지만1d50:6177이 표시되지 않는 경우 데이터 케이블을 교체하거나 상위기기의 다른 USB 포트로 연결해 보십시오.
- 위 단계를 수행했고 Klipper 펌웨어를 성공적으로 플래시한 적이 있으며, 메인보드가 정상적으로 작동 중이라면 Klipper 펌웨어 업데이트만 진행하려는 경우 오른쪽 메뉴바의
펌웨어 업데이트섹션을 참조하십시오.
반드시 1d50:6177 장치를 확인한 후 다음 단계로 진행해야 합니다.
펌웨어 플래싱
- 플래시 플러그인 설치 시 인터넷 연결이 필요하므로 호스트 머신이 인터넷에 정상적으로 연결되어 있는지 확인하십시오.
- 이미 설치한 경우 다시 설치할 필요가 없습니다.
플래싱 시작
-
fly 호스트 머신이 아닌 경우 아래 코드를 꼭 실행하여 펌웨어 플래싱에 필요한 종속 패키지를 설치하십시오. 설치하지 않으면 펌웨어를 플래싱할 수 없습니다!
- 기본 저장소
- 국내 저장소
cd && git clone https://github.com/Arksine/katapult.gitcd && git clone https://gitee.com/MrCakeFuck/katapult.git
-
아래 명령어를 사용하여 장치 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).
ls /dev/serial/by-id/*
-
아래 코드를 사용하여 펌웨어를 플래싱하십시오. 펌웨어가 이미 컴파일되어 있는지 확인하십시오.
<你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.
- Fly-Armbian 및 일반 호스트 머신 플래싱 방법
- Fly-FAST 플래싱 방법
~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>
python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>
-
참고 자료:
-
플래싱 완료 후 참고:
펌웨어 업데이트
- USB 펌웨어 업데이트
- CAN 펌웨어 브리지 업데이트
-
아래 명령어를 사용하여 보드 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).
ls /dev/serial/by-id/*
아래 그림의 /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00은 보드 ID입니다.
-
USB 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어로 업데이트하십시오.
<你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.cd ~/klipper/ && make flash FLASH_DEVICE=<你的主板ID>
- USB 브리지 CAN 펌웨어를 업데이트하려면 최신 펌웨어를 컴파일한 후 아래 명령어로 Katapult에 재설정하십시오(아래 그림 참조. 그림의 ID는 예시이며, 실제 ID는 설정 파일에 따라 다릅니다).
<CANBUS UUID>는 printer.cfg 설정 파일에 있는 보드의 CANBUS UUID입니다.
- Fly-Armbian 및 일반 호스트 머신 재설정 방법
- Fly-FAST 재설정 방법
<你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>
<你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>
- 아래 그림의
f95cee90e1f9는 보드의 CANBUS UUID입니다.
-
Katapult에 재설정된 후 아래 명령어로 보드 ID를 검색하십시오. 아래 그림과 같은 ID가 나타나야 합니다(참고: 그림의 ID는 예시이며, 각 보드의 ID는 다릅니다).
ls /dev/serial/by-id/*
아래 그림의 /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00은 보드 ID입니다.
-
새 펌웨어 컴파일이 완료된 후 플래싱을 실행하십시오.
<你的主板ID>를 이전 단계에서 확인한 ID로 교체하십시오.cd ~/klipper/ && make flash FLASH_DEVICE=<你的主板ID>
잘못된 펌웨어 플래싱 시 해결 방법
- 보드의 전원을 끄고 다시 켠 후 빠르게 리셋 버튼을 두 번 클릭하면 플래싱 모드로 다시 진입할 수 있습니다.
- 또는 Windows/호스트 머신을 사용하여 katapult 펌웨어를 다시 플래싱하십시오. katapult 펌웨어 플래싱
CAN ID 검색
- 브라우저를 열고 주소창에 호스트 컴퓨터의 IP 주소를 입력합니다. 예를 들어, 호스트 컴퓨터의 IP가
192.168.101.179이라면 그대로 입력하고 Enter를 누릅니다.
- 호스트 컴퓨터의 웹 인터페이스를 열고 좌측 사이드바의 설정 옵션에서 다음을 찾습니다:
 |
 |
printer.cfg를 클릭한 후 상단 오른쪽의DEVICES를 클릭합니다.
 |  |
CAN을 클릭한 후 새로고침합니다.
 |
 |
- ID 복사: 화살표가 가리키는 부분을 클릭하면 복사할 수 있습니다.
 |
 |
CAN ID 입력
DEVICES닫고 ID 입력
- 설정 파일 내:
아래와 같이 수정하세요:
[mcu]
serial: /tmp/klipper_host_mcu[mcu host]
serial: /tmp/klipper_host_mcu - 추가:
[mcu]
canbus_uuid: <여기에 방금 검색한 ID 입력>
 |
 |
- 설정에 ID 입력
- ID를 입력한 후 상단 오른쪽의
SAVE & RESTART를 클릭합니다.
 |  |
- Klipper에서
ADC out of range라는 메시지가 표시되는 것은 정상입니다. 열판과 온도 센서를 메인보드에 연결한 후 노즐과 열판의 온도 센서 핀을 설정하고 다시 저장하여 재시작하면 됩니다.
주의: 문서에 나와 있는 모든 ID는 예시입니다. 실제 각 메인보드의 ID는 다릅니다. 반드시 실제 획득한 ID를 입력하십시오.