You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Specify the Height to raise the nozzle after each manual probe of the bed.
117
+
If omitted, the nozzle will raise by `Z_CLEARANCE_BETWEEN_PROBES`.
118
+
- `G29 P4 H` : Offset above the mesh height to place the nozzle.
119
+
If omitted, `Z_CLEARANCE_BETWEEN_PROBES` will be used.
68
120
values:
69
121
-
70
122
unit: linear
71
123
type: float
72
124
-
73
125
tag: I
74
126
optional: true
75
-
description: Invalidate this number of mesh points. (No value = 1)
127
+
description: |
128
+
**Invalidate**
129
+
a number of mesh points (default 1).
130
+
- Invalidate Mesh Points near the given `X Y` (Default: nozzle position)
131
+
- If no `I` value is given, only the point nearest to the given position is invalidated.
132
+
Use `T` to produce a map afterward. This command is useful to invalidate a portion of
133
+
the Mesh so it can be adjusted using other UBL tools. When attempting to invalidate an
134
+
isolated bad mesh point, the `T` option shows the nozzle position in the Mesh with (#).
135
+
- You can move the nozzle around and use this feature to select the center of the area
136
+
(or cell) to invalidate.
76
137
values:
77
138
-
78
139
type: int
79
140
-
80
141
tag: J
81
142
optional: true
82
143
description: |
83
-
- With a value (v), do _Square Grid_ probing of v x v points.
84
-
- With no value, do _Three Point_ probing - e.g. to adjust a loaded mesh to match slight bed misalignment.
144
+
**Grid** (or 3-Point) leveling:
145
+
- These options calculate a plane and adjust the existing mesh to the bed tilt.
146
+
- If a value is provided, probe a grid with the given number of points, squared.
147
+
- With no value, probe 3 points to find the plane of the bed.
85
148
values:
86
149
-
87
150
type: int
88
151
-
89
152
tag: K
90
153
optional: true
91
154
description: |
92
-
**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.
155
+
**Kompare**: Subtract (diff) the stored mesh with the given index from the current mesh. This
156
+
operates on the mesh in-memory, so it will probably make the active mesh unsuitable
157
+
for printing.
93
158
values:
94
159
-
95
160
unit: index
96
161
type: int
97
162
-
98
163
tag: L
99
164
optional: true
100
-
description: Load a mesh. If no index is given, load the previously-activated mesh.
165
+
description: |
166
+
**Load** a mesh. If no index is given, load the previously-activated mesh.
167
+
The given mesh index will be used for subsequent Load and Store operations.
101
168
values:
102
169
-
103
170
unit: index
104
171
type: int
105
172
-
106
173
tag: P
107
174
optional: true
108
-
description: Phase
175
+
description: |
176
+
**Phase**:
177
+
The `P`hase commands are used for the bulk of the work to setup a Mesh. In general, you'll start
178
+
by initializing with a `G29 P0` or a `G29 P1` then do further refinement with additional Phases.
179
+
180
+
109
181
values:
110
182
-
111
183
tag: 0
112
184
description: |
113
-
**Zero Mesh Data** and turn off the Mesh Compensation System.
185
+
**Zero Mesh Data** and turn off the Mesh Compensation System. This reverts the
186
+
machine to the same state it was in before UBL Compensation was enabled. Setting
187
+
the entire Mesh to Zero is a special case to allow a subsequent `G` or `T`
188
+
leveling operation for backward-compatibility.
114
189
-
115
190
tag: 1
116
191
description: |
117
-
Invalidate Mesh and do **Automatic Z Probing**.
192
+
**Automatic Probing** invalidates the mesh and continues automatic probing using the probe.
193
+
- In most cases the probe can't reach all areas that the nozzle can due to the offsets
194
+
specified by `X_PROBE_OFFSET_FROM_EXTRUDER` and `Y_PROBE_OFFSET_FROM_EXTRUDER`.
195
+
Deltabots can only probe within the area where `DELTA_PROBEABLE_RADIUS` and
196
+
`DELTA_PRINTABLE_RADIUS` overlap.
197
+
- Unreachable points can be filled in later with the `P2` and `P3` phases.
198
+
- Use `C` to leave the previous mesh intact and automatically probe needed points. This allows you
199
+
to invalidate parts of the mesh but still use Automatic Probing.
200
+
- The `X` and `Y` parameters prioritize where to try and measure points. If omitted, the current
201
+
probe position is used.
202
+
- Use `T` (Topology) in this phase to report the probing results.
203
+
- `P1` will suspend mesh generation if the controller button is held down. Note that you may need
204
+
to press and hold the switch for several seconds if moves are underway.
118
205
-
119
206
tag: 2
120
207
description: |
121
-
**Probe Areas** of the Mesh that can't be automatically handled.
208
+
**Probe Areas** of the mesh that can't be automatically handled.
209
+
- Use `H` to set the height between mesh points. If omitted, Z_CLEARANCE_BETWEEN_PROBES is used.
210
+
Smaller values will be quicker. Move the nozzle down till it barely touches the bed. Make sure the
211
+
nozzle is clean and unobstructed. Use caution and move slowly. This can damage your printer!
212
+
(Uses SIZE_OF_LITTLE_RAISE mm if the nozzle is moving less than BIG_RAISE_NOT_NEEDED mm.)
213
+
- The `H` value can be negative if the mesh dips in a large area. Press and hold the
214
+
controller button to terminate the current Phase 2 command. You can then re-issue `G29 P 2`
215
+
with an `H` parameter more suitable for the area you're manually probing. Note that the command
216
+
tries to start in a corner of the bed where movement will be predictable. Override the distance
217
+
calculation location with the `X` and `Y` parameters. You can print a mesh Map (`G29 T`) to see
218
+
where the mesh is invalidated and where the nozzle needs to move to complete the command. Use `C`
219
+
to indicate that the search should be based on the current position.
220
+
- The `B` parameter for this command is described above. It places the manual probe subsystem into
221
+
Business Card mode where the thickness of a business card is measured and then used to accurately
222
+
set the nozzle height in all manual probing for the duration of the command. A Business card can
223
+
be used, but you'll get better results with a flexible Shim that doesn't compress. This makes it
224
+
easier to produce similar amounts of force and get more accurate measurements. Google if you're
225
+
not sure how to use a shim.
226
+
- The `T` (Map) parameter helps track mesh building progress.
227
+
- NOTE: `P2` requires an LCD controller!
122
228
-
123
229
tag: 3
124
230
description: |
125
-
**Fill Unpopulated** regions of the Mesh with a fixed value (`C`) or use 'smart fill' to extrapolate from already probed points (`no argument`).
231
+
**Fill Unpopulated** regions of the mesh with a fixed value (`C`) or use 'smart fill' to extrapolate
232
+
from already probed points (`no argument`).
233
+
- With a `C` constant, the closest invalid mesh points to the nozzle will be filled, and then a repeat
234
+
count can also be specified with `R`.
235
+
- Without `C` it does a **Smart Fill**, which scans the mesh from the edges inward looking for
236
+
invalid mesh points. Adjacent points are used to determine the bed slope. If the bed is sloped
237
+
upward from the invalid point, it takes the value of the nearest point. If sloped downward, it's
238
+
replaced by a value that puts all three points in a line. This version of `G29 P3` is a quick, easy
239
+
and (usually) safe way to populate unprobed mesh regions before continuing to `G26` Mesh Validation
240
+
Pattern. Note that this populates the mesh with unverified values. Pay attention and use caution.
126
241
-
127
242
tag: 4
128
243
description: |
129
-
**Fine Tune** the Mesh. Generally used in the form `G29 P4 Rnn Xxxx Yyyy`.
244
+
**Fine Tune** the Mesh. Generally used in the form `G29 P4 Rnn Xxxx Yyyy`.
245
+
- This phase requires an LCD Panel. To fine-tune the mesh without a controller, use `G42` and `M421`.
246
+
- Phase 4 is meant to be used with `G26` Mesh Validation to fine tune the mesh by direct editing
247
+
of Mesh Points. Raise and lower points to fine tune the mesh until it gives consistently reliable
248
+
adhesion.
249
+
- `P4` moves to the closest Mesh Point (and/or the given `X` `Y`), raises the nozzle above the mesh height
250
+
by the given `H` offset (or default Z_CLEARANCE_BETWEEN_PROBES), and waits while the controller is
251
+
used to adjust the nozzle height. On click the displayed height is saved in the mesh.
252
+
- Start Phase 4 at a specific location with `X` and `Y`. Adjust a specific number of Mesh Points with
253
+
the `R` (Repeat) parameter. (If `R` is left out, the whole matrix is assumed.) This command can be
254
+
terminated early (e.g., after editing the area of interest) by pressing and holding the encoder button.
255
+
- The general form is `G29 P4 [R points] [X position] [Y position]`.
256
+
- The `H[offset]`` parameter is useful if a shim is used to fine-tune the mesh. For a 0.4mm shim the
257
+
command would be `G29 P4 H0.4`. The nozzle is moved to the shim height, you adjust height to the shim,
258
+
and on click the height minus the shim thickness is saved in the mesh.
259
+
- _USE WITH CAUTION, as a bad mesh can cause the nozzle to crash into the bed!_
130
260
-
131
261
tag: 5
132
262
description: |
133
-
**Find Mean** Mesh Height and Standard Deviation.
263
+
**Find Mean** Mesh Height and Standard Deviation.
264
+
- Typically, it is easier to use and work with the Mesh if it is Mean-Adjusted. You can specify a `C`
265
+
parameter to Correct the Mesh to a 0.00 Mean Height. With a `C` parameter this will automatically
266
+
execute a `G29 P6 C[mean height]`.
134
267
-
135
268
tag: 6
136
269
description: |
137
-
**Shift Mesh** height by the `C` value.
270
+
**Shift Mesh** height by the `C` value.
271
+
- The entire Mesh's height is adjusted by the height specified by the `C` parameter. It's useful to be
272
+
able to adjust the height of a mesh. It can be used to compensate for a poorly-calibrated probe or other
273
+
errors. Ideally, you should have the Mesh adjusted for a Mean Height of 0.00 and the Z-Probe measuring
274
+
0.0 at the Z homing position.
138
275
-
139
276
tag: Q
140
277
optional: true
141
-
description: Test Pattern
278
+
description: |
279
+
Test Pattern.
280
+
Load the specified Test Pattern to check for correct operation. This command is intended for developers and is
281
+
not required for everyday bed leveling.
142
282
values:
143
283
-
144
284
unit: index
@@ -147,16 +287,21 @@ parameters:
147
287
tag: R
148
288
optional: true
149
289
description: |
150
-
Repeat count. (Default `GRID_MAX_POINTS_X * GRID_MAX_POINTS_Y`). For example, in Phase 3, `G29 P3 R4 C0`- this will tell the firmware to fill the 4 closest points to the nozzle with a value of `0`. Or, in Phase 4, `G29 P4 R3 X80 Y80` - this will tell the firmware to allow you to tweak 3 points around [80,80].
151
-
152
-
_Note that the 'R' parameter does not work in Phase 1; the number of points probed automatically is always `GRID_MAX_POINTS_X * GRID_MAX_POINTS_Y`._
0 commit comments