documentation updated

akaJes · akaJes · commit 0570fd813b07 · 2017-12-11T16:10:34.000+02:00
diff --git a/views/configuration.md b/views/configuration.md
diff --git a/views/gcode/G005.md b/views/gcode/G005.md
@@ -36,6 +36,14 @@ parameters:
       -
         tag: pos
         type: float
+  -
+    tag: E
+    optional: true
+    description: The length of filament to feed into the extruder between the start and end point
+    values:
+      -
+        tag: pos
+        type: float
   -
     tag: I
     optional: false
diff --git a/views/gcode/G026.md b/views/gcode/G026.md
@@ -4,19 +4,22 @@ title: Mesh Validation Pattern
 brief: Test the mesh and adjust.
 
 experimental: true
-requires: AUTO_BED_LEVELING_UBL,UBL_G26_MESH_EDITING
+since: 1.1.0
+requires: HAS_MESH,G26_MESH_VALIDATION
 group: calibration
 
 codes:
   - G26
 
 long:
   - |
-    `G26` Mesh Validation Pattern is designed to be used in conjunction with mesh-based leveling to test the accuracy of the probed mesh. This feature is currently only implemented for [Unified Bed Leveling](/docs/features/unified_bed_leveling.html), so `AUTO_BED_LEVELING_UBL` is required.
+    `G26` Mesh Validation Pattern is designed to be used in conjunction with mesh-based leveling to test the accuracy of the probed mesh.
 
     The `G26` command prints a single-layer pattern over the entire print bed, giving a clear indication of how accurately every mesh point is defined. `G26` can be used to determine which areas of the mesh are less-than-perfect and how much to adjust each mesh point.
 
-notes: Requires `AUTO_BED_LEVELING_UBL` and `UBL_G26_MESH_EDITING`.
+notes: |
+  - Before 1.1.6 requires `UBL_G26_MESH_VALIDATION` and `AUTO_BED_LEVELING_UBL`.
+  - Since 1.1.7 requires `G26_MESH_VALIDATION` and `HAS_MESH` (`AUTO_BED_LEVELING_UBL`, `MESH_BED_LEVELING`, or `AUTO_BED_LEVELING_BILINEAR`).
 
 parameters:
   -
diff --git a/views/gcode/G029-abl.md b/views/gcode/G029-abl.md
@@ -165,7 +165,7 @@ parameters:
     description: Dry-Run mode. Just probe the grid but don't update the bed leveling data
     values:
       -
-        tag: flag
+        type: bool
   -
     tag: V
     optional: true
@@ -188,7 +188,7 @@ parameters:
     description: Generate a Bed Topology Report (`AUTO_BED_LEVELING_LINEAR`)
     values:
       -
-        tag: flag
+        type: bool
   -
     tag: F
     optional: true
diff --git a/views/gcode/G029-ubl.md b/views/gcode/G029-ubl.md
@@ -81,15 +81,15 @@ parameters:
     optional: true
     description: |
                  - With a value (v), do _Square Grid_ probing of v x v points.
-                 - With no value, do _Three Point_ probing.
+                 - With no value, do _Three Point_ probing - e.g. to adjust a loaded mesh to match slight bed misalignment.
     values:
       -
         type: int
   -
     tag: K
     optional: true
     description: |
-                 **Kompare**: Subtract the stored mesh with the given index from the current mesh.
+                 **Kompare**: Subtract the stored mesh with the given index from the current mesh. This operates on the mesh in-memory, so it will probably invalidate the active mesh for purposes of printing.
     values:
       -
         unit: index
@@ -122,7 +122,7 @@ parameters:
       -
         tag: 3
         description: |
-                     **Fill Unpopulated** regions of the Mesh with a fixed value (`C` or ).
+                     **Fill Unpopulated** regions of the Mesh with a fixed value (`C`) or use 'smart fill' to extrapolate from already probed points (`no argument`).
       -
         tag: 4
         description: |
@@ -219,5 +219,39 @@ parameters:
         unit: linear
 
 examples:
