Voron Vibration and Resonance Troubleshooting — Ghosting, Ringing, and Artifacts

故障排查 校准 Mechanical

Every Voron owner eventually encounters print artifacts — those frustrating ripples, waves, and patterns that ruin an otherwise perfect surface finish. The good news: nearly all of them are fixable. The bad news: different artifacts have different causes, and applying the wrong fix wastes time and can make things worse. This guide teaches you to identify artifacts by sight, diagnose the root cause, and apply the correct fix.最后更新：2025年5月。

我们涵盖所有主要缺陷类型，深入解析 Klipper 的输入整形系统、框架与龙门架的机械故障排查、步进电机调校及框架稳定性。无论你是在 V2.4 350mm 上遇到鬼影，还是在 Trident 上遇到 VFA，本指南都能提供答案。

缺陷识别指南

在修复缺陷前，需正确识别它。以下是通过视觉检查区分常见 Voron 打印缺陷的方法。以 100-200 mm/s 速度打印校准立方体或平面测试件，使缺陷可见。

鬼影/振纹（共振缺陷）

现象： Repeating, fading wave patterns on vertical surfaces, especially near sharp corners or sudden direction changes. The waves are most visible on the X and Y faces of the print and fade toward the center. Ghosting looks like a "shadow" of the print's own features offset by a few millimeters.

原因： The toolhead's inertia excites the printer's natural resonance frequencies when it decelerates into corners or changes direction. The frame oscillates at its resonant frequency, and those oscillations imprint onto the print surface. Voron V2.4 350mm printers are particularly susceptible due to the large flying gantry's mass and flexibility.

Fix: Input shaper calibration (see the deep dive below). If input shaper is already calibrated and ghosting persists, the frequency measurement may be wrong or the printer may have changed since calibration (belt tension, toolhead weight, or frame position).

三文鱼皮/垂料纹（丢步或电机电流问题）

现象： A repeating, wavy pattern on horizontal surfaces (top layers and bottom surfaces) that has a "fish scale" or "salmon skin" texture. On vertical walls it appears as short, sharp horizontal lines that repeat at regular intervals.

原因： This artifact is caused by the stepper motor's microstepping positioning error combined with the interaction between the motor driver's current control mode and the motor's back-EMF. It's most common with TMC2209 drivers running in stealthChop2 mode at high speeds. The motor loses position accuracy at certain step frequencies, creating a periodic error.

Fix: Switch from stealthChop to spreadCycle mode for the X and Y stepper drivers. In Klipper's printer.cfg, setstealthchop_threshold: 0 for TMC2209/5160 drivers on X and Y axes to force spreadCycle mode. Alternatively, increase motor current (run_current) by 10-15% to improve torque margin. If the artifact persists, try higher microstepping resolution (256 instead of 128) or adjust the motor driver's interpolation settings. On V0.2 printers with tiny frame, salmon skin is rare — it's more common on larger Vorons pushing high accelerations.

VFA（垂直细纹缺陷 — 电机极通过频率）

现象： Very fine, closely spaced vertical lines on the print surface, typically 0.5-2mm apart. They appear as subtle vertical bands rather than obvious waves. VFA is most visible on glossy filaments like ABS and ASA under direct lighting. It looks like the print surface has a faint "grained" texture.

原因： VFA is caused by the stepper motor's pole-pass frequency — the natural torque ripple that occurs as the motor's internal magnets pass the stator poles. This is a physical characteristic of the motor and cannot be eliminated entirely, but it can be minimized. The artifact changes frequency with print speed because the motor's rotation speed changes, which shifts the pole-pass frequency.

诊断： Print the same model at three different speeds: 200mm/s, 150mm/s, and 80mm/s. If the spacing of the vertical artifacts changes with speed, VFA is the culprit. If the spacing stays the same regardless of speed, the cause is something else (Z binding, belt pulley eccentricity, or a bent lead screw).

Fix: Try the following in order: (1) Adjust stepper driver current — increase by small increments (0.05A) to find the current that minimizes motor vibration at your typical print speeds. (2) Switch between spreadCycle and stealthChop — some motor/driver combinations run smoother in one mode than the other. (3) Try a different microstepping setting (128 vs 256). (4) Replace motors with higher-quality units (LDO motors are known for lower VFA than generic NEMA17s). (5) As a last resort, use Klipper'svfa_freq calibration (available in recent Klipper versions) to measure and compensate for motor-specific VFA frequencies.

摩尔纹（过度挤出 + 输入整形交互作用）

