MarlinFirmware

G29 - Unified Bed Leveling

calibration Probe the bed and enable leveling compensation. AUTO_BED_LEVELING_UBL

The Unified Bed Leveling System (UBL) provides a comprehensive set of resources to produce the best bed leveling results possible.


See the full Unified Bed Leveling documentation for more details. (Examples below.)


Usage

G29 [A<bool>] [B<bool>] [C<bool/float>] [D<bool>] [E<bool>] [F<linear>] [H<linear>] [I<int>] [J<int>] [K<index>] [L<index>] [P<0|1|2|3|4|5|6>] [Q<index>] [R<int>] [S<slot>] [T<0|1>] [U<bool>] [V<0|1|2|3|4>] [W<bool>] [X<linear>] [Y<linear>]

Argument Description
[A<bool>]

Activate Unified Bed Leveling (i.e., M420 S1)

[B<bool>]

Business Card mode (P2 only)

[C<bool/float>]

Continue (P1), Current (P2), Constant (P3,Q2)

[D<bool>]

Disable Unified Bed Leveling (i.e., M420 S0).

[E<bool>]

Stow probe after probing Each point (P1 only).

[F<linear>]

Fade height. (UBL only! For others use M420 Z)

[H<linear>]

Height for Manual Probe raise (P2 only).

[I<int>]

Invalidate this number of mesh points. (No value = 1)

[J<int>]
  • With a value (v), do Square Grid probing of v x v points.
  • With no value, do Three Point probing.
[K<index>]

Kompare: Subtract the stored mesh with the given index from the current mesh.

[L<index>]

Load a mesh. If no index is given, load the previously-activated mesh.

[P<0|1|2|3|4|5|6>]

Phase

  • P0:

    Zero Mesh Data and turn off the Mesh Compensation System.

  • P1:

    Invalidate Mesh and do Automatic Z Probing.

  • P2:

    Probe Areas of the Mesh that can’t be automatically handled.

  • P3:

    Fill Unpopulated regions of the Mesh with a fixed value (C or ).

  • P4:

    Fine Tune the Mesh. Generally used in the form G29 P4 Rnn Xxxx Yyyy.

  • P5:

    Find Mean Mesh Height and Standard Deviation.

  • P6:

    Shift Mesh height by the C value.

[Q<index>]

Test Pattern

[R<int>]

Repeat count. (Default GRID_MAX_POINTS_X * GRID_MAX_POINTS_Y)

[S<slot>]

Store mesh to EEPROM in the given slot. If no slot given, use last-activated. Use S-1 for GCode output.

[T<0|1>]

Topology: Include a Topology Map in the output. Can be used alone or with several other commands. A map type can also be specified:

  • T0:

    Human-readable

  • T1:

    Spreadsheet-readable

[U<bool>]

Unlevel: Probe the outer perimeter to assist physical leveling. (Use with G29 P1 O)

[V<0|1|2|3|4>]

Verbosity Level (0-4)

[W<bool>]

What?: Displays current Unified Bed Leveling info

[X<linear>]

X position (otherwise, current X position)

[Y<linear>]

Y position (otherwise, current Y position)

Notes

Requires AUTO_BED_LEVELING_UBL.