第一步：共振根源定位——加速度计辅助的频率扫描
层纹的波纹状形态（VFA，Variable Frequency Artifacts）本质上是打印头在加速和减速过程中激发打印机机械结构的固有谐振频率造成的。不同频率的振动在模型表面叠加形成明暗相间的波纹。要消除这些振纹，首先要知道打印机的共振频率是多少。加速度计法是最精确的测量手段。
1.1 ADXL345加速度计的安装与配置
ADXL345加速度计模块（淘宝约15元，Raspberry Pi配件）是测量打印机振动频谱的标准工具。安装位置：将加速度计用双面胶粘贴在打印头散热器侧面（X轴方向测量），再用第二个加速度计粘贴在热床支架上（Y轴方向测量）。接线方式：VCC接Klipper主控板的3.3V引脚，GND接GND，SCL接SCL，SDA接SDA。如果使用USB加速度计版本（如ADXL345 USB板），直接连接树莓派的USB口即可——Windows/Mac系统的Klipper用户也可以直接用USB连接，无需额外的GPIO配置。
1.2 Klipper中执行频率扫描操作
配置完成后，在Klipper的printer.cfg中添加加速度计配置段：[resonance_tester] accel_chip: adxl345 probe_points: 100,100,20（测量点坐标，可根据打印机中心位置调整）。保存配置并重启Klipper后，在console中执行TEST_RESONANCES AXIS=X。打印机会在X轴方向从5Hz到100Hz做全频段扫描——整个过程约2分钟，期间打印头会发出不同频率的嗡嗡声（正常现象，不必担心）。扫描完成后，运行ACC_CALIBRATE AXIS=X自动分析频谱数据并输出共振频率峰值。典型的MakerBot式CoreXY结构打印机的X轴共振频率约45-55Hz，i3式龙门结构约35-45Hz。记录峰值FREQ_X值供下一步使用。
第二步：多频段输入整形滤波器参数配置
获取了共振频率峰值后，需要配置输入整形（Input Shaping）滤波器来抑制特定的共振频率。Klipper支持多种滤波器类型，选择正确的滤波器类型和参数是消除振纹的关键。
2.1 三种滤波器类型的选择指南
| 滤波器类型 | 抑制效果 | 引入延迟 | 适用场景 |
|---|---|---|---|
| ZV（Zero Vibration） | 80-90% | 极低（约0.5ms） | 结构刚性好的打印机 |
| ZVD（Zero Vibration Derivative） | 95-98% | 中度（约1ms） | 大多数消费级打印机推荐 |
| EI（Extra Insensitive） | 90-95% | 较高（约2ms） | 共振频率漂移大的老旧打印机 |
对于大多数使用场景，ZVD滤波器是最均衡的选择——它在抑制效果和计算延迟之间取得了最佳平衡。在printer.cfg中找到[input_shaper]段，设置shaper_type_x: zvd，shaper_freq_x: 实测频率值（上一步测得的值），shaper_type_y和shaper_freq_y同理设置Y轴数据。保存配置并重启后，打印一个20mm×20mm的校准立方体来验证效果——对比校准前后，表面的波纹状层纹是否已经转变为平整的表面。
2.2 加速度校准前后对比实测数据
校准前：X轴共振频率48.3Hz，振幅0.15mm，打印的校准立方体表面可见明显的明暗波纹，在45度角侧光下波纹肉眼可见。设置ZVD滤波器，shaper_freq_x=48.3Hz后重新打印相同模型：表面波纹振幅降至0.02mm以下（缩小87%），45度侧光下几乎看不到任何波纹。Y轴校准前共振频率52.1Hz，振幅0.12mm，校准后降至0.015mm（缩小88%）。核心结论：加速度计辅助的输入整形校准是消除机械振纹的最有效手段，效果远超单纯降低打印速度或加速度。
第三步：校准后的微调与长期稳定性维护
输入整形不是一次配置就终身适用的。随着打印机使用时间增加，机械结构的磨损和松动会导致共振频率发生缓慢漂移。
3.1 每月复检与增量调整策略
建议每3个月或每500打印小时执行一次完整的频率扫描（运行TEST_RESONANCES AXIS=X/Y）并检查频率峰值是否发生了超过5%的漂移。如果发现明显漂移（如从48.3Hz变为45.5Hz，漂移约6%），先不要直接修改shaper_freq_x参数——应首先检查机械连接是否松动：Z轴丝杆固定螺丝扭矩、皮带张力、打印头滑轨的POM轮磨损。在排除机械原因后，如果频率确实发生了变化（因为皮带老化导致张力降低致使共振频率下降），再在printer.cfg中更新shaper_freq_x为新值。经验表明：在500打印小时内的合格打印机，频率漂移通常不超过3%，处于ZVD滤波器的容忍范围内，不需要重新配置。
FAQ
问：没有加速度计能否做好输入整形校准？
可以，但精度低很多。Klipper的"手动"输入整形校准方法：打印一个从5000到15000mm/s²递增的加速度塔模型，观察各段表面的波纹情况，凭肉眼选取波纹最少的一段对应的加速度值，然后用该值倒推共振频率。这种方法的精度约±5-10Hz，远不如加速度计法的±0.1Hz。但如果手头没有ADXL345，手动校准仍然能带来约50-60%的振纹改善——值得一试。
问：加速度校准后打印速度可以提高到多少？
输入整形的主要目的是在不牺牲打印质量的前提下提高打印速度。校准完成后，可以将最大加速度（max_accel）从原来的3000mm/s²逐步提升至5000-8000mm/s²，同时保持与校准前同等的表面质量。对于CoreXY结构的打印机（如Bambu X1C、Voron 2.4），校准后甚至可以将加速度提至10000mm/s²而表面质量不下降。限速瓶颈将从振动转移到挤出系统（能否在高速下保持均匀挤出）。
问：为什么我的打印机做了输入整形校准后反而出现了新的纹路？
可能是滤波器频率设置错误。典型错误是将X轴频率设成了Y轴的数值。解决：确认shaper_freq_x和shaper_freq_y分别对应X轴和Y轴的实测频率值，不要搞混。另一个可能性是打印头质量变化（例如换了更重的打印头）导致共振频率大幅漂移，此时需要重新执行全频段扫描。
问：多频段滤波器是否可以同时消除多个共振峰值？
Klipper的输入整形是针对单主峰优化的，一次只能处理一个主要共振频率。如果频谱图显示有两个明显峰值（例如X轴在32Hz和68Hz都有尖峰），选择振幅较大的那个主峰进行补偿（通常在40-60Hz之间）。次峰的振幅通常只有主峰的1/3以下，ZVD滤波器对次峰也有约50%的抑制效果。极端情况下（两个峰等高），使用EI滤波器可以覆盖更宽的频率范围，虽然抑制效果略低于ZVD但可以同时抑制两个峰。