본문으로 건너뛰기

常用指令

문서 설명

본 문서는 Klipper 시스템에서 常用되는 Linux 명령어를 정리한 것으로, 주로 다음 용도로 사용됩니다：

  • 日常 작업 참고 – 高频命令의 빠른 조회 제공
  • 문제 해결 지원 – 常见 문제 발생 시 관련 명령어를 찾아 검증 또는 수정 가능
  • 학습 및 메모 – Linux와 Klipper 상호작용의 기본 명령어 집합

참고: 본 문서는 명령어 수집과 간단한 설명만 제공하며, 구체적인 디버깅 절차나 고장 분석을 다루지 않습니다. 실제 사용 시 상황에 맞게 적용하십시오.

장치 식별​

CAN 장치 ID 조회​

일반 상위 컴퓨터:

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

FLY 상위 컴퓨터:

python3 ~/klipper/scripts/canbus_query.py can0

USB 장치 ID 조회​

ls /dev/serial/by-id/*

펌웨어 굽기​

STM32 시리즈 (DFU 모드)​

  • HEX 파일은 굽을 수 없습니다
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/<펌웨어 파일>.bin

Katapult를 통한 Klipper 굽기​

USB 굽기​

일반 상위 컴퓨터:

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<메인보드 ID>

FLY 상위 컴퓨터:

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<메인보드 ID>

通用 명령어(장치 ID 지정 필요):

cd ~/klipper/ && make flash FLASH_DEVICE=<메인보드 ID>

CAN 굽기​

버전 설명

시스템 버전에 따라 올바른 명령어를 선택하십시오：

  • FlyOS-FAST 1.3.8 이상 버전 또는 2026년 4월 9일 이후 Klipper 업데이트 시스템：

    python3 ~/klipper/lib/katapult/flashtool.py -u <CAN-ID>

  • 旧 버전 시스템（FAST 1.3.8 이전 또는 2026년 4월 9일 전 Klipper 미업데이트）：

    python3 ~/klipper/lib/canboot/flash_can.py -u <CAN-ID>

CAN 리셋하여 BL 진입​

일반 상위 컴퓨터:

~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <메인보드 ID>

FLY 상위 컴퓨터:

python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <메인보드 ID>

RP2040 시리즈​

Klipper 펌웨어 굽기​

cd ~/klipper/ && make flash FLASH_DEVICE=2e8a:0003

Bootloader 굽기​

최초 굽기 시 도구 컴파일 필요:

cd ~/klipper/ && cd ~/klipper/lib/rp2040_flash/ && make

굽기 실행:

sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/<펌웨어 경로>/<파일명>.uf2

코드 관리​

특정 브랜치 가져오기​

저장소의 dev-flyos 브랜치를 /data/klipper 디렉터리에 가져오기:

cd && git clone https://cnb.cool/3dmellow/public/klipper -b dev-flyos /data/klipper

서비스 관리​

Klipper 서비스​

서비스 재시작​

sudo systemctl restart klipper

실시간 로그 보기​

sudo journalctl -u klipper -f

서비스 상태 확인​

sudo systemctl status klipper

Moonraker 서비스​

서비스 재시작​

sudo systemctl restart moonraker

실시간 로그 보기​

sudo journalctl -u moonraker -f

서비스 상태 확인​

sudo systemctl status moonraker

KlipperScreen 서비스​

서비스 재시작​

sudo systemctl restart KlipperScreen

실시간 로그 보기​

sudo journalctl -u KlipperScreen -f

서비스 상태 확인​

sudo systemctl status KlipperScreen
Loading...