共振补偿与压力提前配置问题
本页整理 Input Shaper(共振补偿)和 Pressure Advance(压力提前)相关的配置错误与调优异常。加速度计硬件连接与通信报错请参考 加速度计测试与校准。
启用 Input Shaper 后振纹加重或打印模糊
现象:配置 [input_shaper] 后,打印件表面振纹(鬼影/波纹)反而比未启用时更明显,或细节变模糊、边角变圆。
常见原因:
shaper_freq_x/shaper_freq_y与实际共振频率偏差过大。shaper_type选择不适合当前机型(如高刚性机器使用了2hump_ei导致过度平滑)。- 机械结构存在松动(皮带过松、滑块间隙大、螺丝未紧固),共振补偿无法修正机械问题。
- 启用 Input Shaper 后未重新校准 Pressure Advance,两者叠加导致挤出异常。
解决方法:
-
先排除机械问题:断电后检查皮带张力、滑块/导轨间隙、框架螺丝紧固。
-
重新执行共振测量,获取准确频率:
TEST_RESONANCES AXIS=XTEST_RESONANCES AXIS=Y -
根据共振图选择合适整形器类型:
整形器 适用场景 频率容错 平滑度影响 zv高刚性、低振动机型 ±5% 最低 mzv大多数桌面机型(推荐首选) ±10% 中等 ei床身移动型 / 振动较大 ±20% 中高 2hump_ei存在多个共振频率 ±45% 高 3hump_ei复杂共振模式 ±60% 最高 -
启用 Input Shaper 后必须重新校准 Pressure Advance:
SET_PRESSURE_ADVANCE ADVANCE=0TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 -
如果模糊严重,尝试降低
shaper_freq约 5–10% 或换用容错更低的整形器类型。
相关配置参考:Klipper 共振补偿官方文档。
TEST_RESONANCES / SHAPER_CALIBRATE 配置类报错
报错信息:
accel_chip not configured/No accelerometer configuredprobe_points must be specified或坐标超出打印范围Invalid accel_chip/ 找不到指定芯片名称
常见原因:
[resonance_tester]中未配置accel_chip,或名称与[adxl345]/[mpu9250]/[lis2dw]段名不匹配。probe_points坐标超出[stepper_x]/[stepper_y]定义的position_max范围。- 多加速度计配置时
accel_chip写了错误的大小写或前缀。
解决方法:
-
确认配置段名称一致:
[adxl345]cs_pin: SHT36:gpio12spi_bus:spi0_gpio4_gpio3_gpio2[resonance_tester]accel_chip: adxl345probe_points:150, 150, 20 -
probe_points的 X、Y 坐标必须在打印范围内,Z 坐标为测试时喷嘴离床高度(建议 20 mm)。 -
若使用工具板上的加速度计,
accel_chip名称需与配置段完全一致(区分大小写)。 -
多芯片场景下可指定
accel_chip_x和accel_chip_y分别对应不同轴。
硬件通信报错:如
ACCELEROMETER_QUERY返回超时或 ID 错误,请参考 加速度计测试与校准 中的常见问题处理。
shaper_freq 过高导致电机异响或失步
现象:启用 Input Shaper 后电机发出高频啸叫、打印件出现规律性条纹,或高速移动时丢步。
常见原因:
shaper_freq设置值远高于实际共振频率(例如实际 40 Hz 却填了 80 Hz)。- 共振图解读错误,将噪声峰值误认为共振频率。
max_accel设置过高,超出电机扭矩能力。
解决方法:
-
重新执行
SHAPER_CALIBRATE,以自动推荐频率和整形器类型为准。 -
手动解读共振图时,选择最高且最尖锐的峰值对应频率,忽略低矮宽泛的噪声。
-
降低
max_accel至电机不失步的范围(建议从 3000 开始逐步提高):[printer]max_accel: 3000 -
若电机持续异响,临时禁用 Input Shaper 确认是否为配置问题:
SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0
Pressure Advance 启用后拐角鼓包或缺料
现象:启用 pressure_advance 后,打印件拐角处出现材料堆积(鼓包)或拐角前一段缺料/变细。
常见原因:
- PA 值过小:减速时喷嘴内残余压力未充分补偿 → 拐角鼓包。
- PA 值过大:加速时过度回抽 → 拐角前缺料、线条变细。
- 切片器同时启用了 Coasting(滑行)或 Extra restart distance,与 PA 补偿叠加冲突。
- 挤出机
rotation_distance未校准,基础挤出量不准确。
解决方法:
-
确保切片器中禁用 Coasting、Extra restart distance、动态加速度控制。
-
先校准挤出机
rotation_distance,再校准 PA。 -
使用 TUNING_TOWER 打印测试塔:
SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005近程挤出机使用
FACTOR=.005,远程 Bowden 使用FACTOR=.020。 -
选择拐角最清晰、线条最均匀的层对应高度,计算 PA 值:
pressure_advance = START + 高度 × FACTOR -
典型值范围:近程挤出 0.02–0.15,Bowden 0.1–1.0。若超过 1.0 仍无改善,说明问题不在 PA。
相关配置参考:Klipper Pressure Advance 官方文档。
PA 值过高导致挤出机跳步
现象:使用较高 pressure_advance 值(如 >0.2)后,加速/减速阶段挤出机发出咔嗒声或打印件出现断线。
常见原因:
- PA 补偿在加减速时产生大量额外挤出/回抽运动,超出挤出机扭矩。
- 加速度设置过高,PA 补偿量瞬间过大。
- 挤出机电流不足或耗材打滑。
解决方法:
- 降低
max_accel,减少 PA 补偿的瞬时挤出量。 - 适当降低 PA 值,在拐角质量和挤出可靠性之间取平衡。
- 检查挤出机电流设置(TMC 驱动
run_current)是否足够。 - 确认耗材无打滑(检查挤出齿轮磨损、弹簧压力)。
PA 系统不改变打印时间和总挤出量,只在加减速阶段重新分配挤出运动。极高的 PA 值会导致极大的瞬时挤出机运动量,且没有配置项可以限制该运动幅度。
pressure_advance_smooth_time 设置不当
现象:打印表面出现周期性波纹、挤出速度不平滑,或拐角过渡不自然。
常见原因:
pressure_advance_smooth_time设置过大(>0.1s),PA 补偿响应迟钝。- 设置过小(
<0.01s),PA 补偿过于激进导致挤出抖动。 - 旧版配置使用了已弃用的
[pressure_advance]独立段。
解决方法:
-
默认值
0.040适用于大多数场景,一般无需修改。 -
配置应写在
[extruder]段内:[extruder]pressure_advance: 0.05pressure_advance_smooth_time: 0.040 -
不要使用独立的
[pressure_advance]配置段(已弃用)。 -
若使用 Bowden 长管路,可适当增大至
0.060–0.080。
切片器设置与 Klipper 挤出控制冲突
现象:配置了 PA 后打印质量反而下降,出现拉丝加重、拐角异常或挤出颗粒。
常见原因:
- 切片器启用了 Coasting(滑行)功能,与 PA 减速补偿叠加。
- Simplify3D 的 Extra restart distance 导致挤出速度剧烈变化。
- KISSlicer 的 PreloadVE 与 PA 功能重复。
- 切片器的"动态加速度控制"或"Scarf joint"干扰测试。
解决方法:
- 禁用切片器中以下功能:
- Coasting(滑行)
- Extra restart distance(额外重启距离)
- PreloadVE(KISSlicer)
- 动态加速度控制 / 动态压力控制
- Scarf joint 接缝(校准 PA 时)
- 保留正常的回抽设置(建议 0.5–1.0 mm)和"回抽时擦拭"。
- 禁用切片器的"Z-lift on retract"(抬升回抽),由 Klipper 宏控制。
PA 校准测试时,切片速度建议 100 mm/s、层高约为喷嘴直径的 75%、填充 0%、关闭动态加速度控制,以充分暴露 PA 效果。
升级 Klipper 后共振补偿相关配置变更
现象:升级 Klipper 后 SHAPER_CALIBRATE 行为变化、共振测试结果与之前不同,或出现配置弃用警告。
常见原因:
- Klipper 更新了
[resonance_tester]默认参数(如sweeping_period、accel_per_hz)。 - 旧版
max_accel_to_decel已被minimum_cruise_ratio替代。 - 加速度计采样逻辑或滤波算法更新。
解决方法:
-
升级后查看 Klipper 配置变更记录,确认是否有影响共振补偿的条目。
-
若需恢复旧版测试行为,可在
[resonance_tester]中显式添加:[resonance_tester]sweeping_period: 0accel_per_hz: 75 -
升级后建议重新执行一次
SHAPER_CALIBRATE,不要沿用旧频率值。 -
若
max_accel_to_decel报错已弃用,改用:[printer]minimum_cruise_ratio: 0.5
配置迁移:更多升级后配置迁移问题,请参考 配置类报错 中的相关章节。