Klipper 3D 打印文件坐标异常

• 1
  为什么 Klipper 3D 打印文件坐标异常首先出在位置限制
• 2
  当故障出在运动学而非数值时
• 3
  单板主机上的 GPIO 引脚映射与信号冲突
• 4
  电机电流、微步与累积位置误差
• 5
  G-code、切片配置与坐标原点不匹配
• 6
  如何在完整打印前确认修复
• 7
  坐标异常的症状与可能原因

Klipper 同时跟踪两套坐标系。g-code 文件携带工具头坐标，运动学求解器把它们转换为步进电机位置。两者不一致时，固件抛出异常而不是移动。这就是大多数坐标故障背后的全部机制。

位置限制在 printer.cfg 的 [stepper_x]、[stepper_y] 和 [stepper_z] 中定义。position_min 和 position_max 不是建议值，是硬边界。在声明为 0 到 300 的床上要求 X = 305 的移动，会在任何电机转动之前被拒绝。

异常消息通常会指出轴和请求值。按字面读。如果文件写 X 305 而配置写 300，问题在切片配置，不在固件。打印机报告的是真实的不匹配，不是随机故障。

一个陷阱：床网或探针偏移可能把看似有效的移动推出限制。如果 300 mm 的文件在不启用床网时打印正常，启用后却抛异常，先检查床网边距，再改模型。

• 1
  读轴名异常会告诉你越过了哪个限制。从这里开始。
• 2
  对比单位切片器设为英寸时，发出的坐标会大 25.4 倍。
• 3
  检查床网探针偏移和床网边距会移动可用范围。
• 4
  不要盲目放宽限制过于宽松的限制会掩盖机械故障。

在 CoreXY 或 delta 机器上，固件不直接驱动 X 和 Y 电机。它驱动两条皮带或三根立柱，并求解几何。这些机器上的坐标异常可能来自求解器，而不是文件。

Delta 打印机是最清楚的情况。可打印半径、臂长和立柱间距定义了工作范围。靠近边缘时，所需的臂角可能超出连杆物理上能到达的范围。Klipper 拒绝该移动，因为数学上没有实数解。

CoreXY 还有另一种失效模式。如果两条皮带张力不等，一个滑车会滞后。指令位置与实际位置逐渐偏离，误差在数千次移动中累积。固件可能直到漂移越过限制才抛异常。

快速诊断：禁用电机后用手逐个轴移动。任何粗糙点、紧点或可听见的咔哒声都是机械原因。先修好它，再动配置。

用作 Klipper 主机的单板计算机暴露的 GPIO 引脚与其他功能共用。一个声明为风扇 PWM 输出的引脚可能也被音频或 HDMI 子系统使用。一个引脚上两个驱动会产生不稳定的步进信号。

症状很具体。轴会动，但位置不对，或者移动中途卡住，固件报告坐标不匹配。它常常只在特定速度下出现，看起来像随机故障。

对照板子的引脚图文档检查 printer.cfg 中的引脚声明。确认该引脚未被操作系统保留。在某些板子上，引脚的默认上拉会在驱动期望低电平时把信号保持在高电平。

扩展板上的光耦隔离在这里有帮助。它把电机驱动信号与主机 GPIO 隔开，使步进驱动器的开关噪声无法反馈到主机。这在长排线机器上最重要。

丢步的步进电机不会报告。Klipper 假定指令位置已到达。因此误差会静默累积，直到后续移动越过限制，在远离原始故障处触发异常。

两个设置导致大多数丢步。运行电流太低，电机会在负载下失步。运行电流太高，驱动器或电机会过热，改变扭矩曲线。两者产生相同的可见结果。

微步影响每步扭矩。256 微步看起来平滑，但每微步扭矩很小。皮带摩擦大的机器在 32 或 64 微步、更高电流下可能表现更好。

机械阻力是另一半。干燥的直线导轨、过紧的皮带和不对中的丝杠都会提高负载。让电流适应机械，而不是反过来。

• 1
  检查驱动器温度驱动器发烫说明电流设置过高。
• 2
  降低微步负载下 32 或 64 微步通常比 256 更能保持位置。
• 3
  用手移动每个轴你能感觉到的阻力会在高速下导致丢步。

并非所有异常都来自硬件。切片软件会把坐标原点写入文件。如果切片软件假定热床原点在左前角，而打印机配置使用中心原点，那么每一次移动都会偏移。

偏移量通常是热床宽度的一半。300 mm 的热床若原点不匹配，会产生 150 mm 的偏移。这足以在首层触发限位。

注意绝对定位与相对定位模式。G90 设为绝对，G91 设为相对。文件若切换模式后没有明确回到绝对模式，就会以最后位置为基准发送相对移动，误差逐层累积。

还要检查起始宏是否回零到与切片软件预期不同的角。供应商提供的回零宏和切片配置常常是针对不同热床尺寸调校的。

不要用 12 小时的打印来测试坐标修复。写一个简短的验证文件，以慢速进给走遍整个行程范围。五十次移动足以暴露限位错误。

记录每次移动的指令位置和报告位置。Klipper 通过 API 暴露工具头位置。一个小脚本可以比较两者，并标记超出预期公差的漂移。

同一文件运行三次。三次中只出现一次的故障通常是机械或热问题，不是配置错误。每次都出现的故障是配置错误。

文件通过后，打印一个到达四角的单层测试件。测量实际零件并与 CAD 模型对比。差异说明修复是纠正了位置，还是只是移动了限位。