Skip to main content

Clog Detection Optimization

Feature Description​

FAST version 1.3.8 optimizes the clog detection feature, providing more precise clog detection capabilities and flexible configuration options. This feature can monitor the extruder's material output in real time, automatically pausing printing and notifying the user when a clog or filament break is detected.

Important Note

System Version Requirement: This feature requires FlyOS-Fast system version greater than or equal to v1.3.8 to function properly.

Configuration Method​

  • Add the following configuration to the printer.cfg file:
  • Note that this is a reference configuration; specific parameters may need to be adjusted based on actual conditions.
[filament_blockage_detection my_sensor]
switch_pin: ^PA10
extruder: extruder
distance_per_edge: 0.232
detection_length: 3
pause_on_runout: True
runout_gcode: M118 Clog detected during printing
insert_gcode: M118 Resumed while idle

Parameter Description:

ParameterDescription
switch_pinPin for the clog detection sensor; ^ enables the pull-up resistor
extruderName of the associated extruder
distance_per_edgeDistance of filament movement corresponding to each sensor trigger (in millimeters). This parameter is automatically calculated and updated after executing the calibration command; no manual initial value is required
detection_lengthDetection length threshold (in millimeters); if the sensor is not triggered beyond this distance, a clog is determined
pause_on_runoutWhether to automatically pause printing when a clog is detected
runout_gcodeG-code command executed when a clog is detected
insert_gcodeG-code command executed when filament is reinserted
Auto-Calibration Note

The distance_per_edge parameter will be automatically calculated to its optimal value after executing the CALIBRATE_FILAMENT_BLOCKAGE calibration command and permanently saved to the configuration file via the SAVE_CONFIG command. Any initial value can be entered during configuration; it will be automatically overwritten after calibration.

Calibration Steps​

To ensure detection accuracy, it is recommended to calibrate the sensor before use.

Step 1: Heat the Nozzle​

Heat the nozzle to the normal working temperature (recommended 220°C):

M104 S220
M109 S220

Step 2: Execute Calibration Command​

After the nozzle reaches the target temperature, execute the following calibration command:

CALIBRATE_FILAMENT_BLOCKAGE SENSOR=my_sensor TEMPERATURE=220

Command Explanation:

  • SENSOR: Sensor name, corresponding to [filament_blockage_detection my_sensor] in the configuration
  • TEMPERATURE: Nozzle temperature during calibration

Step 3: Save Calibration Results​

After calibration is complete, the system will automatically calculate the optimal distance_per_edge parameter. To manually save, execute:

SAVE_CONFIG

Important Reminders​

Firmware Update Requirement

After upgrading to FAST 1.3.8, the downstream firmware must be updated; otherwise, the clog detection feature may not function properly.

Please refer to the Screen Firmware Update documentation to complete the firmware upgrade.

Troubleshooting​

Issue 1: Clog Detection Not Triggering​

Possible Causes:

  • Sensor not properly connected
  • Incorrect switch_pin configuration
  • Downstream firmware not updated

Solutions:

  1. Check the sensor hardware connection
  2. Verify the pin configuration matches the actual hardware
  3. Update the downstream firmware to the latest version

Issue 2: False Clog Alarms​

Possible Causes:

  • Inaccurate distance_per_edge parameter
  • detection_length threshold set too low

Solutions:

  1. Re-execute the calibration command
  2. Appropriately increase the detection_length value (recommended 3-5mm)

Issue 3: Calibration Failure​

Possible Causes:

  • Nozzle temperature not meeting requirements
  • Sensor hardware malfunction

Solutions:

  1. Ensure the nozzle has been heated to the specified temperature
  2. Check if the sensor is working properly
  3. Try restarting the Klipper service

Usage Recommendations​

  • It is recommended to recalibrate the sensor whenever changing filament brand or diameter
  • Regularly check the sensor status to ensure detection accuracy
  • If the clog detection feature has not been used for an extended period, it is advisable to recalibrate before use
Loading...