config: Update bed_mesh in example-extras.cfg

Update documentation about the fade options. Also inform the user that it is recommended to home toward the center of the print area when using a probe for z homing.

Signed-off-by: Eric Callahan <arksine.code@gmail.com>

1 files changed, 17 insertions, 7 deletions

diff --git a/config/example-extras.cfg b/config/example-extras.cfg
index 318669d2..1f4bc793 100644
--- a/config/example-extras.cfg
+++ b/config/example-extras.cfg
@@ -99,7 +99,10 @@
 # Mesh Bed Leveling. One may define a [bed_mesh] config section
 # to enable move transformations that offset the z axis based
 # on a mesh generated from probed points. Note that bed_mesh
-# and bed_tilt are incompatible, both cannot be defined.
+# and bed_tilt are incompatible, both cannot be defined.  When
+# using a probe to home the z-axis, it is recommended to define
+# a [homing_override] section in printer.cfg to home toward the
+# center of the print area.
 #[bed_mesh]
 #speed: 50
 #   The speed (in mm/s) of non-probing moves during the
@@ -129,12 +132,19 @@
 #   in which case that value will be for both axes. Default is 3,3
 #   which probes a 3x3 grid.
 #fade_start: 1.0
-#   The z-axis position in which to start phasing z-adjustment out.
-#   Default is 1.0.
-#fade_end: 10.0
-#   The z-axis position in which phase out is complete. If this
-#   value is less than or equal to fade_start then phasing out
-#   is disabled. Default is 10.0.
+#   The gcode z position in which to start phasing out z-adjustment
+#   when fade is enabled.  Default is 1.0.
+#fade_end: 0.0
+#   The gcode z position in which phasing out completes.  When set
+#   to a value below fade_start, fade is disabled. It should be
+#   noted that fade may add unwanted scaling along the z-axis of a
+#   print.  If a user wishes to enable fade, a value of 10.0 is
+#   recommended. Default is 0.0, which disables fade.
+#fade_target:
+#   The z position in which fade should converge. When this value is set
+#   to a non-zero value it must be within the range of z-values in the mesh.
+#   Users that wish to converge to the z homing position should set this to 0.
+#   Default is the average z value of the mesh.
 #split_delta_z: .025
 #   The amount of Z difference (in mm) along a move that will
 #   trigger a split. Default is .025.