Skip to main content

Common Debugging Commands

Tip
  • This tutorial focuses on the Fluidd web interface
  • It applies to debugging after the printer has been successfully connected
  • This tutorial provides commonly used commands, which may not be exhaustive due to various reasons
Note
  • Drivers that are not configured or have issues cannot be detected
  • Ensure all drivers have proper power supply, the mainboard power is normal, and driver jumpers and configurations are correct

Check Driver Status​

  • This command is used to verify the communication status of TMC drivers in SPI/UART mode. Execute in the console:

    DUMP_TMC STEPPER=stepper_x
    DUMP_TMC STEPPER=stepper_y
    DUMP_TMC STEPPER=stepper_z
    DUMP_TMC STEPPER=extruder
Tip

If there are multiple coaxial motors (e.g., stepper_x1, stepper_z1, etc.), replace them with the actual configured names.

Force Move Driver​

  • First, add the following configuration in printer.cfg:

    [force_move]
    enable_force_move: true

  • Then execute the STEPPER_BUZZ command in the console, and the motor will move back and forth by 1mm:

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

  • After enabling force_move, you can also force move via the web control panel

  • Note that only one motor can be moved at a time

  • For multiple axes (e.g., two Z axes), they need to be homed before control is possible

    Loading...

Forcibly Set Print Head Position​

  • Enter the following command in the console to forcibly set the print head position; after setting, movement can be directly controlled:

    SET_KINEMATIC_POSITION x=100 y=100 z=100

Extruder Step Value Calibration​

  • Before calibration, confirm:

    1. The extruder driver can work normally
    2. full_steps_per_rotation and gear_ratio are configured correctly

  • Reference configuration:

    full_steps_per_rotation: 200        # Steps per rotation (200 for 1.8 degrees, 400 for 0.9 degrees)
    gear_ratio: 50:10                   # Gear ratio (BMG is 50:17, output shaft first, input shaft second)
    rotation_distance: 22.522           # Drive pulley circumference in mm

  • Calibration formula:

    New rotation_distance = Old rotation_distance * Actual Extruded Length / Requested Extruded Length

  • After obtaining the new rotation_distance, round it to 3 decimal places

PID Calibration​

Tip
  • TARGET= is followed by the set temperature; set the temperature commonly used for printing
  • If there are multiple heating devices, replace the value after HEATER= with the actual name

  • Extruder:

    PID_CALIBRATE HEATER=extruder TARGET=245

  • Heated Bed:

    PID_CALIBRATE HEATER=heater_bed TARGET=100

  • PTC:

    PID_CALIBRATE HEATER=PTC TARGET=70
Tip
  • For heating wait timeout issues, refer to: M109 Optimization
  • For errors caused by temperature fluctuations, refer to: verify_heater Optimization

Standard Endstops​

Danger
  • Ensure the endstop switch is two-wire; if it is three-wire, verify the wire sequence is correct, otherwise it may damage the mainboard!

  • Query endstop status:

    QUERY_ENDSTOPS

  • Ensure the endstop is in its normal open state (not triggered). The following information should be returned after execution:

    Loading...

  • Manually press the endstop and execute QUERY_ENDSTOPS again; the endstop status should change:

    Loading...

  • A change in endstop status indicates correct wiring

Sensorless Homing​

  • The default status of sensorless homing should be open; if not, the configuration or wiring is incorrect

  • The query method is the same as for standard endstops:

    QUERY_ENDSTOPS
    Loading...

BL-TOUCH​

  • Debug commands:

    CommandFunction
    BLTOUCH_DEBUG COMMAND=pin_downProbe deploys
    BLTOUCH_DEBUG COMMAND=pin_upProbe retracts
    BLTOUCH_DEBUG COMMAND=touch_modeEnters touch verification mode

Probe & TAP​

  • Query probe status (should display open when not triggered normally):

    QUERY_PROBE

  • It is recommended to add a pull-up ^ when configuring the pin

    Loading...

Repeatability Test​

  • Default 10 samples:

    PROBE_ACCURACY

  • 100 samples (more precise):

    PROBE_ACCURACY samples=100

Special Types​

Servo​

Tip

Servos come in 180-degree and 360-degree types; please differentiate accordingly.

  • Reference configuration:

    [servo my_servo]
    pin: PE6

  • Reference commands:

    SET_SERVO SERVO=my_servo ANGLE=360
    SET_SERVO SERVO=my_servo ANGLE=180
    SET_SERVO SERVO=my_servo ANGLE=0
Loading...