🩹 Add missing FORCE_SOFT_SPI (#24940)
[Marlin.git] / Marlin / Configuration_adv.h
bloba6556b7108ffe6ddd19c3d6d9e86c88d746160ca
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 02000905
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
116 #if TEMP_SENSOR_COOLER == 1000
117 #define COOLER_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
118 #define COOLER_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
119 #define COOLER_BETA 3950 // Beta value
120 #endif
122 #if TEMP_SENSOR_PROBE == 1000
123 #define PROBE_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
124 #define PROBE_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
125 #define PROBE_BETA 3950 // Beta value
126 #endif
128 #if TEMP_SENSOR_BOARD == 1000
129 #define BOARD_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
130 #define BOARD_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
131 #define BOARD_BETA 3950 // Beta value
132 #endif
134 #if TEMP_SENSOR_REDUNDANT == 1000
135 #define REDUNDANT_PULLUP_RESISTOR_OHMS 4700 // Pullup resistor
136 #define REDUNDANT_RESISTANCE_25C_OHMS 100000 // Resistance at 25C
137 #define REDUNDANT_BETA 3950 // Beta value
138 #endif
141 * Thermocouple Options — for MAX6675 (-2), MAX31855 (-3), and MAX31865 (-5).
143 //#define TEMP_SENSOR_FORCE_HW_SPI // Ignore SCK/MOSI/MISO pins; use CS and the default SPI bus.
144 //#define MAX31865_SENSOR_WIRES_0 2 // (2-4) Number of wires for the probe connected to a MAX31865 board.
145 //#define MAX31865_SENSOR_WIRES_1 2
147 //#define MAX31865_50HZ_FILTER // Use a 50Hz filter instead of the default 60Hz.
148 //#define MAX31865_USE_READ_ERROR_DETECTION // Treat value spikes (20°C delta in under 1s) as read errors.
150 //#define MAX31865_USE_AUTO_MODE // Read faster and more often than 1-shot; bias voltage always on; slight effect on RTD temperature.
151 //#define MAX31865_MIN_SAMPLING_TIME_MSEC 100 // (ms) 1-shot: minimum read interval. Reduces bias voltage effects by leaving sensor unpowered for longer intervals.
152 //#define MAX31865_IGNORE_INITIAL_FAULTY_READS 10 // Ignore some read faults (keeping the temperature reading) to work around a possible issue (#23439).
154 //#define MAX31865_WIRE_OHMS_0 0.95f // For 2-wire, set the wire resistances for more accurate readings.
155 //#define MAX31865_WIRE_OHMS_1 0.0f
158 * Hephestos 2 24V heated bed upgrade kit.
159 * https://store.bq.com/en/heated-bed-kit-hephestos2
161 //#define HEPHESTOS2_HEATED_BED_KIT
162 #if ENABLED(HEPHESTOS2_HEATED_BED_KIT)
163 #undef TEMP_SENSOR_BED
164 #define TEMP_SENSOR_BED 70
165 #define HEATER_BED_INVERTING true
166 #endif
169 // Heated Bed Bang-Bang options
171 #if DISABLED(PIDTEMPBED)
172 #define BED_CHECK_INTERVAL 5000 // (ms) Interval between checks in bang-bang control
173 #if ENABLED(BED_LIMIT_SWITCHING)
174 #define BED_HYSTERESIS 2 // (°C) Only set the relevant heater state when ABS(T-target) > BED_HYSTERESIS
175 #endif
176 #endif
179 // Heated Chamber options
181 #if DISABLED(PIDTEMPCHAMBER)
182 #define CHAMBER_CHECK_INTERVAL 5000 // (ms) Interval between checks in bang-bang control
183 #if ENABLED(CHAMBER_LIMIT_SWITCHING)
184 #define CHAMBER_HYSTERESIS 2 // (°C) Only set the relevant heater state when ABS(T-target) > CHAMBER_HYSTERESIS
185 #endif
186 #endif
188 #if TEMP_SENSOR_CHAMBER
189 //#define HEATER_CHAMBER_PIN P2_04 // Required heater on/off pin (example: SKR 1.4 Turbo HE1 plug)
190 //#define HEATER_CHAMBER_INVERTING false
191 //#define FAN1_PIN -1 // Remove the fan signal on pin P2_04 (example: SKR 1.4 Turbo HE1 plug)
193 //#define CHAMBER_FAN // Enable a fan on the chamber
194 #if ENABLED(CHAMBER_FAN)
195 //#define CHAMBER_FAN_INDEX 2 // Index of a fan to repurpose as the chamber fan. (Default: first unused fan)
196 #define CHAMBER_FAN_MODE 2 // Fan control mode: 0=Static; 1=Linear increase when temp is higher than target; 2=V-shaped curve; 3=similar to 1 but fan is always on.
197 #if CHAMBER_FAN_MODE == 0
198 #define CHAMBER_FAN_BASE 255 // Chamber fan PWM (0-255)
199 #elif CHAMBER_FAN_MODE == 1
200 #define CHAMBER_FAN_BASE 128 // Base chamber fan PWM (0-255); turns on when chamber temperature is above the target
201 #define CHAMBER_FAN_FACTOR 25 // PWM increase per °C above target
202 #elif CHAMBER_FAN_MODE == 2
203 #define CHAMBER_FAN_BASE 128 // Minimum chamber fan PWM (0-255)
204 #define CHAMBER_FAN_FACTOR 25 // PWM increase per °C difference from target
205 #elif CHAMBER_FAN_MODE == 3
206 #define CHAMBER_FAN_BASE 128 // Base chamber fan PWM (0-255)
207 #define CHAMBER_FAN_FACTOR 25 // PWM increase per °C above target
208 #endif
209 #endif
211 //#define CHAMBER_VENT // Enable a servo-controlled vent on the chamber
212 #if ENABLED(CHAMBER_VENT)
213 #define CHAMBER_VENT_SERVO_NR 1 // Index of the vent servo
214 #define HIGH_EXCESS_HEAT_LIMIT 5 // How much above target temp to consider there is excess heat in the chamber
215 #define LOW_EXCESS_HEAT_LIMIT 3
216 #define MIN_COOLING_SLOPE_TIME_CHAMBER_VENT 20
217 #define MIN_COOLING_SLOPE_DEG_CHAMBER_VENT 1.5
218 #endif
219 #endif
222 // Laser Cooler options
224 #if TEMP_SENSOR_COOLER
225 #define COOLER_MINTEMP 8 // (°C)
226 #define COOLER_MAXTEMP 26 // (°C)
227 #define COOLER_DEFAULT_TEMP 16 // (°C)
228 #define TEMP_COOLER_HYSTERESIS 1 // (°C) Temperature proximity considered "close enough" to the target
229 #define COOLER_PIN 8 // Laser cooler on/off pin used to control power to the cooling element (e.g., TEC, External chiller via relay)
230 #define COOLER_INVERTING false
231 #define TEMP_COOLER_PIN 15 // Laser/Cooler temperature sensor pin. ADC is required.
232 #define COOLER_FAN // Enable a fan on the cooler, Fan# 0,1,2,3 etc.
233 #define COOLER_FAN_INDEX 0 // FAN number 0, 1, 2 etc. e.g.
234 #if ENABLED(COOLER_FAN)
235 #define COOLER_FAN_BASE 100 // Base Cooler fan PWM (0-255); turns on when Cooler temperature is above the target
236 #define COOLER_FAN_FACTOR 25 // PWM increase per °C above target
237 #endif
238 #endif
241 // Motherboard Sensor options
243 #if TEMP_SENSOR_BOARD
244 #define THERMAL_PROTECTION_BOARD // Halt the printer if the board sensor leaves the temp range below.
245 #define BOARD_MINTEMP 8 // (°C)
246 #define BOARD_MAXTEMP 70 // (°C)
247 #ifndef TEMP_BOARD_PIN
248 //#define TEMP_BOARD_PIN -1 // Board temp sensor pin, if not set in pins file.
249 #endif
250 #endif
253 * Thermal Protection provides additional protection to your printer from damage
254 * and fire. Marlin always includes safe min and max temperature ranges which
255 * protect against a broken or disconnected thermistor wire.
257 * The issue: If a thermistor falls out, it will report the much lower
258 * temperature of the air in the room, and the the firmware will keep
259 * the heater on.
261 * The solution: Once the temperature reaches the target, start observing.
262 * If the temperature stays too far below the target (hysteresis) for too
263 * long (period), the firmware will halt the machine as a safety precaution.
265 * If you get false positives for "Thermal Runaway", increase
266 * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
268 #if ENABLED(THERMAL_PROTECTION_HOTENDS)
269 #define THERMAL_PROTECTION_PERIOD 40 // Seconds
270 #define THERMAL_PROTECTION_HYSTERESIS 4 // Degrees Celsius
272 //#define ADAPTIVE_FAN_SLOWING // Slow part cooling fan if temperature drops
273 #if BOTH(ADAPTIVE_FAN_SLOWING, PIDTEMP)
274 //#define NO_FAN_SLOWING_IN_PID_TUNING // Don't slow fan speed during M303
275 #endif
278 * Whenever an M104, M109, or M303 increases the target temperature, the
279 * firmware will wait for the WATCH_TEMP_PERIOD to expire. If the temperature
280 * hasn't increased by WATCH_TEMP_INCREASE degrees, the machine is halted and
281 * requires a hard reset. This test restarts with any M104/M109/M303, but only
282 * if the current temperature is far enough below the target for a reliable
283 * test.
285 * If you get false positives for "Heating failed", increase WATCH_TEMP_PERIOD
286 * and/or decrease WATCH_TEMP_INCREASE. WATCH_TEMP_INCREASE should not be set
287 * below 2.
289 #define WATCH_TEMP_PERIOD 20 // Seconds
290 #define WATCH_TEMP_INCREASE 2 // Degrees Celsius
291 #endif
294 * Thermal Protection parameters for the bed are just as above for hotends.
296 #if ENABLED(THERMAL_PROTECTION_BED)
297 #define THERMAL_PROTECTION_BED_PERIOD 20 // Seconds
298 #define THERMAL_PROTECTION_BED_HYSTERESIS 2 // Degrees Celsius
301 * As described above, except for the bed (M140/M190/M303).
303 #define WATCH_BED_TEMP_PERIOD 60 // Seconds
304 #define WATCH_BED_TEMP_INCREASE 2 // Degrees Celsius
305 #endif
308 * Thermal Protection parameters for the heated chamber.
310 #if ENABLED(THERMAL_PROTECTION_CHAMBER)
311 #define THERMAL_PROTECTION_CHAMBER_PERIOD 20 // Seconds
312 #define THERMAL_PROTECTION_CHAMBER_HYSTERESIS 2 // Degrees Celsius
315 * Heated chamber watch settings (M141/M191).
317 #define WATCH_CHAMBER_TEMP_PERIOD 60 // Seconds
318 #define WATCH_CHAMBER_TEMP_INCREASE 2 // Degrees Celsius
319 #endif
322 * Thermal Protection parameters for the laser cooler.
324 #if ENABLED(THERMAL_PROTECTION_COOLER)
325 #define THERMAL_PROTECTION_COOLER_PERIOD 10 // Seconds
326 #define THERMAL_PROTECTION_COOLER_HYSTERESIS 3 // Degrees Celsius
329 * Laser cooling watch settings (M143/M193).
331 #define WATCH_COOLER_TEMP_PERIOD 60 // Seconds
332 #define WATCH_COOLER_TEMP_INCREASE 3 // Degrees Celsius
333 #endif
335 #if ANY(THERMAL_PROTECTION_HOTENDS, THERMAL_PROTECTION_BED, THERMAL_PROTECTION_CHAMBER, THERMAL_PROTECTION_COOLER)
337 * Thermal Protection Variance Monitor - EXPERIMENTAL.
338 * Kill the machine on a stuck temperature sensor. Disable if you get false positives.
340 //#define THERMAL_PROTECTION_VARIANCE_MONITOR // Detect a sensor malfunction preventing temperature updates
341 #endif
343 #if ENABLED(PIDTEMP)
344 // Add an experimental additional term to the heater power, proportional to the extrusion speed.
345 // A well-chosen Kc value should add just enough power to melt the increased material volume.
346 //#define PID_EXTRUSION_SCALING
347 #if ENABLED(PID_EXTRUSION_SCALING)
348 #define DEFAULT_Kc (100) // heating power = Kc * e_speed
349 #define LPQ_MAX_LEN 50
350 #endif
353 * Add an experimental additional term to the heater power, proportional to the fan speed.
354 * A well-chosen Kf value should add just enough power to compensate for power-loss from the cooling fan.
355 * You can either just add a constant compensation with the DEFAULT_Kf value
356 * or follow the instruction below to get speed-dependent compensation.
358 * Constant compensation (use only with fanspeeds of 0% and 100%)
359 * ---------------------------------------------------------------------
360 * A good starting point for the Kf-value comes from the calculation:
361 * kf = (power_fan * eff_fan) / power_heater * 255
362 * where eff_fan is between 0.0 and 1.0, based on fan-efficiency and airflow to the nozzle / heater.
364 * Example:
365 * Heater: 40W, Fan: 0.1A * 24V = 2.4W, eff_fan = 0.8
366 * Kf = (2.4W * 0.8) / 40W * 255 = 12.24
368 * Fan-speed dependent compensation
369 * --------------------------------
370 * 1. To find a good Kf value, set the hotend temperature, wait for it to settle, and enable the fan (100%).
371 * Make sure PID_FAN_SCALING_LIN_FACTOR is 0 and PID_FAN_SCALING_ALTERNATIVE_DEFINITION is not enabled.
372 * If you see the temperature drop repeat the test, increasing the Kf value slowly, until the temperature
373 * drop goes away. If the temperature overshoots after enabling the fan, the Kf value is too big.
374 * 2. Note the Kf-value for fan-speed at 100%
375 * 3. Determine a good value for PID_FAN_SCALING_MIN_SPEED, which is around the speed, where the fan starts moving.
376 * 4. Repeat step 1. and 2. for this fan speed.
377 * 5. Enable PID_FAN_SCALING_ALTERNATIVE_DEFINITION and enter the two identified Kf-values in
378 * PID_FAN_SCALING_AT_FULL_SPEED and PID_FAN_SCALING_AT_MIN_SPEED. Enter the minimum speed in PID_FAN_SCALING_MIN_SPEED
380 //#define PID_FAN_SCALING
381 #if ENABLED(PID_FAN_SCALING)
382 //#define PID_FAN_SCALING_ALTERNATIVE_DEFINITION
383 #if ENABLED(PID_FAN_SCALING_ALTERNATIVE_DEFINITION)
384 // The alternative definition is used for an easier configuration.
385 // Just figure out Kf at fullspeed (255) and PID_FAN_SCALING_MIN_SPEED.
386 // DEFAULT_Kf and PID_FAN_SCALING_LIN_FACTOR are calculated accordingly.
388 #define PID_FAN_SCALING_AT_FULL_SPEED 13.0 //=PID_FAN_SCALING_LIN_FACTOR*255+DEFAULT_Kf
389 #define PID_FAN_SCALING_AT_MIN_SPEED 6.0 //=PID_FAN_SCALING_LIN_FACTOR*PID_FAN_SCALING_MIN_SPEED+DEFAULT_Kf
390 #define PID_FAN_SCALING_MIN_SPEED 10.0 // Minimum fan speed at which to enable PID_FAN_SCALING
392 #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)
393 #define PID_FAN_SCALING_LIN_FACTOR (PID_FAN_SCALING_AT_FULL_SPEED-DEFAULT_Kf)/255.0
395 #else
396 #define PID_FAN_SCALING_LIN_FACTOR (0) // Power loss due to cooling = Kf * (fan_speed)
397 #define DEFAULT_Kf 10 // A constant value added to the PID-tuner
398 #define PID_FAN_SCALING_MIN_SPEED 10 // Minimum fan speed at which to enable PID_FAN_SCALING
399 #endif
400 #endif
401 #endif
404 * Automatic Temperature Mode
406 * Dynamically adjust the hotend target temperature based on planned E moves.
408 * (Contrast with PID_EXTRUSION_SCALING, which tracks E movement and adjusts PID
409 * behavior using an additional kC value.)
411 * Autotemp is calculated by (mintemp + factor * mm_per_sec), capped to maxtemp.
413 * Enable Autotemp Mode with M104/M109 F<factor> S<mintemp> B<maxtemp>.
414 * Disable by sending M104/M109 with no F parameter (or F0 with AUTOTEMP_PROPORTIONAL).
416 #define AUTOTEMP
417 #if ENABLED(AUTOTEMP)
418 #define AUTOTEMP_OLDWEIGHT 0.98 // Factor used to weight previous readings (0.0 < value < 1.0)
419 // Turn on AUTOTEMP on M104/M109 by default using proportions set here
420 //#define AUTOTEMP_PROPORTIONAL
421 #if ENABLED(AUTOTEMP_PROPORTIONAL)
422 #define AUTOTEMP_MIN_P 0 // (°C) Added to the target temperature
423 #define AUTOTEMP_MAX_P 5 // (°C) Added to the target temperature
424 #define AUTOTEMP_FACTOR_P 1 // Apply this F parameter by default (overridden by M104/M109 F)
425 #endif
426 #endif
428 // Show Temperature ADC value
429 // Enable for M105 to include ADC values read from temperature sensors.
430 //#define SHOW_TEMP_ADC_VALUES
433 * High Temperature Thermistor Support
435 * Thermistors able to support high temperature tend to have a hard time getting
436 * good readings at room and lower temperatures. This means TEMP_SENSOR_X_RAW_LO_TEMP
437 * will probably be caught when the heating element first turns on during the
438 * preheating process, which will trigger a min_temp_error as a safety measure
439 * and force stop everything.
440 * To circumvent this limitation, we allow for a preheat time (during which,
441 * min_temp_error won't be triggered) and add a min_temp buffer to handle
442 * aberrant readings.
444 * If you want to enable this feature for your hotend thermistor(s)
445 * uncomment and set values > 0 in the constants below
448 // The number of consecutive low temperature errors that can occur
449 // before a min_temp_error is triggered. (Shouldn't be more than 10.)
450 //#define MAX_CONSECUTIVE_LOW_TEMPERATURE_ERROR_ALLOWED 0
452 // The number of milliseconds a hotend will preheat before starting to check
453 // the temperature. This value should NOT be set to the time it takes the
454 // hot end to reach the target temperature, but the time it takes to reach
455 // the minimum temperature your thermistor can read. The lower the better/safer.
456 // This shouldn't need to be more than 30 seconds (30000)
457 //#define MILLISECONDS_PREHEAT_TIME 0
459 // @section extruder
461 // Extruder runout prevention.
462 // If the machine is idle and the temperature over MINTEMP
463 // then extrude some filament every couple of SECONDS.
464 //#define EXTRUDER_RUNOUT_PREVENT
465 #if ENABLED(EXTRUDER_RUNOUT_PREVENT)
466 #define EXTRUDER_RUNOUT_MINTEMP 190
467 #define EXTRUDER_RUNOUT_SECONDS 30
468 #define EXTRUDER_RUNOUT_SPEED 1500 // (mm/min)
469 #define EXTRUDER_RUNOUT_EXTRUDE 5 // (mm)
470 #endif
473 * Hotend Idle Timeout
474 * Prevent filament in the nozzle from charring and causing a critical jam.
476 //#define HOTEND_IDLE_TIMEOUT
477 #if ENABLED(HOTEND_IDLE_TIMEOUT)
478 #define HOTEND_IDLE_TIMEOUT_SEC (5*60) // (seconds) Time without extruder movement to trigger protection
479 #define HOTEND_IDLE_MIN_TRIGGER 180 // (°C) Minimum temperature to enable hotend protection
480 #define HOTEND_IDLE_NOZZLE_TARGET 0 // (°C) Safe temperature for the nozzle after timeout
481 #define HOTEND_IDLE_BED_TARGET 0 // (°C) Safe temperature for the bed after timeout
482 #endif
484 // @section temperature
486 // Calibration for AD595 / AD8495 sensor to adjust temperature measurements.
487 // The final temperature is calculated as (measuredTemp * GAIN) + OFFSET.
488 #define TEMP_SENSOR_AD595_OFFSET 0.0
489 #define TEMP_SENSOR_AD595_GAIN 1.0
490 #define TEMP_SENSOR_AD8495_OFFSET 0.0
491 #define TEMP_SENSOR_AD8495_GAIN 1.0
494 * Controller Fan
495 * To cool down the stepper drivers and MOSFETs.
497 * The fan turns on automatically whenever any driver is enabled and turns
498 * off (or reduces to idle speed) shortly after drivers are turned off.
500 //#define USE_CONTROLLER_FAN
501 #if ENABLED(USE_CONTROLLER_FAN)
502 //#define CONTROLLER_FAN_PIN -1 // Set a custom pin for the controller fan
503 //#define CONTROLLER_FAN_USE_Z_ONLY // With this option only the Z axis is considered
504 //#define CONTROLLER_FAN_IGNORE_Z // Ignore Z stepper. Useful when stepper timeout is disabled.
505 #define CONTROLLERFAN_SPEED_MIN 0 // (0-255) Minimum speed. (If set below this value the fan is turned off.)
506 #define CONTROLLERFAN_SPEED_ACTIVE 255 // (0-255) Active speed, used when any motor is enabled
507 #define CONTROLLERFAN_SPEED_IDLE 0 // (0-255) Idle speed, used when motors are disabled
508 #define CONTROLLERFAN_IDLE_TIME 60 // (seconds) Extra time to keep the fan running after disabling motors
510 // Use TEMP_SENSOR_BOARD as a trigger for enabling the controller fan
511 //#define CONTROLLER_FAN_MIN_BOARD_TEMP 40 // (°C) Turn on the fan if the board reaches this temperature
513 //#define CONTROLLER_FAN_EDITABLE // Enable M710 configurable settings
514 #if ENABLED(CONTROLLER_FAN_EDITABLE)
515 #define CONTROLLER_FAN_MENU // Enable the Controller Fan submenu
516 #endif
517 #endif
519 // When first starting the main fan, run it at full speed for the
520 // given number of milliseconds. This gets the fan spinning reliably
521 // before setting a PWM value. (Does not work with software PWM for fan on Sanguinololu)
522 //#define FAN_KICKSTART_TIME 100
524 // Some coolers may require a non-zero "off" state.
525 //#define FAN_OFF_PWM 1
528 * PWM Fan Scaling
530 * Define the min/max speeds for PWM fans (as set with M106).
532 * With these options the M106 0-255 value range is scaled to a subset
533 * to ensure that the fan has enough power to spin, or to run lower
534 * current fans with higher current. (e.g., 5V/12V fans with 12V/24V)
535 * Value 0 always turns off the fan.
537 * Define one or both of these to override the default 0-255 range.
539 //#define FAN_MIN_PWM 50
540 //#define FAN_MAX_PWM 128
543 * Fan Fast PWM
545 * Combinations of PWM Modes, prescale values and TOP resolutions are used internally
546 * to produce a frequency as close as possible to the desired frequency.
548 * FAST_PWM_FAN_FREQUENCY
549 * Set this to your desired frequency.
550 * For AVR, if left undefined this defaults to F = F_CPU/(2*255*1)
551 * i.e., F = 31.4kHz on 16MHz microcontrollers or F = 39.2kHz on 20MHz microcontrollers.
552 * For non AVR, if left undefined this defaults to F = 1Khz.
553 * This F value is only to protect the hardware from an absence of configuration
554 * and not to complete it when users are not aware that the frequency must be specifically set to support the target board.
556 * NOTE: Setting very low frequencies (< 10 Hz) may result in unexpected timer behavior.
557 * Setting very high frequencies can damage your hardware.
559 * USE_OCR2A_AS_TOP [undefined by default]
560 * Boards that use TIMER2 for PWM have limitations resulting in only a few possible frequencies on TIMER2:
561 * 16MHz MCUs: [62.5kHz, 31.4kHz (default), 7.8kHz, 3.92kHz, 1.95kHz, 977Hz, 488Hz, 244Hz, 60Hz, 122Hz, 30Hz]
562 * 20MHz MCUs: [78.1kHz, 39.2kHz (default), 9.77kHz, 4.9kHz, 2.44kHz, 1.22kHz, 610Hz, 305Hz, 153Hz, 76Hz, 38Hz]
563 * A greater range can be achieved by enabling USE_OCR2A_AS_TOP. But note that this option blocks the use of
564 * PWM on pin OC2A. Only use this option if you don't need PWM on 0C2A. (Check your schematic.)
565 * USE_OCR2A_AS_TOP sacrifices duty cycle control resolution to achieve this broader range of frequencies.
567 //#define FAST_PWM_FAN // Increase the fan PWM frequency. Removes the PWM noise but increases heating in the FET/Arduino
568 #if ENABLED(FAST_PWM_FAN)
569 //#define FAST_PWM_FAN_FREQUENCY 31400 // Define here to override the defaults below
570 //#define USE_OCR2A_AS_TOP
571 #ifndef FAST_PWM_FAN_FREQUENCY
572 #ifdef __AVR__
573 #define FAST_PWM_FAN_FREQUENCY ((F_CPU) / (2 * 255 * 1))
574 #else
575 #define FAST_PWM_FAN_FREQUENCY 1000U
576 #endif
577 #endif
578 #endif
581 * Use one of the PWM fans as a redundant part-cooling fan
583 //#define REDUNDANT_PART_COOLING_FAN 2 // Index of the fan to sync with FAN 0.
585 // @section extruder
588 * Extruder cooling fans
590 * Extruder auto fans automatically turn on when their extruders'
591 * temperatures go above EXTRUDER_AUTO_FAN_TEMPERATURE.
593 * Your board's pins file specifies the recommended pins. Override those here
594 * or set to -1 to disable completely.
596 * Multiple extruders can be assigned to the same pin in which case
597 * the fan will turn on when any selected extruder is above the threshold.
599 #define E0_AUTO_FAN_PIN -1
600 #define E1_AUTO_FAN_PIN -1
601 #define E2_AUTO_FAN_PIN -1
602 #define E3_AUTO_FAN_PIN -1
603 #define E4_AUTO_FAN_PIN -1
604 #define E5_AUTO_FAN_PIN -1
605 #define E6_AUTO_FAN_PIN -1
606 #define E7_AUTO_FAN_PIN -1
607 #define CHAMBER_AUTO_FAN_PIN -1
608 #define COOLER_AUTO_FAN_PIN -1
610 #define EXTRUDER_AUTO_FAN_TEMPERATURE 50
611 #define EXTRUDER_AUTO_FAN_SPEED 255 // 255 == full speed
612 #define CHAMBER_AUTO_FAN_TEMPERATURE 30
613 #define CHAMBER_AUTO_FAN_SPEED 255
614 #define COOLER_AUTO_FAN_TEMPERATURE 18
615 #define COOLER_AUTO_FAN_SPEED 255
618 * Hotend Cooling Fans tachometers
620 * Define one or more tachometer pins to enable fan speed
621 * monitoring, and reporting of fan speeds with M123.
623 * NOTE: Only works with fans up to 7000 RPM.
625 //#define FOURWIRES_FANS // Needed with AUTO_FAN when 4-wire PWM fans are installed
626 //#define E0_FAN_TACHO_PIN -1
627 //#define E0_FAN_TACHO_PULLUP
628 //#define E0_FAN_TACHO_PULLDOWN
629 //#define E1_FAN_TACHO_PIN -1
630 //#define E1_FAN_TACHO_PULLUP
631 //#define E1_FAN_TACHO_PULLDOWN
632 //#define E2_FAN_TACHO_PIN -1
633 //#define E2_FAN_TACHO_PULLUP
634 //#define E2_FAN_TACHO_PULLDOWN
635 //#define E3_FAN_TACHO_PIN -1
636 //#define E3_FAN_TACHO_PULLUP
637 //#define E3_FAN_TACHO_PULLDOWN
638 //#define E4_FAN_TACHO_PIN -1
639 //#define E4_FAN_TACHO_PULLUP
640 //#define E4_FAN_TACHO_PULLDOWN
641 //#define E5_FAN_TACHO_PIN -1
642 //#define E5_FAN_TACHO_PULLUP
643 //#define E5_FAN_TACHO_PULLDOWN
644 //#define E6_FAN_TACHO_PIN -1
645 //#define E6_FAN_TACHO_PULLUP
646 //#define E6_FAN_TACHO_PULLDOWN
647 //#define E7_FAN_TACHO_PIN -1
648 //#define E7_FAN_TACHO_PULLUP
649 //#define E7_FAN_TACHO_PULLDOWN
652 * Part-Cooling Fan Multiplexer
654 * This feature allows you to digitally multiplex the fan output.
655 * The multiplexer is automatically switched at tool-change.
656 * Set FANMUX[012]_PINs below for up to 2, 4, or 8 multiplexed fans.
658 #define FANMUX0_PIN -1
659 #define FANMUX1_PIN -1
660 #define FANMUX2_PIN -1
663 * M355 Case Light on-off / brightness
665 //#define CASE_LIGHT_ENABLE
666 #if ENABLED(CASE_LIGHT_ENABLE)
667 //#define CASE_LIGHT_PIN 4 // Override the default pin if needed
668 #define INVERT_CASE_LIGHT false // Set true if Case Light is ON when pin is LOW
669 #define CASE_LIGHT_DEFAULT_ON true // Set default power-up state on
670 #define CASE_LIGHT_DEFAULT_BRIGHTNESS 105 // Set default power-up brightness (0-255, requires PWM pin)
671 //#define CASE_LIGHT_NO_BRIGHTNESS // Disable brightness control. Enable for non-PWM lighting.
672 //#define CASE_LIGHT_MAX_PWM 128 // Limit PWM duty cycle (0-255)
673 //#define CASE_LIGHT_MENU // Add Case Light options to the LCD menu
674 #if ENABLED(NEOPIXEL_LED)
675 //#define CASE_LIGHT_USE_NEOPIXEL // Use NeoPixel LED as case light
676 #endif
677 #if EITHER(RGB_LED, RGBW_LED)
678 //#define CASE_LIGHT_USE_RGB_LED // Use RGB / RGBW LED as case light
679 #endif
680 #if EITHER(CASE_LIGHT_USE_NEOPIXEL, CASE_LIGHT_USE_RGB_LED)
681 #define CASE_LIGHT_DEFAULT_COLOR { 255, 255, 255, 255 } // { Red, Green, Blue, White }
682 #endif
683 #endif
685 // @section homing
687 // If you want endstops to stay on (by default) even when not homing
688 // enable this option. Override at any time with M120, M121.
689 //#define ENDSTOPS_ALWAYS_ON_DEFAULT
691 // @section extras
693 //#define Z_LATE_ENABLE // Enable Z the last moment. Needed if your Z driver overheats.
695 // Employ an external closed loop controller. Override pins here if needed.
696 //#define EXTERNAL_CLOSED_LOOP_CONTROLLER
697 #if ENABLED(EXTERNAL_CLOSED_LOOP_CONTROLLER)
698 //#define CLOSED_LOOP_ENABLE_PIN -1
699 //#define CLOSED_LOOP_MOVE_COMPLETE_PIN -1
700 #endif
703 * Dual X Carriage
705 * This setup has two X carriages that can move independently, each with its own hotend.
706 * The carriages can be used to print an object with two colors or materials, or in
707 * "duplication mode" it can print two identical or X-mirrored objects simultaneously.
708 * The inactive carriage is parked automatically to prevent oozing.
709 * X1 is the left carriage, X2 the right. They park and home at opposite ends of the X axis.
710 * By default the X2 stepper is assigned to the first unused E plug on the board.
712 * The following Dual X Carriage modes can be selected with M605 S<mode>:
714 * 0 : (FULL_CONTROL) The slicer has full control over both X-carriages and can achieve optimal travel
715 * results as long as it supports dual X-carriages. (M605 S0)
717 * 1 : (AUTO_PARK) The firmware automatically parks and unparks the X-carriages on tool-change so
718 * that additional slicer support is not required. (M605 S1)
720 * 2 : (DUPLICATION) The firmware moves the second X-carriage and extruder in synchronization with
721 * the first X-carriage and extruder, to print 2 copies of the same object at the same time.
722 * Set the constant X-offset and temperature differential with M605 S2 X[offs] R[deg] and
723 * follow with M605 S2 to initiate duplicated movement.
725 * 3 : (MIRRORED) Formbot/Vivedino-inspired mirrored mode in which the second extruder duplicates
726 * the movement of the first except the second extruder is reversed in the X axis.
727 * Set the initial X offset and temperature differential with M605 S2 X[offs] R[deg] and
728 * follow with M605 S3 to initiate mirrored movement.
730 //#define DUAL_X_CARRIAGE
731 #if ENABLED(DUAL_X_CARRIAGE)
732 #define X1_MIN_POS X_MIN_POS // Set to X_MIN_POS
733 #define X1_MAX_POS X_BED_SIZE // A max coordinate so the X1 carriage can't hit the parked X2 carriage
734 #define X2_MIN_POS 80 // A min coordinate so the X2 carriage can't hit the parked X1 carriage
735 #define X2_MAX_POS 353 // The max position of the X2 carriage, typically also the home position
736 #define X2_HOME_DIR 1 // Set to 1. The X2 carriage always homes to the max endstop position
737 #define X2_HOME_POS X2_MAX_POS // Default X2 home position. Set to X2_MAX_POS.
738 // NOTE: For Dual X Carriage use M218 T1 Xn to override the X2_HOME_POS.
739 // This allows recalibration of endstops distance without a rebuild.
740 // Remember to set the second extruder's X-offset to 0 in your slicer.
742 // This is the default power-up mode which can be changed later using M605 S<mode>.
743 #define DEFAULT_DUAL_X_CARRIAGE_MODE DXC_AUTO_PARK_MODE
745 // Default x offset in duplication mode (typically set to half print bed width)
746 #define DEFAULT_DUPLICATION_X_OFFSET 100
748 // Default action to execute following M605 mode change commands. Typically G28X to apply new mode.
749 //#define EVENT_GCODE_IDEX_AFTER_MODECHANGE "G28X"
750 #endif
753 * Multi-Stepper / Multi-Endstop
755 * When X2_DRIVER_TYPE is defined, this indicates that the X and X2 motors work in tandem.
756 * The following explanations for X also apply to Y and Z multi-stepper setups.
757 * Endstop offsets may be changed by 'M666 X<offset> Y<offset> Z<offset>' and stored to EEPROM.
759 * - Enable INVERT_X2_VS_X_DIR if the X2 motor requires an opposite DIR signal from X.
761 * - Enable X_DUAL_ENDSTOPS if the second motor has its own endstop, with adjustable offset.
763 * - Extra endstops are included in the output of 'M119'.
765 * - Set X_DUAL_ENDSTOP_ADJUSTMENT to the known error in the X2 endstop.
766 * Applied to the X2 motor on 'G28' / 'G28 X'.
767 * Get the offset by homing X and measuring the error.
768 * Also set with 'M666 X<offset>' and stored to EEPROM with 'M500'.
770 * - Use X2_USE_ENDSTOP to set the endstop plug by name. (_XMIN_, _XMAX_, _YMIN_, _YMAX_, _ZMIN_, _ZMAX_)
772 #if HAS_X2_STEPPER && DISABLED(DUAL_X_CARRIAGE)
773 //#define INVERT_X2_VS_X_DIR // X2 direction signal is the opposite of X
774 //#define X_DUAL_ENDSTOPS // X2 has its own endstop
775 #if ENABLED(X_DUAL_ENDSTOPS)
776 #define X2_USE_ENDSTOP _XMAX_ // X2 endstop board plug. Don't forget to enable USE_*_PLUG.
777 #define X2_ENDSTOP_ADJUSTMENT 0 // X2 offset relative to X endstop
778 #endif
779 #endif
781 #if HAS_DUAL_Y_STEPPERS
782 //#define INVERT_Y2_VS_Y_DIR // Y2 direction signal is the opposite of Y
783 //#define Y_DUAL_ENDSTOPS // Y2 has its own endstop
784 #if ENABLED(Y_DUAL_ENDSTOPS)
785 #define Y2_USE_ENDSTOP _YMAX_ // Y2 endstop board plug. Don't forget to enable USE_*_PLUG.
786 #define Y2_ENDSTOP_ADJUSTMENT 0 // Y2 offset relative to Y endstop
787 #endif
788 #endif
791 // Multi-Z steppers
793 #ifdef Z2_DRIVER_TYPE
794 //#define INVERT_Z2_VS_Z_DIR // Z2 direction signal is the opposite of Z
796 //#define Z_MULTI_ENDSTOPS // Other Z axes have their own endstops
797 #if ENABLED(Z_MULTI_ENDSTOPS)
798 #define Z2_USE_ENDSTOP _XMAX_ // Z2 endstop board plug. Don't forget to enable USE_*_PLUG.
799 #define Z2_ENDSTOP_ADJUSTMENT 0 // Z2 offset relative to Y endstop
800 #endif
801 #ifdef Z3_DRIVER_TYPE
802 //#define INVERT_Z3_VS_Z_DIR // Z3 direction signal is the opposite of Z
803 #if ENABLED(Z_MULTI_ENDSTOPS)
804 #define Z3_USE_ENDSTOP _YMAX_ // Z3 endstop board plug. Don't forget to enable USE_*_PLUG.
805 #define Z3_ENDSTOP_ADJUSTMENT 0 // Z3 offset relative to Y endstop
806 #endif
807 #endif
808 #ifdef Z4_DRIVER_TYPE
809 //#define INVERT_Z4_VS_Z_DIR // Z4 direction signal is the opposite of Z
810 #if ENABLED(Z_MULTI_ENDSTOPS)
811 #define Z4_USE_ENDSTOP _ZMAX_ // Z4 endstop board plug. Don't forget to enable USE_*_PLUG.
812 #define Z4_ENDSTOP_ADJUSTMENT 0 // Z4 offset relative to Y endstop
813 #endif
814 #endif
815 #endif
817 // Drive the E axis with two synchronized steppers
818 //#define E_DUAL_STEPPER_DRIVERS
819 #if ENABLED(E_DUAL_STEPPER_DRIVERS)
820 //#define INVERT_E1_VS_E0_DIR // E direction signals are opposites
821 #endif
823 // Activate a solenoid on the active extruder with M380. Disable all with M381.
824 // Define SOL0_PIN, SOL1_PIN, etc., for each extruder that has a solenoid.
825 //#define EXT_SOLENOID
827 // @section homing
830 * Homing Procedure
831 * Homing (G28) does an indefinite move towards the endstops to establish
832 * the position of the toolhead relative to the workspace.
835 //#define SENSORLESS_BACKOFF_MM { 2, 2, 0 } // (mm) Backoff from endstops before sensorless homing
837 #define HOMING_BUMP_MM { 5, 5, 2 } // (mm) Backoff from endstops after first bump
838 #define HOMING_BUMP_DIVISOR { 2, 2, 4 } // Re-Bump Speed Divisor (Divides the Homing Feedrate)
840 //#define HOMING_BACKOFF_POST_MM { 2, 2, 2 } // (mm) Backoff from endstops after homing
842 //#define QUICK_HOME // If G28 contains XY do a diagonal move first
843 //#define HOME_Y_BEFORE_X // If G28 contains XY home Y before X
844 //#define HOME_Z_FIRST // Home Z first. Requires a Z-MIN endstop (not a probe).
845 //#define CODEPENDENT_XY_HOMING // If X/Y can't home without homing Y/X first
847 // @section bltouch
849 #if ENABLED(BLTOUCH)
851 * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
852 * Do not activate settings that the probe might not understand. Clones might misunderstand
853 * advanced commands.
855 * Note: If the probe is not deploying, do a "Reset" and "Self-Test" and then check the
856 * wiring of the BROWN, RED and ORANGE wires.
858 * Note: If the trigger signal of your probe is not being recognized, it has been very often
859 * because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
860 * like they would be with a real switch. So please check the wiring first.
862 * Settings for all BLTouch and clone probes:
865 // Safety: The probe needs time to recognize the command.
866 // Minimum command delay (ms). Enable and increase if needed.
867 //#define BLTOUCH_DELAY 500
870 * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
873 // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
874 // in special cases, like noisy or filtered input configurations.
875 //#define BLTOUCH_FORCE_SW_MODE
878 * Settings for BLTouch Smart 3.0 and 3.1
879 * Summary:
880 * - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
881 * - High-Speed mode
882 * - Disable LCD voltage options
886 * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
887 * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
888 * If disabled, OD mode is the hard-coded default on 3.0
889 * On startup, Marlin will compare its eeprom to this value. If the selected mode
890 * differs, a mode set eeprom write will be completed at initialization.
891 * Use the option below to force an eeprom write to a V3.1 probe regardless.
893 //#define BLTOUCH_SET_5V_MODE
896 * Safety: Activate if connecting a probe with an unknown voltage mode.
897 * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
898 * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
899 * To preserve the life of the probe, use this once then turn it off and re-flash.
901 //#define BLTOUCH_FORCE_MODE_SET
904 * Enable "HIGH SPEED" option for probing.
905 * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
906 * This feature was designed for Deltabots with very fast Z moves; however, higher speed Cartesians
907 * might be able to use it. If the machine can't raise Z fast enough the BLTouch may go into ALARM.
909 * Set the default state here, change with 'M401 S' or UI, use M500 to save, M502 to reset.
911 //#define BLTOUCH_HS_MODE true
913 // Safety: Enable voltage mode settings in the LCD menu.
914 //#define BLTOUCH_LCD_VOLTAGE_MENU
916 #endif // BLTOUCH
918 // @section extras
921 * Z Steppers Auto-Alignment
922 * Add the G34 command to align multiple Z steppers using a bed probe.
924 //#define Z_STEPPER_AUTO_ALIGN
925 #if ENABLED(Z_STEPPER_AUTO_ALIGN)
927 * Define probe X and Y positions for Z1, Z2 [, Z3 [, Z4]]
928 * These positions are machine-relative and do not shift with the M206 home offset!
929 * If not defined, probe limits will be used.
930 * Override with 'M422 S<index> X<pos> Y<pos>'.
932 //#define Z_STEPPER_ALIGN_XY { { 10, 190 }, { 100, 10 }, { 190, 190 } }
935 * Orientation for the automatically-calculated probe positions.
936 * Override Z stepper align points with 'M422 S<index> X<pos> Y<pos>'
938 * 2 Steppers: (0) (1)
939 * | | 2 |
940 * | 1 2 | |
941 * | | 1 |
943 * 3 Steppers: (0) (1) (2) (3)
944 * | 3 | 1 | 2 1 | 2 |
945 * | | 3 | | 3 |
946 * | 1 2 | 2 | 3 | 1 |
948 * 4 Steppers: (0) (1) (2) (3)
949 * | 4 3 | 1 4 | 2 1 | 3 2 |
950 * | | | | |
951 * | 1 2 | 2 3 | 3 4 | 4 1 |
953 #ifndef Z_STEPPER_ALIGN_XY
954 //#define Z_STEPPERS_ORIENTATION 0
955 #endif
958 * Z Stepper positions for more rapid convergence in bed alignment.
959 * Requires 3 or 4 Z steppers.
961 * Define Stepper XY positions for Z1, Z2, Z3... corresponding to the screw
962 * positions in the bed carriage, with one position per Z stepper in stepper
963 * driver order.
965 //#define Z_STEPPER_ALIGN_STEPPER_XY { { 210.7, 102.5 }, { 152.6, 220.0 }, { 94.5, 102.5 } }
967 #ifndef Z_STEPPER_ALIGN_STEPPER_XY
968 // Amplification factor. Used to scale the correction step up or down in case
969 // the stepper (spindle) position is farther out than the test point.
970 #define Z_STEPPER_ALIGN_AMP 1.0 // Use a value > 1.0 NOTE: This may cause instability!
971 #endif
973 // On a 300mm bed a 5% grade would give a misalignment of ~1.5cm
974 #define G34_MAX_GRADE 5 // (%) Maximum incline that G34 will handle
975 #define Z_STEPPER_ALIGN_ITERATIONS 5 // Number of iterations to apply during alignment
976 #define Z_STEPPER_ALIGN_ACC 0.02 // Stop iterating early if the accuracy is better than this
977 #define RESTORE_LEVELING_AFTER_G34 // Restore leveling after G34 is done?
978 // After G34, re-home Z (G28 Z) or just calculate it from the last probe heights?
979 // Re-homing might be more precise in reproducing the actual 'G28 Z' homing height, especially on an uneven bed.
980 #define HOME_AFTER_G34
981 #endif
984 // Add the G35 command to read bed corners to help adjust screws. Requires a bed probe.
986 //#define ASSISTED_TRAMMING
987 #if ENABLED(ASSISTED_TRAMMING)
989 // Define positions for probe points.
990 #define TRAMMING_POINT_XY { { 20, 20 }, { 180, 20 }, { 180, 180 }, { 20, 180 } }
992 // Define position names for probe points.
993 #define TRAMMING_POINT_NAME_1 "Front-Left"
994 #define TRAMMING_POINT_NAME_2 "Front-Right"
995 #define TRAMMING_POINT_NAME_3 "Back-Right"
996 #define TRAMMING_POINT_NAME_4 "Back-Left"
998 #define RESTORE_LEVELING_AFTER_G35 // Enable to restore leveling setup after operation
999 //#define REPORT_TRAMMING_MM // Report Z deviation (mm) for each point relative to the first
1001 //#define ASSISTED_TRAMMING_WIZARD // Add a Tramming Wizard to the LCD menu
1003 //#define ASSISTED_TRAMMING_WAIT_POSITION { X_CENTER, Y_CENTER, 30 } // Move the nozzle out of the way for adjustment
1006 * Screw thread:
1007 * M3: 30 = Clockwise, 31 = Counter-Clockwise
1008 * M4: 40 = Clockwise, 41 = Counter-Clockwise
1009 * M5: 50 = Clockwise, 51 = Counter-Clockwise
1011 #define TRAMMING_SCREW_THREAD 30
1013 #endif
1015 // @section motion
1017 #define AXIS_RELATIVE_MODES { false, false, false, false }
1019 // Add a Duplicate option for well-separated conjoined nozzles
1020 //#define MULTI_NOZZLE_DUPLICATION
1022 // By default pololu step drivers require an active high signal. However, some high power drivers require an active low signal as step.
1023 #define INVERT_X_STEP_PIN false
1024 #define INVERT_Y_STEP_PIN false
1025 #define INVERT_Z_STEP_PIN false
1026 #define INVERT_I_STEP_PIN false
1027 #define INVERT_J_STEP_PIN false
1028 #define INVERT_K_STEP_PIN false
1029 #define INVERT_E_STEP_PIN false
1032 * Idle Stepper Shutdown
1033 * Set DISABLE_INACTIVE_? 'true' to shut down axis steppers after an idle period.
1034 * The Deactive Time can be overridden with M18 and M84. Set to 0 for No Timeout.
1036 #define DEFAULT_STEPPER_DEACTIVE_TIME 120
1037 #define DISABLE_INACTIVE_X true
1038 #define DISABLE_INACTIVE_Y true
1039 #define DISABLE_INACTIVE_Z true // Set 'false' if the nozzle could fall onto your printed part!
1040 #define DISABLE_INACTIVE_I true
1041 #define DISABLE_INACTIVE_J true
1042 #define DISABLE_INACTIVE_K true
1043 #define DISABLE_INACTIVE_E true
1045 // Default Minimum Feedrates for printing and travel moves
1046 #define DEFAULT_MINIMUMFEEDRATE 0.0 // (mm/s) Minimum feedrate. Set with M205 S.
1047 #define DEFAULT_MINTRAVELFEEDRATE 0.0 // (mm/s) Minimum travel feedrate. Set with M205 T.
1049 // Minimum time that a segment needs to take as the buffer gets emptied
1050 #define DEFAULT_MINSEGMENTTIME 20000 // (µs) Set with M205 B.
1052 // Slow down the machine if the lookahead buffer is (by default) half full.
1053 // Increase the slowdown divisor for larger buffer sizes.
1054 #define SLOWDOWN
1055 #if ENABLED(SLOWDOWN)
1056 #define SLOWDOWN_DIVISOR 2
1057 #endif
1060 * XY Frequency limit
1061 * Reduce resonance by limiting the frequency of small zigzag infill moves.
1062 * See https://hydraraptor.blogspot.com/2010/12/frequency-limit.html
1063 * Use M201 F<freq> G<min%> to change limits at runtime.
1065 //#define XY_FREQUENCY_LIMIT 10 // (Hz) Maximum frequency of small zigzag infill moves. Set with M201 F<hertz>.
1066 #ifdef XY_FREQUENCY_LIMIT
1067 #define XY_FREQUENCY_MIN_PERCENT 5 // (percent) Minimum FR percentage to apply. Set with M201 G<min%>.
1068 #endif
1070 // Minimum planner junction speed. Sets the default minimum speed the planner plans for at the end
1071 // of the buffer and all stops. This should not be much greater than zero and should only be changed
1072 // if unwanted behavior is observed on a user's machine when running at very slow speeds.
1073 #define MINIMUM_PLANNER_SPEED 0.05 // (mm/s)
1076 // Backlash Compensation
1077 // Adds extra movement to axes on direction-changes to account for backlash.
1079 //#define BACKLASH_COMPENSATION
1080 #if ENABLED(BACKLASH_COMPENSATION)
1081 // Define values for backlash distance and correction.
1082 // If BACKLASH_GCODE is enabled these values are the defaults.
1083 #define BACKLASH_DISTANCE_MM { 0, 0, 0 } // (mm) One value for each linear axis
1084 #define BACKLASH_CORRECTION 0.0 // 0.0 = no correction; 1.0 = full correction
1086 // Add steps for motor direction changes on CORE kinematics
1087 //#define CORE_BACKLASH
1089 // Set BACKLASH_SMOOTHING_MM to spread backlash correction over multiple segments
1090 // to reduce print artifacts. (Enabling this is costly in memory and computation!)
1091 //#define BACKLASH_SMOOTHING_MM 3 // (mm)
1093 // Add runtime configuration and tuning of backlash values (M425)
1094 //#define BACKLASH_GCODE
1096 #if ENABLED(BACKLASH_GCODE)
1097 // Measure the Z backlash when probing (G29) and set with "M425 Z"
1098 #define MEASURE_BACKLASH_WHEN_PROBING
1100 #if ENABLED(MEASURE_BACKLASH_WHEN_PROBING)
1101 // When measuring, the probe will move up to BACKLASH_MEASUREMENT_LIMIT
1102 // mm away from point of contact in BACKLASH_MEASUREMENT_RESOLUTION
1103 // increments while checking for the contact to be broken.
1104 #define BACKLASH_MEASUREMENT_LIMIT 0.5 // (mm)
1105 #define BACKLASH_MEASUREMENT_RESOLUTION 0.005 // (mm)
1106 #define BACKLASH_MEASUREMENT_FEEDRATE Z_PROBE_FEEDRATE_SLOW // (mm/min)
1107 #endif
1108 #endif
1109 #endif
1112 * Automatic backlash, position and hotend offset calibration
1114 * Enable G425 to run automatic calibration using an electrically-
1115 * conductive cube, bolt, or washer mounted on the bed.
1117 * G425 uses the probe to touch the top and sides of the calibration object
1118 * on the bed and measures and/or correct positional offsets, axis backlash
1119 * and hotend offsets.
1121 * Note: HOTEND_OFFSET and CALIBRATION_OBJECT_CENTER must be set to within
1122 * ±5mm of true values for G425 to succeed.
1124 //#define CALIBRATION_GCODE
1125 #if ENABLED(CALIBRATION_GCODE)
1127 //#define CALIBRATION_SCRIPT_PRE "M117 Starting Auto-Calibration\nT0\nG28\nG12\nM117 Calibrating..."
1128 //#define CALIBRATION_SCRIPT_POST "M500\nM117 Calibration data saved"
1130 #define CALIBRATION_MEASUREMENT_RESOLUTION 0.01 // mm
1132 #define CALIBRATION_FEEDRATE_SLOW 60 // mm/min
1133 #define CALIBRATION_FEEDRATE_FAST 1200 // mm/min
1134 #define CALIBRATION_FEEDRATE_TRAVEL 3000 // mm/min
1136 // The following parameters refer to the conical section of the nozzle tip.
1137 #define CALIBRATION_NOZZLE_TIP_HEIGHT 1.0 // mm
1138 #define CALIBRATION_NOZZLE_OUTER_DIAMETER 2.0 // mm
1140 // Uncomment to enable reporting (required for "G425 V", but consumes PROGMEM).
1141 //#define CALIBRATION_REPORTING
1143 // The true location and dimension the cube/bolt/washer on the bed.
1144 #define CALIBRATION_OBJECT_CENTER { 264.0, -22.0, -2.0 } // mm
1145 #define CALIBRATION_OBJECT_DIMENSIONS { 10.0, 10.0, 10.0 } // mm
1147 // Comment out any sides which are unreachable by the probe. For best
1148 // auto-calibration results, all sides must be reachable.
1149 #define CALIBRATION_MEASURE_RIGHT
1150 #define CALIBRATION_MEASURE_FRONT
1151 #define CALIBRATION_MEASURE_LEFT
1152 #define CALIBRATION_MEASURE_BACK
1154 //#define CALIBRATION_MEASURE_IMIN
1155 //#define CALIBRATION_MEASURE_IMAX
1156 //#define CALIBRATION_MEASURE_JMIN
1157 //#define CALIBRATION_MEASURE_JMAX
1158 //#define CALIBRATION_MEASURE_KMIN
1159 //#define CALIBRATION_MEASURE_KMAX
1161 // Probing at the exact top center only works if the center is flat. If
1162 // probing on a screwhead or hollow washer, probe near the edges.
1163 //#define CALIBRATION_MEASURE_AT_TOP_EDGES
1165 // Define the pin to read during calibration
1166 #ifndef CALIBRATION_PIN
1167 //#define CALIBRATION_PIN -1 // Define here to override the default pin
1168 #define CALIBRATION_PIN_INVERTING false // Set to true to invert the custom pin
1169 //#define CALIBRATION_PIN_PULLDOWN
1170 #define CALIBRATION_PIN_PULLUP
1171 #endif
1172 #endif
1175 * Adaptive Step Smoothing increases the resolution of multi-axis moves, particularly at step frequencies
1176 * below 1kHz (for AVR) or 10kHz (for ARM), where aliasing between axes in multi-axis moves causes audible
1177 * vibration and surface artifacts. The algorithm adapts to provide the best possible step smoothing at the
1178 * lowest stepping frequencies.
1180 //#define ADAPTIVE_STEP_SMOOTHING
1183 * Custom Microstepping
1184 * Override as-needed for your setup. Up to 3 MS pins are supported.
1186 //#define MICROSTEP1 LOW,LOW,LOW
1187 //#define MICROSTEP2 HIGH,LOW,LOW
1188 //#define MICROSTEP4 LOW,HIGH,LOW
1189 //#define MICROSTEP8 HIGH,HIGH,LOW
1190 //#define MICROSTEP16 LOW,LOW,HIGH
1191 //#define MICROSTEP32 HIGH,LOW,HIGH
1193 // Microstep settings (Requires a board with pins named X_MS1, X_MS2, etc.)
1194 #define MICROSTEP_MODES { 16, 16, 16, 16, 16, 16 } // [1,2,4,8,16]
1197 * @section stepper motor current
1199 * Some boards have a means of setting the stepper motor current via firmware.
1201 * The power on motor currents are set by:
1202 * PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
1203 * known compatible chips: A4982
1204 * DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
1205 * known compatible chips: AD5206
1206 * DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
1207 * known compatible chips: MCP4728
1208 * DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
1209 * known compatible chips: MCP4451, MCP4018
1211 * Motor currents can also be set by M907 - M910 and by the LCD.
1212 * M907 - applies to all.
1213 * M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
1214 * M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
1216 //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 } // Values in milliamps
1217 //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 } // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
1218 //#define DAC_MOTOR_CURRENT_DEFAULT { 70, 80, 90, 80 } // Default drive percent - X, Y, Z, E axis
1221 * I2C-based DIGIPOTs (e.g., Azteeg X3 Pro)
1223 //#define DIGIPOT_MCP4018 // Requires https://github.com/felias-fogg/SlowSoftI2CMaster
1224 //#define DIGIPOT_MCP4451
1225 #if EITHER(DIGIPOT_MCP4018, DIGIPOT_MCP4451)
1226 #define DIGIPOT_I2C_NUM_CHANNELS 8 // 5DPRINT:4 AZTEEG_X3_PRO:8 MKS_SBASE:5 MIGHTYBOARD_REVE:5
1228 // Actual motor currents in Amps. The number of entries must match DIGIPOT_I2C_NUM_CHANNELS.
1229 // These correspond to the physical drivers, so be mindful if the order is changed.
1230 #define DIGIPOT_I2C_MOTOR_CURRENTS { 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 } // AZTEEG_X3_PRO
1232 //#define DIGIPOT_USE_RAW_VALUES // Use DIGIPOT_MOTOR_CURRENT raw wiper values (instead of A4988 motor currents)
1235 * Common slave addresses:
1237 * A (A shifted) B (B shifted) IC
1238 * Smoothie 0x2C (0x58) 0x2D (0x5A) MCP4451
1239 * AZTEEG_X3_PRO 0x2C (0x58) 0x2E (0x5C) MCP4451
1240 * AZTEEG_X5_MINI 0x2C (0x58) 0x2E (0x5C) MCP4451
1241 * AZTEEG_X5_MINI_WIFI 0x58 0x5C MCP4451
1242 * MIGHTYBOARD_REVE 0x2F (0x5E) MCP4018
1244 //#define DIGIPOT_I2C_ADDRESS_A 0x2C // Unshifted slave address for first DIGIPOT
1245 //#define DIGIPOT_I2C_ADDRESS_B 0x2D // Unshifted slave address for second DIGIPOT
1246 #endif
1248 //===========================================================================
1249 //=============================Additional Features===========================
1250 //===========================================================================
1252 // @section lcd
1254 #if HAS_MANUAL_MOVE_MENU
1255 #define MANUAL_FEEDRATE { 50*60, 50*60, 4*60, 2*60 } // (mm/min) Feedrates for manual moves along X, Y, Z, E from panel
1256 #define FINE_MANUAL_MOVE 0.025 // (mm) Smallest manual move (< 0.1mm) applying to Z on most machines
1257 #if IS_ULTIPANEL
1258 #define MANUAL_E_MOVES_RELATIVE // Display extruder move distance rather than "position"
1259 #define ULTIPANEL_FEEDMULTIPLY // Encoder sets the feedrate multiplier on the Status Screen
1260 #endif
1261 #endif
1263 // Change values more rapidly when the encoder is rotated faster
1264 #define ENCODER_RATE_MULTIPLIER
1265 #if ENABLED(ENCODER_RATE_MULTIPLIER)
1266 #define ENCODER_10X_STEPS_PER_SEC 30 // (steps/s) Encoder rate for 10x speed
1267 #define ENCODER_100X_STEPS_PER_SEC 80 // (steps/s) Encoder rate for 100x speed
1268 #endif
1270 // Play a beep when the feedrate is changed from the Status Screen
1271 //#define BEEP_ON_FEEDRATE_CHANGE
1272 #if ENABLED(BEEP_ON_FEEDRATE_CHANGE)
1273 #define FEEDRATE_CHANGE_BEEP_DURATION 10
1274 #define FEEDRATE_CHANGE_BEEP_FREQUENCY 440
1275 #endif
1278 // LCD Backlight Timeout
1280 //#define LCD_BACKLIGHT_TIMEOUT 30 // (s) Timeout before turning off the backlight
1282 #if HAS_BED_PROBE && EITHER(HAS_MARLINUI_MENU, HAS_TFT_LVGL_UI)
1283 //#define PROBE_OFFSET_WIZARD // Add a Probe Z Offset calibration option to the LCD menu
1284 #if ENABLED(PROBE_OFFSET_WIZARD)
1286 * Enable to init the Probe Z-Offset when starting the Wizard.
1287 * Use a height slightly above the estimated nozzle-to-probe Z offset.
1288 * For example, with an offset of -5, consider a starting height of -4.
1290 //#define PROBE_OFFSET_WIZARD_START_Z -4.0
1292 // Set a convenient position to do the calibration (probing point and nozzle/bed-distance)
1293 //#define PROBE_OFFSET_WIZARD_XY_POS { X_CENTER, Y_CENTER }
1294 #endif
1295 #endif
1297 #if HAS_MARLINUI_MENU
1299 #if HAS_BED_PROBE
1300 // Add calibration in the Probe Offsets menu to compensate for X-axis twist.
1301 //#define X_AXIS_TWIST_COMPENSATION
1302 #if ENABLED(X_AXIS_TWIST_COMPENSATION)
1304 * Enable to init the Probe Z-Offset when starting the Wizard.
1305 * Use a height slightly above the estimated nozzle-to-probe Z offset.
1306 * For example, with an offset of -5, consider a starting height of -4.
1308 #define XATC_START_Z 0.0
1309 #define XATC_MAX_POINTS 3 // Number of points to probe in the wizard
1310 #define XATC_Y_POSITION Y_CENTER // (mm) Y position to probe
1311 #define XATC_Z_OFFSETS { 0, 0, 0 } // Z offsets for X axis sample points
1312 #endif
1313 #endif
1315 // Include a page of printer information in the LCD Main Menu
1316 //#define LCD_INFO_MENU
1317 #if ENABLED(LCD_INFO_MENU)
1318 //#define LCD_PRINTER_INFO_IS_BOOTSCREEN // Show bootscreen(s) instead of Printer Info pages
1319 #endif
1321 // BACK menu items keep the highlight at the top
1322 //#define TURBO_BACK_MENU_ITEM
1324 // Insert a menu for preheating at the top level to allow for quick access
1325 //#define PREHEAT_SHORTCUT_MENU_ITEM
1327 #endif // HAS_MARLINUI_MENU
1329 #if ANY(HAS_DISPLAY, DWIN_LCD_PROUI, DWIN_CREALITY_LCD_JYERSUI)
1330 //#define SOUND_MENU_ITEM // Add a mute option to the LCD menu
1331 #define SOUND_ON_DEFAULT // Buzzer/speaker default enabled state
1332 #endif
1334 #if EITHER(HAS_DISPLAY, DWIN_LCD_PROUI)
1335 // The timeout to return to the status screen from sub-menus
1336 //#define LCD_TIMEOUT_TO_STATUS 15000 // (ms)
1338 #if ENABLED(SHOW_BOOTSCREEN)
1339 #define BOOTSCREEN_TIMEOUT 4000 // (ms) Total Duration to display the boot screen(s)
1340 #if EITHER(HAS_MARLINUI_U8GLIB, TFT_COLOR_UI)
1341 #define BOOT_MARLIN_LOGO_SMALL // Show a smaller Marlin logo on the Boot Screen (saving lots of flash)
1342 #endif
1343 #endif
1345 // Scroll a longer status message into view
1346 //#define STATUS_MESSAGE_SCROLLING
1348 // Apply a timeout to low-priority status messages
1349 //#define STATUS_MESSAGE_TIMEOUT_SEC 30 // (seconds)
1351 // On the Info Screen, display XY with one decimal place when possible
1352 //#define LCD_DECIMAL_SMALL_XY
1354 // Add an 'M73' G-code to set the current percentage
1355 //#define LCD_SET_PROGRESS_MANUALLY
1357 // Show the E position (filament used) during printing
1358 //#define LCD_SHOW_E_TOTAL
1361 * LED Control Menu
1362 * Add LED Control to the LCD menu
1364 //#define LED_CONTROL_MENU
1365 #if ENABLED(LED_CONTROL_MENU)
1366 #define LED_COLOR_PRESETS // Enable the Preset Color menu option
1367 //#define NEO2_COLOR_PRESETS // Enable a second NeoPixel Preset Color menu option
1368 #if ENABLED(LED_COLOR_PRESETS)
1369 #define LED_USER_PRESET_RED 255 // User defined RED value
1370 #define LED_USER_PRESET_GREEN 128 // User defined GREEN value
1371 #define LED_USER_PRESET_BLUE 0 // User defined BLUE value
1372 #define LED_USER_PRESET_WHITE 255 // User defined WHITE value
1373 #define LED_USER_PRESET_BRIGHTNESS 255 // User defined intensity
1374 //#define LED_USER_PRESET_STARTUP // Have the printer display the user preset color on startup
1375 #endif
1376 #if ENABLED(NEO2_COLOR_PRESETS)
1377 #define NEO2_USER_PRESET_RED 255 // User defined RED value
1378 #define NEO2_USER_PRESET_GREEN 128 // User defined GREEN value
1379 #define NEO2_USER_PRESET_BLUE 0 // User defined BLUE value
1380 #define NEO2_USER_PRESET_WHITE 255 // User defined WHITE value
1381 #define NEO2_USER_PRESET_BRIGHTNESS 255 // User defined intensity
1382 //#define NEO2_USER_PRESET_STARTUP // Have the printer display the user preset color on startup for the second strip
1383 #endif
1384 #endif
1386 #endif
1388 // LCD Print Progress options
1389 #if EITHER(SDSUPPORT, LCD_SET_PROGRESS_MANUALLY)
1390 #if CAN_SHOW_REMAINING_TIME
1391 //#define SHOW_REMAINING_TIME // Display estimated time to completion
1392 #if ENABLED(SHOW_REMAINING_TIME)
1393 //#define USE_M73_REMAINING_TIME // Use remaining time from M73 command instead of estimation
1394 //#define ROTATE_PROGRESS_DISPLAY // Display (P)rogress, (E)lapsed, and (R)emaining time
1395 #endif
1396 #endif
1398 #if EITHER(HAS_MARLINUI_U8GLIB, EXTENSIBLE_UI)
1399 //#define PRINT_PROGRESS_SHOW_DECIMALS // Show progress with decimal digits
1400 #endif
1402 #if EITHER(HAS_MARLINUI_HD44780, IS_TFTGLCD_PANEL)
1403 //#define LCD_PROGRESS_BAR // Show a progress bar on HD44780 LCDs for SD printing
1404 #if ENABLED(LCD_PROGRESS_BAR)
1405 #define PROGRESS_BAR_BAR_TIME 2000 // (ms) Amount of time to show the bar
1406 #define PROGRESS_BAR_MSG_TIME 3000 // (ms) Amount of time to show the status message
1407 #define PROGRESS_MSG_EXPIRE 0 // (ms) Amount of time to retain the status message (0=forever)
1408 //#define PROGRESS_MSG_ONCE // Show the message for MSG_TIME then clear it
1409 //#define LCD_PROGRESS_BAR_TEST // Add a menu item to test the progress bar
1410 #endif
1411 #endif
1412 #endif
1414 #if ENABLED(SDSUPPORT)
1416 * SD Card SPI Speed
1417 * May be required to resolve "volume init" errors.
1419 * Enable and set to SPI_HALF_SPEED, SPI_QUARTER_SPEED, or SPI_EIGHTH_SPEED
1420 * otherwise full speed will be applied.
1422 * :['SPI_HALF_SPEED', 'SPI_QUARTER_SPEED', 'SPI_EIGHTH_SPEED']
1424 //#define SD_SPI_SPEED SPI_HALF_SPEED
1426 // The standard SD detect circuit reads LOW when media is inserted and HIGH when empty.
1427 // Enable this option and set to HIGH if your SD cards are incorrectly detected.
1428 //#define SD_DETECT_STATE HIGH
1430 //#define SD_IGNORE_AT_STARTUP // Don't mount the SD card when starting up
1431 //#define SDCARD_READONLY // Read-only SD card (to save over 2K of flash)
1433 //#define GCODE_REPEAT_MARKERS // Enable G-code M808 to set repeat markers and do looping
1435 #define SD_PROCEDURE_DEPTH 1 // Increase if you need more nested M32 calls
1437 #define SD_FINISHED_STEPPERRELEASE true // Disable steppers when SD Print is finished
1438 #define SD_FINISHED_RELEASECOMMAND "M84" // Use "M84XYE" to keep Z enabled so your bed stays in place
1440 // Reverse SD sort to show "more recent" files first, according to the card's FAT.
1441 // Since the FAT gets out of order with usage, SDCARD_SORT_ALPHA is recommended.
1442 #define SDCARD_RATHERRECENTFIRST
1444 #define SD_MENU_CONFIRM_START // Confirm the selected SD file before printing
1446 //#define NO_SD_AUTOSTART // Remove auto#.g file support completely to save some Flash, SRAM
1447 //#define MENU_ADDAUTOSTART // Add a menu option to run auto#.g files
1449 //#define BROWSE_MEDIA_ON_INSERT // Open the file browser when media is inserted
1451 //#define MEDIA_MENU_AT_TOP // Force the media menu to be listed on the top of the main menu
1453 #define EVENT_GCODE_SD_ABORT "G28XY" // G-code to run on SD Abort Print (e.g., "G28XY" or "G27")
1455 #if ENABLED(PRINTER_EVENT_LEDS)
1456 #define PE_LEDS_COMPLETED_TIME (30*60) // (seconds) Time to keep the LED "done" color before restoring normal illumination
1457 #endif
1460 * Continue after Power-Loss (Creality3D)
1462 * Store the current state to the SD Card at the start of each layer
1463 * during SD printing. If the recovery file is found at boot time, present
1464 * an option on the LCD screen to continue the print from the last-known
1465 * point in the file.
1467 //#define POWER_LOSS_RECOVERY
1468 #if ENABLED(POWER_LOSS_RECOVERY)
1469 #define PLR_ENABLED_DEFAULT false // Power Loss Recovery enabled by default. (Set with 'M413 Sn' & M500)
1470 //#define BACKUP_POWER_SUPPLY // Backup power / UPS to move the steppers on power loss
1471 //#define POWER_LOSS_ZRAISE 2 // (mm) Z axis raise on resume (on power loss with UPS)
1472 //#define POWER_LOSS_PIN 44 // Pin to detect power loss. Set to -1 to disable default pin on boards without module.
1473 //#define POWER_LOSS_STATE HIGH // State of pin indicating power loss
1474 //#define POWER_LOSS_PULLUP // Set pullup / pulldown as appropriate for your sensor
1475 //#define POWER_LOSS_PULLDOWN
1476 //#define POWER_LOSS_PURGE_LEN 20 // (mm) Length of filament to purge on resume
1477 //#define POWER_LOSS_RETRACT_LEN 10 // (mm) Length of filament to retract on fail. Requires backup power.
1479 // Without a POWER_LOSS_PIN the following option helps reduce wear on the SD card,
1480 // especially with "vase mode" printing. Set too high and vases cannot be continued.
1481 #define POWER_LOSS_MIN_Z_CHANGE 0.05 // (mm) Minimum Z change before saving power-loss data
1483 // Enable if Z homing is needed for proper recovery. 99.9% of the time this should be disabled!
1484 //#define POWER_LOSS_RECOVER_ZHOME
1485 #if ENABLED(POWER_LOSS_RECOVER_ZHOME)
1486 //#define POWER_LOSS_ZHOME_POS { 0, 0 } // Safe XY position to home Z while avoiding objects on the bed
1487 #endif
1488 #endif
1491 * Sort SD file listings in alphabetical order.
1493 * With this option enabled, items on SD cards will be sorted
1494 * by name for easier navigation.
1496 * By default...
1498 * - Use the slowest -but safest- method for sorting.
1499 * - Folders are sorted to the top.
1500 * - The sort key is statically allocated.
1501 * - No added G-code (M34) support.
1502 * - 40 item sorting limit. (Items after the first 40 are unsorted.)
1504 * SD sorting uses static allocation (as set by SDSORT_LIMIT), allowing the
1505 * compiler to calculate the worst-case usage and throw an error if the SRAM
1506 * limit is exceeded.
1508 * - SDSORT_USES_RAM provides faster sorting via a static directory buffer.
1509 * - SDSORT_USES_STACK does the same, but uses a local stack-based buffer.
1510 * - SDSORT_CACHE_NAMES will retain the sorted file listing in RAM. (Expensive!)
1511 * - SDSORT_DYNAMIC_RAM only uses RAM when the SD menu is visible. (Use with caution!)
1513 //#define SDCARD_SORT_ALPHA
1515 // SD Card Sorting options
1516 #if ENABLED(SDCARD_SORT_ALPHA)
1517 #define SDSORT_LIMIT 40 // Maximum number of sorted items (10-256). Costs 27 bytes each.
1518 #define FOLDER_SORTING -1 // -1=above 0=none 1=below
1519 #define SDSORT_GCODE false // Allow turning sorting on/off with LCD and M34 G-code.
1520 #define SDSORT_USES_RAM false // Pre-allocate a static array for faster pre-sorting.
1521 #define SDSORT_USES_STACK false // Prefer the stack for pre-sorting to give back some SRAM. (Negated by next 2 options.)
1522 #define SDSORT_CACHE_NAMES false // Keep sorted items in RAM longer for speedy performance. Most expensive option.
1523 #define SDSORT_DYNAMIC_RAM false // Use dynamic allocation (within SD menus). Least expensive option. Set SDSORT_LIMIT before use!
1524 #define SDSORT_CACHE_VFATS 2 // Maximum number of 13-byte VFAT entries to use for sorting.
1525 // Note: Only affects SCROLL_LONG_FILENAMES with SDSORT_CACHE_NAMES but not SDSORT_DYNAMIC_RAM.
1526 #endif
1528 // Allow international symbols in long filenames. To display correctly, the
1529 // LCD's font must contain the characters. Check your selected LCD language.
1530 //#define UTF_FILENAME_SUPPORT
1532 //#define LONG_FILENAME_HOST_SUPPORT // Get the long filename of a file/folder with 'M33 <dosname>' and list long filenames with 'M20 L'
1533 //#define LONG_FILENAME_WRITE_SUPPORT // Create / delete files with long filenames via M28, M30, and Binary Transfer Protocol
1535 //#define SCROLL_LONG_FILENAMES // Scroll long filenames in the SD card menu
1537 //#define SD_ABORT_NO_COOLDOWN // Leave the heaters on after Stop Print (not recommended!)
1540 * Abort SD printing when any endstop is triggered.
1541 * This feature is enabled with 'M540 S1' or from the LCD menu.
1542 * Endstops must be activated for this option to work.
1544 //#define SD_ABORT_ON_ENDSTOP_HIT
1546 //#define SD_REPRINT_LAST_SELECTED_FILE // On print completion open the LCD Menu and select the same file
1548 //#define AUTO_REPORT_SD_STATUS // Auto-report media status with 'M27 S<seconds>'
1551 * Support for USB thumb drives using an Arduino USB Host Shield or
1552 * equivalent MAX3421E breakout board. The USB thumb drive will appear
1553 * to Marlin as an SD card.
1555 * The MAX3421E can be assigned the same pins as the SD card reader, with
1556 * the following pin mapping:
1558 * SCLK, MOSI, MISO --> SCLK, MOSI, MISO
1559 * INT --> SD_DETECT_PIN [1]
1560 * SS --> SDSS
1562 * [1] On AVR an interrupt-capable pin is best for UHS3 compatibility.
1564 //#define USB_FLASH_DRIVE_SUPPORT
1565 #if ENABLED(USB_FLASH_DRIVE_SUPPORT)
1567 * USB Host Shield Library
1569 * - UHS2 uses no interrupts and has been production-tested
1570 * on a LulzBot TAZ Pro with a 32-bit Archim board.
1572 * - UHS3 is newer code with better USB compatibility. But it
1573 * is less tested and is known to interfere with Servos.
1574 * [1] This requires USB_INTR_PIN to be interrupt-capable.
1576 //#define USE_UHS2_USB
1577 //#define USE_UHS3_USB
1580 * Native USB Host supported by some boards (USB OTG)
1582 //#define USE_OTG_USB_HOST
1584 #if DISABLED(USE_OTG_USB_HOST)
1585 #define USB_CS_PIN SDSS
1586 #define USB_INTR_PIN SD_DETECT_PIN
1587 #endif
1588 #endif
1591 * When using a bootloader that supports SD-Firmware-Flashing,
1592 * add a menu item to activate SD-FW-Update on the next reboot.
1594 * Requires ATMEGA2560 (Arduino Mega)
1596 * Tested with this bootloader:
1597 * https://github.com/FleetProbe/MicroBridge-Arduino-ATMega2560
1599 //#define SD_FIRMWARE_UPDATE
1600 #if ENABLED(SD_FIRMWARE_UPDATE)
1601 #define SD_FIRMWARE_UPDATE_EEPROM_ADDR 0x1FF
1602 #define SD_FIRMWARE_UPDATE_ACTIVE_VALUE 0xF0
1603 #define SD_FIRMWARE_UPDATE_INACTIVE_VALUE 0xFF
1604 #endif
1607 * Enable this option if you have more than ~3K of unused flash space.
1608 * Marlin will embed all settings in the firmware binary as compressed data.
1609 * Use 'M503 C' to write the settings out to the SD Card as 'mc.zip'.
1610 * See docs/ConfigEmbedding.md for details on how to use 'mc-apply.py'.
1612 //#define CONFIGURATION_EMBEDDING
1614 // Add an optimized binary file transfer mode, initiated with 'M28 B1'
1615 //#define BINARY_FILE_TRANSFER
1617 #if ENABLED(BINARY_FILE_TRANSFER)
1618 // Include extra facilities (e.g., 'M20 F') supporting firmware upload via BINARY_FILE_TRANSFER
1619 //#define CUSTOM_FIRMWARE_UPLOAD
1620 #endif
1623 * Set this option to one of the following (or the board's defaults apply):
1625 * LCD - Use the SD drive in the external LCD controller.
1626 * ONBOARD - Use the SD drive on the control board.
1627 * CUSTOM_CABLE - Use a custom cable to access the SD (as defined in a pins file).
1629 * :[ 'LCD', 'ONBOARD', 'CUSTOM_CABLE' ]
1631 //#define SDCARD_CONNECTION LCD
1633 // Enable if SD detect is rendered useless (e.g., by using an SD extender)
1634 //#define NO_SD_DETECT
1637 * Multiple volume support - EXPERIMENTAL.
1638 * Adds 'M21 Pm' / 'M21 S' / 'M21 U' to mount SD Card / USB Drive.
1640 //#define MULTI_VOLUME
1641 #if ENABLED(MULTI_VOLUME)
1642 #define VOLUME_SD_ONBOARD
1643 #define VOLUME_USB_FLASH_DRIVE
1644 #define DEFAULT_VOLUME SV_SD_ONBOARD
1645 #define DEFAULT_SHARED_VOLUME SV_USB_FLASH_DRIVE
1646 #endif
1648 #endif // SDSUPPORT
1651 * By default an onboard SD card reader may be shared as a USB mass-
1652 * storage device. This option hides the SD card from the host PC.
1654 //#define NO_SD_HOST_DRIVE // Disable SD Card access over USB (for security).
1657 * Additional options for Graphical Displays
1659 * Use the optimizations here to improve printing performance,
1660 * which can be adversely affected by graphical display drawing,
1661 * especially when doing several short moves, and when printing
1662 * on DELTA and SCARA machines.
1664 * Some of these options may result in the display lagging behind
1665 * controller events, as there is a trade-off between reliable
1666 * printing performance versus fast display updates.
1668 #if HAS_MARLINUI_U8GLIB
1669 // Save many cycles by drawing a hollow frame or no frame on the Info Screen
1670 //#define XYZ_NO_FRAME
1671 #define XYZ_HOLLOW_FRAME
1673 // A bigger font is available for edit items. Costs 3120 bytes of flash.
1674 // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1675 //#define USE_BIG_EDIT_FONT
1677 // A smaller font may be used on the Info Screen. Costs 2434 bytes of flash.
1678 // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
1679 //#define USE_SMALL_INFOFONT
1682 * Graphical Display Sleep
1684 * The U8G library provides sleep / wake functions for SH1106, SSD1306,
1685 * SSD1309, and some other DOGM displays.
1686 * Enable this option to save energy and prevent OLED pixel burn-in.
1687 * Adds the menu item Configuration > LCD Timeout (m) to set a wait period
1688 * from 0 (disabled) to 99 minutes.
1690 //#define DISPLAY_SLEEP_MINUTES 2 // (minutes) Timeout before turning off the screen
1693 * ST7920-based LCDs can emulate a 16 x 4 character display using
1694 * the ST7920 character-generator for very fast screen updates.
1695 * Enable LIGHTWEIGHT_UI to use this special display mode.
1697 * Since LIGHTWEIGHT_UI has limited space, the position and status
1698 * message occupy the same line. Set STATUS_EXPIRE_SECONDS to the
1699 * length of time to display the status message before clearing.
1701 * Set STATUS_EXPIRE_SECONDS to zero to never clear the status.
1702 * This will prevent position updates from being displayed.
1704 #if IS_U8GLIB_ST7920
1705 // Enable this option and reduce the value to optimize screen updates.
1706 // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
1707 //#define DOGM_SPI_DELAY_US 5
1709 //#define LIGHTWEIGHT_UI
1710 #if ENABLED(LIGHTWEIGHT_UI)
1711 #define STATUS_EXPIRE_SECONDS 20
1712 #endif
1713 #endif
1716 * Status (Info) Screen customizations
1717 * These options may affect code size and screen render time.
1718 * Custom status screens can forcibly override these settings.
1720 //#define STATUS_COMBINE_HEATERS // Use combined heater images instead of separate ones
1721 //#define STATUS_HOTEND_NUMBERLESS // Use plain hotend icons instead of numbered ones (with 2+ hotends)
1722 #define STATUS_HOTEND_INVERTED // Show solid nozzle bitmaps when heating (Requires STATUS_HOTEND_ANIM for numbered hotends)
1723 #define STATUS_HOTEND_ANIM // Use a second bitmap to indicate hotend heating
1724 #define STATUS_BED_ANIM // Use a second bitmap to indicate bed heating
1725 #define STATUS_CHAMBER_ANIM // Use a second bitmap to indicate chamber heating
1726 //#define STATUS_CUTTER_ANIM // Use a second bitmap to indicate spindle / laser active
1727 //#define STATUS_COOLER_ANIM // Use a second bitmap to indicate laser cooling
1728 //#define STATUS_FLOWMETER_ANIM // Use multiple bitmaps to indicate coolant flow
1729 //#define STATUS_ALT_BED_BITMAP // Use the alternative bed bitmap
1730 //#define STATUS_ALT_FAN_BITMAP // Use the alternative fan bitmap
1731 //#define STATUS_FAN_FRAMES 3 // :[0,1,2,3,4] Number of fan animation frames
1732 //#define STATUS_HEAT_PERCENT // Show heating in a progress bar
1733 //#define BOOT_MARLIN_LOGO_ANIMATED // Animated Marlin logo. Costs ~3260 (or ~940) bytes of flash.
1735 // Frivolous Game Options
1736 //#define MARLIN_BRICKOUT
1737 //#define MARLIN_INVADERS
1738 //#define MARLIN_SNAKE
1739 //#define GAMES_EASTER_EGG // Add extra blank lines above the "Games" sub-menu
1741 #endif // HAS_MARLINUI_U8GLIB
1743 #if HAS_MARLINUI_U8GLIB || IS_DWIN_MARLINUI
1744 // Show SD percentage next to the progress bar
1745 //#define SHOW_SD_PERCENT
1747 // Enable to save many cycles by drawing a hollow frame on Menu Screens
1748 #define MENU_HOLLOW_FRAME
1750 // Swap the CW/CCW indicators in the graphics overlay
1751 //#define OVERLAY_GFX_REVERSE
1752 #endif
1755 // Additional options for DGUS / DWIN displays
1757 #if HAS_DGUS_LCD
1758 #define LCD_BAUDRATE 115200
1760 #define DGUS_RX_BUFFER_SIZE 128
1761 #define DGUS_TX_BUFFER_SIZE 48
1762 //#define SERIAL_STATS_RX_BUFFER_OVERRUNS // Fix Rx overrun situation (Currently only for AVR)
1764 #define DGUS_UPDATE_INTERVAL_MS 500 // (ms) Interval between automatic screen updates
1766 #if ANY(DGUS_LCD_UI_FYSETC, DGUS_LCD_UI_MKS, DGUS_LCD_UI_HIPRECY)
1767 #define DGUS_PRINT_FILENAME // Display the filename during printing
1768 #define DGUS_PREHEAT_UI // Display a preheat screen during heatup
1770 #if EITHER(DGUS_LCD_UI_FYSETC, DGUS_LCD_UI_MKS)
1771 //#define DGUS_UI_MOVE_DIS_OPTION // Disabled by default for FYSETC and MKS
1772 #else
1773 #define DGUS_UI_MOVE_DIS_OPTION // Enabled by default for UI_HIPRECY
1774 #endif
1776 #define DGUS_FILAMENT_LOADUNLOAD
1777 #if ENABLED(DGUS_FILAMENT_LOADUNLOAD)
1778 #define DGUS_FILAMENT_PURGE_LENGTH 10
1779 #define DGUS_FILAMENT_LOAD_LENGTH_PER_TIME 0.5 // (mm) Adjust in proportion to DGUS_UPDATE_INTERVAL_MS
1780 #endif
1782 #define DGUS_UI_WAITING // Show a "waiting" screen between some screens
1783 #if ENABLED(DGUS_UI_WAITING)
1784 #define DGUS_UI_WAITING_STATUS 10
1785 #define DGUS_UI_WAITING_STATUS_PERIOD 8 // Increase to slower waiting status looping
1786 #endif
1787 #endif
1788 #endif // HAS_DGUS_LCD
1791 // Additional options for AnyCubic Chiron TFT displays
1793 #if ENABLED(ANYCUBIC_LCD_CHIRON)
1794 // By default the type of panel is automatically detected.
1795 // Enable one of these options if you know the panel type.
1796 //#define CHIRON_TFT_STANDARD
1797 //#define CHIRON_TFT_NEW
1799 // Enable the longer Anycubic powerup startup tune
1800 //#define AC_DEFAULT_STARTUP_TUNE
1803 * Display Folders
1804 * By default the file browser lists all G-code files (including those in subfolders) in a flat list.
1805 * Enable this option to display a hierarchical file browser.
1807 * NOTES:
1808 * - Without this option it helps to enable SDCARD_SORT_ALPHA so files are sorted before/after folders.
1809 * - When used with the "new" panel, folder names will also have '.gcode' appended to their names.
1810 * This hack is currently required to force the panel to show folders.
1812 #define AC_SD_FOLDER_VIEW
1813 #endif
1816 // Specify additional languages for the UI. Default specified by LCD_LANGUAGE.
1818 #if ANY(DOGLCD, TFT_COLOR_UI, TOUCH_UI_FTDI_EVE, IS_DWIN_MARLINUI)
1819 //#define LCD_LANGUAGE_2 fr
1820 //#define LCD_LANGUAGE_3 de
1821 //#define LCD_LANGUAGE_4 es
1822 //#define LCD_LANGUAGE_5 it
1823 #ifdef LCD_LANGUAGE_2
1824 //#define LCD_LANGUAGE_AUTO_SAVE // Automatically save language to EEPROM on change
1825 #endif
1826 #endif
1829 // Touch UI for the FTDI Embedded Video Engine (EVE)
1831 #if ENABLED(TOUCH_UI_FTDI_EVE)
1832 // Display board used
1833 //#define LCD_FTDI_VM800B35A // FTDI 3.5" with FT800 (320x240)
1834 //#define LCD_4DSYSTEMS_4DLCD_FT843 // 4D Systems 4.3" (480x272)
1835 //#define LCD_HAOYU_FT800CB // Haoyu with 4.3" or 5" (480x272)
1836 //#define LCD_HAOYU_FT810CB // Haoyu with 5" (800x480)
1837 //#define LCD_LULZBOT_CLCD_UI // LulzBot Color LCD UI
1838 //#define LCD_FYSETC_TFT81050 // FYSETC with 5" (800x480)
1839 //#define LCD_EVE3_50G // Matrix Orbital 5.0", 800x480, BT815
1840 //#define LCD_EVE2_50G // Matrix Orbital 5.0", 800x480, FT813
1842 // Correct the resolution if not using the stock TFT panel.
1843 //#define TOUCH_UI_320x240
1844 //#define TOUCH_UI_480x272
1845 //#define TOUCH_UI_800x480
1847 // Mappings for boards with a standard RepRapDiscount Display connector
1848 //#define AO_EXP1_PINMAP // LulzBot CLCD UI EXP1 mapping
1849 //#define AO_EXP2_PINMAP // LulzBot CLCD UI EXP2 mapping
1850 //#define CR10_TFT_PINMAP // Rudolph Riedel's CR10 pin mapping
1851 //#define S6_TFT_PINMAP // FYSETC S6 pin mapping
1852 //#define F6_TFT_PINMAP // FYSETC F6 pin mapping
1854 //#define OTHER_PIN_LAYOUT // Define pins manually below
1855 #if ENABLED(OTHER_PIN_LAYOUT)
1856 // Pins for CS and MOD_RESET (PD) must be chosen
1857 #define CLCD_MOD_RESET 9
1858 #define CLCD_SPI_CS 10
1860 // If using software SPI, specify pins for SCLK, MOSI, MISO
1861 //#define CLCD_USE_SOFT_SPI
1862 #if ENABLED(CLCD_USE_SOFT_SPI)
1863 #define CLCD_SOFT_SPI_MOSI 11
1864 #define CLCD_SOFT_SPI_MISO 12
1865 #define CLCD_SOFT_SPI_SCLK 13
1866 #endif
1867 #endif
1869 // Display Orientation. An inverted (i.e. upside-down) display
1870 // is supported on the FT800. The FT810 and beyond also support
1871 // portrait and mirrored orientations.
1872 //#define TOUCH_UI_INVERTED
1873 //#define TOUCH_UI_PORTRAIT
1874 //#define TOUCH_UI_MIRRORED
1876 // UTF8 processing and rendering.
1877 // Unsupported characters are shown as '?'.
1878 //#define TOUCH_UI_USE_UTF8
1879 #if ENABLED(TOUCH_UI_USE_UTF8)
1880 // Western accents support. These accented characters use
1881 // combined bitmaps and require relatively little storage.
1882 #define TOUCH_UI_UTF8_WESTERN_CHARSET
1883 #if ENABLED(TOUCH_UI_UTF8_WESTERN_CHARSET)
1884 // Additional character groups. These characters require
1885 // full bitmaps and take up considerable storage:
1886 //#define TOUCH_UI_UTF8_SUPERSCRIPTS // ¹ ² ³
1887 //#define TOUCH_UI_UTF8_COPYRIGHT // © ®
1888 //#define TOUCH_UI_UTF8_GERMANIC // ß
1889 //#define TOUCH_UI_UTF8_SCANDINAVIAN // Æ Ð Ø Þ æ ð ø þ
1890 //#define TOUCH_UI_UTF8_PUNCTUATION // « » ¿ ¡
1891 //#define TOUCH_UI_UTF8_CURRENCY // ¢ £ ¤ ¥
1892 //#define TOUCH_UI_UTF8_ORDINALS // º ª
1893 //#define TOUCH_UI_UTF8_MATHEMATICS // ± × ÷
1894 //#define TOUCH_UI_UTF8_FRACTIONS // ¼ ½ ¾
1895 //#define TOUCH_UI_UTF8_SYMBOLS // µ ¶ ¦ § ¬
1896 #endif
1898 // Cyrillic character set, costs about 27KiB of flash
1899 //#define TOUCH_UI_UTF8_CYRILLIC_CHARSET
1900 #endif
1902 // Use a smaller font when labels don't fit buttons
1903 #define TOUCH_UI_FIT_TEXT
1905 // Use a numeric passcode for "Screen lock" keypad.
1906 // (recommended for smaller displays)
1907 //#define TOUCH_UI_PASSCODE
1909 // Output extra debug info for Touch UI events
1910 //#define TOUCH_UI_DEBUG
1912 // Developer menu (accessed by touching "About Printer" copyright text)
1913 //#define TOUCH_UI_DEVELOPER_MENU
1914 #endif
1917 // Classic UI Options
1919 #if TFT_SCALED_DOGLCD
1920 //#define TFT_MARLINUI_COLOR 0xFFFF // White
1921 //#define TFT_MARLINBG_COLOR 0x0000 // Black
1922 //#define TFT_DISABLED_COLOR 0x0003 // Almost black
1923 //#define TFT_BTCANCEL_COLOR 0xF800 // Red
1924 //#define TFT_BTARROWS_COLOR 0xDEE6 // 11011 110111 00110 Yellow
1925 //#define TFT_BTOKMENU_COLOR 0x145F // 00010 100010 11111 Cyan
1926 #endif
1929 // ADC Button Debounce
1931 #if HAS_ADC_BUTTONS
1932 #define ADC_BUTTON_DEBOUNCE_DELAY 16 // Increase if buttons bounce or repeat too fast
1933 #endif
1935 // @section safety
1938 * The watchdog hardware timer will do a reset and disable all outputs
1939 * if the firmware gets too overloaded to read the temperature sensors.
1941 * If you find that watchdog reboot causes your AVR board to hang forever,
1942 * enable WATCHDOG_RESET_MANUAL to use a custom timer instead of WDTO.
1943 * NOTE: This method is less reliable as it can only catch hangups while
1944 * interrupts are enabled.
1946 #define USE_WATCHDOG
1947 #if ENABLED(USE_WATCHDOG)
1948 //#define WATCHDOG_RESET_MANUAL
1949 #endif
1951 // @section lcd
1954 * Babystepping enables movement of the axes by tiny increments without changing
1955 * the current position values. This feature is used primarily to adjust the Z
1956 * axis in the first layer of a print in real-time.
1958 * Warning: Does not respect endstops!
1960 //#define BABYSTEPPING
1961 #if ENABLED(BABYSTEPPING)
1962 //#define INTEGRATED_BABYSTEPPING // EXPERIMENTAL integration of babystepping into the Stepper ISR
1963 //#define BABYSTEP_WITHOUT_HOMING
1964 //#define BABYSTEP_ALWAYS_AVAILABLE // Allow babystepping at all times (not just during movement).
1965 //#define BABYSTEP_XY // Also enable X/Y Babystepping. Not supported on DELTA!
1966 #define BABYSTEP_INVERT_Z false // Change if Z babysteps should go the other way
1967 //#define BABYSTEP_MILLIMETER_UNITS // Specify BABYSTEP_MULTIPLICATOR_(XY|Z) in mm instead of micro-steps
1968 #define BABYSTEP_MULTIPLICATOR_Z 1 // (steps or mm) Steps or millimeter distance for each Z babystep
1969 #define BABYSTEP_MULTIPLICATOR_XY 1 // (steps or mm) Steps or millimeter distance for each XY babystep
1971 //#define DOUBLECLICK_FOR_Z_BABYSTEPPING // Double-click on the Status Screen for Z Babystepping.
1972 #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING)
1973 #define DOUBLECLICK_MAX_INTERVAL 1250 // Maximum interval between clicks, in milliseconds.
1974 // Note: Extra time may be added to mitigate controller latency.
1975 //#define MOVE_Z_WHEN_IDLE // Jump to the move Z menu on doubleclick when printer is idle.
1976 #if ENABLED(MOVE_Z_WHEN_IDLE)
1977 #define MOVE_Z_IDLE_MULTIPLICATOR 1 // Multiply 1mm by this factor for the move step size.
1978 #endif
1979 #endif
1981 //#define BABYSTEP_DISPLAY_TOTAL // Display total babysteps since last G28
1983 //#define BABYSTEP_ZPROBE_OFFSET // Combine M851 Z and Babystepping
1984 #if ENABLED(BABYSTEP_ZPROBE_OFFSET)
1985 //#define BABYSTEP_HOTEND_Z_OFFSET // For multiple hotends, babystep relative Z offsets
1986 //#define BABYSTEP_ZPROBE_GFX_OVERLAY // Enable graphical overlay on Z-offset editor
1987 #endif
1988 #endif
1990 // @section extruder
1993 * Linear Pressure Control v1.5
1995 * Assumption: advance [steps] = k * (delta velocity [steps/s])
1996 * K=0 means advance disabled.
1998 * NOTE: K values for LIN_ADVANCE 1.5 differ from earlier versions!
2000 * Set K around 0.22 for 3mm PLA Direct Drive with ~6.5cm between the drive gear and heatbreak.
2001 * Larger K values will be needed for flexible filament and greater distances.
2002 * If this algorithm produces a higher speed offset than the extruder can handle (compared to E jerk)
2003 * print acceleration will be reduced during the affected moves to keep within the limit.
2005 * See https://marlinfw.org/docs/features/lin_advance.html for full instructions.
2007 //#define LIN_ADVANCE
2008 #if ENABLED(LIN_ADVANCE)
2009 //#define EXTRA_LIN_ADVANCE_K // Enable for second linear advance constants
2010 #define LIN_ADVANCE_K 0.22 // Unit: mm compression per 1mm/s extruder speed
2011 //#define LA_DEBUG // If enabled, this will generate debug information output over USB.
2012 //#define EXPERIMENTAL_SCURVE // Enable this option to permit S-Curve Acceleration
2013 //#define ALLOW_LOW_EJERK // Allow a DEFAULT_EJERK value of <10. Recommended for direct drive hotends.
2014 #endif
2016 // @section leveling
2019 * Points to probe for all 3-point Leveling procedures.
2020 * Override if the automatically selected points are inadequate.
2022 #if EITHER(AUTO_BED_LEVELING_3POINT, AUTO_BED_LEVELING_UBL)
2023 //#define PROBE_PT_1_X 15
2024 //#define PROBE_PT_1_Y 180
2025 //#define PROBE_PT_2_X 15
2026 //#define PROBE_PT_2_Y 20
2027 //#define PROBE_PT_3_X 170
2028 //#define PROBE_PT_3_Y 20
2029 #endif
2032 * Probing Margins
2034 * Override PROBING_MARGIN for each side of the build plate
2035 * Useful to get probe points to exact positions on targets or
2036 * to allow leveling to avoid plate clamps on only specific
2037 * sides of the bed. With NOZZLE_AS_PROBE negative values are
2038 * allowed, to permit probing outside the bed.
2040 * If you are replacing the prior *_PROBE_BED_POSITION options,
2041 * LEFT and FRONT values in most cases will map directly over
2042 * RIGHT and REAR would be the inverse such as
2043 * (X/Y_BED_SIZE - RIGHT/BACK_PROBE_BED_POSITION)
2045 * This will allow all positions to match at compilation, however
2046 * should the probe position be modified with M851XY then the
2047 * probe points will follow. This prevents any change from causing
2048 * the probe to be unable to reach any points.
2050 #if PROBE_SELECTED && !IS_KINEMATIC
2051 //#define PROBING_MARGIN_LEFT PROBING_MARGIN
2052 //#define PROBING_MARGIN_RIGHT PROBING_MARGIN
2053 //#define PROBING_MARGIN_FRONT PROBING_MARGIN
2054 //#define PROBING_MARGIN_BACK PROBING_MARGIN
2055 #endif
2057 #if EITHER(MESH_BED_LEVELING, AUTO_BED_LEVELING_UBL)
2058 // Override the mesh area if the automatic (max) area is too large
2059 //#define MESH_MIN_X MESH_INSET
2060 //#define MESH_MIN_Y MESH_INSET
2061 //#define MESH_MAX_X X_BED_SIZE - (MESH_INSET)
2062 //#define MESH_MAX_Y Y_BED_SIZE - (MESH_INSET)
2063 #endif
2065 #if BOTH(AUTO_BED_LEVELING_UBL, EEPROM_SETTINGS)
2066 //#define OPTIMIZED_MESH_STORAGE // Store mesh with less precision to save EEPROM space
2067 #endif
2070 * Repeatedly attempt G29 leveling until it succeeds.
2071 * Stop after G29_MAX_RETRIES attempts.
2073 //#define G29_RETRY_AND_RECOVER
2074 #if ENABLED(G29_RETRY_AND_RECOVER)
2075 #define G29_MAX_RETRIES 3
2076 #define G29_HALT_ON_FAILURE
2078 * Specify the GCODE commands that will be executed when leveling succeeds,
2079 * between attempts, and after the maximum number of retries have been tried.
2081 #define G29_SUCCESS_COMMANDS "M117 Bed leveling done."
2082 #define G29_RECOVER_COMMANDS "M117 Probe failed. Rewiping.\nG28\nG12 P0 S12 T0"
2083 #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"
2085 #endif
2088 * Thermal Probe Compensation
2090 * Adjust probe measurements to compensate for distortion associated with the temperature
2091 * of the probe, bed, and/or hotend.
2092 * Use G76 to automatically calibrate this feature for probe and bed temperatures.
2093 * (Extruder temperature/offset values must be calibrated manually.)
2094 * Use M871 to set temperature/offset values manually.
2095 * For more details see https://marlinfw.org/docs/features/probe_temp_compensation.html
2097 //#define PTC_PROBE // Compensate based on probe temperature
2098 //#define PTC_BED // Compensate based on bed temperature
2099 //#define PTC_HOTEND // Compensate based on hotend temperature
2101 #if ANY(PTC_PROBE, PTC_BED, PTC_HOTEND)
2103 * If the probe is outside the defined range, use linear extrapolation with the closest
2104 * point and the point with index PTC_LINEAR_EXTRAPOLATION. e.g., If set to 4 it will use the
2105 * linear extrapolation between data[0] and data[4] for values below PTC_PROBE_START.
2107 //#define PTC_LINEAR_EXTRAPOLATION 4
2109 #if ENABLED(PTC_PROBE)
2110 // Probe temperature calibration generates a table of values starting at PTC_PROBE_START
2111 // (e.g., 30), in steps of PTC_PROBE_RES (e.g., 5) with PTC_PROBE_COUNT (e.g., 10) samples.
2112 #define PTC_PROBE_START 30 // (°C)
2113 #define PTC_PROBE_RES 5 // (°C)
2114 #define PTC_PROBE_COUNT 10
2115 #define PTC_PROBE_ZOFFS { 0 } // (µm) Z adjustments per sample
2116 #endif
2118 #if ENABLED(PTC_BED)
2119 // Bed temperature calibration builds a similar table.
2120 #define PTC_BED_START 60 // (°C)
2121 #define PTC_BED_RES 5 // (°C)
2122 #define PTC_BED_COUNT 10
2123 #define PTC_BED_ZOFFS { 0 } // (µm) Z adjustments per sample
2124 #endif
2126 #if ENABLED(PTC_HOTEND)
2127 // Note: There is no automatic calibration for the hotend. Use M871.
2128 #define PTC_HOTEND_START 180 // (°C)
2129 #define PTC_HOTEND_RES 5 // (°C)
2130 #define PTC_HOTEND_COUNT 20
2131 #define PTC_HOTEND_ZOFFS { 0 } // (µm) Z adjustments per sample
2132 #endif
2134 // G76 options
2135 #if BOTH(PTC_PROBE, PTC_BED)
2136 // Park position to wait for probe cooldown
2137 #define PTC_PARK_POS { 0, 0, 100 }
2139 // Probe position to probe and wait for probe to reach target temperature
2140 //#define PTC_PROBE_POS { 12.0f, 7.3f } // Example: MK52 magnetic heatbed
2141 #define PTC_PROBE_POS { 90, 100 }
2143 // The temperature the probe should be at while taking measurements during
2144 // bed temperature calibration.
2145 #define PTC_PROBE_TEMP 30 // (°C)
2147 // Height above Z=0.0 to raise the nozzle. Lowering this can help the probe to heat faster.
2148 // Note: The Z=0.0 offset is determined by the probe Z offset (e.g., as set with M851 Z).
2149 #define PTC_PROBE_HEATING_OFFSET 0.5
2150 #endif
2151 #endif // PTC_PROBE || PTC_BED || PTC_HOTEND
2153 // @section extras
2156 // G60/G61 Position Save and Return
2158 //#define SAVED_POSITIONS 1 // Each saved position slot costs 12 bytes
2161 // G2/G3 Arc Support
2163 #define ARC_SUPPORT // Requires ~3226 bytes
2164 #if ENABLED(ARC_SUPPORT)
2165 #define MIN_ARC_SEGMENT_MM 0.1 // (mm) Minimum length of each arc segment
2166 #define MAX_ARC_SEGMENT_MM 1.0 // (mm) Maximum length of each arc segment
2167 #define MIN_CIRCLE_SEGMENTS 72 // Minimum number of segments in a complete circle
2168 //#define ARC_SEGMENTS_PER_SEC 50 // Use the feedrate to choose the segment length
2169 #define N_ARC_CORRECTION 25 // Number of interpolated segments between corrections
2170 //#define ARC_P_CIRCLES // Enable the 'P' parameter to specify complete circles
2171 //#define SF_ARC_FIX // Enable only if using SkeinForge with "Arc Point" fillet procedure
2172 #endif
2174 // G5 Bézier Curve Support with XYZE destination and IJPQ offsets
2175 //#define BEZIER_CURVE_SUPPORT // Requires ~2666 bytes
2177 #if EITHER(ARC_SUPPORT, BEZIER_CURVE_SUPPORT)
2178 //#define CNC_WORKSPACE_PLANES // Allow G2/G3/G5 to operate in XY, ZX, or YZ planes
2179 #endif
2182 * Direct Stepping
2184 * Comparable to the method used by Klipper, G6 direct stepping significantly
2185 * reduces motion calculations, increases top printing speeds, and results in
2186 * less step aliasing by calculating all motions in advance.
2187 * Preparing your G-code: https://github.com/colinrgodsey/step-daemon
2189 //#define DIRECT_STEPPING
2192 * G38 Probe Target
2194 * This option adds G38.2 and G38.3 (probe towards target)
2195 * and optionally G38.4 and G38.5 (probe away from target).
2196 * Set MULTIPLE_PROBING for G38 to probe more than once.
2198 //#define G38_PROBE_TARGET
2199 #if ENABLED(G38_PROBE_TARGET)
2200 //#define G38_PROBE_AWAY // Include G38.4 and G38.5 to probe away from target
2201 #define G38_MINIMUM_MOVE 0.0275 // (mm) Minimum distance that will produce a move.
2202 #endif
2204 // Moves (or segments) with fewer steps than this will be joined with the next move
2205 #define MIN_STEPS_PER_SEGMENT 6
2208 * Minimum delay before and after setting the stepper DIR (in ns)
2209 * 0 : No delay (Expect at least 10µS since one Stepper ISR must transpire)
2210 * 20 : Minimum for TMC2xxx drivers
2211 * 200 : Minimum for A4988 drivers
2212 * 400 : Minimum for A5984 drivers
2213 * 500 : Minimum for LV8729 drivers (guess, no info in datasheet)
2214 * 650 : Minimum for DRV8825 drivers
2215 * 1500 : Minimum for TB6600 drivers (guess, no info in datasheet)
2216 * 15000 : Minimum for TB6560 drivers (guess, no info in datasheet)
2218 * Override the default value based on the driver type set in Configuration.h.
2220 //#define MINIMUM_STEPPER_POST_DIR_DELAY 650
2221 //#define MINIMUM_STEPPER_PRE_DIR_DELAY 650
2224 * Minimum stepper driver pulse width (in µs)
2225 * 0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
2226 * 0 : Minimum 500ns for LV8729, adjusted in stepper.h
2227 * 1 : Minimum for A4988 and A5984 stepper drivers
2228 * 2 : Minimum for DRV8825 stepper drivers
2229 * 3 : Minimum for TB6600 stepper drivers
2230 * 30 : Minimum for TB6560 stepper drivers
2232 * Override the default value based on the driver type set in Configuration.h.
2234 //#define MINIMUM_STEPPER_PULSE 2
2237 * Maximum stepping rate (in Hz) the stepper driver allows
2238 * If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
2239 * 5000000 : Maximum for TMC2xxx stepper drivers
2240 * 1000000 : Maximum for LV8729 stepper driver
2241 * 500000 : Maximum for A4988 stepper driver
2242 * 250000 : Maximum for DRV8825 stepper driver
2243 * 150000 : Maximum for TB6600 stepper driver
2244 * 15000 : Maximum for TB6560 stepper driver
2246 * Override the default value based on the driver type set in Configuration.h.
2248 //#define MAXIMUM_STEPPER_RATE 250000
2250 // @section temperature
2252 // Control heater 0 and heater 1 in parallel.
2253 //#define HEATERS_PARALLEL
2255 //===========================================================================
2256 //================================= Buffers =================================
2257 //===========================================================================
2259 // @section motion
2261 // The number of linear moves that can be in the planner at once.
2262 // The value of BLOCK_BUFFER_SIZE must be a power of 2 (e.g., 8, 16, 32)
2263 #if BOTH(SDSUPPORT, DIRECT_STEPPING)
2264 #define BLOCK_BUFFER_SIZE 8
2265 #elif ENABLED(SDSUPPORT)
2266 #define BLOCK_BUFFER_SIZE 16
2267 #else
2268 #define BLOCK_BUFFER_SIZE 16
2269 #endif
2271 // @section serial
2273 // The ASCII buffer for serial input
2274 #define MAX_CMD_SIZE 96
2275 #define BUFSIZE 4
2277 // Transmission to Host Buffer Size
2278 // To save 386 bytes of flash (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
2279 // To buffer a simple "ok" you need 4 bytes.
2280 // For ADVANCED_OK (M105) you need 32 bytes.
2281 // For debug-echo: 128 bytes for the optimal speed.
2282 // Other output doesn't need to be that speedy.
2283 // :[0, 2, 4, 8, 16, 32, 64, 128, 256]
2284 #define TX_BUFFER_SIZE 0
2286 // Host Receive Buffer Size
2287 // Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
2288 // To use flow control, set this buffer size to at least 1024 bytes.
2289 // :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
2290 //#define RX_BUFFER_SIZE 1024
2292 #if RX_BUFFER_SIZE >= 1024
2293 // Enable to have the controller send XON/XOFF control characters to
2294 // the host to signal the RX buffer is becoming full.
2295 //#define SERIAL_XON_XOFF
2296 #endif
2298 #if ENABLED(SDSUPPORT)
2299 // Enable this option to collect and display the maximum
2300 // RX queue usage after transferring a file to SD.
2301 //#define SERIAL_STATS_MAX_RX_QUEUED
2303 // Enable this option to collect and display the number
2304 // of dropped bytes after a file transfer to SD.
2305 //#define SERIAL_STATS_DROPPED_RX
2306 #endif
2308 // Monitor RX buffer usage
2309 // Dump an error to the serial port if the serial receive buffer overflows.
2310 // If you see these errors, increase the RX_BUFFER_SIZE value.
2311 // Not supported on all platforms.
2312 //#define RX_BUFFER_MONITOR
2315 * Emergency Command Parser
2317 * Add a low-level parser to intercept certain commands as they
2318 * enter the serial receive buffer, so they cannot be blocked.
2319 * Currently handles M108, M112, M410, M876
2320 * NOTE: Not yet implemented for all platforms.
2322 //#define EMERGENCY_PARSER
2325 * Realtime Reporting (requires EMERGENCY_PARSER)
2327 * - Report position and state of the machine (like Grbl).
2328 * - Auto-report position during long moves.
2329 * - Useful for CNC/LASER.
2331 * Adds support for commands:
2332 * S000 : Report State and Position while moving.
2333 * P000 : Instant Pause / Hold while moving.
2334 * R000 : Resume from Pause / Hold.
2336 * - During Hold all Emergency Parser commands are available, as usual.
2337 * - Enable NANODLP_Z_SYNC and NANODLP_ALL_AXIS for move command end-state reports.
2339 //#define REALTIME_REPORTING_COMMANDS
2340 #if ENABLED(REALTIME_REPORTING_COMMANDS)
2341 //#define FULL_REPORT_TO_HOST_FEATURE // Auto-report the machine status like Grbl CNC
2342 #endif
2344 // Bad Serial-connections can miss a received command by sending an 'ok'
2345 // Therefore some clients abort after 30 seconds in a timeout.
2346 // Some other clients start sending commands while receiving a 'wait'.
2347 // This "wait" is only sent when the buffer is empty. 1 second is a good value here.
2348 //#define NO_TIMEOUTS 1000 // Milliseconds
2350 // Some clients will have this feature soon. This could make the NO_TIMEOUTS unnecessary.
2351 //#define ADVANCED_OK
2353 // Printrun may have trouble receiving long strings all at once.
2354 // This option inserts short delays between lines of serial output.
2355 #define SERIAL_OVERRUN_PROTECTION
2357 // For serial echo, the number of digits after the decimal point
2358 //#define SERIAL_FLOAT_PRECISION 4
2361 * Set the number of proportional font spaces required to fill up a typical character space.
2362 * This can help to better align the output of commands like `G29 O` Mesh Output.
2364 * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
2365 * Otherwise, adjust according to your client and font.
2367 #define PROPORTIONAL_FONT_RATIO 1.0
2369 // @section extras
2372 * Extra Fan Speed
2373 * Adds a secondary fan speed for each print-cooling fan.
2374 * 'M106 P<fan> T3-255' : Set a secondary speed for <fan>
2375 * 'M106 P<fan> T2' : Use the set secondary speed
2376 * 'M106 P<fan> T1' : Restore the previous fan speed
2378 //#define EXTRA_FAN_SPEED
2381 * Firmware-based and LCD-controlled retract
2383 * Add G10 / G11 commands for automatic firmware-based retract / recover.
2384 * Use M207 and M208 to define parameters for retract / recover.
2386 * Use M209 to enable or disable auto-retract.
2387 * With auto-retract enabled, all G1 E moves within the set range
2388 * will be converted to firmware-based retract/recover moves.
2390 * Be sure to turn off auto-retract during filament change.
2392 * Note that M207 / M208 / M209 settings are saved to EEPROM.
2394 //#define FWRETRACT
2395 #if ENABLED(FWRETRACT)
2396 #define FWRETRACT_AUTORETRACT // Override slicer retractions
2397 #if ENABLED(FWRETRACT_AUTORETRACT)
2398 #define MIN_AUTORETRACT 0.1 // (mm) Don't convert E moves under this length
2399 #define MAX_AUTORETRACT 10.0 // (mm) Don't convert E moves over this length
2400 #endif
2401 #define RETRACT_LENGTH 3 // (mm) Default retract length (positive value)
2402 #define RETRACT_LENGTH_SWAP 13 // (mm) Default swap retract length (positive value)
2403 #define RETRACT_FEEDRATE 45 // (mm/s) Default feedrate for retracting
2404 #define RETRACT_ZRAISE 0 // (mm) Default retract Z-raise
2405 #define RETRACT_RECOVER_LENGTH 0 // (mm) Default additional recover length (added to retract length on recover)
2406 #define RETRACT_RECOVER_LENGTH_SWAP 0 // (mm) Default additional swap recover length (added to retract length on recover from toolchange)
2407 #define RETRACT_RECOVER_FEEDRATE 8 // (mm/s) Default feedrate for recovering from retraction
2408 #define RETRACT_RECOVER_FEEDRATE_SWAP 8 // (mm/s) Default feedrate for recovering from swap retraction
2409 #if ENABLED(MIXING_EXTRUDER)
2410 //#define RETRACT_SYNC_MIXING // Retract and restore all mixing steppers simultaneously
2411 #endif
2412 #endif
2415 * Universal tool change settings.
2416 * Applies to all types of extruders except where explicitly noted.
2418 #if HAS_MULTI_EXTRUDER
2419 // Z raise distance for tool-change, as needed for some extruders
2420 #define TOOLCHANGE_ZRAISE 2 // (mm)
2421 //#define TOOLCHANGE_ZRAISE_BEFORE_RETRACT // Apply raise before swap retraction (if enabled)
2422 //#define TOOLCHANGE_NO_RETURN // Never return to previous position on tool-change
2423 #if ENABLED(TOOLCHANGE_NO_RETURN)
2424 //#define EVENT_GCODE_AFTER_TOOLCHANGE "G12X" // Extra G-code to run after tool-change
2425 #endif
2428 * Extra G-code to run while executing tool-change commands. Can be used to use an additional
2429 * stepper motor (e.g., I axis in Configuration.h) to drive the tool-changer.
2431 //#define EVENT_GCODE_TOOLCHANGE_T0 "G28 A\nG1 A0" // Extra G-code to run while executing tool-change command T0
2432 //#define EVENT_GCODE_TOOLCHANGE_T1 "G1 A10" // Extra G-code to run while executing tool-change command T1
2433 //#define EVENT_GCODE_TOOLCHANGE_ALWAYS_RUN // Always execute above G-code sequences. Use with caution!
2436 * Tool Sensors detect when tools have been picked up or dropped.
2437 * Requires the pins TOOL_SENSOR1_PIN, TOOL_SENSOR2_PIN, etc.
2439 //#define TOOL_SENSOR
2442 * Retract and prime filament on tool-change to reduce
2443 * ooze and stringing and to get cleaner transitions.
2445 //#define TOOLCHANGE_FILAMENT_SWAP
2446 #if ENABLED(TOOLCHANGE_FILAMENT_SWAP)
2447 // Load / Unload
2448 #define TOOLCHANGE_FS_LENGTH 12 // (mm) Load / Unload length
2449 #define TOOLCHANGE_FS_EXTRA_RESUME_LENGTH 0 // (mm) Extra length for better restart. Adjust with LCD or M217 B.
2450 #define TOOLCHANGE_FS_RETRACT_SPEED (50*60) // (mm/min) (Unloading)
2451 #define TOOLCHANGE_FS_UNRETRACT_SPEED (25*60) // (mm/min) (On SINGLENOZZLE or Bowden loading must be slowed down)
2453 // Longer prime to clean out a SINGLENOZZLE
2454 #define TOOLCHANGE_FS_EXTRA_PRIME 0 // (mm) Extra priming length
2455 #define TOOLCHANGE_FS_PRIME_SPEED (4.6*60) // (mm/min) Extra priming feedrate
2456 #define TOOLCHANGE_FS_WIPE_RETRACT 0 // (mm) Retract before cooling for less stringing, better wipe, etc.
2458 // Cool after prime to reduce stringing
2459 #define TOOLCHANGE_FS_FAN -1 // Fan index or -1 to skip
2460 #define TOOLCHANGE_FS_FAN_SPEED 255 // 0-255
2461 #define TOOLCHANGE_FS_FAN_TIME 10 // (seconds)
2463 // Use TOOLCHANGE_FS_PRIME_SPEED feedrate the first time each extruder is primed
2464 //#define TOOLCHANGE_FS_SLOW_FIRST_PRIME
2467 * Prime T0 the first time T0 is sent to the printer:
2468 * [ Power-On -> T0 { Activate & Prime T0 } -> T1 { Retract T0, Activate & Prime T1 } ]
2469 * If disabled, no priming on T0 until switching back to T0 from another extruder:
2470 * [ Power-On -> T0 { T0 Activated } -> T1 { Activate & Prime T1 } -> T0 { Retract T1, Activate & Prime T0 } ]
2471 * Enable with M217 V1 before printing to avoid unwanted priming on host connect.
2473 //#define TOOLCHANGE_FS_PRIME_FIRST_USED
2476 * Tool Change Migration
2477 * This feature provides G-code and LCD options to switch tools mid-print.
2478 * All applicable tool properties are migrated so the print can continue.
2479 * Tools must be closely matching and other restrictions may apply.
2480 * Useful to:
2481 * - Change filament color without interruption
2482 * - Switch spools automatically on filament runout
2483 * - Switch to a different nozzle on an extruder jam
2485 #define TOOLCHANGE_MIGRATION_FEATURE
2487 #endif
2490 * Position to park head during tool change.
2491 * Doesn't apply to SWITCHING_TOOLHEAD, DUAL_X_CARRIAGE, or PARKING_EXTRUDER
2493 //#define TOOLCHANGE_PARK
2494 #if ENABLED(TOOLCHANGE_PARK)
2495 #define TOOLCHANGE_PARK_XY { X_MIN_POS + 10, Y_MIN_POS + 10 }
2496 #define TOOLCHANGE_PARK_XY_FEEDRATE 6000 // (mm/min)
2497 //#define TOOLCHANGE_PARK_X_ONLY // X axis only move
2498 //#define TOOLCHANGE_PARK_Y_ONLY // Y axis only move
2499 #endif
2500 #endif // HAS_MULTI_EXTRUDER
2503 * Advanced Pause for Filament Change
2504 * - Adds the G-code M600 Filament Change to initiate a filament change.
2505 * - This feature is required for the default FILAMENT_RUNOUT_SCRIPT.
2507 * Requirements:
2508 * - For Filament Change parking enable and configure NOZZLE_PARK_FEATURE.
2509 * - For user interaction enable an LCD display, HOST_PROMPT_SUPPORT, or EMERGENCY_PARSER.
2511 * Enable PARK_HEAD_ON_PAUSE to add the G-code M125 Pause and Park.
2513 //#define ADVANCED_PAUSE_FEATURE
2514 #if ENABLED(ADVANCED_PAUSE_FEATURE)
2515 #define PAUSE_PARK_RETRACT_FEEDRATE 60 // (mm/s) Initial retract feedrate.
2516 #define PAUSE_PARK_RETRACT_LENGTH 2 // (mm) Initial retract.
2517 // This short retract is done immediately, before parking the nozzle.
2518 #define FILAMENT_CHANGE_UNLOAD_FEEDRATE 10 // (mm/s) Unload filament feedrate. This can be pretty fast.
2519 #define FILAMENT_CHANGE_UNLOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
2520 #define FILAMENT_CHANGE_UNLOAD_LENGTH 100 // (mm) The length of filament for a complete unload.
2521 // For Bowden, the full length of the tube and nozzle.
2522 // For direct drive, the full length of the nozzle.
2523 // Set to 0 for manual unloading.
2524 #define FILAMENT_CHANGE_SLOW_LOAD_FEEDRATE 6 // (mm/s) Slow move when starting load.
2525 #define FILAMENT_CHANGE_SLOW_LOAD_LENGTH 0 // (mm) Slow length, to allow time to insert material.
2526 // 0 to disable start loading and skip to fast load only
2527 #define FILAMENT_CHANGE_FAST_LOAD_FEEDRATE 6 // (mm/s) Load filament feedrate. This can be pretty fast.
2528 #define FILAMENT_CHANGE_FAST_LOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
2529 #define FILAMENT_CHANGE_FAST_LOAD_LENGTH 0 // (mm) Load length of filament, from extruder gear to nozzle.
2530 // For Bowden, the full length of the tube and nozzle.
2531 // For direct drive, the full length of the nozzle.
2532 //#define ADVANCED_PAUSE_CONTINUOUS_PURGE // Purge continuously up to the purge length until interrupted.
2533 #define ADVANCED_PAUSE_PURGE_FEEDRATE 3 // (mm/s) Extrude feedrate (after loading). Should be slower than load feedrate.
2534 #define ADVANCED_PAUSE_PURGE_LENGTH 50 // (mm) Length to extrude after loading.
2535 // Set to 0 for manual extrusion.
2536 // Filament can be extruded repeatedly from the Filament Change menu
2537 // until extrusion is consistent, and to purge old filament.
2538 #define ADVANCED_PAUSE_RESUME_PRIME 0 // (mm) Extra distance to prime nozzle after returning from park.
2539 //#define ADVANCED_PAUSE_FANS_PAUSE // Turn off print-cooling fans while the machine is paused.
2541 // Filament Unload does a Retract, Delay, and Purge first:
2542 #define FILAMENT_UNLOAD_PURGE_RETRACT 13 // (mm) Unload initial retract length.
2543 #define FILAMENT_UNLOAD_PURGE_DELAY 5000 // (ms) Delay for the filament to cool after retract.
2544 #define FILAMENT_UNLOAD_PURGE_LENGTH 8 // (mm) An unretract is done, then this length is purged.
2545 #define FILAMENT_UNLOAD_PURGE_FEEDRATE 25 // (mm/s) feedrate to purge before unload
2547 #define PAUSE_PARK_NOZZLE_TIMEOUT 45 // (seconds) Time limit before the nozzle is turned off for safety.
2548 #define FILAMENT_CHANGE_ALERT_BEEPS 10 // Number of alert beeps to play when a response is needed.
2549 #define PAUSE_PARK_NO_STEPPER_TIMEOUT // Enable for XYZ steppers to stay powered on during filament change.
2550 //#define FILAMENT_CHANGE_RESUME_ON_INSERT // Automatically continue / load filament when runout sensor is triggered again.
2551 //#define PAUSE_REHEAT_FAST_RESUME // Reduce number of waits by not prompting again post-timeout before continuing.
2553 //#define PARK_HEAD_ON_PAUSE // Park the nozzle during pause and filament change.
2554 //#define HOME_BEFORE_FILAMENT_CHANGE // If needed, home before parking for filament change
2556 //#define FILAMENT_LOAD_UNLOAD_GCODES // Add M701/M702 Load/Unload G-codes, plus Load/Unload in the LCD Prepare menu.
2557 //#define FILAMENT_UNLOAD_ALL_EXTRUDERS // Allow M702 to unload all extruders above a minimum target temp (as set by M302)
2558 #endif
2560 // @section tmc
2563 * TMC26X Stepper Driver options
2565 * The TMC26XStepper library is required for this stepper driver.
2566 * https://github.com/trinamic/TMC26XStepper
2568 #if HAS_DRIVER(TMC26X)
2570 #if AXIS_DRIVER_TYPE_X(TMC26X)
2571 #define X_MAX_CURRENT 1000 // (mA)
2572 #define X_SENSE_RESISTOR 91 // (mOhms)
2573 #define X_MICROSTEPS 16 // Number of microsteps
2574 #endif
2576 #if AXIS_DRIVER_TYPE_X2(TMC26X)
2577 #define X2_MAX_CURRENT 1000
2578 #define X2_SENSE_RESISTOR 91
2579 #define X2_MICROSTEPS X_MICROSTEPS
2580 #endif
2582 #if AXIS_DRIVER_TYPE_Y(TMC26X)
2583 #define Y_MAX_CURRENT 1000
2584 #define Y_SENSE_RESISTOR 91
2585 #define Y_MICROSTEPS 16
2586 #endif
2588 #if AXIS_DRIVER_TYPE_Y2(TMC26X)
2589 #define Y2_MAX_CURRENT 1000
2590 #define Y2_SENSE_RESISTOR 91
2591 #define Y2_MICROSTEPS Y_MICROSTEPS
2592 #endif
2594 #if AXIS_DRIVER_TYPE_Z(TMC26X)
2595 #define Z_MAX_CURRENT 1000
2596 #define Z_SENSE_RESISTOR 91
2597 #define Z_MICROSTEPS 16
2598 #endif
2600 #if AXIS_DRIVER_TYPE_Z2(TMC26X)
2601 #define Z2_MAX_CURRENT 1000
2602 #define Z2_SENSE_RESISTOR 91
2603 #define Z2_MICROSTEPS Z_MICROSTEPS
2604 #endif
2606 #if AXIS_DRIVER_TYPE_Z3(TMC26X)
2607 #define Z3_MAX_CURRENT 1000
2608 #define Z3_SENSE_RESISTOR 91
2609 #define Z3_MICROSTEPS Z_MICROSTEPS
2610 #endif
2612 #if AXIS_DRIVER_TYPE_Z4(TMC26X)
2613 #define Z4_MAX_CURRENT 1000
2614 #define Z4_SENSE_RESISTOR 91
2615 #define Z4_MICROSTEPS Z_MICROSTEPS
2616 #endif
2618 #if AXIS_DRIVER_TYPE_I(TMC26X)
2619 #define I_MAX_CURRENT 1000
2620 #define I_SENSE_RESISTOR 91
2621 #define I_MICROSTEPS 16
2622 #endif
2624 #if AXIS_DRIVER_TYPE_J(TMC26X)
2625 #define J_MAX_CURRENT 1000
2626 #define J_SENSE_RESISTOR 91
2627 #define J_MICROSTEPS 16
2628 #endif
2630 #if AXIS_DRIVER_TYPE_K(TMC26X)
2631 #define K_MAX_CURRENT 1000
2632 #define K_SENSE_RESISTOR 91
2633 #define K_MICROSTEPS 16
2634 #endif
2636 #if AXIS_DRIVER_TYPE_E0(TMC26X)
2637 #define E0_MAX_CURRENT 1000
2638 #define E0_SENSE_RESISTOR 91
2639 #define E0_MICROSTEPS 16
2640 #endif
2642 #if AXIS_DRIVER_TYPE_E1(TMC26X)
2643 #define E1_MAX_CURRENT 1000
2644 #define E1_SENSE_RESISTOR 91
2645 #define E1_MICROSTEPS E0_MICROSTEPS
2646 #endif
2648 #if AXIS_DRIVER_TYPE_E2(TMC26X)
2649 #define E2_MAX_CURRENT 1000
2650 #define E2_SENSE_RESISTOR 91
2651 #define E2_MICROSTEPS E0_MICROSTEPS
2652 #endif
2654 #if AXIS_DRIVER_TYPE_E3(TMC26X)
2655 #define E3_MAX_CURRENT 1000
2656 #define E3_SENSE_RESISTOR 91
2657 #define E3_MICROSTEPS E0_MICROSTEPS
2658 #endif
2660 #if AXIS_DRIVER_TYPE_E4(TMC26X)
2661 #define E4_MAX_CURRENT 1000
2662 #define E4_SENSE_RESISTOR 91
2663 #define E4_MICROSTEPS E0_MICROSTEPS
2664 #endif
2666 #if AXIS_DRIVER_TYPE_E5(TMC26X)
2667 #define E5_MAX_CURRENT 1000
2668 #define E5_SENSE_RESISTOR 91
2669 #define E5_MICROSTEPS E0_MICROSTEPS
2670 #endif
2672 #if AXIS_DRIVER_TYPE_E6(TMC26X)
2673 #define E6_MAX_CURRENT 1000
2674 #define E6_SENSE_RESISTOR 91
2675 #define E6_MICROSTEPS E0_MICROSTEPS
2676 #endif
2678 #if AXIS_DRIVER_TYPE_E7(TMC26X)
2679 #define E7_MAX_CURRENT 1000
2680 #define E7_SENSE_RESISTOR 91
2681 #define E7_MICROSTEPS E0_MICROSTEPS
2682 #endif
2684 #endif // TMC26X
2686 // @section tmc_smart
2689 * To use TMC2130, TMC2160, TMC2660, TMC5130, TMC5160 stepper drivers in SPI mode
2690 * connect your SPI pins to the hardware SPI interface on your board and define
2691 * the required CS pins in your `pins_MYBOARD.h` file. (e.g., RAMPS 1.4 uses AUX3
2692 * pins `X_CS_PIN 53`, `Y_CS_PIN 49`, etc.).
2693 * You may also use software SPI if you wish to use general purpose IO pins.
2695 * To use TMC2208 stepper UART-configurable stepper drivers connect #_SERIAL_TX_PIN
2696 * to the driver side PDN_UART pin with a 1K resistor.
2697 * To use the reading capabilities, also connect #_SERIAL_RX_PIN to PDN_UART without
2698 * a resistor.
2699 * The drivers can also be used with hardware serial.
2701 * TMCStepper library is required to use TMC stepper drivers.
2702 * https://github.com/teemuatlut/TMCStepper
2704 #if HAS_TRINAMIC_CONFIG
2706 #define HOLD_MULTIPLIER 0.5 // Scales down the holding current from run current
2709 * Interpolate microsteps to 256
2710 * Override for each driver with <driver>_INTERPOLATE settings below
2712 #define INTERPOLATE true
2714 #if AXIS_IS_TMC(X)
2715 #define X_CURRENT 800 // (mA) RMS current. Multiply by 1.414 for peak current.
2716 #define X_CURRENT_HOME X_CURRENT // (mA) RMS current for sensorless homing
2717 #define X_MICROSTEPS 16 // 0..256
2718 #define X_RSENSE 0.11
2719 #define X_CHAIN_POS -1 // -1..0: Not chained. 1: MCU MOSI connected. 2: Next in chain, ...
2720 //#define X_INTERPOLATE true // Enable to override 'INTERPOLATE' for the X axis
2721 //#define X_HOLD_MULTIPLIER 0.5 // Enable to override 'HOLD_MULTIPLIER' for the X axis
2722 #endif
2724 #if AXIS_IS_TMC(X2)
2725 #define X2_CURRENT 800
2726 #define X2_CURRENT_HOME X2_CURRENT
2727 #define X2_MICROSTEPS X_MICROSTEPS
2728 #define X2_RSENSE 0.11
2729 #define X2_CHAIN_POS -1
2730 //#define X2_INTERPOLATE true
2731 //#define X2_HOLD_MULTIPLIER 0.5
2732 #endif
2734 #if AXIS_IS_TMC(Y)
2735 #define Y_CURRENT 800
2736 #define Y_CURRENT_HOME Y_CURRENT
2737 #define Y_MICROSTEPS 16
2738 #define Y_RSENSE 0.11
2739 #define Y_CHAIN_POS -1
2740 //#define Y_INTERPOLATE true
2741 //#define Y_HOLD_MULTIPLIER 0.5
2742 #endif
2744 #if AXIS_IS_TMC(Y2)
2745 #define Y2_CURRENT 800
2746 #define Y2_CURRENT_HOME Y2_CURRENT
2747 #define Y2_MICROSTEPS Y_MICROSTEPS
2748 #define Y2_RSENSE 0.11
2749 #define Y2_CHAIN_POS -1
2750 //#define Y2_INTERPOLATE true
2751 //#define Y2_HOLD_MULTIPLIER 0.5
2752 #endif
2754 #if AXIS_IS_TMC(Z)
2755 #define Z_CURRENT 800
2756 #define Z_CURRENT_HOME Z_CURRENT
2757 #define Z_MICROSTEPS 16
2758 #define Z_RSENSE 0.11
2759 #define Z_CHAIN_POS -1
2760 //#define Z_INTERPOLATE true
2761 //#define Z_HOLD_MULTIPLIER 0.5
2762 #endif
2764 #if AXIS_IS_TMC(Z2)
2765 #define Z2_CURRENT 800
2766 #define Z2_CURRENT_HOME Z2_CURRENT
2767 #define Z2_MICROSTEPS Z_MICROSTEPS
2768 #define Z2_RSENSE 0.11
2769 #define Z2_CHAIN_POS -1
2770 //#define Z2_INTERPOLATE true
2771 //#define Z2_HOLD_MULTIPLIER 0.5
2772 #endif
2774 #if AXIS_IS_TMC(Z3)
2775 #define Z3_CURRENT 800
2776 #define Z3_CURRENT_HOME Z3_CURRENT
2777 #define Z3_MICROSTEPS Z_MICROSTEPS
2778 #define Z3_RSENSE 0.11
2779 #define Z3_CHAIN_POS -1
2780 //#define Z3_INTERPOLATE true
2781 //#define Z3_HOLD_MULTIPLIER 0.5
2782 #endif
2784 #if AXIS_IS_TMC(Z4)
2785 #define Z4_CURRENT 800
2786 #define Z4_CURRENT_HOME Z4_CURRENT
2787 #define Z4_MICROSTEPS Z_MICROSTEPS
2788 #define Z4_RSENSE 0.11
2789 #define Z4_CHAIN_POS -1
2790 //#define Z4_INTERPOLATE true
2791 //#define Z4_HOLD_MULTIPLIER 0.5
2792 #endif
2794 #if AXIS_IS_TMC(I)
2795 #define I_CURRENT 800
2796 #define I_CURRENT_HOME I_CURRENT
2797 #define I_MICROSTEPS 16
2798 #define I_RSENSE 0.11
2799 #define I_CHAIN_POS -1
2800 //#define I_INTERPOLATE true
2801 //#define I_HOLD_MULTIPLIER 0.5
2802 #endif
2804 #if AXIS_IS_TMC(J)
2805 #define J_CURRENT 800
2806 #define J_CURRENT_HOME J_CURRENT
2807 #define J_MICROSTEPS 16
2808 #define J_RSENSE 0.11
2809 #define J_CHAIN_POS -1
2810 //#define J_INTERPOLATE true
2811 //#define J_HOLD_MULTIPLIER 0.5
2812 #endif
2814 #if AXIS_IS_TMC(K)
2815 #define K_CURRENT 800
2816 #define K_CURRENT_HOME K_CURRENT
2817 #define K_MICROSTEPS 16
2818 #define K_RSENSE 0.11
2819 #define K_CHAIN_POS -1
2820 //#define K_INTERPOLATE true
2821 //#define K_HOLD_MULTIPLIER 0.5
2822 #endif
2824 #if AXIS_IS_TMC(E0)
2825 #define E0_CURRENT 800
2826 #define E0_MICROSTEPS 16
2827 #define E0_RSENSE 0.11
2828 #define E0_CHAIN_POS -1
2829 //#define E0_INTERPOLATE true
2830 //#define E0_HOLD_MULTIPLIER 0.5
2831 #endif
2833 #if AXIS_IS_TMC(E1)
2834 #define E1_CURRENT 800
2835 #define E1_MICROSTEPS E0_MICROSTEPS
2836 #define E1_RSENSE 0.11
2837 #define E1_CHAIN_POS -1
2838 //#define E1_INTERPOLATE true
2839 //#define E1_HOLD_MULTIPLIER 0.5
2840 #endif
2842 #if AXIS_IS_TMC(E2)
2843 #define E2_CURRENT 800
2844 #define E2_MICROSTEPS E0_MICROSTEPS
2845 #define E2_RSENSE 0.11
2846 #define E2_CHAIN_POS -1
2847 //#define E2_INTERPOLATE true
2848 //#define E2_HOLD_MULTIPLIER 0.5
2849 #endif
2851 #if AXIS_IS_TMC(E3)
2852 #define E3_CURRENT 800
2853 #define E3_MICROSTEPS E0_MICROSTEPS
2854 #define E3_RSENSE 0.11
2855 #define E3_CHAIN_POS -1
2856 //#define E3_INTERPOLATE true
2857 //#define E3_HOLD_MULTIPLIER 0.5
2858 #endif
2860 #if AXIS_IS_TMC(E4)
2861 #define E4_CURRENT 800
2862 #define E4_MICROSTEPS E0_MICROSTEPS
2863 #define E4_RSENSE 0.11
2864 #define E4_CHAIN_POS -1
2865 //#define E4_INTERPOLATE true
2866 //#define E4_HOLD_MULTIPLIER 0.5
2867 #endif
2869 #if AXIS_IS_TMC(E5)
2870 #define E5_CURRENT 800
2871 #define E5_MICROSTEPS E0_MICROSTEPS
2872 #define E5_RSENSE 0.11
2873 #define E5_CHAIN_POS -1
2874 //#define E5_INTERPOLATE true
2875 //#define E5_HOLD_MULTIPLIER 0.5
2876 #endif
2878 #if AXIS_IS_TMC(E6)
2879 #define E6_CURRENT 800
2880 #define E6_MICROSTEPS E0_MICROSTEPS
2881 #define E6_RSENSE 0.11
2882 #define E6_CHAIN_POS -1
2883 //#define E6_INTERPOLATE true
2884 //#define E6_HOLD_MULTIPLIER 0.5
2885 #endif
2887 #if AXIS_IS_TMC(E7)
2888 #define E7_CURRENT 800
2889 #define E7_MICROSTEPS E0_MICROSTEPS
2890 #define E7_RSENSE 0.11
2891 #define E7_CHAIN_POS -1
2892 //#define E7_INTERPOLATE true
2893 //#define E7_HOLD_MULTIPLIER 0.5
2894 #endif
2897 * Override default SPI pins for TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160 drivers here.
2898 * The default pins can be found in your board's pins file.
2900 //#define X_CS_PIN -1
2901 //#define Y_CS_PIN -1
2902 //#define Z_CS_PIN -1
2903 //#define X2_CS_PIN -1
2904 //#define Y2_CS_PIN -1
2905 //#define Z2_CS_PIN -1
2906 //#define Z3_CS_PIN -1
2907 //#define Z4_CS_PIN -1
2908 //#define I_CS_PIN -1
2909 //#define J_CS_PIN -1
2910 //#define K_CS_PIN -1
2911 //#define E0_CS_PIN -1
2912 //#define E1_CS_PIN -1
2913 //#define E2_CS_PIN -1
2914 //#define E3_CS_PIN -1
2915 //#define E4_CS_PIN -1
2916 //#define E5_CS_PIN -1
2917 //#define E6_CS_PIN -1
2918 //#define E7_CS_PIN -1
2921 * Software option for SPI driven drivers (TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160).
2922 * The default SW SPI pins are defined the respective pins files,
2923 * but you can override or define them here.
2925 //#define TMC_USE_SW_SPI
2926 //#define TMC_SW_MOSI -1
2927 //#define TMC_SW_MISO -1
2928 //#define TMC_SW_SCK -1
2931 * Four TMC2209 drivers can use the same HW/SW serial port with hardware configured addresses.
2932 * Set the address using jumpers on pins MS1 and MS2.
2933 * Address | MS1 | MS2
2934 * 0 | LOW | LOW
2935 * 1 | HIGH | LOW
2936 * 2 | LOW | HIGH
2937 * 3 | HIGH | HIGH
2939 * Set *_SERIAL_TX_PIN and *_SERIAL_RX_PIN to match for all drivers
2940 * on the same serial port, either here or in your board's pins file.
2942 //#define X_SLAVE_ADDRESS 0
2943 //#define Y_SLAVE_ADDRESS 0
2944 //#define Z_SLAVE_ADDRESS 0
2945 //#define X2_SLAVE_ADDRESS 0
2946 //#define Y2_SLAVE_ADDRESS 0
2947 //#define Z2_SLAVE_ADDRESS 0
2948 //#define Z3_SLAVE_ADDRESS 0
2949 //#define Z4_SLAVE_ADDRESS 0
2950 //#define I_SLAVE_ADDRESS 0
2951 //#define J_SLAVE_ADDRESS 0
2952 //#define K_SLAVE_ADDRESS 0
2953 //#define E0_SLAVE_ADDRESS 0
2954 //#define E1_SLAVE_ADDRESS 0
2955 //#define E2_SLAVE_ADDRESS 0
2956 //#define E3_SLAVE_ADDRESS 0
2957 //#define E4_SLAVE_ADDRESS 0
2958 //#define E5_SLAVE_ADDRESS 0
2959 //#define E6_SLAVE_ADDRESS 0
2960 //#define E7_SLAVE_ADDRESS 0
2963 * Software enable
2965 * Use for drivers that do not use a dedicated enable pin, but rather handle the same
2966 * function through a communication line such as SPI or UART.
2968 //#define SOFTWARE_DRIVER_ENABLE
2971 * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
2972 * Use Trinamic's ultra quiet stepping mode.
2973 * When disabled, Marlin will use spreadCycle stepping mode.
2975 #define STEALTHCHOP_XY
2976 #define STEALTHCHOP_Z
2977 #define STEALTHCHOP_I
2978 #define STEALTHCHOP_J
2979 #define STEALTHCHOP_K
2980 #define STEALTHCHOP_E
2983 * Optimize spreadCycle chopper parameters by using predefined parameter sets
2984 * or with the help of an example included in the library.
2985 * Provided parameter sets are
2986 * CHOPPER_DEFAULT_12V
2987 * CHOPPER_DEFAULT_19V
2988 * CHOPPER_DEFAULT_24V
2989 * CHOPPER_DEFAULT_36V
2990 * CHOPPER_09STEP_24V // 0.9 degree steppers (24V)
2991 * CHOPPER_PRUSAMK3_24V // Imported parameters from the official Průša firmware for MK3 (24V)
2992 * CHOPPER_MARLIN_119 // Old defaults from Marlin v1.1.9
2994 * Define your own with:
2995 * { <off_time[1..15]>, <hysteresis_end[-3..12]>, hysteresis_start[1..8] }
2997 #define CHOPPER_TIMING CHOPPER_DEFAULT_12V // All axes (override below)
2998 //#define CHOPPER_TIMING_X CHOPPER_TIMING // For X Axes (override below)
2999 //#define CHOPPER_TIMING_X2 CHOPPER_TIMING_X
3000 //#define CHOPPER_TIMING_Y CHOPPER_TIMING // For Y Axes (override below)
3001 //#define CHOPPER_TIMING_Y2 CHOPPER_TIMING_Y
3002 //#define CHOPPER_TIMING_Z CHOPPER_TIMING // For Z Axes (override below)
3003 //#define CHOPPER_TIMING_Z2 CHOPPER_TIMING_Z
3004 //#define CHOPPER_TIMING_Z3 CHOPPER_TIMING_Z
3005 //#define CHOPPER_TIMING_Z4 CHOPPER_TIMING_Z
3006 //#define CHOPPER_TIMING_I CHOPPER_TIMING
3007 //#define CHOPPER_TIMING_J CHOPPER_TIMING
3008 //#define CHOPPER_TIMING_K CHOPPER_TIMING
3009 //#define CHOPPER_TIMING_E CHOPPER_TIMING // For Extruders (override below)
3010 //#define CHOPPER_TIMING_E1 CHOPPER_TIMING_E
3011 //#define CHOPPER_TIMING_E2 CHOPPER_TIMING_E
3012 //#define CHOPPER_TIMING_E3 CHOPPER_TIMING_E
3013 //#define CHOPPER_TIMING_E4 CHOPPER_TIMING_E
3014 //#define CHOPPER_TIMING_E5 CHOPPER_TIMING_E
3015 //#define CHOPPER_TIMING_E6 CHOPPER_TIMING_E
3016 //#define CHOPPER_TIMING_E7 CHOPPER_TIMING_E
3019 * Monitor Trinamic drivers
3020 * for error conditions like overtemperature and short to ground.
3021 * To manage over-temp Marlin can decrease the driver current until the error condition clears.
3022 * Other detected conditions can be used to stop the current print.
3023 * Relevant G-codes:
3024 * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given.
3025 * M911 - Report stepper driver overtemperature pre-warn condition.
3026 * M912 - Clear stepper driver overtemperature pre-warn condition flag.
3027 * M122 - Report driver parameters (Requires TMC_DEBUG)
3029 //#define MONITOR_DRIVER_STATUS
3031 #if ENABLED(MONITOR_DRIVER_STATUS)
3032 #define CURRENT_STEP_DOWN 50 // [mA]
3033 #define REPORT_CURRENT_CHANGE
3034 #define STOP_ON_ERROR
3035 #endif
3038 * TMC2130, TMC2160, TMC2208, TMC2209, TMC5130 and TMC5160 only
3039 * The driver will switch to spreadCycle when stepper speed is over HYBRID_THRESHOLD.
3040 * This mode allows for faster movements at the expense of higher noise levels.
3041 * STEALTHCHOP_(XY|Z|E) must be enabled to use HYBRID_THRESHOLD.
3042 * M913 X/Y/Z/E to live tune the setting
3044 //#define HYBRID_THRESHOLD
3046 #define X_HYBRID_THRESHOLD 100 // [mm/s]
3047 #define X2_HYBRID_THRESHOLD 100
3048 #define Y_HYBRID_THRESHOLD 100
3049 #define Y2_HYBRID_THRESHOLD 100
3050 #define Z_HYBRID_THRESHOLD 3
3051 #define Z2_HYBRID_THRESHOLD 3
3052 #define Z3_HYBRID_THRESHOLD 3
3053 #define Z4_HYBRID_THRESHOLD 3
3054 #define I_HYBRID_THRESHOLD 3
3055 #define J_HYBRID_THRESHOLD 3
3056 #define K_HYBRID_THRESHOLD 3
3057 #define E0_HYBRID_THRESHOLD 30
3058 #define E1_HYBRID_THRESHOLD 30
3059 #define E2_HYBRID_THRESHOLD 30
3060 #define E3_HYBRID_THRESHOLD 30
3061 #define E4_HYBRID_THRESHOLD 30
3062 #define E5_HYBRID_THRESHOLD 30
3063 #define E6_HYBRID_THRESHOLD 30
3064 #define E7_HYBRID_THRESHOLD 30
3067 * Use StallGuard to home / probe X, Y, Z.
3069 * TMC2130, TMC2160, TMC2209, TMC2660, TMC5130, and TMC5160 only
3070 * Connect the stepper driver's DIAG1 pin to the X/Y endstop pin.
3071 * X, Y, and Z homing will always be done in spreadCycle mode.
3073 * X/Y/Z_STALL_SENSITIVITY is the default stall threshold.
3074 * Use M914 X Y Z to set the stall threshold at runtime:
3076 * Sensitivity TMC2209 Others
3077 * HIGHEST 255 -64 (Too sensitive => False positive)
3078 * LOWEST 0 63 (Too insensitive => No trigger)
3080 * It is recommended to set HOMING_BUMP_MM to { 0, 0, 0 }.
3082 * SPI_ENDSTOPS *** Beta feature! *** TMC2130/TMC5160 Only ***
3083 * Poll the driver through SPI to determine load when homing.
3084 * Removes the need for a wire from DIAG1 to an endstop pin.
3086 * IMPROVE_HOMING_RELIABILITY tunes acceleration and jerk when
3087 * homing and adds a guard period for endstop triggering.
3089 * Comment *_STALL_SENSITIVITY to disable sensorless homing for that axis.
3091 //#define SENSORLESS_HOMING // StallGuard capable drivers only
3093 #if EITHER(SENSORLESS_HOMING, SENSORLESS_PROBING)
3094 // TMC2209: 0...255. TMC2130: -64...63
3095 #define X_STALL_SENSITIVITY 8
3096 #define X2_STALL_SENSITIVITY X_STALL_SENSITIVITY
3097 #define Y_STALL_SENSITIVITY 8
3098 #define Y2_STALL_SENSITIVITY Y_STALL_SENSITIVITY
3099 //#define Z_STALL_SENSITIVITY 8
3100 //#define Z2_STALL_SENSITIVITY Z_STALL_SENSITIVITY
3101 //#define Z3_STALL_SENSITIVITY Z_STALL_SENSITIVITY
3102 //#define Z4_STALL_SENSITIVITY Z_STALL_SENSITIVITY
3103 //#define I_STALL_SENSITIVITY 8
3104 //#define J_STALL_SENSITIVITY 8
3105 //#define K_STALL_SENSITIVITY 8
3106 //#define SPI_ENDSTOPS // TMC2130 only
3107 //#define IMPROVE_HOMING_RELIABILITY
3108 #endif
3111 * TMC Homing stepper phase.
3113 * Improve homing repeatability by homing to stepper coil's nearest absolute
3114 * phase position. Trinamic drivers use a stepper phase table with 1024 values
3115 * spanning 4 full steps with 256 positions each (ergo, 1024 positions).
3116 * Full step positions (128, 384, 640, 896) have the highest holding torque.
3118 * Values from 0..1023, -1 to disable homing phase for that axis.
3120 //#define TMC_HOME_PHASE { 896, 896, 896 }
3123 * Beta feature!
3124 * Create a 50/50 square wave step pulse optimal for stepper drivers.
3126 //#define SQUARE_WAVE_STEPPING
3129 * Enable M122 debugging command for TMC stepper drivers.
3130 * M122 S0/1 will enable continuous reporting.
3132 //#define TMC_DEBUG
3135 * You can set your own advanced settings by filling in predefined functions.
3136 * A list of available functions can be found on the library github page
3137 * https://github.com/teemuatlut/TMCStepper
3139 * Example:
3140 * #define TMC_ADV() { \
3141 * stepperX.diag0_otpw(1); \
3142 * stepperY.intpol(0); \
3145 #define TMC_ADV() { }
3147 #endif // HAS_TRINAMIC_CONFIG
3149 // @section L64XX
3152 * L64XX Stepper Driver options
3154 * Arduino-L6470 library (0.8.0 or higher) is required.
3155 * https://github.com/ameyer/Arduino-L6470
3157 * Requires the following to be defined in your pins_YOUR_BOARD file
3158 * L6470_CHAIN_SCK_PIN
3159 * L6470_CHAIN_MISO_PIN
3160 * L6470_CHAIN_MOSI_PIN
3161 * L6470_CHAIN_SS_PIN
3162 * ENABLE_RESET_L64XX_CHIPS(Q) where Q is 1 to enable and 0 to reset
3165 #if HAS_L64XX
3167 //#define L6470_CHITCHAT // Display additional status info
3169 #if AXIS_IS_L64XX(X)
3170 #define X_MICROSTEPS 128 // Number of microsteps (VALID: 1, 2, 4, 8, 16, 32, 128) - L6474 max is 16
3171 #define X_OVERCURRENT 2000 // (mA) Current where the driver detects an over current
3172 // L6470 & L6474 - VALID: 375 x (1 - 16) - 6A max - rounds down
3173 // POWERSTEP01: VALID: 1000 x (1 - 32) - 32A max - rounds down
3174 #define X_STALLCURRENT 1500 // (mA) Current where the driver detects a stall (VALID: 31.25 * (1-128) - 4A max - rounds down)
3175 // L6470 & L6474 - VALID: 31.25 * (1-128) - 4A max - rounds down
3176 // POWERSTEP01: VALID: 200 x (1 - 32) - 6.4A max - rounds down
3177 // L6474 - STALLCURRENT setting is used to set the nominal (TVAL) current
3178 #define X_MAX_VOLTAGE 127 // 0-255, Maximum effective voltage seen by stepper - not used by L6474
3179 #define X_CHAIN_POS -1 // Position in SPI chain, 0=Not in chain, 1=Nearest MOSI
3180 #define X_SLEW_RATE 1 // 0-3, Slew 0 is slowest, 3 is fastest
3181 #endif
3183 #if AXIS_IS_L64XX(X2)
3184 #define X2_MICROSTEPS X_MICROSTEPS
3185 #define X2_OVERCURRENT 2000
3186 #define X2_STALLCURRENT 1500
3187 #define X2_MAX_VOLTAGE 127
3188 #define X2_CHAIN_POS -1
3189 #define X2_SLEW_RATE 1
3190 #endif
3192 #if AXIS_IS_L64XX(Y)
3193 #define Y_MICROSTEPS 128
3194 #define Y_OVERCURRENT 2000
3195 #define Y_STALLCURRENT 1500
3196 #define Y_MAX_VOLTAGE 127
3197 #define Y_CHAIN_POS -1
3198 #define Y_SLEW_RATE 1
3199 #endif
3201 #if AXIS_IS_L64XX(Y2)
3202 #define Y2_MICROSTEPS Y_MICROSTEPS
3203 #define Y2_OVERCURRENT 2000
3204 #define Y2_STALLCURRENT 1500
3205 #define Y2_MAX_VOLTAGE 127
3206 #define Y2_CHAIN_POS -1
3207 #define Y2_SLEW_RATE 1
3208 #endif
3210 #if AXIS_IS_L64XX(Z)
3211 #define Z_MICROSTEPS 128
3212 #define Z_OVERCURRENT 2000
3213 #define Z_STALLCURRENT 1500
3214 #define Z_MAX_VOLTAGE 127
3215 #define Z_CHAIN_POS -1
3216 #define Z_SLEW_RATE 1
3217 #endif
3219 #if AXIS_IS_L64XX(Z2)
3220 #define Z2_MICROSTEPS Z_MICROSTEPS
3221 #define Z2_OVERCURRENT 2000
3222 #define Z2_STALLCURRENT 1500
3223 #define Z2_MAX_VOLTAGE 127
3224 #define Z2_CHAIN_POS -1
3225 #define Z2_SLEW_RATE 1
3226 #endif
3228 #if AXIS_IS_L64XX(Z3)
3229 #define Z3_MICROSTEPS Z_MICROSTEPS
3230 #define Z3_OVERCURRENT 2000
3231 #define Z3_STALLCURRENT 1500
3232 #define Z3_MAX_VOLTAGE 127
3233 #define Z3_CHAIN_POS -1
3234 #define Z3_SLEW_RATE 1
3235 #endif
3237 #if AXIS_IS_L64XX(Z4)
3238 #define Z4_MICROSTEPS Z_MICROSTEPS
3239 #define Z4_OVERCURRENT 2000
3240 #define Z4_STALLCURRENT 1500
3241 #define Z4_MAX_VOLTAGE 127
3242 #define Z4_CHAIN_POS -1
3243 #define Z4_SLEW_RATE 1
3244 #endif
3246 #if AXIS_IS_L64XX(I)
3247 #define I_MICROSTEPS 128
3248 #define I_OVERCURRENT 2000
3249 #define I_STALLCURRENT 1500
3250 #define I_MAX_VOLTAGE 127
3251 #define I_CHAIN_POS -1
3252 #define I_SLEW_RATE 1
3253 #endif
3255 #if AXIS_IS_L64XX(J)
3256 #define J_MICROSTEPS 128
3257 #define J_OVERCURRENT 2000
3258 #define J_STALLCURRENT 1500
3259 #define J_MAX_VOLTAGE 127
3260 #define J_CHAIN_POS -1
3261 #define J_SLEW_RATE 1
3262 #endif
3264 #if AXIS_IS_L64XX(K)
3265 #define K_MICROSTEPS 128
3266 #define K_OVERCURRENT 2000
3267 #define K_STALLCURRENT 1500
3268 #define K_MAX_VOLTAGE 127
3269 #define K_CHAIN_POS -1
3270 #define K_SLEW_RATE 1
3271 #endif
3273 #if AXIS_IS_L64XX(E0)
3274 #define E0_MICROSTEPS 128
3275 #define E0_OVERCURRENT 2000
3276 #define E0_STALLCURRENT 1500
3277 #define E0_MAX_VOLTAGE 127
3278 #define E0_CHAIN_POS -1
3279 #define E0_SLEW_RATE 1
3280 #endif
3282 #if AXIS_IS_L64XX(E1)
3283 #define E1_MICROSTEPS E0_MICROSTEPS
3284 #define E1_OVERCURRENT 2000
3285 #define E1_STALLCURRENT 1500
3286 #define E1_MAX_VOLTAGE 127
3287 #define E1_CHAIN_POS -1
3288 #define E1_SLEW_RATE 1
3289 #endif
3291 #if AXIS_IS_L64XX(E2)
3292 #define E2_MICROSTEPS E0_MICROSTEPS
3293 #define E2_OVERCURRENT 2000
3294 #define E2_STALLCURRENT 1500
3295 #define E2_MAX_VOLTAGE 127
3296 #define E2_CHAIN_POS -1
3297 #define E2_SLEW_RATE 1
3298 #endif
3300 #if AXIS_IS_L64XX(E3)
3301 #define E3_MICROSTEPS E0_MICROSTEPS
3302 #define E3_OVERCURRENT 2000
3303 #define E3_STALLCURRENT 1500
3304 #define E3_MAX_VOLTAGE 127
3305 #define E3_CHAIN_POS -1
3306 #define E3_SLEW_RATE 1
3307 #endif
3309 #if AXIS_IS_L64XX(E4)
3310 #define E4_MICROSTEPS E0_MICROSTEPS
3311 #define E4_OVERCURRENT 2000
3312 #define E4_STALLCURRENT 1500
3313 #define E4_MAX_VOLTAGE 127
3314 #define E4_CHAIN_POS -1
3315 #define E4_SLEW_RATE 1
3316 #endif
3318 #if AXIS_IS_L64XX(E5)
3319 #define E5_MICROSTEPS E0_MICROSTEPS
3320 #define E5_OVERCURRENT 2000
3321 #define E5_STALLCURRENT 1500
3322 #define E5_MAX_VOLTAGE 127
3323 #define E5_CHAIN_POS -1
3324 #define E5_SLEW_RATE 1
3325 #endif
3327 #if AXIS_IS_L64XX(E6)
3328 #define E6_MICROSTEPS E0_MICROSTEPS
3329 #define E6_OVERCURRENT 2000
3330 #define E6_STALLCURRENT 1500
3331 #define E6_MAX_VOLTAGE 127
3332 #define E6_CHAIN_POS -1
3333 #define E6_SLEW_RATE 1
3334 #endif
3336 #if AXIS_IS_L64XX(E7)
3337 #define E7_MICROSTEPS E0_MICROSTEPS
3338 #define E7_OVERCURRENT 2000
3339 #define E7_STALLCURRENT 1500
3340 #define E7_MAX_VOLTAGE 127
3341 #define E7_CHAIN_POS -1
3342 #define E7_SLEW_RATE 1
3343 #endif
3346 * Monitor L6470 drivers for error conditions like over temperature and over current.
3347 * In the case of over temperature Marlin can decrease the drive until the error condition clears.
3348 * Other detected conditions can be used to stop the current print.
3349 * Relevant G-codes:
3350 * 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.
3351 * I not present or I0 or I1 - X, Y, Z or E0
3352 * I2 - X2, Y2, Z2 or E1
3353 * I3 - Z3 or E3
3354 * I4 - Z4 or E4
3355 * I5 - E5
3356 * M916 - Increase drive level until get thermal warning
3357 * M917 - Find minimum current thresholds
3358 * M918 - Increase speed until max or error
3359 * M122 S0/1 - Report driver parameters
3361 //#define MONITOR_L6470_DRIVER_STATUS
3363 #if ENABLED(MONITOR_L6470_DRIVER_STATUS)
3364 #define KVAL_HOLD_STEP_DOWN 1
3365 //#define L6470_STOP_ON_ERROR
3366 #endif
3368 #endif // HAS_L64XX
3370 // @section i2cbus
3373 // I2C Master ID for LPC176x LCD and Digital Current control
3374 // Does not apply to other peripherals based on the Wire library.
3376 //#define I2C_MASTER_ID 1 // Set a value from 0 to 2
3379 * TWI/I2C BUS
3381 * This feature is an EXPERIMENTAL feature so it shall not be used on production
3382 * machines. Enabling this will allow you to send and receive I2C data from slave
3383 * devices on the bus.
3385 * ; Example #1
3386 * ; This macro send the string "Marlin" to the slave device with address 0x63 (99)
3387 * ; It uses multiple M260 commands with one B<base 10> arg
3388 * M260 A99 ; Target slave address
3389 * M260 B77 ; M
3390 * M260 B97 ; a
3391 * M260 B114 ; r
3392 * M260 B108 ; l
3393 * M260 B105 ; i
3394 * M260 B110 ; n
3395 * M260 S1 ; Send the current buffer
3397 * ; Example #2
3398 * ; Request 6 bytes from slave device with address 0x63 (99)
3399 * M261 A99 B5
3401 * ; Example #3
3402 * ; Example serial output of a M261 request
3403 * echo:i2c-reply: from:99 bytes:5 data:hello
3406 //#define EXPERIMENTAL_I2CBUS
3407 #if ENABLED(EXPERIMENTAL_I2CBUS)
3408 #define I2C_SLAVE_ADDRESS 0 // Set a value from 8 to 127 to act as a slave
3409 #endif
3411 // @section extras
3414 * Photo G-code
3415 * Add the M240 G-code to take a photo.
3416 * The photo can be triggered by a digital pin or a physical movement.
3418 //#define PHOTO_GCODE
3419 #if ENABLED(PHOTO_GCODE)
3420 // A position to move to (and raise Z) before taking the photo
3421 //#define PHOTO_POSITION { X_MAX_POS - 5, Y_MAX_POS, 0 } // { xpos, ypos, zraise } (M240 X Y Z)
3422 //#define PHOTO_DELAY_MS 100 // (ms) Duration to pause before moving back (M240 P)
3423 //#define PHOTO_RETRACT_MM 6.5 // (mm) E retract/recover for the photo move (M240 R S)
3425 // Canon RC-1 or homebrew digital camera trigger
3426 // Data from: https://www.doc-diy.net/photo/rc-1_hacked/
3427 //#define PHOTOGRAPH_PIN 23
3429 // Canon Hack Development Kit
3430 // https://captain-slow.dk/2014/03/09/3d-printing-timelapses/
3431 //#define CHDK_PIN 4
3433 // Optional second move with delay to trigger the camera shutter
3434 //#define PHOTO_SWITCH_POSITION { X_MAX_POS, Y_MAX_POS } // { xpos, ypos } (M240 I J)
3436 // Duration to hold the switch or keep CHDK_PIN high
3437 //#define PHOTO_SWITCH_MS 50 // (ms) (M240 D)
3440 * PHOTO_PULSES_US may need adjustment depending on board and camera model.
3441 * Pin must be running at 48.4kHz.
3442 * Be sure to use a PHOTOGRAPH_PIN which can rise and fall quick enough.
3443 * (e.g., MKS SBase temp sensor pin was too slow, so used P1.23 on J8.)
3445 * Example pulse data for Nikon: https://bit.ly/2FKD0Aq
3446 * IR Wiring: https://git.io/JvJf7
3448 //#define PHOTO_PULSES_US { 2000, 27850, 400, 1580, 400, 3580, 400 } // (µs) Durations for each 48.4kHz oscillation
3449 #ifdef PHOTO_PULSES_US
3450 #define PHOTO_PULSE_DELAY_US 13 // (µs) Approximate duration of each HIGH and LOW pulse in the oscillation
3451 #endif
3452 #endif
3455 * Spindle & Laser control
3457 * Add the M3, M4, and M5 commands to turn the spindle/laser on and off, and
3458 * to set spindle speed, spindle direction, and laser power.
3460 * SuperPid is a router/spindle speed controller used in the CNC milling community.
3461 * Marlin can be used to turn the spindle on and off. It can also be used to set
3462 * the spindle speed from 5,000 to 30,000 RPM.
3464 * You'll need to select a pin for the ON/OFF function and optionally choose a 0-5V
3465 * hardware PWM pin for the speed control and a pin for the rotation direction.
3467 * See https://marlinfw.org/docs/configuration/2.0.9/laser_spindle.html for more config details.
3469 //#define SPINDLE_FEATURE
3470 //#define LASER_FEATURE
3471 #if EITHER(SPINDLE_FEATURE, LASER_FEATURE)
3472 #define SPINDLE_LASER_ACTIVE_STATE LOW // Set to "HIGH" if SPINDLE_LASER_ENA_PIN is active HIGH
3474 #define SPINDLE_LASER_USE_PWM // Enable if your controller supports setting the speed/power
3475 #if ENABLED(SPINDLE_LASER_USE_PWM)
3476 #define SPINDLE_LASER_PWM_INVERT false // Set to "true" if the speed/power goes up when you want it to go slower
3477 #define SPINDLE_LASER_FREQUENCY 2500 // (Hz) Spindle/laser frequency (only on supported HALs: AVR, ESP32, and LPC)
3478 // ESP32: If SPINDLE_LASER_PWM_PIN is onboard then <=78125Hz. For I2S expander
3479 // the frequency determines the PWM resolution. 2500Hz = 0-100, 977Hz = 0-255, ...
3480 // (250000 / SPINDLE_LASER_FREQUENCY) = max value.
3481 #endif
3483 //#define AIR_EVACUATION // Cutter Vacuum / Laser Blower motor control with G-codes M10-M11
3484 #if ENABLED(AIR_EVACUATION)
3485 #define AIR_EVACUATION_ACTIVE LOW // Set to "HIGH" if the on/off function is active HIGH
3486 //#define AIR_EVACUATION_PIN 42 // Override the default Cutter Vacuum or Laser Blower pin
3487 #endif
3489 //#define AIR_ASSIST // Air Assist control with G-codes M8-M9
3490 #if ENABLED(AIR_ASSIST)
3491 #define AIR_ASSIST_ACTIVE LOW // Active state on air assist pin
3492 //#define AIR_ASSIST_PIN 44 // Override the default Air Assist pin
3493 #endif
3495 //#define SPINDLE_SERVO // A servo converting an angle to spindle power
3496 #ifdef SPINDLE_SERVO
3497 #define SPINDLE_SERVO_NR 0 // Index of servo used for spindle control
3498 #define SPINDLE_SERVO_MIN 10 // Minimum angle for servo spindle
3499 #endif
3502 * Speed / Power can be set ('M3 S') and displayed in terms of:
3503 * - PWM255 (S0 - S255)
3504 * - PERCENT (S0 - S100)
3505 * - RPM (S0 - S50000) Best for use with a spindle
3506 * - SERVO (S0 - S180)
3508 #define CUTTER_POWER_UNIT PWM255
3511 * Relative Cutter Power
3512 * Normally, 'M3 O<power>' sets
3513 * OCR power is relative to the range SPEED_POWER_MIN...SPEED_POWER_MAX.
3514 * so input powers of 0...255 correspond to SPEED_POWER_MIN...SPEED_POWER_MAX
3515 * instead of normal range (0 to SPEED_POWER_MAX).
3516 * Best used with (e.g.) SuperPID router controller: S0 = 5,000 RPM and S255 = 30,000 RPM
3518 //#define CUTTER_POWER_RELATIVE // Set speed proportional to [SPEED_POWER_MIN...SPEED_POWER_MAX]
3520 #if ENABLED(SPINDLE_FEATURE)
3521 //#define SPINDLE_CHANGE_DIR // Enable if your spindle controller can change spindle direction
3522 #define SPINDLE_CHANGE_DIR_STOP // Enable if the spindle should stop before changing spin direction
3523 #define SPINDLE_INVERT_DIR false // Set to "true" if the spin direction is reversed
3525 #define SPINDLE_LASER_POWERUP_DELAY 5000 // (ms) Delay to allow the spindle/laser to come up to speed/power
3526 #define SPINDLE_LASER_POWERDOWN_DELAY 5000 // (ms) Delay to allow the spindle to stop
3529 * M3/M4 Power Equation
3531 * Each tool uses different value ranges for speed / power control.
3532 * These parameters are used to convert between tool power units and PWM.
3534 * Speed/Power = (PWMDC / 255 * 100 - SPEED_POWER_INTERCEPT) / SPEED_POWER_SLOPE
3535 * PWMDC = (spdpwr - SPEED_POWER_MIN) / (SPEED_POWER_MAX - SPEED_POWER_MIN) / SPEED_POWER_SLOPE
3537 #if ENABLED(SPINDLE_LASER_USE_PWM)
3538 #define SPEED_POWER_INTERCEPT 0 // (%) 0-100 i.e., Minimum power percentage
3539 #define SPEED_POWER_MIN 5000 // (RPM)
3540 #define SPEED_POWER_MAX 30000 // (RPM) SuperPID router controller 0 - 30,000 RPM
3541 #define SPEED_POWER_STARTUP 25000 // (RPM) M3/M4 speed/power default (with no arguments)
3542 #endif
3544 #else
3546 #if ENABLED(SPINDLE_LASER_USE_PWM)
3547 #define SPEED_POWER_INTERCEPT 0 // (%) 0-100 i.e., Minimum power percentage
3548 #define SPEED_POWER_MIN 0 // (%) 0-100
3549 #define SPEED_POWER_MAX 100 // (%) 0-100
3550 #define SPEED_POWER_STARTUP 80 // (%) M3/M4 speed/power default (with no arguments)
3551 #endif
3553 // Define the minimum and maximum test pulse time values for a laser test fire function
3554 #define LASER_TEST_PULSE_MIN 1 // (ms) Used with Laser Control Menu
3555 #define LASER_TEST_PULSE_MAX 999 // (ms) Caution: Menu may not show more than 3 characters
3557 #define SPINDLE_LASER_POWERUP_DELAY 50 // (ms) Delay to allow the spindle/laser to come up to speed/power
3558 #define SPINDLE_LASER_POWERDOWN_DELAY 50 // (ms) Delay to allow the spindle to stop
3561 * Laser Safety Timeout
3563 * The laser should be turned off when there is no movement for a period of time.
3564 * Consider material flammability, cut rate, and G-code order when setting this
3565 * value. Too low and it could turn off during a very slow move; too high and
3566 * the material could ignite.
3568 #define LASER_SAFETY_TIMEOUT_MS 1000 // (ms)
3571 * Any M3 or G1/2/3/5 command with the 'I' parameter enables continuous inline power mode.
3573 * e.g., 'M3 I' enables continuous inline power which is processed by the planner.
3574 * Power is stored in move blocks and applied when blocks are processed by the Stepper ISR.
3576 * 'M4 I' sets dynamic mode which uses the current feedrate to calculate a laser power OCR value.
3578 * Any move in dynamic mode will use the current feedrate to calculate the laser power.
3579 * Feed rates are set by the F parameter of a move command e.g. G1 X0 Y10 F6000
3580 * Laser power would be calculated by bit shifting off 8 LSB's. In binary this is div 256.
3581 * The calculation gives us ocr values from 0 to 255, values over F65535 will be set as 255 .
3582 * More refined power control such as compesation for accell/decell will be addressed in future releases.
3584 * M5 I clears inline mode and set power to 0, M5 sets the power output to 0 but leaves inline mode on.
3588 * Enable M3 commands for laser mode inline power planner syncing.
3589 * This feature enables any M3 S-value to be injected into the block buffers while in
3590 * CUTTER_MODE_CONTINUOUS. The option allows M3 laser power to be commited without waiting
3591 * for a planner syncronization
3593 //#define LASER_POWER_SYNC
3596 * Scale the laser's power in proportion to the movement rate.
3598 * - Sets the entry power proportional to the entry speed over the nominal speed.
3599 * - Ramps the power up every N steps to approximate the speed trapezoid.
3600 * - Due to the limited power resolution this is only approximate.
3602 //#define LASER_POWER_TRAP
3605 // Laser I2C Ammeter (High precision INA226 low/high side module)
3607 //#define I2C_AMMETER
3608 #if ENABLED(I2C_AMMETER)
3609 #define I2C_AMMETER_IMAX 0.1 // (Amps) Calibration value for the expected current range
3610 #define I2C_AMMETER_SHUNT_RESISTOR 0.1 // (Ohms) Calibration shunt resistor value
3611 #endif
3614 // Laser Coolant Flow Meter
3616 //#define LASER_COOLANT_FLOW_METER
3617 #if ENABLED(LASER_COOLANT_FLOW_METER)
3618 #define FLOWMETER_PIN 20 // Requires an external interrupt-enabled pin (e.g., RAMPS 2,3,18,19,20,21)
3619 #define FLOWMETER_PPL 5880 // (pulses/liter) Flow meter pulses-per-liter on the input pin
3620 #define FLOWMETER_INTERVAL 1000 // (ms) Flow rate calculation interval in milliseconds
3621 #define FLOWMETER_SAFETY // Prevent running the laser without the minimum flow rate set below
3622 #if ENABLED(FLOWMETER_SAFETY)
3623 #define FLOWMETER_MIN_LITERS_PER_MINUTE 1.5 // (liters/min) Minimum flow required when enabled
3624 #endif
3625 #endif
3627 #endif
3628 #endif // SPINDLE_FEATURE || LASER_FEATURE
3631 * Synchronous Laser Control with M106/M107
3633 * Marlin normally applies M106/M107 fan speeds at a time "soon after" processing
3634 * a planner block. This is too inaccurate for a PWM/TTL laser attached to the fan
3635 * header (as with some add-on laser kits). Enable this option to set fan/laser
3636 * speeds with much more exact timing for improved print fidelity.
3638 * NOTE: This option sacrifices some cooling fan speed options.
3640 //#define LASER_SYNCHRONOUS_M106_M107
3643 * Coolant Control
3645 * Add the M7, M8, and M9 commands to turn mist or flood coolant on and off.
3647 * Note: COOLANT_MIST_PIN and/or COOLANT_FLOOD_PIN must also be defined.
3649 //#define COOLANT_CONTROL
3650 #if ENABLED(COOLANT_CONTROL)
3651 #define COOLANT_MIST // Enable if mist coolant is present
3652 #define COOLANT_FLOOD // Enable if flood coolant is present
3653 #define COOLANT_MIST_INVERT false // Set "true" if the on/off function is reversed
3654 #define COOLANT_FLOOD_INVERT false // Set "true" if the on/off function is reversed
3655 #endif
3658 * Filament Width Sensor
3660 * Measures the filament width in real-time and adjusts
3661 * flow rate to compensate for any irregularities.
3663 * Also allows the measured filament diameter to set the
3664 * extrusion rate, so the slicer only has to specify the
3665 * volume.
3667 * Only a single extruder is supported at this time.
3669 * 34 RAMPS_14 : Analog input 5 on the AUX2 connector
3670 * 81 PRINTRBOARD : Analog input 2 on the Exp1 connector (version B,C,D,E)
3671 * 301 RAMBO : Analog input 3
3673 * Note: May require analog pins to be defined for other boards.
3675 //#define FILAMENT_WIDTH_SENSOR
3677 #if ENABLED(FILAMENT_WIDTH_SENSOR)
3678 #define FILAMENT_SENSOR_EXTRUDER_NUM 0 // Index of the extruder that has the filament sensor. :[0,1,2,3,4]
3679 #define MEASUREMENT_DELAY_CM 14 // (cm) The distance from the filament sensor to the melting chamber
3681 #define FILWIDTH_ERROR_MARGIN 1.0 // (mm) If a measurement differs too much from nominal width ignore it
3682 #define MAX_MEASUREMENT_DELAY 20 // (bytes) Buffer size for stored measurements (1 byte per cm). Must be larger than MEASUREMENT_DELAY_CM.
3684 #define DEFAULT_MEASURED_FILAMENT_DIA DEFAULT_NOMINAL_FILAMENT_DIA // Set measured to nominal initially
3686 // Display filament width on the LCD status line. Status messages will expire after 5 seconds.
3687 //#define FILAMENT_LCD_DISPLAY
3688 #endif
3691 * Power Monitor
3692 * Monitor voltage (V) and/or current (A), and -when possible- power (W)
3694 * Read and configure with M430
3696 * The current sensor feeds DC voltage (relative to the measured current) to an analog pin
3697 * The voltage sensor feeds DC voltage (relative to the measured voltage) to an analog pin
3699 //#define POWER_MONITOR_CURRENT // Monitor the system current
3700 //#define POWER_MONITOR_VOLTAGE // Monitor the system voltage
3702 #if ENABLED(POWER_MONITOR_CURRENT)
3703 #define POWER_MONITOR_VOLTS_PER_AMP 0.05000 // Input voltage to the MCU analog pin per amp - DO NOT apply more than ADC_VREF!
3704 #define POWER_MONITOR_CURRENT_OFFSET 0 // Offset (in amps) applied to the calculated current
3705 #define POWER_MONITOR_FIXED_VOLTAGE 13.6 // Voltage for a current sensor with no voltage sensor (for power display)
3706 #endif
3708 #if ENABLED(POWER_MONITOR_VOLTAGE)
3709 #define POWER_MONITOR_VOLTS_PER_VOLT 0.077933 // Input voltage to the MCU analog pin per volt - DO NOT apply more than ADC_VREF!
3710 #define POWER_MONITOR_VOLTAGE_OFFSET 0 // Offset (in volts) applied to the calculated voltage
3711 #endif
3714 * Stepper Driver Anti-SNAFU Protection
3716 * If the SAFE_POWER_PIN is defined for your board, Marlin will check
3717 * that stepper drivers are properly plugged in before applying power.
3718 * Disable protection if your stepper drivers don't support the feature.
3720 //#define DISABLE_DRIVER_SAFE_POWER_PROTECT
3723 * CNC Coordinate Systems
3725 * Enables G53 and G54-G59.3 commands to select coordinate systems
3726 * and G92.1 to reset the workspace to native machine space.
3728 //#define CNC_COORDINATE_SYSTEMS
3731 * Auto-report fan speed with M123 S<seconds>
3732 * Requires fans with tachometer pins
3734 //#define AUTO_REPORT_FANS
3737 * Auto-report temperatures with M155 S<seconds>
3739 #define AUTO_REPORT_TEMPERATURES
3740 #if ENABLED(AUTO_REPORT_TEMPERATURES) && TEMP_SENSOR_REDUNDANT
3741 //#define AUTO_REPORT_REDUNDANT // Include the "R" sensor in the auto-report
3742 #endif
3745 * Auto-report position with M154 S<seconds>
3747 //#define AUTO_REPORT_POSITION
3750 * Include capabilities in M115 output
3752 #define EXTENDED_CAPABILITIES_REPORT
3753 #if ENABLED(EXTENDED_CAPABILITIES_REPORT)
3754 //#define M115_GEOMETRY_REPORT
3755 #endif
3758 * Expected Printer Check
3759 * Add the M16 G-code to compare a string to the MACHINE_NAME.
3760 * M16 with a non-matching string causes the printer to halt.
3762 //#define EXPECTED_PRINTER_CHECK
3765 * Disable all Volumetric extrusion options
3767 //#define NO_VOLUMETRICS
3769 #if DISABLED(NO_VOLUMETRICS)
3771 * Volumetric extrusion default state
3772 * Activate to make volumetric extrusion the default method,
3773 * with DEFAULT_NOMINAL_FILAMENT_DIA as the default diameter.
3775 * M200 D0 to disable, M200 Dn to set a new diameter (and enable volumetric).
3776 * M200 S0/S1 to disable/enable volumetric extrusion.
3778 //#define VOLUMETRIC_DEFAULT_ON
3780 //#define VOLUMETRIC_EXTRUDER_LIMIT
3781 #if ENABLED(VOLUMETRIC_EXTRUDER_LIMIT)
3783 * Default volumetric extrusion limit in cubic mm per second (mm^3/sec).
3784 * This factory setting applies to all extruders.
3785 * Use 'M200 [T<extruder>] L<limit>' to override and 'M502' to reset.
3786 * A non-zero value activates Volume-based Extrusion Limiting.
3788 #define DEFAULT_VOLUMETRIC_EXTRUDER_LIMIT 0.00 // (mm^3/sec)
3789 #endif
3790 #endif
3793 * Enable this option for a leaner build of Marlin that removes all
3794 * workspace offsets, simplifying coordinate transformations, leveling, etc.
3796 * - M206 and M428 are disabled.
3797 * - G92 will revert to its behavior from Marlin 1.0.
3799 //#define NO_WORKSPACE_OFFSETS
3801 // Extra options for the M114 "Current Position" report
3802 //#define M114_DETAIL // Use 'M114` for details to check planner calculations
3803 //#define M114_REALTIME // Real current position based on forward kinematics
3804 //#define M114_LEGACY // M114 used to synchronize on every call. Enable if needed.
3806 //#define REPORT_FAN_CHANGE // Report the new fan speed when changed by M106 (and others)
3809 * Spend 28 bytes of SRAM to optimize the G-code parser
3811 #define FASTER_GCODE_PARSER
3813 #if ENABLED(FASTER_GCODE_PARSER)
3814 //#define GCODE_QUOTED_STRINGS // Support for quoted string parameters
3815 #endif
3817 // Support for MeatPack G-code compression (https://github.com/scottmudge/OctoPrint-MeatPack)
3818 //#define MEATPACK_ON_SERIAL_PORT_1
3819 //#define MEATPACK_ON_SERIAL_PORT_2
3821 //#define GCODE_CASE_INSENSITIVE // Accept G-code sent to the firmware in lowercase
3823 //#define REPETIER_GCODE_M360 // Add commands originally from Repetier FW
3826 * CNC G-code options
3827 * Support CNC-style G-code dialects used by laser cutters, drawing machine cams, etc.
3828 * Note that G0 feedrates should be used with care for 3D printing (if used at all).
3829 * High feedrates may cause ringing and harm print quality.
3831 //#define PAREN_COMMENTS // Support for parentheses-delimited comments
3832 //#define GCODE_MOTION_MODES // Remember the motion mode (G0 G1 G2 G3 G5 G38.X) and apply for X Y Z E F, etc.
3834 // Enable and set a (default) feedrate for all G0 moves
3835 //#define G0_FEEDRATE 3000 // (mm/min)
3836 #ifdef G0_FEEDRATE
3837 //#define VARIABLE_G0_FEEDRATE // The G0 feedrate is set by F in G0 motion mode
3838 #endif
3841 * Startup commands
3843 * Execute certain G-code commands immediately after power-on.
3845 //#define STARTUP_COMMANDS "M17 Z"
3848 * G-code Macros
3850 * Add G-codes M810-M819 to define and run G-code macros.
3851 * Macros are not saved to EEPROM.
3853 //#define GCODE_MACROS
3854 #if ENABLED(GCODE_MACROS)
3855 #define GCODE_MACROS_SLOTS 5 // Up to 10 may be used
3856 #define GCODE_MACROS_SLOT_SIZE 50 // Maximum length of a single macro
3857 #endif
3860 * User-defined menu items to run custom G-code.
3861 * Up to 25 may be defined, but the actual number is LCD-dependent.
3864 // Custom Menu: Main Menu
3865 //#define CUSTOM_MENU_MAIN
3866 #if ENABLED(CUSTOM_MENU_MAIN)
3867 //#define CUSTOM_MENU_MAIN_TITLE "Custom Commands"
3868 #define CUSTOM_MENU_MAIN_SCRIPT_DONE "M117 User Script Done"
3869 #define CUSTOM_MENU_MAIN_SCRIPT_AUDIBLE_FEEDBACK
3870 //#define CUSTOM_MENU_MAIN_SCRIPT_RETURN // Return to status screen after a script
3871 #define CUSTOM_MENU_MAIN_ONLY_IDLE // Only show custom menu when the machine is idle
3873 #define MAIN_MENU_ITEM_1_DESC "Home & UBL Info"
3874 #define MAIN_MENU_ITEM_1_GCODE "G28\nG29 W"
3875 //#define MAIN_MENU_ITEM_1_CONFIRM // Show a confirmation dialog before this action
3877 #define MAIN_MENU_ITEM_2_DESC "Preheat for " PREHEAT_1_LABEL
3878 #define MAIN_MENU_ITEM_2_GCODE "M140 S" STRINGIFY(PREHEAT_1_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_1_TEMP_HOTEND)
3879 //#define MAIN_MENU_ITEM_2_CONFIRM
3881 //#define MAIN_MENU_ITEM_3_DESC "Preheat for " PREHEAT_2_LABEL
3882 //#define MAIN_MENU_ITEM_3_GCODE "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_2_TEMP_HOTEND)
3883 //#define MAIN_MENU_ITEM_3_CONFIRM
3885 //#define MAIN_MENU_ITEM_4_DESC "Heat Bed/Home/Level"
3886 //#define MAIN_MENU_ITEM_4_GCODE "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nG28\nG29"
3887 //#define MAIN_MENU_ITEM_4_CONFIRM
3889 //#define MAIN_MENU_ITEM_5_DESC "Home & Info"
3890 //#define MAIN_MENU_ITEM_5_GCODE "G28\nM503"
3891 //#define MAIN_MENU_ITEM_5_CONFIRM
3892 #endif
3894 // Custom Menu: Configuration Menu
3895 //#define CUSTOM_MENU_CONFIG
3896 #if ENABLED(CUSTOM_MENU_CONFIG)
3897 //#define CUSTOM_MENU_CONFIG_TITLE "Custom Commands"
3898 #define CUSTOM_MENU_CONFIG_SCRIPT_DONE "M117 Wireless Script Done"
3899 #define CUSTOM_MENU_CONFIG_SCRIPT_AUDIBLE_FEEDBACK
3900 //#define CUSTOM_MENU_CONFIG_SCRIPT_RETURN // Return to status screen after a script
3901 #define CUSTOM_MENU_CONFIG_ONLY_IDLE // Only show custom menu when the machine is idle
3903 #define CONFIG_MENU_ITEM_1_DESC "Wifi ON"
3904 #define CONFIG_MENU_ITEM_1_GCODE "M118 [ESP110] WIFI-STA pwd=12345678"
3905 //#define CONFIG_MENU_ITEM_1_CONFIRM // Show a confirmation dialog before this action
3907 #define CONFIG_MENU_ITEM_2_DESC "Bluetooth ON"
3908 #define CONFIG_MENU_ITEM_2_GCODE "M118 [ESP110] BT pwd=12345678"
3909 //#define CONFIG_MENU_ITEM_2_CONFIRM
3911 //#define CONFIG_MENU_ITEM_3_DESC "Radio OFF"
3912 //#define CONFIG_MENU_ITEM_3_GCODE "M118 [ESP110] OFF pwd=12345678"
3913 //#define CONFIG_MENU_ITEM_3_CONFIRM
3915 //#define CONFIG_MENU_ITEM_4_DESC "Wifi ????"
3916 //#define CONFIG_MENU_ITEM_4_GCODE "M118 ????"
3917 //#define CONFIG_MENU_ITEM_4_CONFIRM
3919 //#define CONFIG_MENU_ITEM_5_DESC "Wifi ????"
3920 //#define CONFIG_MENU_ITEM_5_GCODE "M118 ????"
3921 //#define CONFIG_MENU_ITEM_5_CONFIRM
3922 #endif
3925 * User-defined buttons to run custom G-code.
3926 * Up to 25 may be defined.
3928 //#define CUSTOM_USER_BUTTONS
3929 #if ENABLED(CUSTOM_USER_BUTTONS)
3930 //#define BUTTON1_PIN -1
3931 #if PIN_EXISTS(BUTTON1)
3932 #define BUTTON1_HIT_STATE LOW // State of the triggered button. NC=LOW. NO=HIGH.
3933 #define BUTTON1_WHEN_PRINTING false // Button allowed to trigger during printing?
3934 #define BUTTON1_GCODE "G28"
3935 #define BUTTON1_DESC "Homing" // Optional string to set the LCD status
3936 #endif
3938 //#define BUTTON2_PIN -1
3939 #if PIN_EXISTS(BUTTON2)
3940 #define BUTTON2_HIT_STATE LOW
3941 #define BUTTON2_WHEN_PRINTING false
3942 #define BUTTON2_GCODE "M140 S" STRINGIFY(PREHEAT_1_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_1_TEMP_HOTEND)
3943 #define BUTTON2_DESC "Preheat for " PREHEAT_1_LABEL
3944 #endif
3946 //#define BUTTON3_PIN -1
3947 #if PIN_EXISTS(BUTTON3)
3948 #define BUTTON3_HIT_STATE LOW
3949 #define BUTTON3_WHEN_PRINTING false
3950 #define BUTTON3_GCODE "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_2_TEMP_HOTEND)
3951 #define BUTTON3_DESC "Preheat for " PREHEAT_2_LABEL
3952 #endif
3953 #endif
3956 * Host Action Commands
3958 * Define host streamer action commands in compliance with the standard.
3960 * See https://reprap.org/wiki/G-code#Action_commands
3961 * Common commands ........ poweroff, pause, paused, resume, resumed, cancel
3962 * G29_RETRY_AND_RECOVER .. probe_rewipe, probe_failed
3964 * Some features add reason codes to extend these commands.
3966 * Host Prompt Support enables Marlin to use the host for user prompts so
3967 * filament runout and other processes can be managed from the host side.
3969 //#define HOST_ACTION_COMMANDS
3970 #if ENABLED(HOST_ACTION_COMMANDS)
3971 //#define HOST_PAUSE_M76 // Tell the host to pause in response to M76
3972 //#define HOST_PROMPT_SUPPORT // Initiate host prompts to get user feedback
3973 #if ENABLED(HOST_PROMPT_SUPPORT)
3974 //#define HOST_STATUS_NOTIFICATIONS // Send some status messages to the host as notifications
3975 #endif
3976 //#define HOST_START_MENU_ITEM // Add a menu item that tells the host to start
3977 //#define HOST_SHUTDOWN_MENU_ITEM // Add a menu item that tells the host to shut down
3978 #endif
3981 * Cancel Objects
3983 * Implement M486 to allow Marlin to skip objects
3985 //#define CANCEL_OBJECTS
3986 #if ENABLED(CANCEL_OBJECTS)
3987 #define CANCEL_OBJECTS_REPORTING // Emit the current object as a status message
3988 #endif
3991 * I2C position encoders for closed loop control.
3992 * Developed by Chris Barr at Aus3D.
3994 * Wiki: https://wiki.aus3d.com.au/Magnetic_Encoder
3995 * Github: https://github.com/Aus3D/MagneticEncoder
3997 * Supplier: https://aus3d.com.au/magnetic-encoder-module
3998 * Alternative Supplier: https://reliabuild3d.com/
4000 * Reliabuild encoders have been modified to improve reliability.
4003 //#define I2C_POSITION_ENCODERS
4004 #if ENABLED(I2C_POSITION_ENCODERS)
4006 #define I2CPE_ENCODER_CNT 1 // The number of encoders installed; max of 5
4007 // encoders supported currently.
4009 #define I2CPE_ENC_1_ADDR I2CPE_PRESET_ADDR_X // I2C address of the encoder. 30-200.
4010 #define I2CPE_ENC_1_AXIS X_AXIS // Axis the encoder module is installed on. <X|Y|Z|E>_AXIS.
4011 #define I2CPE_ENC_1_TYPE I2CPE_ENC_TYPE_LINEAR // Type of encoder: I2CPE_ENC_TYPE_LINEAR -or-
4012 // I2CPE_ENC_TYPE_ROTARY.
4013 #define I2CPE_ENC_1_TICKS_UNIT 2048 // 1024 for magnetic strips with 2mm poles; 2048 for
4014 // 1mm poles. For linear encoders this is ticks / mm,
4015 // for rotary encoders this is ticks / revolution.
4016 //#define I2CPE_ENC_1_TICKS_REV (16 * 200) // Only needed for rotary encoders; number of stepper
4017 // steps per full revolution (motor steps/rev * microstepping)
4018 //#define I2CPE_ENC_1_INVERT // Invert the direction of axis travel.
4019 #define I2CPE_ENC_1_EC_METHOD I2CPE_ECM_MICROSTEP // Type of error error correction.
4020 #define I2CPE_ENC_1_EC_THRESH 0.10 // Threshold size for error (in mm) above which the
4021 // printer will attempt to correct the error; errors
4022 // smaller than this are ignored to minimize effects of
4023 // measurement noise / latency (filter).
4025 #define I2CPE_ENC_2_ADDR I2CPE_PRESET_ADDR_Y // Same as above, but for encoder 2.
4026 #define I2CPE_ENC_2_AXIS Y_AXIS
4027 #define I2CPE_ENC_2_TYPE I2CPE_ENC_TYPE_LINEAR
4028 #define I2CPE_ENC_2_TICKS_UNIT 2048
4029 //#define I2CPE_ENC_2_TICKS_REV (16 * 200)
4030 //#define I2CPE_ENC_2_INVERT
4031 #define I2CPE_ENC_2_EC_METHOD I2CPE_ECM_MICROSTEP
4032 #define I2CPE_ENC_2_EC_THRESH 0.10
4034 #define I2CPE_ENC_3_ADDR I2CPE_PRESET_ADDR_Z // Encoder 3. Add additional configuration options
4035 #define I2CPE_ENC_3_AXIS Z_AXIS // as above, or use defaults below.
4037 #define I2CPE_ENC_4_ADDR I2CPE_PRESET_ADDR_E // Encoder 4.
4038 #define I2CPE_ENC_4_AXIS E_AXIS
4040 #define I2CPE_ENC_5_ADDR 34 // Encoder 5.
4041 #define I2CPE_ENC_5_AXIS E_AXIS
4043 // Default settings for encoders which are enabled, but without settings configured above.
4044 #define I2CPE_DEF_TYPE I2CPE_ENC_TYPE_LINEAR
4045 #define I2CPE_DEF_ENC_TICKS_UNIT 2048
4046 #define I2CPE_DEF_TICKS_REV (16 * 200)
4047 #define I2CPE_DEF_EC_METHOD I2CPE_ECM_NONE
4048 #define I2CPE_DEF_EC_THRESH 0.1
4050 //#define I2CPE_ERR_THRESH_ABORT 100.0 // Threshold size for error (in mm) error on any given
4051 // axis after which the printer will abort. Comment out to
4052 // disable abort behavior.
4054 #define I2CPE_TIME_TRUSTED 10000 // After an encoder fault, there must be no further fault
4055 // for this amount of time (in ms) before the encoder
4056 // is trusted again.
4059 * Position is checked every time a new command is executed from the buffer but during long moves,
4060 * this setting determines the minimum update time between checks. A value of 100 works well with
4061 * error rolling average when attempting to correct only for skips and not for vibration.
4063 #define I2CPE_MIN_UPD_TIME_MS 4 // (ms) Minimum time between encoder checks.
4065 // Use a rolling average to identify persistent errors that indicate skips, as opposed to vibration and noise.
4066 #define I2CPE_ERR_ROLLING_AVERAGE
4068 #endif // I2C_POSITION_ENCODERS
4071 * Analog Joystick(s)
4073 //#define JOYSTICK
4074 #if ENABLED(JOYSTICK)
4075 #define JOY_X_PIN 5 // RAMPS: Suggested pin A5 on AUX2
4076 #define JOY_Y_PIN 10 // RAMPS: Suggested pin A10 on AUX2
4077 #define JOY_Z_PIN 12 // RAMPS: Suggested pin A12 on AUX2
4078 #define JOY_EN_PIN 44 // RAMPS: Suggested pin D44 on AUX2
4080 //#define INVERT_JOY_X // Enable if X direction is reversed
4081 //#define INVERT_JOY_Y // Enable if Y direction is reversed
4082 //#define INVERT_JOY_Z // Enable if Z direction is reversed
4084 // Use M119 with JOYSTICK_DEBUG to find reasonable values after connecting:
4085 #define JOY_X_LIMITS { 5600, 8190-100, 8190+100, 10800 } // min, deadzone start, deadzone end, max
4086 #define JOY_Y_LIMITS { 5600, 8250-100, 8250+100, 11000 }
4087 #define JOY_Z_LIMITS { 4800, 8080-100, 8080+100, 11550 }
4088 //#define JOYSTICK_DEBUG
4089 #endif
4092 * Mechanical Gantry Calibration
4093 * Modern replacement for the Prusa TMC_Z_CALIBRATION.
4094 * Adds capability to work with any adjustable current drivers.
4095 * Implemented as G34 because M915 is deprecated.
4097 //#define MECHANICAL_GANTRY_CALIBRATION
4098 #if ENABLED(MECHANICAL_GANTRY_CALIBRATION)
4099 #define GANTRY_CALIBRATION_CURRENT 600 // Default calibration current in ma
4100 #define GANTRY_CALIBRATION_EXTRA_HEIGHT 15 // Extra distance in mm past Z_###_POS to move
4101 #define GANTRY_CALIBRATION_FEEDRATE 500 // Feedrate for correction move
4102 //#define GANTRY_CALIBRATION_TO_MIN // Enable to calibrate Z in the MIN direction
4104 //#define GANTRY_CALIBRATION_SAFE_POSITION XY_CENTER // Safe position for nozzle
4105 //#define GANTRY_CALIBRATION_XY_PARK_FEEDRATE 3000 // XY Park Feedrate - MMM
4106 //#define GANTRY_CALIBRATION_COMMANDS_PRE ""
4107 #define GANTRY_CALIBRATION_COMMANDS_POST "G28" // G28 highly recommended to ensure an accurate position
4108 #endif
4111 * Instant freeze / unfreeze functionality
4112 * Potentially useful for emergency stop that allows being resumed.
4114 //#define FREEZE_FEATURE
4115 #if ENABLED(FREEZE_FEATURE)
4116 //#define FREEZE_PIN 41 // Override the default (KILL) pin here
4117 #define FREEZE_STATE LOW // State of pin indicating freeze
4118 #endif
4121 * MAX7219 Debug Matrix
4123 * Add support for a low-cost 8x8 LED Matrix based on the Max7219 chip as a realtime status display.
4124 * Requires 3 signal wires. Some useful debug options are included to demonstrate its usage.
4126 //#define MAX7219_DEBUG
4127 #if ENABLED(MAX7219_DEBUG)
4128 #define MAX7219_CLK_PIN 64
4129 #define MAX7219_DIN_PIN 57
4130 #define MAX7219_LOAD_PIN 44
4132 //#define MAX7219_GCODE // Add the M7219 G-code to control the LED matrix
4133 #define MAX7219_INIT_TEST 2 // Test pattern at startup: 0=none, 1=sweep, 2=spiral
4134 #define MAX7219_NUMBER_UNITS 1 // Number of Max7219 units in chain.
4135 #define MAX7219_ROTATE 0 // Rotate the display clockwise (in multiples of +/- 90°)
4136 // connector at: right=0 bottom=-90 top=90 left=180
4137 //#define MAX7219_REVERSE_ORDER // The individual LED matrix units may be in reversed order
4138 //#define MAX7219_SIDE_BY_SIDE // Big chip+matrix boards can be chained side-by-side
4141 * Sample debug features
4142 * If you add more debug displays, be careful to avoid conflicts!
4144 #define MAX7219_DEBUG_PRINTER_ALIVE // Blink corner LED of 8x8 matrix to show that the firmware is functioning
4145 #define MAX7219_DEBUG_PLANNER_HEAD 3 // Show the planner queue head position on this and the next LED matrix row
4146 #define MAX7219_DEBUG_PLANNER_TAIL 5 // Show the planner queue tail position on this and the next LED matrix row
4148 #define MAX7219_DEBUG_PLANNER_QUEUE 0 // Show the current planner queue depth on this and the next LED matrix row
4149 // If you experience stuttering, reboots, etc. this option can reveal how
4150 // tweaks made to the configuration are affecting the printer in real-time.
4151 #endif
4154 * NanoDLP Sync support
4156 * Support for Synchronized Z moves when used with NanoDLP. G0/G1 axis moves will
4157 * output a "Z_move_comp" string to enable synchronization with DLP projector exposure.
4158 * This feature allows you to use [[WaitForDoneMessage]] instead of M400 commands.
4160 //#define NANODLP_Z_SYNC
4161 #if ENABLED(NANODLP_Z_SYNC)
4162 //#define NANODLP_ALL_AXIS // Send a "Z_move_comp" report for any axis move (not just Z).
4163 #endif
4166 * Ethernet. Use M552 to enable and set the IP address.
4168 #if HAS_ETHERNET
4169 #define MAC_ADDRESS { 0xDE, 0xAD, 0xBE, 0xEF, 0xF0, 0x0D } // A MAC address unique to your network
4170 #endif
4173 * WiFi Support (Espressif ESP32 WiFi)
4175 //#define WIFISUPPORT // Marlin embedded WiFi managenent
4176 //#define ESP3D_WIFISUPPORT // ESP3D Library WiFi management (https://github.com/luc-github/ESP3DLib)
4178 #if EITHER(WIFISUPPORT, ESP3D_WIFISUPPORT)
4179 //#define WEBSUPPORT // Start a webserver (which may include auto-discovery)
4180 //#define OTASUPPORT // Support over-the-air firmware updates
4181 //#define WIFI_CUSTOM_COMMAND // Accept feature config commands (e.g., WiFi ESP3D) from the host
4184 * To set a default WiFi SSID / Password, create a file called Configuration_Secure.h with
4185 * the following defines, customized for your network. This specific file is excluded via
4186 * .gitignore to prevent it from accidentally leaking to the public.
4188 * #define WIFI_SSID "WiFi SSID"
4189 * #define WIFI_PWD "WiFi Password"
4191 //#include "Configuration_Secure.h" // External file with WiFi SSID / Password
4192 #endif
4195 * Průša Multi-Material Unit (MMU)
4196 * Enable in Configuration.h
4198 * These devices allow a single stepper driver on the board to drive
4199 * multi-material feeders with any number of stepper motors.
4201 #if HAS_PRUSA_MMU1
4203 * This option only allows the multiplexer to switch on tool-change.
4204 * Additional options to configure custom E moves are pending.
4206 * Override the default DIO selector pins here, if needed.
4207 * Some pins files may provide defaults for these pins.
4209 //#define E_MUX0_PIN 40 // Always Required
4210 //#define E_MUX1_PIN 42 // Needed for 3 to 8 inputs
4211 //#define E_MUX2_PIN 44 // Needed for 5 to 8 inputs
4212 #elif HAS_PRUSA_MMU2
4213 // Serial port used for communication with MMU2.
4214 #define MMU2_SERIAL_PORT 2
4216 // Use hardware reset for MMU if a pin is defined for it
4217 //#define MMU2_RST_PIN 23
4219 // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
4220 //#define MMU2_MODE_12V
4222 // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
4223 #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
4225 // Add an LCD menu for MMU2
4226 //#define MMU2_MENUS
4227 #if EITHER(MMU2_MENUS, HAS_PRUSA_MMU2S)
4228 // Settings for filament load / unload from the LCD menu.
4229 // This is for Průša MK3-style extruders. Customize for your hardware.
4230 #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
4231 #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
4232 { 7.2, 1145 }, \
4233 { 14.4, 871 }, \
4234 { 36.0, 1393 }, \
4235 { 14.4, 871 }, \
4236 { 50.0, 198 }
4238 #define MMU2_RAMMING_SEQUENCE \
4239 { 1.0, 1000 }, \
4240 { 1.0, 1500 }, \
4241 { 2.0, 2000 }, \
4242 { 1.5, 3000 }, \
4243 { 2.5, 4000 }, \
4244 { -15.0, 5000 }, \
4245 { -14.0, 1200 }, \
4246 { -6.0, 600 }, \
4247 { 10.0, 700 }, \
4248 { -10.0, 400 }, \
4249 { -50.0, 2000 }
4250 #endif
4253 * Using a sensor like the MMU2S
4254 * This mode requires a MK3S extruder with a sensor at the extruder idler, like the MMU2S.
4255 * See https://help.prusa3d.com/en/guide/3b-mk3s-mk2-5s-extruder-upgrade_41560, step 11
4257 #if HAS_PRUSA_MMU2S
4258 #define MMU2_C0_RETRY 5 // Number of retries (total time = timeout*retries)
4260 #define MMU2_CAN_LOAD_FEEDRATE 800 // (mm/min)
4261 #define MMU2_CAN_LOAD_SEQUENCE \
4262 { 0.1, MMU2_CAN_LOAD_FEEDRATE }, \
4263 { 60.0, MMU2_CAN_LOAD_FEEDRATE }, \
4264 { -52.0, MMU2_CAN_LOAD_FEEDRATE }
4266 #define MMU2_CAN_LOAD_RETRACT 6.0 // (mm) Keep under the distance between Load Sequence values
4267 #define MMU2_CAN_LOAD_DEVIATION 0.8 // (mm) Acceptable deviation
4269 #define MMU2_CAN_LOAD_INCREMENT 0.2 // (mm) To reuse within MMU2 module
4270 #define MMU2_CAN_LOAD_INCREMENT_SEQUENCE \
4271 { -MMU2_CAN_LOAD_INCREMENT, MMU2_CAN_LOAD_FEEDRATE }
4273 #else
4276 * MMU1 Extruder Sensor
4278 * Support for a Průša (or other) IR Sensor to detect filament near the extruder
4279 * and make loading more reliable. Suitable for an extruder equipped with a filament
4280 * sensor less than 38mm from the gears.
4282 * During loading the extruder will stop when the sensor is triggered, then do a last
4283 * move up to the gears. If no filament is detected, the MMU2 can make some more attempts.
4284 * If all attempts fail, a filament runout will be triggered.
4286 //#define MMU_EXTRUDER_SENSOR
4287 #if ENABLED(MMU_EXTRUDER_SENSOR)
4288 #define MMU_LOADING_ATTEMPTS_NR 5 // max. number of attempts to load filament if first load fail
4289 #endif
4291 #endif
4293 //#define MMU2_DEBUG // Write debug info to serial output
4295 #endif // HAS_PRUSA_MMU2
4298 * Advanced Print Counter settings
4300 #if ENABLED(PRINTCOUNTER)
4301 #define SERVICE_WARNING_BUZZES 3
4302 // Activate up to 3 service interval watchdogs
4303 //#define SERVICE_NAME_1 "Service S"
4304 //#define SERVICE_INTERVAL_1 100 // print hours
4305 //#define SERVICE_NAME_2 "Service L"
4306 //#define SERVICE_INTERVAL_2 200 // print hours
4307 //#define SERVICE_NAME_3 "Service 3"
4308 //#define SERVICE_INTERVAL_3 1 // print hours
4309 #endif
4311 // @section develop
4314 // M100 Free Memory Watcher to debug memory usage
4316 //#define M100_FREE_MEMORY_WATCHER
4319 // M42 - Set pin states
4321 //#define DIRECT_PIN_CONTROL
4324 // M43 - display pin status, toggle pins, watch pins, watch endstops & toggle LED, test servo probe
4326 //#define PINS_DEBUGGING
4328 // Enable Marlin dev mode which adds some special commands
4329 //#define MARLIN_DEV_MODE
4331 #if ENABLED(MARLIN_DEV_MODE)
4333 * D576 - Buffer Monitoring
4334 * To help diagnose print quality issues stemming from empty command buffers.
4336 //#define BUFFER_MONITORING
4337 #endif
4340 * Postmortem Debugging captures misbehavior and outputs the CPU status and backtrace to serial.
4341 * When running in the debugger it will break for debugging. This is useful to help understand
4342 * a crash from a remote location. Requires ~400 bytes of SRAM and 5Kb of flash.
4344 //#define POSTMORTEM_DEBUGGING
4347 * Software Reset options
4349 //#define SOFT_RESET_VIA_SERIAL // 'KILL' and '^X' commands will soft-reset the controller
4350 //#define SOFT_RESET_ON_KILL // Use a digital button to soft-reset the controller after KILL
4352 // Report uncleaned reset reason from register r2 instead of MCUSR. Supported by Optiboot on AVR.
4353 //#define OPTIBOOT_RESET_REASON