You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: views/configuration.md
+21-7Lines changed: 21 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -921,15 +921,21 @@ Set to `true` to enable the option to constrain movement to the physical boundar
921
921
922
922
### Movement Bounds
923
923
924
+
```cpp
925
+
#define X_BED_SIZE 200
926
+
#define Y_BED_SIZE 200
927
+
```
928
+
With Marlin 1.1.5 and up you can directly specify the bed size. This allows Marlin to do extra logic related to the bed size when it differs from the movement limits below. If the XY carriage is able to move outside of the bed, you can specify a wider range below.
929
+
924
930
```cpp
925
931
#define X_MIN_POS 0
926
932
#define Y_MIN_POS 0
927
933
#define Z_MIN_POS 0
928
-
#define X_MAX_POS 200
929
-
#define Y_MAX_POS 200
934
+
#define X_MAX_POS X_BED_SIZE
935
+
#define Y_MAX_POS Y_BED_SIZE
930
936
#define Z_MAX_POS 170
931
937
```
932
-
These values specify the physical limits of the machine. Usually the `[XYZ]_MIN_POS` values are set to 0, because endstops are positioned at the bed limits. `[XYZ]_MAX_POS` should be set to the farthest reachable point. By default, these positions are used for homing as well. However, the `MANUAL_[XYZ]_HOME_POS` options can be used to override these, if needed.
938
+
These values specify the physical limits of the machine. Usually the `[XYZ]_MIN_POS` values are set to 0, because endstops are positioned at the bed limits. `[XYZ]_MAX_POS` should be set to the farthest reachable point. By default, these are used as your homing positions as well. However, the `MANUAL_[XYZ]_HOME_POS` options can be used to override these, if needed.
933
939
934
940
{% panel info Home Offset %}
935
941
Although home positions are fixed, `M206` can be used to apply offsets to the home position if needed.
@@ -1177,21 +1183,29 @@ The EEPROM-related commands are:
1177
1183
-`M502`: Reset all settings to their default values (as set by `Configuration.h`)
1178
1184
-`M503`: Print the current settings (in RAM, not EEPROM)
1179
1185
1186
+
#### EEPROM Options
1187
+
```cpp
1188
+
//#define DISABLE_M503 // Saves ~2700 bytes of PROGMEM. Disable for release!
1189
+
#defineEEPROM_CHITCHAT // Give feedback on EEPROM commands. Disable to save PROGMEM.
1190
+
```
1191
+
These EEPROM options should be left as they are, but for 128K and smaller boards they may be used to recover some program memory. Vendors are strongly discouraged from using `DISABLE_M503`.
1192
+
1180
1193
{% alert info %}
1181
1194
Settings that can be changed and saved to EEPROM are marked with <em class="fa fa-sticky-note-o" aria-hidden="true"></em>. Options marked with <em class="fa fa-desktop" aria-hidden="true"></em> can be changed from the LCD controller.
1182
1195
{% endalert %}
1183
1196
1184
1197
{% alert info %}
1185
-
Certain EEPROM behaviors may be confusing. For example, when you edit the configurations and re-flash the firmware, you may discover that your new settings don't have any effect! What's going on? They are still overridden by the settings last saved to EEPROM! Use `M502` to restore settings to defaults, then `M500` to save them. Note that `M503` shows current settings in volatile memory even without `EEPROM_SETTINGS`.
1198
+
When you change saveable settings in the configuration files and re-flash, the new values don't take effect right away. They are still overridden by the saved values in EEPROM. To get your new default settings into the EEPROM, use `M502` followed by `M500`.
1186
1199
{% endalert %}
1187
1200
1188
1201
### Host Keepalive
1189
1202
1190
1203
```cpp
1191
-
#defineHOST_KEEPALIVE_FEATURE
1192
-
#defineDEFAULT_KEEPALIVE_INTERVAL 2
1204
+
#define HOST_KEEPALIVE_FEATURE // Disable this if your host doesn't like keepalive messages
1205
+
#define DEFAULT_KEEPALIVE_INTERVAL 2 // Number of seconds between "busy" messages. Set with M113.
1206
+
#define BUSY_WHILE_HEATING // Some hosts require "busy" messages even during heating
1193
1207
```
1194
-
When Host Keepalive is enabled Marlin will send a busy status message to the host every couple of seconds when it can't accept commands. Disable if your host doesn't like keepalive messages. Use `DEFAULT_KEEPALIVE_INTERVAL` for the default number of seconds between "busy" messages. Override with [`M113`](/docs/gcode/M113.html).
1208
+
When Host Keepalive is enabled Marlin will send a busy status message to the host every couple of seconds when it can't accept commands. Disable if your host doesn't like keepalive messages. Use `DEFAULT_KEEPALIVE_INTERVAL` for the default number of seconds between "busy" messages. Override with [`M113`](/docs/gcode/M113.html). Marlin 1.1.5and up include the `BUSY_WHILE_HEATING` option for hosts that treat host keepalive as a strict busy protocol.
Copy file name to clipboardExpand all lines: views/gcode/G010.md
+16-2Lines changed: 16 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,9 +12,23 @@ group: planner
12
12
codes:
13
13
- G10
14
14
15
-
long: Retract the filament according to settings of [`M207`](/docs/gcode/M207.html).
15
+
long:
16
+
- Retract the filament according to settings of [`M207`](/docs/gcode/M207.html).
17
+
- Firmware retraction allows you to tune retraction at the machine level and can significantly reduce the size of G-code files.
16
18
17
-
notes: Requires `FWRETRACT`.
19
+
notes:
20
+
- Requires `FWRETRACT`.
21
+
- See related codes [`G11`](/docs/gcode/G011.html), [`M207`](/docs/gcode/M207.html), [`M208`](/docs/gcode/M208.html), and [`M209`](/docs/gcode/M209.html).
22
+
23
+
parameters:
24
+
-
25
+
tag: S
26
+
optional: true
27
+
description: Use `G10 S1` to do a swap retraction, before changing extruders. The subsequent `G11` (after tool change) will do a swap recover. (Requires `EXTRUDERS` > 1)
Copy file name to clipboardExpand all lines: views/gcode/G011.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,9 @@ codes:
14
14
15
15
long: Unretract (i.e., recover, prime) the filament according to settings of [`M208`](/docs/gcode/M208.html).
16
16
17
-
notes: Requires `FWRETRACT`.
17
+
notes:
18
+
- Requires `FWRETRACT`.
19
+
- See related codes [`G10`](/docs/gcode/G010.html), [`M207`](/docs/gcode/M207.html), [`M208`](/docs/gcode/M208.html), and [`M209`](/docs/gcode/M209.html).
Copy file name to clipboardExpand all lines: views/gcode/M207.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,9 @@ codes:
13
13
14
14
long: Set lengths, feedrate, and Z lift for firmware-based retraction. See parameters below.
15
15
16
-
notes: Requires `FWRETRACT`.
16
+
notes:
17
+
- Requires `FWRETRACT`.
18
+
- See related codes [`G10`](/docs/gcode/G010.html), [`G11`](/docs/gcode/G010.html), [`M208`](/docs/gcode/M208.html), and [`M209`](/docs/gcode/M209.html).
Copy file name to clipboardExpand all lines: views/gcode/M208.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,9 @@ codes:
13
13
14
14
long: Set lengths and feedrate for firmware-based retract recovery. The new values will apply to all subsequent G11
15
15
16
-
notes: Requires `FWRETRACT`.
16
+
notes:
17
+
- Requires `FWRETRACT`.
18
+
- See related codes [`G10`](/docs/gcode/G010.html), [`G11`](/docs/gcode/G010.html), [`M207`](/docs/gcode/M207.html), and [`M209`](/docs/gcode/M209.html).
Copy file name to clipboardExpand all lines: views/gcode/M209.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,8 +16,10 @@ long:
16
16
- When auto-retract is enabled, all reversed E-only moves are treated as retraction. (Recover moves are also automatically overridden.) When disabled, E retraction derives from G-code.
17
17
18
18
notes:
19
+
- Requires `FWRETRACT`.
19
20
- Most slicers today can generate `G10`/`G11`. But this option is useful for older G-code.
20
21
- Though not currently very popular, both volumetric extrusion and firmware-based retraction (and/or `M209`) make G-code more immune to changes from one machine to another, and permit changing the hardware without needing to re-slice.
22
+
- See related codes [`G10`](/docs/gcode/G010.html), [`G11`](/docs/gcode/G010.html), [`M207`](/docs/gcode/M207.html), and [`M208`](/docs/gcode/M208.html).
0 commit comments