56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
---
|
|
tag: m0114
|
|
title: Get Current Position
|
|
brief: Report the current tool position to the host.
|
|
author: thinkyhead
|
|
|
|
group: hosts
|
|
codes: [ M114 ]
|
|
related: M154
|
|
|
|
notes:
|
|
- Hosts should respond to the output of `M114` by updating their current position.
|
|
- G-code [`M154`](/docs/gcode/M154.html) can be used to to auto-report positions to the host, reducing serial traffic.
|
|
|
|
parameters:
|
|
-
|
|
tag: D
|
|
optional: true
|
|
description: Detailed information (requires `M114_DETAIL`)
|
|
values:
|
|
-
|
|
type: flag
|
|
-
|
|
tag: E
|
|
optional: true
|
|
description: Report E stepper position (requires `M114_DETAIL`)
|
|
values:
|
|
-
|
|
type: flag
|
|
-
|
|
tag: R
|
|
optional: true
|
|
description: Real position information (requires `M114_REALTIME`)
|
|
values:
|
|
-
|
|
type: flag
|
|
|
|
example:
|
|
-
|
|
pre: Get the _projected_ current position
|
|
code: |
|
|
> M114
|
|
X:0.00 Y:127.00 Z:145.00 E:0.00 Count X: 0 Y:10160 Z:116000
|
|
ok
|
|
|
|
---
|
|
Get the "current position" of the active tool. Stepper values are included.
|
|
|
|
If `M114_LEGACY` is enabled the planner will be synchronized before reporting so that the reported position is not be ahead of the actual planner position.
|
|
|
|
Normally `M114` reports the "projected position" which is the last position Marlin was instructed to move to.
|
|
|
|
With the `M114_REALTIME` option you can send `R` to get the "real" current position at the moment that the request was processed. This position comes directly from the steppers in the midst of motion, so when the printer is moving you can consider this the "recent position."
|
|
|
|
For debugging it can be useful to enable `M114_DETAIL` which adds `D` and `E` parameters to get extra details.
|