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>
This commit is contained in:
Rowland
2025-05-14 18:53:10 +01:00
committed by GitHub
parent ed36041b67
commit 82f540bb73
2 changed files with 9 additions and 2 deletions

View File

@@ -497,7 +497,8 @@ _Default Adaptive Margin: 0_
Initiates the probing procedure for Bed Mesh Calibration. 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 or `default` if unspecified. The `METHOD` parameter takes one of the following
values: 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 `BED_MESH_PROFILE LOAD=default` to either their `START_PRINT` macro or their
slicer's "Start G-Code" configuration, whichever is applicable. 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 Alternatively the old behavior of loading a profile at startup can be
restored with a `[delayed_gcode]`: restored with a `[delayed_gcode]`:

View File

@@ -174,8 +174,10 @@ The following commands are available when the
[ADAPTIVE_MARGIN=<value>]`: This command probes the bed using generated points [ADAPTIVE_MARGIN=<value>]`: This command probes the bed using generated points
specified by the parameters in the config. After probing, a mesh is generated specified by the parameters in the config. After probing, a mesh is generated
and z-movement is adjusted according to the mesh. 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, 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 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 METHOD=manual is specified then the manual probing tool is activated - see the
MANUAL_PROBE command above for details on the additional commands available MANUAL_PROBE command above for details on the additional commands available