126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
---
|
|
tag: g029g1
|
|
title: Bed Leveling (3-Point)
|
|
brief: Probe the bed and enable leveling compensation.
|
|
author: thinkyhead
|
|
|
|
requires: AUTO_BED_LEVELING_3POINT
|
|
group: calibration
|
|
|
|
related: [ M420 ]
|
|
codes: [ G29 ]
|
|
|
|
notes:
|
|
- Any arguments left out of `G29` will use your configured defaults.
|
|
- By default [`G28`](/docs/gcode/G028.html) disables bed leveling. Follow with `M420 S` to turn leveling on, or use `RESTORE_LEVELING_AFTER_G28` to automatically keep leveling on after [`G28`](/docs/gcode/G028.html).
|
|
- To save time and machine wear, save your matrix to EEPROM with [`M500`](/docs/gcode/M500.html) and in your slicer's "Starting G-code" replace `G29` with `M420 S1` to enable your last-saved matrix.
|
|
|
|
parameters:
|
|
-
|
|
tag: A
|
|
optional: true
|
|
description: Abort leveling procedure in-progress (`PROBE_MANUALLY`)
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: C
|
|
optional: true
|
|
description: Create fake points for testing. (`DEBUG_LEVELING_FEATURE`)
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: O
|
|
type: bool
|
|
optional: true
|
|
description: Optional. If leveling is already enabled then exit without leveling. (1.1.9)
|
|
-
|
|
tag: Q
|
|
optional: true
|
|
description: Query the current leveling state (`PROBE_MANUALLY`, `DEBUG_LEVELING_FEATURE`)
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: E
|
|
optional: true
|
|
description: |
|
|
- By default G29 will engage the Z probe, test the bed, then disengage.
|
|
- Include "E" to engage/disengage the Z probe for each sample.
|
|
- There's no extra effect if you have a fixed Z probe. (without `PROBE_MANUALLY`)
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: D
|
|
optional: true
|
|
description: Dry-Run mode. Just probe the grid but don't update the bed leveling data
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: J
|
|
optional: true
|
|
description: Jettison the leveling data stored in SRAM and turn off leveling compensation. Data in EEPROM is not affected.
|
|
values:
|
|
-
|
|
type: bool
|
|
-
|
|
tag: V
|
|
optional: true
|
|
description: Set the verbose level
|
|
values:
|
|
-
|
|
type: int
|
|
tag: 0-4
|
|
|
|
examples:
|
|
-
|
|
code: G29 ; Probe 3 points and compensate
|
|
---
|
|
|
|
Automatic (3-Point) Bed Leveling probes the bed at 3 points and enables bed leveling compensation using a rotation matrix to compensate for bed tilt.
|
|
|
|
The printer must be homed with [`G28`](/docs/gcode/G028.html) before `G29`.
|
|
|
|
#### Automatic Probing
|
|
Using an electronic probe Marlin can probe all three points with a single `G29` command. See parameter descriptions and examples below for details.
|
|
|
|
#### Manual Probing
|
|
Auto Bed Leveling now includes a `PROBE_MANUALLY` option for systems lacking a probe.
|
|
|
|
**`PROBE_MANUALLY` adds these parameters to `G29`:**
|
|
|
|
- `Q` : Query leveling and `G29` state
|
|
- `A` : Abort current leveling procedure
|
|
|
|
To do manual probing simply repeat `G29` until the procedure is complete.
|
|
|
|
The first `G29` accepts the same parameters , shown in the [Usage](#usage-g029g1) section below. The exact parameters available will depend on which style of bed leveling is enabled. (**Note:** UBL parameters are not covered on this page unless they coincide. See the [`G29` for UBL](/docs/gcode/G029-ubl.html) page for a full list of its options.*)
|
|
|
|
{% details Probing Procedure %}
|
|
|
|
**Before probing the bed:**
|
|
1. Use `G29 Q` to get the current status. If `G29` isn't idle, abort with `G29 A`.
|
|
2. Use `M420 V` to view leveling data. You can send `M420 S1` to use the existing data.
|
|
|
|
**To probe the bed using G-code:**
|
|
1. Use `G29` to move to the first point for Z adjustment.
|
|
2. Adjust Z so a piece of paper can just pass under the nozzle.
|
|
3. Use `G29` to save the Z value and move to the next point.
|
|
4. Repeat steps 3-4 until completed.
|
|
5. Use [`M500`](/docs/gcode/M500.html) to save the leveling data to EEPROM, if desired.
|
|
|
|
**To probe the bed using your LCD controller:** (Requires `LCD_BED_LEVELING`)
|
|
|
|
1. Select the `Level Bed` sub-menu, then choose `Level Bed` (not `Cancel`).
|
|
2. Wait for `Homing XYZ` to complete.
|
|
3. When `Click to Begin` appears, press the controller button to move to the first point.
|
|
4. Use the controller wheel to adjust Z so that a piece of paper can just pass under the nozzle.
|
|
5. Press the controller button to save the Z value and move to the next point.
|
|
6. Repeat steps 4-5 until completed.
|
|
7. Use `Control` > `Store memory` to save the mesh to EEPROM, if desired.
|
|
|
|
{% enddetails %}
|