Klippain Shake&Tune 공진 분석 플러그인

Klippain Shake&Tune은 Klipper 공진 분석 및 입력 셰이퍼 교정 플러그인으로, 가속도계로 수집한 진동 데이터를 시각화 차트로 생성하여 기계적 문제를 진단하고 Input Shaper 필터를 최적화하는 데 도움을 줍니다.

FlyOS-FAST 사용자

FlyOS-FAST v1.3.5 이상에는 Shake&Tune이 사전 설치되어 있어 수동 설치가 필요 없습니다. printer.cfg에 [shaketune] 설정 구간을 추가하고 재시작하기만 하면 됩니다.

전체 설정 매개변수 및 설명은 다음을 참조하세요: FlyOS-FAST Shake&Tune 플러그인 설명

설치

SSH 도구를 사용하여 호스트 컴퓨터에 연결하고 다음 조건을 확인하세요:

1. 호스트 컴퓨터에 Klipper 펌웨어가 설치되어 있어야 합니다.
2. 가속도계(ADXL345, LIS2DW 등)가 설치 및 올바르게 구성되어 있어야 하며, ACCELEROMETER_QUERY 명령이 정상적으로 데이터를 반환해야 합니다.
3. printer.cfg에 [resonance_tester] 구간이 정의되어 있어야 합니다.

플러그인 가져오기 또는 업데이트

이 단계는 GitHub 연결이 필요합니다. 가져오기가 성공적으로 완료된 것을 확인한 후 설치 스크립트를 실행하세요.

cd ~
if [ -d ~/klippain-shaketune/.git ]; then
  git -C ~/klippain-shaketune pull --ff-only
else
  git clone https://github.com/Frix-x/klippain-shaketune.git ~/klippain-shaketune
fi

설치 스크립트 실행

cd ~/klippain-shaketune
chmod +x install.sh
./install.sh
systemctl restart klipper

FlyOS-FAST 시스템을 사용하는 경우 설치 경로를 /data/ 디렉토리로 조정해야 합니다. 자세한 내용은 위의 FlyOS-FAST 전용 문서를 참조하세요.

설정 구간 추가

printer.cfg에 다음을 추가합니다:

[shaketune]
# result_folder: ~/printer_data/config/ShakeTune_results
#    처리 결과 저장 경로, 폴더가 없으면 자동 생성됨
# number_of_results_to_keep: 10
#    보관할 최근 결과 수, 초과 시 오래된 파일 자동 정리
# keep_raw_data: False
#    True로 설정하면 원시 .stdata 파일도 함께 저장하여 문제 해결 또는 피드백 제출에 사용
# show_macros_in_webui: True
#    Fluidd / Mainsail 웹 인터페이스에 Shake&Tune 매크로 버튼 표시
# timeout: 600
#    차트 생성 제한 시간(초), 저성능 장치에서는 적절히 증가 가능

저장 후 Klipper를 재시작합니다.

설치 확인

systemctl is-active klipper

active가 반환되면 웹 콘솔에서 TEST_RESONANCES 등 매크로 명령을 입력하여 명령이 인식되는지 확인합니다.

사용 가능한 매크로 명령

설치가 완료되면 다음 매크로 명령을 웹 콘솔 또는 G-code에서 사용할 수 있습니다:

매크로 명령	용도
TEST_RESONANCES AXIS=X	X축 공진을 측정하고 스펙트럼 차트 및 권장 Input Shaper 매개변수 생성
TEST_RESONANCES AXIS=Y	Y축 공진을 측정하고 스펙트럼 차트 생성
TEST_RESONANCES AXIS=X OUTPUT=raw_data	원시 데이터만 수집하고 자동 차트 생성 안 함
COMPARE_RESONANCES	최근 두 번의 공진 측정 결과를 비교하여 조정 효과 확인에 용이
BELTS_SHAPER_TUNING	전용 벨트 공진 테스트, Hanning 창 기반 스펙트럼 비교 차트 생성

실행이 완료될 때마다 Shake&Tune은 result_folder에 PNG 차트 파일을 생성하며, Fluidd / Mainsail의 파일 관리자를 통해 직접 확인할 수 있습니다.

Klipper 내장 명령과의 차이점

Shake&Tune은 Klipper 내장 SHAPER_CALIBRATE를 대체하지 않으며, 그 위에 더 풍부한 시각화 분석을 제공합니다:

기능	Klipper 내장	Shake&Tune
Input Shaper 매개변수 자동 계산	SHAPER_CALIBRATE가 설정에 직접 기록	TEST_RESONANCES가 참고용 차트 생성
스펙트럼 시각화 차트	없음	PNG 스펙트럼 차트 자동 생성
벨트 장력 비교	없음	BELTS_SHAPER_TUNING이 비교 차트 생성
여러 측정 결과 비교	없음	COMPARE_RESONANCES가 최근 결과 비교

내장 명령은 빠른 자동 교정에 적합하고, Shake&Tune은 상세 스펙트럼 확인, 기계적 문제 진단 또는 벨트 장력 비교가 필요한 상황에 적합합니다.

자주 묻는 질문

차트 생성 제한 시간 초과

저성능 장치에서 차트 생성 시 제한 시간이 초과될 수 있습니다. [shaketune]의 timeout 값을 적절히 증가시키세요. 예: timeout: 900.

결과 폴더가 생성되지 않음

result_folder 경로가 존재하고 Klipper에 쓰기 권한이 있는지 확인하세요.

설치 후 ACCELEROMETER_QUERY 오류

Shake&Tune은 가속도계 하위 통신에 영향을 주지 않습니다. 설치 후 통신 오류가 발생하면 먼저 가속도계 테스트 및 교정 문서에 따라 하드웨어 및 구성 문제를 진단하세요.

가속도계 구성 및 테스트: 가속도계 테스트 및 교정 보기

공진 보상 및 Input Shaper 튜닝: 공진 보상 및 압력 전진 설정 문제 보기