现象： Wavy, interference-like patterns on flat surfaces, creating a visually busy texture that resembles the moiré effect on scanned images. The pattern interacts with the print orientation and can change as the print progresses up the Z axis.

原因： Moiré patterns in 3D prints are typically caused by the interaction between over-extrusion and input shaper. When extrusion multiplier is too high (1.05-1.10), the excess plastic has nowhere to go and creates a wavy surface. Input shaper's smoothing effect then interacts with this waviness to produce the moiré pattern. The effect is more pronounced on large, flat surfaces printed at high accelerations.

Fix: Reduce extrusion multiplier to 1.00 or 0.98 and re-extrude. If the pattern persists, recalibrate your pressure advance (see ourPressure Advance Guide). Also check that your input shaper frequency isn't too low — a too-low frequency causes more smoothing, which accentuates the moiré effect. Try a less aggressive shaper type (MZV instead of 2HUMP_EI) to reduce smoothing.

层纹/Z 轴缺陷

现象： Visible horizontal lines at regular Z height intervals, giving the print surface a stacked or "ribbed" appearance. In severe cases, you can feel the ridges with your fingernail. The lines may be uniformly spaced or appear in clusters at specific Z heights.

原因： Z artifacts arise from imperfections in the Z axis motion. Common causes: lead screw wobble (if the lead screw is bent or not parallel to the Z extrusions), Z rail binding (dirt or misalignment in the linear rail), inconsistent Z motor microstepping, or thermal expansion of the Z leads during enclosure heating.

Fix: Start by checking Z alignment. On Trident and V2.4, ensure all Z motors move in sync — runQUAD_GANTRY_LEVEL before each print. Check the lead screw for straightness by rolling it on a flat surface. Lubricate the Z linear rails with lightweight oil (Super Lube 51004 or similar). If using a single Z motor (V0.2, Switchwire), check that the coupler between motor and lead screw is tight and centered. For the V2.4's belt-driven Z, check belt tension — loose Z belts cause inconsistent Z layer heights.

输入整形深度解析

Input shaper 是消除 Voron 打印机重影/振纹的最重要工具。它测量打印机固有共振频率，过滤运动指令以在振动显现前抵消。以下是有效使用要点。

整形类型详解

Klipper 支持五种 shaper 算法，在重影抑制、平滑度和最大加速度间各有取舍：

• ZV（零振动）： The simplest shaper. Cancels vibration at a single frequency. Minimal smoothing (lowest acceleration loss of ~10%) but moderate ghosting suppression. Best for very rigid frames like the V0.2 where vibration is already minimal.
• MZV（改进型零振动）： An improved ZV that adds a second pulse for better suppression. Good ghosting reduction with low smoothing (~15% acceleration loss). The best all-rounder for most Voron builds. Start here unless you have a specific reason not to.
• EI（回波消除输入整形器）： Aggressive suppression with more smoothing (~40% acceleration loss). Use when MZV isn't enough to eliminate ghosting, or when surface quality is your absolute priority over speed.
• 2HUMP_EI： A two-hump EI variant that handles two overlapping resonance peaks. Excellent suppression with moderate smoothing (~25% acceleration loss). Ideal for V2.4 printers whose flying gantry produces two distinct resonance peaks (frame resonance + gantry belt resonance).
• 3HUMP_EI： The most aggressive shaper — maximum ghosting suppression at the cost of the highest smoothing (~35% acceleration loss). Best for large V2.4 350mm printers where frame flexibility creates multiple resonance peaks.

选择合适的整形器

Use MZV as your starting point for all Voron models. RunSHAPER_CALIBRATE with an ADXL345 accelerometer (see ourcomplete Input Shaper guide for wiring and configuration). If the recommended shaper from calibration is different from MZV, trust the calibration — Klipper's algorithm selects the shaper that provides the best vibration reduction at the highest possible acceleration.

按 Voron 机型推荐：

• V0.2： MZV or ZV. The tiny 120mm frame is extremely rigid. ZV provides enough suppression with minimal smoothing, preserving the high accelerations (10,000-15,000 mm/s²) the V0.2 is capable of.
• Trident： MZV or 2HUMP_EI. The fixed gantry is inherently more rigid than the V2.4's flying gantry, so MZV is usually sufficient. 2HUMP_EI for 300mm Tridents where the larger frame adds resonance.
• V2.4 250mm/300mm： 2HUMP_EI is the sweet spot. The flying gantry produces two resonance peaks, and 2HUMP_EI handles both effectively while keeping acceleration loss manageable.
• V2.4 350mm： 2HUMP_EI or 3HUMP_EI. The 350mm frame's larger spans create more complex resonance. Run SHAPER_CALIBRATE and accept whatever it recommends — it will likely be one of the EI variants.

