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	直近の2回の共振測定結果を比較し、調整効果を確認しやすくします
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 のチューニング：共振補償と圧力アドバンス設定の問題を参照