Separate endstop and motion sensor thresholds in filament runout detection

[MrKuskov]

Description

This PR introduces improvements to filament runout detection logic when both endstop switch and motion sensor (encoder) are enabled (FILAMENT_SWITCH_AND_MOTION). Key changes:

• New ignore_motion flag: Temporarily disables motion sensor checks during endstop-triggered runout events to prevent false positives.

  • Controlled via RunoutResponseDelayed::set_ignore_motion().
  • Automatically reset on print start via new handle_runout_on_print_start().

• Separate trigger thresholds:

  • Motion sensor now uses dedicated motion_distance_mm (default: FILAMENT_MOTION_DISTANCE_MM), decoupling it from endstop sensitivity.

• Critical fixes:

  • Motion sensor counters now respect ignore_motion during extrusion.
  • Fixed incorrect usage of runout_distance_mm for motion sensors (now uses motion_distance_mm).
  • Added motion counter reset during runout events to avoid false triggers after recovery.

Requirements

• Configuration: Only affects setups with FILAMENT_SWITCH_AND_MOTION enabled.
• Testing: Requires hardware with both endstop and encoder-based filament sensors.

Benefits

• Prevents false runouts: Motion sensor ignores extrusion movements after endstop triggers.
• Flexible tuning: Independent distance thresholds for switch vs. encoder.
• Robust recovery: Clean state reset when starting new prints.

Configurations

Test with:

• FILAMENT_SWITCH_AND_MOTION enabled
• Customizable via:

  #define FILAMENT_RUNOUT_DISTANCE_MM 300  // Distance from sensor to extruder (mm)
  #define FILAMENT_RUNOUT_SENSOR_DEBUG    // Enable sensor debugging
  
  #if ENABLED(FILAMENT_MOTION_SENSOR)
    #define FILAMENT_SWITCH_AND_MOTION
    #if ENABLED(FILAMENT_SWITCH_AND_MOTION)
      // Encoder resolution (mm per pulse):
      #ifndef FILAMENT_MOTION_DISTANCE_MM
        #define FILAMENT_MOTION_DISTANCE_MM 3.0  // Default for 20mm encoder wheel
      #endif
  
    // Hardware configuration:
    #define NUM_MOTION_SENSORS 1       // Sensors count (1 per extruder)
    #define FIL_MOTION1_PIN P1_25       // E1DET pin (BTT SKR specific)
  #endif

#endif

[thinkyhead]

The added function handle_runout_on_print_start() is not called at any point in the code. It may be a little tricky to do so, since there is not always a clear definition about what constitutes a "print start" — but generally any time an SD print is started or resumed from a pause, or if a host that is sending commands sends the command to start the print job timer, that is when you might call handle_runout_on_print_start(). We'll formalize more events like this in the next phase of Marlin after the release of 2.1.3.

The name handle_runout_on_print_start implies that the function will deal with the situation where filament is missing at the beginning of a print job. However, all it does is reset and enable RunoutResponseDelayed, which is a relatively generic behavior. So I have moved it to a method in TFilamentMonitor::init_for_restart(bool onoff=true) indicating it should be called at any point where filament runout detection ought to reset and continue (or to reset and stop).

[thinkyhead]

I think this is about as complete as it's going to get, but please confirm that the modified code works, particularly the code calling runout.init_for_restart(...) because that is entirely speculative and maybe it does more than it should for the use-case. Once we have that little detail sorted out it should be good to go.

Overall this is a good addition to make more sense of a "motion sensor" as a way to gauge that filament has run out, separating it from the post-runout length, as the intent is not to throw the "M600" alarm until the complete length of filament specified by FILAMENT_RUNOUT_DISTANCE_MM has elapsed, even though the abstract "runout" state of the sensor is triggered.

There are bound to be questions about use-cases for different combinations of runout/motion sensors, so it could help to add more examples to the Filament Runout Sensors page on the Marlin website.

[vovodroid]

Add new parameter to M412/settings/menu in Configure FILAMENT_SWITCH_AND_MOTION #27836

[vovodroid]

On the other hand, if you set FILAMENT_RUNOUT_DISTANCE_MM larger than FILAMENT_MOTION_DISTANCE_MM (and it could be 200-400mm) no filament jam or slipping will be detected until this length.