ADXL345 安装技巧

Input shaper 校准质量高度依赖加速度计安装方式。错误安装=错误数据=无效 shaper。遵循以下规则：

• 刚性安装： The sensor must be firmly attached to the toolhead with no wiggle. A screw mount is ideal. 3M VHB double-sided tape works but add a zip tie for security.
• 对齐 axes: Mount the ADXL345 so its X and Y axes match the printer's X and Y movement directions. Use theaxes_map parameter in Klipper if you can't achieve perfect alignment.
• Toolhead 位置，而非 gantry： Mount the sensor on the toolhead (carriage), not the gantry extrusion. You want to measure the vibration at the print nozzle, not somewhere else on the structure.
• 短电缆： Use a cable shorter than 1.5m. Long cables pick up EMI from the stepper motor wires, corrupting the accelerometer readings. If you must use a long cable, route it away from motor and heater wires.
• 更改后重新运行： Any change to the printer — new toolhead, different hotend, tightened belts, even changing the desk surface — can shift resonance frequencies. Re-run SHAPER_CALIBRATE after every modification.

机械振动源

Input shaper 是强大工具，但无法修复机械问题。若打印机存在松动连接、导轨卡顿或皮带张力不均，任何软件调优都无法消除纹路。先修复机械问题，再校准 input shaper。

松动的挤出机连接件

检查框架所有角码和型材连接处。松动连接会放大振动——工具头振动传递至松动节点，引发共振。将角码 M5 螺栓拧紧至标准扭矩（通常 1.5-2.0 Nm，或“拧紧后加四分之一圈”）。建议使用扭矩扳手。V2.4 机型需特别注意 Z 型材和顶部框架角——这些部位在高速 Y 轴运动时承受最大载荷。

龙门架弯曲（V2.4 特有）

V2.4 的飞桥式龙门架为悬臂设计——X 轴龙门仅由左右 Y 导轨支撑。高加速度下龙门可能轻微扭转，产生 input shaper 难以抵消的低频摆动。确保龙门与热床平行：测量龙门型材两端到热床距离。350mm V2.4 上，差值超过 0.5mm 即需校正。松开龙门安装支架，重新校准后紧固。大型机型加装龙门支撑（Voron 用户改装 GitHub 提供）可显著减少形变。

皮带张力不平衡

X/Y 轴皮带张力应相近但不必完全相同。若两轴张力差异显著，`SHAPER_CALIBRATE` 的共振频率测量会显示两个独立峰值。修复方法：用手机 APP（Gate tension meter 等）或“拨弦测试”测量皮带张力——像拨吉他弦一样拨动皮带，两轴频率应在 100-140 Hz 范围。独立调整 X/Y 皮带张力至接近。注意：V0.2 皮带更短更硬，自然共振频率更高（140-180 Hz），勿尝试匹配 V2.4 的张力值。

导轨卡滞

直线导轨若存在卡点或安装偏差，滑块移动时会卡顿跳跃，产生 input shaper 无法抵消的尖锐振动尖峰。手动全程移动工具头或热床检查导轨阻力——应感觉平滑均匀。卡点表现为特定位置的“阻滞感”或阻力增大。修复：松开导轨安装螺丝，重新对齐后以交叉顺序拧紧。若导轨本身损坏（凹坑或压痕），需更换。

电机驱动微步进

The interaction between stepper motor microstepping and the motor driver's current control mode can introduce mid-band resonance — vibration at specific speeds where the motor's electrical frequency matches a mechanical resonance. This shows up as audible whining and visible artifacts at those specific feed rates. In Klipper, you can mitigate this by adjustingmicrosteps (try 16, 32, 64, or 128), switching between stealthChop and spreadCycle, or adjustingrun_current up by 5-10%. The best setting depends on your specific motor brand and model — there's no one-size-fits-all.

VFA 诊断与速度测试

垂直精细纹路（VFA）最难诊断，因其外观类似重影但对 input shaper 响应不同。以下是系统诊断方法：

步骤 1： Print a 40x40x40mm calibration cube at 200mm/s, 150mm/s, and 80mm/s. Use the same filament, temperature, and extrusion settings for all three.

