Prusa MINI Firmware overview
Configuration_adv.h
Go to the documentation of this file.
1 /**
2  * Marlin 3D Printer Firmware
3  * Copyright (c) 2019 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
4  *
5  * Based on Sprinter and grbl.
6  * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program. If not, see <http://www.gnu.org/licenses/>.
20  *
21  */
22 #pragma once
23 
24 /**
25  * Configuration_adv.h
26  *
27  * Advanced settings.
28  * Only change these if you know exactly what you're doing.
29  * Some of these settings can damage your printer if improperly set!
30  *
31  * Basic settings can be found in Configuration.h
32  *
33  */
34 #define CONFIGURATION_ADV_H_VERSION 020000
35 
36 // @section temperature
37 
38 //===========================================================================
39 //=============================Thermal Settings ============================
40 //===========================================================================
41 
42 //
43 // Custom Thermistor 1000 parameters
44 //
45 #if TEMP_SENSOR_0 == 1000
46  #define HOTEND0_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
47  #define HOTEND0_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
48  #define HOTEND0_BETA 3950 // Beta value
49 #endif
50 
51 #if TEMP_SENSOR_1 == 1000
52  #define HOTEND1_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
53  #define HOTEND1_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
54  #define HOTEND1_BETA 3950 // Beta value
55 #endif
56 
57 #if TEMP_SENSOR_2 == 1000
58  #define HOTEND2_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
59  #define HOTEND2_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
60  #define HOTEND2_BETA 3950 // Beta value
61 #endif
62 
63 #if TEMP_SENSOR_3 == 1000
64  #define HOTEND3_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
65  #define HOTEND3_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
66  #define HOTEND3_BETA 3950 // Beta value
67 #endif
68 
69 #if TEMP_SENSOR_4 == 1000
70  #define HOTEND4_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
71  #define HOTEND4_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
72  #define HOTEND4_BETA 3950 // Beta value
73 #endif
74 
75 #if TEMP_SENSOR_5 == 1000
76  #define HOTEND5_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
77  #define HOTEND5_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
78  #define HOTEND5_BETA 3950 // Beta value
79 #endif
80 
81 #if TEMP_SENSOR_BED == 1000
82  #define BED_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
83  #define BED_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
84  #define BED_BETA 3950 // Beta value
85 #endif
86 
87 #if TEMP_SENSOR_CHAMBER == 1000
88  #define CHAMBER_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
89  #define CHAMBER_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
90  #define CHAMBER_BETA 3950 // Beta value
91 #endif
92 
93 //
94 // Hephestos 2 24V heated bed upgrade kit.
95 // https://store.bq.com/en/heated-bed-kit-hephestos2
96 //
97 //#define HEPHESTOS2_HEATED_BED_KIT
98 #if ENABLED(HEPHESTOS2_HEATED_BED_KIT)
99  #undef TEMP_SENSOR_BED
100  #define TEMP_SENSOR_BED 70
101  #define HEATER_BED_INVERTING true
102 #endif
103 
104 /**
105  * Heated Chamber settings
106  */
107 #if TEMP_SENSOR_CHAMBER
108  #define CHAMBER_MINTEMP 5
109  #define CHAMBER_MAXTEMP 60
110  #define TEMP_CHAMBER_HYSTERESIS 1 // (°C) Temperature proximity considered "close enough" to the target
111  //#define CHAMBER_LIMIT_SWITCHING
112  //#define HEATER_CHAMBER_PIN 44 // Chamber heater on/off pin
113  //#define HEATER_CHAMBER_INVERTING false
114 #endif
115 
116 #if DISABLED(PIDTEMPBED)
117  #define BED_CHECK_INTERVAL 5000 // ms between checks in bang-bang control
118  #if ENABLED(BED_LIMIT_SWITCHING)
119  #define BED_HYSTERESIS 2 // Only disable heating if T>target+BED_HYSTERESIS and enable heating if T>target-BED_HYSTERESIS
120  #endif
121 #endif
122 
123 /**
124  * Thermal Protection provides additional protection to your printer from damage
125  * and fire. Marlin always includes safe min and max temperature ranges which
126  * protect against a broken or disconnected thermistor wire.
127  *
128  * The issue: If a thermistor falls out, it will report the much lower
129  * temperature of the air in the room, and the the firmware will keep
130  * the heater on.
131  *
132  * The solution: Once the temperature reaches the target, start observing.
133  * If the temperature stays too far below the target (hysteresis) for too
134  * long (period), the firmware will halt the machine as a safety precaution.
135  *
136  * If you get false positives for "Thermal Runaway", increase
137  * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
138  */
139 #if ENABLED(THERMAL_PROTECTION_HOTENDS)
140  #define THERMAL_PROTECTION_PERIOD 40 // Seconds
141  #define THERMAL_PROTECTION_HYSTERESIS 4 // Degrees Celsius
142 
143  //#define ADAPTIVE_FAN_SLOWING // Slow part cooling fan if temperature drops
144  #if BOTH(ADAPTIVE_FAN_SLOWING, PIDTEMP)
145  //#define NO_FAN_SLOWING_IN_PID_TUNING // Don't slow fan speed during M303
146  #endif
147 
148  /**
149  * Whenever an M104, M109, or M303 increases the target temperature, the
150  * firmware will wait for the WATCH_TEMP_PERIOD to expire. If the temperature
151  * hasn't increased by WATCH_TEMP_INCREASE degrees, the machine is halted and
152  * requires a hard reset. This test restarts with any M104/M109/M303, but only
153  * if the current temperature is far enough below the target for a reliable
154  * test.
155  *
156  * If you get false positives for "Heating failed", increase WATCH_TEMP_PERIOD
157  * and/or decrease WATCH_TEMP_INCREASE. WATCH_TEMP_INCREASE should not be set
158  * below 2.
159  */
160  #define WATCH_TEMP_PERIOD 20 // Seconds
161  #define WATCH_TEMP_INCREASE 2 // Degrees Celsius
162 #endif
163 
164 /**
165  * Thermal Protection parameters for the bed are just as above for hotends.
166  */
167 #if ENABLED(THERMAL_PROTECTION_BED)
168  #define THERMAL_PROTECTION_BED_PERIOD 20 // Seconds
169  #define THERMAL_PROTECTION_BED_HYSTERESIS 2 // Degrees Celsius
170 
171  /**
172  * As described above, except for the bed (M140/M190/M303).
173  */
174  #define WATCH_BED_TEMP_PERIOD 60 // Seconds
175  #define WATCH_BED_TEMP_INCREASE 2 // Degrees Celsius
176 #endif
177 
178 /**
179  * Thermal Protection parameters for the heated chamber.
180  */
181 #if ENABLED(THERMAL_PROTECTION_CHAMBER)
182  #define THERMAL_PROTECTION_CHAMBER_PERIOD 20 // Seconds
183  #define THERMAL_PROTECTION_CHAMBER_HYSTERESIS 2 // Degrees Celsius
184 
185  /**
186  * Heated chamber watch settings (M141/M191).
187  */
188  #define WATCH_CHAMBER_TEMP_PERIOD 60 // Seconds
189  #define WATCH_CHAMBER_TEMP_INCREASE 2 // Degrees Celsius
190 #endif
191 
192 #if ENABLED(PIDTEMP)
193  // Add an experimental additional term to the heater power, proportional to the extrusion speed.
194  // A well-chosen Kc value should add just enough power to melt the increased material volume.
195  //#define PID_EXTRUSION_SCALING
196  #if ENABLED(PID_EXTRUSION_SCALING)
197  #define DEFAULT_Kc (100) //heating power=Kc*(e_speed)
198  #define LPQ_MAX_LEN 50
199  #endif
200 #endif
201 
202 /**
203  * Automatic Temperature:
204  * The hotend target temperature is calculated by all the buffered lines of gcode.
205  * The maximum buffered steps/sec of the extruder motor is called "se".
206  * Start autotemp mode with M109 S<mintemp> B<maxtemp> F<factor>
207  * The target temperature is set to mintemp+factor*se[steps/sec] and is limited by
208  * mintemp and maxtemp. Turn this off by executing M109 without F*
209  * Also, if the temperature is set to a value below mintemp, it will not be changed by autotemp.
210  * On an Ultimaker, some initial testing worked with M109 S215 B260 F1 in the start.gcode
211  */
212 #define AUTOTEMP
213 #if ENABLED(AUTOTEMP)
214  #define AUTOTEMP_OLDWEIGHT 0.98
215 #endif
216 
217 // Show extra position information with 'M114 D'
218 //#define M114_DETAIL
219 
220 // Show Temperature ADC value
221 // Enable for M105 to include ADC values read from temperature sensors.
222 //#define SHOW_TEMP_ADC_VALUES
223 
224 /**
225  * High Temperature Thermistor Support
226  *
227  * Thermistors able to support high temperature tend to have a hard time getting
228  * good readings at room and lower temperatures. This means HEATER_X_RAW_LO_TEMP
229  * will probably be caught when the heating element first turns on during the
230  * preheating process, which will trigger a min_temp_error as a safety measure
231  * and force stop everything.
232  * To circumvent this limitation, we allow for a preheat time (during which,
233  * min_temp_error won't be triggered) and add a min_temp buffer to handle
234  * aberrant readings.
235  *
236  * If you want to enable this feature for your hotend thermistor(s)
237  * uncomment and set values > 0 in the constants below
238  */
239 
240 // The number of consecutive low temperature errors that can occur
241 // before a min_temp_error is triggered. (Shouldn't be more than 10.)
242 //#define MAX_CONSECUTIVE_LOW_TEMPERATURE_ERROR_ALLOWED 0
243 
244 // The number of milliseconds a hotend will preheat before starting to check
245 // the temperature. This value should NOT be set to the time it takes the
246 // hot end to reach the target temperature, but the time it takes to reach
247 // the minimum temperature your thermistor can read. The lower the better/safer.
248 // This shouldn't need to be more than 30 seconds (30000)
249 //#define MILLISECONDS_PREHEAT_TIME 0
250 
251 // @section extruder
252 
253 // Extruder runout prevention.
254 // If the machine is idle and the temperature over MINTEMP
255 // then extrude some filament every couple of SECONDS.
256 //#define EXTRUDER_RUNOUT_PREVENT
257 #if ENABLED(EXTRUDER_RUNOUT_PREVENT)
258  #define EXTRUDER_RUNOUT_MINTEMP 190
259  #define EXTRUDER_RUNOUT_SECONDS 30
260  #define EXTRUDER_RUNOUT_SPEED 1500 // (mm/m)
261  #define EXTRUDER_RUNOUT_EXTRUDE 5 // (mm)
262 #endif
263 
264 // @section temperature
265 
266 // Calibration for AD595 / AD8495 sensor to adjust temperature measurements.
267 // The final temperature is calculated as (measuredTemp * GAIN) + OFFSET.
268 #define TEMP_SENSOR_AD595_OFFSET 0.0
269 #define TEMP_SENSOR_AD595_GAIN 1.0
270 #define TEMP_SENSOR_AD8495_OFFSET 0.0
271 #define TEMP_SENSOR_AD8495_GAIN 1.0
272 
273 /**
274  * Controller Fan
275  * To cool down the stepper drivers and MOSFETs.
276  *
277  * The fan will turn on automatically whenever any stepper is enabled
278  * and turn off after a set period after all steppers are turned off.
279  */
280 //#define USE_CONTROLLER_FAN
281 #if ENABLED(USE_CONTROLLER_FAN)
282  //#define CONTROLLER_FAN_PIN -1 // Set a custom pin for the controller fan
283  #define CONTROLLERFAN_SECS 60 // Duration in seconds for the fan to run after all motors are disabled
284  #define CONTROLLERFAN_SPEED 255 // 255 == full speed
285  //#define CONTROLLERFAN_SPEED_Z_ONLY 127 // Reduce noise on machines that keep Z enabled
286 #endif
287 
288 // When first starting the main fan, run it at full speed for the
289 // given number of milliseconds. This gets the fan spinning reliably
290 // before setting a PWM value. (Does not work with software PWM for fan on Sanguinololu)
291 //#define FAN_KICKSTART_TIME 100
292 
293 /**
294  * PWM Fan Scaling
295  *
296  * Define the min/max speeds for PWM fans (as set with M106).
297  *
298  * With these options the M106 0-255 value range is scaled to a subset
299  * to ensure that the fan has enough power to spin, or to run lower
300  * current fans with higher current. (e.g., 5V/12V fans with 12V/24V)
301  * Value 0 always turns off the fan.
302  *
303  * Define one or both of these to override the default 0-255 range.
304  */
305 //#define FAN_MIN_PWM 50
306 //#define FAN_MAX_PWM 128
307 
308 /**
309  * FAST PWM FAN Settings
310  *
311  * Use to change the FAST FAN PWM frequency (if enabled in Configuration.h)
312  * Combinations of PWM Modes, prescale values and TOP resolutions are used internally to produce a
313  * frequency as close as possible to the desired frequency.
314  *
315  * FAST_PWM_FAN_FREQUENCY [undefined by default]
316  * Set this to your desired frequency.
317  * If left undefined this defaults to F = F_CPU/(2*255*1)
318  * ie F = 31.4 Khz on 16 MHz microcontrollers or F = 39.2 KHz on 20 MHz microcontrollers
319  * These defaults are the same as with the old FAST_PWM_FAN implementation - no migration is required
320  * NOTE: Setting very low frequencies (< 10 Hz) may result in unexpected timer behavior.
321  *
322  * USE_OCR2A_AS_TOP [undefined by default]
323  * Boards that use TIMER2 for PWM have limitations resulting in only a few possible frequencies on TIMER2:
324  * 16MHz MCUs: [62.5KHz, 31.4KHz (default), 7.8KHz, 3.92KHz, 1.95KHz, 977Hz, 488Hz, 244Hz, 60Hz, 122Hz, 30Hz]
325  * 20MHz MCUs: [78.1KHz, 39.2KHz (default), 9.77KHz, 4.9KHz, 2.44KHz, 1.22KHz, 610Hz, 305Hz, 153Hz, 76Hz, 38Hz]
326  * A greater range can be achieved by enabling USE_OCR2A_AS_TOP. But note that this option blocks the use of
327  * PWM on pin OC2A. Only use this option if you don't need PWM on 0C2A. (Check your schematic.)
328  * USE_OCR2A_AS_TOP sacrifices duty cycle control resolution to achieve this broader range of frequencies.
329  */
330 #if ENABLED(FAST_PWM_FAN)
331  //#define FAST_PWM_FAN_FREQUENCY 31400
332  //#define USE_OCR2A_AS_TOP
333 #endif
334 
335 // @section extruder
336 
337 /**
338  * Extruder cooling fans
339  *
340  * Extruder auto fans automatically turn on when their extruders'
341  * temperatures go above EXTRUDER_AUTO_FAN_TEMPERATURE.
342  *
343  * Your board's pins file specifies the recommended pins. Override those here
344  * or set to -1 to disable completely.
345  *
346  * Multiple extruders can be assigned to the same pin in which case
347  * the fan will turn on when any selected extruder is above the threshold.
348  */
349 #define E0_AUTO_FAN_PIN -1
350 #define E1_AUTO_FAN_PIN -1
351 #define E2_AUTO_FAN_PIN -1
352 #define E3_AUTO_FAN_PIN -1
353 #define E4_AUTO_FAN_PIN -1
354 #define E5_AUTO_FAN_PIN -1
355 #define CHAMBER_AUTO_FAN_PIN -1
356 
357 #define EXTRUDER_AUTO_FAN_TEMPERATURE 50
358 #define EXTRUDER_AUTO_FAN_SPEED 255 // 255 == full speed
359 #define CHAMBER_AUTO_FAN_TEMPERATURE 30
360 #define CHAMBER_AUTO_FAN_SPEED 255
361 
362 /**
363  * Part-Cooling Fan Multiplexer
364  *
365  * This feature allows you to digitally multiplex the fan output.
366  * The multiplexer is automatically switched at tool-change.
367  * Set FANMUX[012]_PINs below for up to 2, 4, or 8 multiplexed fans.
368  */
369 #define FANMUX0_PIN -1
370 #define FANMUX1_PIN -1
371 #define FANMUX2_PIN -1
372 
373 /**
374  * M355 Case Light on-off / brightness
375  */
376 //#define CASE_LIGHT_ENABLE
377 #if ENABLED(CASE_LIGHT_ENABLE)
378  //#define CASE_LIGHT_PIN 4 // Override the default pin if needed
379  #define INVERT_CASE_LIGHT false // Set true if Case Light is ON when pin is LOW
380  #define CASE_LIGHT_DEFAULT_ON true // Set default power-up state on
381  #define CASE_LIGHT_DEFAULT_BRIGHTNESS 105 // Set default power-up brightness (0-255, requires PWM pin)
382  //#define CASE_LIGHT_MAX_PWM 128 // Limit pwm
383  //#define CASE_LIGHT_MENU // Add Case Light options to the LCD menu
384  //#define CASE_LIGHT_NO_BRIGHTNESS // Disable brightness control. Enable for non-PWM lighting.
385  //#define CASE_LIGHT_USE_NEOPIXEL // Use Neopixel LED as case light, requires NEOPIXEL_LED.
386  #if ENABLED(CASE_LIGHT_USE_NEOPIXEL)
387  #define CASE_LIGHT_NEOPIXEL_COLOR { 255, 255, 255, 255 } // { Red, Green, Blue, White }
388  #endif
389 #endif
390 
391 // @section homing
392 
393 // If you want endstops to stay on (by default) even when not homing
394 // enable this option. Override at any time with M120, M121.
395 //#define ENDSTOPS_ALWAYS_ON_DEFAULT
396 
397 // @section extras
398 
399 //#define Z_LATE_ENABLE // Enable Z the last moment. Needed if your Z driver overheats.
400 
401 // Employ an external closed loop controller. Override pins here if needed.
402 //#define EXTERNAL_CLOSED_LOOP_CONTROLLER
403 #if ENABLED(EXTERNAL_CLOSED_LOOP_CONTROLLER)
404  //#define CLOSED_LOOP_ENABLE_PIN -1
405  //#define CLOSED_LOOP_MOVE_COMPLETE_PIN -1
406 #endif
407 
408 /**
409  * Dual Steppers / Dual Endstops
410  *
411  * This section will allow you to use extra E drivers to drive a second motor for X, Y, or Z axes.
412  *
413  * For example, set X_DUAL_STEPPER_DRIVERS setting to use a second motor. If the motors need to
414  * spin in opposite directions set INVERT_X2_VS_X_DIR. If the second motor needs its own endstop
415  * set X_DUAL_ENDSTOPS. This can adjust for "racking." Use X2_USE_ENDSTOP to set the endstop plug
416  * that should be used for the second endstop. Extra endstops will appear in the output of 'M119'.
417  *
418  * Use X_DUAL_ENDSTOP_ADJUSTMENT to adjust for mechanical imperfection. After homing both motors
419  * this offset is applied to the X2 motor. To find the offset home the X axis, and measure the error
420  * in X2. Dual endstop offsets can be set at runtime with 'M666 X<offset> Y<offset> Z<offset>'.
421  */
422 
423 //#define X_DUAL_STEPPER_DRIVERS
424 #if ENABLED(X_DUAL_STEPPER_DRIVERS)
425  #define INVERT_X2_VS_X_DIR true // Set 'true' if X motors should rotate in opposite directions
426  //#define X_DUAL_ENDSTOPS
427  #if ENABLED(X_DUAL_ENDSTOPS)
428  #define X2_USE_ENDSTOP _XMAX_
429  #define X_DUAL_ENDSTOPS_ADJUSTMENT 0
430  #endif
431 #endif
432 
433 //#define Y_DUAL_STEPPER_DRIVERS
434 #if ENABLED(Y_DUAL_STEPPER_DRIVERS)
435  #define INVERT_Y2_VS_Y_DIR true // Set 'true' if Y motors should rotate in opposite directions
436  //#define Y_DUAL_ENDSTOPS
437  #if ENABLED(Y_DUAL_ENDSTOPS)
438  #define Y2_USE_ENDSTOP _YMAX_
439  #define Y_DUAL_ENDSTOPS_ADJUSTMENT 0
440  #endif
441 #endif
442 
443 //#define Z_DUAL_STEPPER_DRIVERS
444 #if ENABLED(Z_DUAL_STEPPER_DRIVERS)
445  //#define Z_DUAL_ENDSTOPS
446  #if ENABLED(Z_DUAL_ENDSTOPS)
447  #define Z2_USE_ENDSTOP _XMAX_
448  #define Z_DUAL_ENDSTOPS_ADJUSTMENT 0
449  #endif
450 #endif
451 
452 //#define Z_TRIPLE_STEPPER_DRIVERS
453 #if ENABLED(Z_TRIPLE_STEPPER_DRIVERS)
454  //#define Z_TRIPLE_ENDSTOPS
455  #if ENABLED(Z_TRIPLE_ENDSTOPS)
456  #define Z2_USE_ENDSTOP _XMAX_
457  #define Z3_USE_ENDSTOP _YMAX_
458  #define Z_TRIPLE_ENDSTOPS_ADJUSTMENT2 0
459  #define Z_TRIPLE_ENDSTOPS_ADJUSTMENT3 0
460  #endif
461 #endif
462 
463 /**
464  * Dual X Carriage
465  *
466  * This setup has two X carriages that can move independently, each with its own hotend.
467  * The carriages can be used to print an object with two colors or materials, or in
468  * "duplication mode" it can print two identical or X-mirrored objects simultaneously.
469  * The inactive carriage is parked automatically to prevent oozing.
470  * X1 is the left carriage, X2 the right. They park and home at opposite ends of the X axis.
471  * By default the X2 stepper is assigned to the first unused E plug on the board.
472  *
473  * The following Dual X Carriage modes can be selected with M605 S<mode>:
474  *
475  * 0 : (FULL_CONTROL) The slicer has full control over both X-carriages and can achieve optimal travel
476  * results as long as it supports dual X-carriages. (M605 S0)
477  *
478  * 1 : (AUTO_PARK) The firmware automatically parks and unparks the X-carriages on tool-change so
479  * that additional slicer support is not required. (M605 S1)
480  *
481  * 2 : (DUPLICATION) The firmware moves the second X-carriage and extruder in synchronization with
482  * the first X-carriage and extruder, to print 2 copies of the same object at the same time.
483  * Set the constant X-offset and temperature differential with M605 S2 X[offs] R[deg] and
484  * follow with M605 S2 to initiate duplicated movement.
485  *
486  * 3 : (MIRRORED) Formbot/Vivedino-inspired mirrored mode in which the second extruder duplicates
487  * the movement of the first except the second extruder is reversed in the X axis.
488  * Set the initial X offset and temperature differential with M605 S2 X[offs] R[deg] and
489  * follow with M605 S3 to initiate mirrored movement.
490  */
491 //#define DUAL_X_CARRIAGE
492 #if ENABLED(DUAL_X_CARRIAGE)
493  #define X1_MIN_POS X_MIN_POS // Set to X_MIN_POS
494  #define X1_MAX_POS X_BED_SIZE // Set a maximum so the first X-carriage can't hit the parked second X-carriage
495  #define X2_MIN_POS 80 // Set a minimum to ensure the second X-carriage can't hit the parked first X-carriage
496  #define X2_MAX_POS 353 // Set this to the distance between toolheads when both heads are homed
497  #define X2_HOME_DIR 1 // Set to 1. The second X-carriage always homes to the maximum endstop position
498  #define X2_HOME_POS X2_MAX_POS // Default X2 home position. Set to X2_MAX_POS.
499  // However: In this mode the HOTEND_OFFSET_X value for the second extruder provides a software
500  // override for X2_HOME_POS. This also allow recalibration of the distance between the two endstops
501  // without modifying the firmware (through the "M218 T1 X???" command).
502  // Remember: you should set the second extruder x-offset to 0 in your slicer.
503 
504  // This is the default power-up mode which can be later using M605.
505  #define DEFAULT_DUAL_X_CARRIAGE_MODE DXC_AUTO_PARK_MODE
506 
507  // Default x offset in duplication mode (typically set to half print bed width)
508  #define DEFAULT_DUPLICATION_X_OFFSET 100
509 
510 #endif // DUAL_X_CARRIAGE
511 
512 // Activate a solenoid on the active extruder with M380. Disable all with M381.
513 // Define SOL0_PIN, SOL1_PIN, etc., for each extruder that has a solenoid.
514 //#define EXT_SOLENOID
515 
516 // @section homing
517 
518 // Homing hits each endstop, retracts by these distances, then does a slower bump.
519 #define X_HOME_BUMP_MM 5
520 #define Y_HOME_BUMP_MM 5
521 #define Z_HOME_BUMP_MM 2
522 #define HOMING_BUMP_DIVISOR { 2, 2, 4 } // Re-Bump Speed Divisor (Divides the Homing Feedrate)
523 //#define QUICK_HOME // If homing includes X and Y, do a diagonal move initially
524 //#define HOMING_BACKOFF_MM { 2, 2, 2 } // (mm) Move away from the endstops after homing
525 
526 // When G28 is called, this option will make Y home before X
527 //#define HOME_Y_BEFORE_X
528 
529 // Enable this if X or Y can't home without homing the other axis first.
530 //#define CODEPENDENT_XY_HOMING
531 
532 #if ENABLED(BLTOUCH)
533  /**
534  * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
535  * Do not activate settings that the probe might not understand. Clones might misunderstand
536  * advanced commands.
537  *
538  * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
539  * check the wiring of the BROWN, RED and ORANGE wires.
540  *
541  * Note: If the trigger signal of your probe is not being recognized, it has been very often
542  * because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
543  * like they would be with a real switch. So please check the wiring first.
544  *
545  * Settings for all BLTouch and clone probes:
546  */
547 
548  // Safety: The probe needs time to recognize the command.
549  // Minimum command delay (ms). Enable and increase if needed.
550  //#define BLTOUCH_DELAY 500
551 
552  /**
553  * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
554  */
555 
556  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
557  // in special cases, like noisy or filtered input configurations.
558  //#define BLTOUCH_FORCE_SW_MODE
559 
560  /**
561  * Settings for BLTouch Smart 3.0 and 3.1
562  * Summary:
563  * - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
564  * - High-Speed mode
565  * - Disable LCD voltage options
566  */
567 
568  /**
569  * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
570  * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
571  * If disabled, OD mode is the hard-coded default on 3.0
572  * On startup, Marlin will compare its eeprom to this vale. If the selected mode
573  * differs, a mode set eeprom write will be completed at initialization.
574  * Use the option below to force an eeprom write to a V3.1 probe regardless.
575  */
576  //#define BLTOUCH_SET_5V_MODE
577 
578  /**
579  * Safety: Activate if connecting a probe with an unknown voltage mode.
580  * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
581  * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
582  * To preserve the life of the probe, use this once then turn it off and re-flash.
583  */
584  //#define BLTOUCH_FORCE_MODE_SET
585 
586  /**
587  * Use "HIGH SPEED" mode for probing.
588  * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
589  * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
590  * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
591  */
592  //#define BLTOUCH_HS_MODE
593 
594  // Safety: Enable voltage mode settings in the LCD menu.
595  //#define BLTOUCH_LCD_VOLTAGE_MENU
596 
597 #endif // BLTOUCH
598 
599 /**
600  * Z Steppers Auto-Alignment
601  * Add the G34 command to align multiple Z steppers using a bed probe.
602  */
603 //#define Z_STEPPER_AUTO_ALIGN
604 #if ENABLED(Z_STEPPER_AUTO_ALIGN)
605  // Define probe X and Y positions for Z1, Z2 [, Z3]
606  #define Z_STEPPER_ALIGN_XY { { 10, 290 }, { 150, 10 }, { 290, 290 } }
607 
608  // Provide Z stepper positions for more rapid convergence in bed alignment.
609  // Currently requires triple stepper drivers.
610  //#define Z_STEPPER_ALIGN_KNOWN_STEPPER_POSITIONS
611  #if ENABLED(Z_STEPPER_ALIGN_KNOWN_STEPPER_POSITIONS)
612  // Define Stepper XY positions for Z1, Z2, Z3 corresponding to
613  // the Z screw positions in the bed carriage.
614  // Define one position per Z stepper in stepper driver order.
615  #define Z_STEPPER_ALIGN_STEPPER_XY { { 210.7, 102.5 }, { 152.6, 220.0 }, { 94.5, 102.5 } }
616  #else
617  // Amplification factor. Used to scale the correction step up or down.
618  // In case the stepper (spindle) position is further out than the test point.
619  // Use a value > 1. NOTE: This may cause instability
620  #define Z_STEPPER_ALIGN_AMP 1.0
621  #endif
622 
623  // Set number of iterations to align
624  #define Z_STEPPER_ALIGN_ITERATIONS 3
625 
626  // Enable to restore leveling setup after operation
627  #define RESTORE_LEVELING_AFTER_G34
628 
629  // On a 300mm bed a 5% grade would give a misalignment of ~1.5cm
630  #define G34_MAX_GRADE 5 // (%) Maximum incline G34 will handle
631 
632  // Stop criterion. If the accuracy is better than this stop iterating early
633  #define Z_STEPPER_ALIGN_ACC 0.02
634 #endif
635 
636 // @section motion
637 
638 #define AXIS_RELATIVE_MODES { false, false, false, false }
639 
640 // Add a Duplicate option for well-separated conjoined nozzles
641 //#define MULTI_NOZZLE_DUPLICATION
642 
643 // By default pololu step drivers require an active high signal. However, some high power drivers require an active low signal as step.
644 #define INVERT_X_STEP_PIN false
645 #define INVERT_Y_STEP_PIN false
646 #define INVERT_Z_STEP_PIN false
647 #define INVERT_E_STEP_PIN false
648 
649 // Default stepper release if idle. Set to 0 to deactivate.
650 // Steppers will shut down DEFAULT_STEPPER_DEACTIVE_TIME seconds after the last move when DISABLE_INACTIVE_? is true.
651 // Time can be set by M18 and M84.
652 #define DEFAULT_STEPPER_DEACTIVE_TIME 120
653 #define DISABLE_INACTIVE_X true
654 #define DISABLE_INACTIVE_Y true
655 #define DISABLE_INACTIVE_Z true // Set to false if the nozzle will fall down on your printed part when print has finished.
656 #define DISABLE_INACTIVE_E true
657 
658 #define DEFAULT_MINIMUMFEEDRATE 0.0 // minimum feedrate
659 #define DEFAULT_MINTRAVELFEEDRATE 0.0
660 
661 //#define HOME_AFTER_DEACTIVATE // Require rehoming after steppers are deactivated
662 
663 // Minimum time that a segment needs to take if the buffer is emptied
664 #define DEFAULT_MINSEGMENTTIME 20000 // (ms)
665 
666 // If defined the movements slow down when the look ahead buffer is only half full
667 #define SLOWDOWN
668 
669 // Frequency limit
670 // See nophead's blog for more info
671 // Not working O
672 //#define XY_FREQUENCY_LIMIT 15
673 
674 // Minimum planner junction speed. Sets the default minimum speed the planner plans for at the end
675 // of the buffer and all stops. This should not be much greater than zero and should only be changed
676 // if unwanted behavior is observed on a user's machine when running at very slow speeds.
677 #define MINIMUM_PLANNER_SPEED 0.05 // (mm/s)
678 
679 //
680 // Backlash Compensation
681 // Adds extra movement to axes on direction-changes to account for backlash.
682 //
683 //#define BACKLASH_COMPENSATION
684 #if ENABLED(BACKLASH_COMPENSATION)
685  // Define values for backlash distance and correction.
686  // If BACKLASH_GCODE is enabled these values are the defaults.
687  #define BACKLASH_DISTANCE_MM { 0, 0, 0 } // (mm)
688  #define BACKLASH_CORRECTION 0.0 // 0.0 = no correction; 1.0 = full correction
689 
690  // Set BACKLASH_SMOOTHING_MM to spread backlash correction over multiple segments
691  // to reduce print artifacts. (Enabling this is costly in memory and computation!)
692  //#define BACKLASH_SMOOTHING_MM 3 // (mm)
693 
694  // Add runtime configuration and tuning of backlash values (M425)
695  //#define BACKLASH_GCODE
696 
697  #if ENABLED(BACKLASH_GCODE)
698  // Measure the Z backlash when probing (G29) and set with "M425 Z"
699  #define MEASURE_BACKLASH_WHEN_PROBING
700 
701  #if ENABLED(MEASURE_BACKLASH_WHEN_PROBING)
702  // When measuring, the probe will move up to BACKLASH_MEASUREMENT_LIMIT
703  // mm away from point of contact in BACKLASH_MEASUREMENT_RESOLUTION
704  // increments while checking for the contact to be broken.
705  #define BACKLASH_MEASUREMENT_LIMIT 0.5 // (mm)
706  #define BACKLASH_MEASUREMENT_RESOLUTION 0.005 // (mm)
707  #define BACKLASH_MEASUREMENT_FEEDRATE Z_PROBE_SPEED_SLOW // (mm/m)
708  #endif
709  #endif
710 #endif
711 
712 /**
713  * Automatic backlash, position and hotend offset calibration
714  *
715  * Enable G425 to run automatic calibration using an electrically-
716  * conductive cube, bolt, or washer mounted on the bed.
717  *
718  * G425 uses the probe to touch the top and sides of the calibration object
719  * on the bed and measures and/or correct positional offsets, axis backlash
720  * and hotend offsets.
721  *
722  * Note: HOTEND_OFFSET and CALIBRATION_OBJECT_CENTER must be set to within
723  * ±5mm of true values for G425 to succeed.
724  */
725 //#define CALIBRATION_GCODE
726 #if ENABLED(CALIBRATION_GCODE)
727 
728  #define CALIBRATION_MEASUREMENT_RESOLUTION 0.01 // mm
729 
730  #define CALIBRATION_FEEDRATE_SLOW 60 // mm/m
731  #define CALIBRATION_FEEDRATE_FAST 1200 // mm/m
732  #define CALIBRATION_FEEDRATE_TRAVEL 3000 // mm/m
733 
734  // The following parameters refer to the conical section of the nozzle tip.
735  #define CALIBRATION_NOZZLE_TIP_HEIGHT 1.0 // mm
736  #define CALIBRATION_NOZZLE_OUTER_DIAMETER 2.0 // mm
737 
738  // Uncomment to enable reporting (required for "G425 V", but consumes PROGMEM).
739  //#define CALIBRATION_REPORTING
740 
741  // The true location and dimension the cube/bolt/washer on the bed.
742  #define CALIBRATION_OBJECT_CENTER { 264.0, -22.0, -2.0 } // mm
743  #define CALIBRATION_OBJECT_DIMENSIONS { 10.0, 10.0, 10.0 } // mm
744 
745  // Comment out any sides which are unreachable by the probe. For best
746  // auto-calibration results, all sides must be reachable.
747  #define CALIBRATION_MEASURE_RIGHT
748  #define CALIBRATION_MEASURE_FRONT
749  #define CALIBRATION_MEASURE_LEFT
750  #define CALIBRATION_MEASURE_BACK
751 
752  // Probing at the exact top center only works if the center is flat. If
753  // probing on a screwhead or hollow washer, probe near the edges.
754  //#define CALIBRATION_MEASURE_AT_TOP_EDGES
755 
756  // Define pin which is read during calibration
757  #ifndef CALIBRATION_PIN
758  #define CALIBRATION_PIN -1 // Override in pins.h or set to -1 to use your Z endstop
759  #define CALIBRATION_PIN_INVERTING false // Set to true to invert the pin
760  //#define CALIBRATION_PIN_PULLDOWN
761  #define CALIBRATION_PIN_PULLUP
762  #endif
763 #endif
764 
765 /**
766  * Adaptive Step Smoothing increases the resolution of multi-axis moves, particularly at step frequencies
767  * below 1kHz (for AVR) or 10kHz (for ARM), where aliasing between axes in multi-axis moves causes audible
768  * vibration and surface artifacts. The algorithm adapts to provide the best possible step smoothing at the
769  * lowest stepping frequencies.
770  */
771 //#define ADAPTIVE_STEP_SMOOTHING
772 
773 /**
774  * Custom Microstepping
775  * Override as-needed for your setup. Up to 3 MS pins are supported.
776  */
777 //#define MICROSTEP1 LOW,LOW,LOW
778 //#define MICROSTEP2 HIGH,LOW,LOW
779 //#define MICROSTEP4 LOW,HIGH,LOW
780 //#define MICROSTEP8 HIGH,HIGH,LOW
781 //#define MICROSTEP16 LOW,LOW,HIGH
782 //#define MICROSTEP32 HIGH,LOW,HIGH
783 
784 // Microstep setting (Only functional when stepper driver microstep pins are connected to MCU.
785 #define MICROSTEP_MODES { 16, 16, 16, 16, 16, 16 } // [1,2,4,8,16]
786 
787 /**
788  * @section stepper motor current
789  *
790  * Some boards have a means of setting the stepper motor current via firmware.
791  *
792  * The power on motor currents are set by:
793  * PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
794  * known compatible chips: A4982
795  * DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
796  * known compatible chips: AD5206
797  * DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
798  * known compatible chips: MCP4728
799  * DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
800  * known compatible chips: MCP4451, MCP4018
801  *
802  * Motor currents can also be set by M907 - M910 and by the LCD.
803  * M907 - applies to all.
804  * M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
805  * M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
806  */
807 //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 } // Values in milliamps
808 //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 } // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
809 //#define DAC_MOTOR_CURRENT_DEFAULT { 70, 80, 90, 80 } // Default drive percent - X, Y, Z, E axis
810 
811 // Use an I2C based DIGIPOT (e.g., Azteeg X3 Pro)
812 //#define DIGIPOT_I2C
813 #if ENABLED(DIGIPOT_I2C) && !defined(DIGIPOT_I2C_ADDRESS_A)
814  /**
815  * Common slave addresses:
816  *
817  * A (A shifted) B (B shifted) IC
818  * Smoothie 0x2C (0x58) 0x2D (0x5A) MCP4451
819  * AZTEEG_X3_PRO 0x2C (0x58) 0x2E (0x5C) MCP4451
820  * AZTEEG_X5_MINI 0x2C (0x58) 0x2E (0x5C) MCP4451
821  * AZTEEG_X5_MINI_WIFI 0x58 0x5C MCP4451
822  * MIGHTYBOARD_REVE 0x2F (0x5E) MCP4018
823  */
824  #define DIGIPOT_I2C_ADDRESS_A 0x2C // unshifted slave address for first DIGIPOT
825  #define DIGIPOT_I2C_ADDRESS_B 0x2D // unshifted slave address for second DIGIPOT
826 #endif
827 
828 //#define DIGIPOT_MCP4018 // Requires library from https://github.com/stawel/SlowSoftI2CMaster
829 #define DIGIPOT_I2C_NUM_CHANNELS 8 // 5DPRINT: 4 AZTEEG_X3_PRO: 8 MKS SBASE: 5
830 // Actual motor currents in Amps. The number of entries must match DIGIPOT_I2C_NUM_CHANNELS.
831 // These correspond to the physical drivers, so be mindful if the order is changed.
832 #define DIGIPOT_I2C_MOTOR_CURRENTS { 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 } // AZTEEG_X3_PRO
833 
834 //===========================================================================
835 //=============================Additional Features===========================
836 //===========================================================================
837 
838 // @section lcd
839 
840 #if EITHER(ULTIPANEL, EXTENSIBLE_UI)
841  #define MANUAL_FEEDRATE { 50*60, 50*60, 4*60, 60 } // Feedrates for manual moves along X, Y, Z, E from panel
842  #define SHORT_MANUAL_Z_MOVE 0.025 // (mm) Smallest manual Z move (< 0.1mm)
843  #if ENABLED(ULTIPANEL)
844  #define MANUAL_E_MOVES_RELATIVE // Display extruder move distance rather than "position"
845  #define ULTIPANEL_FEEDMULTIPLY // Encoder sets the feedrate multiplier on the Status Screen
846  #endif
847 #endif
848 
849 // Change values more rapidly when the encoder is rotated faster
850 #define ENCODER_RATE_MULTIPLIER
851 #if ENABLED(ENCODER_RATE_MULTIPLIER)
852  #define ENCODER_10X_STEPS_PER_SEC 30 // (steps/s) Encoder rate for 10x speed
853  #define ENCODER_100X_STEPS_PER_SEC 80 // (steps/s) Encoder rate for 100x speed
854 #endif
855 
856 // Play a beep when the feedrate is changed from the Status Screen
857 //#define BEEP_ON_FEEDRATE_CHANGE
858 #if ENABLED(BEEP_ON_FEEDRATE_CHANGE)
859  #define FEEDRATE_CHANGE_BEEP_DURATION 10
860  #define FEEDRATE_CHANGE_BEEP_FREQUENCY 440
861 #endif
862 
863 #if HAS_LCD_MENU
864 
865  // Include a page of printer information in the LCD Main Menu
866  //#define LCD_INFO_MENU
867  #if ENABLED(LCD_INFO_MENU)
868  //#define LCD_PRINTER_INFO_IS_BOOTSCREEN // Show bootscreen(s) instead of Printer Info pages
869  #endif
870 
871  // BACK menu items keep the highlight at the top
872  //#define TURBO_BACK_MENU_ITEM
873 
874  /**
875  * LED Control Menu
876  * Add LED Control to the LCD menu
877  */
878  //#define LED_CONTROL_MENU
879  #if ENABLED(LED_CONTROL_MENU)
880  #define LED_COLOR_PRESETS // Enable the Preset Color menu option
881  #if ENABLED(LED_COLOR_PRESETS)
882  #define LED_USER_PRESET_RED 255 // User defined RED value
883  #define LED_USER_PRESET_GREEN 128 // User defined GREEN value
884  #define LED_USER_PRESET_BLUE 0 // User defined BLUE value
885  #define LED_USER_PRESET_WHITE 255 // User defined WHITE value
886  #define LED_USER_PRESET_BRIGHTNESS 255 // User defined intensity
887  //#define LED_USER_PRESET_STARTUP // Have the printer display the user preset color on startup
888  #endif
889  #endif
890 
891 #endif // HAS_LCD_MENU
892 
893 // Scroll a longer status message into view
894 //#define STATUS_MESSAGE_SCROLLING
895 
896 // On the Info Screen, display XY with one decimal place when possible
897 //#define LCD_DECIMAL_SMALL_XY
898 
899 // The timeout (in ms) to return to the status screen from sub-menus
900 //#define LCD_TIMEOUT_TO_STATUS 15000
901 
902 // Add an 'M73' G-code to set the current percentage
903 //#define LCD_SET_PROGRESS_MANUALLY
904 
905 #if HAS_PRINT_PROGRESS
906  //#define PRINT_PROGRESS_SHOW_DECIMALS // Show progress with decimal digits (Graphical LCD only)
907  //#define SHOW_REMAINING_TIME // Display estimated time to completion (Graphical LCD only)
908 #endif
909 
910 #if HAS_CHARACTER_LCD && HAS_PRINT_PROGRESS
911  //#define LCD_PROGRESS_BAR // Show a progress bar on HD44780 LCDs for SD printing
912  #if ENABLED(LCD_PROGRESS_BAR)
913  #define PROGRESS_BAR_BAR_TIME 2000 // (ms) Amount of time to show the bar
914  #define PROGRESS_BAR_MSG_TIME 3000 // (ms) Amount of time to show the status message
915  #define PROGRESS_MSG_EXPIRE 0 // (ms) Amount of time to retain the status message (0=forever)
916  //#define PROGRESS_MSG_ONCE // Show the message for MSG_TIME then clear it
917  //#define LCD_PROGRESS_BAR_TEST // Add a menu item to test the progress bar
918  #endif
919 #endif
920 
921 #if ENABLED(SDSUPPORT)
922 
923  // Some RAMPS and other boards don't detect when an SD card is inserted. You can work
924  // around this by connecting a push button or single throw switch to the pin defined
925  // as SD_DETECT_PIN in your board's pins definitions.
926  // This setting should be disabled unless you are using a push button, pulling the pin to ground.
927  // Note: This is always disabled for ULTIPANEL (except ELB_FULL_GRAPHIC_CONTROLLER).
928  #define SD_DETECT_INVERTED
929 
930  #define SD_FINISHED_STEPPERRELEASE true // Disable steppers when SD Print is finished
931  #define SD_FINISHED_RELEASECOMMAND "M84 X Y Z E" // You might want to keep the Z enabled so your bed stays in place.
932 
933  // Reverse SD sort to show "more recent" files first, according to the card's FAT.
934  // Since the FAT gets out of order with usage, SDCARD_SORT_ALPHA is recommended.
935  #define SDCARD_RATHERRECENTFIRST
936 
937  #define SD_MENU_CONFIRM_START // Confirm the selected SD file before printing
938 
939  //#define MENU_ADDAUTOSTART // Add a menu option to run auto#.g files
940 
941  #define EVENT_GCODE_SD_STOP "G28XY" // G-code to run on Stop Print (e.g., "G28XY" or "G27")
942 
943  /**
944  * Continue after Power-Loss (Creality3D)
945  *
946  * Store the current state to the SD Card at the start of each layer
947  * during SD printing. If the recovery file is found at boot time, present
948  * an option on the LCD screen to continue the print from the last-known
949  * point in the file.
950  */
951  //#define POWER_LOSS_RECOVERY
952  #if ENABLED(POWER_LOSS_RECOVERY)
953  //#define POWER_LOSS_PIN 44 // Pin to detect power loss
954  //#define POWER_LOSS_STATE HIGH // State of pin indicating power loss
955  //#define POWER_LOSS_PULL // Set pullup / pulldown as appropriate
956  //#define POWER_LOSS_PURGE_LEN 20 // (mm) Length of filament to purge on resume
957  //#define POWER_LOSS_RETRACT_LEN 10 // (mm) Length of filament to retract on fail. Requires backup power.
958 
959  // Without a POWER_LOSS_PIN the following option helps reduce wear on the SD card,
960  // especially with "vase mode" printing. Set too high and vases cannot be continued.
961  #define POWER_LOSS_MIN_Z_CHANGE 0.05 // (mm) Minimum Z change before saving power-loss data
962  #endif
963 
964  /**
965  * Sort SD file listings in alphabetical order.
966  *
967  * With this option enabled, items on SD cards will be sorted
968  * by name for easier navigation.
969  *
970  * By default...
971  *
972  * - Use the slowest -but safest- method for sorting.
973  * - Folders are sorted to the top.
974  * - The sort key is statically allocated.
975  * - No added G-code (M34) support.
976  * - 40 item sorting limit. (Items after the first 40 are unsorted.)
977  *
978  * SD sorting uses static allocation (as set by SDSORT_LIMIT), allowing the
979  * compiler to calculate the worst-case usage and throw an error if the SRAM
980  * limit is exceeded.
981  *
982  * - SDSORT_USES_RAM provides faster sorting via a static directory buffer.
983  * - SDSORT_USES_STACK does the same, but uses a local stack-based buffer.
984  * - SDSORT_CACHE_NAMES will retain the sorted file listing in RAM. (Expensive!)
985  * - SDSORT_DYNAMIC_RAM only uses RAM when the SD menu is visible. (Use with caution!)
986  */
987  //#define SDCARD_SORT_ALPHA
988 
989  // SD Card Sorting options
990  #if ENABLED(SDCARD_SORT_ALPHA)
991  #define SDSORT_LIMIT 40 // Maximum number of sorted items (10-256). Costs 27 bytes each.
992  #define FOLDER_SORTING -1 // -1=above 0=none 1=below
993  #define SDSORT_GCODE false // Allow turning sorting on/off with LCD and M34 g-code.
994  #define SDSORT_USES_RAM false // Pre-allocate a static array for faster pre-sorting.
995  #define SDSORT_USES_STACK false // Prefer the stack for pre-sorting to give back some SRAM. (Negated by next 2 options.)
996  #define SDSORT_CACHE_NAMES false // Keep sorted items in RAM longer for speedy performance. Most expensive option.
997  #define SDSORT_DYNAMIC_RAM false // Use dynamic allocation (within SD menus). Least expensive option. Set SDSORT_LIMIT before use!
998  #define SDSORT_CACHE_VFATS 2 // Maximum number of 13-byte VFAT entries to use for sorting.
999  // Note: Only affects SCROLL_LONG_FILENAMES with SDSORT_CACHE_NAMES but not SDSORT_DYNAMIC_RAM.
1000  #endif
1001 
1002  // This allows hosts to request long names for files and folders with M33
1003  //#define LONG_FILENAME_HOST_SUPPORT
1004 
1005  // Enable this option to scroll long filenames in the SD card menu
1006  //#define SCROLL_LONG_FILENAMES
1007 
1008  // Leave the heaters on after Stop Print (not recommended!)
1009  //#define SD_ABORT_NO_COOLDOWN
1010 
1011  /**
1012  * This option allows you to abort SD printing when any endstop is triggered.
1013  * This feature must be enabled with "M540 S1" or from the LCD menu.
1014  * To have any effect, endstops must be enabled during SD printing.
1015  */
1016  //#define SD_ABORT_ON_ENDSTOP_HIT
1017 
1018  /**
1019  * This option makes it easier to print the same SD Card file again.
1020  * On print completion the LCD Menu will open with the file selected.
1021  * You can just click to start the print, or navigate elsewhere.
1022  */
1023  //#define SD_REPRINT_LAST_SELECTED_FILE
1024 
1025  /**
1026  * Auto-report SdCard status with M27 S<seconds>
1027  */
1028  //#define AUTO_REPORT_SD_STATUS
1029 
1030  /**
1031  * Support for USB thumb drives using an Arduino USB Host Shield or
1032  * equivalent MAX3421E breakout board. The USB thumb drive will appear
1033  * to Marlin as an SD card.
1034  *
1035  * The MAX3421E can be assigned the same pins as the SD card reader, with
1036  * the following pin mapping:
1037  *
1038  * SCLK, MOSI, MISO --> SCLK, MOSI, MISO
1039  * INT --> SD_DETECT_PIN [1]
1040  * SS --> SDSS
1041  *
1042  * [1] On AVR an interrupt-capable pin is best for UHS3 compatibility.
1043  */
1044  //#define USB_FLASH_DRIVE_SUPPORT
1045  #if ENABLED(USB_FLASH_DRIVE_SUPPORT)
1046  #define USB_CS_PIN SDSS
1047  #define USB_INTR_PIN SD_DETECT_PIN
1048 
1049  /**
1050  * USB Host Shield Library
1051  *
1052  * - UHS2 uses no interrupts and has been production-tested
1053  * on a LulzBot TAZ Pro with a 32-bit Archim board.
1054  *
1055  * - UHS3 is newer code with better USB compatibility. But it
1056  * is less tested and is known to interfere with Servos.
1057  * [1] This requires USB_INTR_PIN to be interrupt-capable.
1058  */
1059  //#define USE_UHS3_USB
1060  #endif
1061 
1062  /**
1063  * When using a bootloader that supports SD-Firmware-Flashing,
1064  * add a menu item to activate SD-FW-Update on the next reboot.
1065  *
1066  * Requires ATMEGA2560 (Arduino Mega)
1067  *
1068  * Tested with this bootloader:
1069  * https://github.com/FleetProbe/MicroBridge-Arduino-ATMega2560
1070  */
1071  //#define SD_FIRMWARE_UPDATE
1072  #if ENABLED(SD_FIRMWARE_UPDATE)
1073  #define SD_FIRMWARE_UPDATE_EEPROM_ADDR 0x1FF
1074  #define SD_FIRMWARE_UPDATE_ACTIVE_VALUE 0xF0
1075  #define SD_FIRMWARE_UPDATE_INACTIVE_VALUE 0xFF
1076  #endif
1077 
1078  // Add an optimized binary file transfer mode, initiated with 'M28 B1'
1079  //#define BINARY_FILE_TRANSFER
1080 
1081  #if HAS_SDCARD_CONNECTION
1082  /**
1083  * Set this option to one of the following (or the board's defaults apply):
1084  *
1085  * LCD - Use the SD drive in the external LCD controller.
1086  * ONBOARD - Use the SD drive on the control board. (No SD_DETECT_PIN. M21 to init.)
1087  * CUSTOM_CABLE - Use a custom cable to access the SD (as defined in a pins file).
1088  *
1089  * :[ 'LCD', 'ONBOARD', 'CUSTOM_CABLE' ]
1090  */
1091  //#define SDCARD_CONNECTION LCD
1092  #endif
1093 
1094 #endif // SDSUPPORT
1095 
1096 /**
1097  * By default an onboard SD card reader may be shared as a USB mass-
1098  * storage device. This option hides the SD card from the host PC.
1099  */
1100 //#define NO_SD_HOST_DRIVE // Disable SD Card access over USB (for security).
1101 
1102 /**
1103  * Additional options for Graphical Displays
1104  *
1105  * Use the optimizations here to improve printing performance,
1106  * which can be adversely affected by graphical display drawing,
1107  * especially when doing several short moves, and when printing
1108  * on DELTA and SCARA machines.
1109  *
1110  * Some of these options may result in the display lagging behind
1111  * controller events, as there is a trade-off between reliable
1112  * printing performance versus fast display updates.
1113  */
1114 #if HAS_GRAPHICAL_LCD
1115  // Show SD percentage next to the progress bar
1116  //#define DOGM_SD_PERCENT
1117 
1118  // Enable to save many cycles by drawing a hollow frame on the Info Screen
1119  #define XYZ_HOLLOW_FRAME
1120 
1121  // Enable to save many cycles by drawing a hollow frame on Menu Screens
1122  #define MENU_HOLLOW_FRAME
1123 
1124  // A bigger font is available for edit items. Costs 3120 bytes of PROGMEM.
1125  // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1126  //#define USE_BIG_EDIT_FONT
1127 
1128  // A smaller font may be used on the Info Screen. Costs 2300 bytes of PROGMEM.
1129  // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1130  //#define USE_SMALL_INFOFONT
1131 
1132  // Enable this option and reduce the value to optimize screen updates.
1133  // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
1134  //#define DOGM_SPI_DELAY_US 5
1135 
1136  // Swap the CW/CCW indicators in the graphics overlay
1137  //#define OVERLAY_GFX_REVERSE
1138 
1139  /**
1140  * ST7920-based LCDs can emulate a 16 x 4 character display using
1141  * the ST7920 character-generator for very fast screen updates.
1142  * Enable LIGHTWEIGHT_UI to use this special display mode.
1143  *
1144  * Since LIGHTWEIGHT_UI has limited space, the position and status
1145  * message occupy the same line. Set STATUS_EXPIRE_SECONDS to the
1146  * length of time to display the status message before clearing.
1147  *
1148  * Set STATUS_EXPIRE_SECONDS to zero to never clear the status.
1149  * This will prevent position updates from being displayed.
1150  */
1151  #if ENABLED(U8GLIB_ST7920)
1152  //#define LIGHTWEIGHT_UI
1153  #if ENABLED(LIGHTWEIGHT_UI)
1154  #define STATUS_EXPIRE_SECONDS 20
1155  #endif
1156  #endif
1157 
1158  /**
1159  * Status (Info) Screen customizations
1160  * These options may affect code size and screen render time.
1161  * Custom status screens can forcibly override these settings.
1162  */
1163  //#define STATUS_COMBINE_HEATERS // Use combined heater images instead of separate ones
1164  //#define STATUS_HOTEND_NUMBERLESS // Use plain hotend icons instead of numbered ones (with 2+ hotends)
1165  #define STATUS_HOTEND_INVERTED // Show solid nozzle bitmaps when heating (Requires STATUS_HOTEND_ANIM)
1166  #define STATUS_HOTEND_ANIM // Use a second bitmap to indicate hotend heating
1167  #define STATUS_BED_ANIM // Use a second bitmap to indicate bed heating
1168  #define STATUS_CHAMBER_ANIM // Use a second bitmap to indicate chamber heating
1169  //#define STATUS_ALT_BED_BITMAP // Use the alternative bed bitmap
1170  //#define STATUS_ALT_FAN_BITMAP // Use the alternative fan bitmap
1171  //#define STATUS_FAN_FRAMES 3 // :[0,1,2,3,4] Number of fan animation frames
1172  //#define STATUS_HEAT_PERCENT // Show heating in a progress bar
1173  //#define BOOT_MARLIN_LOGO_SMALL // Show a smaller Marlin logo on the Boot Screen (saving 399 bytes of flash)
1174  //#define BOOT_MARLIN_LOGO_ANIMATED // Animated Marlin logo. Costs ~‭3260 (or ~940) bytes of PROGMEM.
1175 
1176  // Frivolous Game Options
1177  //#define MARLIN_BRICKOUT
1178  //#define MARLIN_INVADERS
1179  //#define MARLIN_SNAKE
1180  //#define GAMES_EASTER_EGG // Add extra blank lines above the "Games" sub-menu
1181 
1182 #endif // HAS_GRAPHICAL_LCD
1183 
1184 //
1185 // Lulzbot Touch UI
1186 //
1187 #if ENABLED(LULZBOT_TOUCH_UI)
1188  // Display board used
1189  //#define LCD_FTDI_VM800B35A // FTDI 3.5" with FT800 (320x240)
1190  //#define LCD_4DSYSTEMS_4DLCD_FT843 // 4D Systems 4.3" (480x272)
1191  //#define LCD_HAOYU_FT800CB // Haoyu with 4.3" or 5" (480x272)
1192  //#define LCD_HAOYU_FT810CB // Haoyu with 5" (800x480)
1193  //#define LCD_ALEPHOBJECTS_CLCD_UI // Aleph Objects Color LCD UI
1194 
1195  // Correct the resolution if not using the stock TFT panel.
1196  //#define TOUCH_UI_320x240
1197  //#define TOUCH_UI_480x272
1198  //#define TOUCH_UI_800x480
1199 
1200  // Mappings for boards with a standard RepRapDiscount Display connector
1201  //#define AO_EXP1_PINMAP // AlephObjects CLCD UI EXP1 mapping
1202  //#define AO_EXP2_PINMAP // AlephObjects CLCD UI EXP2 mapping
1203  //#define CR10_TFT_PINMAP // Rudolph Riedel's CR10 pin mapping
1204  //#define OTHER_PIN_LAYOUT // Define pins manually below
1205  #if ENABLED(OTHER_PIN_LAYOUT)
1206  // The pins for CS and MOD_RESET (PD) must be chosen.
1207  #define CLCD_MOD_RESET 9
1208  #define CLCD_SPI_CS 10
1209 
1210  // If using software SPI, specify pins for SCLK, MOSI, MISO
1211  //#define CLCD_USE_SOFT_SPI
1212  #if ENABLED(CLCD_USE_SOFT_SPI)
1213  #define CLCD_SOFT_SPI_MOSI 11
1214  #define CLCD_SOFT_SPI_MISO 12
1215  #define CLCD_SOFT_SPI_SCLK 13
1216  #endif
1217  #endif
1218 
1219  // Display Orientation. An inverted (i.e. upside-down) display
1220  // is supported on the FT800. The FT810 and beyond also support
1221  // portrait and mirrored orientations.
1222  //#define TOUCH_UI_INVERTED
1223  //#define TOUCH_UI_PORTRAIT
1224  //#define TOUCH_UI_MIRRORED
1225 
1226  // UTF8 processing and rendering.
1227  // Unsupported characters are shown as '?'.
1228  //#define TOUCH_UI_USE_UTF8
1229  #if ENABLED(TOUCH_UI_USE_UTF8)
1230  // Western accents support. These accented characters use
1231  // combined bitmaps and require relatively little storage.
1232  #define TOUCH_UI_UTF8_WESTERN_CHARSET
1233  #if ENABLED(TOUCH_UI_UTF8_WESTERN_CHARSET)
1234  // Additional character groups. These characters require
1235  // full bitmaps and take up considerable storage:
1236  //#define TOUCH_UI_UTF8_SUPERSCRIPTS // ¹ ² ³
1237  //#define TOUCH_UI_UTF8_COPYRIGHT // © ®
1238  //#define TOUCH_UI_UTF8_GERMANIC // ß
1239  //#define TOUCH_UI_UTF8_SCANDINAVIAN // Æ Ð Ø Þ æ ð ø þ
1240  //#define TOUCH_UI_UTF8_PUNCTUATION // « » ¿ ¡
1241  //#define TOUCH_UI_UTF8_CURRENCY // ¢ £ ¤ ¥
1242  //#define TOUCH_UI_UTF8_ORDINALS // º ª
1243  //#define TOUCH_UI_UTF8_MATHEMATICS // ± × ÷
1244  //#define TOUCH_UI_UTF8_FRACTIONS // ¼ ½ ¾
1245  //#define TOUCH_UI_UTF8_SYMBOLS // µ ¶ ¦ § ¬
1246  #endif
1247  #endif
1248 
1249  // Use a smaller font when labels don't fit buttons
1250  #define TOUCH_UI_FIT_TEXT
1251 
1252  // Allow language selection from menu at run-time (otherwise use LCD_LANGUAGE)
1253  //#define LCD_LANGUAGE_1 en
1254  //#define LCD_LANGUAGE_2 fr
1255  //#define LCD_LANGUAGE_3 de
1256  //#define LCD_LANGUAGE_4 es
1257  //#define LCD_LANGUAGE_5 it
1258 
1259  // Use a numeric passcode for "Screen lock" keypad.
1260  // (recommended for smaller displays)
1261  //#define TOUCH_UI_PASSCODE
1262 
1263  // Output extra debug info for Touch UI events
1264  //#define TOUCH_UI_DEBUG
1265 #endif
1266 
1267 //
1268 // FSMC Graphical TFT
1269 //
1270 #if ENABLED(FSMC_GRAPHICAL_TFT)
1271  //#define TFT_MARLINUI_COLOR 0xFFFF // White
1272  //#define TFT_MARLINBG_COLOR 0x0000 // Black
1273  //#define TFT_DISABLED_COLOR 0x0003 // Almost black
1274  //#define TFT_BTCANCEL_COLOR 0xF800 // Red
1275  //#define TFT_BTARROWS_COLOR 0xDEE6 // 11011 110111 00110 Yellow
1276  //#define TFT_BTOKMENU_COLOR 0x145F // 00010 100010 11111 Cyan
1277 #endif
1278 
1279 // @section safety
1280 
1281 /**
1282  * The watchdog hardware timer will do a reset and disable all outputs
1283  * if the firmware gets too overloaded to read the temperature sensors.
1284  *
1285  * If you find that watchdog reboot causes your AVR board to hang forever,
1286  * enable WATCHDOG_RESET_MANUAL to use a custom timer instead of WDTO.
1287  * NOTE: This method is less reliable as it can only catch hangups while
1288  * interrupts are enabled.
1289  */
1290 #define USE_WATCHDOG
1291 #if ENABLED(USE_WATCHDOG)
1292  //#define WATCHDOG_RESET_MANUAL
1293 #endif
1294 
1295 // @section lcd
1296 
1297 /**
1298  * Babystepping enables movement of the axes by tiny increments without changing
1299  * the current position values. This feature is used primarily to adjust the Z
1300  * axis in the first layer of a print in real-time.
1301  *
1302  * Warning: Does not respect endstops!
1303  */
1304 //#define BABYSTEPPING
1305 #if ENABLED(BABYSTEPPING)
1306  //#define BABYSTEP_WITHOUT_HOMING
1307  //#define BABYSTEP_XY // Also enable X/Y Babystepping. Not supported on DELTA!
1308  #define BABYSTEP_INVERT_Z false // Change if Z babysteps should go the other way
1309  #define BABYSTEP_MULTIPLICATOR 1 // Babysteps are very small. Increase for faster motion.
1310 
1311  //#define DOUBLECLICK_FOR_Z_BABYSTEPPING // Double-click on the Status Screen for Z Babystepping.
1312  #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING)
1313  #define DOUBLECLICK_MAX_INTERVAL 1250 // Maximum interval between clicks, in milliseconds.
1314  // Note: Extra time may be added to mitigate controller latency.
1315  //#define BABYSTEP_ALWAYS_AVAILABLE // Allow babystepping at all times (not just during movement).
1316  //#define MOVE_Z_WHEN_IDLE // Jump to the move Z menu on doubleclick when printer is idle.
1317  #if ENABLED(MOVE_Z_WHEN_IDLE)
1318  #define MOVE_Z_IDLE_MULTIPLICATOR 1 // Multiply 1mm by this factor for the move step size.
1319  #endif
1320  #endif
1321 
1322  //#define BABYSTEP_DISPLAY_TOTAL // Display total babysteps since last G28
1323 
1324  //#define BABYSTEP_ZPROBE_OFFSET // Combine M851 Z and Babystepping
1325  #if ENABLED(BABYSTEP_ZPROBE_OFFSET)
1326  //#define BABYSTEP_HOTEND_Z_OFFSET // For multiple hotends, babystep relative Z offsets
1327  //#define BABYSTEP_ZPROBE_GFX_OVERLAY // Enable graphical overlay on Z-offset editor
1328  #endif
1329 #endif
1330 
1331 // @section extruder
1332 
1333 /**
1334  * Linear Pressure Control v1.5
1335  *
1336  * Assumption: advance [steps] = k * (delta velocity [steps/s])
1337  * K=0 means advance disabled.
1338  *
1339  * NOTE: K values for LIN_ADVANCE 1.5 differ from earlier versions!
1340  *
1341  * Set K around 0.22 for 3mm PLA Direct Drive with ~6.5cm between the drive gear and heatbreak.
1342  * Larger K values will be needed for flexible filament and greater distances.
1343  * If this algorithm produces a higher speed offset than the extruder can handle (compared to E jerk)
1344  * print acceleration will be reduced during the affected moves to keep within the limit.
1345  *
1346  * See http://marlinfw.org/docs/features/lin_advance.html for full instructions.
1347  * Mention @Sebastianv650 on GitHub to alert the author of any issues.
1348  */
1349 //#define LIN_ADVANCE
1350 #if ENABLED(LIN_ADVANCE)
1351  //#define EXTRA_LIN_ADVANCE_K // Enable for second linear advance constants
1352  #define LIN_ADVANCE_K 0.22 // Unit: mm compression per 1mm/s extruder speed
1353  //#define LA_DEBUG // If enabled, this will generate debug information output over USB.
1354 #endif
1355 
1356 // @section leveling
1357 
1358 /**
1359  * Points to probe for all 3-point Leveling procedures.
1360  * Override if the automatically selected points are inadequate.
1361  */
1362 #if EITHER(AUTO_BED_LEVELING_3POINT, AUTO_BED_LEVELING_UBL)
1363  //#define PROBE_PT_1_X 15
1364  //#define PROBE_PT_1_Y 180
1365  //#define PROBE_PT_2_X 15
1366  //#define PROBE_PT_2_Y 20
1367  //#define PROBE_PT_3_X 170
1368  //#define PROBE_PT_3_Y 20
1369 #endif
1370 
1371 /**
1372  * Override MIN_PROBE_EDGE for each side of the build plate
1373  * Useful to get probe points to exact positions on targets or
1374  * to allow leveling to avoid plate clamps on only specific
1375  * sides of the bed.
1376  *
1377  * If you are replacing the prior *_PROBE_BED_POSITION options,
1378  * LEFT and FRONT values in most cases will map directly over
1379  * RIGHT and REAR would be the inverse such as
1380  * (X/Y_BED_SIZE - RIGHT/BACK_PROBE_BED_POSITION)
1381  *
1382  * This will allow all positions to match at compilation, however
1383  * should the probe position be modified with M851XY then the
1384  * probe points will follow. This prevents any change from causing
1385  * the probe to be unable to reach any points.
1386  */
1387 #if PROBE_SELECTED && !IS_KINEMATIC
1388  //#define MIN_PROBE_EDGE_LEFT MIN_PROBE_EDGE
1389  //#define MIN_PROBE_EDGE_RIGHT MIN_PROBE_EDGE
1390  //#define MIN_PROBE_EDGE_FRONT MIN_PROBE_EDGE
1391  //#define MIN_PROBE_EDGE_BACK MIN_PROBE_EDGE
1392 #endif
1393 
1394 #if EITHER(MESH_BED_LEVELING, AUTO_BED_LEVELING_UBL)
1395  // Override the mesh area if the automatic (max) area is too large
1396  //#define MESH_MIN_X MESH_INSET
1397  //#define MESH_MIN_Y MESH_INSET
1398  //#define MESH_MAX_X X_BED_SIZE - (MESH_INSET)
1399  //#define MESH_MAX_Y Y_BED_SIZE - (MESH_INSET)
1400 #endif
1401 
1402 /**
1403  * Repeatedly attempt G29 leveling until it succeeds.
1404  * Stop after G29_MAX_RETRIES attempts.
1405  */
1406 //#define G29_RETRY_AND_RECOVER
1407 #if ENABLED(G29_RETRY_AND_RECOVER)
1408  #define G29_MAX_RETRIES 3
1409  #define G29_HALT_ON_FAILURE
1410  /**
1411  * Specify the GCODE commands that will be executed when leveling succeeds,
1412  * between attempts, and after the maximum number of retries have been tried.
1413  */
1414  #define G29_SUCCESS_COMMANDS "M117 Bed leveling done."
1415  #define G29_RECOVER_COMMANDS "M117 Probe failed. Rewiping.\nG28\nG12 P0 S12 T0"
1416  #define G29_FAILURE_COMMANDS "M117 Bed leveling failed.\nG0 Z10\nM300 P25 S880\nM300 P50 S0\nM300 P25 S880\nM300 P50 S0\nM300 P25 S880\nM300 P50 S0\nG4 S1"
1417 
1418 #endif
1419 
1420 // @section extras
1421 
1422 //
1423 // G2/G3 Arc Support
1424 //
1425 #define ARC_SUPPORT // Disable this feature to save ~3226 bytes
1426 #if ENABLED(ARC_SUPPORT)
1427  #define MM_PER_ARC_SEGMENT 1 // Length of each arc segment
1428  #define MIN_ARC_SEGMENTS 24 // Minimum number of segments in a complete circle
1429  #define N_ARC_CORRECTION 25 // Number of interpolated segments between corrections
1430  //#define ARC_P_CIRCLES // Enable the 'P' parameter to specify complete circles
1431  //#define CNC_WORKSPACE_PLANES // Allow G2/G3 to operate in XY, ZX, or YZ planes
1432 #endif
1433 
1434 // Support for G5 with XYZE destination and IJPQ offsets. Requires ~2666 bytes.
1435 //#define BEZIER_CURVE_SUPPORT
1436 
1437 /**
1438  * G38 Probe Target
1439  *
1440  * This option adds G38.2 and G38.3 (probe towards target)
1441  * and optionally G38.4 and G38.5 (probe away from target).
1442  * Set MULTIPLE_PROBING for G38 to probe more than once.
1443  */
1444 //#define G38_PROBE_TARGET
1445 #if ENABLED(G38_PROBE_TARGET)
1446  //#define G38_PROBE_AWAY // Include G38.4 and G38.5 to probe away from target
1447  #define G38_MINIMUM_MOVE 0.0275 // (mm) Minimum distance that will produce a move.
1448 #endif
1449 
1450 // Moves (or segments) with fewer steps than this will be joined with the next move
1451 #define MIN_STEPS_PER_SEGMENT 6
1452 
1453 /**
1454  * Minimum delay before and after setting the stepper DIR (in ns)
1455  * 0 : No delay (Expect at least 10µS since one Stepper ISR must transpire)
1456  * 20 : Minimum for TMC2xxx drivers
1457  * 200 : Minimum for A4988 drivers
1458  * 400 : Minimum for A5984 drivers
1459  * 500 : Minimum for LV8729 drivers (guess, no info in datasheet)
1460  * 650 : Minimum for DRV8825 drivers
1461  * 1500 : Minimum for TB6600 drivers (guess, no info in datasheet)
1462  * 15000 : Minimum for TB6560 drivers (guess, no info in datasheet)
1463  *
1464  * Override the default value based on the driver type set in Configuration.h.
1465  */
1466 //#define MINIMUM_STEPPER_POST_DIR_DELAY 650
1467 //#define MINIMUM_STEPPER_PRE_DIR_DELAY 650
1468 
1469 /**
1470  * Minimum stepper driver pulse width (in µs)
1471  * 0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
1472  * 0 : Minimum 500ns for LV8729, adjusted in stepper.h
1473  * 1 : Minimum for A4988 and A5984 stepper drivers
1474  * 2 : Minimum for DRV8825 stepper drivers
1475  * 3 : Minimum for TB6600 stepper drivers
1476  * 30 : Minimum for TB6560 stepper drivers
1477  *
1478  * Override the default value based on the driver type set in Configuration.h.
1479  */
1480 //#define MINIMUM_STEPPER_PULSE 2
1481 
1482 /**
1483  * Maximum stepping rate (in Hz) the stepper driver allows
1484  * If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
1485  * 500000 : Maximum for A4988 stepper driver
1486  * 400000 : Maximum for TMC2xxx stepper drivers
1487  * 250000 : Maximum for DRV8825 stepper driver
1488  * 200000 : Maximum for LV8729 stepper driver
1489  * 150000 : Maximum for TB6600 stepper driver
1490  * 15000 : Maximum for TB6560 stepper driver
1491  *
1492  * Override the default value based on the driver type set in Configuration.h.
1493  */
1494 //#define MAXIMUM_STEPPER_RATE 250000
1495 
1496 // @section temperature
1497 
1498 // Control heater 0 and heater 1 in parallel.
1499 //#define HEATERS_PARALLEL
1500 
1501 //===========================================================================
1502 //================================= Buffers =================================
1503 //===========================================================================
1504 
1505 // @section hidden
1506 
1507 // The number of linear motions that can be in the plan at any give time.
1508 // THE BLOCK_BUFFER_SIZE NEEDS TO BE A POWER OF 2 (e.g. 8, 16, 32) because shifts and ors are used to do the ring-buffering.
1509 #if ENABLED(SDSUPPORT)
1510  #define BLOCK_BUFFER_SIZE 16 // SD,LCD,Buttons take more memory, block buffer needs to be smaller
1511 #else
1512  #define BLOCK_BUFFER_SIZE 16 // maximize block buffer
1513 #endif
1514 
1515 // @section serial
1516 
1517 // The ASCII buffer for serial input
1518 #define MAX_CMD_SIZE 96
1519 #define BUFSIZE 4
1520 
1521 // Transmission to Host Buffer Size
1522 // To save 386 bytes of PROGMEM (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
1523 // To buffer a simple "ok" you need 4 bytes.
1524 // For ADVANCED_OK (M105) you need 32 bytes.
1525 // For debug-echo: 128 bytes for the optimal speed.
1526 // Other output doesn't need to be that speedy.
1527 // :[0, 2, 4, 8, 16, 32, 64, 128, 256]
1528 #define TX_BUFFER_SIZE 0
1529 
1530 // Host Receive Buffer Size
1531 // Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
1532 // To use flow control, set this buffer size to at least 1024 bytes.
1533 // :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
1534 //#define RX_BUFFER_SIZE 1024
1535 
1536 #if RX_BUFFER_SIZE >= 1024
1537  // Enable to have the controller send XON/XOFF control characters to
1538  // the host to signal the RX buffer is becoming full.
1539  //#define SERIAL_XON_XOFF
1540 #endif
1541 
1542 // Add M575 G-code to change the baud rate
1543 //#define BAUD_RATE_GCODE
1544 
1545 #if ENABLED(SDSUPPORT)
1546  // Enable this option to collect and display the maximum
1547  // RX queue usage after transferring a file to SD.
1548  //#define SERIAL_STATS_MAX_RX_QUEUED
1549 
1550  // Enable this option to collect and display the number
1551  // of dropped bytes after a file transfer to SD.
1552  //#define SERIAL_STATS_DROPPED_RX
1553 #endif
1554 
1555 // Enable an emergency-command parser to intercept certain commands as they
1556 // enter the serial receive buffer, so they cannot be blocked.
1557 // Currently handles M108, M112, M410
1558 // Does not work on boards using AT90USB (USBCON) processors!
1559 //#define EMERGENCY_PARSER
1560 
1561 // Bad Serial-connections can miss a received command by sending an 'ok'
1562 // Therefore some clients abort after 30 seconds in a timeout.
1563 // Some other clients start sending commands while receiving a 'wait'.
1564 // This "wait" is only sent when the buffer is empty. 1 second is a good value here.
1565 //#define NO_TIMEOUTS 1000 // Milliseconds
1566 
1567 // Some clients will have this feature soon. This could make the NO_TIMEOUTS unnecessary.
1568 //#define ADVANCED_OK
1569 
1570 // Printrun may have trouble receiving long strings all at once.
1571 // This option inserts short delays between lines of serial output.
1572 #define SERIAL_OVERRUN_PROTECTION
1573 
1574 // @section extras
1575 
1576 /**
1577  * Extra Fan Speed
1578  * Adds a secondary fan speed for each print-cooling fan.
1579  * 'M106 P<fan> T3-255' : Set a secondary speed for <fan>
1580  * 'M106 P<fan> T2' : Use the set secondary speed
1581  * 'M106 P<fan> T1' : Restore the previous fan speed
1582  */
1583 //#define EXTRA_FAN_SPEED
1584 
1585 /**
1586  * Firmware-based and LCD-controlled retract
1587  *
1588  * Add G10 / G11 commands for automatic firmware-based retract / recover.
1589  * Use M207 and M208 to define parameters for retract / recover.
1590  *
1591  * Use M209 to enable or disable auto-retract.
1592  * With auto-retract enabled, all G1 E moves within the set range
1593  * will be converted to firmware-based retract/recover moves.
1594  *
1595  * Be sure to turn off auto-retract during filament change.
1596  *
1597  * Note that M207 / M208 / M209 settings are saved to EEPROM.
1598  *
1599  */
1600 //#define FWRETRACT
1601 #if ENABLED(FWRETRACT)
1602  #define FWRETRACT_AUTORETRACT // Override slicer retractions
1603  #if ENABLED(FWRETRACT_AUTORETRACT)
1604  #define MIN_AUTORETRACT 0.1 // (mm) Don't convert E moves under this length
1605  #define MAX_AUTORETRACT 10.0 // (mm) Don't convert E moves over this length
1606  #endif
1607  #define RETRACT_LENGTH 3 // (mm) Default retract length (positive value)
1608  #define RETRACT_LENGTH_SWAP 13 // (mm) Default swap retract length (positive value)
1609  #define RETRACT_FEEDRATE 45 // (mm/s) Default feedrate for retracting
1610  #define RETRACT_ZRAISE 0 // (mm) Default retract Z-raise
1611  #define RETRACT_RECOVER_LENGTH 0 // (mm) Default additional recover length (added to retract length on recover)
1612  #define RETRACT_RECOVER_LENGTH_SWAP 0 // (mm) Default additional swap recover length (added to retract length on recover from toolchange)
1613  #define RETRACT_RECOVER_FEEDRATE 8 // (mm/s) Default feedrate for recovering from retraction
1614  #define RETRACT_RECOVER_FEEDRATE_SWAP 8 // (mm/s) Default feedrate for recovering from swap retraction
1615  #if ENABLED(MIXING_EXTRUDER)
1616  //#define RETRACT_SYNC_MIXING // Retract and restore all mixing steppers simultaneously
1617  #endif
1618 #endif
1619 
1620 /**
1621  * Universal tool change settings.
1622  * Applies to all types of extruders except where explicitly noted.
1623  */
1624 #if EXTRUDERS > 1
1625  // Z raise distance for tool-change, as needed for some extruders
1626  #define TOOLCHANGE_ZRAISE 2 // (mm)
1627  //#define TOOLCHANGE_NO_RETURN // Never return to the previous position on tool-change
1628 
1629  // Retract and prime filament on tool-change
1630  //#define TOOLCHANGE_FILAMENT_SWAP
1631  #if ENABLED(TOOLCHANGE_FILAMENT_SWAP)
1632  #define TOOLCHANGE_FIL_SWAP_LENGTH 12 // (mm)
1633  #define TOOLCHANGE_FIL_EXTRA_PRIME 2 // (mm)
1634  #define TOOLCHANGE_FIL_SWAP_RETRACT_SPEED 3600 // (mm/m)
1635  #define TOOLCHANGE_FIL_SWAP_PRIME_SPEED 3600 // (mm/m)
1636  #endif
1637 
1638  /**
1639  * Position to park head during tool change.
1640  * Doesn't apply to SWITCHING_TOOLHEAD, DUAL_X_CARRIAGE, or PARKING_EXTRUDER
1641  */
1642  //#define TOOLCHANGE_PARK
1643  #if ENABLED(TOOLCHANGE_PARK)
1644  #define TOOLCHANGE_PARK_XY { X_MIN_POS + 10, Y_MIN_POS + 10 }
1645  #define TOOLCHANGE_PARK_XY_FEEDRATE 6000 // (mm/m)
1646  #endif
1647 #endif
1648 
1649 /**
1650  * Advanced Pause
1651  * Experimental feature for filament change support and for parking the nozzle when paused.
1652  * Adds the GCode M600 for initiating filament change.
1653  * If PARK_HEAD_ON_PAUSE enabled, adds the GCode M125 to pause printing and park the nozzle.
1654  *
1655  * Requires an LCD display.
1656  * Requires NOZZLE_PARK_FEATURE.
1657  * This feature is required for the default FILAMENT_RUNOUT_SCRIPT.
1658  */
1659 //#define ADVANCED_PAUSE_FEATURE
1660 #if ENABLED(ADVANCED_PAUSE_FEATURE)
1661  #define PAUSE_PARK_RETRACT_FEEDRATE 60 // (mm/s) Initial retract feedrate.
1662  #define PAUSE_PARK_RETRACT_LENGTH 2 // (mm) Initial retract.
1663  // This short retract is done immediately, before parking the nozzle.
1664  #define FILAMENT_CHANGE_UNLOAD_FEEDRATE 10 // (mm/s) Unload filament feedrate. This can be pretty fast.
1665  #define FILAMENT_CHANGE_UNLOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
1666  #define FILAMENT_CHANGE_UNLOAD_LENGTH 100 // (mm) The length of filament for a complete unload.
1667  // For Bowden, the full length of the tube and nozzle.
1668  // For direct drive, the full length of the nozzle.
1669  // Set to 0 for manual unloading.
1670  #define FILAMENT_CHANGE_SLOW_LOAD_FEEDRATE 6 // (mm/s) Slow move when starting load.
1671  #define FILAMENT_CHANGE_SLOW_LOAD_LENGTH 0 // (mm) Slow length, to allow time to insert material.
1672  // 0 to disable start loading and skip to fast load only
1673  #define FILAMENT_CHANGE_FAST_LOAD_FEEDRATE 6 // (mm/s) Load filament feedrate. This can be pretty fast.
1674  #define FILAMENT_CHANGE_FAST_LOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
1675  #define FILAMENT_CHANGE_FAST_LOAD_LENGTH 0 // (mm) Load length of filament, from extruder gear to nozzle.
1676  // For Bowden, the full length of the tube and nozzle.
1677  // For direct drive, the full length of the nozzle.
1678  //#define ADVANCED_PAUSE_CONTINUOUS_PURGE // Purge continuously up to the purge length until interrupted.
1679  #define ADVANCED_PAUSE_PURGE_FEEDRATE 3 // (mm/s) Extrude feedrate (after loading). Should be slower than load feedrate.
1680  #define ADVANCED_PAUSE_PURGE_LENGTH 50 // (mm) Length to extrude after loading.
1681  // Set to 0 for manual extrusion.
1682  // Filament can be extruded repeatedly from the Filament Change menu
1683  // until extrusion is consistent, and to purge old filament.
1684  #define ADVANCED_PAUSE_RESUME_PRIME 0 // (mm) Extra distance to prime nozzle after returning from park.
1685  //#define ADVANCED_PAUSE_FANS_PAUSE // Turn off print-cooling fans while the machine is paused.
1686 
1687  // Filament Unload does a Retract, Delay, and Purge first:
1688  #define FILAMENT_UNLOAD_RETRACT_LENGTH 13 // (mm) Unload initial retract length.
1689  #define FILAMENT_UNLOAD_DELAY 5000 // (ms) Delay for the filament to cool after retract.
1690  #define FILAMENT_UNLOAD_PURGE_LENGTH 8 // (mm) An unretract is done, then this length is purged.
1691 
1692  #define PAUSE_PARK_NOZZLE_TIMEOUT 45 // (seconds) Time limit before the nozzle is turned off for safety.
1693  #define FILAMENT_CHANGE_ALERT_BEEPS 10 // Number of alert beeps to play when a response is needed.
1694  #define PAUSE_PARK_NO_STEPPER_TIMEOUT // Enable for XYZ steppers to stay powered on during filament change.
1695 
1696  //#define PARK_HEAD_ON_PAUSE // Park the nozzle during pause and filament change.
1697  //#define HOME_BEFORE_FILAMENT_CHANGE // Ensure homing has been completed prior to parking for filament change
1698 
1699  //#define FILAMENT_LOAD_UNLOAD_GCODES // Add M701/M702 Load/Unload G-codes, plus Load/Unload in the LCD Prepare menu.
1700  //#define FILAMENT_UNLOAD_ALL_EXTRUDERS // Allow M702 to unload all extruders above a minimum target temp (as set by M302)
1701 #endif
1702 
1703 // @section tmc
1704 
1705 /**
1706  * TMC26X Stepper Driver options
1707  *
1708  * The TMC26XStepper library is required for this stepper driver.
1709  * https://github.com/trinamic/TMC26XStepper
1710  */
1711 #if HAS_DRIVER(TMC26X)
1712 
1713  #if AXIS_DRIVER_TYPE_X(TMC26X)
1714  #define X_MAX_CURRENT 1000 // (mA)
1715  #define X_SENSE_RESISTOR 91 // (mOhms)
1716  #define X_MICROSTEPS 16 // Number of microsteps
1717  #endif
1718 
1719  #if AXIS_DRIVER_TYPE_X2(TMC26X)
1720  #define X2_MAX_CURRENT 1000
1721  #define X2_SENSE_RESISTOR 91
1722  #define X2_MICROSTEPS 16
1723  #endif
1724 
1725  #if AXIS_DRIVER_TYPE_Y(TMC26X)
1726  #define Y_MAX_CURRENT 1000
1727  #define Y_SENSE_RESISTOR 91
1728  #define Y_MICROSTEPS 16
1729  #endif
1730 
1731  #if AXIS_DRIVER_TYPE_Y2(TMC26X)
1732  #define Y2_MAX_CURRENT 1000
1733  #define Y2_SENSE_RESISTOR 91
1734  #define Y2_MICROSTEPS 16
1735  #endif
1736 
1737  #if AXIS_DRIVER_TYPE_Z(TMC26X)
1738  #define Z_MAX_CURRENT 1000
1739  #define Z_SENSE_RESISTOR 91
1740  #define Z_MICROSTEPS 16
1741  #endif
1742 
1743  #if AXIS_DRIVER_TYPE_Z2(TMC26X)
1744  #define Z2_MAX_CURRENT 1000
1745  #define Z2_SENSE_RESISTOR 91
1746  #define Z2_MICROSTEPS 16
1747  #endif
1748 
1749  #if AXIS_DRIVER_TYPE_Z3(TMC26X)
1750  #define Z3_MAX_CURRENT 1000
1751  #define Z3_SENSE_RESISTOR 91
1752  #define Z3_MICROSTEPS 16
1753  #endif
1754 
1755  #if AXIS_DRIVER_TYPE_E0(TMC26X)
1756  #define E0_MAX_CURRENT 1000
1757  #define E0_SENSE_RESISTOR 91
1758  #define E0_MICROSTEPS 16
1759  #endif
1760 
1761  #if AXIS_DRIVER_TYPE_E1(TMC26X)
1762  #define E1_MAX_CURRENT 1000
1763  #define E1_SENSE_RESISTOR 91
1764  #define E1_MICROSTEPS 16
1765  #endif
1766 
1767  #if AXIS_DRIVER_TYPE_E2(TMC26X)
1768  #define E2_MAX_CURRENT 1000
1769  #define E2_SENSE_RESISTOR 91
1770  #define E2_MICROSTEPS 16
1771  #endif
1772 
1773  #if AXIS_DRIVER_TYPE_E3(TMC26X)
1774  #define E3_MAX_CURRENT 1000
1775  #define E3_SENSE_RESISTOR 91
1776  #define E3_MICROSTEPS 16
1777  #endif
1778 
1779  #if AXIS_DRIVER_TYPE_E4(TMC26X)
1780  #define E4_MAX_CURRENT 1000
1781  #define E4_SENSE_RESISTOR 91
1782  #define E4_MICROSTEPS 16
1783  #endif
1784 
1785  #if AXIS_DRIVER_TYPE_E5(TMC26X)
1786  #define E5_MAX_CURRENT 1000
1787  #define E5_SENSE_RESISTOR 91
1788  #define E5_MICROSTEPS 16
1789  #endif
1790 
1791 #endif // TMC26X
1792 
1793 // @section tmc_smart
1794 
1795 /**
1796  * To use TMC2130, TMC2160, TMC2660, TMC5130, TMC5160 stepper drivers in SPI mode
1797  * connect your SPI pins to the hardware SPI interface on your board and define
1798  * the required CS pins in your `pins_MYBOARD.h` file. (e.g., RAMPS 1.4 uses AUX3
1799  * pins `X_CS_PIN 53`, `Y_CS_PIN 49`, etc.).
1800  * You may also use software SPI if you wish to use general purpose IO pins.
1801  *
1802  * To use TMC2208 stepper UART-configurable stepper drivers connect #_SERIAL_TX_PIN
1803  * to the driver side PDN_UART pin with a 1K resistor.
1804  * To use the reading capabilities, also connect #_SERIAL_RX_PIN to PDN_UART without
1805  * a resistor.
1806  * The drivers can also be used with hardware serial.
1807  *
1808  * TMCStepper library is required to use TMC stepper drivers.
1809  * https://github.com/teemuatlut/TMCStepper
1810  */
1811 #if HAS_TRINAMIC
1812 
1813  #define HOLD_MULTIPLIER 0.5 // Scales down the holding current from run current
1814  #define INTERPOLATE true // Interpolate X/Y/Z_MICROSTEPS to 256
1815 
1816  #if AXIS_IS_TMC(X)
1817  #define X_CURRENT 800 // (mA) RMS current. Multiply by 1.414 for peak current.
1818  #define X_MICROSTEPS 16 // 0..256
1819  #define X_RSENSE 0.11
1820  #define X_CHAIN_POS -1 // <=0 : Not chained. 1 : MCU MOSI connected. 2 : Next in chain, ...
1821  #endif
1822 
1823  #if AXIS_IS_TMC(X2)
1824  #define X2_CURRENT 800
1825  #define X2_MICROSTEPS 16
1826  #define X2_RSENSE 0.11
1827  #define X2_CHAIN_POS -1
1828  #endif
1829 
1830  #if AXIS_IS_TMC(Y)
1831  #define Y_CURRENT 800
1832  #define Y_MICROSTEPS 16
1833  #define Y_RSENSE 0.11
1834  #define Y_CHAIN_POS -1
1835  #endif
1836 
1837  #if AXIS_IS_TMC(Y2)
1838  #define Y2_CURRENT 800
1839  #define Y2_MICROSTEPS 16
1840  #define Y2_RSENSE 0.11
1841  #define Y2_CHAIN_POS -1
1842  #endif
1843 
1844  #if AXIS_IS_TMC(Z)
1845  #define Z_CURRENT 800
1846  #define Z_MICROSTEPS 16
1847  #define Z_RSENSE 0.11
1848  #define Z_CHAIN_POS -1
1849  #endif
1850 
1851  #if AXIS_IS_TMC(Z2)
1852  #define Z2_CURRENT 800
1853  #define Z2_MICROSTEPS 16
1854  #define Z2_RSENSE 0.11
1855  #define Z2_CHAIN_POS -1
1856  #endif
1857 
1858  #if AXIS_IS_TMC(Z3)
1859  #define Z3_CURRENT 800
1860  #define Z3_MICROSTEPS 16
1861  #define Z3_RSENSE 0.11
1862  #define Z3_CHAIN_POS -1
1863  #endif
1864 
1865  #if AXIS_IS_TMC(E0)
1866  #define E0_CURRENT 800
1867  #define E0_MICROSTEPS 16
1868  #define E0_RSENSE 0.11
1869  #define E0_CHAIN_POS -1
1870  #endif
1871 
1872  #if AXIS_IS_TMC(E1)
1873  #define E1_CURRENT 800
1874  #define E1_MICROSTEPS 16
1875  #define E1_RSENSE 0.11
1876  #define E1_CHAIN_POS -1
1877  #endif
1878 
1879  #if AXIS_IS_TMC(E2)
1880  #define E2_CURRENT 800
1881  #define E2_MICROSTEPS 16
1882  #define E2_RSENSE 0.11
1883  #define E2_CHAIN_POS -1
1884  #endif
1885 
1886  #if AXIS_IS_TMC(E3)
1887  #define E3_CURRENT 800
1888  #define E3_MICROSTEPS 16
1889  #define E3_RSENSE 0.11
1890  #define E3_CHAIN_POS -1
1891  #endif
1892 
1893  #if AXIS_IS_TMC(E4)
1894  #define E4_CURRENT 800
1895  #define E4_MICROSTEPS 16
1896  #define E4_RSENSE 0.11
1897  #define E4_CHAIN_POS -1
1898  #endif
1899 
1900  #if AXIS_IS_TMC(E5)
1901  #define E5_CURRENT 800
1902  #define E5_MICROSTEPS 16
1903  #define E5_RSENSE 0.11
1904  #define E5_CHAIN_POS -1
1905  #endif
1906 
1907  /**
1908  * Override default SPI pins for TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160 drivers here.
1909  * The default pins can be found in your board's pins file.
1910  */
1911  //#define X_CS_PIN -1
1912  //#define Y_CS_PIN -1
1913  //#define Z_CS_PIN -1
1914  //#define X2_CS_PIN -1
1915  //#define Y2_CS_PIN -1
1916  //#define Z2_CS_PIN -1
1917  //#define Z3_CS_PIN -1
1918  //#define E0_CS_PIN -1
1919  //#define E1_CS_PIN -1
1920  //#define E2_CS_PIN -1
1921  //#define E3_CS_PIN -1
1922  //#define E4_CS_PIN -1
1923  //#define E5_CS_PIN -1
1924 
1925  /**
1926  * Software option for SPI driven drivers (TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160).
1927  * The default SW SPI pins are defined the respective pins files,
1928  * but you can override or define them here.
1929  */
1930  //#define TMC_USE_SW_SPI
1931  //#define TMC_SW_MOSI -1
1932  //#define TMC_SW_MISO -1
1933  //#define TMC_SW_SCK -1
1934 
1935  /**
1936  * Four TMC2209 drivers can use the same HW/SW serial port with hardware configured addresses.
1937  * Set the address using jumpers on pins MS1 and MS2.
1938  * Address | MS1 | MS2
1939  * 0 | LOW | LOW
1940  * 1 | HIGH | LOW
1941  * 2 | LOW | HIGH
1942  * 3 | HIGH | HIGH
1943  *
1944  * Set *_SERIAL_TX_PIN and *_SERIAL_RX_PIN to match for all drivers
1945  * on the same serial port, either here or in your board's pins file.
1946  */
1947  #define X_SLAVE_ADDRESS 0
1948  #define Y_SLAVE_ADDRESS 0
1949  #define Z_SLAVE_ADDRESS 0
1950  #define X2_SLAVE_ADDRESS 0
1951  #define Y2_SLAVE_ADDRESS 0
1952  #define Z2_SLAVE_ADDRESS 0
1953  #define Z3_SLAVE_ADDRESS 0
1954  #define E0_SLAVE_ADDRESS 0
1955  #define E1_SLAVE_ADDRESS 0
1956  #define E2_SLAVE_ADDRESS 0
1957  #define E3_SLAVE_ADDRESS 0
1958  #define E4_SLAVE_ADDRESS 0
1959  #define E5_SLAVE_ADDRESS 0
1960 
1961  /**
1962  * Software enable
1963  *
1964  * Use for drivers that do not use a dedicated enable pin, but rather handle the same
1965  * function through a communication line such as SPI or UART.
1966  */
1967  //#define SOFTWARE_DRIVER_ENABLE
1968 
1969  /**
1970  * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
1971  * Use Trinamic's ultra quiet stepping mode.
1972  * When disabled, Marlin will use spreadCycle stepping mode.
1973  */
1974  #define STEALTHCHOP_XY
1975  #define STEALTHCHOP_Z
1976  #define STEALTHCHOP_E
1977 
1978  /**
1979  * Optimize spreadCycle chopper parameters by using predefined parameter sets
1980  * or with the help of an example included in the library.
1981  * Provided parameter sets are
1982  * CHOPPER_DEFAULT_12V
1983  * CHOPPER_DEFAULT_19V
1984  * CHOPPER_DEFAULT_24V
1985  * CHOPPER_DEFAULT_36V
1986  * CHOPPER_PRUSAMK3_24V // Imported parameters from the official Prusa firmware for MK3 (24V)
1987  * CHOPPER_MARLIN_119 // Old defaults from Marlin v1.1.9
1988  *
1989  * Define you own with
1990  * { <off_time[1..15]>, <hysteresis_end[-3..12]>, hysteresis_start[1..8] }
1991  */
1992  #define CHOPPER_TIMING CHOPPER_DEFAULT_12V
1993 
1994  /**
1995  * Monitor Trinamic drivers for error conditions,
1996  * like overtemperature and short to ground.
1997  * In the case of overtemperature Marlin can decrease the driver current until error condition clears.
1998  * Other detected conditions can be used to stop the current print.
1999  * Relevant g-codes:
2000  * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given.
2001  * M911 - Report stepper driver overtemperature pre-warn condition.
2002  * M912 - Clear stepper driver overtemperature pre-warn condition flag.
2003  * M122 - Report driver parameters (Requires TMC_DEBUG)
2004  */
2005  //#define MONITOR_DRIVER_STATUS
2006 
2007  #if ENABLED(MONITOR_DRIVER_STATUS)
2008  #define CURRENT_STEP_DOWN 50 // [mA]
2009  #define REPORT_CURRENT_CHANGE
2010  #define STOP_ON_ERROR
2011  #endif
2012 
2013  /**
2014  * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
2015  * The driver will switch to spreadCycle when stepper speed is over HYBRID_THRESHOLD.
2016  * This mode allows for faster movements at the expense of higher noise levels.
2017  * STEALTHCHOP_(XY|Z|E) must be enabled to use HYBRID_THRESHOLD.
2018  * M913 X/Y/Z/E to live tune the setting
2019  */
2020  //#define HYBRID_THRESHOLD
2021 
2022  #define X_HYBRID_THRESHOLD 100 // [mm/s]
2023  #define X2_HYBRID_THRESHOLD 100
2024  #define Y_HYBRID_THRESHOLD 100
2025  #define Y2_HYBRID_THRESHOLD 100
2026  #define Z_HYBRID_THRESHOLD 3
2027  #define Z2_HYBRID_THRESHOLD 3
2028  #define Z3_HYBRID_THRESHOLD 3
2029  #define E0_HYBRID_THRESHOLD 30
2030  #define E1_HYBRID_THRESHOLD 30
2031  #define E2_HYBRID_THRESHOLD 30
2032  #define E3_HYBRID_THRESHOLD 30
2033  #define E4_HYBRID_THRESHOLD 30
2034  #define E5_HYBRID_THRESHOLD 30
2035 
2036  /**
2037  * Use StallGuard2 to home / probe X, Y, Z.
2038  *
2039  * TMC2130, TMC2160, TMC2209, TMC2660, TMC5130, and TMC5160 only
2040  * Connect the stepper driver's DIAG1 pin to the X/Y endstop pin.
2041  * X, Y, and Z homing will always be done in spreadCycle mode.
2042  *
2043  * X/Y/Z_STALL_SENSITIVITY is the default stall threshold.
2044  * Use M914 X Y Z to set the stall threshold at runtime:
2045  *
2046  * Sensitivity TMC2209 Others
2047  * HIGHEST 255 -64 (Too sensitive => False positive)
2048  * LOWEST 0 63 (Too insensitive => No trigger)
2049  *
2050  * It is recommended to set [XYZ]_HOME_BUMP_MM to 0.
2051  *
2052  * SPI_ENDSTOPS *** Beta feature! *** TMC2130 Only ***
2053  * Poll the driver through SPI to determine load when homing.
2054  * Removes the need for a wire from DIAG1 to an endstop pin.
2055  *
2056  * IMPROVE_HOMING_RELIABILITY tunes acceleration and jerk when
2057  * homing and adds a guard period for endstop triggering.
2058  */
2059  //#define SENSORLESS_HOMING // StallGuard capable drivers only
2060 
2061  /**
2062  * Use StallGuard2 to probe the bed with the nozzle.
2063  *
2064  * CAUTION: This could cause damage to machines that use a lead screw or threaded rod
2065  * to move the Z axis. Take extreme care when attempting to enable this feature.
2066  */
2067  //#define SENSORLESS_PROBING // StallGuard capable drivers only
2068 
2069  #if EITHER(SENSORLESS_HOMING, SENSORLESS_PROBING)
2070  // TMC2209: 0...255. TMC2130: -64...63
2071  #define X_STALL_SENSITIVITY 8
2072  #define X2_STALL_SENSITIVITY X_STALL_SENSITIVITY
2073  #define Y_STALL_SENSITIVITY 8
2074  //#define Z_STALL_SENSITIVITY 8
2075  //#define SPI_ENDSTOPS // TMC2130 only
2076  //#define IMPROVE_HOMING_RELIABILITY
2077  #endif
2078 
2079  /**
2080  * Beta feature!
2081  * Create a 50/50 square wave step pulse optimal for stepper drivers.
2082  */
2083  //#define SQUARE_WAVE_STEPPING
2084 
2085  /**
2086  * Enable M122 debugging command for TMC stepper drivers.
2087  * M122 S0/1 will enable continous reporting.
2088  */
2089  //#define TMC_DEBUG
2090 
2091  /**
2092  * You can set your own advanced settings by filling in predefined functions.
2093  * A list of available functions can be found on the library github page
2094  * https://github.com/teemuatlut/TMCStepper
2095  *
2096  * Example:
2097  * #define TMC_ADV() { \
2098  * stepperX.diag0_temp_prewarn(1); \
2099  * stepperY.interpolate(0); \
2100  * }
2101  */
2102  #define TMC_ADV() { }
2103 
2104 #endif // HAS_TRINAMIC
2105 
2106 // @section L6470
2107 
2108 /**
2109  * L6470 Stepper Driver options
2110  *
2111  * Arduino-L6470 library (0.7.0 or higher) is required for this stepper driver.
2112  * https://github.com/ameyer/Arduino-L6470
2113  *
2114  * Requires the following to be defined in your pins_YOUR_BOARD file
2115  * L6470_CHAIN_SCK_PIN
2116  * L6470_CHAIN_MISO_PIN
2117  * L6470_CHAIN_MOSI_PIN
2118  * L6470_CHAIN_SS_PIN
2119  * L6470_RESET_CHAIN_PIN (optional)
2120  */
2121 #if HAS_DRIVER(L6470)
2122 
2123  //#define L6470_CHITCHAT // Display additional status info
2124 
2125  #if AXIS_DRIVER_TYPE_X(L6470)
2126  #define X_MICROSTEPS 128 // Number of microsteps (VALID: 1, 2, 4, 8, 16, 32, 128)
2127  #define X_OVERCURRENT 2000 // (mA) Current where the driver detects an over current (VALID: 375 x (1 - 16) - 6A max - rounds down)
2128  #define X_STALLCURRENT 1500 // (mA) Current where the driver detects a stall (VALID: 31.25 * (1-128) - 4A max - rounds down)
2129  #define X_MAX_VOLTAGE 127 // 0-255, Maximum effective voltage seen by stepper
2130  #define X_CHAIN_POS -1 // Position in SPI chain. (<=0 : Not in chain. 1 : Nearest MOSI)
2131  #endif
2132 
2133  #if AXIS_DRIVER_TYPE_X2(L6470)
2134  #define X2_MICROSTEPS 128
2135  #define X2_OVERCURRENT 2000
2136  #define X2_STALLCURRENT 1500
2137  #define X2_MAX_VOLTAGE 127
2138  #define X2_CHAIN_POS -1
2139  #endif
2140 
2141  #if AXIS_DRIVER_TYPE_Y(L6470)
2142  #define Y_MICROSTEPS 128
2143  #define Y_OVERCURRENT 2000
2144  #define Y_STALLCURRENT 1500
2145  #define Y_MAX_VOLTAGE 127
2146  #define Y_CHAIN_POS -1
2147  #endif
2148 
2149  #if AXIS_DRIVER_TYPE_Y2(L6470)
2150  #define Y2_MICROSTEPS 128
2151  #define Y2_OVERCURRENT 2000
2152  #define Y2_STALLCURRENT 1500
2153  #define Y2_MAX_VOLTAGE 127
2154  #define Y2_CHAIN_POS -1
2155  #endif
2156 
2157  #if AXIS_DRIVER_TYPE_Z(L6470)
2158  #define Z_MICROSTEPS 128
2159  #define Z_OVERCURRENT 2000
2160  #define Z_STALLCURRENT 1500
2161  #define Z_MAX_VOLTAGE 127
2162  #define Z_CHAIN_POS -1
2163  #endif
2164 
2165  #if AXIS_DRIVER_TYPE_Z2(L6470)
2166  #define Z2_MICROSTEPS 128
2167  #define Z2_OVERCURRENT 2000
2168  #define Z2_STALLCURRENT 1500
2169  #define Z2_MAX_VOLTAGE 127
2170  #define Z2_CHAIN_POS -1
2171  #endif
2172 
2173  #if AXIS_DRIVER_TYPE_Z3(L6470)
2174  #define Z3_MICROSTEPS 128
2175  #define Z3_OVERCURRENT 2000
2176  #define Z3_STALLCURRENT 1500
2177  #define Z3_MAX_VOLTAGE 127
2178  #define Z3_CHAIN_POS -1
2179  #endif
2180 
2181  #if AXIS_DRIVER_TYPE_E0(L6470)
2182  #define E0_MICROSTEPS 128
2183  #define E0_OVERCURRENT 2000
2184  #define E0_STALLCURRENT 1500
2185  #define E0_MAX_VOLTAGE 127
2186  #define E0_CHAIN_POS -1
2187  #endif
2188 
2189  #if AXIS_DRIVER_TYPE_E1(L6470)
2190  #define E1_MICROSTEPS 128
2191  #define E1_OVERCURRENT 2000
2192  #define E1_STALLCURRENT 1500
2193  #define E1_MAX_VOLTAGE 127
2194  #define E1_CHAIN_POS -1
2195  #endif
2196 
2197  #if AXIS_DRIVER_TYPE_E2(L6470)
2198  #define E2_MICROSTEPS 128
2199  #define E2_OVERCURRENT 2000
2200  #define E2_STALLCURRENT 1500
2201  #define E2_MAX_VOLTAGE 127
2202  #define E2_CHAIN_POS -1
2203  #endif
2204 
2205  #if AXIS_DRIVER_TYPE_E3(L6470)
2206  #define E3_MICROSTEPS 128
2207  #define E3_OVERCURRENT 2000
2208  #define E3_STALLCURRENT 1500
2209  #define E3_MAX_VOLTAGE 127
2210  #define E3_CHAIN_POS -1
2211  #endif
2212 
2213  #if AXIS_DRIVER_TYPE_E4(L6470)
2214  #define E4_MICROSTEPS 128
2215  #define E4_OVERCURRENT 2000
2216  #define E4_STALLCURRENT 1500
2217  #define E4_MAX_VOLTAGE 127
2218  #define E4_CHAIN_POS -1
2219  #endif
2220 
2221  #if AXIS_DRIVER_TYPE_E5(L6470)
2222  #define E5_MICROSTEPS 128
2223  #define E5_OVERCURRENT 2000
2224  #define E5_STALLCURRENT 1500
2225  #define E5_MAX_VOLTAGE 127
2226  #define E5_CHAIN_POS -1
2227  #endif
2228 
2229  /**
2230  * Monitor L6470 drivers for error conditions like over temperature and over current.
2231  * In the case of over temperature Marlin can decrease the drive until the error condition clears.
2232  * Other detected conditions can be used to stop the current print.
2233  * Relevant g-codes:
2234  * M906 - I1/2/3/4/5 Set or get motor drive level using axis codes X, Y, Z, E. Report values if no axis codes given.
2235  * I not present or I0 or I1 - X, Y, Z or E0
2236  * I2 - X2, Y2, Z2 or E1
2237  * I3 - Z3 or E3
2238  * I4 - E4
2239  * I5 - E5
2240  * M916 - Increase drive level until get thermal warning
2241  * M917 - Find minimum current thresholds
2242  * M918 - Increase speed until max or error
2243  * M122 S0/1 - Report driver parameters
2244  */
2245  //#define MONITOR_L6470_DRIVER_STATUS
2246 
2247  #if ENABLED(MONITOR_L6470_DRIVER_STATUS)
2248  #define KVAL_HOLD_STEP_DOWN 1
2249  //#define L6470_STOP_ON_ERROR
2250  #endif
2251 
2252 #endif // L6470
2253 
2254 /**
2255  * TWI/I2C BUS
2256  *
2257  * This feature is an EXPERIMENTAL feature so it shall not be used on production
2258  * machines. Enabling this will allow you to send and receive I2C data from slave
2259  * devices on the bus.
2260  *
2261  * ; Example #1
2262  * ; This macro send the string "Marlin" to the slave device with address 0x63 (99)
2263  * ; It uses multiple M260 commands with one B<base 10> arg
2264  * M260 A99 ; Target slave address
2265  * M260 B77 ; M
2266  * M260 B97 ; a
2267  * M260 B114 ; r
2268  * M260 B108 ; l
2269  * M260 B105 ; i
2270  * M260 B110 ; n
2271  * M260 S1 ; Send the current buffer
2272  *
2273  * ; Example #2
2274  * ; Request 6 bytes from slave device with address 0x63 (99)
2275  * M261 A99 B5
2276  *
2277  * ; Example #3
2278  * ; Example serial output of a M261 request
2279  * echo:i2c-reply: from:99 bytes:5 data:hello
2280  */
2281 
2282 // @section i2cbus
2283 
2284 //#define EXPERIMENTAL_I2CBUS
2285 #define I2C_SLAVE_ADDRESS 0 // Set a value from 8 to 127 to act as a slave
2286 
2287 // @section extras
2288 
2289 /**
2290  * Photo G-code
2291  * Add the M240 G-code to take a photo.
2292  * The photo can be triggered by a digital pin or a physical movement.
2293  */
2294 //#define PHOTO_GCODE
2295 #if ENABLED(PHOTO_GCODE)
2296  // A position to move to (and raise Z) before taking the photo
2297  //#define PHOTO_POSITION { X_MAX_POS - 5, Y_MAX_POS, 0 } // { xpos, ypos, zraise } (M240 X Y Z)
2298  //#define PHOTO_DELAY_MS 100 // (ms) Duration to pause before moving back (M240 P)
2299  //#define PHOTO_RETRACT_MM 6.5 // (mm) E retract/recover for the photo move (M240 R S)
2300 
2301  // Canon RC-1 or homebrew digital camera trigger
2302  // Data from: http://www.doc-diy.net/photo/rc-1_hacked/
2303  //#define PHOTOGRAPH_PIN 23
2304 
2305  // Canon Hack Development Kit
2306  // http://captain-slow.dk/2014/03/09/3d-printing-timelapses/
2307  //#define CHDK_PIN 4
2308 
2309  // Optional second move with delay to trigger the camera shutter
2310  //#define PHOTO_SWITCH_POSITION { X_MAX_POS, Y_MAX_POS } // { xpos, ypos } (M240 I J)
2311 
2312  // Duration to hold the switch or keep CHDK_PIN high
2313  //#define PHOTO_SWITCH_MS 50 // (ms) (M240 D)
2314 #endif
2315 
2316 /**
2317  * Spindle & Laser control
2318  *
2319  * Add the M3, M4, and M5 commands to turn the spindle/laser on and off, and
2320  * to set spindle speed, spindle direction, and laser power.
2321  *
2322  * SuperPid is a router/spindle speed controller used in the CNC milling community.
2323  * Marlin can be used to turn the spindle on and off. It can also be used to set
2324  * the spindle speed from 5,000 to 30,000 RPM.
2325  *
2326  * You'll need to select a pin for the ON/OFF function and optionally choose a 0-5V
2327  * hardware PWM pin for the speed control and a pin for the rotation direction.
2328  *
2329  * See http://marlinfw.org/docs/configuration/laser_spindle.html for more config details.
2330  */
2331 //#define SPINDLE_FEATURE
2332 //#define LASER_FEATURE
2333 #if EITHER(SPINDLE_FEATURE, LASER_FEATURE)
2334  #define SPINDLE_LASER_ACTIVE_HIGH false // Set to "true" if the on/off function is active HIGH
2335  #define SPINDLE_LASER_PWM true // Set to "true" if your controller supports setting the speed/power
2336  #define SPINDLE_LASER_PWM_INVERT true // Set to "true" if the speed/power goes up when you want it to go slower
2337  #define SPINDLE_LASER_POWERUP_DELAY 5000 // (ms) Delay to allow the spindle/laser to come up to speed/power
2338  #define SPINDLE_LASER_POWERDOWN_DELAY 5000 // (ms) Delay to allow the spindle to stop
2339 
2340  #if ENABLED(SPINDLE_FEATURE)
2341  //#define SPINDLE_CHANGE_DIR // Enable if your spindle controller can change spindle direction
2342  #define SPINDLE_CHANGE_DIR_STOP // Enable if the spindle should stop before changing spin direction
2343  #define SPINDLE_INVERT_DIR false // Set to "true" if the spin direction is reversed
2344 
2345  /**
2346  * The M3 & M4 commands use the following equation to convert PWM duty cycle to speed/power
2347  *
2348  * SPEED/POWER = PWM duty cycle * SPEED_POWER_SLOPE + SPEED_POWER_INTERCEPT
2349  * where PWM duty cycle varies from 0 to 255
2350  *
2351  * set the following for your controller (ALL MUST BE SET)
2352  */
2353  #define SPEED_POWER_SLOPE 118.4
2354  #define SPEED_POWER_INTERCEPT 0
2355  #define SPEED_POWER_MIN 5000
2356  #define SPEED_POWER_MAX 30000 // SuperPID router controller 0 - 30,000 RPM
2357  #else
2358  #define SPEED_POWER_SLOPE 0.3922
2359  #define SPEED_POWER_INTERCEPT 0
2360  #define SPEED_POWER_MIN 10
2361  #define SPEED_POWER_MAX 100 // 0-100%
2362  #endif
2363 #endif
2364 
2365 /**
2366  * Coolant Control
2367  *
2368  * Add the M7, M8, and M9 commands to turn mist or flood coolant on and off.
2369  *
2370  * Note: COOLANT_MIST_PIN and/or COOLANT_FLOOD_PIN must also be defined.
2371  */
2372 //#define COOLANT_CONTROL
2373 #if ENABLED(COOLANT_CONTROL)
2374  #define COOLANT_MIST // Enable if mist coolant is present
2375  #define COOLANT_FLOOD // Enable if flood coolant is present
2376  #define COOLANT_MIST_INVERT false // Set "true" if the on/off function is reversed
2377  #define COOLANT_FLOOD_INVERT false // Set "true" if the on/off function is reversed
2378 #endif
2379 
2380 /**
2381  * Filament Width Sensor
2382  *
2383  * Measures the filament width in real-time and adjusts
2384  * flow rate to compensate for any irregularities.
2385  *
2386  * Also allows the measured filament diameter to set the
2387  * extrusion rate, so the slicer only has to specify the
2388  * volume.
2389  *
2390  * Only a single extruder is supported at this time.
2391  *
2392  * 34 RAMPS_14 : Analog input 5 on the AUX2 connector
2393  * 81 PRINTRBOARD : Analog input 2 on the Exp1 connector (version B,C,D,E)
2394  * 301 RAMBO : Analog input 3
2395  *
2396  * Note: May require analog pins to be defined for other boards.
2397  */
2398 //#define FILAMENT_WIDTH_SENSOR
2399 
2400 #if ENABLED(FILAMENT_WIDTH_SENSOR)
2401  #define FILAMENT_SENSOR_EXTRUDER_NUM 0 // Index of the extruder that has the filament sensor. :[0,1,2,3,4]
2402  #define MEASUREMENT_DELAY_CM 14 // (cm) The distance from the filament sensor to the melting chamber
2403 
2404  #define FILWIDTH_ERROR_MARGIN 1.0 // (mm) If a measurement differs too much from nominal width ignore it
2405  #define MAX_MEASUREMENT_DELAY 20 // (bytes) Buffer size for stored measurements (1 byte per cm). Must be larger than MEASUREMENT_DELAY_CM.
2406 
2407  #define DEFAULT_MEASURED_FILAMENT_DIA DEFAULT_NOMINAL_FILAMENT_DIA // Set measured to nominal initially
2408 
2409  // Display filament width on the LCD status line. Status messages will expire after 5 seconds.
2410  //#define FILAMENT_LCD_DISPLAY
2411 #endif
2412 
2413 /**
2414  * CNC Coordinate Systems
2415  *
2416  * Enables G53 and G54-G59.3 commands to select coordinate systems
2417  * and G92.1 to reset the workspace to native machine space.
2418  */
2419 //#define CNC_COORDINATE_SYSTEMS
2420 
2421 /**
2422  * Auto-report temperatures with M155 S<seconds>
2423  */
2424 #define AUTO_REPORT_TEMPERATURES
2425 
2426 /**
2427  * Include capabilities in M115 output
2428  */
2429 #define EXTENDED_CAPABILITIES_REPORT
2430 
2431 /**
2432  * Expected Printer Check
2433  * Add the M16 G-code to compare a string to the MACHINE_NAME.
2434  * M16 with a non-matching string causes the printer to halt.
2435  */
2436 //#define EXPECTED_PRINTER_CHECK
2437 
2438 /**
2439  * Disable all Volumetric extrusion options
2440  */
2441 //#define NO_VOLUMETRICS
2442 
2443 #if DISABLED(NO_VOLUMETRICS)
2444  /**
2445  * Volumetric extrusion default state
2446  * Activate to make volumetric extrusion the default method,
2447  * with DEFAULT_NOMINAL_FILAMENT_DIA as the default diameter.
2448  *
2449  * M200 D0 to disable, M200 Dn to set a new diameter.
2450  */
2451  //#define VOLUMETRIC_DEFAULT_ON
2452 #endif
2453 
2454 /**
2455  * Enable this option for a leaner build of Marlin that removes all
2456  * workspace offsets, simplifying coordinate transformations, leveling, etc.
2457  *
2458  * - M206 and M428 are disabled.
2459  * - G92 will revert to its behavior from Marlin 1.0.
2460  */
2461 //#define NO_WORKSPACE_OFFSETS
2462 
2463 /**
2464  * Set the number of proportional font spaces required to fill up a typical character space.
2465  * This can help to better align the output of commands like `G29 O` Mesh Output.
2466  *
2467  * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
2468  * Otherwise, adjust according to your client and font.
2469  */
2470 #define PROPORTIONAL_FONT_RATIO 1.0
2471 
2472 /**
2473  * Spend 28 bytes of SRAM to optimize the GCode parser
2474  */
2475 #define FASTER_GCODE_PARSER
2476 
2477 /**
2478  * CNC G-code options
2479  * Support CNC-style G-code dialects used by laser cutters, drawing machine cams, etc.
2480  * Note that G0 feedrates should be used with care for 3D printing (if used at all).
2481  * High feedrates may cause ringing and harm print quality.
2482  */
2483 //#define PAREN_COMMENTS // Support for parentheses-delimited comments
2484 //#define GCODE_MOTION_MODES // Remember the motion mode (G0 G1 G2 G3 G5 G38.X) and apply for X Y Z E F, etc.
2485 
2486 // Enable and set a (default) feedrate for all G0 moves
2487 //#define G0_FEEDRATE 3000 // (mm/m)
2488 #ifdef G0_FEEDRATE
2489  //#define VARIABLE_G0_FEEDRATE // The G0 feedrate is set by F in G0 motion mode
2490 #endif
2491 
2492 /**
2493  * Startup commands
2494  *
2495  * Execute certain G-code commands immediately after power-on.
2496  */
2497 //#define STARTUP_COMMANDS "M17 Z"
2498 
2499 /**
2500  * G-code Macros
2501  *
2502  * Add G-codes M810-M819 to define and run G-code macros.
2503  * Macros are not saved to EEPROM.
2504  */
2505 //#define GCODE_MACROS
2506 #if ENABLED(GCODE_MACROS)
2507  #define GCODE_MACROS_SLOTS 5 // Up to 10 may be used
2508  #define GCODE_MACROS_SLOT_SIZE 50 // Maximum length of a single macro
2509 #endif
2510 
2511 /**
2512  * User-defined menu items that execute custom GCode
2513  */
2514 //#define CUSTOM_USER_MENUS
2515 #if ENABLED(CUSTOM_USER_MENUS)
2516  //#define CUSTOM_USER_MENU_TITLE "Custom Commands"
2517  #define USER_SCRIPT_DONE "M117 User Script Done"
2518  #define USER_SCRIPT_AUDIBLE_FEEDBACK
2519  //#define USER_SCRIPT_RETURN // Return to status screen after a script
2520 
2521  #define USER_DESC_1 "Home & UBL Info"
2522  #define USER_GCODE_1 "G28\nG29 W"
2523 
2524  #define USER_DESC_2 "Preheat for " PREHEAT_1_LABEL
2525  #define USER_GCODE_2 "M140 S" STRINGIFY(PREHEAT_1_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_1_TEMP_HOTEND)
2526 
2527  #define USER_DESC_3 "Preheat for " PREHEAT_2_LABEL
2528  #define USER_GCODE_3 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_2_TEMP_HOTEND)
2529 
2530  #define USER_DESC_4 "Heat Bed/Home/Level"
2531  #define USER_GCODE_4 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nG28\nG29"
2532 
2533  #define USER_DESC_5 "Home & Info"
2534  #define USER_GCODE_5 "G28\nM503"
2535 #endif
2536 
2537 /**
2538  * Host Action Commands
2539  *
2540  * Define host streamer action commands in compliance with the standard.
2541  *
2542  * See https://reprap.org/wiki/G-code#Action_commands
2543  * Common commands ........ poweroff, pause, paused, resume, resumed, cancel
2544  * G29_RETRY_AND_RECOVER .. probe_rewipe, probe_failed
2545  *
2546  * Some features add reason codes to extend these commands.
2547  *
2548  * Host Prompt Support enables Marlin to use the host for user prompts so
2549  * filament runout and other processes can be managed from the host side.
2550  */
2551 //#define HOST_ACTION_COMMANDS
2552 #if ENABLED(HOST_ACTION_COMMANDS)
2553  //#define HOST_PROMPT_SUPPORT
2554 #endif
2555 
2556 /**
2557  * I2C position encoders for closed loop control.
2558  * Developed by Chris Barr at Aus3D.
2559  *
2560  * Wiki: http://wiki.aus3d.com.au/Magnetic_Encoder
2561  * Github: https://github.com/Aus3D/MagneticEncoder
2562  *
2563  * Supplier: http://aus3d.com.au/magnetic-encoder-module
2564  * Alternative Supplier: http://reliabuild3d.com/
2565  *
2566  * Reliabuild encoders have been modified to improve reliability.
2567  */
2568 
2569 //#define I2C_POSITION_ENCODERS
2570 #if ENABLED(I2C_POSITION_ENCODERS)
2571 
2572  #define I2CPE_ENCODER_CNT 1 // The number of encoders installed; max of 5
2573  // encoders supported currently.
2574 
2575  #define I2CPE_ENC_1_ADDR I2CPE_PRESET_ADDR_X // I2C address of the encoder. 30-200.
2576  #define I2CPE_ENC_1_AXIS X_AXIS // Axis the encoder module is installed on. <X|Y|Z|E>_AXIS.
2577  #define I2CPE_ENC_1_TYPE I2CPE_ENC_TYPE_LINEAR // Type of encoder: I2CPE_ENC_TYPE_LINEAR -or-
2578  // I2CPE_ENC_TYPE_ROTARY.
2579  #define I2CPE_ENC_1_TICKS_UNIT 2048 // 1024 for magnetic strips with 2mm poles; 2048 for
2580  // 1mm poles. For linear encoders this is ticks / mm,
2581  // for rotary encoders this is ticks / revolution.
2582  //#define I2CPE_ENC_1_TICKS_REV (16 * 200) // Only needed for rotary encoders; number of stepper
2583  // steps per full revolution (motor steps/rev * microstepping)
2584  //#define I2CPE_ENC_1_INVERT // Invert the direction of axis travel.
2585  #define I2CPE_ENC_1_EC_METHOD I2CPE_ECM_MICROSTEP // Type of error error correction.
2586  #define I2CPE_ENC_1_EC_THRESH 0.10 // Threshold size for error (in mm) above which the
2587  // printer will attempt to correct the error; errors
2588  // smaller than this are ignored to minimize effects of
2589  // measurement noise / latency (filter).
2590 
2591  #define I2CPE_ENC_2_ADDR I2CPE_PRESET_ADDR_Y // Same as above, but for encoder 2.
2592  #define I2CPE_ENC_2_AXIS Y_AXIS
2593  #define I2CPE_ENC_2_TYPE I2CPE_ENC_TYPE_LINEAR
2594  #define I2CPE_ENC_2_TICKS_UNIT 2048
2595  //#define I2CPE_ENC_2_TICKS_REV (16 * 200)
2596  //#define I2CPE_ENC_2_INVERT
2597  #define I2CPE_ENC_2_EC_METHOD I2CPE_ECM_MICROSTEP
2598  #define I2CPE_ENC_2_EC_THRESH 0.10
2599 
2600  #define I2CPE_ENC_3_ADDR I2CPE_PRESET_ADDR_Z // Encoder 3. Add additional configuration options
2601  #define I2CPE_ENC_3_AXIS Z_AXIS // as above, or use defaults below.
2602 
2603  #define I2CPE_ENC_4_ADDR I2CPE_PRESET_ADDR_E // Encoder 4.
2604  #define I2CPE_ENC_4_AXIS E_AXIS
2605 
2606  #define I2CPE_ENC_5_ADDR 34 // Encoder 5.
2607  #define I2CPE_ENC_5_AXIS E_AXIS
2608 
2609  // Default settings for encoders which are enabled, but without settings configured above.
2610  #define I2CPE_DEF_TYPE I2CPE_ENC_TYPE_LINEAR
2611  #define I2CPE_DEF_ENC_TICKS_UNIT 2048
2612  #define I2CPE_DEF_TICKS_REV (16 * 200)
2613  #define I2CPE_DEF_EC_METHOD I2CPE_ECM_NONE
2614  #define I2CPE_DEF_EC_THRESH 0.1
2615 
2616  //#define I2CPE_ERR_THRESH_ABORT 100.0 // Threshold size for error (in mm) error on any given
2617  // axis after which the printer will abort. Comment out to
2618  // disable abort behavior.
2619 
2620  #define I2CPE_TIME_TRUSTED 10000 // After an encoder fault, there must be no further fault
2621  // for this amount of time (in ms) before the encoder
2622  // is trusted again.
2623 
2624  /**
2625  * Position is checked every time a new command is executed from the buffer but during long moves,
2626  * this setting determines the minimum update time between checks. A value of 100 works well with
2627  * error rolling average when attempting to correct only for skips and not for vibration.
2628  */
2629  #define I2CPE_MIN_UPD_TIME_MS 4 // (ms) Minimum time between encoder checks.
2630 
2631  // Use a rolling average to identify persistant errors that indicate skips, as opposed to vibration and noise.
2632  #define I2CPE_ERR_ROLLING_AVERAGE
2633 
2634 #endif // I2C_POSITION_ENCODERS
2635 
2636 /**
2637  * Analog Joystick(s)
2638  */
2639 //#define JOYSTICK
2640 #if ENABLED(JOYSTICK)
2641  #define JOY_X_PIN 5 // RAMPS: Suggested pin A5 on AUX2
2642  #define JOY_Y_PIN 10 // RAMPS: Suggested pin A10 on AUX2
2643  #define JOY_Z_PIN 12 // RAMPS: Suggested pin A12 on AUX2
2644  #define JOY_EN_PIN 44 // RAMPS: Suggested pin D44 on AUX2
2645 
2646  // Use M119 to find reasonable values after connecting your hardware:
2647  #define JOY_X_LIMITS { 5600, 8190-100, 8190+100, 10800 } // min, deadzone start, deadzone end, max
2648  #define JOY_Y_LIMITS { 5600, 8250-100, 8250+100, 11000 }
2649  #define JOY_Z_LIMITS { 4800, 8080-100, 8080+100, 11550 }
2650 #endif
2651 
2652 /**
2653  * MAX7219 Debug Matrix
2654  *
2655  * Add support for a low-cost 8x8 LED Matrix based on the Max7219 chip as a realtime status display.
2656  * Requires 3 signal wires. Some useful debug options are included to demonstrate its usage.
2657  */
2658 //#define MAX7219_DEBUG
2659 #if ENABLED(MAX7219_DEBUG)
2660  #define MAX7219_CLK_PIN 64
2661  #define MAX7219_DIN_PIN 57
2662  #define MAX7219_LOAD_PIN 44
2663 
2664  //#define MAX7219_GCODE // Add the M7219 G-code to control the LED matrix
2665  #define MAX7219_INIT_TEST 2 // Do a test pattern at initialization (Set to 2 for spiral)
2666  #define MAX7219_NUMBER_UNITS 1 // Number of Max7219 units in chain.
2667  #define MAX7219_ROTATE 0 // Rotate the display clockwise (in multiples of +/- 90°)
2668  // connector at: right=0 bottom=-90 top=90 left=180
2669  //#define MAX7219_REVERSE_ORDER // The individual LED matrix units may be in reversed order
2670  //#define MAX7219_SIDE_BY_SIDE // Big chip+matrix boards can be chained side-by-side
2671 
2672  /**
2673  * Sample debug features
2674  * If you add more debug displays, be careful to avoid conflicts!
2675  */
2676  #define MAX7219_DEBUG_PRINTER_ALIVE // Blink corner LED of 8x8 matrix to show that the firmware is functioning
2677  #define MAX7219_DEBUG_PLANNER_HEAD 3 // Show the planner queue head position on this and the next LED matrix row
2678  #define MAX7219_DEBUG_PLANNER_TAIL 5 // Show the planner queue tail position on this and the next LED matrix row
2679 
2680  #define MAX7219_DEBUG_PLANNER_QUEUE 0 // Show the current planner queue depth on this and the next LED matrix row
2681  // If you experience stuttering, reboots, etc. this option can reveal how
2682  // tweaks made to the configuration are affecting the printer in real-time.
2683 #endif
2684 
2685 /**
2686  * NanoDLP Sync support
2687  *
2688  * Add support for Synchronized Z moves when using with NanoDLP. G0/G1 axis moves will output "Z_move_comp"
2689  * string to enable synchronization with DLP projector exposure. This change will allow to use
2690  * [[WaitForDoneMessage]] instead of populating your gcode with M400 commands
2691  */
2692 //#define NANODLP_Z_SYNC
2693 #if ENABLED(NANODLP_Z_SYNC)
2694  //#define NANODLP_ALL_AXIS // Enables "Z_move_comp" output on any axis move.
2695  // Default behavior is limited to Z axis only.
2696 #endif
2697 
2698 /**
2699  * WiFi Support (Espressif ESP32 WiFi)
2700  */
2701 //#define WIFISUPPORT
2702 #if ENABLED(WIFISUPPORT)
2703  #define WIFI_SSID "Wifi SSID"
2704  #define WIFI_PWD "Wifi Password"
2705  //#define WEBSUPPORT // Start a webserver with auto-discovery
2706  //#define OTASUPPORT // Support over-the-air firmware updates
2707 #endif
2708 
2709 /**
2710  * Prusa Multi-Material Unit v2
2711  * Enable in Configuration.h
2712  */
2713 #if ENABLED(PRUSA_MMU2)
2714 
2715  // Serial port used for communication with MMU2.
2716  // For AVR enable the UART port used for the MMU. (e.g., internalSerial)
2717  // For 32-bit boards check your HAL for available serial ports. (e.g., Serial2)
2718  #define INTERNAL_SERIAL_PORT 2
2719  #define MMU2_SERIAL internalSerial
2720 
2721  // Use hardware reset for MMU if a pin is defined for it
2722  //#define MMU2_RST_PIN 23
2723 
2724  // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
2725  //#define MMU2_MODE_12V
2726 
2727  // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
2728  #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
2729 
2730  // Add an LCD menu for MMU2
2731  //#define MMU2_MENUS
2732  #if ENABLED(MMU2_MENUS)
2733  // Settings for filament load / unload from the LCD menu.
2734  // This is for Prusa MK3-style extruders. Customize for your hardware.
2735  #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
2736  #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
2737  { 7.2, 562 }, \
2738  { 14.4, 871 }, \
2739  { 36.0, 1393 }, \
2740  { 14.4, 871 }, \
2741  { 50.0, 198 }
2742 
2743  #define MMU2_RAMMING_SEQUENCE \
2744  { 1.0, 1000 }, \
2745  { 1.0, 1500 }, \
2746  { 2.0, 2000 }, \
2747  { 1.5, 3000 }, \
2748  { 2.5, 4000 }, \
2749  { -15.0, 5000 }, \
2750  { -14.0, 1200 }, \
2751  { -6.0, 600 }, \
2752  { 10.0, 700 }, \
2753  { -10.0, 400 }, \
2754  { -50.0, 2000 }
2755 
2756  #endif
2757 
2758  //#define MMU2_DEBUG // Write debug info to serial output
2759 
2760 #endif // PRUSA_MMU2
2761 
2762 /**
2763  * Advanced Print Counter settings
2764  */
2765 #if ENABLED(PRINTCOUNTER)
2766  #define SERVICE_WARNING_BUZZES 3
2767  // Activate up to 3 service interval watchdogs
2768  //#define SERVICE_NAME_1 "Service S"
2769  //#define SERVICE_INTERVAL_1 100 // print hours
2770  //#define SERVICE_NAME_2 "Service L"
2771  //#define SERVICE_INTERVAL_2 200 // print hours
2772  //#define SERVICE_NAME_3 "Service 3"
2773  //#define SERVICE_INTERVAL_3 1 // print hours
2774 #endif
2775 
2776 // @section develop
2777 
2778 /**
2779  * M43 - display pin status, watch pins for changes, watch endstops & toggle LED, Z servo probe test, toggle pins
2780  */
2781 //#define PINS_DEBUGGING
2782 
2783 // Enable Marlin dev mode which adds some special commands
2784 //#define MARLIN_DEV_MODE