extra: Add Safe Z home extra

Signed-off-by: Florian Heilmann <Florian.Heilmann@gmx.net>

1 files changed, 19 insertions, 0 deletions

diff --git a/config/example-extras.cfg b/config/example-extras.cfg
index 50d1ecfb..f3f1d1f8 100644
--- a/config/example-extras.cfg
+++ b/config/example-extras.cfg
@@ -1316,6 +1316,25 @@
 #   axis. The default is to not force a position for an axis.
 
 
+# Safe Z homing. One may use this mechanism to home the Z axis at a
+# specific XY coordinate. This is useful if the toolhead, for example
+# has to move to the center of the bed before Z can be homed.
+#[safe_z_home]
+#home_xy_position:
+#   A X,Y coordinate (e.g. 100,100) where the Z homing should be
+#   performed. This parameter must be provided.
+#speed: 50.0
+#   Speed at which the toolhead is moved to the safe Z home coordinate.
+#   The default is 50 mm/s
+#z_hop: 0.0
+#   Lift the Z axis prior to homing. This is applied to any homing command,
+#   even if it doesn't home the Z axis. If the Z axis is already homed and
+#   the zhop would exceed the printer limits, the zhop is ignored.
+#   The default is 0.0mm.
+#z_hop_speed: 20.0
+#   Speed at which the Z axis is lifted prior to homing. The default is 20mm/s.
+
+
 # Support manually moving stepper motors for diagnostic purposes.
 # Note, using this feature may place the printer in an invalid state -
 # see docs/G-Codes.md for important details.