跳到主要内容

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 网页中显示 Shake&Tune 宏按钮
# timeout: 600
#    图表生成超时时间（秒），低性能设备可适当增大

添加后在网页中执行 保存并重启 即可。

可用宏命令​

前提条件

使用 Shake&Tune 前需要确认：

  1. 已安装并正确配置加速度计（ADXL345、LIS2DW 等），ACCELEROMETER_QUERY 能正常返回数据。
  2. printer.cfg 中已定义 [resonance_tester] 段。
  3. 打印机已完成归位。

以下宏命令可在网页控制台或 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 插件与扩展

Loading...