+  -
+    pre: This is a minimal 'quick-start' sequence for set-up and initial probing of a UBL mesh on a machine that includes a display and z-probe
+    code:
+      - M502          ; Reset settings to configuration defaults...
+      - M500          ; ...and Save to EEPROM. Use this on a new install.
+      - M501          ; Read back in the saved EEPROM.  
+
+      - M190 S65      ; Not required, but having the printer at temperature helps accuracy
+      - M104 S210     ; Not required, but having the printer at temperature helps accuracy
+
+      - G28           ; Home XYZ.
+      - G29 P1        ; Do automated probing of the bed.
+      - G29 P2 B T    ; Manual probing of locations USUALLY NOT NEEDED!!!!
+      - G29 P3 T      ; Repeat until all mesh points are filled in.
+
+      - G29 T         ; View the Z compensation values.
+      - G29 S1        ; Save UBL mesh points to EEPROM.
+      - G29 F 10.0    ; Set Fade Height for correction at 10.0 mm.
+      - G29 A         ; Activate the UBL System.
+      - M500          ; Save current setup. WARNING - UBL will be active at power up, before any `G28`.
+  -
+    pre: Use `G26` and `G29` commands to fine-tune a measured mesh
+    code:
+      - G26 C P T3.0  ; Produce mesh validation pattern with primed nozzle.
+      -     ; NOTE - PLA temperatures are assumed unless you specify - e.g. - B 105 H 225 for ABS Plastic
+      - G29 P4 T      ; Move nozzle to 'bad' areas and fine tune the values if needed.
+      -     ; Repeat G26 and G29 P4 T  commands as needed.
+      - G29 S1        ; Save UBL mesh values to EEPROM.
+      - M500          ; Resave UBL's state information.
+  -
+    pre: Use 3-point probe to 'tilt' a stored mesh; e.g. in your startup script
+    code:
+      - G29 L1        ; Load the mesh stored in slot 1 (from G29 S1)
+      - G29 J         ; No size specified on the J option tells G29 to probe the specified 3 points and tilt the mesh according to what it finds.
 
 ---
diff --git a/views/gcode/G030.md b/views/gcode/G030.md
@@ -31,6 +31,15 @@ parameters:
       -
         tag: pos
         type: float
+  -
+    tag: E
+    optional: true
+    description: Engage the probe for each point.
+    values:
+      -
+        type: bool
+      -
+        default: 0
 
 notes:
 
diff --git a/views/gcode/G033.md b/views/gcode/G033.md
@@ -26,6 +26,9 @@ parameters:
     tag: P
     optional: true
     values:
+      -
+        tag: 0
+        description: Normalize end-stops and tower angle corrections only (no probing).
       -
         tag: 1
         description: Probe center and set height only.
@@ -36,15 +39,29 @@ parameters:
         tag: 3
         description: Probe all positions - center, towers and opposite towers. Set all.
       -
-        tag: 4-7
-        description: Probe all positions at different locations and average them.
+        tag: 4-10
+        description: Probe all positions + at different itermediate locations and average them.
+      -
+        default: set in Configuration.h
   -
     tag: T
     optional: true
-    description: Enable or disable tower angle corrections calibration (`P3`-`P7`)
+    description: Disable tower angle corrections calibration (`P3`-`P7`)
     values:
       -
         type: bool
+      -
+        default: 0
+  -
+    tag: C
+    optional: true
+    description: If omitted iterations stop at best achievable precision; if set force iterations to stop at the set precision.
+    values: mm
+  -
+    tag: F
+    optional: true
+    description: Force to run at least n iterations and take the best result.
+    values: 1-30
   -
     tag: V
     optional: true
@@ -59,6 +76,26 @@ parameters:
       -
         tag: 2
         description: Report settings and probe results
+      -
+        default: 1
+  -
+    tag: A
+    optional: true
+    description: Auto tune calibration factors.
+    values:
+      -
+        type: bool
+      -
+        default: 0
+  -
+    tag: E
+    optional: true
+    description: Engage the probe for each point.
+    values:
+      -
+        type: bool
+      -
+        default: 0
 
 notes:
 
diff --git a/views/gcode/M111.md b/views/gcode/M111.md
@@ -45,6 +45,9 @@ examples:
   -
     pre: Enable everything except dry-run mode
     code: M111 S247 ; 255 - 8
+  -
+    pre: Disable previously set extra debugging output.
+    code: M111 S0
 
 ---
 
diff --git a/views/gcode/M203.md b/views/gcode/M203.md
@@ -61,7 +61,7 @@ parameters:
 examples:
   -
     pre: 'Set max feedrate for XY to 100mm/s:'
-    code: M203 X6000 Y6000
+    code: M203 X100 Y1000
 
 ---
 
