From 82f540bb731fe4ae4575d48aefb2f837491ba4e6 Mon Sep 17 00:00:00 2001 From: Rowland <43092584+strayr@users.noreply.github.com> Date: Wed, 14 May 2025 18:53:10 +0100 Subject: [PATCH] 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 --- docs/Bed_Mesh.md | 7 ++++++- docs/G-Codes.md | 4 +++- 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=]`: 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