106 lines
4.4 KiB
Markdown
106 lines
4.4 KiB
Markdown
---
|
|
tag: g000
|
|
title: Linear Move
|
|
brief: Add a straight line movement to the planner
|
|
author: thinkyhead
|
|
|
|
since: 1.0.0-beta
|
|
group: motion
|
|
|
|
codes: [ G0, G1 ]
|
|
|
|
related: [ G2, G3, G5, M82, M83, G91 ]
|
|
|
|
notes: |
|
|
- Coordinates are given in millimeters by default. Units may be set to inches by [`G20`](/docs/gcode/G020.html).
|
|
- In Relative Mode ([`G91`](/docs/gcode/G091.html)) all coordinates are interpreted as relative, adding onto the previous position.
|
|
- In Extruder Relative Mode ([`M83`](/docs/gcode/M083.html)) the E coordinate is interpreted as relative, adding onto the previous E position.
|
|
- A single linear move may generate several smaller moves to the planner due to kinematics and bed leveling compensation. Printing performance can be tuned by adjusting segments-per-second.
|
|
|
|
devnotes: |
|
|
- Developers: Keep using `G0` for non-print moves. It makes G-code more adaptable to lasers, engravers, etc.
|
|
|
|
parameters:
|
|
-
|
|
tag: X
|
|
optional: true
|
|
description: An absolute or relative coordinate on the X axis (in current units).
|
|
values:
|
|
-
|
|
tag: pos
|
|
type: float
|
|
-
|
|
tag: Y
|
|
optional: true
|
|
description: An absolute or relative coordinate on the Y axis (in current units).
|
|
values:
|
|
-
|
|
tag: pos
|
|
type: float
|
|
-
|
|
tag: Z
|
|
optional: true
|
|
description: An absolute or relative coordinate on the Z axis (in current units).
|
|
values:
|
|
-
|
|
tag: pos
|
|
type: float
|
|
-
|
|
tag: E
|
|
optional: true
|
|
description: An absolute or relative coordinate on the E (extruder) axis (in current units). The E axis describes the position of the filament in terms of input to the extruder feeder.
|
|
values:
|
|
-
|
|
tag: pos
|
|
type: float
|
|
-
|
|
tag: F
|
|
optional: true
|
|
description: The maximum movement rate of the move between the start and end point. The feedrate set here applies to subsequent moves that omit this parameter.
|
|
values:
|
|
-
|
|
tag: rate
|
|
type: float
|
|
-
|
|
tag: S
|
|
since: 2.1.1
|
|
requires: LASER_FEATURE
|
|
optional: true
|
|
description: Set the laser power for the move.
|
|
values:
|
|
-
|
|
tag: power
|
|
type: float
|
|
|
|
examples:
|
|
-
|
|
pre: The most basic move sets a feedrate and moves the tool to the given position.
|
|
code:
|
|
- G0 X12 ; Move to 12mm on the X axis
|
|
- G0 F1500 ; Set the feedrate to 1500 mm/min
|
|
- G1 X90.6 Y13.8 ; Move to 90.6mm on the X axis and 13.8mm on the Y axis
|
|
-
|
|
pre: There are some caveats related with feedrates. Consider the following:
|
|
code:
|
|
- G1 F1500 ; Set the feedrate to 1500 mm/min
|
|
- G92 E0
|
|
- G1 X50 Y25.3 E22.4 ; Move while extruding
|
|
post: In the above example the feedrate is set to 1500 mm/min, then the tool is moved 50mm on the X axis and 25.3mm on the Y axis while extruding 22.4mm of filament between the two points.
|
|
-
|
|
code:
|
|
- G1 F1500
|
|
- G92 E0
|
|
- G1 X50 Y25.3 E22.4 F3000
|
|
post: However, in the above example, we set a feedrate of 1500 mm/min on line 1 then do the move described above, accelerating to a feedrate of 3000 mm/min (if possible). The extrusion will accelerate along with the X and Y movement, so everything stays synchronized.
|
|
|
|
---
|
|
The `G0` and `G1` commands add a linear move to the queue to be performed after all previous moves are completed. These commands yield control back to the command parser as soon as the move is queued, but they may delay the command parser while awaiting a slot in the queue.
|
|
|
|
A linear move traces a straight line from one point to another, ensuring that the specified axes will arrive simultaneously at the given coordinates (by linear interpolation). The speed may change over time following an acceleration curve, according to the acceleration and jerk settings of the given axes.
|
|
|
|
A command like `G1 F1000` sets the feedrate for all subsequent moves.
|
|
|
|
By convention, most G-code generators use `G0` for non-extrusion movements (those without the E axis) and `G1` for moves that include extrusion. This is meant to allow a kinematic system to, optionally, do a more rapid uninterpolated movement requiring much less calculation.
|
|
|
|
For Cartesians and Deltas the `G0` (rapid linear movement) command is (and must be) a direct alias for `G1` (rapid movement). On SCARA machines `G0` does a fast non-linear move. Marlin 2.0 introduces an option to maintain a separate default feedrate for `G0`. *Note: Slicers tend to override firmware feedrates!*
|