diff --git a/views/gcode/M220.md b/views/gcode/M220.md
@@ -10,7 +10,7 @@ group: planner
 codes:
   - M220
 
-long: Set the feedrate percentage, which applies to all G-code-based moves.
+long: Set the feedrate percentage, which applies to all G-code-based moves in all (X, Y, Z, and E) axes.
 
 notes:
 
diff --git a/views/gcode/M290.md b/views/gcode/M290.md
@@ -0,0 +1,68 @@
+---
+tag: m290
+title: Babystep
+brief: Babystep one or more axes
+author: thinkyhead
+
+experimental: false
+since: 1.1.7
+requires: BABYSTEPPING
+group: calibration
+
+codes:
+  - M290
+
+long:
+  - Apply babysteps to one or more axes using current units. Offsets applied with `M290` aren't added to the current coordinates, but are intended for making small adjustments, especially in the Z axis, at the start of a print.
+  - Note that when `BABYSTEP_ZPROBE_OFFSET` is enabled, `M290` also modifies the Probe Z Offset (with no immediate effects). The new Z offset applies to successive probing operations, and can be saved with `M500`. This behavior is means to coincide with the LCD Menu replacing "Z Babystepping" with "Babystep Z Probe Offset." To avoid this side-effect, use `M290 P0` or leave `BABYSTEP_ZPROBE_OFFSET` disabled.
+
+notes: Requires `BABYSTEP_XY` for babystepping on the XY axes.
+
+parameters:
+  -
+    tag: X
+    optional: true
+    description: A distance on the X axis
+    values:
+      -
+        tag: pos
+        type: float
+  -
+    tag: Y
+    optional: true
+    description: A distance on the Y axis
+    values:
+      -
+        tag: pos
+        type: float
+  -
+    tag: Z
+    optional: true
+    description: A distance on the Z axis
+    values:
+      -
+        tag: pos
+        type: float
+  -
+    tag: S
+    optional: true
+    description: Alias for Z
+    values:
+      -
+        tag: pos
+        type: float
+  -
+    tag: P
+    optional: true
+    description: Use `P0` to leave the Probe Z Offset unaffected. (Requires `BABYSTEP_ZPROBE_OFFSET`)
+    values:
+      -
+        type: bool
+
+example:
+  -
+    pre: Babystep the Z axis by 0.25mm (in mm units mode)
+    code:
+      - M290 Z0.25 ; move up 0.25mm on the Z axis
+
+---
diff --git a/views/gcode/M665.md b/views/gcode/M665.md
@@ -73,7 +73,7 @@ parameters:
   -
     tag: Z
     optional: true
-    description: Also add this angle to X and Y
+    description: Gamma (Tower 3) angle trim
     values:
       -
         type: float

Original file line number	Diff line number	Diff line change
`@@ -165,7 +165,7 @@ parameters:`
`165`	`165`	`description: Dry-Run mode. Just probe the grid but don't update the bed leveling data`
`166`	`166`	`values:`
`167`	`167`	`-`
`168`		`- tag: flag`
	`168`	`+ type: bool`
`169`	`169`	`-`
`170`	`170`	`tag: V`
`171`	`171`	`optional: true`
`@@ -188,7 +188,7 @@ parameters:`
`188`	`188`	description: Generate a Bed Topology Report (`AUTO_BED_LEVELING_LINEAR`)
`189`	`189`	`values:`
`190`	`190`	`-`
`191`		`- tag: flag`
	`191`	`+ type: bool`
`192`	`192`	`-`
`193`	`193`	`tag: F`
`194`	`194`	`optional: true`
Original file line number	Diff line number	Diff line change
`@@ -45,6 +45,9 @@ examples:`
`45`	`45`	`-`
`46`	`46`	`pre: Enable everything except dry-run mode`
`47`	`47`	`code: M111 S247 ; 255 - 8`
	`48`	`+ -`
	`49`	`+ pre: Disable previously set extra debugging output.`
	`50`	`+ code: M111 S0`
`48`	`51`
`49`	`52`	`---`
`50`	`53`
Original file line number	Diff line number	Diff line change
`@@ -61,7 +61,7 @@ parameters:`
`61`	`61`	`examples:`
`62`	`62`	`-`
`63`	`63`	`pre: 'Set max feedrate for XY to 100mm/s:'`
`64`		`- code: M203 X6000 Y6000`
	`64`	`+ code: M203 X100 Y1000`
`65`	`65`
`66`	`66`	`---`
`67`	`67`