跳到主要内容

常用调试指令

提示
  • 本教程以 Fluidd 网页界面为主要操作环境。
  • 本教程适用于打印机成功连接后的调试场景。
  • 本文仅提供常用指令，基于各种原因可能未完全列出所有可用命令。

驱动相关​

注意
  • 未配置或有故障的驱动无法检测。
  • 请确保所有驱动正常供电、主板正常供电，驱动跳线及配置正确。

检查驱动状态​

  • 此命令用于验证 SPI/UART 模式下 TMC 驱动的通信状态。在控制台执行：

    DUMP_TMC STEPPER=stepper_x
    DUMP_TMC STEPPER=stepper_y
    DUMP_TMC STEPPER=stepper_z
    DUMP_TMC STEPPER=extruder
提示

若存在多个同轴电机（如 stepper_x1、stepper_z1 等），请替换为实际配置名称。

强制驱动移动​

  • 首先在 printer.cfg 中添加以下配置：

    [force_move]
    enable_force_move: true

  • 然后在控制台执行 STEPPER_BUZZ 指令，电机将前后往复移动 1mm：

    STEPPER_BUZZ STEPPER=stepper_x
    STEPPER_BUZZ STEPPER=stepper_y
    STEPPER_BUZZ STEPPER=stepper_z
    STEPPER_BUZZ STEPPER=extruder

  • 启用 force_move 后，也可以通过网页控制面板进行强制移动。

  • 注意每次只能移动一个电机。

  • 多轴场景（如双 Z 轴）需先归位再进行控制。

Loading...

强制设置打印头位置​

  • 在控制台输入以下命令可强制设定打印头位置，设定后即可直接控制移动：

    SET_KINEMATIC_POSITION x=100 y=100 z=100

挤出机步进值校准​

  • 校准前请确认：

    1. 挤出机驱动可正常工作。
    2. full_steps_per_rotation 与 gear_ratio 已正确配置。

  • 参考配置：

    full_steps_per_rotation: 200        # 每转步数（1.8度=200，0.9度=400）
    gear_ratio: 50:10                   # 齿轮比（BMG 为 50:17，输出轴在前、输入轴在后）
    rotation_distance: 22.522           # 驱动齿轮周长，单位 mm

  • 校准公式：

    新 rotation_distance = 旧 rotation_distance × 实际挤出长度 / 设定挤出长度

  • 得到新的 rotation_distance 后保留 3 位小数。

加热相关​

PID 校准​

提示
  • TARGET= 后设置的目标温度应为正常打印所用温度。
  • 若存在多个加热设备，请将 HEATER= 后的值替换为实际名称。

  • 挤出头：

    PID_CALIBRATE HEATER=extruder TARGET=245

  • 热床：

    PID_CALIBRATE HEATER=heater_bed TARGET=100

  • PTC：

    PID_CALIBRATE HEATER=PTC TARGET=70

温度报错相关​

提示

温度控制指令​

  • 设置挤出头温度并等待达到目标：

    M109 S245          # 加热挤出头到 245°C 并等待
    M104 S245          # 加热挤出头到 245°C 不等待

  • 设置热床温度并等待达到目标：

    M190 S100          # 加热热床到 100°C 并等待
    M140 S100          # 加热热床到 100°C 不等待

  • 关闭所有加热器：

    TURN_OFF_HEATERS

  • 风扇控制：

    M106 S255          # 模型风扇全速
    M106 S128          # 模型风扇 50% 转速
    M107               # 关闭模型风扇

限位相关​

标准限位开关​

危险
  • 确保限位开关为两线制；若为三线制必须确认线序正确，否则可能损坏主板！

  • 查询限位状态：

    QUERY_ENDSTOPS

  • 确保限位处于常开状态（未触发），执行后应返回类似如下信息：

Loading...
  • 用手按下限位开关后再次执行 QUERY_ENDSTOPS，限位状态应发生变化：
Loading...
  • 限位状态发生变化表示接线正确。

无传感器归位​

  • 无传感器归位默认状态应为 open（未触发），否则表示配置或接线存在问题。

  • 查询方法与标准限位相同：

    QUERY_ENDSTOPS
Loading...

探针相关​

BL-TOUCH​

  • 调试命令：

    命令功能
    BLTOUCH_DEBUG COMMAND=pin_down探针伸出
    BLTOUCH_DEBUG COMMAND=pin_up探针收回
    BLTOUCH_DEBUG COMMAND=touch_mode进入触碰验证模式

Probe & TAP​

  • 查询探针状态（正常未触发时应显示 open）：

    QUERY_PROBE

  • 建议配置引脚时添加内部上拉 ^。

Loading...

探针重复性测试​

  • 默认 10 次采样：

    PROBE_ACCURACY

  • 100 次采样（更准确）：

    PROBE_ACCURACY samples=100

Z 轴偏移校准​

PROBE_CALIBRATE                          # 探针 Z 偏移校准
TESTZ Z=-0.1                             # 微调 Z 偏移（负值=喷嘴靠近热床）
ACCEPT                                   # 接受当前偏移值
ABORT                                    # 放弃此次校准
SAVE_CONFIG                              # 保存校准结果到配置文件

进阶指令：挤出、运动控制、网床、共振补偿、系统控制和特殊类型模块的调试指令请参考 进阶指令与系统操作。

Loading...