✨ M86/M87 Hotend Idle Timeout

MarlinFirmware/Marlin#25015

Author: thinkyhead

_gcode/M086.md

@@ -0,0 +1,58 @@
+---
+tag: m0086
+title: Hotend Idle Timeout
+brief: Set the hotend idle timeout.
+author: thinkyhead
+
+group: control
+eeprom: true
+
+codes: [ M86 ]
+related: [ M87 ]
+requires: HOTEND_IDLE_TIMEOUT
+since: 2.1.3
+
+parameters:
+  -
+    tag: S
+    optional: true
+    description: Timeout period. Temperatures are reduced if the machine is idle for this period.
+    values:
+      -
+        tag: seconds
+        type: int
+  -
+    tag: T
+    optional: true
+    description: Temperature trigger. Timeout only applies above this temperature.
+    values:
+      -
+        tag: temp
+        type: int
+  -
+    tag: E
+    optional: true
+    description: Extruder idle temperature. The hotend is set to this temperature on timeout.
+    values:
+      -
+        tag: temp
+        type: int
+  -
+    tag: B
+    optional: true
+    description: Bed idle temperature. The bed is set to this temperature on timeout. (Requires a heated bed.)
+    values:
+      -
+        tag: temp
+        type: int
+
+example:
+  -
+    pre: Reduce hotend and bed temperatures after 4 minutes with a hotend over 100
+    code: M86 S240 T100 E40 B30
+
+---
+
+Use this command to set a maximum period of time for the machine to be idle with heaters on. If the extruder temperature is above the trigger value and the machine is idle for longer than the set period, the firmware will set the temperature of all hotends and the heated bed to the configured temperatures.
+
+Send `M86` with no parameters to report the current settings.

_gcode/M087.md

@@ -0,0 +1,22 @@
+---
+tag: m0087
+title: Disable Hotend Idle Timeout
+brief: Disable the hotend idle timeout.
+author: thinkyhead
+
+group: control
+eeprom: true
+
+codes: [ M87 ]
+related: [ M86 ]
+requires: HOTEND_IDLE_TIMEOUT
+since: 2.1.3
+
+example:
+  -
+    pre: Disable the Hotend Idle Timer
+    code: M87
+
+---
+
+Use this command to disable the Hotend Idle Timer. Equivalent to `M86 S0`.