步骤 2： Examine the vertical surfaces of all three cubes under a bright light at an angle. Measure the spacing between the fine vertical lines using calipers or a digital microscope.

步骤 3： If the line spacing changes proportionally with print speed (smaller spacing at lower speeds, larger spacing at higher speeds), the artifact is VFA from motor pole-pass frequency. If the spacing is the same at all speeds, the cause is mechanical — check the Z axis for binding, the belt pulleys for eccentricity, or the hotend for loose mounting screws.

步骤 4（VFA 已确认）： Try these fixes in order:

• 调整驱动电流：以 0.05A 为增量增加，最高不超过电机额定电流的 +20%。每次调整后打印测试件。
• Switch driver mode: if running spreadCycle, try stealthChop (set stealthchop_threshold: 999999), or vice versa.
• 更改微步进：尝试 32、64、128 和 256 微步。更高的微步进通常能平滑 VFA，但会降低保持扭矩。
• Try Klipper's vfa_freq calibration: runVFA_CALIBRATE to measure and compensate for motor-specific frequencies.

框架稳定性与环境

Voron 打印机放置表面显著影响打印质量。摇晃的桌面或不平地面引入低频振动，input shaper 无法完全抵消。

桌面/弹跳检查： While the printer is running at high speed (printing infill at 200mm/s+), place your hand on the desk next to the printer. If you feel noticeable vibration, your desk is resonating with the printer. The fix is to rigidly mount the printer to a solid surface or decouple it from the surface using vibration isolation.

刚性安装表面： The best surface for a Voron is a thick (~2+ inch) butcher block countertop, a concrete paver on a sturdy steel frame desk, or a dedicated printer stand with cross-bracing. Avoid flimsy IKEA-style desks, standing desk extensions, or folding tables — these amplify vibration rather than dampening it.

防震脚垫： If you can't change the desk, use anti-vibration feet or pads between the printer and the surface. Sorbothane hemispheres (durometer 50-70) are the gold standard — they absorb up to 95% of transmitted vibration at the frequencies common in Voron printers (20-80 Hz). Silicone anti-vibration pads (like the ones used for washing machines) also work but are less effective. Rubber feet alone are insufficient — they don't absorb the specific frequencies that cause print artifacts.

混凝土板技巧： Place a 40x40cm concrete paver (from any hardware store, $3-5) under the printer with a layer of Sorbothane or foam between the paver and the desk. The high mass of the paver absorbs vibration energy, and the decoupling layer prevents it from transmitting to the desk. This is the most cost-effective frame stability upgrade available. Many V2.4 350mm owners swear by this method.

Klipper 高级故障排查技巧

• 每次更改后重新校准： Input shaper frequencies drift with belt tension changes, toolhead swaps, and even ambient temperature. Re-runSHAPER_CALIBRATE after any maintenance or modification. Keep a log of measured frequencies so you can spot drift over time.
• Toolhead 与热床共振： Your toolhead and bed have different resonance frequencies. Klipper'sSHAPER_CALIBRATE measures toolhead resonance by default. To measure bed resonance (on Trident, V2.4, or Switchwire), mount the ADXL345 on the bed and useSHAPER_CALIBRATE AXIS=Z. This is important for tall prints where bed vibration at specific Z heights affects the top layers.
• 使用 CSV 数据进行分析： RunMEASURE_AXES_NOISE to check the noise floor. Export CSV data withACCELEROMETER_MEASURE and import into Python/Excel for custom analysis. A Klipper frequency graph with multiple spikes at unexpected frequencies points to a mechanical problem, not a tuning problem.
• 暂时禁用 input shaper： If you're troubleshooting a new artifact, temporarily disable input shaper (SET_INPUT_SHAPER SHAPER_TYPE_X=0 SHAPER_TYPE_Y=0) and print a test piece. If the artifact disappears, it's related to input shaper (wrong frequency, too much smoothing). If it persists, the cause is mechanical.
• 使用测试打印件： Download the Klipper ringing tower from the Klipper documentation. Print it at 150mm/s with increasing accelerations (2,000 to 10,000 mm/s²). The tower reveals at which speeds and accelerations artifacts appear, helping you isolate the root cause.

振动排查是系统性的排除过程。从最常见原因开始（输入整形校准、皮带张力、框架稳定性），逐步完成机械检查，仅在明显修复无效时才深入电机和驱动器调校。打印测试件、仔细测量、每次只改变一个变量。通过有条理的调试，每台Voron都能实现无缺陷打印——只需耐心和正确方法。