aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorRowland <43092584+strayr@users.noreply.github.com>2025-05-14 18:53:10 +0100
committerGitHub <noreply@github.com>2025-05-14 13:53:10 -0400
commit82f540bb731fe4ae4575d48aefb2f837491ba4e6 (patch)
tree680b0d2fdd02421efaf89685836e68cc7ef5ef49 /docs
parented36041b67e8bbbacae0710af8c4a5e4ffc030fa (diff)
downloadkutter-82f540bb731fe4ae4575d48aefb2f837491ba4e6.tar.gz
kutter-82f540bb731fe4ae4575d48aefb2f837491ba4e6.tar.xz
kutter-82f540bb731fe4ae4575d48aefb2f837491ba4e6.zip
docs: BED_MESH_CALIBRATE makes a mesh that is immediately available. (#6919)
The docs aren't particularly clear that if you generate a mesh in our start g-code, you can just use it without additional commands. This is causing issues with support on r/klippers Signed-off-by: Rowland Straylight <rowlandstraylight@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/Bed_Mesh.md7
-rw-r--r--docs/G-Codes.md4
2 files changed, 9 insertions, 2 deletions
diff --git a/docs/Bed_Mesh.md b/docs/Bed_Mesh.md
index c8d744fe..9956de9c 100644
--- a/docs/Bed_Mesh.md
+++ b/docs/Bed_Mesh.md
@@ -497,7 +497,8 @@ _Default Adaptive Margin: 0_
Initiates the probing procedure for Bed Mesh Calibration.
-The mesh will be saved into a profile specified by the `PROFILE` parameter,
+The mesh will be immediately ready to use when the command completes and saved
+into a profile specified by the `PROFILE` parameter,
or `default` if unspecified. The `METHOD` parameter takes one of the following
values:
@@ -561,6 +562,10 @@ load the `default` profile it is recommended to add
`BED_MESH_PROFILE LOAD=default` to either their `START_PRINT` macro or their
slicer's "Start G-Code" configuration, whichever is applicable.
+Note that this is not required if a new mesh is generated with
+`BED_MESH_CALIBRATE` in the `START_PRINT` macro or the slicer's "Start G-Code"
+and may produce unexpected results, especially with adaptive meshing.
+
Alternatively the old behavior of loading a profile at startup can be
restored with a `[delayed_gcode]`:
diff --git a/docs/G-Codes.md b/docs/G-Codes.md
index 6c40ec5e..caf41f0d 100644
--- a/docs/G-Codes.md
+++ b/docs/G-Codes.md
@@ -174,8 +174,10 @@ The following commands are available when the
[ADAPTIVE_MARGIN=<value>]`: This command probes the bed using generated points
specified by the parameters in the config. After probing, a mesh is generated
and z-movement is adjusted according to the mesh.
+The mesh is immediately active after successful completion of `BED_MESH_CALIBRATE`.
The mesh will be saved into a profile specified by the `PROFILE` parameter,
-or `default` if unspecified.
+or `default` if unspecified. If ADAPTIVE=1 is specified then the profile
+name will begin with `adaptive-` and should not be saved for reuse.
See the PROBE command for details on the optional probe parameters. If
METHOD=manual is specified then the manual probing tool is activated - see the
MANUAL_PROBE command above for details on the additional commands available