MarlinFirmware

G12 - Clean the Nozzle

1.1.0 nozzle Perform the nozzle cleaning procedure. NOZZLE_CLEAN_FEATURE

Description

Start the nozzle cleaning process. Three types of cleaning patterns are supported: straight strokes, zigzags and circles. This feature requires a dedicated cleaning area on or outside the bed, but within reach of the nozzle. The pattern may be repeated as many times as desired.

Notes

Default behavior is defined by NOZZLE_CLEAN_FEATURE settings in Configuration.h.

With NOZZLE_CLEAN_GOBACK enabled, the nozzle automatically returns to the XYZ position before G12.

Usage

G12 [P<0|1|2>] [R<radius>] [S<count>] [T<count>] [X] [Y] [Z]

Parameters

[P<0|1|2>]

Pattern style selection

  • P0:

    Linear move back and forth

  • P1:

    Move in a zigzag pattern

  • P2:

    Move in a circular pattern
[R<radius>]

Radius of nozzle cleaning circle
    [S<count>]

    Number of repetitions of the pattern
      [T<count>]

      Number of triangles in the zigzag pattern
        [X]

        Include X motion when cleaning with limited axes. (Leave out X, Y, and Z for non-limited cleaning.)
          [Y]

          Include Y motion when cleaning with limited axes. (Leave out X, Y, and Z for non-limited cleaning.)
            [Z]

            Include Z motion when cleaning with limited axes. (Leave out X, Y, and Z for non-limited cleaning.)

              Examples

              The most basic example is to use the command without any arguments, this will default to a stroke based pattern which will be stroked NOZZLE_CLEAN_STROKES times.

              G12 ; stroke pattern (default)

              To generate a three triangle zig-zag pattern which will be stroked one time use the following command.

              G12 P1 S1 T3 ; zig-zag pattern with 3 triangles

              To generate a 10mm radius circle which will be stroked one time use the following command.

              G12 P2 S1 R10 ; 10mm circle