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

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

활성화 설정

FlyOS-Fast v1.3.5 이상 버전에는 Shake&Tune이 사전 설치되어 있어 수동 설치가 필요 없습니다. 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 웹 UI에 Shake&Tune 매크로 버튼 표시
# timeout: 600
#    차트 생성 제한 시간(초). 저성능 장치에서는 적절히 늘릴 수 있음

추가 후 웹 UI에서 저장 및 재시작을 실행하면 됩니다.

사용 가능한 매크로 명령

사전 조건

Shake&Tune을 사용하기 전에 다음 사항을 확인해야 합니다:

1. 가속도계(ADXL345, LIS2DW 등)가 설치 및 올바르게 구성되어 있고, ACCELEROMETER_QUERY가 정상적으로 데이터를 반환하는지 확인.
2. printer.cfg에 [resonance_tester] 섹션이 정의되어 있어야 함.
3. 프린터가 귀환(Home) 완료 상태여야 함.

다음 매크로 명령은 웹 콘솔 또는 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의 파일 관리자를 통해 바로 확인할 수 있습니다.

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

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

일반 설치 안내: DebugDoc 플러그인 및 확장 보기