blob: 0fb644c928e0d8db3a42052a4c24b76d24ce65be (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
---
tag: g028
title: Auto Home
brief: Auto home one or more axes.
author: thinkyhead
group: calibration
codes: [ G28 ]
notes:
- Homing is required before [`G29`](/docs/gcode/G029.html), [`M48`](/docs/gcode/M048.html), and some other procedures.
- If homing is needed the LCD will blink the X Y Z indicators.
- "`G28` disables bed leveling. Follow with `M420 S` to turn leveling on, or use `RESTORE_LEVELING_AFTER_G28` to automatically keep leveling on after `G28`."
parameters:
-
tag: L
type: flag
optional: true
description: Flag to restore bed leveling state after homing. (default `true`)
-
tag: O
since: 1.1.9
type: flag
optional: true
description: Flag to skip homing if the position is already trusted
-
tag: R
since: 1.1.9
type: float
optional: true
description: The distance to raise the nozzle before homing
-
tag: X
type: bool
optional: true
description: Flag to home the X axis
-
tag: Y
type: bool
optional: true
description: Flag to home the Y axis
-
tag: Z
type: bool
optional: true
description: Flag to home the Z axis
examples:
-
pre:
- 'The most-used form of this command is to home all axes:'
code:
- G28 ; Home all axes
-
code:
- G28 X Z ; Home the X and Z axes
-
code:
- G28 O ; Home all "untrusted" axes
---
When you first start up your machine it has no idea where the toolhead is positioned, so Marlin needs to use a procedure called "homing" to establish a known position. To do this it moves each axis towards one end of its track until it triggers a switch, commonly called an "endstop." Marlin knows where the endstops are, so once all the endstops have been triggered the position is known.
The `G28` command is used to home one or more axes. The default behavior with no parameters is to home all axes.
In order to improve positional accuracy, the homing procedure can re-bump at a slower speed according to the `[XYZ]_HOME_BUMP_MM` and `HOMING_BUMP_DIVISOR` settings.
The position is easy to lose when the steppers are turned off, so homing may be required or advised after the machine has been sitting idle for a period of time. See the Configuration files for all homing options.
|
