screws_tilt_adjust: Add new screws_tilt_adjust tool (#1367)

Signed-off-by: Rui Caridade <rui.mcbc@gmail.com>

config/example-extras.cfg

@@ -115,6 +115,9 @@
 #samples: 1
 #   The number of times to probe each point.  The probed z-values
 #   will be averaged.  The default is to probe 1 time.
+#samples_result: average
+#   One can choose median or average between probes samples
+#   The default is average.
 #sample_retract_dist: 2.0
 #   The distance (in mm) to retract between each sample if
 #   sampling more than once.  Default is 2mm.
@@ -157,6 +160,9 @@
 #samples: 1
 #   The number of times to probe each point.  The probed z-values
 #   will be averaged.  The default is to probe 1 time.
+#samples_result: average
+#   One can choose median or average between probes samples
+#   The default is average.
 #sample_retract_dist: 2.0
 #   The distance (in mm) to retract between each sample if
 #   sampling more than once.  Default is 2mm.
@@ -258,6 +264,47 @@
 #   The speed (in mm/s) when moving from a horizontal_move_z position
 #   to a probe_height position. The default is 5.
 
+# Tool to help adjust bed screws tilt using Z probe. One may define a
+# [screws_tilt_adjust] config section to enable a SCREWS_TILT_CALCULATE
+# g-code command.
+#[screws_tilt_adjust]
+#screw1: 100,100
+#   The X,Y coordinate of the first bed leveling screw. This is a
+#   position to command the nozzle to that is directly above the bed
+#   screw (or as close as possible while still being above the bed).
+#   This is the base screw used in calculations.
+#   This parameter must be provided.
+#screw1_name: front screw
+#   An arbitrary name for the given screw. This name is displayed when
+#   the helper script runs. The default is to use a name based upon
+#   the screw XY location.
+#screw2:
+#screw2_name:
+#...
+#   Additional bed leveling screws. At least two screws must be
+#   defined.
+#speed: 50
+#   The speed (in mm/s) of non-probing moves during the calibration.
+#   The default is 50.
+#horizontal_move_z: 5
+#   The height (in mm) that the head should be commanded to move to
+#   just prior to starting a probe operation. The default is 5.
+#samples: 1
+#   The number of times to probe each point.  The probed z-values
+#   will be averaged.  The default is to probe 1 time.
+#sample_retract_dist: 2.0
+#   The distance (in mm) to retract between each sample if
+#   sampling more than once.  Default is 2mm.
+#samples_result: median
+#   One can choose median or average between screw probes
+#   The default is average.
+#screw_thread: CW-M3
+#   The type of screw used for bed level, M3, M4 or M5 and the
+#   direction of the knob used to level the bed, clockwise decrease
+#   counter-clockwise decrease.
+#   Accepted values: CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5.
+#   Default value is CW-M3, most printers use an M3 screw and
+#   turning the knob clockwise decrease distance.
 
 # Multiple Z stepper tilt adjustment. This feature enables independent
 # adjustment of multiple z steppers (see stepper_z1 section below) to
@@ -284,6 +331,9 @@
 #samples: 1
 #   The number of times to probe each point.  The probed z-values
 #   will be averaged.  The default is to probe 1 time.
+#samples_result: average
+#   One can choose median or average between probes samples
+#   The default is average.
 #sample_retract_dist: 2.0
 #   The distance (in mm) to retract between each sample if
 #   sampling more than once.  Default is 2mm.
@@ -326,6 +376,9 @@
 #   just prior to starting a probe operation. The default is 5
 #samples: 1
 #   Number of probe samples per point. The defaut is 1
+#samples_result: average
+#   One can choose median or average between probes samples
+#   The default is average.
 #sample_retract_dist: 2.0
 #   Distance in mm to retract the probe between samples. Default is 2.