MMU2 as standard serial device (#20771)
[Marlin.git] / Marlin / Configuration_adv.h
blob0e2545700dc3d5dfa659bbe4517931156af00d5f
1 /**
2 * Marlin 3D Printer Firmware
3 * Copyright (c) 2020 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
5 * Based on Sprinter and grbl.
6 * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
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.
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.
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 #pragma once
24 /**
25 * Configuration_adv.h
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!
31 * Basic settings can be found in Configuration.h
33 #define CONFIGURATION_ADV_H_VERSION 020008
35 //===========================================================================
36 //============================= Thermal Settings ============================
37 //===========================================================================
38 // @section temperature
40 /**
41 * Thermocouple sensors are quite sensitive to noise. Any noise induced in
42 * the sensor wires, such as by stepper motor wires run in parallel to them,
43 * may result in the thermocouple sensor reporting spurious errors. This
44 * value is the number of errors which can occur in a row before the error
45 * is reported. This allows us to ignore intermittent error conditions while
46 * still detecting an actual failure, which should result in a continuous
47 * stream of errors from the sensor.
49 * Set this value to 0 to fail on the first error to occur.
51 #define THERMOCOUPLE_MAX_ERRORS 15
54 // Custom Thermistor 1000 parameters
56 #if TEMP_SENSOR_0 == 1000
57 #define HOTEND0_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
58 #define HOTEND0_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
59 #define HOTEND0_BETA 3950 // Beta value
60 #endif
62 #if TEMP_SENSOR_1 == 1000
63 #define HOTEND1_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
64 #define HOTEND1_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
65 #define HOTEND1_BETA 3950 // Beta value
66 #endif
68 #if TEMP_SENSOR_2 == 1000
69 #define HOTEND2_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
70 #define HOTEND2_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
71 #define HOTEND2_BETA 3950 // Beta value
72 #endif
74 #if TEMP_SENSOR_3 == 1000
75 #define HOTEND3_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
76 #define HOTEND3_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
77 #define HOTEND3_BETA 3950 // Beta value
78 #endif
80 #if TEMP_SENSOR_4 == 1000
81 #define HOTEND4_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
82 #define HOTEND4_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
83 #define HOTEND4_BETA 3950 // Beta value
84 #endif
86 #if TEMP_SENSOR_5 == 1000
87 #define HOTEND5_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
88 #define HOTEND5_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
89 #define HOTEND5_BETA 3950 // Beta value
90 #endif
92 #if TEMP_SENSOR_6 == 1000
93 #define HOTEND6_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
94 #define HOTEND6_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
95 #define HOTEND6_BETA 3950 // Beta value
96 #endif
98 #if TEMP_SENSOR_7 == 1000
99 #define HOTEND7_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
100 #define HOTEND7_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
101 #define HOTEND7_BETA 3950 // Beta value
102 #endif
104 #if TEMP_SENSOR_BED == 1000
105 #define BED_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
106 #define BED_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
107 #define BED_BETA 3950 // Beta value
108 #endif
110 #if TEMP_SENSOR_CHAMBER == 1000
111 #define CHAMBER_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
112 #define CHAMBER_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
113 #define CHAMBER_BETA 3950 // Beta value
114 #endif
117 // Hephestos 2 24V heated bed upgrade kit.
118 // https://store.bq.com/en/heated-bed-kit-hephestos2
120 //#define HEPHESTOS2_HEATED_BED_KIT
121 #if ENABLED(HEPHESTOS2_HEATED_BED_KIT)
122 #undef TEMP_SENSOR_BED
123 #define TEMP_SENSOR_BED 70
124 #define HEATER_BED_INVERTING true
125 #endif
128 // Heated Bed Bang-Bang options
130 #if DISABLED(PIDTEMPBED)
131 #define BED_CHECK_INTERVAL 5000 // (ms) Interval between checks in bang-bang control
132 #if ENABLED(BED_LIMIT_SWITCHING)
133 #define BED_HYSTERESIS 2 // (°C) Only set the relevant heater state when ABS(T-target) > BED_HYSTERESIS
134 #endif
135 #endif
138 // Heated Chamber options
140 #if TEMP_SENSOR_CHAMBER
141 #define CHAMBER_MINTEMP 5
142 #define CHAMBER_MAXTEMP 60
143 #define TEMP_CHAMBER_HYSTERESIS 1 // (°C) Temperature proximity considered "close enough" to the target
144 //#define CHAMBER_LIMIT_SWITCHING
145 //#define HEATER_CHAMBER_PIN 44 // Chamber heater on/off pin
146 //#define HEATER_CHAMBER_INVERTING false
148 //#define CHAMBER_FAN // Enable a fan on the chamber
149 #if ENABLED(CHAMBER_FAN)
150 #define CHAMBER_FAN_MODE 2 // Fan control mode: 0=Static; 1=Linear increase when temp is higher than target; 2=V-shaped curve.
151 #if CHAMBER_FAN_MODE == 0
152 #define CHAMBER_FAN_BASE 255 // Chamber fan PWM (0-255)
153 #elif CHAMBER_FAN_MODE == 1
154 #define CHAMBER_FAN_BASE 128 // Base chamber fan PWM (0-255); turns on when chamber temperature is above the target
155 #define CHAMBER_FAN_FACTOR 25 // PWM increase per °C above target
156 #elif CHAMBER_FAN_MODE == 2
157 #define CHAMBER_FAN_BASE 128 // Minimum chamber fan PWM (0-255)
158 #define CHAMBER_FAN_FACTOR 25 // PWM increase per °C difference from target
159 #endif
160 #endif
162 //#define CHAMBER_VENT // Enable a servo-controlled vent on the chamber
163 #if ENABLED(CHAMBER_VENT)
164 #define CHAMBER_VENT_SERVO_NR 1 // Index of the vent servo
165 #define HIGH_EXCESS_HEAT_LIMIT 5 // How much above target temp to consider there is excess heat in the chamber
166 #define LOW_EXCESS_HEAT_LIMIT 3
167 #define MIN_COOLING_SLOPE_TIME_CHAMBER_VENT 20
168 #define MIN_COOLING_SLOPE_DEG_CHAMBER_VENT 1.5
169 #endif
170 #endif
173 * Thermal Protection provides additional protection to your printer from damage
174 * and fire. Marlin always includes safe min and max temperature ranges which
175 * protect against a broken or disconnected thermistor wire.
177 * The issue: If a thermistor falls out, it will report the much lower
178 * temperature of the air in the room, and the the firmware will keep
179 * the heater on.
181 * The solution: Once the temperature reaches the target, start observing.
182 * If the temperature stays too far below the target (hysteresis) for too
183 * long (period), the firmware will halt the machine as a safety precaution.
185 * If you get false positives for "Thermal Runaway", increase
186 * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
188 #if ENABLED(THERMAL_PROTECTION_HOTENDS)
189 #define THERMAL_PROTECTION_PERIOD 40 // Seconds
190 #define THERMAL_PROTECTION_HYSTERESIS 4 // Degrees Celsius
192 //#define ADAPTIVE_FAN_SLOWING // Slow part cooling fan if temperature drops
193 #if BOTH(ADAPTIVE_FAN_SLOWING, PIDTEMP)
194 //#define NO_FAN_SLOWING_IN_PID_TUNING // Don't slow fan speed during M303
195 #endif
198 * Whenever an M104, M109, or M303 increases the target temperature, the
199 * firmware will wait for the WATCH_TEMP_PERIOD to expire. If the temperature
200 * hasn't increased by WATCH_TEMP_INCREASE degrees, the machine is halted and
201 * requires a hard reset. This test restarts with any M104/M109/M303, but only
202 * if the current temperature is far enough below the target for a reliable
203 * test.
205 * If you get false positives for "Heating failed", increase WATCH_TEMP_PERIOD
206 * and/or decrease WATCH_TEMP_INCREASE. WATCH_TEMP_INCREASE should not be set
207 * below 2.
209 #define WATCH_TEMP_PERIOD 20 // Seconds
210 #define WATCH_TEMP_INCREASE 2 // Degrees Celsius
211 #endif
214 * Thermal Protection parameters for the bed are just as above for hotends.
216 #if ENABLED(THERMAL_PROTECTION_BED)
217 #define THERMAL_PROTECTION_BED_PERIOD 20 // Seconds
218 #define THERMAL_PROTECTION_BED_HYSTERESIS 2 // Degrees Celsius
221 * As described above, except for the bed (M140/M190/M303).
223 #define WATCH_BED_TEMP_PERIOD 60 // Seconds
224 #define WATCH_BED_TEMP_INCREASE 2 // Degrees Celsius
225 #endif
228 * Thermal Protection parameters for the heated chamber.
230 #if ENABLED(THERMAL_PROTECTION_CHAMBER)
231 #define THERMAL_PROTECTION_CHAMBER_PERIOD 20 // Seconds
232 #define THERMAL_PROTECTION_CHAMBER_HYSTERESIS 2 // Degrees Celsius
235 * Heated chamber watch settings (M141/M191).
237 #define WATCH_CHAMBER_TEMP_PERIOD 60 // Seconds
238 #define WATCH_CHAMBER_TEMP_INCREASE 2 // Degrees Celsius
239 #endif
241 #if ENABLED(PIDTEMP)
242 // Add an experimental additional term to the heater power, proportional to the extrusion speed.
243 // A well-chosen Kc value should add just enough power to melt the increased material volume.
244 //#define PID_EXTRUSION_SCALING
245 #if ENABLED(PID_EXTRUSION_SCALING)
246 #define DEFAULT_Kc (100) // heating power = Kc * e_speed
247 #define LPQ_MAX_LEN 50
248 #endif
251 * Add an experimental additional term to the heater power, proportional to the fan speed.
252 * A well-chosen Kf value should add just enough power to compensate for power-loss from the cooling fan.
253 * You can either just add a constant compensation with the DEFAULT_Kf value
254 * or follow the instruction below to get speed-dependent compensation.
256 * Constant compensation (use only with fanspeeds of 0% and 100%)
257 * ---------------------------------------------------------------------
258 * A good starting point for the Kf-value comes from the calculation:
259 * kf = (power_fan * eff_fan) / power_heater * 255
260 * where eff_fan is between 0.0 and 1.0, based on fan-efficiency and airflow to the nozzle / heater.
262 * Example:
263 * Heater: 40W, Fan: 0.1A * 24V = 2.4W, eff_fan = 0.8
264 * Kf = (2.4W * 0.8) / 40W * 255 = 12.24
266 * Fan-speed dependent compensation
267 * --------------------------------
268 * 1. To find a good Kf value, set the hotend temperature, wait for it to settle, and enable the fan (100%).
269 * Make sure PID_FAN_SCALING_LIN_FACTOR is 0 and PID_FAN_SCALING_ALTERNATIVE_DEFINITION is not enabled.
270 * If you see the temperature drop repeat the test, increasing the Kf value slowly, until the temperature
271 * drop goes away. If the temperature overshoots after enabling the fan, the Kf value is too big.
272 * 2. Note the Kf-value for fan-speed at 100%
273 * 3. Determine a good value for PID_FAN_SCALING_MIN_SPEED, which is around the speed, where the fan starts moving.
274 * 4. Repeat step 1. and 2. for this fan speed.
275 * 5. Enable PID_FAN_SCALING_ALTERNATIVE_DEFINITION and enter the two identified Kf-values in
276 * PID_FAN_SCALING_AT_FULL_SPEED and PID_FAN_SCALING_AT_MIN_SPEED. Enter the minimum speed in PID_FAN_SCALING_MIN_SPEED
278 //#define PID_FAN_SCALING
279 #if ENABLED(PID_FAN_SCALING)
280 //#define PID_FAN_SCALING_ALTERNATIVE_DEFINITION
281 #if ENABLED(PID_FAN_SCALING_ALTERNATIVE_DEFINITION)
282 // The alternative definition is used for an easier configuration.
283 // Just figure out Kf at fullspeed (255) and PID_FAN_SCALING_MIN_SPEED.
284 // DEFAULT_Kf and PID_FAN_SCALING_LIN_FACTOR are calculated accordingly.
286 #define PID_FAN_SCALING_AT_FULL_SPEED 13.0 //=PID_FAN_SCALING_LIN_FACTOR*255+DEFAULT_Kf
287 #define PID_FAN_SCALING_AT_MIN_SPEED 6.0 //=PID_FAN_SCALING_LIN_FACTOR*PID_FAN_SCALING_MIN_SPEED+DEFAULT_Kf
288 #define PID_FAN_SCALING_MIN_SPEED 10.0 // Minimum fan speed at which to enable PID_FAN_SCALING
290 #define DEFAULT_Kf (255.0*PID_FAN_SCALING_AT_MIN_SPEED-PID_FAN_SCALING_AT_FULL_SPEED*PID_FAN_SCALING_MIN_SPEED)/(255.0-PID_FAN_SCALING_MIN_SPEED)
291 #define PID_FAN_SCALING_LIN_FACTOR (PID_FAN_SCALING_AT_FULL_SPEED-DEFAULT_Kf)/255.0
293 #else
294 #define PID_FAN_SCALING_LIN_FACTOR (0) // Power loss due to cooling = Kf * (fan_speed)
295 #define DEFAULT_Kf 10 // A constant value added to the PID-tuner
296 #define PID_FAN_SCALING_MIN_SPEED 10 // Minimum fan speed at which to enable PID_FAN_SCALING
297 #endif
298 #endif
299 #endif
302 * Automatic Temperature Mode
304 * Dynamically adjust the hotend target temperature based on planned E moves.
306 * (Contrast with PID_EXTRUSION_SCALING, which tracks E movement and adjusts PID
307 * behavior using an additional kC value.)
309 * Autotemp is calculated by (mintemp + factor * mm_per_sec), capped to maxtemp.
311 * Enable Autotemp Mode with M104/M109 F<factor> S<mintemp> B<maxtemp>.
312 * Disable by sending M104/M109 with no F parameter (or F0 with AUTOTEMP_PROPORTIONAL).
314 #define AUTOTEMP
315 #if ENABLED(AUTOTEMP)
316 #define AUTOTEMP_OLDWEIGHT 0.98
317 // Turn on AUTOTEMP on M104/M109 by default using proportions set here
318 //#define AUTOTEMP_PROPORTIONAL
319 #if ENABLED(AUTOTEMP_PROPORTIONAL)
320 #define AUTOTEMP_MIN_P 0 // (°C) Added to the target temperature
321 #define AUTOTEMP_MAX_P 5 // (°C) Added to the target temperature
322 #define AUTOTEMP_FACTOR_P 1 // Apply this F parameter by default (overridden by M104/M109 F)
323 #endif
324 #endif
326 // Show Temperature ADC value
327 // Enable for M105 to include ADC values read from temperature sensors.
328 //#define SHOW_TEMP_ADC_VALUES
331 * High Temperature Thermistor Support
333 * Thermistors able to support high temperature tend to have a hard time getting
334 * good readings at room and lower temperatures. This means HEATER_X_RAW_LO_TEMP
335 * will probably be caught when the heating element first turns on during the
336 * preheating process, which will trigger a min_temp_error as a safety measure
337 * and force stop everything.
338 * To circumvent this limitation, we allow for a preheat time (during which,
339 * min_temp_error won't be triggered) and add a min_temp buffer to handle
340 * aberrant readings.
342 * If you want to enable this feature for your hotend thermistor(s)
343 * uncomment and set values > 0 in the constants below
346 // The number of consecutive low temperature errors that can occur
347 // before a min_temp_error is triggered. (Shouldn't be more than 10.)
348 //#define MAX_CONSECUTIVE_LOW_TEMPERATURE_ERROR_ALLOWED 0
350 // The number of milliseconds a hotend will preheat before starting to check
351 // the temperature. This value should NOT be set to the time it takes the
352 // hot end to reach the target temperature, but the time it takes to reach
353 // the minimum temperature your thermistor can read. The lower the better/safer.
354 // This shouldn't need to be more than 30 seconds (30000)
355 //#define MILLISECONDS_PREHEAT_TIME 0
357 // @section extruder
359 // Extruder runout prevention.
360 // If the machine is idle and the temperature over MINTEMP
361 // then extrude some filament every couple of SECONDS.
362 //#define EXTRUDER_RUNOUT_PREVENT
363 #if ENABLED(EXTRUDER_RUNOUT_PREVENT)
364 #define EXTRUDER_RUNOUT_MINTEMP 190
365 #define EXTRUDER_RUNOUT_SECONDS 30
366 #define EXTRUDER_RUNOUT_SPEED 1500 // (mm/min)
367 #define EXTRUDER_RUNOUT_EXTRUDE 5 // (mm)
368 #endif
371 * Hotend Idle Timeout
372 * Prevent filament in the nozzle from charring and causing a critical jam.
374 //#define HOTEND_IDLE_TIMEOUT
375 #if ENABLED(HOTEND_IDLE_TIMEOUT)
376 #define HOTEND_IDLE_TIMEOUT_SEC (5*60) // (seconds) Time without extruder movement to trigger protection
377 #define HOTEND_IDLE_MIN_TRIGGER 180 // (°C) Minimum temperature to enable hotend protection
378 #define HOTEND_IDLE_NOZZLE_TARGET 0 // (°C) Safe temperature for the nozzle after timeout
379 #define HOTEND_IDLE_BED_TARGET 0 // (°C) Safe temperature for the bed after timeout
380 #endif
382 // @section temperature
384 // Calibration for AD595 / AD8495 sensor to adjust temperature measurements.
385 // The final temperature is calculated as (measuredTemp * GAIN) + OFFSET.
386 #define TEMP_SENSOR_AD595_OFFSET 0.0
387 #define TEMP_SENSOR_AD595_GAIN 1.0
388 #define TEMP_SENSOR_AD8495_OFFSET 0.0
389 #define TEMP_SENSOR_AD8495_GAIN 1.0
392 * Controller Fan
393 * To cool down the stepper drivers and MOSFETs.
395 * The fan turns on automatically whenever any driver is enabled and turns
396 * off (or reduces to idle speed) shortly after drivers are turned off.
398 //#define USE_CONTROLLER_FAN
399 #if ENABLED(USE_CONTROLLER_FAN)
400 //#define CONTROLLER_FAN_PIN -1 // Set a custom pin for the controller fan
401 //#define CONTROLLER_FAN_USE_Z_ONLY // With this option only the Z axis is considered
402 //#define CONTROLLER_FAN_IGNORE_Z // Ignore Z stepper. Useful when stepper timeout is disabled.
403 #define CONTROLLERFAN_SPEED_MIN 0 // (0-255) Minimum speed. (If set below this value the fan is turned off.)
404 #define CONTROLLERFAN_SPEED_ACTIVE 255 // (0-255) Active speed, used when any motor is enabled
405 #define CONTROLLERFAN_SPEED_IDLE 0 // (0-255) Idle speed, used when motors are disabled
406 #define CONTROLLERFAN_IDLE_TIME 60 // (seconds) Extra time to keep the fan running after disabling motors
407 //#define CONTROLLER_FAN_EDITABLE // Enable M710 configurable settings
408 #if ENABLED(CONTROLLER_FAN_EDITABLE)
409 #define CONTROLLER_FAN_MENU // Enable the Controller Fan submenu
410 #endif
411 #endif
413 // When first starting the main fan, run it at full speed for the
414 // given number of milliseconds. This gets the fan spinning reliably
415 // before setting a PWM value. (Does not work with software PWM for fan on Sanguinololu)
416 //#define FAN_KICKSTART_TIME 100
418 // Some coolers may require a non-zero "off" state.
419 //#define FAN_OFF_PWM 1
422 * PWM Fan Scaling
424 * Define the min/max speeds for PWM fans (as set with M106).
426 * With these options the M106 0-255 value range is scaled to a subset
427 * to ensure that the fan has enough power to spin, or to run lower
428 * current fans with higher current. (e.g., 5V/12V fans with 12V/24V)
429 * Value 0 always turns off the fan.
431 * Define one or both of these to override the default 0-255 range.
433 //#define FAN_MIN_PWM 50
434 //#define FAN_MAX_PWM 128
437 * FAST PWM FAN Settings
439 * Use to change the FAST FAN PWM frequency (if enabled in Configuration.h)
440 * Combinations of PWM Modes, prescale values and TOP resolutions are used internally to produce a
441 * frequency as close as possible to the desired frequency.
443 * FAST_PWM_FAN_FREQUENCY [undefined by default]
444 * Set this to your desired frequency.
445 * If left undefined this defaults to F = F_CPU/(2*255*1)
446 * i.e., F = 31.4kHz on 16MHz microcontrollers or F = 39.2kHz on 20MHz microcontrollers.
447 * These defaults are the same as with the old FAST_PWM_FAN implementation - no migration is required
448 * NOTE: Setting very low frequencies (< 10 Hz) may result in unexpected timer behavior.
450 * USE_OCR2A_AS_TOP [undefined by default]
451 * Boards that use TIMER2 for PWM have limitations resulting in only a few possible frequencies on TIMER2:
452 * 16MHz MCUs: [62.5KHz, 31.4KHz (default), 7.8KHz, 3.92KHz, 1.95KHz, 977Hz, 488Hz, 244Hz, 60Hz, 122Hz, 30Hz]
453 * 20MHz MCUs: [78.1KHz, 39.2KHz (default), 9.77KHz, 4.9KHz, 2.44KHz, 1.22KHz, 610Hz, 305Hz, 153Hz, 76Hz, 38Hz]
454 * A greater range can be achieved by enabling USE_OCR2A_AS_TOP. But note that this option blocks the use of
455 * PWM on pin OC2A. Only use this option if you don't need PWM on 0C2A. (Check your schematic.)
456 * USE_OCR2A_AS_TOP sacrifices duty cycle control resolution to achieve this broader range of frequencies.
458 #if ENABLED(FAST_PWM_FAN)
459 //#define FAST_PWM_FAN_FREQUENCY 31400
460 //#define USE_OCR2A_AS_TOP
461 #endif
463 // @section extruder
466 * Extruder cooling fans
468 * Extruder auto fans automatically turn on when their extruders'
469 * temperatures go above EXTRUDER_AUTO_FAN_TEMPERATURE.
471 * Your board's pins file specifies the recommended pins. Override those here
472 * or set to -1 to disable completely.
474 * Multiple extruders can be assigned to the same pin in which case
475 * the fan will turn on when any selected extruder is above the threshold.
477 #define E0_AUTO_FAN_PIN -1
478 #define E1_AUTO_FAN_PIN -1
479 #define E2_AUTO_FAN_PIN -1
480 #define E3_AUTO_FAN_PIN -1
481 #define E4_AUTO_FAN_PIN -1
482 #define E5_AUTO_FAN_PIN -1
483 #define E6_AUTO_FAN_PIN -1
484 #define E7_AUTO_FAN_PIN -1
485 #define CHAMBER_AUTO_FAN_PIN -1
487 #define EXTRUDER_AUTO_FAN_TEMPERATURE 50
488 #define EXTRUDER_AUTO_FAN_SPEED 255 // 255 == full speed
489 #define CHAMBER_AUTO_FAN_TEMPERATURE 30
490 #define CHAMBER_AUTO_FAN_SPEED 255
493 * Part-Cooling Fan Multiplexer
495 * This feature allows you to digitally multiplex the fan output.
496 * The multiplexer is automatically switched at tool-change.
497 * Set FANMUX[012]_PINs below for up to 2, 4, or 8 multiplexed fans.
499 #define FANMUX0_PIN -1
500 #define FANMUX1_PIN -1
501 #define FANMUX2_PIN -1
504 * M355 Case Light on-off / brightness
506 //#define CASE_LIGHT_ENABLE
507 #if ENABLED(CASE_LIGHT_ENABLE)
508 //#define CASE_LIGHT_PIN 4 // Override the default pin if needed
509 #define INVERT_CASE_LIGHT false // Set true if Case Light is ON when pin is LOW
510 #define CASE_LIGHT_DEFAULT_ON true // Set default power-up state on
511 #define CASE_LIGHT_DEFAULT_BRIGHTNESS 105 // Set default power-up brightness (0-255, requires PWM pin)
512 //#define CASE_LIGHT_MAX_PWM 128 // Limit pwm
513 //#define CASE_LIGHT_MENU // Add Case Light options to the LCD menu
514 //#define CASE_LIGHT_NO_BRIGHTNESS // Disable brightness control. Enable for non-PWM lighting.
515 //#define CASE_LIGHT_USE_NEOPIXEL // Use NeoPixel LED as case light, requires NEOPIXEL_LED.
516 #if ENABLED(CASE_LIGHT_USE_NEOPIXEL)
517 #define CASE_LIGHT_NEOPIXEL_COLOR { 255, 255, 255, 255 } // { Red, Green, Blue, White }
518 #endif
519 #endif
521 // @section homing
523 // If you want endstops to stay on (by default) even when not homing
524 // enable this option. Override at any time with M120, M121.
525 //#define ENDSTOPS_ALWAYS_ON_DEFAULT
527 // @section extras
529 //#define Z_LATE_ENABLE // Enable Z the last moment. Needed if your Z driver overheats.
531 // Employ an external closed loop controller. Override pins here if needed.
532 //#define EXTERNAL_CLOSED_LOOP_CONTROLLER
533 #if ENABLED(EXTERNAL_CLOSED_LOOP_CONTROLLER)
534 //#define CLOSED_LOOP_ENABLE_PIN -1
535 //#define CLOSED_LOOP_MOVE_COMPLETE_PIN -1
536 #endif
539 * Dual Steppers / Dual Endstops
541 * This section will allow you to use extra E drivers to drive a second motor for X, Y, or Z axes.
543 * For example, set X_DUAL_STEPPER_DRIVERS setting to use a second motor. If the motors need to
544 * spin in opposite directions set INVERT_X2_VS_X_DIR. If the second motor needs its own endstop
545 * set X_DUAL_ENDSTOPS. This can adjust for "racking." Use X2_USE_ENDSTOP to set the endstop plug
546 * that should be used for the second endstop. Extra endstops will appear in the output of 'M119'.
548 * Use X_DUAL_ENDSTOP_ADJUSTMENT to adjust for mechanical imperfection. After homing both motors
549 * this offset is applied to the X2 motor. To find the offset home the X axis, and measure the error
550 * in X2. Dual endstop offsets can be set at runtime with 'M666 X<offset> Y<offset> Z<offset>'.
553 //#define X_DUAL_STEPPER_DRIVERS
554 #if ENABLED(X_DUAL_STEPPER_DRIVERS)
555 //#define INVERT_X2_VS_X_DIR // Enable if X2 direction signal is opposite to X
556 //#define X_DUAL_ENDSTOPS
557 #if ENABLED(X_DUAL_ENDSTOPS)
558 #define X2_USE_ENDSTOP _XMAX_
559 #define X2_ENDSTOP_ADJUSTMENT 0
560 #endif
561 #endif
563 //#define Y_DUAL_STEPPER_DRIVERS
564 #if ENABLED(Y_DUAL_STEPPER_DRIVERS)
565 //#define INVERT_Y2_VS_Y_DIR // Enable if Y2 direction signal is opposite to Y
566 //#define Y_DUAL_ENDSTOPS
567 #if ENABLED(Y_DUAL_ENDSTOPS)
568 #define Y2_USE_ENDSTOP _YMAX_
569 #define Y2_ENDSTOP_ADJUSTMENT 0
570 #endif
571 #endif
574 // For Z set the number of stepper drivers
576 #define NUM_Z_STEPPER_DRIVERS 1 // (1-4) Z options change based on how many
578 #if NUM_Z_STEPPER_DRIVERS > 1
579 // Enable if Z motor direction signals are the opposite of Z1
580 //#define INVERT_Z2_VS_Z_DIR
581 //#define INVERT_Z3_VS_Z_DIR
582 //#define INVERT_Z4_VS_Z_DIR
584 //#define Z_MULTI_ENDSTOPS
585 #if ENABLED(Z_MULTI_ENDSTOPS)
586 #define Z2_USE_ENDSTOP _XMAX_
587 #define Z2_ENDSTOP_ADJUSTMENT 0
588 #if NUM_Z_STEPPER_DRIVERS >= 3
589 #define Z3_USE_ENDSTOP _YMAX_
590 #define Z3_ENDSTOP_ADJUSTMENT 0
591 #endif
592 #if NUM_Z_STEPPER_DRIVERS >= 4
593 #define Z4_USE_ENDSTOP _ZMAX_
594 #define Z4_ENDSTOP_ADJUSTMENT 0
595 #endif
596 #endif
597 #endif
600 * Dual X Carriage
602 * This setup has two X carriages that can move independently, each with its own hotend.
603 * The carriages can be used to print an object with two colors or materials, or in
604 * "duplication mode" it can print two identical or X-mirrored objects simultaneously.
605 * The inactive carriage is parked automatically to prevent oozing.
606 * X1 is the left carriage, X2 the right. They park and home at opposite ends of the X axis.
607 * By default the X2 stepper is assigned to the first unused E plug on the board.
609 * The following Dual X Carriage modes can be selected with M605 S<mode>:
611 * 0 : (FULL_CONTROL) The slicer has full control over both X-carriages and can achieve optimal travel
612 * results as long as it supports dual X-carriages. (M605 S0)
614 * 1 : (AUTO_PARK) The firmware automatically parks and unparks the X-carriages on tool-change so
615 * that additional slicer support is not required. (M605 S1)
617 * 2 : (DUPLICATION) The firmware moves the second X-carriage and extruder in synchronization with
618 * the first X-carriage and extruder, to print 2 copies of the same object at the same time.
619 * Set the constant X-offset and temperature differential with M605 S2 X[offs] R[deg] and
620 * follow with M605 S2 to initiate duplicated movement.
622 * 3 : (MIRRORED) Formbot/Vivedino-inspired mirrored mode in which the second extruder duplicates
623 * the movement of the first except the second extruder is reversed in the X axis.
624 * Set the initial X offset and temperature differential with M605 S2 X[offs] R[deg] and
625 * follow with M605 S3 to initiate mirrored movement.
627 //#define DUAL_X_CARRIAGE
628 #if ENABLED(DUAL_X_CARRIAGE)
629 #define X1_MIN_POS X_MIN_POS // Set to X_MIN_POS
630 #define X1_MAX_POS X_BED_SIZE // Set a maximum so the first X-carriage can't hit the parked second X-carriage
631 #define X2_MIN_POS 80 // Set a minimum to ensure the second X-carriage can't hit the parked first X-carriage
632 #define X2_MAX_POS 353 // Set this to the distance between toolheads when both heads are homed
633 #define X2_HOME_DIR 1 // Set to 1. The second X-carriage always homes to the maximum endstop position
634 #define X2_HOME_POS X2_MAX_POS // Default X2 home position. Set to X2_MAX_POS.
635 // However: In this mode the HOTEND_OFFSET_X value for the second extruder provides a software
636 // override for X2_HOME_POS. This also allow recalibration of the distance between the two endstops
637 // without modifying the firmware (through the "M218 T1 X???" command).
638 // Remember: you should set the second extruder x-offset to 0 in your slicer.
640 // This is the default power-up mode which can be later using M605.
641 #define DEFAULT_DUAL_X_CARRIAGE_MODE DXC_AUTO_PARK_MODE
643 // Default x offset in duplication mode (typically set to half print bed width)
644 #define DEFAULT_DUPLICATION_X_OFFSET 100
646 // Default action to execute following M605 mode change commands. Typically G28X to apply new mode.
647 //#define EVENT_GCODE_IDEX_AFTER_MODECHANGE "G28X"
648 #endif
650 // Activate a solenoid on the active extruder with M380. Disable all with M381.
651 // Define SOL0_PIN, SOL1_PIN, etc., for each extruder that has a solenoid.
652 //#define EXT_SOLENOID
654 // @section homing
657 * Homing Procedure
658 * Homing (G28) does an indefinite move towards the endstops to establish
659 * the position of the toolhead relative to the workspace.
662 //#define SENSORLESS_BACKOFF_MM { 2, 2 } // (mm) Backoff from endstops before sensorless homing
664 #define HOMING_BUMP_MM { 5, 5, 2 } // (mm) Backoff from endstops after first bump
665 #define HOMING_BUMP_DIVISOR { 2, 2, 4 } // Re-Bump Speed Divisor (Divides the Homing Feedrate)
667 //#define HOMING_BACKOFF_POST_MM { 2, 2, 2 } // (mm) Backoff from endstops after homing
669 //#define QUICK_HOME // If G28 contains XY do a diagonal move first
670 //#define HOME_Y_BEFORE_X // If G28 contains XY home Y before X
671 //#define HOME_Z_FIRST // Home Z first. Requires a Z-MIN endstop (not a probe).
672 //#define CODEPENDENT_XY_HOMING // If X/Y can't home without homing Y/X first
674 // @section bltouch
676 #if ENABLED(BLTOUCH)
678 * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
679 * Do not activate settings that the probe might not understand. Clones might misunderstand
680 * advanced commands.
682 * Note: If the probe is not deploying, do a "Reset" and "Self-Test" and then check the
683 * wiring of the BROWN, RED and ORANGE wires.
685 * Note: If the trigger signal of your probe is not being recognized, it has been very often
686 * because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
687 * like they would be with a real switch. So please check the wiring first.
689 * Settings for all BLTouch and clone probes:
692 // Safety: The probe needs time to recognize the command.
693 // Minimum command delay (ms). Enable and increase if needed.
694 //#define BLTOUCH_DELAY 500
697 * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
700 // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
701 // in special cases, like noisy or filtered input configurations.
702 //#define BLTOUCH_FORCE_SW_MODE
705 * Settings for BLTouch Smart 3.0 and 3.1
706 * Summary:
707 * - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
708 * - High-Speed mode
709 * - Disable LCD voltage options
713 * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
714 * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
715 * If disabled, OD mode is the hard-coded default on 3.0
716 * On startup, Marlin will compare its eeprom to this value. If the selected mode
717 * differs, a mode set eeprom write will be completed at initialization.
718 * Use the option below to force an eeprom write to a V3.1 probe regardless.
720 //#define BLTOUCH_SET_5V_MODE
723 * Safety: Activate if connecting a probe with an unknown voltage mode.
724 * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
725 * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
726 * To preserve the life of the probe, use this once then turn it off and re-flash.
728 //#define BLTOUCH_FORCE_MODE_SET
731 * Use "HIGH SPEED" mode for probing.
732 * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
733 * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
734 * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
736 //#define BLTOUCH_HS_MODE
738 // Safety: Enable voltage mode settings in the LCD menu.
739 //#define BLTOUCH_LCD_VOLTAGE_MENU
741 #endif // BLTOUCH
743 // @section extras
746 * Z Steppers Auto-Alignment
747 * Add the G34 command to align multiple Z steppers using a bed probe.
749 //#define Z_STEPPER_AUTO_ALIGN
750 #if ENABLED(Z_STEPPER_AUTO_ALIGN)
751 // Define probe X and Y positions for Z1, Z2 [, Z3 [, Z4]]
752 // If not defined, probe limits will be used.
753 // Override with 'M422 S<index> X<pos> Y<pos>'
754 //#define Z_STEPPER_ALIGN_XY { { 10, 190 }, { 100, 10 }, { 190, 190 } }
757 * Orientation for the automatically-calculated probe positions.
758 * Override Z stepper align points with 'M422 S<index> X<pos> Y<pos>'
760 * 2 Steppers: (0) (1)
761 * | | 2 |
762 * | 1 2 | |
763 * | | 1 |
765 * 3 Steppers: (0) (1) (2) (3)
766 * | 3 | 1 | 2 1 | 2 |
767 * | | 3 | | 3 |
768 * | 1 2 | 2 | 3 | 1 |
770 * 4 Steppers: (0) (1) (2) (3)
771 * | 4 3 | 1 4 | 2 1 | 3 2 |
772 * | | | | |
773 * | 1 2 | 2 3 | 3 4 | 4 1 |
775 #ifndef Z_STEPPER_ALIGN_XY
776 //#define Z_STEPPERS_ORIENTATION 0
777 #endif
779 // Provide Z stepper positions for more rapid convergence in bed alignment.
780 // Requires triple stepper drivers (i.e., set NUM_Z_STEPPER_DRIVERS to 3)
781 //#define Z_STEPPER_ALIGN_KNOWN_STEPPER_POSITIONS
782 #if ENABLED(Z_STEPPER_ALIGN_KNOWN_STEPPER_POSITIONS)
783 // Define Stepper XY positions for Z1, Z2, Z3 corresponding to
784 // the Z screw positions in the bed carriage.
785 // Define one position per Z stepper in stepper driver order.
786 #define Z_STEPPER_ALIGN_STEPPER_XY { { 210.7, 102.5 }, { 152.6, 220.0 }, { 94.5, 102.5 } }
787 #else
788 // Amplification factor. Used to scale the correction step up or down in case
789 // the stepper (spindle) position is farther out than the test point.
790 #define Z_STEPPER_ALIGN_AMP 1.0 // Use a value > 1.0 NOTE: This may cause instability!
791 #endif
793 // On a 300mm bed a 5% grade would give a misalignment of ~1.5cm
794 #define G34_MAX_GRADE 5 // (%) Maximum incline that G34 will handle
795 #define Z_STEPPER_ALIGN_ITERATIONS 5 // Number of iterations to apply during alignment
796 #define Z_STEPPER_ALIGN_ACC 0.02 // Stop iterating early if the accuracy is better than this
797 #define RESTORE_LEVELING_AFTER_G34 // Restore leveling after G34 is done?
798 // After G34, re-home Z (G28 Z) or just calculate it from the last probe heights?
799 // Re-homing might be more precise in reproducing the actual 'G28 Z' homing height, especially on an uneven bed.
800 #define HOME_AFTER_G34
801 #endif
804 // Add the G35 command to read bed corners to help adjust screws. Requires a bed probe.
806 //#define ASSISTED_TRAMMING
807 #if ENABLED(ASSISTED_TRAMMING)
809 // Define positions for probe points.
810 #define TRAMMING_POINT_XY { { 20, 20 }, { 180, 20 }, { 180, 180 }, { 20, 180 } }
812 // Define position names for probe points.
813 #define TRAMMING_POINT_NAME_1 "Front-Left"
814 #define TRAMMING_POINT_NAME_2 "Front-Right"
815 #define TRAMMING_POINT_NAME_3 "Back-Right"
816 #define TRAMMING_POINT_NAME_4 "Back-Left"
818 #define RESTORE_LEVELING_AFTER_G35 // Enable to restore leveling setup after operation
819 //#define REPORT_TRAMMING_MM // Report Z deviation (mm) for each point relative to the first
821 //#define ASSISTED_TRAMMING_WIZARD // Add a Tramming Wizard to the LCD menu
823 //#define ASSISTED_TRAMMING_WAIT_POSITION { X_CENTER, Y_CENTER, 30 } // Move the nozzle out of the way for adjustment
826 * Screw thread:
827 * M3: 30 = Clockwise, 31 = Counter-Clockwise
828 * M4: 40 = Clockwise, 41 = Counter-Clockwise
829 * M5: 50 = Clockwise, 51 = Counter-Clockwise
831 #define TRAMMING_SCREW_THREAD 30
833 #endif
835 // @section motion
837 #define AXIS_RELATIVE_MODES { false, false, false, false }
839 // Add a Duplicate option for well-separated conjoined nozzles
840 //#define MULTI_NOZZLE_DUPLICATION
842 // By default pololu step drivers require an active high signal. However, some high power drivers require an active low signal as step.
843 #define INVERT_X_STEP_PIN false
844 #define INVERT_Y_STEP_PIN false
845 #define INVERT_Z_STEP_PIN false
846 #define INVERT_E_STEP_PIN false
849 * Idle Stepper Shutdown
850 * Set DISABLE_INACTIVE_? 'true' to shut down axis steppers after an idle period.
851 * The Deactive Time can be overridden with M18 and M84. Set to 0 for No Timeout.
853 #define DEFAULT_STEPPER_DEACTIVE_TIME 120
854 #define DISABLE_INACTIVE_X true
855 #define DISABLE_INACTIVE_Y true
856 #define DISABLE_INACTIVE_Z true // Set 'false' if the nozzle could fall onto your printed part!
857 #define DISABLE_INACTIVE_E true
859 // If the Nozzle or Bed falls when the Z stepper is disabled, set its resting position here.
860 //#define Z_AFTER_DEACTIVATE Z_HOME_POS
862 // Default Minimum Feedrates for printing and travel moves
863 #define DEFAULT_MINIMUMFEEDRATE 0.0 // (mm/s) Minimum feedrate. Set with M205 S.
864 #define DEFAULT_MINTRAVELFEEDRATE 0.0 // (mm/s) Minimum travel feedrate. Set with M205 T.
866 // Minimum time that a segment needs to take as the buffer gets emptied
867 #define DEFAULT_MINSEGMENTTIME 20000 // (µs) Set with M205 B.
869 // Slow down the machine if the lookahead buffer is (by default) half full.
870 // Increase the slowdown divisor for larger buffer sizes.
871 #define SLOWDOWN
872 #if ENABLED(SLOWDOWN)
873 #define SLOWDOWN_DIVISOR 2
874 #endif
877 * XY Frequency limit
878 * Reduce resonance by limiting the frequency of small zigzag infill moves.
879 * See https://hydraraptor.blogspot.com/2010/12/frequency-limit.html
880 * Use M201 F<freq> G<min%> to change limits at runtime.
882 //#define XY_FREQUENCY_LIMIT 10 // (Hz) Maximum frequency of small zigzag infill moves. Set with M201 F<hertz>.
883 #ifdef XY_FREQUENCY_LIMIT
884 #define XY_FREQUENCY_MIN_PERCENT 5 // (percent) Minimum FR percentage to apply. Set with M201 G<min%>.
885 #endif
887 // Minimum planner junction speed. Sets the default minimum speed the planner plans for at the end
888 // of the buffer and all stops. This should not be much greater than zero and should only be changed
889 // if unwanted behavior is observed on a user's machine when running at very slow speeds.
890 #define MINIMUM_PLANNER_SPEED 0.05 // (mm/s)
893 // Backlash Compensation
894 // Adds extra movement to axes on direction-changes to account for backlash.
896 //#define BACKLASH_COMPENSATION
897 #if ENABLED(BACKLASH_COMPENSATION)
898 // Define values for backlash distance and correction.
899 // If BACKLASH_GCODE is enabled these values are the defaults.
900 #define BACKLASH_DISTANCE_MM { 0, 0, 0 } // (mm)
901 #define BACKLASH_CORRECTION 0.0 // 0.0 = no correction; 1.0 = full correction
903 // Set BACKLASH_SMOOTHING_MM to spread backlash correction over multiple segments
904 // to reduce print artifacts. (Enabling this is costly in memory and computation!)
905 //#define BACKLASH_SMOOTHING_MM 3 // (mm)
907 // Add runtime configuration and tuning of backlash values (M425)
908 //#define BACKLASH_GCODE
910 #if ENABLED(BACKLASH_GCODE)
911 // Measure the Z backlash when probing (G29) and set with "M425 Z"
912 #define MEASURE_BACKLASH_WHEN_PROBING
914 #if ENABLED(MEASURE_BACKLASH_WHEN_PROBING)
915 // When measuring, the probe will move up to BACKLASH_MEASUREMENT_LIMIT
916 // mm away from point of contact in BACKLASH_MEASUREMENT_RESOLUTION
917 // increments while checking for the contact to be broken.
918 #define BACKLASH_MEASUREMENT_LIMIT 0.5 // (mm)
919 #define BACKLASH_MEASUREMENT_RESOLUTION 0.005 // (mm)
920 #define BACKLASH_MEASUREMENT_FEEDRATE Z_PROBE_SPEED_SLOW // (mm/min)
921 #endif
922 #endif
923 #endif
926 * Automatic backlash, position and hotend offset calibration
928 * Enable G425 to run automatic calibration using an electrically-
929 * conductive cube, bolt, or washer mounted on the bed.
931 * G425 uses the probe to touch the top and sides of the calibration object
932 * on the bed and measures and/or correct positional offsets, axis backlash
933 * and hotend offsets.
935 * Note: HOTEND_OFFSET and CALIBRATION_OBJECT_CENTER must be set to within
936 * ±5mm of true values for G425 to succeed.
938 //#define CALIBRATION_GCODE
939 #if ENABLED(CALIBRATION_GCODE)
941 //#define CALIBRATION_SCRIPT_PRE "M117 Starting Auto-Calibration\nT0\nG28\nG12\nM117 Calibrating..."
942 //#define CALIBRATION_SCRIPT_POST "M500\nM117 Calibration data saved"
944 #define CALIBRATION_MEASUREMENT_RESOLUTION 0.01 // mm
946 #define CALIBRATION_FEEDRATE_SLOW 60 // mm/min
947 #define CALIBRATION_FEEDRATE_FAST 1200 // mm/min
948 #define CALIBRATION_FEEDRATE_TRAVEL 3000 // mm/min
950 // The following parameters refer to the conical section of the nozzle tip.
951 #define CALIBRATION_NOZZLE_TIP_HEIGHT 1.0 // mm
952 #define CALIBRATION_NOZZLE_OUTER_DIAMETER 2.0 // mm
954 // Uncomment to enable reporting (required for "G425 V", but consumes PROGMEM).
955 //#define CALIBRATION_REPORTING
957 // The true location and dimension the cube/bolt/washer on the bed.
958 #define CALIBRATION_OBJECT_CENTER { 264.0, -22.0, -2.0 } // mm
959 #define CALIBRATION_OBJECT_DIMENSIONS { 10.0, 10.0, 10.0 } // mm
961 // Comment out any sides which are unreachable by the probe. For best
962 // auto-calibration results, all sides must be reachable.
963 #define CALIBRATION_MEASURE_RIGHT
964 #define CALIBRATION_MEASURE_FRONT
965 #define CALIBRATION_MEASURE_LEFT
966 #define CALIBRATION_MEASURE_BACK
968 // Probing at the exact top center only works if the center is flat. If
969 // probing on a screwhead or hollow washer, probe near the edges.
970 //#define CALIBRATION_MEASURE_AT_TOP_EDGES
972 // Define the pin to read during calibration
973 #ifndef CALIBRATION_PIN
974 //#define CALIBRATION_PIN -1 // Define here to override the default pin
975 #define CALIBRATION_PIN_INVERTING false // Set to true to invert the custom pin
976 //#define CALIBRATION_PIN_PULLDOWN
977 #define CALIBRATION_PIN_PULLUP
978 #endif
979 #endif
982 * Adaptive Step Smoothing increases the resolution of multi-axis moves, particularly at step frequencies
983 * below 1kHz (for AVR) or 10kHz (for ARM), where aliasing between axes in multi-axis moves causes audible
984 * vibration and surface artifacts. The algorithm adapts to provide the best possible step smoothing at the
985 * lowest stepping frequencies.
987 //#define ADAPTIVE_STEP_SMOOTHING
990 * Custom Microstepping
991 * Override as-needed for your setup. Up to 3 MS pins are supported.
993 //#define MICROSTEP1 LOW,LOW,LOW
994 //#define MICROSTEP2 HIGH,LOW,LOW
995 //#define MICROSTEP4 LOW,HIGH,LOW
996 //#define MICROSTEP8 HIGH,HIGH,LOW
997 //#define MICROSTEP16 LOW,LOW,HIGH
998 //#define MICROSTEP32 HIGH,LOW,HIGH
1000 // Microstep settings (Requires a board with pins named X_MS1, X_MS2, etc.)
1001 #define MICROSTEP_MODES { 16, 16, 16, 16, 16, 16 } // [1,2,4,8,16]
1004 * @section stepper motor current
1006 * Some boards have a means of setting the stepper motor current via firmware.
1008 * The power on motor currents are set by:
1009 * PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
1010 * known compatible chips: A4982
1011 * DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
1012 * known compatible chips: AD5206
1013 * DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
1014 * known compatible chips: MCP4728
1015 * DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
1016 * known compatible chips: MCP4451, MCP4018
1018 * Motor currents can also be set by M907 - M910 and by the LCD.
1019 * M907 - applies to all.
1020 * M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
1021 * M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
1023 //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 } // Values in milliamps
1024 //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 } // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
1025 //#define DAC_MOTOR_CURRENT_DEFAULT { 70, 80, 90, 80 } // Default drive percent - X, Y, Z, E axis
1028 * I2C-based DIGIPOTs (e.g., Azteeg X3 Pro)
1030 //#define DIGIPOT_MCP4018 // Requires https://github.com/felias-fogg/SlowSoftI2CMaster
1031 //#define DIGIPOT_MCP4451
1032 #if EITHER(DIGIPOT_MCP4018, DIGIPOT_MCP4451)
1033 #define DIGIPOT_I2C_NUM_CHANNELS 8 // 5DPRINT:4 AZTEEG_X3_PRO:8 MKS_SBASE:5 MIGHTYBOARD_REVE:5
1035 // Actual motor currents in Amps. The number of entries must match DIGIPOT_I2C_NUM_CHANNELS.
1036 // These correspond to the physical drivers, so be mindful if the order is changed.
1037 #define DIGIPOT_I2C_MOTOR_CURRENTS { 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 } // AZTEEG_X3_PRO
1039 //#define DIGIPOT_USE_RAW_VALUES // Use DIGIPOT_MOTOR_CURRENT raw wiper values (instead of A4988 motor currents)
1042 * Common slave addresses:
1044 * A (A shifted) B (B shifted) IC
1045 * Smoothie 0x2C (0x58) 0x2D (0x5A) MCP4451
1046 * AZTEEG_X3_PRO 0x2C (0x58) 0x2E (0x5C) MCP4451
1047 * AZTEEG_X5_MINI 0x2C (0x58) 0x2E (0x5C) MCP4451
1048 * AZTEEG_X5_MINI_WIFI 0x58 0x5C MCP4451
1049 * MIGHTYBOARD_REVE 0x2F (0x5E) MCP4018
1051 //#define DIGIPOT_I2C_ADDRESS_A 0x2C // Unshifted slave address for first DIGIPOT
1052 //#define DIGIPOT_I2C_ADDRESS_B 0x2D // Unshifted slave address for second DIGIPOT
1053 #endif
1055 //===========================================================================
1056 //=============================Additional Features===========================
1057 //===========================================================================
1059 // @section lcd
1061 #if EITHER(IS_ULTIPANEL, EXTENSIBLE_UI)
1062 #define MANUAL_FEEDRATE { 50*60, 50*60, 4*60, 2*60 } // (mm/min) Feedrates for manual moves along X, Y, Z, E from panel
1063 #define FINE_MANUAL_MOVE 0.025 // (mm) Smallest manual move (< 0.1mm) applying to Z on most machines
1064 #if IS_ULTIPANEL
1065 #define MANUAL_E_MOVES_RELATIVE // Display extruder move distance rather than "position"
1066 #define ULTIPANEL_FEEDMULTIPLY // Encoder sets the feedrate multiplier on the Status Screen
1067 #endif
1068 #endif
1070 // Change values more rapidly when the encoder is rotated faster
1071 #define ENCODER_RATE_MULTIPLIER
1072 #if ENABLED(ENCODER_RATE_MULTIPLIER)
1073 #define ENCODER_10X_STEPS_PER_SEC 30 // (steps/s) Encoder rate for 10x speed
1074 #define ENCODER_100X_STEPS_PER_SEC 80 // (steps/s) Encoder rate for 100x speed
1075 #endif
1077 // Play a beep when the feedrate is changed from the Status Screen
1078 //#define BEEP_ON_FEEDRATE_CHANGE
1079 #if ENABLED(BEEP_ON_FEEDRATE_CHANGE)
1080 #define FEEDRATE_CHANGE_BEEP_DURATION 10
1081 #define FEEDRATE_CHANGE_BEEP_FREQUENCY 440
1082 #endif
1084 #if HAS_LCD_MENU
1086 // Add Probe Z Offset calibration to the Z Probe Offsets menu
1087 #if HAS_BED_PROBE
1088 //#define PROBE_OFFSET_WIZARD
1089 #if ENABLED(PROBE_OFFSET_WIZARD)
1091 // Enable to init the Probe Z-Offset when starting the Wizard.
1092 // Use a height slightly above the estimated nozzle-to-probe Z offset.
1093 // For example, with an offset of -5, consider a starting height of -4.
1095 //#define PROBE_OFFSET_WIZARD_START_Z -4.0
1097 // Set a convenient position to do the calibration (probing point and nozzle/bed-distance)
1098 //#define PROBE_OFFSET_WIZARD_XY_POS { X_CENTER, Y_CENTER }
1099 #endif
1100 #endif
1102 // Include a page of printer information in the LCD Main Menu
1103 //#define LCD_INFO_MENU
1104 #if ENABLED(LCD_INFO_MENU)
1105 //#define LCD_PRINTER_INFO_IS_BOOTSCREEN // Show bootscreen(s) instead of Printer Info pages
1106 #endif
1108 // BACK menu items keep the highlight at the top
1109 //#define TURBO_BACK_MENU_ITEM
1111 // Add a mute option to the LCD menu
1112 //#define SOUND_MENU_ITEM
1115 * LED Control Menu
1116 * Add LED Control to the LCD menu
1118 //#define LED_CONTROL_MENU
1119 #if ENABLED(LED_CONTROL_MENU)
1120 #define LED_COLOR_PRESETS // Enable the Preset Color menu option
1121 //#define NEO2_COLOR_PRESETS // Enable a second NeoPixel Preset Color menu option
1122 #if ENABLED(LED_COLOR_PRESETS)
1123 #define LED_USER_PRESET_RED 255 // User defined RED value
1124 #define LED_USER_PRESET_GREEN 128 // User defined GREEN value
1125 #define LED_USER_PRESET_BLUE 0 // User defined BLUE value
1126 #define LED_USER_PRESET_WHITE 255 // User defined WHITE value
1127 #define LED_USER_PRESET_BRIGHTNESS 255 // User defined intensity
1128 //#define LED_USER_PRESET_STARTUP // Have the printer display the user preset color on startup
1129 #endif
1130 #if ENABLED(NEO2_COLOR_PRESETS)
1131 #define NEO2_USER_PRESET_RED 255 // User defined RED value
1132 #define NEO2_USER_PRESET_GREEN 128 // User defined GREEN value
1133 #define NEO2_USER_PRESET_BLUE 0 // User defined BLUE value
1134 #define NEO2_USER_PRESET_WHITE 255 // User defined WHITE value
1135 #define NEO2_USER_PRESET_BRIGHTNESS 255 // User defined intensity
1136 //#define NEO2_USER_PRESET_STARTUP // Have the printer display the user preset color on startup for the second strip
1137 #endif
1138 #endif
1140 #endif // HAS_LCD_MENU
1142 #if HAS_DISPLAY
1143 // The timeout (in ms) to return to the status screen from sub-menus
1144 //#define LCD_TIMEOUT_TO_STATUS 15000
1146 #if ENABLED(SHOW_BOOTSCREEN)
1147 #define BOOTSCREEN_TIMEOUT 4000 // (ms) Total Duration to display the boot screen(s)
1148 #if EITHER(HAS_MARLINUI_U8GLIB, TFT_COLOR_UI)
1149 #define BOOT_MARLIN_LOGO_SMALL // Show a smaller Marlin logo on the Boot Screen (saving lots of flash)
1150 #endif
1151 #endif
1153 // Scroll a longer status message into view
1154 //#define STATUS_MESSAGE_SCROLLING
1156 // On the Info Screen, display XY with one decimal place when possible
1157 //#define LCD_DECIMAL_SMALL_XY
1159 // Add an 'M73' G-code to set the current percentage
1160 //#define LCD_SET_PROGRESS_MANUALLY
1162 // Show the E position (filament used) during printing
1163 //#define LCD_SHOW_E_TOTAL
1164 #endif
1166 #if EITHER(SDSUPPORT, LCD_SET_PROGRESS_MANUALLY) && ANY(HAS_MARLINUI_U8GLIB, HAS_MARLINUI_HD44780, IS_TFTGLCD_PANEL, EXTENSIBLE_UI)
1167 //#define SHOW_REMAINING_TIME // Display estimated time to completion
1168 #if ENABLED(SHOW_REMAINING_TIME)
1169 //#define USE_M73_REMAINING_TIME // Use remaining time from M73 command instead of estimation
1170 //#define ROTATE_PROGRESS_DISPLAY // Display (P)rogress, (E)lapsed, and (R)emaining time
1171 #endif
1173 #if EITHER(HAS_MARLINUI_U8GLIB, EXTENSIBLE_UI)
1174 //#define PRINT_PROGRESS_SHOW_DECIMALS // Show progress with decimal digits
1175 #endif
1177 #if EITHER(HAS_MARLINUI_HD44780, IS_TFTGLCD_PANEL)
1178 //#define LCD_PROGRESS_BAR // Show a progress bar on HD44780 LCDs for SD printing
1179 #if ENABLED(LCD_PROGRESS_BAR)
1180 #define PROGRESS_BAR_BAR_TIME 2000 // (ms) Amount of time to show the bar
1181 #define PROGRESS_BAR_MSG_TIME 3000 // (ms) Amount of time to show the status message
1182 #define PROGRESS_MSG_EXPIRE 0 // (ms) Amount of time to retain the status message (0=forever)
1183 //#define PROGRESS_MSG_ONCE // Show the message for MSG_TIME then clear it
1184 //#define LCD_PROGRESS_BAR_TEST // Add a menu item to test the progress bar
1185 #endif
1186 #endif
1187 #endif
1189 #if ENABLED(SDSUPPORT)
1191 * SD Card SPI Speed
1192 * May be required to resolve "volume init" errors.
1194 * Enable and set to SPI_HALF_SPEED, SPI_QUARTER_SPEED, or SPI_EIGHTH_SPEED
1195 * otherwise full speed will be applied.
1197 * :['SPI_HALF_SPEED', 'SPI_QUARTER_SPEED', 'SPI_EIGHTH_SPEED']
1199 //#define SD_SPI_SPEED SPI_HALF_SPEED
1201 // The standard SD detect circuit reads LOW when media is inserted and HIGH when empty.
1202 // Enable this option and set to HIGH if your SD cards are incorrectly detected.
1203 //#define SD_DETECT_STATE HIGH
1205 //#define SD_IGNORE_AT_STARTUP // Don't mount the SD card when starting up
1206 //#define SDCARD_READONLY // Read-only SD card (to save over 2K of flash)
1208 //#define GCODE_REPEAT_MARKERS // Enable G-code M808 to set repeat markers and do looping
1210 #define SD_PROCEDURE_DEPTH 1 // Increase if you need more nested M32 calls
1212 #define SD_FINISHED_STEPPERRELEASE true // Disable steppers when SD Print is finished
1213 #define SD_FINISHED_RELEASECOMMAND "M84" // Use "M84XYE" to keep Z enabled so your bed stays in place
1215 // Reverse SD sort to show "more recent" files first, according to the card's FAT.
1216 // Since the FAT gets out of order with usage, SDCARD_SORT_ALPHA is recommended.
1217 #define SDCARD_RATHERRECENTFIRST
1219 #define SD_MENU_CONFIRM_START // Confirm the selected SD file before printing
1221 //#define NO_SD_AUTOSTART // Remove auto#.g file support completely to save some Flash, SRAM
1222 //#define MENU_ADDAUTOSTART // Add a menu option to run auto#.g files
1224 //#define BROWSE_MEDIA_ON_INSERT // Open the file browser when media is inserted
1226 #define EVENT_GCODE_SD_ABORT "G28XY" // G-code to run on SD Abort Print (e.g., "G28XY" or "G27")
1228 #if ENABLED(PRINTER_EVENT_LEDS)
1229 #define PE_LEDS_COMPLETED_TIME (30*60) // (seconds) Time to keep the LED "done" color before restoring normal illumination
1230 #endif
1233 * Continue after Power-Loss (Creality3D)
1235 * Store the current state to the SD Card at the start of each layer
1236 * during SD printing. If the recovery file is found at boot time, present
1237 * an option on the LCD screen to continue the print from the last-known
1238 * point in the file.
1240 //#define POWER_LOSS_RECOVERY
1241 #if ENABLED(POWER_LOSS_RECOVERY)
1242 #define PLR_ENABLED_DEFAULT false // Power Loss Recovery enabled by default. (Set with 'M413 Sn' & M500)
1243 //#define BACKUP_POWER_SUPPLY // Backup power / UPS to move the steppers on power loss
1244 //#define POWER_LOSS_RECOVER_ZHOME // Z homing is needed for proper recovery. 99.9% of the time this should be disabled!
1245 //#define POWER_LOSS_ZRAISE 2 // (mm) Z axis raise on resume (on power loss with UPS)
1246 //#define POWER_LOSS_PIN 44 // Pin to detect power loss. Set to -1 to disable default pin on boards without module.
1247 //#define POWER_LOSS_STATE HIGH // State of pin indicating power loss
1248 //#define POWER_LOSS_PULLUP // Set pullup / pulldown as appropriate for your sensor
1249 //#define POWER_LOSS_PULLDOWN
1250 //#define POWER_LOSS_PURGE_LEN 20 // (mm) Length of filament to purge on resume
1251 //#define POWER_LOSS_RETRACT_LEN 10 // (mm) Length of filament to retract on fail. Requires backup power.
1253 // Without a POWER_LOSS_PIN the following option helps reduce wear on the SD card,
1254 // especially with "vase mode" printing. Set too high and vases cannot be continued.
1255 #define POWER_LOSS_MIN_Z_CHANGE 0.05 // (mm) Minimum Z change before saving power-loss data
1256 #endif
1259 * Sort SD file listings in alphabetical order.
1261 * With this option enabled, items on SD cards will be sorted
1262 * by name for easier navigation.
1264 * By default...
1266 * - Use the slowest -but safest- method for sorting.
1267 * - Folders are sorted to the top.
1268 * - The sort key is statically allocated.
1269 * - No added G-code (M34) support.
1270 * - 40 item sorting limit. (Items after the first 40 are unsorted.)
1272 * SD sorting uses static allocation (as set by SDSORT_LIMIT), allowing the
1273 * compiler to calculate the worst-case usage and throw an error if the SRAM
1274 * limit is exceeded.
1276 * - SDSORT_USES_RAM provides faster sorting via a static directory buffer.
1277 * - SDSORT_USES_STACK does the same, but uses a local stack-based buffer.
1278 * - SDSORT_CACHE_NAMES will retain the sorted file listing in RAM. (Expensive!)
1279 * - SDSORT_DYNAMIC_RAM only uses RAM when the SD menu is visible. (Use with caution!)
1281 //#define SDCARD_SORT_ALPHA
1283 // SD Card Sorting options
1284 #if ENABLED(SDCARD_SORT_ALPHA)
1285 #define SDSORT_LIMIT 40 // Maximum number of sorted items (10-256). Costs 27 bytes each.
1286 #define FOLDER_SORTING -1 // -1=above 0=none 1=below
1287 #define SDSORT_GCODE false // Allow turning sorting on/off with LCD and M34 G-code.
1288 #define SDSORT_USES_RAM false // Pre-allocate a static array for faster pre-sorting.
1289 #define SDSORT_USES_STACK false // Prefer the stack for pre-sorting to give back some SRAM. (Negated by next 2 options.)
1290 #define SDSORT_CACHE_NAMES false // Keep sorted items in RAM longer for speedy performance. Most expensive option.
1291 #define SDSORT_DYNAMIC_RAM false // Use dynamic allocation (within SD menus). Least expensive option. Set SDSORT_LIMIT before use!
1292 #define SDSORT_CACHE_VFATS 2 // Maximum number of 13-byte VFAT entries to use for sorting.
1293 // Note: Only affects SCROLL_LONG_FILENAMES with SDSORT_CACHE_NAMES but not SDSORT_DYNAMIC_RAM.
1294 #endif
1296 // Allow international symbols in long filenames. To display correctly, the
1297 // LCD's font must contain the characters. Check your selected LCD language.
1298 //#define UTF_FILENAME_SUPPORT
1300 // This allows hosts to request long names for files and folders with M33
1301 //#define LONG_FILENAME_HOST_SUPPORT
1303 // Enable this option to scroll long filenames in the SD card menu
1304 //#define SCROLL_LONG_FILENAMES
1306 // Leave the heaters on after Stop Print (not recommended!)
1307 //#define SD_ABORT_NO_COOLDOWN
1310 * This option allows you to abort SD printing when any endstop is triggered.
1311 * This feature must be enabled with "M540 S1" or from the LCD menu.
1312 * To have any effect, endstops must be enabled during SD printing.
1314 //#define SD_ABORT_ON_ENDSTOP_HIT
1317 * This option makes it easier to print the same SD Card file again.
1318 * On print completion the LCD Menu will open with the file selected.
1319 * You can just click to start the print, or navigate elsewhere.
1321 //#define SD_REPRINT_LAST_SELECTED_FILE
1324 * Auto-report SdCard status with M27 S<seconds>
1326 //#define AUTO_REPORT_SD_STATUS
1329 * Support for USB thumb drives using an Arduino USB Host Shield or
1330 * equivalent MAX3421E breakout board. The USB thumb drive will appear
1331 * to Marlin as an SD card.
1333 * The MAX3421E can be assigned the same pins as the SD card reader, with
1334 * the following pin mapping:
1336 * SCLK, MOSI, MISO --> SCLK, MOSI, MISO
1337 * INT --> SD_DETECT_PIN [1]
1338 * SS --> SDSS
1340 * [1] On AVR an interrupt-capable pin is best for UHS3 compatibility.
1342 //#define USB_FLASH_DRIVE_SUPPORT
1343 #if ENABLED(USB_FLASH_DRIVE_SUPPORT)
1345 * USB Host Shield Library
1347 * - UHS2 uses no interrupts and has been production-tested
1348 * on a LulzBot TAZ Pro with a 32-bit Archim board.
1350 * - UHS3 is newer code with better USB compatibility. But it
1351 * is less tested and is known to interfere with Servos.
1352 * [1] This requires USB_INTR_PIN to be interrupt-capable.
1354 //#define USE_UHS2_USB
1355 //#define USE_UHS3_USB
1358 * Native USB Host supported by some boards (USB OTG)
1360 //#define USE_OTG_USB_HOST
1362 #if DISABLED(USE_OTG_USB_HOST)
1363 #define USB_CS_PIN SDSS
1364 #define USB_INTR_PIN SD_DETECT_PIN
1365 #endif
1366 #endif
1369 * When using a bootloader that supports SD-Firmware-Flashing,
1370 * add a menu item to activate SD-FW-Update on the next reboot.
1372 * Requires ATMEGA2560 (Arduino Mega)
1374 * Tested with this bootloader:
1375 * https://github.com/FleetProbe/MicroBridge-Arduino-ATMega2560
1377 //#define SD_FIRMWARE_UPDATE
1378 #if ENABLED(SD_FIRMWARE_UPDATE)
1379 #define SD_FIRMWARE_UPDATE_EEPROM_ADDR 0x1FF
1380 #define SD_FIRMWARE_UPDATE_ACTIVE_VALUE 0xF0
1381 #define SD_FIRMWARE_UPDATE_INACTIVE_VALUE 0xFF
1382 #endif
1384 // Add an optimized binary file transfer mode, initiated with 'M28 B1'
1385 //#define BINARY_FILE_TRANSFER
1388 * Set this option to one of the following (or the board's defaults apply):
1390 * LCD - Use the SD drive in the external LCD controller.
1391 * ONBOARD - Use the SD drive on the control board.
1392 * CUSTOM_CABLE - Use a custom cable to access the SD (as defined in a pins file).
1394 * :[ 'LCD', 'ONBOARD', 'CUSTOM_CABLE' ]
1396 //#define SDCARD_CONNECTION LCD
1398 // Enable if SD detect is rendered useless (e.g., by using an SD extender)
1399 //#define NO_SD_DETECT
1401 #endif // SDSUPPORT
1404 * By default an onboard SD card reader may be shared as a USB mass-
1405 * storage device. This option hides the SD card from the host PC.
1407 //#define NO_SD_HOST_DRIVE // Disable SD Card access over USB (for security).
1410 * Additional options for Graphical Displays
1412 * Use the optimizations here to improve printing performance,
1413 * which can be adversely affected by graphical display drawing,
1414 * especially when doing several short moves, and when printing
1415 * on DELTA and SCARA machines.
1417 * Some of these options may result in the display lagging behind
1418 * controller events, as there is a trade-off between reliable
1419 * printing performance versus fast display updates.
1421 #if HAS_MARLINUI_U8GLIB
1422 // Show SD percentage next to the progress bar
1423 //#define DOGM_SD_PERCENT
1425 // Save many cycles by drawing a hollow frame or no frame on the Info Screen
1426 //#define XYZ_NO_FRAME
1427 #define XYZ_HOLLOW_FRAME
1429 // Enable to save many cycles by drawing a hollow frame on Menu Screens
1430 #define MENU_HOLLOW_FRAME
1432 // A bigger font is available for edit items. Costs 3120 bytes of PROGMEM.
1433 // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1434 //#define USE_BIG_EDIT_FONT
1436 // A smaller font may be used on the Info Screen. Costs 2434 bytes of PROGMEM.
1437 // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1438 //#define USE_SMALL_INFOFONT
1440 // Swap the CW/CCW indicators in the graphics overlay
1441 //#define OVERLAY_GFX_REVERSE
1444 * ST7920-based LCDs can emulate a 16 x 4 character display using
1445 * the ST7920 character-generator for very fast screen updates.
1446 * Enable LIGHTWEIGHT_UI to use this special display mode.
1448 * Since LIGHTWEIGHT_UI has limited space, the position and status
1449 * message occupy the same line. Set STATUS_EXPIRE_SECONDS to the
1450 * length of time to display the status message before clearing.
1452 * Set STATUS_EXPIRE_SECONDS to zero to never clear the status.
1453 * This will prevent position updates from being displayed.
1455 #if ENABLED(U8GLIB_ST7920)
1456 // Enable this option and reduce the value to optimize screen updates.
1457 // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
1458 //#define DOGM_SPI_DELAY_US 5
1460 //#define LIGHTWEIGHT_UI
1461 #if ENABLED(LIGHTWEIGHT_UI)
1462 #define STATUS_EXPIRE_SECONDS 20
1463 #endif
1464 #endif
1467 * Status (Info) Screen customizations
1468 * These options may affect code size and screen render time.
1469 * Custom status screens can forcibly override these settings.
1471 //#define STATUS_COMBINE_HEATERS // Use combined heater images instead of separate ones
1472 //#define STATUS_HOTEND_NUMBERLESS // Use plain hotend icons instead of numbered ones (with 2+ hotends)
1473 #define STATUS_HOTEND_INVERTED // Show solid nozzle bitmaps when heating (Requires STATUS_HOTEND_ANIM)
1474 #define STATUS_HOTEND_ANIM // Use a second bitmap to indicate hotend heating
1475 #define STATUS_BED_ANIM // Use a second bitmap to indicate bed heating
1476 #define STATUS_CHAMBER_ANIM // Use a second bitmap to indicate chamber heating
1477 //#define STATUS_CUTTER_ANIM // Use a second bitmap to indicate spindle / laser active
1478 //#define STATUS_ALT_BED_BITMAP // Use the alternative bed bitmap
1479 //#define STATUS_ALT_FAN_BITMAP // Use the alternative fan bitmap
1480 //#define STATUS_FAN_FRAMES 3 // :[0,1,2,3,4] Number of fan animation frames
1481 //#define STATUS_HEAT_PERCENT // Show heating in a progress bar
1482 //#define BOOT_MARLIN_LOGO_ANIMATED // Animated Marlin logo. Costs ~‭3260 (or ~940) bytes of PROGMEM.
1484 // Frivolous Game Options
1485 //#define MARLIN_BRICKOUT
1486 //#define MARLIN_INVADERS
1487 //#define MARLIN_SNAKE
1488 //#define GAMES_EASTER_EGG // Add extra blank lines above the "Games" sub-menu
1490 #endif // HAS_MARLINUI_U8GLIB
1493 // Additional options for DGUS / DWIN displays
1495 #if HAS_DGUS_LCD
1496 #define LCD_SERIAL_PORT 3
1497 #define LCD_BAUDRATE 115200
1499 #define DGUS_RX_BUFFER_SIZE 128
1500 #define DGUS_TX_BUFFER_SIZE 48
1501 //#define SERIAL_STATS_RX_BUFFER_OVERRUNS // Fix Rx overrun situation (Currently only for AVR)
1503 #define DGUS_UPDATE_INTERVAL_MS 500 // (ms) Interval between automatic screen updates
1505 #if EITHER(DGUS_LCD_UI_FYSETC, DGUS_LCD_UI_HIPRECY)
1506 #define DGUS_PRINT_FILENAME // Display the filename during printing
1507 #define DGUS_PREHEAT_UI // Display a preheat screen during heatup
1509 #if ENABLED(DGUS_LCD_UI_FYSETC)
1510 //#define DGUS_UI_MOVE_DIS_OPTION // Disabled by default for UI_FYSETC
1511 #else
1512 #define DGUS_UI_MOVE_DIS_OPTION // Enabled by default for UI_HIPRECY
1513 #endif
1515 #define DGUS_FILAMENT_LOADUNLOAD
1516 #if ENABLED(DGUS_FILAMENT_LOADUNLOAD)
1517 #define DGUS_FILAMENT_PURGE_LENGTH 10
1518 #define DGUS_FILAMENT_LOAD_LENGTH_PER_TIME 0.5 // (mm) Adjust in proportion to DGUS_UPDATE_INTERVAL_MS
1519 #endif
1521 #define DGUS_UI_WAITING // Show a "waiting" screen between some screens
1522 #if ENABLED(DGUS_UI_WAITING)
1523 #define DGUS_UI_WAITING_STATUS 10
1524 #define DGUS_UI_WAITING_STATUS_PERIOD 8 // Increase to slower waiting status looping
1525 #endif
1526 #endif
1527 #endif // HAS_DGUS_LCD
1530 // Touch UI for the FTDI Embedded Video Engine (EVE)
1532 #if ENABLED(TOUCH_UI_FTDI_EVE)
1533 // Display board used
1534 //#define LCD_FTDI_VM800B35A // FTDI 3.5" with FT800 (320x240)
1535 //#define LCD_4DSYSTEMS_4DLCD_FT843 // 4D Systems 4.3" (480x272)
1536 //#define LCD_HAOYU_FT800CB // Haoyu with 4.3" or 5" (480x272)
1537 //#define LCD_HAOYU_FT810CB // Haoyu with 5" (800x480)
1538 //#define LCD_ALEPHOBJECTS_CLCD_UI // Aleph Objects Color LCD UI
1539 //#define LCD_FYSETC_TFT81050 // FYSETC with 5" (800x480)
1541 // Correct the resolution if not using the stock TFT panel.
1542 //#define TOUCH_UI_320x240
1543 //#define TOUCH_UI_480x272
1544 //#define TOUCH_UI_800x480
1546 // Mappings for boards with a standard RepRapDiscount Display connector
1547 //#define AO_EXP1_PINMAP // AlephObjects CLCD UI EXP1 mapping
1548 //#define AO_EXP2_PINMAP // AlephObjects CLCD UI EXP2 mapping
1549 //#define CR10_TFT_PINMAP // Rudolph Riedel's CR10 pin mapping
1550 //#define S6_TFT_PINMAP // FYSETC S6 pin mapping
1551 //#define F6_TFT_PINMAP // FYSETC F6 pin mapping
1553 //#define OTHER_PIN_LAYOUT // Define pins manually below
1554 #if ENABLED(OTHER_PIN_LAYOUT)
1555 // Pins for CS and MOD_RESET (PD) must be chosen
1556 #define CLCD_MOD_RESET 9
1557 #define CLCD_SPI_CS 10
1559 // If using software SPI, specify pins for SCLK, MOSI, MISO
1560 //#define CLCD_USE_SOFT_SPI
1561 #if ENABLED(CLCD_USE_SOFT_SPI)
1562 #define CLCD_SOFT_SPI_MOSI 11
1563 #define CLCD_SOFT_SPI_MISO 12
1564 #define CLCD_SOFT_SPI_SCLK 13
1565 #endif
1566 #endif
1568 // Display Orientation. An inverted (i.e. upside-down) display
1569 // is supported on the FT800. The FT810 and beyond also support
1570 // portrait and mirrored orientations.
1571 //#define TOUCH_UI_INVERTED
1572 //#define TOUCH_UI_PORTRAIT
1573 //#define TOUCH_UI_MIRRORED
1575 // UTF8 processing and rendering.
1576 // Unsupported characters are shown as '?'.
1577 //#define TOUCH_UI_USE_UTF8
1578 #if ENABLED(TOUCH_UI_USE_UTF8)
1579 // Western accents support. These accented characters use
1580 // combined bitmaps and require relatively little storage.
1581 #define TOUCH_UI_UTF8_WESTERN_CHARSET
1582 #if ENABLED(TOUCH_UI_UTF8_WESTERN_CHARSET)
1583 // Additional character groups. These characters require
1584 // full bitmaps and take up considerable storage:
1585 //#define TOUCH_UI_UTF8_SUPERSCRIPTS // ¹ ² ³
1586 //#define TOUCH_UI_UTF8_COPYRIGHT // © ®
1587 //#define TOUCH_UI_UTF8_GERMANIC // ß
1588 //#define TOUCH_UI_UTF8_SCANDINAVIAN // Æ Ð Ø Þ æ ð ø þ
1589 //#define TOUCH_UI_UTF8_PUNCTUATION // « » ¿ ¡
1590 //#define TOUCH_UI_UTF8_CURRENCY // ¢ £ ¤ ¥
1591 //#define TOUCH_UI_UTF8_ORDINALS // º ª
1592 //#define TOUCH_UI_UTF8_MATHEMATICS // ± × ÷
1593 //#define TOUCH_UI_UTF8_FRACTIONS // ¼ ½ ¾
1594 //#define TOUCH_UI_UTF8_SYMBOLS // µ ¶ ¦ § ¬
1595 #endif
1597 // Cyrillic character set, costs about 27KiB of flash
1598 //#define TOUCH_UI_UTF8_CYRILLIC_CHARSET
1599 #endif
1601 // Use a smaller font when labels don't fit buttons
1602 #define TOUCH_UI_FIT_TEXT
1604 // Allow language selection from menu at run-time (otherwise use LCD_LANGUAGE)
1605 //#define LCD_LANGUAGE_1 en
1606 //#define LCD_LANGUAGE_2 fr
1607 //#define LCD_LANGUAGE_3 de
1608 //#define LCD_LANGUAGE_4 es
1609 //#define LCD_LANGUAGE_5 it
1611 // Use a numeric passcode for "Screen lock" keypad.
1612 // (recommended for smaller displays)
1613 //#define TOUCH_UI_PASSCODE
1615 // Output extra debug info for Touch UI events
1616 //#define TOUCH_UI_DEBUG
1618 // Developer menu (accessed by touching "About Printer" copyright text)
1619 //#define TOUCH_UI_DEVELOPER_MENU
1620 #endif
1623 // Classic UI Options
1625 #if TFT_SCALED_DOGLCD
1626 //#define TFT_MARLINUI_COLOR 0xFFFF // White
1627 //#define TFT_MARLINBG_COLOR 0x0000 // Black
1628 //#define TFT_DISABLED_COLOR 0x0003 // Almost black
1629 //#define TFT_BTCANCEL_COLOR 0xF800 // Red
1630 //#define TFT_BTARROWS_COLOR 0xDEE6 // 11011 110111 00110 Yellow
1631 //#define TFT_BTOKMENU_COLOR 0x145F // 00010 100010 11111 Cyan
1632 #endif
1635 // ADC Button Debounce
1637 #if HAS_ADC_BUTTONS
1638 #define ADC_BUTTON_DEBOUNCE_DELAY 16 // Increase if buttons bounce or repeat too fast
1639 #endif
1641 // @section safety
1644 * The watchdog hardware timer will do a reset and disable all outputs
1645 * if the firmware gets too overloaded to read the temperature sensors.
1647 * If you find that watchdog reboot causes your AVR board to hang forever,
1648 * enable WATCHDOG_RESET_MANUAL to use a custom timer instead of WDTO.
1649 * NOTE: This method is less reliable as it can only catch hangups while
1650 * interrupts are enabled.
1652 #define USE_WATCHDOG
1653 #if ENABLED(USE_WATCHDOG)
1654 //#define WATCHDOG_RESET_MANUAL
1655 #endif
1657 // @section lcd
1660 * Babystepping enables movement of the axes by tiny increments without changing
1661 * the current position values. This feature is used primarily to adjust the Z
1662 * axis in the first layer of a print in real-time.
1664 * Warning: Does not respect endstops!
1666 //#define BABYSTEPPING
1667 #if ENABLED(BABYSTEPPING)
1668 //#define INTEGRATED_BABYSTEPPING // EXPERIMENTAL integration of babystepping into the Stepper ISR
1669 //#define BABYSTEP_WITHOUT_HOMING
1670 //#define BABYSTEP_ALWAYS_AVAILABLE // Allow babystepping at all times (not just during movement).
1671 //#define BABYSTEP_XY // Also enable X/Y Babystepping. Not supported on DELTA!
1672 #define BABYSTEP_INVERT_Z false // Change if Z babysteps should go the other way
1673 //#define BABYSTEP_MILLIMETER_UNITS // Specify BABYSTEP_MULTIPLICATOR_(XY|Z) in mm instead of micro-steps
1674 #define BABYSTEP_MULTIPLICATOR_Z 1 // (steps or mm) Steps or millimeter distance for each Z babystep
1675 #define BABYSTEP_MULTIPLICATOR_XY 1 // (steps or mm) Steps or millimeter distance for each XY babystep
1677 //#define DOUBLECLICK_FOR_Z_BABYSTEPPING // Double-click on the Status Screen for Z Babystepping.
1678 #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING)
1679 #define DOUBLECLICK_MAX_INTERVAL 1250 // Maximum interval between clicks, in milliseconds.
1680 // Note: Extra time may be added to mitigate controller latency.
1681 //#define MOVE_Z_WHEN_IDLE // Jump to the move Z menu on doubleclick when printer is idle.
1682 #if ENABLED(MOVE_Z_WHEN_IDLE)
1683 #define MOVE_Z_IDLE_MULTIPLICATOR 1 // Multiply 1mm by this factor for the move step size.
1684 #endif
1685 #endif
1687 //#define BABYSTEP_DISPLAY_TOTAL // Display total babysteps since last G28
1689 //#define BABYSTEP_ZPROBE_OFFSET // Combine M851 Z and Babystepping
1690 #if ENABLED(BABYSTEP_ZPROBE_OFFSET)
1691 //#define BABYSTEP_HOTEND_Z_OFFSET // For multiple hotends, babystep relative Z offsets
1692 //#define BABYSTEP_ZPROBE_GFX_OVERLAY // Enable graphical overlay on Z-offset editor
1693 #endif
1694 #endif
1696 // @section extruder
1699 * Linear Pressure Control v1.5
1701 * Assumption: advance [steps] = k * (delta velocity [steps/s])
1702 * K=0 means advance disabled.
1704 * NOTE: K values for LIN_ADVANCE 1.5 differ from earlier versions!
1706 * Set K around 0.22 for 3mm PLA Direct Drive with ~6.5cm between the drive gear and heatbreak.
1707 * Larger K values will be needed for flexible filament and greater distances.
1708 * If this algorithm produces a higher speed offset than the extruder can handle (compared to E jerk)
1709 * print acceleration will be reduced during the affected moves to keep within the limit.
1711 * See https://marlinfw.org/docs/features/lin_advance.html for full instructions.
1713 //#define LIN_ADVANCE
1714 #if ENABLED(LIN_ADVANCE)
1715 //#define EXTRA_LIN_ADVANCE_K // Enable for second linear advance constants
1716 #define LIN_ADVANCE_K 0.22 // Unit: mm compression per 1mm/s extruder speed
1717 //#define LA_DEBUG // If enabled, this will generate debug information output over USB.
1718 //#define EXPERIMENTAL_SCURVE // Enable this option to permit S-Curve Acceleration
1719 #endif
1721 // @section leveling
1724 * Points to probe for all 3-point Leveling procedures.
1725 * Override if the automatically selected points are inadequate.
1727 #if EITHER(AUTO_BED_LEVELING_3POINT, AUTO_BED_LEVELING_UBL)
1728 //#define PROBE_PT_1_X 15
1729 //#define PROBE_PT_1_Y 180
1730 //#define PROBE_PT_2_X 15
1731 //#define PROBE_PT_2_Y 20
1732 //#define PROBE_PT_3_X 170
1733 //#define PROBE_PT_3_Y 20
1734 #endif
1737 * Probing Margins
1739 * Override PROBING_MARGIN for each side of the build plate
1740 * Useful to get probe points to exact positions on targets or
1741 * to allow leveling to avoid plate clamps on only specific
1742 * sides of the bed. With NOZZLE_AS_PROBE negative values are
1743 * allowed, to permit probing outside the bed.
1745 * If you are replacing the prior *_PROBE_BED_POSITION options,
1746 * LEFT and FRONT values in most cases will map directly over
1747 * RIGHT and REAR would be the inverse such as
1748 * (X/Y_BED_SIZE - RIGHT/BACK_PROBE_BED_POSITION)
1750 * This will allow all positions to match at compilation, however
1751 * should the probe position be modified with M851XY then the
1752 * probe points will follow. This prevents any change from causing
1753 * the probe to be unable to reach any points.
1755 #if PROBE_SELECTED && !IS_KINEMATIC
1756 //#define PROBING_MARGIN_LEFT PROBING_MARGIN
1757 //#define PROBING_MARGIN_RIGHT PROBING_MARGIN
1758 //#define PROBING_MARGIN_FRONT PROBING_MARGIN
1759 //#define PROBING_MARGIN_BACK PROBING_MARGIN
1760 #endif
1762 #if EITHER(MESH_BED_LEVELING, AUTO_BED_LEVELING_UBL)
1763 // Override the mesh area if the automatic (max) area is too large
1764 //#define MESH_MIN_X MESH_INSET
1765 //#define MESH_MIN_Y MESH_INSET
1766 //#define MESH_MAX_X X_BED_SIZE - (MESH_INSET)
1767 //#define MESH_MAX_Y Y_BED_SIZE - (MESH_INSET)
1768 #endif
1770 #if BOTH(AUTO_BED_LEVELING_UBL, EEPROM_SETTINGS)
1771 //#define OPTIMIZED_MESH_STORAGE // Store mesh with less precision to save EEPROM space
1772 #endif
1775 * Repeatedly attempt G29 leveling until it succeeds.
1776 * Stop after G29_MAX_RETRIES attempts.
1778 //#define G29_RETRY_AND_RECOVER
1779 #if ENABLED(G29_RETRY_AND_RECOVER)
1780 #define G29_MAX_RETRIES 3
1781 #define G29_HALT_ON_FAILURE
1783 * Specify the GCODE commands that will be executed when leveling succeeds,
1784 * between attempts, and after the maximum number of retries have been tried.
1786 #define G29_SUCCESS_COMMANDS "M117 Bed leveling done."
1787 #define G29_RECOVER_COMMANDS "M117 Probe failed. Rewiping.\nG28\nG12 P0 S12 T0"
1788 #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"
1790 #endif
1793 * Thermal Probe Compensation
1794 * Probe measurements are adjusted to compensate for temperature distortion.
1795 * Use G76 to calibrate this feature. Use M871 to set values manually.
1796 * For a more detailed explanation of the process see G76_M871.cpp.
1798 #if HAS_BED_PROBE && TEMP_SENSOR_PROBE && TEMP_SENSOR_BED
1799 // Enable thermal first layer compensation using bed and probe temperatures
1800 #define PROBE_TEMP_COMPENSATION
1802 // Add additional compensation depending on hotend temperature
1803 // Note: this values cannot be calibrated and have to be set manually
1804 #if ENABLED(PROBE_TEMP_COMPENSATION)
1805 // Park position to wait for probe cooldown
1806 #define PTC_PARK_POS { 0, 0, 100 }
1808 // Probe position to probe and wait for probe to reach target temperature
1809 #define PTC_PROBE_POS { 90, 100 }
1811 // Enable additional compensation using hotend temperature
1812 // Note: this values cannot be calibrated automatically but have to be set manually
1813 //#define USE_TEMP_EXT_COMPENSATION
1815 // Probe temperature calibration generates a table of values starting at PTC_SAMPLE_START
1816 // (e.g. 30), in steps of PTC_SAMPLE_RES (e.g. 5) with PTC_SAMPLE_COUNT (e.g. 10) samples.
1818 //#define PTC_SAMPLE_START 30.0f
1819 //#define PTC_SAMPLE_RES 5.0f
1820 //#define PTC_SAMPLE_COUNT 10U
1822 // Bed temperature calibration builds a similar table.
1824 //#define BTC_SAMPLE_START 60.0f
1825 //#define BTC_SAMPLE_RES 5.0f
1826 //#define BTC_SAMPLE_COUNT 10U
1828 // The temperature the probe should be at while taking measurements during bed temperature
1829 // calibration.
1830 //#define BTC_PROBE_TEMP 30.0f
1832 // Height above Z=0.0f to raise the nozzle. Lowering this can help the probe to heat faster.
1833 // Note: the Z=0.0f offset is determined by the probe offset which can be set using M851.
1834 //#define PTC_PROBE_HEATING_OFFSET 0.5f
1836 // Height to raise the Z-probe between heating and taking the next measurement. Some probes
1837 // may fail to untrigger if they have been triggered for a long time, which can be solved by
1838 // increasing the height the probe is raised to.
1839 //#define PTC_PROBE_RAISE 15U
1841 // If the probe is outside of the defined range, use linear extrapolation using the closest
1842 // point and the PTC_LINEAR_EXTRAPOLATION'th next point. E.g. if set to 4 it will use data[0]
1843 // and data[4] to perform linear extrapolation for values below PTC_SAMPLE_START.
1844 //#define PTC_LINEAR_EXTRAPOLATION 4
1845 #endif
1846 #endif
1848 // @section extras
1851 // G60/G61 Position Save and Return
1853 //#define SAVED_POSITIONS 1 // Each saved position slot costs 12 bytes
1856 // G2/G3 Arc Support
1858 #define ARC_SUPPORT // Disable this feature to save ~3226 bytes
1859 #if ENABLED(ARC_SUPPORT)
1860 #define MM_PER_ARC_SEGMENT 1 // (mm) Length (or minimum length) of each arc segment
1861 //#define ARC_SEGMENTS_PER_R 1 // Max segment length, MM_PER = Min
1862 #define MIN_ARC_SEGMENTS 24 // Minimum number of segments in a complete circle
1863 //#define ARC_SEGMENTS_PER_SEC 50 // Use feedrate to choose segment length (with MM_PER_ARC_SEGMENT as the minimum)
1864 #define N_ARC_CORRECTION 25 // Number of interpolated segments between corrections
1865 //#define ARC_P_CIRCLES // Enable the 'P' parameter to specify complete circles
1866 //#define CNC_WORKSPACE_PLANES // Allow G2/G3 to operate in XY, ZX, or YZ planes
1867 //#define SF_ARC_FIX // Enable only if using SkeinForge with "Arc Point" fillet procedure
1868 #endif
1870 // Support for G5 with XYZE destination and IJPQ offsets. Requires ~2666 bytes.
1871 //#define BEZIER_CURVE_SUPPORT
1874 * Direct Stepping
1876 * Comparable to the method used by Klipper, G6 direct stepping significantly
1877 * reduces motion calculations, increases top printing speeds, and results in
1878 * less step aliasing by calculating all motions in advance.
1879 * Preparing your G-code: https://github.com/colinrgodsey/step-daemon
1881 //#define DIRECT_STEPPING
1884 * G38 Probe Target
1886 * This option adds G38.2 and G38.3 (probe towards target)
1887 * and optionally G38.4 and G38.5 (probe away from target).
1888 * Set MULTIPLE_PROBING for G38 to probe more than once.
1890 //#define G38_PROBE_TARGET
1891 #if ENABLED(G38_PROBE_TARGET)
1892 //#define G38_PROBE_AWAY // Include G38.4 and G38.5 to probe away from target
1893 #define G38_MINIMUM_MOVE 0.0275 // (mm) Minimum distance that will produce a move.
1894 #endif
1896 // Moves (or segments) with fewer steps than this will be joined with the next move
1897 #define MIN_STEPS_PER_SEGMENT 6
1900 * Minimum delay before and after setting the stepper DIR (in ns)
1901 * 0 : No delay (Expect at least 10µS since one Stepper ISR must transpire)
1902 * 20 : Minimum for TMC2xxx drivers
1903 * 200 : Minimum for A4988 drivers
1904 * 400 : Minimum for A5984 drivers
1905 * 500 : Minimum for LV8729 drivers (guess, no info in datasheet)
1906 * 650 : Minimum for DRV8825 drivers
1907 * 1500 : Minimum for TB6600 drivers (guess, no info in datasheet)
1908 * 15000 : Minimum for TB6560 drivers (guess, no info in datasheet)
1910 * Override the default value based on the driver type set in Configuration.h.
1912 //#define MINIMUM_STEPPER_POST_DIR_DELAY 650
1913 //#define MINIMUM_STEPPER_PRE_DIR_DELAY 650
1916 * Minimum stepper driver pulse width (in µs)
1917 * 0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
1918 * 0 : Minimum 500ns for LV8729, adjusted in stepper.h
1919 * 1 : Minimum for A4988 and A5984 stepper drivers
1920 * 2 : Minimum for DRV8825 stepper drivers
1921 * 3 : Minimum for TB6600 stepper drivers
1922 * 30 : Minimum for TB6560 stepper drivers
1924 * Override the default value based on the driver type set in Configuration.h.
1926 //#define MINIMUM_STEPPER_PULSE 2
1929 * Maximum stepping rate (in Hz) the stepper driver allows
1930 * If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
1931 * 5000000 : Maximum for TMC2xxx stepper drivers
1932 * 1000000 : Maximum for LV8729 stepper driver
1933 * 500000 : Maximum for A4988 stepper driver
1934 * 250000 : Maximum for DRV8825 stepper driver
1935 * 150000 : Maximum for TB6600 stepper driver
1936 * 15000 : Maximum for TB6560 stepper driver
1938 * Override the default value based on the driver type set in Configuration.h.
1940 //#define MAXIMUM_STEPPER_RATE 250000
1942 // @section temperature
1944 // Control heater 0 and heater 1 in parallel.
1945 //#define HEATERS_PARALLEL
1947 //===========================================================================
1948 //================================= Buffers =================================
1949 //===========================================================================
1951 // @section motion
1953 // The number of linear moves that can be in the planner at once.
1954 // The value of BLOCK_BUFFER_SIZE must be a power of 2 (e.g. 8, 16, 32)
1955 #if BOTH(SDSUPPORT, DIRECT_STEPPING)
1956 #define BLOCK_BUFFER_SIZE 8
1957 #elif ENABLED(SDSUPPORT)
1958 #define BLOCK_BUFFER_SIZE 16
1959 #else
1960 #define BLOCK_BUFFER_SIZE 16
1961 #endif
1963 // @section serial
1965 // The ASCII buffer for serial input
1966 #define MAX_CMD_SIZE 96
1967 #define BUFSIZE 4
1969 // Transmission to Host Buffer Size
1970 // To save 386 bytes of PROGMEM (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
1971 // To buffer a simple "ok" you need 4 bytes.
1972 // For ADVANCED_OK (M105) you need 32 bytes.
1973 // For debug-echo: 128 bytes for the optimal speed.
1974 // Other output doesn't need to be that speedy.
1975 // :[0, 2, 4, 8, 16, 32, 64, 128, 256]
1976 #define TX_BUFFER_SIZE 0
1978 // Host Receive Buffer Size
1979 // Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
1980 // To use flow control, set this buffer size to at least 1024 bytes.
1981 // :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
1982 //#define RX_BUFFER_SIZE 1024
1984 #if RX_BUFFER_SIZE >= 1024
1985 // Enable to have the controller send XON/XOFF control characters to
1986 // the host to signal the RX buffer is becoming full.
1987 //#define SERIAL_XON_XOFF
1988 #endif
1990 // Add M575 G-code to change the baud rate
1991 //#define BAUD_RATE_GCODE
1993 #if ENABLED(SDSUPPORT)
1994 // Enable this option to collect and display the maximum
1995 // RX queue usage after transferring a file to SD.
1996 //#define SERIAL_STATS_MAX_RX_QUEUED
1998 // Enable this option to collect and display the number
1999 // of dropped bytes after a file transfer to SD.
2000 //#define SERIAL_STATS_DROPPED_RX
2001 #endif
2004 * Emergency Command Parser
2006 * Add a low-level parser to intercept certain commands as they
2007 * enter the serial receive buffer, so they cannot be blocked.
2008 * Currently handles M108, M112, M410, M876
2009 * NOTE: Not yet implemented for all platforms.
2011 //#define EMERGENCY_PARSER
2013 // Bad Serial-connections can miss a received command by sending an 'ok'
2014 // Therefore some clients abort after 30 seconds in a timeout.
2015 // Some other clients start sending commands while receiving a 'wait'.
2016 // This "wait" is only sent when the buffer is empty. 1 second is a good value here.
2017 //#define NO_TIMEOUTS 1000 // Milliseconds
2019 // Some clients will have this feature soon. This could make the NO_TIMEOUTS unnecessary.
2020 //#define ADVANCED_OK
2022 // Printrun may have trouble receiving long strings all at once.
2023 // This option inserts short delays between lines of serial output.
2024 #define SERIAL_OVERRUN_PROTECTION
2026 // For serial echo, the number of digits after the decimal point
2027 //#define SERIAL_FLOAT_PRECISION 4
2029 // @section extras
2032 * Extra Fan Speed
2033 * Adds a secondary fan speed for each print-cooling fan.
2034 * 'M106 P<fan> T3-255' : Set a secondary speed for <fan>
2035 * 'M106 P<fan> T2' : Use the set secondary speed
2036 * 'M106 P<fan> T1' : Restore the previous fan speed
2038 //#define EXTRA_FAN_SPEED
2041 * Firmware-based and LCD-controlled retract
2043 * Add G10 / G11 commands for automatic firmware-based retract / recover.
2044 * Use M207 and M208 to define parameters for retract / recover.
2046 * Use M209 to enable or disable auto-retract.
2047 * With auto-retract enabled, all G1 E moves within the set range
2048 * will be converted to firmware-based retract/recover moves.
2050 * Be sure to turn off auto-retract during filament change.
2052 * Note that M207 / M208 / M209 settings are saved to EEPROM.
2054 //#define FWRETRACT
2055 #if ENABLED(FWRETRACT)
2056 #define FWRETRACT_AUTORETRACT // Override slicer retractions
2057 #if ENABLED(FWRETRACT_AUTORETRACT)
2058 #define MIN_AUTORETRACT 0.1 // (mm) Don't convert E moves under this length
2059 #define MAX_AUTORETRACT 10.0 // (mm) Don't convert E moves over this length
2060 #endif
2061 #define RETRACT_LENGTH 3 // (mm) Default retract length (positive value)
2062 #define RETRACT_LENGTH_SWAP 13 // (mm) Default swap retract length (positive value)
2063 #define RETRACT_FEEDRATE 45 // (mm/s) Default feedrate for retracting
2064 #define RETRACT_ZRAISE 0 // (mm) Default retract Z-raise
2065 #define RETRACT_RECOVER_LENGTH 0 // (mm) Default additional recover length (added to retract length on recover)
2066 #define RETRACT_RECOVER_LENGTH_SWAP 0 // (mm) Default additional swap recover length (added to retract length on recover from toolchange)
2067 #define RETRACT_RECOVER_FEEDRATE 8 // (mm/s) Default feedrate for recovering from retraction
2068 #define RETRACT_RECOVER_FEEDRATE_SWAP 8 // (mm/s) Default feedrate for recovering from swap retraction
2069 #if ENABLED(MIXING_EXTRUDER)
2070 //#define RETRACT_SYNC_MIXING // Retract and restore all mixing steppers simultaneously
2071 #endif
2072 #endif
2075 * Universal tool change settings.
2076 * Applies to all types of extruders except where explicitly noted.
2078 #if HAS_MULTI_EXTRUDER
2079 // Z raise distance for tool-change, as needed for some extruders
2080 #define TOOLCHANGE_ZRAISE 2 // (mm)
2081 //#define TOOLCHANGE_ZRAISE_BEFORE_RETRACT // Apply raise before swap retraction (if enabled)
2082 //#define TOOLCHANGE_NO_RETURN // Never return to previous position on tool-change
2083 #if ENABLED(TOOLCHANGE_NO_RETURN)
2084 //#define EVENT_GCODE_AFTER_TOOLCHANGE "G12X" // Extra G-code to run after tool-change
2085 #endif
2088 * Retract and prime filament on tool-change to reduce
2089 * ooze and stringing and to get cleaner transitions.
2091 //#define TOOLCHANGE_FILAMENT_SWAP
2092 #if ENABLED(TOOLCHANGE_FILAMENT_SWAP)
2093 // Load / Unload
2094 #define TOOLCHANGE_FS_LENGTH 12 // (mm) Load / Unload length
2095 #define TOOLCHANGE_FS_EXTRA_RESUME_LENGTH 0 // (mm) Extra length for better restart, fine tune by LCD/Gcode)
2096 #define TOOLCHANGE_FS_RETRACT_SPEED (50*60) // (mm/min) (Unloading)
2097 #define TOOLCHANGE_FS_UNRETRACT_SPEED (25*60) // (mm/min) (On SINGLENOZZLE or Bowden loading must be slowed down)
2099 // Longer prime to clean out a SINGLENOZZLE
2100 #define TOOLCHANGE_FS_EXTRA_PRIME 0 // (mm) Extra priming length
2101 #define TOOLCHANGE_FS_PRIME_SPEED (4.6*60) // (mm/min) Extra priming feedrate
2102 #define TOOLCHANGE_FS_WIPE_RETRACT 0 // (mm/min) Retract before cooling for less stringing, better wipe, etc.
2104 // Cool after prime to reduce stringing
2105 #define TOOLCHANGE_FS_FAN -1 // Fan index or -1 to skip
2106 #define TOOLCHANGE_FS_FAN_SPEED 255 // 0-255
2107 #define TOOLCHANGE_FS_FAN_TIME 10 // (seconds)
2109 // Swap uninitialized extruder with TOOLCHANGE_FS_PRIME_SPEED for all lengths (recover + prime)
2110 // (May break filament if not retracted beforehand.)
2111 //#define TOOLCHANGE_FS_INIT_BEFORE_SWAP
2113 // Prime on the first T0 (If other, TOOLCHANGE_FS_INIT_BEFORE_SWAP applied)
2114 // Enable it (M217 V[0/1]) before printing, to avoid unwanted priming on host connect
2115 //#define TOOLCHANGE_FS_PRIME_FIRST_USED
2118 * Tool Change Migration
2119 * This feature provides G-code and LCD options to switch tools mid-print.
2120 * All applicable tool properties are migrated so the print can continue.
2121 * Tools must be closely matching and other restrictions may apply.
2122 * Useful to:
2123 * - Change filament color without interruption
2124 * - Switch spools automatically on filament runout
2125 * - Switch to a different nozzle on an extruder jam
2127 #define TOOLCHANGE_MIGRATION_FEATURE
2129 #endif
2132 * Position to park head during tool change.
2133 * Doesn't apply to SWITCHING_TOOLHEAD, DUAL_X_CARRIAGE, or PARKING_EXTRUDER
2135 //#define TOOLCHANGE_PARK
2136 #if ENABLED(TOOLCHANGE_PARK)
2137 #define TOOLCHANGE_PARK_XY { X_MIN_POS + 10, Y_MIN_POS + 10 }
2138 #define TOOLCHANGE_PARK_XY_FEEDRATE 6000 // (mm/min)
2139 //#define TOOLCHANGE_PARK_X_ONLY // X axis only move
2140 //#define TOOLCHANGE_PARK_Y_ONLY // Y axis only move
2141 #endif
2142 #endif // HAS_MULTI_EXTRUDER
2145 * Advanced Pause
2146 * Experimental feature for filament change support and for parking the nozzle when paused.
2147 * Adds the GCode M600 for initiating filament change.
2148 * If PARK_HEAD_ON_PAUSE enabled, adds the GCode M125 to pause printing and park the nozzle.
2150 * Requires an LCD display.
2151 * Requires NOZZLE_PARK_FEATURE.
2152 * This feature is required for the default FILAMENT_RUNOUT_SCRIPT.
2154 //#define ADVANCED_PAUSE_FEATURE
2155 #if ENABLED(ADVANCED_PAUSE_FEATURE)
2156 #define PAUSE_PARK_RETRACT_FEEDRATE 60 // (mm/s) Initial retract feedrate.
2157 #define PAUSE_PARK_RETRACT_LENGTH 2 // (mm) Initial retract.
2158 // This short retract is done immediately, before parking the nozzle.
2159 #define FILAMENT_CHANGE_UNLOAD_FEEDRATE 10 // (mm/s) Unload filament feedrate. This can be pretty fast.
2160 #define FILAMENT_CHANGE_UNLOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
2161 #define FILAMENT_CHANGE_UNLOAD_LENGTH 100 // (mm) The length of filament for a complete unload.
2162 // For Bowden, the full length of the tube and nozzle.
2163 // For direct drive, the full length of the nozzle.
2164 // Set to 0 for manual unloading.
2165 #define FILAMENT_CHANGE_SLOW_LOAD_FEEDRATE 6 // (mm/s) Slow move when starting load.
2166 #define FILAMENT_CHANGE_SLOW_LOAD_LENGTH 0 // (mm) Slow length, to allow time to insert material.
2167 // 0 to disable start loading and skip to fast load only
2168 #define FILAMENT_CHANGE_FAST_LOAD_FEEDRATE 6 // (mm/s) Load filament feedrate. This can be pretty fast.
2169 #define FILAMENT_CHANGE_FAST_LOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
2170 #define FILAMENT_CHANGE_FAST_LOAD_LENGTH 0 // (mm) Load length of filament, from extruder gear to nozzle.
2171 // For Bowden, the full length of the tube and nozzle.
2172 // For direct drive, the full length of the nozzle.
2173 //#define ADVANCED_PAUSE_CONTINUOUS_PURGE // Purge continuously up to the purge length until interrupted.
2174 #define ADVANCED_PAUSE_PURGE_FEEDRATE 3 // (mm/s) Extrude feedrate (after loading). Should be slower than load feedrate.
2175 #define ADVANCED_PAUSE_PURGE_LENGTH 50 // (mm) Length to extrude after loading.
2176 // Set to 0 for manual extrusion.
2177 // Filament can be extruded repeatedly from the Filament Change menu
2178 // until extrusion is consistent, and to purge old filament.
2179 #define ADVANCED_PAUSE_RESUME_PRIME 0 // (mm) Extra distance to prime nozzle after returning from park.
2180 //#define ADVANCED_PAUSE_FANS_PAUSE // Turn off print-cooling fans while the machine is paused.
2182 // Filament Unload does a Retract, Delay, and Purge first:
2183 #define FILAMENT_UNLOAD_PURGE_RETRACT 13 // (mm) Unload initial retract length.
2184 #define FILAMENT_UNLOAD_PURGE_DELAY 5000 // (ms) Delay for the filament to cool after retract.
2185 #define FILAMENT_UNLOAD_PURGE_LENGTH 8 // (mm) An unretract is done, then this length is purged.
2186 #define FILAMENT_UNLOAD_PURGE_FEEDRATE 25 // (mm/s) feedrate to purge before unload
2188 #define PAUSE_PARK_NOZZLE_TIMEOUT 45 // (seconds) Time limit before the nozzle is turned off for safety.
2189 #define FILAMENT_CHANGE_ALERT_BEEPS 10 // Number of alert beeps to play when a response is needed.
2190 #define PAUSE_PARK_NO_STEPPER_TIMEOUT // Enable for XYZ steppers to stay powered on during filament change.
2192 //#define PARK_HEAD_ON_PAUSE // Park the nozzle during pause and filament change.
2193 //#define HOME_BEFORE_FILAMENT_CHANGE // If needed, home before parking for filament change
2195 //#define FILAMENT_LOAD_UNLOAD_GCODES // Add M701/M702 Load/Unload G-codes, plus Load/Unload in the LCD Prepare menu.
2196 //#define FILAMENT_UNLOAD_ALL_EXTRUDERS // Allow M702 to unload all extruders above a minimum target temp (as set by M302)
2197 #endif
2199 // @section tmc
2202 * TMC26X Stepper Driver options
2204 * The TMC26XStepper library is required for this stepper driver.
2205 * https://github.com/trinamic/TMC26XStepper
2207 #if HAS_DRIVER(TMC26X)
2209 #if AXIS_DRIVER_TYPE_X(TMC26X)
2210 #define X_MAX_CURRENT 1000 // (mA)
2211 #define X_SENSE_RESISTOR 91 // (mOhms)
2212 #define X_MICROSTEPS 16 // Number of microsteps
2213 #endif
2215 #if AXIS_DRIVER_TYPE_X2(TMC26X)
2216 #define X2_MAX_CURRENT 1000
2217 #define X2_SENSE_RESISTOR 91
2218 #define X2_MICROSTEPS 16
2219 #endif
2221 #if AXIS_DRIVER_TYPE_Y(TMC26X)
2222 #define Y_MAX_CURRENT 1000
2223 #define Y_SENSE_RESISTOR 91
2224 #define Y_MICROSTEPS 16
2225 #endif
2227 #if AXIS_DRIVER_TYPE_Y2(TMC26X)
2228 #define Y2_MAX_CURRENT 1000
2229 #define Y2_SENSE_RESISTOR 91
2230 #define Y2_MICROSTEPS 16
2231 #endif
2233 #if AXIS_DRIVER_TYPE_Z(TMC26X)
2234 #define Z_MAX_CURRENT 1000
2235 #define Z_SENSE_RESISTOR 91
2236 #define Z_MICROSTEPS 16
2237 #endif
2239 #if AXIS_DRIVER_TYPE_Z2(TMC26X)
2240 #define Z2_MAX_CURRENT 1000
2241 #define Z2_SENSE_RESISTOR 91
2242 #define Z2_MICROSTEPS 16
2243 #endif
2245 #if AXIS_DRIVER_TYPE_Z3(TMC26X)
2246 #define Z3_MAX_CURRENT 1000
2247 #define Z3_SENSE_RESISTOR 91
2248 #define Z3_MICROSTEPS 16
2249 #endif
2251 #if AXIS_DRIVER_TYPE_Z4(TMC26X)
2252 #define Z4_MAX_CURRENT 1000
2253 #define Z4_SENSE_RESISTOR 91
2254 #define Z4_MICROSTEPS 16
2255 #endif
2257 #if AXIS_DRIVER_TYPE_E0(TMC26X)
2258 #define E0_MAX_CURRENT 1000
2259 #define E0_SENSE_RESISTOR 91
2260 #define E0_MICROSTEPS 16
2261 #endif
2263 #if AXIS_DRIVER_TYPE_E1(TMC26X)
2264 #define E1_MAX_CURRENT 1000
2265 #define E1_SENSE_RESISTOR 91
2266 #define E1_MICROSTEPS 16
2267 #endif
2269 #if AXIS_DRIVER_TYPE_E2(TMC26X)
2270 #define E2_MAX_CURRENT 1000
2271 #define E2_SENSE_RESISTOR 91
2272 #define E2_MICROSTEPS 16
2273 #endif
2275 #if AXIS_DRIVER_TYPE_E3(TMC26X)
2276 #define E3_MAX_CURRENT 1000
2277 #define E3_SENSE_RESISTOR 91
2278 #define E3_MICROSTEPS 16
2279 #endif
2281 #if AXIS_DRIVER_TYPE_E4(TMC26X)
2282 #define E4_MAX_CURRENT 1000
2283 #define E4_SENSE_RESISTOR 91
2284 #define E4_MICROSTEPS 16
2285 #endif
2287 #if AXIS_DRIVER_TYPE_E5(TMC26X)
2288 #define E5_MAX_CURRENT 1000
2289 #define E5_SENSE_RESISTOR 91
2290 #define E5_MICROSTEPS 16
2291 #endif
2293 #if AXIS_DRIVER_TYPE_E6(TMC26X)
2294 #define E6_MAX_CURRENT 1000
2295 #define E6_SENSE_RESISTOR 91
2296 #define E6_MICROSTEPS 16
2297 #endif
2299 #if AXIS_DRIVER_TYPE_E7(TMC26X)
2300 #define E7_MAX_CURRENT 1000
2301 #define E7_SENSE_RESISTOR 91
2302 #define E7_MICROSTEPS 16
2303 #endif
2305 #endif // TMC26X
2307 // @section tmc_smart
2310 * To use TMC2130, TMC2160, TMC2660, TMC5130, TMC5160 stepper drivers in SPI mode
2311 * connect your SPI pins to the hardware SPI interface on your board and define
2312 * the required CS pins in your `pins_MYBOARD.h` file. (e.g., RAMPS 1.4 uses AUX3
2313 * pins `X_CS_PIN 53`, `Y_CS_PIN 49`, etc.).
2314 * You may also use software SPI if you wish to use general purpose IO pins.
2316 * To use TMC2208 stepper UART-configurable stepper drivers connect #_SERIAL_TX_PIN
2317 * to the driver side PDN_UART pin with a 1K resistor.
2318 * To use the reading capabilities, also connect #_SERIAL_RX_PIN to PDN_UART without
2319 * a resistor.
2320 * The drivers can also be used with hardware serial.
2322 * TMCStepper library is required to use TMC stepper drivers.
2323 * https://github.com/teemuatlut/TMCStepper
2325 #if HAS_TRINAMIC_CONFIG
2327 #define HOLD_MULTIPLIER 0.5 // Scales down the holding current from run current
2330 * Interpolate microsteps to 256
2331 * Override for each driver with <driver>_INTERPOLATE settings below
2333 #define INTERPOLATE true
2335 #if AXIS_IS_TMC(X)
2336 #define X_CURRENT 800 // (mA) RMS current. Multiply by 1.414 for peak current.
2337 #define X_CURRENT_HOME X_CURRENT // (mA) RMS current for sensorless homing
2338 #define X_MICROSTEPS 16 // 0..256
2339 #define X_RSENSE 0.11
2340 #define X_CHAIN_POS -1 // -1..0: Not chained. 1: MCU MOSI connected. 2: Next in chain, ...
2341 //#define X_INTERPOLATE true // Enable to override 'INTERPOLATE' for the X axis
2342 #endif
2344 #if AXIS_IS_TMC(X2)
2345 #define X2_CURRENT 800
2346 #define X2_CURRENT_HOME X2_CURRENT
2347 #define X2_MICROSTEPS 16
2348 #define X2_RSENSE 0.11
2349 #define X2_CHAIN_POS -1
2350 //#define X2_INTERPOLATE true
2351 #endif
2353 #if AXIS_IS_TMC(Y)
2354 #define Y_CURRENT 800
2355 #define Y_CURRENT_HOME Y_CURRENT
2356 #define Y_MICROSTEPS 16
2357 #define Y_RSENSE 0.11
2358 #define Y_CHAIN_POS -1
2359 //#define Y_INTERPOLATE true
2360 #endif
2362 #if AXIS_IS_TMC(Y2)
2363 #define Y2_CURRENT 800
2364 #define Y2_CURRENT_HOME Y2_CURRENT
2365 #define Y2_MICROSTEPS 16
2366 #define Y2_RSENSE 0.11
2367 #define Y2_CHAIN_POS -1
2368 //#define Y2_INTERPOLATE true
2369 #endif
2371 #if AXIS_IS_TMC(Z)
2372 #define Z_CURRENT 800
2373 #define Z_CURRENT_HOME Z_CURRENT
2374 #define Z_MICROSTEPS 16
2375 #define Z_RSENSE 0.11
2376 #define Z_CHAIN_POS -1
2377 //#define Z_INTERPOLATE true
2378 #endif
2380 #if AXIS_IS_TMC(Z2)
2381 #define Z2_CURRENT 800
2382 #define Z2_CURRENT_HOME Z2_CURRENT
2383 #define Z2_MICROSTEPS 16
2384 #define Z2_RSENSE 0.11
2385 #define Z2_CHAIN_POS -1
2386 //#define Z2_INTERPOLATE true
2387 #endif
2389 #if AXIS_IS_TMC(Z3)
2390 #define Z3_CURRENT 800
2391 #define Z3_CURRENT_HOME Z3_CURRENT
2392 #define Z3_MICROSTEPS 16
2393 #define Z3_RSENSE 0.11
2394 #define Z3_CHAIN_POS -1
2395 //#define Z3_INTERPOLATE true
2396 #endif
2398 #if AXIS_IS_TMC(Z4)
2399 #define Z4_CURRENT 800
2400 #define Z4_CURRENT_HOME Z4_CURRENT
2401 #define Z4_MICROSTEPS 16
2402 #define Z4_RSENSE 0.11
2403 #define Z4_CHAIN_POS -1
2404 //#define Z4_INTERPOLATE true
2405 #endif
2407 #if AXIS_IS_TMC(E0)
2408 #define E0_CURRENT 800
2409 #define E0_MICROSTEPS 16
2410 #define E0_RSENSE 0.11
2411 #define E0_CHAIN_POS -1
2412 //#define E0_INTERPOLATE true
2413 #endif
2415 #if AXIS_IS_TMC(E1)
2416 #define E1_CURRENT 800
2417 #define E1_MICROSTEPS 16
2418 #define E1_RSENSE 0.11
2419 #define E1_CHAIN_POS -1
2420 //#define E1_INTERPOLATE true
2421 #endif
2423 #if AXIS_IS_TMC(E2)
2424 #define E2_CURRENT 800
2425 #define E2_MICROSTEPS 16
2426 #define E2_RSENSE 0.11
2427 #define E2_CHAIN_POS -1
2428 //#define E2_INTERPOLATE true
2429 #endif
2431 #if AXIS_IS_TMC(E3)
2432 #define E3_CURRENT 800
2433 #define E3_MICROSTEPS 16
2434 #define E3_RSENSE 0.11
2435 #define E3_CHAIN_POS -1
2436 //#define E3_INTERPOLATE true
2437 #endif
2439 #if AXIS_IS_TMC(E4)
2440 #define E4_CURRENT 800
2441 #define E4_MICROSTEPS 16
2442 #define E4_RSENSE 0.11
2443 #define E4_CHAIN_POS -1
2444 //#define E4_INTERPOLATE true
2445 #endif
2447 #if AXIS_IS_TMC(E5)
2448 #define E5_CURRENT 800
2449 #define E5_MICROSTEPS 16
2450 #define E5_RSENSE 0.11
2451 #define E5_CHAIN_POS -1
2452 //#define E5_INTERPOLATE true
2453 #endif
2455 #if AXIS_IS_TMC(E6)
2456 #define E6_CURRENT 800
2457 #define E6_MICROSTEPS 16
2458 #define E6_RSENSE 0.11
2459 #define E6_CHAIN_POS -1
2460 //#define E6_INTERPOLATE true
2461 #endif
2463 #if AXIS_IS_TMC(E7)
2464 #define E7_CURRENT 800
2465 #define E7_MICROSTEPS 16
2466 #define E7_RSENSE 0.11
2467 #define E7_CHAIN_POS -1
2468 //#define E7_INTERPOLATE true
2469 #endif
2472 * Override default SPI pins for TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160 drivers here.
2473 * The default pins can be found in your board's pins file.
2475 //#define X_CS_PIN -1
2476 //#define Y_CS_PIN -1
2477 //#define Z_CS_PIN -1
2478 //#define X2_CS_PIN -1
2479 //#define Y2_CS_PIN -1
2480 //#define Z2_CS_PIN -1
2481 //#define Z3_CS_PIN -1
2482 //#define E0_CS_PIN -1
2483 //#define E1_CS_PIN -1
2484 //#define E2_CS_PIN -1
2485 //#define E3_CS_PIN -1
2486 //#define E4_CS_PIN -1
2487 //#define E5_CS_PIN -1
2488 //#define E6_CS_PIN -1
2489 //#define E7_CS_PIN -1
2492 * Software option for SPI driven drivers (TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160).
2493 * The default SW SPI pins are defined the respective pins files,
2494 * but you can override or define them here.
2496 //#define TMC_USE_SW_SPI
2497 //#define TMC_SW_MOSI -1
2498 //#define TMC_SW_MISO -1
2499 //#define TMC_SW_SCK -1
2502 * Four TMC2209 drivers can use the same HW/SW serial port with hardware configured addresses.
2503 * Set the address using jumpers on pins MS1 and MS2.
2504 * Address | MS1 | MS2
2505 * 0 | LOW | LOW
2506 * 1 | HIGH | LOW
2507 * 2 | LOW | HIGH
2508 * 3 | HIGH | HIGH
2510 * Set *_SERIAL_TX_PIN and *_SERIAL_RX_PIN to match for all drivers
2511 * on the same serial port, either here or in your board's pins file.
2513 //#define X_SLAVE_ADDRESS 0
2514 //#define Y_SLAVE_ADDRESS 0
2515 //#define Z_SLAVE_ADDRESS 0
2516 //#define X2_SLAVE_ADDRESS 0
2517 //#define Y2_SLAVE_ADDRESS 0
2518 //#define Z2_SLAVE_ADDRESS 0
2519 //#define Z3_SLAVE_ADDRESS 0
2520 //#define Z4_SLAVE_ADDRESS 0
2521 //#define E0_SLAVE_ADDRESS 0
2522 //#define E1_SLAVE_ADDRESS 0
2523 //#define E2_SLAVE_ADDRESS 0
2524 //#define E3_SLAVE_ADDRESS 0
2525 //#define E4_SLAVE_ADDRESS 0
2526 //#define E5_SLAVE_ADDRESS 0
2527 //#define E6_SLAVE_ADDRESS 0
2528 //#define E7_SLAVE_ADDRESS 0
2531 * Software enable
2533 * Use for drivers that do not use a dedicated enable pin, but rather handle the same
2534 * function through a communication line such as SPI or UART.
2536 //#define SOFTWARE_DRIVER_ENABLE
2539 * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
2540 * Use Trinamic's ultra quiet stepping mode.
2541 * When disabled, Marlin will use spreadCycle stepping mode.
2543 #define STEALTHCHOP_XY
2544 #define STEALTHCHOP_Z
2545 #define STEALTHCHOP_E
2548 * Optimize spreadCycle chopper parameters by using predefined parameter sets
2549 * or with the help of an example included in the library.
2550 * Provided parameter sets are
2551 * CHOPPER_DEFAULT_12V
2552 * CHOPPER_DEFAULT_19V
2553 * CHOPPER_DEFAULT_24V
2554 * CHOPPER_DEFAULT_36V
2555 * CHOPPER_09STEP_24V // 0.9 degree steppers (24V)
2556 * CHOPPER_PRUSAMK3_24V // Imported parameters from the official Průša firmware for MK3 (24V)
2557 * CHOPPER_MARLIN_119 // Old defaults from Marlin v1.1.9
2559 * Define your own with:
2560 * { <off_time[1..15]>, <hysteresis_end[-3..12]>, hysteresis_start[1..8] }
2562 #define CHOPPER_TIMING CHOPPER_DEFAULT_12V // All axes (override below)
2563 //#define CHOPPER_TIMING_X CHOPPER_DEFAULT_12V // For X Axes (override below)
2564 //#define CHOPPER_TIMING_X2 CHOPPER_DEFAULT_12V
2565 //#define CHOPPER_TIMING_Y CHOPPER_DEFAULT_12V // For Y Axes (override below)
2566 //#define CHOPPER_TIMING_Y2 CHOPPER_DEFAULT_12V
2567 //#define CHOPPER_TIMING_Z CHOPPER_DEFAULT_12V // For Z Axes (override below)
2568 //#define CHOPPER_TIMING_Z2 CHOPPER_DEFAULT_12V
2569 //#define CHOPPER_TIMING_Z3 CHOPPER_DEFAULT_12V
2570 //#define CHOPPER_TIMING_Z4 CHOPPER_DEFAULT_12V
2571 //#define CHOPPER_TIMING_E CHOPPER_DEFAULT_12V // For Extruders (override below)
2572 //#define CHOPPER_TIMING_E1 CHOPPER_DEFAULT_12V
2573 //#define CHOPPER_TIMING_E2 CHOPPER_DEFAULT_12V
2574 //#define CHOPPER_TIMING_E3 CHOPPER_DEFAULT_12V
2575 //#define CHOPPER_TIMING_E4 CHOPPER_DEFAULT_12V
2576 //#define CHOPPER_TIMING_E5 CHOPPER_DEFAULT_12V
2577 //#define CHOPPER_TIMING_E6 CHOPPER_DEFAULT_12V
2578 //#define CHOPPER_TIMING_E7 CHOPPER_DEFAULT_12V
2581 * Monitor Trinamic drivers
2582 * for error conditions like overtemperature and short to ground.
2583 * To manage over-temp Marlin can decrease the driver current until the error condition clears.
2584 * Other detected conditions can be used to stop the current print.
2585 * Relevant G-codes:
2586 * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given.
2587 * M911 - Report stepper driver overtemperature pre-warn condition.
2588 * M912 - Clear stepper driver overtemperature pre-warn condition flag.
2589 * M122 - Report driver parameters (Requires TMC_DEBUG)
2591 //#define MONITOR_DRIVER_STATUS
2593 #if ENABLED(MONITOR_DRIVER_STATUS)
2594 #define CURRENT_STEP_DOWN 50 // [mA]
2595 #define REPORT_CURRENT_CHANGE
2596 #define STOP_ON_ERROR
2597 #endif
2600 * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
2601 * The driver will switch to spreadCycle when stepper speed is over HYBRID_THRESHOLD.
2602 * This mode allows for faster movements at the expense of higher noise levels.
2603 * STEALTHCHOP_(XY|Z|E) must be enabled to use HYBRID_THRESHOLD.
2604 * M913 X/Y/Z/E to live tune the setting
2606 //#define HYBRID_THRESHOLD
2608 #define X_HYBRID_THRESHOLD 100 // [mm/s]
2609 #define X2_HYBRID_THRESHOLD 100
2610 #define Y_HYBRID_THRESHOLD 100
2611 #define Y2_HYBRID_THRESHOLD 100
2612 #define Z_HYBRID_THRESHOLD 3
2613 #define Z2_HYBRID_THRESHOLD 3
2614 #define Z3_HYBRID_THRESHOLD 3
2615 #define Z4_HYBRID_THRESHOLD 3
2616 #define E0_HYBRID_THRESHOLD 30
2617 #define E1_HYBRID_THRESHOLD 30
2618 #define E2_HYBRID_THRESHOLD 30
2619 #define E3_HYBRID_THRESHOLD 30
2620 #define E4_HYBRID_THRESHOLD 30
2621 #define E5_HYBRID_THRESHOLD 30
2622 #define E6_HYBRID_THRESHOLD 30
2623 #define E7_HYBRID_THRESHOLD 30
2626 * Use StallGuard to home / probe X, Y, Z.
2628 * TMC2130, TMC2160, TMC2209, TMC2660, TMC5130, and TMC5160 only
2629 * Connect the stepper driver's DIAG1 pin to the X/Y endstop pin.
2630 * X, Y, and Z homing will always be done in spreadCycle mode.
2632 * X/Y/Z_STALL_SENSITIVITY is the default stall threshold.
2633 * Use M914 X Y Z to set the stall threshold at runtime:
2635 * Sensitivity TMC2209 Others
2636 * HIGHEST 255 -64 (Too sensitive => False positive)
2637 * LOWEST 0 63 (Too insensitive => No trigger)
2639 * It is recommended to set HOMING_BUMP_MM to { 0, 0, 0 }.
2641 * SPI_ENDSTOPS *** Beta feature! *** TMC2130 Only ***
2642 * Poll the driver through SPI to determine load when homing.
2643 * Removes the need for a wire from DIAG1 to an endstop pin.
2645 * IMPROVE_HOMING_RELIABILITY tunes acceleration and jerk when
2646 * homing and adds a guard period for endstop triggering.
2648 * Comment *_STALL_SENSITIVITY to disable sensorless homing for that axis.
2650 //#define SENSORLESS_HOMING // StallGuard capable drivers only
2652 #if EITHER(SENSORLESS_HOMING, SENSORLESS_PROBING)
2653 // TMC2209: 0...255. TMC2130: -64...63
2654 #define X_STALL_SENSITIVITY 8
2655 #define X2_STALL_SENSITIVITY X_STALL_SENSITIVITY
2656 #define Y_STALL_SENSITIVITY 8
2657 #define Y2_STALL_SENSITIVITY Y_STALL_SENSITIVITY
2658 //#define Z_STALL_SENSITIVITY 8
2659 //#define Z2_STALL_SENSITIVITY Z_STALL_SENSITIVITY
2660 //#define Z3_STALL_SENSITIVITY Z_STALL_SENSITIVITY
2661 //#define Z4_STALL_SENSITIVITY Z_STALL_SENSITIVITY
2662 //#define SPI_ENDSTOPS // TMC2130 only
2663 //#define IMPROVE_HOMING_RELIABILITY
2664 #endif
2667 * TMC Homing stepper phase.
2669 * Improve homing repeatability by homing to stepper coil's nearest absolute
2670 * phase position. Trinamic drivers use a stepper phase table with 1024 values
2671 * spanning 4 full steps with 256 positions each (ergo, 1024 positions).
2672 * Full step positions (128, 384, 640, 896) have the highest holding torque.
2674 * Values from 0..1023, -1 to disable homing phase for that axis.
2676 //#define TMC_HOME_PHASE { 896, 896, 896 }
2679 * Beta feature!
2680 * Create a 50/50 square wave step pulse optimal for stepper drivers.
2682 //#define SQUARE_WAVE_STEPPING
2685 * Enable M122 debugging command for TMC stepper drivers.
2686 * M122 S0/1 will enable continous reporting.
2688 //#define TMC_DEBUG
2691 * You can set your own advanced settings by filling in predefined functions.
2692 * A list of available functions can be found on the library github page
2693 * https://github.com/teemuatlut/TMCStepper
2695 * Example:
2696 * #define TMC_ADV() { \
2697 * stepperX.diag0_otpw(1); \
2698 * stepperY.intpol(0); \
2701 #define TMC_ADV() { }
2703 #endif // HAS_TRINAMIC_CONFIG
2705 // @section L64XX
2708 * L64XX Stepper Driver options
2710 * Arduino-L6470 library (0.8.0 or higher) is required.
2711 * https://github.com/ameyer/Arduino-L6470
2713 * Requires the following to be defined in your pins_YOUR_BOARD file
2714 * L6470_CHAIN_SCK_PIN
2715 * L6470_CHAIN_MISO_PIN
2716 * L6470_CHAIN_MOSI_PIN
2717 * L6470_CHAIN_SS_PIN
2718 * ENABLE_RESET_L64XX_CHIPS(Q) where Q is 1 to enable and 0 to reset
2721 #if HAS_L64XX
2723 //#define L6470_CHITCHAT // Display additional status info
2725 #if AXIS_IS_L64XX(X)
2726 #define X_MICROSTEPS 128 // Number of microsteps (VALID: 1, 2, 4, 8, 16, 32, 128) - L6474 max is 16
2727 #define X_OVERCURRENT 2000 // (mA) Current where the driver detects an over current
2728 // L6470 & L6474 - VALID: 375 x (1 - 16) - 6A max - rounds down
2729 // POWERSTEP01: VALID: 1000 x (1 - 32) - 32A max - rounds down
2730 #define X_STALLCURRENT 1500 // (mA) Current where the driver detects a stall (VALID: 31.25 * (1-128) - 4A max - rounds down)
2731 // L6470 & L6474 - VALID: 31.25 * (1-128) - 4A max - rounds down
2732 // POWERSTEP01: VALID: 200 x (1 - 32) - 6.4A max - rounds down
2733 // L6474 - STALLCURRENT setting is used to set the nominal (TVAL) current
2734 #define X_MAX_VOLTAGE 127 // 0-255, Maximum effective voltage seen by stepper - not used by L6474
2735 #define X_CHAIN_POS -1 // Position in SPI chain, 0=Not in chain, 1=Nearest MOSI
2736 #define X_SLEW_RATE 1 // 0-3, Slew 0 is slowest, 3 is fastest
2737 #endif
2739 #if AXIS_IS_L64XX(X2)
2740 #define X2_MICROSTEPS 128
2741 #define X2_OVERCURRENT 2000
2742 #define X2_STALLCURRENT 1500
2743 #define X2_MAX_VOLTAGE 127
2744 #define X2_CHAIN_POS -1
2745 #define X2_SLEW_RATE 1
2746 #endif
2748 #if AXIS_IS_L64XX(Y)
2749 #define Y_MICROSTEPS 128
2750 #define Y_OVERCURRENT 2000
2751 #define Y_STALLCURRENT 1500
2752 #define Y_MAX_VOLTAGE 127
2753 #define Y_CHAIN_POS -1
2754 #define Y_SLEW_RATE 1
2755 #endif
2757 #if AXIS_IS_L64XX(Y2)
2758 #define Y2_MICROSTEPS 128
2759 #define Y2_OVERCURRENT 2000
2760 #define Y2_STALLCURRENT 1500
2761 #define Y2_MAX_VOLTAGE 127
2762 #define Y2_CHAIN_POS -1
2763 #define Y2_SLEW_RATE 1
2764 #endif
2766 #if AXIS_IS_L64XX(Z)
2767 #define Z_MICROSTEPS 128
2768 #define Z_OVERCURRENT 2000
2769 #define Z_STALLCURRENT 1500
2770 #define Z_MAX_VOLTAGE 127
2771 #define Z_CHAIN_POS -1
2772 #define Z_SLEW_RATE 1
2773 #endif
2775 #if AXIS_IS_L64XX(Z2)
2776 #define Z2_MICROSTEPS 128
2777 #define Z2_OVERCURRENT 2000
2778 #define Z2_STALLCURRENT 1500
2779 #define Z2_MAX_VOLTAGE 127
2780 #define Z2_CHAIN_POS -1
2781 #define Z2_SLEW_RATE 1
2782 #endif
2784 #if AXIS_IS_L64XX(Z3)
2785 #define Z3_MICROSTEPS 128
2786 #define Z3_OVERCURRENT 2000
2787 #define Z3_STALLCURRENT 1500
2788 #define Z3_MAX_VOLTAGE 127
2789 #define Z3_CHAIN_POS -1
2790 #define Z3_SLEW_RATE 1
2791 #endif
2793 #if AXIS_IS_L64XX(Z4)
2794 #define Z4_MICROSTEPS 128
2795 #define Z4_OVERCURRENT 2000
2796 #define Z4_STALLCURRENT 1500
2797 #define Z4_MAX_VOLTAGE 127
2798 #define Z4_CHAIN_POS -1
2799 #define Z4_SLEW_RATE 1
2800 #endif
2802 #if AXIS_IS_L64XX(E0)
2803 #define E0_MICROSTEPS 128
2804 #define E0_OVERCURRENT 2000
2805 #define E0_STALLCURRENT 1500
2806 #define E0_MAX_VOLTAGE 127
2807 #define E0_CHAIN_POS -1
2808 #define E0_SLEW_RATE 1
2809 #endif
2811 #if AXIS_IS_L64XX(E1)
2812 #define E1_MICROSTEPS 128
2813 #define E1_OVERCURRENT 2000
2814 #define E1_STALLCURRENT 1500
2815 #define E1_MAX_VOLTAGE 127
2816 #define E1_CHAIN_POS -1
2817 #define E1_SLEW_RATE 1
2818 #endif
2820 #if AXIS_IS_L64XX(E2)
2821 #define E2_MICROSTEPS 128
2822 #define E2_OVERCURRENT 2000
2823 #define E2_STALLCURRENT 1500
2824 #define E2_MAX_VOLTAGE 127
2825 #define E2_CHAIN_POS -1
2826 #define E2_SLEW_RATE 1
2827 #endif
2829 #if AXIS_IS_L64XX(E3)
2830 #define E3_MICROSTEPS 128
2831 #define E3_OVERCURRENT 2000
2832 #define E3_STALLCURRENT 1500
2833 #define E3_MAX_VOLTAGE 127
2834 #define E3_CHAIN_POS -1
2835 #define E3_SLEW_RATE 1
2836 #endif
2838 #if AXIS_IS_L64XX(E4)
2839 #define E4_MICROSTEPS 128
2840 #define E4_OVERCURRENT 2000
2841 #define E4_STALLCURRENT 1500
2842 #define E4_MAX_VOLTAGE 127
2843 #define E4_CHAIN_POS -1
2844 #define E4_SLEW_RATE 1
2845 #endif
2847 #if AXIS_IS_L64XX(E5)
2848 #define E5_MICROSTEPS 128
2849 #define E5_OVERCURRENT 2000
2850 #define E5_STALLCURRENT 1500
2851 #define E5_MAX_VOLTAGE 127
2852 #define E5_CHAIN_POS -1
2853 #define E5_SLEW_RATE 1
2854 #endif
2856 #if AXIS_IS_L64XX(E6)
2857 #define E6_MICROSTEPS 128
2858 #define E6_OVERCURRENT 2000
2859 #define E6_STALLCURRENT 1500
2860 #define E6_MAX_VOLTAGE 127
2861 #define E6_CHAIN_POS -1
2862 #define E6_SLEW_RATE 1
2863 #endif
2865 #if AXIS_IS_L64XX(E7)
2866 #define E7_MICROSTEPS 128
2867 #define E7_OVERCURRENT 2000
2868 #define E7_STALLCURRENT 1500
2869 #define E7_MAX_VOLTAGE 127
2870 #define E7_CHAIN_POS -1
2871 #define E7_SLEW_RATE 1
2872 #endif
2875 * Monitor L6470 drivers for error conditions like over temperature and over current.
2876 * In the case of over temperature Marlin can decrease the drive until the error condition clears.
2877 * Other detected conditions can be used to stop the current print.
2878 * Relevant G-codes:
2879 * 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.
2880 * I not present or I0 or I1 - X, Y, Z or E0
2881 * I2 - X2, Y2, Z2 or E1
2882 * I3 - Z3 or E3
2883 * I4 - Z4 or E4
2884 * I5 - E5
2885 * M916 - Increase drive level until get thermal warning
2886 * M917 - Find minimum current thresholds
2887 * M918 - Increase speed until max or error
2888 * M122 S0/1 - Report driver parameters
2890 //#define MONITOR_L6470_DRIVER_STATUS
2892 #if ENABLED(MONITOR_L6470_DRIVER_STATUS)
2893 #define KVAL_HOLD_STEP_DOWN 1
2894 //#define L6470_STOP_ON_ERROR
2895 #endif
2897 #endif // HAS_L64XX
2899 // @section i2cbus
2902 // I2C Master ID for LPC176x LCD and Digital Current control
2903 // Does not apply to other peripherals based on the Wire library.
2905 //#define I2C_MASTER_ID 1 // Set a value from 0 to 2
2908 * TWI/I2C BUS
2910 * This feature is an EXPERIMENTAL feature so it shall not be used on production
2911 * machines. Enabling this will allow you to send and receive I2C data from slave
2912 * devices on the bus.
2914 * ; Example #1
2915 * ; This macro send the string "Marlin" to the slave device with address 0x63 (99)
2916 * ; It uses multiple M260 commands with one B<base 10> arg
2917 * M260 A99 ; Target slave address
2918 * M260 B77 ; M
2919 * M260 B97 ; a
2920 * M260 B114 ; r
2921 * M260 B108 ; l
2922 * M260 B105 ; i
2923 * M260 B110 ; n
2924 * M260 S1 ; Send the current buffer
2926 * ; Example #2
2927 * ; Request 6 bytes from slave device with address 0x63 (99)
2928 * M261 A99 B5
2930 * ; Example #3
2931 * ; Example serial output of a M261 request
2932 * echo:i2c-reply: from:99 bytes:5 data:hello
2935 //#define EXPERIMENTAL_I2CBUS
2936 #if ENABLED(EXPERIMENTAL_I2CBUS)
2937 #define I2C_SLAVE_ADDRESS 0 // Set a value from 8 to 127 to act as a slave
2938 #endif
2940 // @section extras
2943 * Photo G-code
2944 * Add the M240 G-code to take a photo.
2945 * The photo can be triggered by a digital pin or a physical movement.
2947 //#define PHOTO_GCODE
2948 #if ENABLED(PHOTO_GCODE)
2949 // A position to move to (and raise Z) before taking the photo
2950 //#define PHOTO_POSITION { X_MAX_POS - 5, Y_MAX_POS, 0 } // { xpos, ypos, zraise } (M240 X Y Z)
2951 //#define PHOTO_DELAY_MS 100 // (ms) Duration to pause before moving back (M240 P)
2952 //#define PHOTO_RETRACT_MM 6.5 // (mm) E retract/recover for the photo move (M240 R S)
2954 // Canon RC-1 or homebrew digital camera trigger
2955 // Data from: https://www.doc-diy.net/photo/rc-1_hacked/
2956 //#define PHOTOGRAPH_PIN 23
2958 // Canon Hack Development Kit
2959 // https://captain-slow.dk/2014/03/09/3d-printing-timelapses/
2960 //#define CHDK_PIN 4
2962 // Optional second move with delay to trigger the camera shutter
2963 //#define PHOTO_SWITCH_POSITION { X_MAX_POS, Y_MAX_POS } // { xpos, ypos } (M240 I J)
2965 // Duration to hold the switch or keep CHDK_PIN high
2966 //#define PHOTO_SWITCH_MS 50 // (ms) (M240 D)
2969 * PHOTO_PULSES_US may need adjustment depending on board and camera model.
2970 * Pin must be running at 48.4kHz.
2971 * Be sure to use a PHOTOGRAPH_PIN which can rise and fall quick enough.
2972 * (e.g., MKS SBase temp sensor pin was too slow, so used P1.23 on J8.)
2974 * Example pulse data for Nikon: https://bit.ly/2FKD0Aq
2975 * IR Wiring: https://git.io/JvJf7
2977 //#define PHOTO_PULSES_US { 2000, 27850, 400, 1580, 400, 3580, 400 } // (µs) Durations for each 48.4kHz oscillation
2978 #ifdef PHOTO_PULSES_US
2979 #define PHOTO_PULSE_DELAY_US 13 // (µs) Approximate duration of each HIGH and LOW pulse in the oscillation
2980 #endif
2981 #endif
2984 * Spindle & Laser control
2986 * Add the M3, M4, and M5 commands to turn the spindle/laser on and off, and
2987 * to set spindle speed, spindle direction, and laser power.
2989 * SuperPid is a router/spindle speed controller used in the CNC milling community.
2990 * Marlin can be used to turn the spindle on and off. It can also be used to set
2991 * the spindle speed from 5,000 to 30,000 RPM.
2993 * You'll need to select a pin for the ON/OFF function and optionally choose a 0-5V
2994 * hardware PWM pin for the speed control and a pin for the rotation direction.
2996 * See https://marlinfw.org/docs/configuration/laser_spindle.html for more config details.
2998 //#define SPINDLE_FEATURE
2999 //#define LASER_FEATURE
3000 #if EITHER(SPINDLE_FEATURE, LASER_FEATURE)
3001 #define SPINDLE_LASER_ACTIVE_STATE LOW // Set to "HIGH" if the on/off function is active HIGH
3002 #define SPINDLE_LASER_PWM true // Set to "true" if your controller supports setting the speed/power
3003 #define SPINDLE_LASER_PWM_INVERT false // Set to "true" if the speed/power goes up when you want it to go slower
3005 #define SPINDLE_LASER_FREQUENCY 2500 // (Hz) Spindle/laser frequency (only on supported HALs: AVR and LPC)
3007 //#define SPINDLE_SERVO // A servo converting an angle to spindle power
3008 #ifdef SPINDLE_SERVO
3009 #define SPINDLE_SERVO_NR 0 // Index of servo used for spindle control
3010 #define SPINDLE_SERVO_MIN 10 // Minimum angle for servo spindle
3011 #endif
3014 * Speed / Power can be set ('M3 S') and displayed in terms of:
3015 * - PWM255 (S0 - S255)
3016 * - PERCENT (S0 - S100)
3017 * - RPM (S0 - S50000) Best for use with a spindle
3018 * - SERVO (S0 - S180)
3020 #define CUTTER_POWER_UNIT PWM255
3023 * Relative Cutter Power
3024 * Normally, 'M3 O<power>' sets
3025 * OCR power is relative to the range SPEED_POWER_MIN...SPEED_POWER_MAX.
3026 * so input powers of 0...255 correspond to SPEED_POWER_MIN...SPEED_POWER_MAX
3027 * instead of normal range (0 to SPEED_POWER_MAX).
3028 * Best used with (e.g.) SuperPID router controller: S0 = 5,000 RPM and S255 = 30,000 RPM
3030 //#define CUTTER_POWER_RELATIVE // Set speed proportional to [SPEED_POWER_MIN...SPEED_POWER_MAX]
3032 #if ENABLED(SPINDLE_FEATURE)
3033 //#define SPINDLE_CHANGE_DIR // Enable if your spindle controller can change spindle direction
3034 #define SPINDLE_CHANGE_DIR_STOP // Enable if the spindle should stop before changing spin direction
3035 #define SPINDLE_INVERT_DIR false // Set to "true" if the spin direction is reversed
3037 #define SPINDLE_LASER_POWERUP_DELAY 5000 // (ms) Delay to allow the spindle/laser to come up to speed/power
3038 #define SPINDLE_LASER_POWERDOWN_DELAY 5000 // (ms) Delay to allow the spindle to stop
3041 * M3/M4 Power Equation
3043 * Each tool uses different value ranges for speed / power control.
3044 * These parameters are used to convert between tool power units and PWM.
3046 * Speed/Power = (PWMDC / 255 * 100 - SPEED_POWER_INTERCEPT) / SPEED_POWER_SLOPE
3047 * PWMDC = (spdpwr - SPEED_POWER_MIN) / (SPEED_POWER_MAX - SPEED_POWER_MIN) / SPEED_POWER_SLOPE
3049 #define SPEED_POWER_INTERCEPT 0 // (%) 0-100 i.e., Minimum power percentage
3050 #define SPEED_POWER_MIN 5000 // (RPM)
3051 #define SPEED_POWER_MAX 30000 // (RPM) SuperPID router controller 0 - 30,000 RPM
3052 #define SPEED_POWER_STARTUP 25000 // (RPM) M3/M4 speed/power default (with no arguments)
3054 #else
3056 #define SPEED_POWER_INTERCEPT 0 // (%) 0-100 i.e., Minimum power percentage
3057 #define SPEED_POWER_MIN 0 // (%) 0-100
3058 #define SPEED_POWER_MAX 100 // (%) 0-100
3059 #define SPEED_POWER_STARTUP 80 // (%) M3/M4 speed/power default (with no arguments)
3061 // Define the minimum and maximum test pulse time values for a laser test fire function
3062 #define LASER_TEST_PULSE_MIN 1 // Used with Laser Control Menu
3063 #define LASER_TEST_PULSE_MAX 999 // Caution: Menu may not show more than 3 characters
3066 * Enable inline laser power to be handled in the planner / stepper routines.
3067 * Inline power is specified by the I (inline) flag in an M3 command (e.g., M3 S20 I)
3068 * or by the 'S' parameter in G0/G1/G2/G3 moves (see LASER_MOVE_POWER).
3070 * This allows the laser to keep in perfect sync with the planner and removes
3071 * the powerup/down delay since lasers require negligible time.
3073 //#define LASER_POWER_INLINE
3075 #if ENABLED(LASER_POWER_INLINE)
3077 * Scale the laser's power in proportion to the movement rate.
3079 * - Sets the entry power proportional to the entry speed over the nominal speed.
3080 * - Ramps the power up every N steps to approximate the speed trapezoid.
3081 * - Due to the limited power resolution this is only approximate.
3083 #define LASER_POWER_INLINE_TRAPEZOID
3086 * Continuously calculate the current power (nominal_power * current_rate / nominal_rate).
3087 * Required for accurate power with non-trapezoidal acceleration (e.g., S_CURVE_ACCELERATION).
3088 * This is a costly calculation so this option is discouraged on 8-bit AVR boards.
3090 * LASER_POWER_INLINE_TRAPEZOID_CONT_PER defines how many step cycles there are between power updates. If your
3091 * board isn't able to generate steps fast enough (and you are using LASER_POWER_INLINE_TRAPEZOID_CONT), increase this.
3092 * Note that when this is zero it means it occurs every cycle; 1 means a delay wait one cycle then run, etc.
3094 //#define LASER_POWER_INLINE_TRAPEZOID_CONT
3097 * Stepper iterations between power updates. Increase this value if the board
3098 * can't keep up with the processing demands of LASER_POWER_INLINE_TRAPEZOID_CONT.
3099 * Disable (or set to 0) to recalculate power on every stepper iteration.
3101 //#define LASER_POWER_INLINE_TRAPEZOID_CONT_PER 10
3104 * Include laser power in G0/G1/G2/G3/G5 commands with the 'S' parameter
3106 //#define LASER_MOVE_POWER
3108 #if ENABLED(LASER_MOVE_POWER)
3109 // Turn off the laser on G0 moves with no power parameter.
3110 // If a power parameter is provided, use that instead.
3111 //#define LASER_MOVE_G0_OFF
3113 // Turn off the laser on G28 homing.
3114 //#define LASER_MOVE_G28_OFF
3115 #endif
3118 * Inline flag inverted
3120 * WARNING: M5 will NOT turn off the laser unless another move
3121 * is done (so G-code files must end with 'M5 I').
3123 //#define LASER_POWER_INLINE_INVERT
3126 * Continuously apply inline power. ('M3 S3' == 'G1 S3' == 'M3 S3 I')
3128 * The laser might do some weird things, so only enable this
3129 * feature if you understand the implications.
3131 //#define LASER_POWER_INLINE_CONTINUOUS
3133 #else
3135 #define SPINDLE_LASER_POWERUP_DELAY 50 // (ms) Delay to allow the spindle/laser to come up to speed/power
3136 #define SPINDLE_LASER_POWERDOWN_DELAY 50 // (ms) Delay to allow the spindle to stop
3138 #endif
3139 #endif
3140 #endif
3143 * Coolant Control
3145 * Add the M7, M8, and M9 commands to turn mist or flood coolant on and off.
3147 * Note: COOLANT_MIST_PIN and/or COOLANT_FLOOD_PIN must also be defined.
3149 //#define COOLANT_CONTROL
3150 #if ENABLED(COOLANT_CONTROL)
3151 #define COOLANT_MIST // Enable if mist coolant is present
3152 #define COOLANT_FLOOD // Enable if flood coolant is present
3153 #define COOLANT_MIST_INVERT false // Set "true" if the on/off function is reversed
3154 #define COOLANT_FLOOD_INVERT false // Set "true" if the on/off function is reversed
3155 #endif
3158 * Filament Width Sensor
3160 * Measures the filament width in real-time and adjusts
3161 * flow rate to compensate for any irregularities.
3163 * Also allows the measured filament diameter to set the
3164 * extrusion rate, so the slicer only has to specify the
3165 * volume.
3167 * Only a single extruder is supported at this time.
3169 * 34 RAMPS_14 : Analog input 5 on the AUX2 connector
3170 * 81 PRINTRBOARD : Analog input 2 on the Exp1 connector (version B,C,D,E)
3171 * 301 RAMBO : Analog input 3
3173 * Note: May require analog pins to be defined for other boards.
3175 //#define FILAMENT_WIDTH_SENSOR
3177 #if ENABLED(FILAMENT_WIDTH_SENSOR)
3178 #define FILAMENT_SENSOR_EXTRUDER_NUM 0 // Index of the extruder that has the filament sensor. :[0,1,2,3,4]
3179 #define MEASUREMENT_DELAY_CM 14 // (cm) The distance from the filament sensor to the melting chamber
3181 #define FILWIDTH_ERROR_MARGIN 1.0 // (mm) If a measurement differs too much from nominal width ignore it
3182 #define MAX_MEASUREMENT_DELAY 20 // (bytes) Buffer size for stored measurements (1 byte per cm). Must be larger than MEASUREMENT_DELAY_CM.
3184 #define DEFAULT_MEASURED_FILAMENT_DIA DEFAULT_NOMINAL_FILAMENT_DIA // Set measured to nominal initially
3186 // Display filament width on the LCD status line. Status messages will expire after 5 seconds.
3187 //#define FILAMENT_LCD_DISPLAY
3188 #endif
3191 * Power Monitor
3192 * Monitor voltage (V) and/or current (A), and -when possible- power (W)
3194 * Read and configure with M430
3196 * The current sensor feeds DC voltage (relative to the measured current) to an analog pin
3197 * The voltage sensor feeds DC voltage (relative to the measured voltage) to an analog pin
3199 //#define POWER_MONITOR_CURRENT // Monitor the system current
3200 //#define POWER_MONITOR_VOLTAGE // Monitor the system voltage
3201 #if EITHER(POWER_MONITOR_CURRENT, POWER_MONITOR_VOLTAGE)
3202 #define POWER_MONITOR_VOLTS_PER_AMP 0.05000 // Input voltage to the MCU analog pin per amp - DO NOT apply more than ADC_VREF!
3203 #define POWER_MONITOR_CURRENT_OFFSET -1 // Offset value for current sensors with linear function output
3204 #define POWER_MONITOR_VOLTS_PER_VOLT 0.11786 // Input voltage to the MCU analog pin per volt - DO NOT apply more than ADC_VREF!
3205 #define POWER_MONITOR_FIXED_VOLTAGE 13.6 // Voltage for a current sensor with no voltage sensor (for power display)
3206 #endif
3209 * CNC Coordinate Systems
3211 * Enables G53 and G54-G59.3 commands to select coordinate systems
3212 * and G92.1 to reset the workspace to native machine space.
3214 //#define CNC_COORDINATE_SYSTEMS
3217 * Auto-report temperatures with M155 S<seconds>
3219 #define AUTO_REPORT_TEMPERATURES
3222 * Include capabilities in M115 output
3224 #define EXTENDED_CAPABILITIES_REPORT
3225 #if ENABLED(EXTENDED_CAPABILITIES_REPORT)
3226 //#define M115_GEOMETRY_REPORT
3227 #endif
3230 * Expected Printer Check
3231 * Add the M16 G-code to compare a string to the MACHINE_NAME.
3232 * M16 with a non-matching string causes the printer to halt.
3234 //#define EXPECTED_PRINTER_CHECK
3237 * Disable all Volumetric extrusion options
3239 //#define NO_VOLUMETRICS
3241 #if DISABLED(NO_VOLUMETRICS)
3243 * Volumetric extrusion default state
3244 * Activate to make volumetric extrusion the default method,
3245 * with DEFAULT_NOMINAL_FILAMENT_DIA as the default diameter.
3247 * M200 D0 to disable, M200 Dn to set a new diameter (and enable volumetric).
3248 * M200 S0/S1 to disable/enable volumetric extrusion.
3250 //#define VOLUMETRIC_DEFAULT_ON
3252 //#define VOLUMETRIC_EXTRUDER_LIMIT
3253 #if ENABLED(VOLUMETRIC_EXTRUDER_LIMIT)
3255 * Default volumetric extrusion limit in cubic mm per second (mm^3/sec).
3256 * This factory setting applies to all extruders.
3257 * Use 'M200 [T<extruder>] L<limit>' to override and 'M502' to reset.
3258 * A non-zero value activates Volume-based Extrusion Limiting.
3260 #define DEFAULT_VOLUMETRIC_EXTRUDER_LIMIT 0.00 // (mm^3/sec)
3261 #endif
3262 #endif
3265 * Enable this option for a leaner build of Marlin that removes all
3266 * workspace offsets, simplifying coordinate transformations, leveling, etc.
3268 * - M206 and M428 are disabled.
3269 * - G92 will revert to its behavior from Marlin 1.0.
3271 //#define NO_WORKSPACE_OFFSETS
3273 // Extra options for the M114 "Current Position" report
3274 //#define M114_DETAIL // Use 'M114` for details to check planner calculations
3275 //#define M114_REALTIME // Real current position based on forward kinematics
3276 //#define M114_LEGACY // M114 used to synchronize on every call. Enable if needed.
3278 //#define REPORT_FAN_CHANGE // Report the new fan speed when changed by M106 (and others)
3281 * Set the number of proportional font spaces required to fill up a typical character space.
3282 * This can help to better align the output of commands like `G29 O` Mesh Output.
3284 * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
3285 * Otherwise, adjust according to your client and font.
3287 #define PROPORTIONAL_FONT_RATIO 1.0
3290 * Spend 28 bytes of SRAM to optimize the GCode parser
3292 #define FASTER_GCODE_PARSER
3294 #if ENABLED(FASTER_GCODE_PARSER)
3295 //#define GCODE_QUOTED_STRINGS // Support for quoted string parameters
3296 #endif
3298 //#define GCODE_CASE_INSENSITIVE // Accept G-code sent to the firmware in lowercase
3300 //#define REPETIER_GCODE_M360 // Add commands originally from Repetier FW
3303 * CNC G-code options
3304 * Support CNC-style G-code dialects used by laser cutters, drawing machine cams, etc.
3305 * Note that G0 feedrates should be used with care for 3D printing (if used at all).
3306 * High feedrates may cause ringing and harm print quality.
3308 //#define PAREN_COMMENTS // Support for parentheses-delimited comments
3309 //#define GCODE_MOTION_MODES // Remember the motion mode (G0 G1 G2 G3 G5 G38.X) and apply for X Y Z E F, etc.
3311 // Enable and set a (default) feedrate for all G0 moves
3312 //#define G0_FEEDRATE 3000 // (mm/min)
3313 #ifdef G0_FEEDRATE
3314 //#define VARIABLE_G0_FEEDRATE // The G0 feedrate is set by F in G0 motion mode
3315 #endif
3318 * Startup commands
3320 * Execute certain G-code commands immediately after power-on.
3322 //#define STARTUP_COMMANDS "M17 Z"
3325 * G-code Macros
3327 * Add G-codes M810-M819 to define and run G-code macros.
3328 * Macros are not saved to EEPROM.
3330 //#define GCODE_MACROS
3331 #if ENABLED(GCODE_MACROS)
3332 #define GCODE_MACROS_SLOTS 5 // Up to 10 may be used
3333 #define GCODE_MACROS_SLOT_SIZE 50 // Maximum length of a single macro
3334 #endif
3337 * User-defined menu items that execute custom GCode
3339 //#define CUSTOM_USER_MENUS
3340 #if ENABLED(CUSTOM_USER_MENUS)
3341 //#define CUSTOM_USER_MENU_TITLE "Custom Commands"
3342 #define USER_SCRIPT_DONE "M117 User Script Done"
3343 #define USER_SCRIPT_AUDIBLE_FEEDBACK
3344 //#define USER_SCRIPT_RETURN // Return to status screen after a script
3346 #define USER_DESC_1 "Home & UBL Info"
3347 #define USER_GCODE_1 "G28\nG29 W"
3349 #define USER_DESC_2 "Preheat for " PREHEAT_1_LABEL
3350 #define USER_GCODE_2 "M140 S" STRINGIFY(PREHEAT_1_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_1_TEMP_HOTEND)
3352 #define USER_DESC_3 "Preheat for " PREHEAT_2_LABEL
3353 #define USER_GCODE_3 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_2_TEMP_HOTEND)
3355 #define USER_DESC_4 "Heat Bed/Home/Level"
3356 #define USER_GCODE_4 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nG28\nG29"
3358 #define USER_DESC_5 "Home & Info"
3359 #define USER_GCODE_5 "G28\nM503"
3360 #endif
3363 * Host Action Commands
3365 * Define host streamer action commands in compliance with the standard.
3367 * See https://reprap.org/wiki/G-code#Action_commands
3368 * Common commands ........ poweroff, pause, paused, resume, resumed, cancel
3369 * G29_RETRY_AND_RECOVER .. probe_rewipe, probe_failed
3371 * Some features add reason codes to extend these commands.
3373 * Host Prompt Support enables Marlin to use the host for user prompts so
3374 * filament runout and other processes can be managed from the host side.
3376 //#define HOST_ACTION_COMMANDS
3377 #if ENABLED(HOST_ACTION_COMMANDS)
3378 //#define HOST_PROMPT_SUPPORT
3379 //#define HOST_START_MENU_ITEM // Add a menu item that tells the host to start
3380 #endif
3383 * Cancel Objects
3385 * Implement M486 to allow Marlin to skip objects
3387 //#define CANCEL_OBJECTS
3390 * I2C position encoders for closed loop control.
3391 * Developed by Chris Barr at Aus3D.
3393 * Wiki: https://wiki.aus3d.com.au/Magnetic_Encoder
3394 * Github: https://github.com/Aus3D/MagneticEncoder
3396 * Supplier: https://aus3d.com.au/magnetic-encoder-module
3397 * Alternative Supplier: https://reliabuild3d.com/
3399 * Reliabuild encoders have been modified to improve reliability.
3402 //#define I2C_POSITION_ENCODERS
3403 #if ENABLED(I2C_POSITION_ENCODERS)
3405 #define I2CPE_ENCODER_CNT 1 // The number of encoders installed; max of 5
3406 // encoders supported currently.
3408 #define I2CPE_ENC_1_ADDR I2CPE_PRESET_ADDR_X // I2C address of the encoder. 30-200.
3409 #define I2CPE_ENC_1_AXIS X_AXIS // Axis the encoder module is installed on. <X|Y|Z|E>_AXIS.
3410 #define I2CPE_ENC_1_TYPE I2CPE_ENC_TYPE_LINEAR // Type of encoder: I2CPE_ENC_TYPE_LINEAR -or-
3411 // I2CPE_ENC_TYPE_ROTARY.
3412 #define I2CPE_ENC_1_TICKS_UNIT 2048 // 1024 for magnetic strips with 2mm poles; 2048 for
3413 // 1mm poles. For linear encoders this is ticks / mm,
3414 // for rotary encoders this is ticks / revolution.
3415 //#define I2CPE_ENC_1_TICKS_REV (16 * 200) // Only needed for rotary encoders; number of stepper
3416 // steps per full revolution (motor steps/rev * microstepping)
3417 //#define I2CPE_ENC_1_INVERT // Invert the direction of axis travel.
3418 #define I2CPE_ENC_1_EC_METHOD I2CPE_ECM_MICROSTEP // Type of error error correction.
3419 #define I2CPE_ENC_1_EC_THRESH 0.10 // Threshold size for error (in mm) above which the
3420 // printer will attempt to correct the error; errors
3421 // smaller than this are ignored to minimize effects of
3422 // measurement noise / latency (filter).
3424 #define I2CPE_ENC_2_ADDR I2CPE_PRESET_ADDR_Y // Same as above, but for encoder 2.
3425 #define I2CPE_ENC_2_AXIS Y_AXIS
3426 #define I2CPE_ENC_2_TYPE I2CPE_ENC_TYPE_LINEAR
3427 #define I2CPE_ENC_2_TICKS_UNIT 2048
3428 //#define I2CPE_ENC_2_TICKS_REV (16 * 200)
3429 //#define I2CPE_ENC_2_INVERT
3430 #define I2CPE_ENC_2_EC_METHOD I2CPE_ECM_MICROSTEP
3431 #define I2CPE_ENC_2_EC_THRESH 0.10
3433 #define I2CPE_ENC_3_ADDR I2CPE_PRESET_ADDR_Z // Encoder 3. Add additional configuration options
3434 #define I2CPE_ENC_3_AXIS Z_AXIS // as above, or use defaults below.
3436 #define I2CPE_ENC_4_ADDR I2CPE_PRESET_ADDR_E // Encoder 4.
3437 #define I2CPE_ENC_4_AXIS E_AXIS
3439 #define I2CPE_ENC_5_ADDR 34 // Encoder 5.
3440 #define I2CPE_ENC_5_AXIS E_AXIS
3442 // Default settings for encoders which are enabled, but without settings configured above.
3443 #define I2CPE_DEF_TYPE I2CPE_ENC_TYPE_LINEAR
3444 #define I2CPE_DEF_ENC_TICKS_UNIT 2048
3445 #define I2CPE_DEF_TICKS_REV (16 * 200)
3446 #define I2CPE_DEF_EC_METHOD I2CPE_ECM_NONE
3447 #define I2CPE_DEF_EC_THRESH 0.1
3449 //#define I2CPE_ERR_THRESH_ABORT 100.0 // Threshold size for error (in mm) error on any given
3450 // axis after which the printer will abort. Comment out to
3451 // disable abort behavior.
3453 #define I2CPE_TIME_TRUSTED 10000 // After an encoder fault, there must be no further fault
3454 // for this amount of time (in ms) before the encoder
3455 // is trusted again.
3458 * Position is checked every time a new command is executed from the buffer but during long moves,
3459 * this setting determines the minimum update time between checks. A value of 100 works well with
3460 * error rolling average when attempting to correct only for skips and not for vibration.
3462 #define I2CPE_MIN_UPD_TIME_MS 4 // (ms) Minimum time between encoder checks.
3464 // Use a rolling average to identify persistant errors that indicate skips, as opposed to vibration and noise.
3465 #define I2CPE_ERR_ROLLING_AVERAGE
3467 #endif // I2C_POSITION_ENCODERS
3470 * Analog Joystick(s)
3472 //#define JOYSTICK
3473 #if ENABLED(JOYSTICK)
3474 #define JOY_X_PIN 5 // RAMPS: Suggested pin A5 on AUX2
3475 #define JOY_Y_PIN 10 // RAMPS: Suggested pin A10 on AUX2
3476 #define JOY_Z_PIN 12 // RAMPS: Suggested pin A12 on AUX2
3477 #define JOY_EN_PIN 44 // RAMPS: Suggested pin D44 on AUX2
3479 //#define INVERT_JOY_X // Enable if X direction is reversed
3480 //#define INVERT_JOY_Y // Enable if Y direction is reversed
3481 //#define INVERT_JOY_Z // Enable if Z direction is reversed
3483 // Use M119 with JOYSTICK_DEBUG to find reasonable values after connecting:
3484 #define JOY_X_LIMITS { 5600, 8190-100, 8190+100, 10800 } // min, deadzone start, deadzone end, max
3485 #define JOY_Y_LIMITS { 5600, 8250-100, 8250+100, 11000 }
3486 #define JOY_Z_LIMITS { 4800, 8080-100, 8080+100, 11550 }
3487 //#define JOYSTICK_DEBUG
3488 #endif
3491 * Mechanical Gantry Calibration
3492 * Modern replacement for the Prusa TMC_Z_CALIBRATION.
3493 * Adds capability to work with any adjustable current drivers.
3494 * Implemented as G34 because M915 is deprecated.
3496 //#define MECHANICAL_GANTRY_CALIBRATION
3497 #if ENABLED(MECHANICAL_GANTRY_CALIBRATION)
3498 #define GANTRY_CALIBRATION_CURRENT 600 // Default calibration current in ma
3499 #define GANTRY_CALIBRATION_EXTRA_HEIGHT 15 // Extra distance in mm past Z_###_POS to move
3500 #define GANTRY_CALIBRATION_FEEDRATE 500 // Feedrate for correction move
3501 //#define GANTRY_CALIBRATION_TO_MIN // Enable to calibrate Z in the MIN direction
3503 //#define GANTRY_CALIBRATION_SAFE_POSITION XY_CENTER // Safe position for nozzle
3504 //#define GANTRY_CALIBRATION_XY_PARK_FEEDRATE 3000 // XY Park Feedrate - MMM
3505 //#define GANTRY_CALIBRATION_COMMANDS_PRE ""
3506 #define GANTRY_CALIBRATION_COMMANDS_POST "G28" // G28 highly recommended to ensure an accurate position
3507 #endif
3510 * MAX7219 Debug Matrix
3512 * Add support for a low-cost 8x8 LED Matrix based on the Max7219 chip as a realtime status display.
3513 * Requires 3 signal wires. Some useful debug options are included to demonstrate its usage.
3515 //#define MAX7219_DEBUG
3516 #if ENABLED(MAX7219_DEBUG)
3517 #define MAX7219_CLK_PIN 64
3518 #define MAX7219_DIN_PIN 57
3519 #define MAX7219_LOAD_PIN 44
3521 //#define MAX7219_GCODE // Add the M7219 G-code to control the LED matrix
3522 #define MAX7219_INIT_TEST 2 // Test pattern at startup: 0=none, 1=sweep, 2=spiral
3523 #define MAX7219_NUMBER_UNITS 1 // Number of Max7219 units in chain.
3524 #define MAX7219_ROTATE 0 // Rotate the display clockwise (in multiples of +/- 90°)
3525 // connector at: right=0 bottom=-90 top=90 left=180
3526 //#define MAX7219_REVERSE_ORDER // The individual LED matrix units may be in reversed order
3527 //#define MAX7219_SIDE_BY_SIDE // Big chip+matrix boards can be chained side-by-side
3530 * Sample debug features
3531 * If you add more debug displays, be careful to avoid conflicts!
3533 #define MAX7219_DEBUG_PRINTER_ALIVE // Blink corner LED of 8x8 matrix to show that the firmware is functioning
3534 #define MAX7219_DEBUG_PLANNER_HEAD 3 // Show the planner queue head position on this and the next LED matrix row
3535 #define MAX7219_DEBUG_PLANNER_TAIL 5 // Show the planner queue tail position on this and the next LED matrix row
3537 #define MAX7219_DEBUG_PLANNER_QUEUE 0 // Show the current planner queue depth on this and the next LED matrix row
3538 // If you experience stuttering, reboots, etc. this option can reveal how
3539 // tweaks made to the configuration are affecting the printer in real-time.
3540 #endif
3543 * NanoDLP Sync support
3545 * Add support for Synchronized Z moves when using with NanoDLP. G0/G1 axis moves will output "Z_move_comp"
3546 * string to enable synchronization with DLP projector exposure. This change will allow to use
3547 * [[WaitForDoneMessage]] instead of populating your gcode with M400 commands
3549 //#define NANODLP_Z_SYNC
3550 #if ENABLED(NANODLP_Z_SYNC)
3551 //#define NANODLP_ALL_AXIS // Enables "Z_move_comp" output on any axis move.
3552 // Default behavior is limited to Z axis only.
3553 #endif
3556 * Ethernet. Use M552 to enable and set the IP address.
3558 #if HAS_ETHERNET
3559 #define MAC_ADDRESS { 0xDE, 0xAD, 0xBE, 0xEF, 0xF0, 0x0D } // A MAC address unique to your network
3560 #endif
3563 * WiFi Support (Espressif ESP32 WiFi)
3565 //#define WIFISUPPORT // Marlin embedded WiFi managenent
3566 //#define ESP3D_WIFISUPPORT // ESP3D Library WiFi management (https://github.com/luc-github/ESP3DLib)
3568 #if EITHER(WIFISUPPORT, ESP3D_WIFISUPPORT)
3569 //#define WEBSUPPORT // Start a webserver (which may include auto-discovery)
3570 //#define OTASUPPORT // Support over-the-air firmware updates
3571 //#define WIFI_CUSTOM_COMMAND // Accept feature config commands (e.g., WiFi ESP3D) from the host
3574 * To set a default WiFi SSID / Password, create a file called Configuration_Secure.h with
3575 * the following defines, customized for your network. This specific file is excluded via
3576 * .gitignore to prevent it from accidentally leaking to the public.
3578 * #define WIFI_SSID "WiFi SSID"
3579 * #define WIFI_PWD "WiFi Password"
3581 //#include "Configuration_Secure.h" // External file with WiFi SSID / Password
3582 #endif
3585 * Průša Multi-Material Unit (MMU)
3586 * Enable in Configuration.h
3588 * These devices allow a single stepper driver on the board to drive
3589 * multi-material feeders with any number of stepper motors.
3591 #if HAS_PRUSA_MMU1
3593 * This option only allows the multiplexer to switch on tool-change.
3594 * Additional options to configure custom E moves are pending.
3596 * Override the default DIO selector pins here, if needed.
3597 * Some pins files may provide defaults for these pins.
3599 //#define E_MUX0_PIN 40 // Always Required
3600 //#define E_MUX1_PIN 42 // Needed for 3 to 8 inputs
3601 //#define E_MUX2_PIN 44 // Needed for 5 to 8 inputs
3602 #elif HAS_PRUSA_MMU2
3603 // Serial port used for communication with MMU2.
3604 #define MMU2_SERIAL_PORT 2
3606 // Use hardware reset for MMU if a pin is defined for it
3607 //#define MMU2_RST_PIN 23
3609 // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
3610 //#define MMU2_MODE_12V
3612 // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
3613 #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
3615 // Add an LCD menu for MMU2
3616 //#define MMU2_MENUS
3617 #if EITHER(MMU2_MENUS, HAS_PRUSA_MMU2S)
3618 // Settings for filament load / unload from the LCD menu.
3619 // This is for Průša MK3-style extruders. Customize for your hardware.
3620 #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
3621 #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
3622 { 7.2, 1145 }, \
3623 { 14.4, 871 }, \
3624 { 36.0, 1393 }, \
3625 { 14.4, 871 }, \
3626 { 50.0, 198 }
3628 #define MMU2_RAMMING_SEQUENCE \
3629 { 1.0, 1000 }, \
3630 { 1.0, 1500 }, \
3631 { 2.0, 2000 }, \
3632 { 1.5, 3000 }, \
3633 { 2.5, 4000 }, \
3634 { -15.0, 5000 }, \
3635 { -14.0, 1200 }, \
3636 { -6.0, 600 }, \
3637 { 10.0, 700 }, \
3638 { -10.0, 400 }, \
3639 { -50.0, 2000 }
3640 #endif
3643 * Using a sensor like the MMU2S
3644 * This mode requires a MK3S extruder with a sensor at the extruder idler, like the MMU2S.
3645 * See https://help.prusa3d.com/en/guide/3b-mk3s-mk2-5s-extruder-upgrade_41560, step 11
3647 #if HAS_PRUSA_MMU2S
3648 #define MMU2_C0_RETRY 5 // Number of retries (total time = timeout*retries)
3650 #define MMU2_CAN_LOAD_FEEDRATE 800 // (mm/min)
3651 #define MMU2_CAN_LOAD_SEQUENCE \
3652 { 0.1, MMU2_CAN_LOAD_FEEDRATE }, \
3653 { 60.0, MMU2_CAN_LOAD_FEEDRATE }, \
3654 { -52.0, MMU2_CAN_LOAD_FEEDRATE }
3656 #define MMU2_CAN_LOAD_RETRACT 6.0 // (mm) Keep under the distance between Load Sequence values
3657 #define MMU2_CAN_LOAD_DEVIATION 0.8 // (mm) Acceptable deviation
3659 #define MMU2_CAN_LOAD_INCREMENT 0.2 // (mm) To reuse within MMU2 module
3660 #define MMU2_CAN_LOAD_INCREMENT_SEQUENCE \
3661 { -MMU2_CAN_LOAD_INCREMENT, MMU2_CAN_LOAD_FEEDRATE }
3663 #else
3666 * MMU1 Extruder Sensor
3668 * Support for a Průša (or other) IR Sensor to detect filament near the extruder
3669 * and make loading more reliable. Suitable for an extruder equipped with a filament
3670 * sensor less than 38mm from the gears.
3672 * During loading the extruder will stop when the sensor is triggered, then do a last
3673 * move up to the gears. If no filament is detected, the MMU2 can make some more attempts.
3674 * If all attempts fail, a filament runout will be triggered.
3676 //#define MMU_EXTRUDER_SENSOR
3677 #if ENABLED(MMU_EXTRUDER_SENSOR)
3678 #define MMU_LOADING_ATTEMPTS_NR 5 // max. number of attempts to load filament if first load fail
3679 #endif
3681 #endif
3683 //#define MMU2_DEBUG // Write debug info to serial output
3685 #endif // HAS_PRUSA_MMU2
3688 * Advanced Print Counter settings
3690 #if ENABLED(PRINTCOUNTER)
3691 #define SERVICE_WARNING_BUZZES 3
3692 // Activate up to 3 service interval watchdogs
3693 //#define SERVICE_NAME_1 "Service S"
3694 //#define SERVICE_INTERVAL_1 100 // print hours
3695 //#define SERVICE_NAME_2 "Service L"
3696 //#define SERVICE_INTERVAL_2 200 // print hours
3697 //#define SERVICE_NAME_3 "Service 3"
3698 //#define SERVICE_INTERVAL_3 1 // print hours
3699 #endif
3701 // @section develop
3704 // M100 Free Memory Watcher to debug memory usage
3706 //#define M100_FREE_MEMORY_WATCHER
3709 // M42 - Set pin states
3711 //#define DIRECT_PIN_CONTROL
3714 // M43 - display pin status, toggle pins, watch pins, watch endstops & toggle LED, test servo probe
3716 //#define PINS_DEBUGGING
3718 // Enable Marlin dev mode which adds some special commands
3719 //#define MARLIN_DEV_MODE