🩹 Add missing FORCE_SOFT_SPI (#24940)
[Marlin.git] / Marlin / Configuration.h
blob99ccba028c1887bef94cbc3e6f177a185c08b387
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.h
27 * Basic settings such as:
29 * - Type of electronics
30 * - Type of temperature sensor
31 * - Printer geometry
32 * - Endstop configuration
33 * - LCD controller
34 * - Extra features
36 * Advanced settings can be found in Configuration_adv.h
38 #define CONFIGURATION_H_VERSION 02000905
40 //===========================================================================
41 //============================= Getting Started =============================
42 //===========================================================================
44 /**
45 * Here are some useful links to help get your machine configured and calibrated:
47 * Example Configs: https://github.com/MarlinFirmware/Configurations/branches/all
49 * Průša Calculator: https://blog.prusaprinters.org/calculator_3416/
51 * Calibration Guides: https://reprap.org/wiki/Calibration
52 * https://reprap.org/wiki/Triffid_Hunter%27s_Calibration_Guide
53 * https://sites.google.com/site/repraplogphase/calibration-of-your-reprap
54 * https://youtu.be/wAL9d7FgInk
56 * Calibration Objects: https://www.thingiverse.com/thing:5573
57 * https://www.thingiverse.com/thing:1278865
60 // @section info
62 // Author info of this build printed to the host during boot and M115
63 #define STRING_CONFIG_H_AUTHOR "(none, default config)" // Who made the changes.
64 //#define CUSTOM_VERSION_FILE Version.h // Path from the root directory (no quotes)
66 /**
67 * *** VENDORS PLEASE READ ***
69 * Marlin allows you to add a custom boot image for Graphical LCDs.
70 * With this option Marlin will first show your custom screen followed
71 * by the standard Marlin logo with version number and web URL.
73 * We encourage you to take advantage of this new feature and we also
74 * respectfully request that you retain the unmodified Marlin boot screen.
77 // Show the Marlin bootscreen on startup. ** ENABLE FOR PRODUCTION **
78 #define SHOW_BOOTSCREEN
80 // Show the bitmap in Marlin/_Bootscreen.h on startup.
81 //#define SHOW_CUSTOM_BOOTSCREEN
83 // Show the bitmap in Marlin/_Statusscreen.h on the status screen.
84 //#define CUSTOM_STATUS_SCREEN_IMAGE
86 // @section machine
88 // Choose the name from boards.h that matches your setup
89 #ifndef MOTHERBOARD
90 #define MOTHERBOARD BOARD_RAMPS_14_EFB
91 #endif
93 /**
94 * Select the serial port on the board to use for communication with the host.
95 * This allows the connection of wireless adapters (for instance) to non-default port pins.
96 * Serial port -1 is the USB emulated serial port, if available.
97 * Note: The first serial port (-1 or 0) will always be used by the Arduino bootloader.
99 * :[-1, 0, 1, 2, 3, 4, 5, 6, 7]
101 #define SERIAL_PORT 0
104 * Serial Port Baud Rate
105 * This is the default communication speed for all serial ports.
106 * Set the baud rate defaults for additional serial ports below.
108 * 250000 works in most cases, but you might try a lower speed if
109 * you commonly experience drop-outs during host printing.
110 * You may try up to 1000000 to speed up SD file transfer.
112 * :[2400, 9600, 19200, 38400, 57600, 115200, 250000, 500000, 1000000]
114 #define BAUDRATE 250000
115 //#define BAUD_RATE_GCODE // Enable G-code M575 to set the baud rate
118 * Select a secondary serial port on the board to use for communication with the host.
119 * Currently Ethernet (-2) is only supported on Teensy 4.1 boards.
120 * :[-2, -1, 0, 1, 2, 3, 4, 5, 6, 7]
122 //#define SERIAL_PORT_2 -1
123 //#define BAUDRATE_2 250000 // Enable to override BAUDRATE
126 * Select a third serial port on the board to use for communication with the host.
127 * Currently only supported for AVR, DUE, LPC1768/9 and STM32/STM32F1
128 * :[-1, 0, 1, 2, 3, 4, 5, 6, 7]
130 //#define SERIAL_PORT_3 1
131 //#define BAUDRATE_3 250000 // Enable to override BAUDRATE
133 // Enable the Bluetooth serial interface on AT90USB devices
134 //#define BLUETOOTH
136 // Name displayed in the LCD "Ready" message and Info menu
137 //#define CUSTOM_MACHINE_NAME "3D Printer"
139 // Printer's unique ID, used by some programs to differentiate between machines.
140 // Choose your own or use a service like https://www.uuidgenerator.net/version4
141 //#define MACHINE_UUID "00000000-0000-0000-0000-000000000000"
144 * Stepper Drivers
146 * These settings allow Marlin to tune stepper driver timing and enable advanced options for
147 * stepper drivers that support them. You may also override timing options in Configuration_adv.h.
149 * Use TMC2208/TMC2208_STANDALONE for TMC2225 drivers and TMC2209/TMC2209_STANDALONE for TMC2226 drivers.
151 * Options: A4988, A5984, DRV8825, LV8729, L6470, L6474, POWERSTEP01,
152 * TB6560, TB6600, TMC2100,
153 * TMC2130, TMC2130_STANDALONE, TMC2160, TMC2160_STANDALONE,
154 * TMC2208, TMC2208_STANDALONE, TMC2209, TMC2209_STANDALONE,
155 * TMC26X, TMC26X_STANDALONE, TMC2660, TMC2660_STANDALONE,
156 * TMC5130, TMC5130_STANDALONE, TMC5160, TMC5160_STANDALONE
157 * :['A4988', 'A5984', 'DRV8825', 'LV8729', 'L6470', 'L6474', 'POWERSTEP01', 'TB6560', 'TB6600', 'TMC2100', 'TMC2130', 'TMC2130_STANDALONE', 'TMC2160', 'TMC2160_STANDALONE', 'TMC2208', 'TMC2208_STANDALONE', 'TMC2209', 'TMC2209_STANDALONE', 'TMC26X', 'TMC26X_STANDALONE', 'TMC2660', 'TMC2660_STANDALONE', 'TMC5130', 'TMC5130_STANDALONE', 'TMC5160', 'TMC5160_STANDALONE']
159 #define X_DRIVER_TYPE A4988
160 #define Y_DRIVER_TYPE A4988
161 #define Z_DRIVER_TYPE A4988
162 //#define X2_DRIVER_TYPE A4988
163 //#define Y2_DRIVER_TYPE A4988
164 //#define Z2_DRIVER_TYPE A4988
165 //#define Z3_DRIVER_TYPE A4988
166 //#define Z4_DRIVER_TYPE A4988
167 //#define I_DRIVER_TYPE A4988
168 //#define J_DRIVER_TYPE A4988
169 //#define K_DRIVER_TYPE A4988
170 #define E0_DRIVER_TYPE A4988
171 //#define E1_DRIVER_TYPE A4988
172 //#define E2_DRIVER_TYPE A4988
173 //#define E3_DRIVER_TYPE A4988
174 //#define E4_DRIVER_TYPE A4988
175 //#define E5_DRIVER_TYPE A4988
176 //#define E6_DRIVER_TYPE A4988
177 //#define E7_DRIVER_TYPE A4988
180 * Additional Axis Settings
182 * AXISn_NAME defines the letter used to refer to the axis in (most) G-code commands.
183 * By convention the names and roles are typically:
184 * 'A' : Rotational axis parallel to X
185 * 'B' : Rotational axis parallel to Y
186 * 'C' : Rotational axis parallel to Z
187 * 'U' : Secondary linear axis parallel to X
188 * 'V' : Secondary linear axis parallel to Y
189 * 'W' : Secondary linear axis parallel to Z
191 * Regardless of these settings the axes are internally named I, J, K.
193 #ifdef I_DRIVER_TYPE
194 #define AXIS4_NAME 'A' // :['A', 'B', 'C', 'U', 'V', 'W']
195 #endif
196 #ifdef J_DRIVER_TYPE
197 #define AXIS5_NAME 'B' // :['B', 'C', 'U', 'V', 'W']
198 #endif
199 #ifdef K_DRIVER_TYPE
200 #define AXIS6_NAME 'C' // :['C', 'U', 'V', 'W']
201 #endif
203 // @section extruder
205 // This defines the number of extruders
206 // :[0, 1, 2, 3, 4, 5, 6, 7, 8]
207 #define EXTRUDERS 1
209 // Generally expected filament diameter (1.75, 2.85, 3.0, ...). Used for Volumetric, Filament Width Sensor, etc.
210 #define DEFAULT_NOMINAL_FILAMENT_DIA 1.75
212 // For Cyclops or any "multi-extruder" that shares a single nozzle.
213 //#define SINGLENOZZLE
215 // Save and restore temperature and fan speed on tool-change.
216 // Set standby for the unselected tool with M104/106/109 T...
217 #if ENABLED(SINGLENOZZLE)
218 //#define SINGLENOZZLE_STANDBY_TEMP
219 //#define SINGLENOZZLE_STANDBY_FAN
220 #endif
223 * Multi-Material Unit
224 * Set to one of these predefined models:
226 * PRUSA_MMU1 : Průša MMU1 (The "multiplexer" version)
227 * PRUSA_MMU2 : Průša MMU2
228 * PRUSA_MMU2S : Průša MMU2S (Requires MK3S extruder with motion sensor, EXTRUDERS = 5)
229 * EXTENDABLE_EMU_MMU2 : MMU with configurable number of filaments (ERCF, SMuFF or similar with Průša MMU2 compatible firmware)
230 * EXTENDABLE_EMU_MMU2S : MMUS with configurable number of filaments (ERCF, SMuFF or similar with Průša MMU2 compatible firmware)
232 * Requires NOZZLE_PARK_FEATURE to park print head in case MMU unit fails.
233 * See additional options in Configuration_adv.h.
235 //#define MMU_MODEL PRUSA_MMU2
237 // A dual extruder that uses a single stepper motor
238 //#define SWITCHING_EXTRUDER
239 #if ENABLED(SWITCHING_EXTRUDER)
240 #define SWITCHING_EXTRUDER_SERVO_NR 0
241 #define SWITCHING_EXTRUDER_SERVO_ANGLES { 0, 90 } // Angles for E0, E1[, E2, E3]
242 #if EXTRUDERS > 3
243 #define SWITCHING_EXTRUDER_E23_SERVO_NR 1
244 #endif
245 #endif
247 // A dual-nozzle that uses a servomotor to raise/lower one (or both) of the nozzles
248 //#define SWITCHING_NOZZLE
249 #if ENABLED(SWITCHING_NOZZLE)
250 #define SWITCHING_NOZZLE_SERVO_NR 0
251 //#define SWITCHING_NOZZLE_E1_SERVO_NR 1 // If two servos are used, the index of the second
252 #define SWITCHING_NOZZLE_SERVO_ANGLES { 0, 90 } // Angles for E0, E1 (single servo) or lowered/raised (dual servo)
253 #endif
256 * Two separate X-carriages with extruders that connect to a moving part
257 * via a solenoid docking mechanism. Requires SOL1_PIN and SOL2_PIN.
259 //#define PARKING_EXTRUDER
262 * Two separate X-carriages with extruders that connect to a moving part
263 * via a magnetic docking mechanism using movements and no solenoid
265 * project : https://www.thingiverse.com/thing:3080893
266 * movements : https://youtu.be/0xCEiG9VS3k
267 * https://youtu.be/Bqbcs0CU2FE
269 //#define MAGNETIC_PARKING_EXTRUDER
271 #if EITHER(PARKING_EXTRUDER, MAGNETIC_PARKING_EXTRUDER)
273 #define PARKING_EXTRUDER_PARKING_X { -78, 184 } // X positions for parking the extruders
274 #define PARKING_EXTRUDER_GRAB_DISTANCE 1 // (mm) Distance to move beyond the parking point to grab the extruder
276 #if ENABLED(PARKING_EXTRUDER)
278 #define PARKING_EXTRUDER_SOLENOIDS_INVERT // If enabled, the solenoid is NOT magnetized with applied voltage
279 #define PARKING_EXTRUDER_SOLENOIDS_PINS_ACTIVE LOW // LOW or HIGH pin signal energizes the coil
280 #define PARKING_EXTRUDER_SOLENOIDS_DELAY 250 // (ms) Delay for magnetic field. No delay if 0 or not defined.
281 //#define MANUAL_SOLENOID_CONTROL // Manual control of docking solenoids with M380 S / M381
283 #elif ENABLED(MAGNETIC_PARKING_EXTRUDER)
285 #define MPE_FAST_SPEED 9000 // (mm/min) Speed for travel before last distance point
286 #define MPE_SLOW_SPEED 4500 // (mm/min) Speed for last distance travel to park and couple
287 #define MPE_TRAVEL_DISTANCE 10 // (mm) Last distance point
288 #define MPE_COMPENSATION 0 // Offset Compensation -1 , 0 , 1 (multiplier) only for coupling
290 #endif
292 #endif
295 * Switching Toolhead
297 * Support for swappable and dockable toolheads, such as
298 * the E3D Tool Changer. Toolheads are locked with a servo.
300 //#define SWITCHING_TOOLHEAD
303 * Magnetic Switching Toolhead
305 * Support swappable and dockable toolheads with a magnetic
306 * docking mechanism using movement and no servo.
308 //#define MAGNETIC_SWITCHING_TOOLHEAD
311 * Electromagnetic Switching Toolhead
313 * Parking for CoreXY / HBot kinematics.
314 * Toolheads are parked at one edge and held with an electromagnet.
315 * Supports more than 2 Toolheads. See https://youtu.be/JolbsAKTKf4
317 //#define ELECTROMAGNETIC_SWITCHING_TOOLHEAD
319 #if ANY(SWITCHING_TOOLHEAD, MAGNETIC_SWITCHING_TOOLHEAD, ELECTROMAGNETIC_SWITCHING_TOOLHEAD)
320 #define SWITCHING_TOOLHEAD_Y_POS 235 // (mm) Y position of the toolhead dock
321 #define SWITCHING_TOOLHEAD_Y_SECURITY 10 // (mm) Security distance Y axis
322 #define SWITCHING_TOOLHEAD_Y_CLEAR 60 // (mm) Minimum distance from dock for unobstructed X axis
323 #define SWITCHING_TOOLHEAD_X_POS { 215, 0 } // (mm) X positions for parking the extruders
324 #if ENABLED(SWITCHING_TOOLHEAD)
325 #define SWITCHING_TOOLHEAD_SERVO_NR 2 // Index of the servo connector
326 #define SWITCHING_TOOLHEAD_SERVO_ANGLES { 0, 180 } // (degrees) Angles for Lock, Unlock
327 #elif ENABLED(MAGNETIC_SWITCHING_TOOLHEAD)
328 #define SWITCHING_TOOLHEAD_Y_RELEASE 5 // (mm) Security distance Y axis
329 #define SWITCHING_TOOLHEAD_X_SECURITY { 90, 150 } // (mm) Security distance X axis (T0,T1)
330 //#define PRIME_BEFORE_REMOVE // Prime the nozzle before release from the dock
331 #if ENABLED(PRIME_BEFORE_REMOVE)
332 #define SWITCHING_TOOLHEAD_PRIME_MM 20 // (mm) Extruder prime length
333 #define SWITCHING_TOOLHEAD_RETRACT_MM 10 // (mm) Retract after priming length
334 #define SWITCHING_TOOLHEAD_PRIME_FEEDRATE 300 // (mm/min) Extruder prime feedrate
335 #define SWITCHING_TOOLHEAD_RETRACT_FEEDRATE 2400 // (mm/min) Extruder retract feedrate
336 #endif
337 #elif ENABLED(ELECTROMAGNETIC_SWITCHING_TOOLHEAD)
338 #define SWITCHING_TOOLHEAD_Z_HOP 2 // (mm) Z raise for switching
339 #endif
340 #endif
343 * "Mixing Extruder"
344 * - Adds G-codes M163 and M164 to set and "commit" the current mix factors.
345 * - Extends the stepping routines to move multiple steppers in proportion to the mix.
346 * - Optional support for Repetier Firmware's 'M164 S<index>' supporting virtual tools.
347 * - This implementation supports up to two mixing extruders.
348 * - Enable DIRECT_MIXING_IN_G1 for M165 and mixing in G1 (from Pia Taubert's reference implementation).
350 //#define MIXING_EXTRUDER
351 #if ENABLED(MIXING_EXTRUDER)
352 #define MIXING_STEPPERS 2 // Number of steppers in your mixing extruder
353 #define MIXING_VIRTUAL_TOOLS 16 // Use the Virtual Tool method with M163 and M164
354 //#define DIRECT_MIXING_IN_G1 // Allow ABCDHI mix factors in G1 movement commands
355 //#define GRADIENT_MIX // Support for gradient mixing with M166 and LCD
356 //#define MIXING_PRESETS // Assign 8 default V-tool presets for 2 or 3 MIXING_STEPPERS
357 #if ENABLED(GRADIENT_MIX)
358 //#define GRADIENT_VTOOL // Add M166 T to use a V-tool index as a Gradient alias
359 #endif
360 #endif
362 // Offset of the extruders (uncomment if using more than one and relying on firmware to position when changing).
363 // The offset has to be X=0, Y=0 for the extruder 0 hotend (default extruder).
364 // For the other hotends it is their distance from the extruder 0 hotend.
365 //#define HOTEND_OFFSET_X { 0.0, 20.00 } // (mm) relative X-offset for each nozzle
366 //#define HOTEND_OFFSET_Y { 0.0, 5.00 } // (mm) relative Y-offset for each nozzle
367 //#define HOTEND_OFFSET_Z { 0.0, 0.00 } // (mm) relative Z-offset for each nozzle
369 // @section machine
372 * Power Supply Control
374 * Enable and connect the power supply to the PS_ON_PIN.
375 * Specify whether the power supply is active HIGH or active LOW.
377 //#define PSU_CONTROL
378 //#define PSU_NAME "Power Supply"
380 #if ENABLED(PSU_CONTROL)
381 //#define MKS_PWC // Using the MKS PWC add-on
382 //#define PS_OFF_CONFIRM // Confirm dialog when power off
383 //#define PS_OFF_SOUND // Beep 1s when power off
384 #define PSU_ACTIVE_STATE LOW // Set 'LOW' for ATX, 'HIGH' for X-Box
386 //#define PSU_DEFAULT_OFF // Keep power off until enabled directly with M80
387 //#define PSU_POWERUP_DELAY 250 // (ms) Delay for the PSU to warm up to full power
388 //#define LED_POWEROFF_TIMEOUT 10000 // (ms) Turn off LEDs after power-off, with this amount of delay
390 //#define POWER_OFF_TIMER // Enable M81 D<seconds> to power off after a delay
391 //#define POWER_OFF_WAIT_FOR_COOLDOWN // Enable M81 S to power off only after cooldown
393 //#define PSU_POWERUP_GCODE "M355 S1" // G-code to run after power-on (e.g., case light on)
394 //#define PSU_POWEROFF_GCODE "M355 S0" // G-code to run before power-off (e.g., case light off)
396 //#define AUTO_POWER_CONTROL // Enable automatic control of the PS_ON pin
397 #if ENABLED(AUTO_POWER_CONTROL)
398 #define AUTO_POWER_FANS // Turn on PSU if fans need power
399 #define AUTO_POWER_E_FANS
400 #define AUTO_POWER_CONTROLLERFAN
401 #define AUTO_POWER_CHAMBER_FAN
402 #define AUTO_POWER_COOLER_FAN
403 #define POWER_TIMEOUT 30 // (s) Turn off power if the machine is idle for this duration
404 //#define POWER_OFF_DELAY 60 // (s) Delay of poweroff after M81 command. Useful to let fans run for extra time.
405 #endif
406 #if EITHER(AUTO_POWER_CONTROL, POWER_OFF_WAIT_FOR_COOLDOWN)
407 //#define AUTO_POWER_E_TEMP 50 // (°C) PSU on if any extruder is over this temperature
408 //#define AUTO_POWER_CHAMBER_TEMP 30 // (°C) PSU on if the chamber is over this temperature
409 //#define AUTO_POWER_COOLER_TEMP 26 // (°C) PSU on if the cooler is over this temperature
410 #endif
411 #endif
413 //===========================================================================
414 //============================= Thermal Settings ============================
415 //===========================================================================
416 // @section temperature
419 * --NORMAL IS 4.7kΩ PULLUP!-- 1kΩ pullup can be used on hotend sensor, using correct resistor and table
421 * Temperature sensors available:
423 * SPI RTD/Thermocouple Boards - IMPORTANT: Read the NOTE below!
424 * -------
425 * -5 : MAX31865 with Pt100/Pt1000, 2, 3, or 4-wire (only for sensors 0-1)
426 * NOTE: You must uncomment/set the MAX31865_*_OHMS_n defines below.
427 * -3 : MAX31855 with Thermocouple, -200°C to +700°C (only for sensors 0-1)
428 * -2 : MAX6675 with Thermocouple, 0°C to +700°C (only for sensors 0-1)
430 * NOTE: Ensure TEMP_n_CS_PIN is set in your pins file for each TEMP_SENSOR_n using an SPI Thermocouple. By default,
431 * Hardware SPI on the default serial bus is used. If you have also set TEMP_n_SCK_PIN and TEMP_n_MISO_PIN,
432 * Software SPI will be used on those ports instead. You can force Hardware SPI on the default bus in the
433 * Configuration_adv.h file. At this time, separate Hardware SPI buses for sensors are not supported.
435 * Analog Themocouple Boards
436 * -------
437 * -4 : AD8495 with Thermocouple
438 * -1 : AD595 with Thermocouple
440 * Analog Thermistors - 4.7kΩ pullup - Normal
441 * -------
442 * 1 : 100kΩ EPCOS - Best choice for EPCOS thermistors
443 * 331 : 100kΩ Same as #1, but 3.3V scaled for MEGA
444 * 332 : 100kΩ Same as #1, but 3.3V scaled for DUE
445 * 2 : 200kΩ ATC Semitec 204GT-2
446 * 202 : 200kΩ Copymaster 3D
447 * 3 : ???Ω Mendel-parts thermistor
448 * 4 : 10kΩ Generic Thermistor !! DO NOT use for a hotend - it gives bad resolution at high temp. !!
449 * 5 : 100kΩ ATC Semitec 104GT-2/104NT-4-R025H42G - Used in ParCan, J-Head, and E3D, SliceEngineering 300°C
450 * 501 : 100kΩ Zonestar - Tronxy X3A
451 * 502 : 100kΩ Zonestar - used by hot bed in Zonestar Průša P802M
452 * 503 : 100kΩ Zonestar (Z8XM2) Heated Bed thermistor
453 * 504 : 100kΩ Zonestar P802QR2 (Part# QWG-104F-B3950) Hotend Thermistor
454 * 505 : 100kΩ Zonestar P802QR2 (Part# QWG-104F-3950) Bed Thermistor
455 * 512 : 100kΩ RPW-Ultra hotend
456 * 6 : 100kΩ EPCOS - Not as accurate as table #1 (created using a fluke thermocouple)
457 * 7 : 100kΩ Honeywell 135-104LAG-J01
458 * 71 : 100kΩ Honeywell 135-104LAF-J01
459 * 8 : 100kΩ Vishay 0603 SMD NTCS0603E3104FXT
460 * 9 : 100kΩ GE Sensing AL03006-58.2K-97-G1
461 * 10 : 100kΩ RS PRO 198-961
462 * 11 : 100kΩ Keenovo AC silicone mats, most Wanhao i3 machines - beta 3950, 1%
463 * 12 : 100kΩ Vishay 0603 SMD NTCS0603E3104FXT (#8) - calibrated for Makibox hot bed
464 * 13 : 100kΩ Hisens up to 300°C - for "Simple ONE" & "All In ONE" hotend - beta 3950, 1%
465 * 15 : 100kΩ Calibrated for JGAurora A5 hotend
466 * 18 : 200kΩ ATC Semitec 204GT-2 Dagoma.Fr - MKS_Base_DKU001327
467 * 22 : 100kΩ GTM32 Pro vB - hotend - 4.7kΩ pullup to 3.3V and 220Ω to analog input
468 * 23 : 100kΩ GTM32 Pro vB - bed - 4.7kΩ pullup to 3.3v and 220Ω to analog input
469 * 30 : 100kΩ Kis3d Silicone heating mat 200W/300W with 6mm precision cast plate (EN AW 5083) NTC100K - beta 3950
470 * 60 : 100kΩ Maker's Tool Works Kapton Bed Thermistor - beta 3950
471 * 61 : 100kΩ Formbot/Vivedino 350°C Thermistor - beta 3950
472 * 66 : 4.7MΩ Dyze Design High Temperature Thermistor
473 * 67 : 500kΩ SliceEngineering 450°C Thermistor
474 * 68 : PT100 amplifier board from Dyze Design
475 * 70 : 100kΩ bq Hephestos 2
476 * 75 : 100kΩ Generic Silicon Heat Pad with NTC100K MGB18-104F39050L32
477 * 2000 : 100kΩ Ultimachine Rambo TDK NTCG104LH104KT1 NTC100K motherboard Thermistor
479 * Analog Thermistors - 1kΩ pullup - Atypical, and requires changing out the 4.7kΩ pullup for 1kΩ.
480 * ------- (but gives greater accuracy and more stable PID)
481 * 51 : 100kΩ EPCOS (1kΩ pullup)
482 * 52 : 200kΩ ATC Semitec 204GT-2 (1kΩ pullup)
483 * 55 : 100kΩ ATC Semitec 104GT-2 - Used in ParCan & J-Head (1kΩ pullup)
485 * Analog Thermistors - 10kΩ pullup - Atypical
486 * -------
487 * 99 : 100kΩ Found on some Wanhao i3 machines with a 10kΩ pull-up resistor
489 * Analog RTDs (Pt100/Pt1000)
490 * -------
491 * 110 : Pt100 with 1kΩ pullup (atypical)
492 * 147 : Pt100 with 4.7kΩ pullup
493 * 1010 : Pt1000 with 1kΩ pullup (atypical)
494 * 1047 : Pt1000 with 4.7kΩ pullup (E3D)
495 * 20 : Pt100 with circuit in the Ultimainboard V2.x with mainboard ADC reference voltage = INA826 amplifier-board supply voltage.
496 * NOTE: (1) Must use an ADC input with no pullup. (2) Some INA826 amplifiers are unreliable at 3.3V so consider using sensor 147, 110, or 21.
497 * 21 : Pt100 with circuit in the Ultimainboard V2.x with 3.3v ADC reference voltage (STM32, LPC176x....) and 5V INA826 amplifier board supply.
498 * NOTE: ADC pins are not 5V tolerant. Not recommended because it's possible to damage the CPU by going over 500°C.
499 * 201 : Pt100 with circuit in Overlord, similar to Ultimainboard V2.x
501 * Custom/Dummy/Other Thermal Sensors
502 * ------
503 * 0 : not used
504 * 1000 : Custom - Specify parameters in Configuration_adv.h
506 * !!! Use these for Testing or Development purposes. NEVER for production machine. !!!
507 * 998 : Dummy Table that ALWAYS reads 25°C or the temperature defined below.
508 * 999 : Dummy Table that ALWAYS reads 100°C or the temperature defined below.
511 #define TEMP_SENSOR_0 1
512 #define TEMP_SENSOR_1 0
513 #define TEMP_SENSOR_2 0
514 #define TEMP_SENSOR_3 0
515 #define TEMP_SENSOR_4 0
516 #define TEMP_SENSOR_5 0
517 #define TEMP_SENSOR_6 0
518 #define TEMP_SENSOR_7 0
519 #define TEMP_SENSOR_BED 0
520 #define TEMP_SENSOR_PROBE 0
521 #define TEMP_SENSOR_CHAMBER 0
522 #define TEMP_SENSOR_COOLER 0
523 #define TEMP_SENSOR_BOARD 0
524 #define TEMP_SENSOR_REDUNDANT 0
526 // Dummy thermistor constant temperature readings, for use with 998 and 999
527 #define DUMMY_THERMISTOR_998_VALUE 25
528 #define DUMMY_THERMISTOR_999_VALUE 100
530 // Resistor values when using MAX31865 sensors (-5) on TEMP_SENSOR_0 / 1
531 //#define MAX31865_SENSOR_OHMS_0 100 // (Ω) Typically 100 or 1000 (PT100 or PT1000)
532 //#define MAX31865_CALIBRATION_OHMS_0 430 // (Ω) Typically 430 for Adafruit PT100; 4300 for Adafruit PT1000
533 //#define MAX31865_SENSOR_OHMS_1 100
534 //#define MAX31865_CALIBRATION_OHMS_1 430
536 #define TEMP_RESIDENCY_TIME 10 // (seconds) Time to wait for hotend to "settle" in M109
537 #define TEMP_WINDOW 1 // (°C) Temperature proximity for the "temperature reached" timer
538 #define TEMP_HYSTERESIS 3 // (°C) Temperature proximity considered "close enough" to the target
540 #define TEMP_BED_RESIDENCY_TIME 10 // (seconds) Time to wait for bed to "settle" in M190
541 #define TEMP_BED_WINDOW 1 // (°C) Temperature proximity for the "temperature reached" timer
542 #define TEMP_BED_HYSTERESIS 3 // (°C) Temperature proximity considered "close enough" to the target
544 #define TEMP_CHAMBER_RESIDENCY_TIME 10 // (seconds) Time to wait for chamber to "settle" in M191
545 #define TEMP_CHAMBER_WINDOW 1 // (°C) Temperature proximity for the "temperature reached" timer
546 #define TEMP_CHAMBER_HYSTERESIS 3 // (°C) Temperature proximity considered "close enough" to the target
549 * Redundant Temperature Sensor (TEMP_SENSOR_REDUNDANT)
551 * Use a temp sensor as a redundant sensor for another reading. Select an unused temperature sensor, and another
552 * sensor you'd like it to be redundant for. If the two thermistors differ by TEMP_SENSOR_REDUNDANT_MAX_DIFF (°C),
553 * the print will be aborted. Whichever sensor is selected will have its normal functions disabled; i.e. selecting
554 * the Bed sensor (-1) will disable bed heating/monitoring.
556 * For selecting source/target use: COOLER, PROBE, BOARD, CHAMBER, BED, E0, E1, E2, E3, E4, E5, E6, E7
558 #if TEMP_SENSOR_REDUNDANT
559 #define TEMP_SENSOR_REDUNDANT_SOURCE E1 // The sensor that will provide the redundant reading.
560 #define TEMP_SENSOR_REDUNDANT_TARGET E0 // The sensor that we are providing a redundant reading for.
561 #define TEMP_SENSOR_REDUNDANT_MAX_DIFF 10 // (°C) Temperature difference that will trigger a print abort.
562 #endif
564 // Below this temperature the heater will be switched off
565 // because it probably indicates a broken thermistor wire.
566 #define HEATER_0_MINTEMP 5
567 #define HEATER_1_MINTEMP 5
568 #define HEATER_2_MINTEMP 5
569 #define HEATER_3_MINTEMP 5
570 #define HEATER_4_MINTEMP 5
571 #define HEATER_5_MINTEMP 5
572 #define HEATER_6_MINTEMP 5
573 #define HEATER_7_MINTEMP 5
574 #define BED_MINTEMP 5
575 #define CHAMBER_MINTEMP 5
577 // Above this temperature the heater will be switched off.
578 // This can protect components from overheating, but NOT from shorts and failures.
579 // (Use MINTEMP for thermistor short/failure protection.)
580 #define HEATER_0_MAXTEMP 275
581 #define HEATER_1_MAXTEMP 275
582 #define HEATER_2_MAXTEMP 275
583 #define HEATER_3_MAXTEMP 275
584 #define HEATER_4_MAXTEMP 275
585 #define HEATER_5_MAXTEMP 275
586 #define HEATER_6_MAXTEMP 275
587 #define HEATER_7_MAXTEMP 275
588 #define BED_MAXTEMP 150
589 #define CHAMBER_MAXTEMP 60
592 * Thermal Overshoot
593 * During heatup (and printing) the temperature can often "overshoot" the target by many degrees
594 * (especially before PID tuning). Setting the target temperature too close to MAXTEMP guarantees
595 * a MAXTEMP shutdown! Use these values to forbid temperatures being set too close to MAXTEMP.
597 #define HOTEND_OVERSHOOT 15 // (°C) Forbid temperatures over MAXTEMP - OVERSHOOT
598 #define BED_OVERSHOOT 10 // (°C) Forbid temperatures over MAXTEMP - OVERSHOOT
599 #define COOLER_OVERSHOOT 2 // (°C) Forbid temperatures closer than OVERSHOOT
601 //===========================================================================
602 //============================= PID Settings ================================
603 //===========================================================================
605 // Enable PIDTEMP for PID control or MPCTEMP for Predictive Model.
606 // temperature control. Disable both for bang-bang heating.
607 #define PIDTEMP // See the PID Tuning Guide at https://reprap.org/wiki/PID_Tuning
608 //#define MPCTEMP // ** EXPERIMENTAL **
610 #define BANG_MAX 255 // Limits current to nozzle while in bang-bang mode; 255=full current
611 #define PID_MAX BANG_MAX // Limits current to nozzle while PID is active (see PID_FUNCTIONAL_RANGE below); 255=full current
612 #define PID_K1 0.95 // Smoothing factor within any PID loop
614 #if ENABLED(PIDTEMP)
615 //#define PID_PARAMS_PER_HOTEND // Uses separate PID parameters for each extruder (useful for mismatched extruders)
616 // Set/get with G-code: M301 E[extruder number, 0-2]
618 #if ENABLED(PID_PARAMS_PER_HOTEND)
619 // Specify up to one value per hotend here, according to your setup.
620 // If there are fewer values, the last one applies to the remaining hotends.
621 #define DEFAULT_Kp_LIST { 22.20, 22.20 }
622 #define DEFAULT_Ki_LIST { 1.08, 1.08 }
623 #define DEFAULT_Kd_LIST { 114.00, 114.00 }
624 #else
625 #define DEFAULT_Kp 22.20
626 #define DEFAULT_Ki 1.08
627 #define DEFAULT_Kd 114.00
628 #endif
629 #endif
632 * Model Predictive Control for hotend
634 * Use a physical model of the hotend to control temperature. When configured correctly
635 * this gives better responsiveness and stability than PID and it also removes the need
636 * for PID_EXTRUSION_SCALING and PID_FAN_SCALING. Use M306 T to autotune the model.
638 #if ENABLED(MPCTEMP)
639 //#define MPC_EDIT_MENU // Add MPC editing to the "Advanced Settings" menu. (~1300 bytes of flash)
640 //#define MPC_AUTOTUNE_MENU // Add MPC auto-tuning to the "Advanced Settings" menu. (~350 bytes of flash)
642 #define MPC_MAX BANG_MAX // (0..255) Current to nozzle while MPC is active.
643 #define MPC_HEATER_POWER { 40.0f } // (W) Heat cartridge powers.
645 #define MPC_INCLUDE_FAN // Model the fan speed?
647 // Measured physical constants from M306
648 #define MPC_BLOCK_HEAT_CAPACITY { 16.7f } // (J/K) Heat block heat capacities.
649 #define MPC_SENSOR_RESPONSIVENESS { 0.22f } // (K/s per ∆K) Rate of change of sensor temperature from heat block.
650 #define MPC_AMBIENT_XFER_COEFF { 0.068f } // (W/K) Heat transfer coefficients from heat block to room air with fan off.
651 #if ENABLED(MPC_INCLUDE_FAN)
652 #define MPC_AMBIENT_XFER_COEFF_FAN255 { 0.097f } // (W/K) Heat transfer coefficients from heat block to room air with fan on full.
653 #endif
655 // For one fan and multiple hotends MPC needs to know how to apply the fan cooling effect.
656 #if ENABLED(MPC_INCLUDE_FAN)
657 //#define MPC_FAN_0_ALL_HOTENDS
658 //#define MPC_FAN_0_ACTIVE_HOTEND
659 #endif
661 #define FILAMENT_HEAT_CAPACITY_PERMM { 5.6e-3f } // 0.0056 J/K/mm for 1.75mm PLA (0.0149 J/K/mm for 2.85mm PLA).
662 //#define FILAMENT_HEAT_CAPACITY_PERMM { 3.6e-3f } // 0.0036 J/K/mm for 1.75mm PETG (0.0094 J/K/mm for 2.85mm PETG).
664 // Advanced options
665 #define MPC_SMOOTHING_FACTOR 0.5f // (0.0...1.0) Noisy temperature sensors may need a lower value for stabilization.
666 #define MPC_MIN_AMBIENT_CHANGE 1.0f // (K/s) Modeled ambient temperature rate of change, when correcting model inaccuracies.
667 #define MPC_STEADYSTATE 0.5f // (K/s) Temperature change rate for steady state logic to be enforced.
669 #define MPC_TUNING_POS { X_CENTER, Y_CENTER, 1.0f } // (mm) M306 Autotuning position, ideally bed center at first layer height.
670 #define MPC_TUNING_END_Z 10.0f // (mm) M306 Autotuning final Z position.
671 #endif
673 //===========================================================================
674 //====================== PID > Bed Temperature Control ======================
675 //===========================================================================
678 * PID Bed Heating
680 * If this option is enabled set PID constants below.
681 * If this option is disabled, bang-bang will be used and BED_LIMIT_SWITCHING will enable hysteresis.
683 * The PID frequency will be the same as the extruder PWM.
684 * If PID_dT is the default, and correct for the hardware/configuration, that means 7.689Hz,
685 * which is fine for driving a square wave into a resistive load and does not significantly
686 * impact FET heating. This also works fine on a Fotek SSR-10DA Solid State Relay into a 250W
687 * heater. If your configuration is significantly different than this and you don't understand
688 * the issues involved, don't use bed PID until someone else verifies that your hardware works.
690 //#define PIDTEMPBED
692 //#define BED_LIMIT_SWITCHING
695 * Max Bed Power
696 * Applies to all forms of bed control (PID, bang-bang, and bang-bang with hysteresis).
697 * When set to any value below 255, enables a form of PWM to the bed that acts like a divider
698 * so don't use it unless you are OK with PWM on your bed. (See the comment on enabling PIDTEMPBED)
700 #define MAX_BED_POWER 255 // limits duty cycle to bed; 255=full current
702 #if ENABLED(PIDTEMPBED)
703 //#define MIN_BED_POWER 0
704 //#define PID_BED_DEBUG // Sends debug data to the serial port.
706 // 120V 250W silicone heater into 4mm borosilicate (MendelMax 1.5+)
707 // from FOPDT model - kp=.39 Tp=405 Tdead=66, Tc set to 79.2, aggressive factor of .15 (vs .1, 1, 10)
708 #define DEFAULT_bedKp 10.00
709 #define DEFAULT_bedKi .023
710 #define DEFAULT_bedKd 305.4
712 // FIND YOUR OWN: "M303 E-1 C8 S90" to run autotune on the bed at 90 degreesC for 8 cycles.
713 #endif // PIDTEMPBED
715 //===========================================================================
716 //==================== PID > Chamber Temperature Control ====================
717 //===========================================================================
720 * PID Chamber Heating
722 * If this option is enabled set PID constants below.
723 * If this option is disabled, bang-bang will be used and CHAMBER_LIMIT_SWITCHING will enable
724 * hysteresis.
726 * The PID frequency will be the same as the extruder PWM.
727 * If PID_dT is the default, and correct for the hardware/configuration, that means 7.689Hz,
728 * which is fine for driving a square wave into a resistive load and does not significantly
729 * impact FET heating. This also works fine on a Fotek SSR-10DA Solid State Relay into a 200W
730 * heater. If your configuration is significantly different than this and you don't understand
731 * the issues involved, don't use chamber PID until someone else verifies that your hardware works.
733 //#define PIDTEMPCHAMBER
734 //#define CHAMBER_LIMIT_SWITCHING
737 * Max Chamber Power
738 * Applies to all forms of chamber control (PID, bang-bang, and bang-bang with hysteresis).
739 * When set to any value below 255, enables a form of PWM to the chamber heater that acts like a divider
740 * so don't use it unless you are OK with PWM on your heater. (See the comment on enabling PIDTEMPCHAMBER)
742 #define MAX_CHAMBER_POWER 255 // limits duty cycle to chamber heater; 255=full current
744 #if ENABLED(PIDTEMPCHAMBER)
745 #define MIN_CHAMBER_POWER 0
746 //#define PID_CHAMBER_DEBUG // Sends debug data to the serial port.
748 // Lasko "MyHeat Personal Heater" (200w) modified with a Fotek SSR-10DA to control only the heating element
749 // and placed inside the small Creality printer enclosure tent.
751 #define DEFAULT_chamberKp 37.04
752 #define DEFAULT_chamberKi 1.40
753 #define DEFAULT_chamberKd 655.17
754 // M309 P37.04 I1.04 D655.17
756 // FIND YOUR OWN: "M303 E-2 C8 S50" to run autotune on the chamber at 50 degreesC for 8 cycles.
757 #endif // PIDTEMPCHAMBER
759 #if ANY(PIDTEMP, PIDTEMPBED, PIDTEMPCHAMBER)
760 //#define PID_DEBUG // Sends debug data to the serial port. Use 'M303 D' to toggle activation.
761 //#define PID_OPENLOOP // Puts PID in open loop. M104/M140 sets the output power from 0 to PID_MAX
762 //#define SLOW_PWM_HEATERS // PWM with very low frequency (roughly 0.125Hz=8s) and minimum state time of approximately 1s useful for heaters driven by a relay
763 #define PID_FUNCTIONAL_RANGE 10 // If the temperature difference between the target temperature and the actual temperature
764 // is more than PID_FUNCTIONAL_RANGE then the PID will be shut off and the heater will be set to min/max.
766 //#define PID_EDIT_MENU // Add PID editing to the "Advanced Settings" menu. (~700 bytes of flash)
767 //#define PID_AUTOTUNE_MENU // Add PID auto-tuning to the "Advanced Settings" menu. (~250 bytes of flash)
768 #endif
770 // @section extruder
773 * Prevent extrusion if the temperature is below EXTRUDE_MINTEMP.
774 * Add M302 to set the minimum extrusion temperature and/or turn
775 * cold extrusion prevention on and off.
777 * *** IT IS HIGHLY RECOMMENDED TO LEAVE THIS OPTION ENABLED! ***
779 #define PREVENT_COLD_EXTRUSION
780 #define EXTRUDE_MINTEMP 170
783 * Prevent a single extrusion longer than EXTRUDE_MAXLENGTH.
784 * Note: For Bowden Extruders make this large enough to allow load/unload.
786 #define PREVENT_LENGTHY_EXTRUDE
787 #define EXTRUDE_MAXLENGTH 200
789 //===========================================================================
790 //======================== Thermal Runaway Protection =======================
791 //===========================================================================
794 * Thermal Protection provides additional protection to your printer from damage
795 * and fire. Marlin always includes safe min and max temperature ranges which
796 * protect against a broken or disconnected thermistor wire.
798 * The issue: If a thermistor falls out, it will report the much lower
799 * temperature of the air in the room, and the the firmware will keep
800 * the heater on.
802 * If you get "Thermal Runaway" or "Heating failed" errors the
803 * details can be tuned in Configuration_adv.h
806 #define THERMAL_PROTECTION_HOTENDS // Enable thermal protection for all extruders
807 #define THERMAL_PROTECTION_BED // Enable thermal protection for the heated bed
808 #define THERMAL_PROTECTION_CHAMBER // Enable thermal protection for the heated chamber
809 #define THERMAL_PROTECTION_COOLER // Enable thermal protection for the laser cooling
811 //===========================================================================
812 //============================= Mechanical Settings =========================
813 //===========================================================================
815 // @section machine
817 // Enable one of the options below for CoreXY, CoreXZ, or CoreYZ kinematics,
818 // either in the usual order or reversed
819 //#define COREXY
820 //#define COREXZ
821 //#define COREYZ
822 //#define COREYX
823 //#define COREZX
824 //#define COREZY
825 //#define MARKFORGED_XY // MarkForged. See https://reprap.org/forum/read.php?152,504042
826 //#define MARKFORGED_YX
828 // Enable for a belt style printer with endless "Z" motion
829 //#define BELTPRINTER
831 // Enable for Polargraph Kinematics
832 //#define POLARGRAPH
833 #if ENABLED(POLARGRAPH)
834 #define POLARGRAPH_MAX_BELT_LEN 1035.0
835 #define POLAR_SEGMENTS_PER_SECOND 5
836 #endif
838 // Enable for DELTA kinematics and configure below
839 //#define DELTA
840 #if ENABLED(DELTA)
842 // Make delta curves from many straight lines (linear interpolation).
843 // This is a trade-off between visible corners (not enough segments)
844 // and processor overload (too many expensive sqrt calls).
845 #define DELTA_SEGMENTS_PER_SECOND 200
847 // After homing move down to a height where XY movement is unconstrained
848 //#define DELTA_HOME_TO_SAFE_ZONE
850 // Delta calibration menu
851 // uncomment to add three points calibration menu option.
852 // See http://minow.blogspot.com/index.html#4918805519571907051
853 //#define DELTA_CALIBRATION_MENU
855 // uncomment to add G33 Delta Auto-Calibration (Enable EEPROM_SETTINGS to store results)
856 //#define DELTA_AUTO_CALIBRATION
858 // NOTE NB all values for DELTA_* values MUST be floating point, so always have a decimal point in them
860 #if ENABLED(DELTA_AUTO_CALIBRATION)
861 // set the default number of probe points : n*n (1 -> 7)
862 #define DELTA_CALIBRATION_DEFAULT_POINTS 4
863 #endif
865 #if EITHER(DELTA_AUTO_CALIBRATION, DELTA_CALIBRATION_MENU)
866 // Set the steprate for papertest probing
867 #define PROBE_MANUALLY_STEP 0.05 // (mm)
868 #endif
870 // Print surface diameter/2 minus unreachable space (avoid collisions with vertical towers).
871 #define DELTA_PRINTABLE_RADIUS 140.0 // (mm)
873 // Maximum reachable area
874 #define DELTA_MAX_RADIUS 140.0 // (mm)
876 // Center-to-center distance of the holes in the diagonal push rods.
877 #define DELTA_DIAGONAL_ROD 250.0 // (mm)
879 // Distance between bed and nozzle Z home position
880 #define DELTA_HEIGHT 250.00 // (mm) Get this value from G33 auto calibrate
882 #define DELTA_ENDSTOP_ADJ { 0.0, 0.0, 0.0 } // Get these values from G33 auto calibrate
884 // Horizontal distance bridged by diagonal push rods when effector is centered.
885 #define DELTA_RADIUS 124.0 // (mm) Get this value from G33 auto calibrate
887 // Trim adjustments for individual towers
888 // tower angle corrections for X and Y tower / rotate XYZ so Z tower angle = 0
889 // measured in degrees anticlockwise looking from above the printer
890 #define DELTA_TOWER_ANGLE_TRIM { 0.0, 0.0, 0.0 } // Get these values from G33 auto calibrate
892 // Delta radius and diagonal rod adjustments (mm)
893 //#define DELTA_RADIUS_TRIM_TOWER { 0.0, 0.0, 0.0 }
894 //#define DELTA_DIAGONAL_ROD_TRIM_TOWER { 0.0, 0.0, 0.0 }
895 #endif
898 * MORGAN_SCARA was developed by QHARLEY in South Africa in 2012-2013.
899 * Implemented and slightly reworked by JCERNY in June, 2014.
901 * Mostly Printed SCARA is an open source design by Tyler Williams. See:
902 * https://www.thingiverse.com/thing:2487048
903 * https://www.thingiverse.com/thing:1241491
905 //#define MORGAN_SCARA
906 //#define MP_SCARA
907 #if EITHER(MORGAN_SCARA, MP_SCARA)
908 // If movement is choppy try lowering this value
909 #define SCARA_SEGMENTS_PER_SECOND 200
911 // Length of inner and outer support arms. Measure arm lengths precisely.
912 #define SCARA_LINKAGE_1 150 // (mm)
913 #define SCARA_LINKAGE_2 150 // (mm)
915 // SCARA tower offset (position of Tower relative to bed zero position)
916 // This needs to be reasonably accurate as it defines the printbed position in the SCARA space.
917 #define SCARA_OFFSET_X 100 // (mm)
918 #define SCARA_OFFSET_Y -56 // (mm)
920 #if ENABLED(MORGAN_SCARA)
922 //#define DEBUG_SCARA_KINEMATICS
923 #define SCARA_FEEDRATE_SCALING // Convert XY feedrate from mm/s to degrees/s on the fly
925 // Radius around the center where the arm cannot reach
926 #define MIDDLE_DEAD_ZONE_R 0 // (mm)
928 #define THETA_HOMING_OFFSET 0 // Calculated from Calibration Guide and M360 / M114. See http://reprap.harleystudio.co.za/?page_id=1073
929 #define PSI_HOMING_OFFSET 0 // Calculated from Calibration Guide and M364 / M114. See http://reprap.harleystudio.co.za/?page_id=1073
931 #elif ENABLED(MP_SCARA)
933 #define SCARA_OFFSET_THETA1 12 // degrees
934 #define SCARA_OFFSET_THETA2 131 // degrees
936 #endif
938 #endif
940 // Enable for TPARA kinematics and configure below
941 //#define AXEL_TPARA
942 #if ENABLED(AXEL_TPARA)
943 #define DEBUG_ROBOT_KINEMATICS
944 #define ROBOT_SEGMENTS_PER_SECOND 200
946 // Length of inner and outer support arms. Measure arm lengths precisely.
947 #define ROBOT_LINKAGE_1 120 // (mm)
948 #define ROBOT_LINKAGE_2 120 // (mm)
950 // SCARA tower offset (position of Tower relative to bed zero position)
951 // This needs to be reasonably accurate as it defines the printbed position in the SCARA space.
952 #define ROBOT_OFFSET_X 0 // (mm)
953 #define ROBOT_OFFSET_Y 0 // (mm)
954 #define ROBOT_OFFSET_Z 0 // (mm)
956 #define SCARA_FEEDRATE_SCALING // Convert XY feedrate from mm/s to degrees/s on the fly
958 // Radius around the center where the arm cannot reach
959 #define MIDDLE_DEAD_ZONE_R 0 // (mm)
961 // Calculated from Calibration Guide and M360 / M114. See http://reprap.harleystudio.co.za/?page_id=1073
962 #define THETA_HOMING_OFFSET 0
963 #define PSI_HOMING_OFFSET 0
964 #endif
966 //===========================================================================
967 //============================== Endstop Settings ===========================
968 //===========================================================================
970 // @section homing
972 // Specify here all the endstop connectors that are connected to any endstop or probe.
973 // Almost all printers will be using one per axis. Probes will use one or more of the
974 // extra connectors. Leave undefined any used for non-endstop and non-probe purposes.
975 #define USE_XMIN_PLUG
976 #define USE_YMIN_PLUG
977 #define USE_ZMIN_PLUG
978 //#define USE_IMIN_PLUG
979 //#define USE_JMIN_PLUG
980 //#define USE_KMIN_PLUG
981 //#define USE_XMAX_PLUG
982 //#define USE_YMAX_PLUG
983 //#define USE_ZMAX_PLUG
984 //#define USE_IMAX_PLUG
985 //#define USE_JMAX_PLUG
986 //#define USE_KMAX_PLUG
988 // Enable pullup for all endstops to prevent a floating state
989 #define ENDSTOPPULLUPS
990 #if DISABLED(ENDSTOPPULLUPS)
991 // Disable ENDSTOPPULLUPS to set pullups individually
992 //#define ENDSTOPPULLUP_XMIN
993 //#define ENDSTOPPULLUP_YMIN
994 //#define ENDSTOPPULLUP_ZMIN
995 //#define ENDSTOPPULLUP_IMIN
996 //#define ENDSTOPPULLUP_JMIN
997 //#define ENDSTOPPULLUP_KMIN
998 //#define ENDSTOPPULLUP_XMAX
999 //#define ENDSTOPPULLUP_YMAX
1000 //#define ENDSTOPPULLUP_ZMAX
1001 //#define ENDSTOPPULLUP_IMAX
1002 //#define ENDSTOPPULLUP_JMAX
1003 //#define ENDSTOPPULLUP_KMAX
1004 //#define ENDSTOPPULLUP_ZMIN_PROBE
1005 #endif
1007 // Enable pulldown for all endstops to prevent a floating state
1008 //#define ENDSTOPPULLDOWNS
1009 #if DISABLED(ENDSTOPPULLDOWNS)
1010 // Disable ENDSTOPPULLDOWNS to set pulldowns individually
1011 //#define ENDSTOPPULLDOWN_XMIN
1012 //#define ENDSTOPPULLDOWN_YMIN
1013 //#define ENDSTOPPULLDOWN_ZMIN
1014 //#define ENDSTOPPULLDOWN_IMIN
1015 //#define ENDSTOPPULLDOWN_JMIN
1016 //#define ENDSTOPPULLDOWN_KMIN
1017 //#define ENDSTOPPULLDOWN_XMAX
1018 //#define ENDSTOPPULLDOWN_YMAX
1019 //#define ENDSTOPPULLDOWN_ZMAX
1020 //#define ENDSTOPPULLDOWN_IMAX
1021 //#define ENDSTOPPULLDOWN_JMAX
1022 //#define ENDSTOPPULLDOWN_KMAX
1023 //#define ENDSTOPPULLDOWN_ZMIN_PROBE
1024 #endif
1026 // Mechanical endstop with COM to ground and NC to Signal uses "false" here (most common setup).
1027 #define X_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1028 #define Y_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1029 #define Z_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1030 #define I_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1031 #define J_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1032 #define K_MIN_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1033 #define X_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1034 #define Y_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1035 #define Z_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1036 #define I_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1037 #define J_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1038 #define K_MAX_ENDSTOP_INVERTING false // Set to true to invert the logic of the endstop.
1039 #define Z_MIN_PROBE_ENDSTOP_INVERTING false // Set to true to invert the logic of the probe.
1041 // Enable this feature if all enabled endstop pins are interrupt-capable.
1042 // This will remove the need to poll the interrupt pins, saving many CPU cycles.
1043 //#define ENDSTOP_INTERRUPTS_FEATURE
1046 * Endstop Noise Threshold
1048 * Enable if your probe or endstops falsely trigger due to noise.
1050 * - Higher values may affect repeatability or accuracy of some bed probes.
1051 * - To fix noise install a 100nF ceramic capacitor in parallel with the switch.
1052 * - This feature is not required for common micro-switches mounted on PCBs
1053 * based on the Makerbot design, which already have the 100nF capacitor.
1055 * :[2,3,4,5,6,7]
1057 //#define ENDSTOP_NOISE_THRESHOLD 2
1059 // Check for stuck or disconnected endstops during homing moves.
1060 //#define DETECT_BROKEN_ENDSTOP
1062 //=============================================================================
1063 //============================== Movement Settings ============================
1064 //=============================================================================
1065 // @section motion
1068 * Default Settings
1070 * These settings can be reset by M502
1072 * Note that if EEPROM is enabled, saved values will override these.
1076 * With this option each E stepper can have its own factors for the
1077 * following movement settings. If fewer factors are given than the
1078 * total number of extruders, the last value applies to the rest.
1080 //#define DISTINCT_E_FACTORS
1083 * Default Axis Steps Per Unit (steps/mm)
1084 * Override with M92
1085 * X, Y, Z [, I [, J [, K]]], E0 [, E1[, E2...]]
1087 #define DEFAULT_AXIS_STEPS_PER_UNIT { 80, 80, 400, 500 }
1090 * Default Max Feed Rate (mm/s)
1091 * Override with M203
1092 * X, Y, Z [, I [, J [, K]]], E0 [, E1[, E2...]]
1094 #define DEFAULT_MAX_FEEDRATE { 300, 300, 5, 25 }
1096 //#define LIMITED_MAX_FR_EDITING // Limit edit via M203 or LCD to DEFAULT_MAX_FEEDRATE * 2
1097 #if ENABLED(LIMITED_MAX_FR_EDITING)
1098 #define MAX_FEEDRATE_EDIT_VALUES { 600, 600, 10, 50 } // ...or, set your own edit limits
1099 #endif
1102 * Default Max Acceleration (change/s) change = mm/s
1103 * (Maximum start speed for accelerated moves)
1104 * Override with M201
1105 * X, Y, Z [, I [, J [, K]]], E0 [, E1[, E2...]]
1107 #define DEFAULT_MAX_ACCELERATION { 3000, 3000, 100, 10000 }
1109 //#define LIMITED_MAX_ACCEL_EDITING // Limit edit via M201 or LCD to DEFAULT_MAX_ACCELERATION * 2
1110 #if ENABLED(LIMITED_MAX_ACCEL_EDITING)
1111 #define MAX_ACCEL_EDIT_VALUES { 6000, 6000, 200, 20000 } // ...or, set your own edit limits
1112 #endif
1115 * Default Acceleration (change/s) change = mm/s
1116 * Override with M204
1118 * M204 P Acceleration
1119 * M204 R Retract Acceleration
1120 * M204 T Travel Acceleration
1122 #define DEFAULT_ACCELERATION 3000 // X, Y, Z ... and E acceleration for printing moves
1123 #define DEFAULT_RETRACT_ACCELERATION 3000 // E acceleration for retracts
1124 #define DEFAULT_TRAVEL_ACCELERATION 3000 // X, Y, Z ... acceleration for travel (non printing) moves
1127 * Default Jerk limits (mm/s)
1128 * Override with M205 X Y Z E
1130 * "Jerk" specifies the minimum speed change that requires acceleration.
1131 * When changing speed and direction, if the difference is less than the
1132 * value set here, it may happen instantaneously.
1134 //#define CLASSIC_JERK
1135 #if ENABLED(CLASSIC_JERK)
1136 #define DEFAULT_XJERK 10.0
1137 #define DEFAULT_YJERK 10.0
1138 #define DEFAULT_ZJERK 0.3
1139 //#define DEFAULT_IJERK 0.3
1140 //#define DEFAULT_JJERK 0.3
1141 //#define DEFAULT_KJERK 0.3
1143 //#define TRAVEL_EXTRA_XYJERK 0.0 // Additional jerk allowance for all travel moves
1145 //#define LIMITED_JERK_EDITING // Limit edit via M205 or LCD to DEFAULT_aJERK * 2
1146 #if ENABLED(LIMITED_JERK_EDITING)
1147 #define MAX_JERK_EDIT_VALUES { 20, 20, 0.6, 10 } // ...or, set your own edit limits
1148 #endif
1149 #endif
1151 #define DEFAULT_EJERK 5.0 // May be used by Linear Advance
1154 * Junction Deviation Factor
1156 * See:
1157 * https://reprap.org/forum/read.php?1,739819
1158 * https://blog.kyneticcnc.com/2018/10/computing-junction-deviation-for-marlin.html
1160 #if DISABLED(CLASSIC_JERK)
1161 #define JUNCTION_DEVIATION_MM 0.013 // (mm) Distance from real junction edge
1162 #define JD_HANDLE_SMALL_SEGMENTS // Use curvature estimation instead of just the junction angle
1163 // for small segments (< 1mm) with large junction angles (> 135°).
1164 #endif
1167 * S-Curve Acceleration
1169 * This option eliminates vibration during printing by fitting a Bézier
1170 * curve to move acceleration, producing much smoother direction changes.
1172 * See https://github.com/synthetos/TinyG/wiki/Jerk-Controlled-Motion-Explained
1174 //#define S_CURVE_ACCELERATION
1176 //===========================================================================
1177 //============================= Z Probe Options =============================
1178 //===========================================================================
1179 // @section probes
1182 // See https://marlinfw.org/docs/configuration/probes.html
1186 * Enable this option for a probe connected to the Z-MIN pin.
1187 * The probe replaces the Z-MIN endstop and is used for Z homing.
1188 * (Automatically enables USE_PROBE_FOR_Z_HOMING.)
1190 #define Z_MIN_PROBE_USES_Z_MIN_ENDSTOP_PIN
1192 // Force the use of the probe for Z-axis homing
1193 //#define USE_PROBE_FOR_Z_HOMING
1196 * Z_MIN_PROBE_PIN
1198 * Define this pin if the probe is not connected to Z_MIN_PIN.
1199 * If not defined the default pin for the selected MOTHERBOARD
1200 * will be used. Most of the time the default is what you want.
1202 * - The simplest option is to use a free endstop connector.
1203 * - Use 5V for powered (usually inductive) sensors.
1205 * - RAMPS 1.3/1.4 boards may use the 5V, GND, and Aux4->D32 pin:
1206 * - For simple switches connect...
1207 * - normally-closed switches to GND and D32.
1208 * - normally-open switches to 5V and D32.
1210 //#define Z_MIN_PROBE_PIN 32 // Pin 32 is the RAMPS default
1213 * Probe Type
1215 * Allen Key Probes, Servo Probes, Z-Sled Probes, FIX_MOUNTED_PROBE, etc.
1216 * Activate one of these to use Auto Bed Leveling below.
1220 * The "Manual Probe" provides a means to do "Auto" Bed Leveling without a probe.
1221 * Use G29 repeatedly, adjusting the Z height at each point with movement commands
1222 * or (with LCD_BED_LEVELING) the LCD controller.
1224 //#define PROBE_MANUALLY
1227 * A Fix-Mounted Probe either doesn't deploy or needs manual deployment.
1228 * (e.g., an inductive probe or a nozzle-based probe-switch.)
1230 //#define FIX_MOUNTED_PROBE
1233 * Use the nozzle as the probe, as with a conductive
1234 * nozzle system or a piezo-electric smart effector.
1236 //#define NOZZLE_AS_PROBE
1239 * Z Servo Probe, such as an endstop switch on a rotating arm.
1241 //#define Z_PROBE_SERVO_NR 0 // Defaults to SERVO 0 connector.
1242 //#define Z_SERVO_ANGLES { 70, 0 } // Z Servo Deploy and Stow angles
1245 * The BLTouch probe uses a Hall effect sensor and emulates a servo.
1247 //#define BLTOUCH
1250 * MagLev V4 probe by MDD
1252 * This probe is deployed and activated by powering a built-in electromagnet.
1254 //#define MAGLEV4
1255 #if ENABLED(MAGLEV4)
1256 //#define MAGLEV_TRIGGER_PIN 11 // Set to the connected digital output
1257 #define MAGLEV_TRIGGER_DELAY 15 // Changing this risks overheating the coil
1258 #endif
1261 * Touch-MI Probe by hotends.fr
1263 * This probe is deployed and activated by moving the X-axis to a magnet at the edge of the bed.
1264 * By default, the magnet is assumed to be on the left and activated by a home. If the magnet is
1265 * on the right, enable and set TOUCH_MI_DEPLOY_XPOS to the deploy position.
1267 * Also requires: BABYSTEPPING, BABYSTEP_ZPROBE_OFFSET, Z_SAFE_HOMING,
1268 * and a minimum Z_HOMING_HEIGHT of 10.
1270 //#define TOUCH_MI_PROBE
1271 #if ENABLED(TOUCH_MI_PROBE)
1272 #define TOUCH_MI_RETRACT_Z 0.5 // Height at which the probe retracts
1273 //#define TOUCH_MI_DEPLOY_XPOS (X_MAX_BED + 2) // For a magnet on the right side of the bed
1274 //#define TOUCH_MI_MANUAL_DEPLOY // For manual deploy (LCD menu)
1275 #endif
1277 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
1278 //#define SOLENOID_PROBE
1280 // A sled-mounted probe like those designed by Charles Bell.
1281 //#define Z_PROBE_SLED
1282 //#define SLED_DOCKING_OFFSET 5 // The extra distance the X axis must travel to pickup the sled. 0 should be fine but you can push it further if you'd like.
1284 // A probe deployed by moving the x-axis, such as the Wilson II's rack-and-pinion probe designed by Marty Rice.
1285 //#define RACK_AND_PINION_PROBE
1286 #if ENABLED(RACK_AND_PINION_PROBE)
1287 #define Z_PROBE_DEPLOY_X X_MIN_POS
1288 #define Z_PROBE_RETRACT_X X_MAX_POS
1289 #endif
1291 // Duet Smart Effector (for delta printers) - https://bit.ly/2ul5U7J
1292 // When the pin is defined you can use M672 to set/reset the probe sensitivity.
1293 //#define DUET_SMART_EFFECTOR
1294 #if ENABLED(DUET_SMART_EFFECTOR)
1295 #define SMART_EFFECTOR_MOD_PIN -1 // Connect a GPIO pin to the Smart Effector MOD pin
1296 #endif
1299 * Use StallGuard2 to probe the bed with the nozzle.
1300 * Requires stallGuard-capable Trinamic stepper drivers.
1301 * CAUTION: This can damage machines with Z lead screws.
1302 * Take extreme care when setting up this feature.
1304 //#define SENSORLESS_PROBING
1307 * Allen key retractable z-probe as seen on many Kossel delta printers - https://reprap.org/wiki/Kossel#Automatic_bed_leveling_probe
1308 * Deploys by touching z-axis belt. Retracts by pushing the probe down.
1310 //#define Z_PROBE_ALLEN_KEY
1311 #if ENABLED(Z_PROBE_ALLEN_KEY)
1312 // 2 or 3 sets of coordinates for deploying and retracting the spring loaded touch probe on G29,
1313 // if servo actuated touch probe is not defined. Uncomment as appropriate for your printer/probe.
1315 #define Z_PROBE_ALLEN_KEY_DEPLOY_1 { 30.0, DELTA_PRINTABLE_RADIUS, 100.0 }
1316 #define Z_PROBE_ALLEN_KEY_DEPLOY_1_FEEDRATE XY_PROBE_FEEDRATE
1318 #define Z_PROBE_ALLEN_KEY_DEPLOY_2 { 0.0, DELTA_PRINTABLE_RADIUS, 100.0 }
1319 #define Z_PROBE_ALLEN_KEY_DEPLOY_2_FEEDRATE (XY_PROBE_FEEDRATE)/10
1321 #define Z_PROBE_ALLEN_KEY_DEPLOY_3 { 0.0, (DELTA_PRINTABLE_RADIUS) * 0.75, 100.0 }
1322 #define Z_PROBE_ALLEN_KEY_DEPLOY_3_FEEDRATE XY_PROBE_FEEDRATE
1324 #define Z_PROBE_ALLEN_KEY_STOW_1 { -64.0, 56.0, 23.0 } // Move the probe into position
1325 #define Z_PROBE_ALLEN_KEY_STOW_1_FEEDRATE XY_PROBE_FEEDRATE
1327 #define Z_PROBE_ALLEN_KEY_STOW_2 { -64.0, 56.0, 3.0 } // Push it down
1328 #define Z_PROBE_ALLEN_KEY_STOW_2_FEEDRATE (XY_PROBE_FEEDRATE)/10
1330 #define Z_PROBE_ALLEN_KEY_STOW_3 { -64.0, 56.0, 50.0 } // Move it up to clear
1331 #define Z_PROBE_ALLEN_KEY_STOW_3_FEEDRATE XY_PROBE_FEEDRATE
1333 #define Z_PROBE_ALLEN_KEY_STOW_4 { 0.0, 0.0, 50.0 }
1334 #define Z_PROBE_ALLEN_KEY_STOW_4_FEEDRATE XY_PROBE_FEEDRATE
1336 #endif // Z_PROBE_ALLEN_KEY
1339 * Nozzle-to-Probe offsets { X, Y, Z }
1341 * X and Y offset
1342 * Use a caliper or ruler to measure the distance from the tip of
1343 * the Nozzle to the center-point of the Probe in the X and Y axes.
1345 * Z offset
1346 * - For the Z offset use your best known value and adjust at runtime.
1347 * - Common probes trigger below the nozzle and have negative values for Z offset.
1348 * - Probes triggering above the nozzle height are uncommon but do exist. When using
1349 * probes such as this, carefully set Z_CLEARANCE_DEPLOY_PROBE and Z_CLEARANCE_BETWEEN_PROBES
1350 * to avoid collisions during probing.
1352 * Tune and Adjust
1353 * - Probe Offsets can be tuned at runtime with 'M851', LCD menus, babystepping, etc.
1354 * - PROBE_OFFSET_WIZARD (configuration_adv.h) can be used for setting the Z offset.
1356 * Assuming the typical work area orientation:
1357 * - Probe to RIGHT of the Nozzle has a Positive X offset
1358 * - Probe to LEFT of the Nozzle has a Negative X offset
1359 * - Probe in BACK of the Nozzle has a Positive Y offset
1360 * - Probe in FRONT of the Nozzle has a Negative Y offset
1362 * Some examples:
1363 * #define NOZZLE_TO_PROBE_OFFSET { 10, 10, -1 } // Example "1"
1364 * #define NOZZLE_TO_PROBE_OFFSET {-10, 5, -1 } // Example "2"
1365 * #define NOZZLE_TO_PROBE_OFFSET { 5, -5, -1 } // Example "3"
1366 * #define NOZZLE_TO_PROBE_OFFSET {-15,-10, -1 } // Example "4"
1368 * +-- BACK ---+
1369 * | [+] |
1370 * L | 1 | R <-- Example "1" (right+, back+)
1371 * E | 2 | I <-- Example "2" ( left-, back+)
1372 * F |[-] N [+]| G <-- Nozzle
1373 * T | 3 | H <-- Example "3" (right+, front-)
1374 * | 4 | T <-- Example "4" ( left-, front-)
1375 * | [-] |
1376 * O-- FRONT --+
1378 #define NOZZLE_TO_PROBE_OFFSET { 10, 10, 0 }
1380 // Most probes should stay away from the edges of the bed, but
1381 // with NOZZLE_AS_PROBE this can be negative for a wider probing area.
1382 #define PROBING_MARGIN 10
1384 // X and Y axis travel speed (mm/min) between probes
1385 #define XY_PROBE_FEEDRATE (133*60)
1387 // Feedrate (mm/min) for the first approach when double-probing (MULTIPLE_PROBING == 2)
1388 #define Z_PROBE_FEEDRATE_FAST (4*60)
1390 // Feedrate (mm/min) for the "accurate" probe of each point
1391 #define Z_PROBE_FEEDRATE_SLOW (Z_PROBE_FEEDRATE_FAST / 2)
1394 * Probe Activation Switch
1395 * A switch indicating proper deployment, or an optical
1396 * switch triggered when the carriage is near the bed.
1398 //#define PROBE_ACTIVATION_SWITCH
1399 #if ENABLED(PROBE_ACTIVATION_SWITCH)
1400 #define PROBE_ACTIVATION_SWITCH_STATE LOW // State indicating probe is active
1401 //#define PROBE_ACTIVATION_SWITCH_PIN PC6 // Override default pin
1402 #endif
1405 * Tare Probe (determine zero-point) prior to each probe.
1406 * Useful for a strain gauge or piezo sensor that needs to factor out
1407 * elements such as cables pulling on the carriage.
1409 //#define PROBE_TARE
1410 #if ENABLED(PROBE_TARE)
1411 #define PROBE_TARE_TIME 200 // (ms) Time to hold tare pin
1412 #define PROBE_TARE_DELAY 200 // (ms) Delay after tare before
1413 #define PROBE_TARE_STATE HIGH // State to write pin for tare
1414 //#define PROBE_TARE_PIN PA5 // Override default pin
1415 #if ENABLED(PROBE_ACTIVATION_SWITCH)
1416 //#define PROBE_TARE_ONLY_WHILE_INACTIVE // Fail to tare/probe if PROBE_ACTIVATION_SWITCH is active
1417 #endif
1418 #endif
1421 * Probe Enable / Disable
1422 * The probe only provides a triggered signal when enabled.
1424 //#define PROBE_ENABLE_DISABLE
1425 #if ENABLED(PROBE_ENABLE_DISABLE)
1426 //#define PROBE_ENABLE_PIN -1 // Override the default pin here
1427 #endif
1430 * Multiple Probing
1432 * You may get improved results by probing 2 or more times.
1433 * With EXTRA_PROBING the more atypical reading(s) will be disregarded.
1435 * A total of 2 does fast/slow probes with a weighted average.
1436 * A total of 3 or more adds more slow probes, taking the average.
1438 //#define MULTIPLE_PROBING 2
1439 //#define EXTRA_PROBING 1
1442 * Z probes require clearance when deploying, stowing, and moving between
1443 * probe points to avoid hitting the bed and other hardware.
1444 * Servo-mounted probes require extra space for the arm to rotate.
1445 * Inductive probes need space to keep from triggering early.
1447 * Use these settings to specify the distance (mm) to raise the probe (or
1448 * lower the bed). The values set here apply over and above any (negative)
1449 * probe Z Offset set with NOZZLE_TO_PROBE_OFFSET, M851, or the LCD.
1450 * Only integer values >= 1 are valid here.
1452 * Example: `M851 Z-5` with a CLEARANCE of 4 => 9mm from bed to nozzle.
1453 * But: `M851 Z+1` with a CLEARANCE of 2 => 2mm from bed to nozzle.
1455 #define Z_CLEARANCE_DEPLOY_PROBE 10 // Z Clearance for Deploy/Stow
1456 #define Z_CLEARANCE_BETWEEN_PROBES 5 // Z Clearance between probe points
1457 #define Z_CLEARANCE_MULTI_PROBE 5 // Z Clearance between multiple probes
1458 //#define Z_AFTER_PROBING 5 // Z position after probing is done
1460 #define Z_PROBE_LOW_POINT -2 // Farthest distance below the trigger-point to go before stopping
1462 // For M851 give a range for adjusting the Z probe offset
1463 #define Z_PROBE_OFFSET_RANGE_MIN -20
1464 #define Z_PROBE_OFFSET_RANGE_MAX 20
1466 // Enable the M48 repeatability test to test probe accuracy
1467 //#define Z_MIN_PROBE_REPEATABILITY_TEST
1469 // Before deploy/stow pause for user confirmation
1470 //#define PAUSE_BEFORE_DEPLOY_STOW
1471 #if ENABLED(PAUSE_BEFORE_DEPLOY_STOW)
1472 //#define PAUSE_PROBE_DEPLOY_WHEN_TRIGGERED // For Manual Deploy Allenkey Probe
1473 #endif
1476 * Enable one or more of the following if probing seems unreliable.
1477 * Heaters and/or fans can be disabled during probing to minimize electrical
1478 * noise. A delay can also be added to allow noise and vibration to settle.
1479 * These options are most useful for the BLTouch probe, but may also improve
1480 * readings with inductive probes and piezo sensors.
1482 //#define PROBING_HEATERS_OFF // Turn heaters off when probing
1483 #if ENABLED(PROBING_HEATERS_OFF)
1484 //#define WAIT_FOR_BED_HEATER // Wait for bed to heat back up between probes (to improve accuracy)
1485 //#define WAIT_FOR_HOTEND // Wait for hotend to heat back up between probes (to improve accuracy & prevent cold extrude)
1486 #endif
1487 //#define PROBING_FANS_OFF // Turn fans off when probing
1488 //#define PROBING_ESTEPPERS_OFF // Turn all extruder steppers off when probing
1489 //#define PROBING_STEPPERS_OFF // Turn all steppers off (unless needed to hold position) when probing (including extruders)
1490 //#define DELAY_BEFORE_PROBING 200 // (ms) To prevent vibrations from triggering piezo sensors
1492 // Require minimum nozzle and/or bed temperature for probing
1493 //#define PREHEAT_BEFORE_PROBING
1494 #if ENABLED(PREHEAT_BEFORE_PROBING)
1495 #define PROBING_NOZZLE_TEMP 120 // (°C) Only applies to E0 at this time
1496 #define PROBING_BED_TEMP 50
1497 #endif
1499 // For Inverting Stepper Enable Pins (Active Low) use 0, Non Inverting (Active High) use 1
1500 // :{ 0:'Low', 1:'High' }
1501 #define X_ENABLE_ON 0
1502 #define Y_ENABLE_ON 0
1503 #define Z_ENABLE_ON 0
1504 #define E_ENABLE_ON 0 // For all extruders
1505 //#define I_ENABLE_ON 0
1506 //#define J_ENABLE_ON 0
1507 //#define K_ENABLE_ON 0
1509 // Disable axis steppers immediately when they're not being stepped.
1510 // WARNING: When motors turn off there is a chance of losing position accuracy!
1511 #define DISABLE_X false
1512 #define DISABLE_Y false
1513 #define DISABLE_Z false
1514 //#define DISABLE_I false
1515 //#define DISABLE_J false
1516 //#define DISABLE_K false
1518 // Turn off the display blinking that warns about possible accuracy reduction
1519 //#define DISABLE_REDUCED_ACCURACY_WARNING
1521 // @section extruder
1523 #define DISABLE_E false // Disable the extruder when not stepping
1524 #define DISABLE_INACTIVE_EXTRUDER // Keep only the active extruder enabled
1526 // @section machine
1528 // Invert the stepper direction. Change (or reverse the motor connector) if an axis goes the wrong way.
1529 #define INVERT_X_DIR false
1530 #define INVERT_Y_DIR true
1531 #define INVERT_Z_DIR false
1532 //#define INVERT_I_DIR false
1533 //#define INVERT_J_DIR false
1534 //#define INVERT_K_DIR false
1536 // @section extruder
1538 // For direct drive extruder v9 set to true, for geared extruder set to false.
1539 #define INVERT_E0_DIR false
1540 #define INVERT_E1_DIR false
1541 #define INVERT_E2_DIR false
1542 #define INVERT_E3_DIR false
1543 #define INVERT_E4_DIR false
1544 #define INVERT_E5_DIR false
1545 #define INVERT_E6_DIR false
1546 #define INVERT_E7_DIR false
1548 // @section homing
1550 //#define NO_MOTION_BEFORE_HOMING // Inhibit movement until all axes have been homed. Also enable HOME_AFTER_DEACTIVATE for extra safety.
1551 //#define HOME_AFTER_DEACTIVATE // Require rehoming after steppers are deactivated. Also enable NO_MOTION_BEFORE_HOMING for extra safety.
1554 * Set Z_IDLE_HEIGHT if the Z-Axis moves on its own when steppers are disabled.
1555 * - Use a low value (i.e., Z_MIN_POS) if the nozzle falls down to the bed.
1556 * - Use a large value (i.e., Z_MAX_POS) if the bed falls down, away from the nozzle.
1558 //#define Z_IDLE_HEIGHT Z_HOME_POS
1560 //#define Z_HOMING_HEIGHT 4 // (mm) Minimal Z height before homing (G28) for Z clearance above the bed, clamps, ...
1561 // Be sure to have this much clearance over your Z_MAX_POS to prevent grinding.
1563 //#define Z_AFTER_HOMING 10 // (mm) Height to move to after homing Z
1565 // Direction of endstops when homing; 1=MAX, -1=MIN
1566 // :[-1,1]
1567 #define X_HOME_DIR -1
1568 #define Y_HOME_DIR -1
1569 #define Z_HOME_DIR -1
1570 //#define I_HOME_DIR -1
1571 //#define J_HOME_DIR -1
1572 //#define K_HOME_DIR -1
1574 // @section machine
1576 // The size of the printable area
1577 #define X_BED_SIZE 200
1578 #define Y_BED_SIZE 200
1580 // Travel limits (mm) after homing, corresponding to endstop positions.
1581 #define X_MIN_POS 0
1582 #define Y_MIN_POS 0
1583 #define Z_MIN_POS 0
1584 #define X_MAX_POS X_BED_SIZE
1585 #define Y_MAX_POS Y_BED_SIZE
1586 #define Z_MAX_POS 200
1587 //#define I_MIN_POS 0
1588 //#define I_MAX_POS 50
1589 //#define J_MIN_POS 0
1590 //#define J_MAX_POS 50
1591 //#define K_MIN_POS 0
1592 //#define K_MAX_POS 50
1595 * Software Endstops
1597 * - Prevent moves outside the set machine bounds.
1598 * - Individual axes can be disabled, if desired.
1599 * - X and Y only apply to Cartesian robots.
1600 * - Use 'M211' to set software endstops on/off or report current state
1603 // Min software endstops constrain movement within minimum coordinate bounds
1604 #define MIN_SOFTWARE_ENDSTOPS
1605 #if ENABLED(MIN_SOFTWARE_ENDSTOPS)
1606 #define MIN_SOFTWARE_ENDSTOP_X
1607 #define MIN_SOFTWARE_ENDSTOP_Y
1608 #define MIN_SOFTWARE_ENDSTOP_Z
1609 #define MIN_SOFTWARE_ENDSTOP_I
1610 #define MIN_SOFTWARE_ENDSTOP_J
1611 #define MIN_SOFTWARE_ENDSTOP_K
1612 #endif
1614 // Max software endstops constrain movement within maximum coordinate bounds
1615 #define MAX_SOFTWARE_ENDSTOPS
1616 #if ENABLED(MAX_SOFTWARE_ENDSTOPS)
1617 #define MAX_SOFTWARE_ENDSTOP_X
1618 #define MAX_SOFTWARE_ENDSTOP_Y
1619 #define MAX_SOFTWARE_ENDSTOP_Z
1620 #define MAX_SOFTWARE_ENDSTOP_I
1621 #define MAX_SOFTWARE_ENDSTOP_J
1622 #define MAX_SOFTWARE_ENDSTOP_K
1623 #endif
1625 #if EITHER(MIN_SOFTWARE_ENDSTOPS, MAX_SOFTWARE_ENDSTOPS)
1626 //#define SOFT_ENDSTOPS_MENU_ITEM // Enable/Disable software endstops from the LCD
1627 #endif
1630 * Filament Runout Sensors
1631 * Mechanical or opto endstops are used to check for the presence of filament.
1633 * IMPORTANT: Runout will only trigger if Marlin is aware that a print job is running.
1634 * Marlin knows a print job is running when:
1635 * 1. Running a print job from media started with M24.
1636 * 2. The Print Job Timer has been started with M75.
1637 * 3. The heaters were turned on and PRINTJOB_TIMER_AUTOSTART is enabled.
1639 * RAMPS-based boards use SERVO3_PIN for the first runout sensor.
1640 * For other boards you may need to define FIL_RUNOUT_PIN, FIL_RUNOUT2_PIN, etc.
1642 //#define FILAMENT_RUNOUT_SENSOR
1643 #if ENABLED(FILAMENT_RUNOUT_SENSOR)
1644 #define FIL_RUNOUT_ENABLED_DEFAULT true // Enable the sensor on startup. Override with M412 followed by M500.
1645 #define NUM_RUNOUT_SENSORS 1 // Number of sensors, up to one per extruder. Define a FIL_RUNOUT#_PIN for each.
1647 #define FIL_RUNOUT_STATE LOW // Pin state indicating that filament is NOT present.
1648 #define FIL_RUNOUT_PULLUP // Use internal pullup for filament runout pins.
1649 //#define FIL_RUNOUT_PULLDOWN // Use internal pulldown for filament runout pins.
1650 //#define WATCH_ALL_RUNOUT_SENSORS // Execute runout script on any triggering sensor, not only for the active extruder.
1651 // This is automatically enabled for MIXING_EXTRUDERs.
1653 // Override individually if the runout sensors vary
1654 //#define FIL_RUNOUT1_STATE LOW
1655 //#define FIL_RUNOUT1_PULLUP
1656 //#define FIL_RUNOUT1_PULLDOWN
1658 //#define FIL_RUNOUT2_STATE LOW
1659 //#define FIL_RUNOUT2_PULLUP
1660 //#define FIL_RUNOUT2_PULLDOWN
1662 //#define FIL_RUNOUT3_STATE LOW
1663 //#define FIL_RUNOUT3_PULLUP
1664 //#define FIL_RUNOUT3_PULLDOWN
1666 //#define FIL_RUNOUT4_STATE LOW
1667 //#define FIL_RUNOUT4_PULLUP
1668 //#define FIL_RUNOUT4_PULLDOWN
1670 //#define FIL_RUNOUT5_STATE LOW
1671 //#define FIL_RUNOUT5_PULLUP
1672 //#define FIL_RUNOUT5_PULLDOWN
1674 //#define FIL_RUNOUT6_STATE LOW
1675 //#define FIL_RUNOUT6_PULLUP
1676 //#define FIL_RUNOUT6_PULLDOWN
1678 //#define FIL_RUNOUT7_STATE LOW
1679 //#define FIL_RUNOUT7_PULLUP
1680 //#define FIL_RUNOUT7_PULLDOWN
1682 //#define FIL_RUNOUT8_STATE LOW
1683 //#define FIL_RUNOUT8_PULLUP
1684 //#define FIL_RUNOUT8_PULLDOWN
1686 // Commands to execute on filament runout.
1687 // With multiple runout sensors use the %c placeholder for the current tool in commands (e.g., "M600 T%c")
1688 // NOTE: After 'M412 H1' the host handles filament runout and this script does not apply.
1689 #define FILAMENT_RUNOUT_SCRIPT "M600"
1691 // After a runout is detected, continue printing this length of filament
1692 // before executing the runout script. Useful for a sensor at the end of
1693 // a feed tube. Requires 4 bytes SRAM per sensor, plus 4 bytes overhead.
1694 //#define FILAMENT_RUNOUT_DISTANCE_MM 25
1696 #ifdef FILAMENT_RUNOUT_DISTANCE_MM
1697 // Enable this option to use an encoder disc that toggles the runout pin
1698 // as the filament moves. (Be sure to set FILAMENT_RUNOUT_DISTANCE_MM
1699 // large enough to avoid false positives.)
1700 //#define FILAMENT_MOTION_SENSOR
1701 #endif
1702 #endif
1704 //===========================================================================
1705 //=============================== Bed Leveling ==============================
1706 //===========================================================================
1707 // @section calibrate
1710 * Choose one of the options below to enable G29 Bed Leveling. The parameters
1711 * and behavior of G29 will change depending on your selection.
1713 * If using a Probe for Z Homing, enable Z_SAFE_HOMING also!
1715 * - AUTO_BED_LEVELING_3POINT
1716 * Probe 3 arbitrary points on the bed (that aren't collinear)
1717 * You specify the XY coordinates of all 3 points.
1718 * The result is a single tilted plane. Best for a flat bed.
1720 * - AUTO_BED_LEVELING_LINEAR
1721 * Probe several points in a grid.
1722 * You specify the rectangle and the density of sample points.
1723 * The result is a single tilted plane. Best for a flat bed.
1725 * - AUTO_BED_LEVELING_BILINEAR
1726 * Probe several points in a grid.
1727 * You specify the rectangle and the density of sample points.
1728 * The result is a mesh, best for large or uneven beds.
1730 * - AUTO_BED_LEVELING_UBL (Unified Bed Leveling)
1731 * A comprehensive bed leveling system combining the features and benefits
1732 * of other systems. UBL also includes integrated Mesh Generation, Mesh
1733 * Validation and Mesh Editing systems.
1735 * - MESH_BED_LEVELING
1736 * Probe a grid manually
1737 * The result is a mesh, suitable for large or uneven beds. (See BILINEAR.)
1738 * For machines without a probe, Mesh Bed Leveling provides a method to perform
1739 * leveling in steps so you can manually adjust the Z height at each grid-point.
1740 * With an LCD controller the process is guided step-by-step.
1742 //#define AUTO_BED_LEVELING_3POINT
1743 //#define AUTO_BED_LEVELING_LINEAR
1744 //#define AUTO_BED_LEVELING_BILINEAR
1745 //#define AUTO_BED_LEVELING_UBL
1746 //#define MESH_BED_LEVELING
1749 * Normally G28 leaves leveling disabled on completion. Enable one of
1750 * these options to restore the prior leveling state or to always enable
1751 * leveling immediately after G28.
1753 //#define RESTORE_LEVELING_AFTER_G28
1754 //#define ENABLE_LEVELING_AFTER_G28
1757 * Auto-leveling needs preheating
1759 //#define PREHEAT_BEFORE_LEVELING
1760 #if ENABLED(PREHEAT_BEFORE_LEVELING)
1761 #define LEVELING_NOZZLE_TEMP 120 // (°C) Only applies to E0 at this time
1762 #define LEVELING_BED_TEMP 50
1763 #endif
1766 * Enable detailed logging of G28, G29, M48, etc.
1767 * Turn on with the command 'M111 S32'.
1768 * NOTE: Requires a lot of PROGMEM!
1770 //#define DEBUG_LEVELING_FEATURE
1772 #if ANY(MESH_BED_LEVELING, AUTO_BED_LEVELING_UBL, PROBE_MANUALLY)
1773 // Set a height for the start of manual adjustment
1774 #define MANUAL_PROBE_START_Z 0.2 // (mm) Comment out to use the last-measured height
1775 #endif
1777 #if ANY(MESH_BED_LEVELING, AUTO_BED_LEVELING_BILINEAR, AUTO_BED_LEVELING_UBL)
1778 // Gradually reduce leveling correction until a set height is reached,
1779 // at which point movement will be level to the machine's XY plane.
1780 // The height can be set with M420 Z<height>
1781 #define ENABLE_LEVELING_FADE_HEIGHT
1782 #if ENABLED(ENABLE_LEVELING_FADE_HEIGHT)
1783 #define DEFAULT_LEVELING_FADE_HEIGHT 10.0 // (mm) Default fade height.
1784 #endif
1786 // For Cartesian machines, instead of dividing moves on mesh boundaries,
1787 // split up moves into short segments like a Delta. This follows the
1788 // contours of the bed more closely than edge-to-edge straight moves.
1789 #define SEGMENT_LEVELED_MOVES
1790 #define LEVELED_SEGMENT_LENGTH 5.0 // (mm) Length of all segments (except the last one)
1793 * Enable the G26 Mesh Validation Pattern tool.
1795 //#define G26_MESH_VALIDATION
1796 #if ENABLED(G26_MESH_VALIDATION)
1797 #define MESH_TEST_NOZZLE_SIZE 0.4 // (mm) Diameter of primary nozzle.
1798 #define MESH_TEST_LAYER_HEIGHT 0.2 // (mm) Default layer height for G26.
1799 #define MESH_TEST_HOTEND_TEMP 205 // (°C) Default nozzle temperature for G26.
1800 #define MESH_TEST_BED_TEMP 60 // (°C) Default bed temperature for G26.
1801 #define G26_XY_FEEDRATE 20 // (mm/s) Feedrate for G26 XY moves.
1802 #define G26_XY_FEEDRATE_TRAVEL 100 // (mm/s) Feedrate for G26 XY travel moves.
1803 #define G26_RETRACT_MULTIPLIER 1.0 // G26 Q (retraction) used by default between mesh test elements.
1804 #endif
1806 #endif
1808 #if EITHER(AUTO_BED_LEVELING_LINEAR, AUTO_BED_LEVELING_BILINEAR)
1810 // Set the number of grid points per dimension.
1811 #define GRID_MAX_POINTS_X 3
1812 #define GRID_MAX_POINTS_Y GRID_MAX_POINTS_X
1814 // Probe along the Y axis, advancing X after each column
1815 //#define PROBE_Y_FIRST
1817 #if ENABLED(AUTO_BED_LEVELING_BILINEAR)
1819 // Beyond the probed grid, continue the implied tilt?
1820 // Default is to maintain the height of the nearest edge.
1821 //#define EXTRAPOLATE_BEYOND_GRID
1824 // Experimental Subdivision of the grid by Catmull-Rom method.
1825 // Synthesizes intermediate points to produce a more detailed mesh.
1827 //#define ABL_BILINEAR_SUBDIVISION
1828 #if ENABLED(ABL_BILINEAR_SUBDIVISION)
1829 // Number of subdivisions between probe points
1830 #define BILINEAR_SUBDIVISIONS 3
1831 #endif
1833 #endif
1835 #elif ENABLED(AUTO_BED_LEVELING_UBL)
1837 //===========================================================================
1838 //========================= Unified Bed Leveling ============================
1839 //===========================================================================
1841 //#define MESH_EDIT_GFX_OVERLAY // Display a graphics overlay while editing the mesh
1843 #define MESH_INSET 1 // Set Mesh bounds as an inset region of the bed
1844 #define GRID_MAX_POINTS_X 10 // Don't use more than 15 points per axis, implementation limited.
1845 #define GRID_MAX_POINTS_Y GRID_MAX_POINTS_X
1847 //#define UBL_HILBERT_CURVE // Use Hilbert distribution for less travel when probing multiple points
1849 #define UBL_MESH_EDIT_MOVES_Z // Sophisticated users prefer no movement of nozzle
1850 #define UBL_SAVE_ACTIVE_ON_M500 // Save the currently active mesh in the current slot on M500
1852 //#define UBL_Z_RAISE_WHEN_OFF_MESH 2.5 // When the nozzle is off the mesh, this value is used
1853 // as the Z-Height correction value.
1855 //#define UBL_MESH_WIZARD // Run several commands in a row to get a complete mesh
1857 #elif ENABLED(MESH_BED_LEVELING)
1859 //===========================================================================
1860 //=================================== Mesh ==================================
1861 //===========================================================================
1863 #define MESH_INSET 10 // Set Mesh bounds as an inset region of the bed
1864 #define GRID_MAX_POINTS_X 3 // Don't use more than 7 points per axis, implementation limited.
1865 #define GRID_MAX_POINTS_Y GRID_MAX_POINTS_X
1867 //#define MESH_G28_REST_ORIGIN // After homing all axes ('G28' or 'G28 XYZ') rest Z at Z_MIN_POS
1869 #endif // BED_LEVELING
1872 * Add a bed leveling sub-menu for ABL or MBL.
1873 * Include a guided procedure if manual probing is enabled.
1875 //#define LCD_BED_LEVELING
1877 #if ENABLED(LCD_BED_LEVELING)
1878 #define MESH_EDIT_Z_STEP 0.025 // (mm) Step size while manually probing Z axis.
1879 #define LCD_PROBE_Z_RANGE 4 // (mm) Z Range centered on Z_MIN_POS for LCD Z adjustment
1880 //#define MESH_EDIT_MENU // Add a menu to edit mesh points
1881 #endif
1883 // Add a menu item to move between bed corners for manual bed adjustment
1884 //#define LCD_BED_TRAMMING
1886 #if ENABLED(LCD_BED_TRAMMING)
1887 #define BED_TRAMMING_INSET_LFRB { 30, 30, 30, 30 } // (mm) Left, Front, Right, Back insets
1888 #define BED_TRAMMING_HEIGHT 0.0 // (mm) Z height of nozzle at leveling points
1889 #define BED_TRAMMING_Z_HOP 4.0 // (mm) Z height of nozzle between leveling points
1890 //#define BED_TRAMMING_INCLUDE_CENTER // Move to the center after the last corner
1891 //#define BED_TRAMMING_USE_PROBE
1892 #if ENABLED(BED_TRAMMING_USE_PROBE)
1893 #define BED_TRAMMING_PROBE_TOLERANCE 0.1 // (mm)
1894 #define BED_TRAMMING_VERIFY_RAISED // After adjustment triggers the probe, re-probe to verify
1895 //#define BED_TRAMMING_AUDIO_FEEDBACK
1896 #endif
1899 * Corner Leveling Order
1901 * Set 2 or 4 points. When 2 points are given, the 3rd is the center of the opposite edge.
1903 * LF Left-Front RF Right-Front
1904 * LB Left-Back RB Right-Back
1906 * Examples:
1908 * Default {LF,RB,LB,RF} {LF,RF} {LB,LF}
1909 * LB --------- RB LB --------- RB LB --------- RB LB --------- RB
1910 * | 4 3 | | 3 2 | | <3> | | 1 |
1911 * | | | | | | | <3>|
1912 * | 1 2 | | 1 4 | | 1 2 | | 2 |
1913 * LF --------- RF LF --------- RF LF --------- RF LF --------- RF
1915 #define BED_TRAMMING_LEVELING_ORDER { LF, RF, RB, LB }
1916 #endif
1919 * Commands to execute at the end of G29 probing.
1920 * Useful to retract or move the Z probe out of the way.
1922 //#define Z_PROBE_END_SCRIPT "G1 Z10 F12000\nG1 X15 Y330\nG1 Z0.5\nG1 Z10"
1924 // @section homing
1926 // The center of the bed is at (X=0, Y=0)
1927 //#define BED_CENTER_AT_0_0
1929 // Manually set the home position. Leave these undefined for automatic settings.
1930 // For DELTA this is the top-center of the Cartesian print volume.
1931 //#define MANUAL_X_HOME_POS 0
1932 //#define MANUAL_Y_HOME_POS 0
1933 //#define MANUAL_Z_HOME_POS 0
1934 //#define MANUAL_I_HOME_POS 0
1935 //#define MANUAL_J_HOME_POS 0
1936 //#define MANUAL_K_HOME_POS 0
1939 * Use "Z Safe Homing" to avoid homing with a Z probe outside the bed area.
1941 * - Moves the Z probe (or nozzle) to a defined XY point before Z homing.
1942 * - Allows Z homing only when XY positions are known and trusted.
1943 * - If stepper drivers sleep, XY homing may be required again before Z homing.
1945 //#define Z_SAFE_HOMING
1947 #if ENABLED(Z_SAFE_HOMING)
1948 #define Z_SAFE_HOMING_X_POINT X_CENTER // X point for Z homing
1949 #define Z_SAFE_HOMING_Y_POINT Y_CENTER // Y point for Z homing
1950 #endif
1952 // Homing speeds (mm/min)
1953 #define HOMING_FEEDRATE_MM_M { (50*60), (50*60), (4*60) }
1955 // Validate that endstops are triggered on homing moves
1956 #define VALIDATE_HOMING_ENDSTOPS
1958 // @section calibrate
1961 * Bed Skew Compensation
1963 * This feature corrects for misalignment in the XYZ axes.
1965 * Take the following steps to get the bed skew in the XY plane:
1966 * 1. Print a test square (e.g., https://www.thingiverse.com/thing:2563185)
1967 * 2. For XY_DIAG_AC measure the diagonal A to C
1968 * 3. For XY_DIAG_BD measure the diagonal B to D
1969 * 4. For XY_SIDE_AD measure the edge A to D
1971 * Marlin automatically computes skew factors from these measurements.
1972 * Skew factors may also be computed and set manually:
1974 * - Compute AB : SQRT(2*AC*AC+2*BD*BD-4*AD*AD)/2
1975 * - XY_SKEW_FACTOR : TAN(PI/2-ACOS((AC*AC-AB*AB-AD*AD)/(2*AB*AD)))
1977 * If desired, follow the same procedure for XZ and YZ.
1978 * Use these diagrams for reference:
1980 * Y Z Z
1981 * ^ B-------C ^ B-------C ^ B-------C
1982 * | / / | / / | / /
1983 * | / / | / / | / /
1984 * | A-------D | A-------D | A-------D
1985 * +-------------->X +-------------->X +-------------->Y
1986 * XY_SKEW_FACTOR XZ_SKEW_FACTOR YZ_SKEW_FACTOR
1988 //#define SKEW_CORRECTION
1990 #if ENABLED(SKEW_CORRECTION)
1991 // Input all length measurements here:
1992 #define XY_DIAG_AC 282.8427124746
1993 #define XY_DIAG_BD 282.8427124746
1994 #define XY_SIDE_AD 200
1996 // Or, set the default skew factors directly here
1997 // to override the above measurements:
1998 #define XY_SKEW_FACTOR 0.0
2000 //#define SKEW_CORRECTION_FOR_Z
2001 #if ENABLED(SKEW_CORRECTION_FOR_Z)
2002 #define XZ_DIAG_AC 282.8427124746
2003 #define XZ_DIAG_BD 282.8427124746
2004 #define YZ_DIAG_AC 282.8427124746
2005 #define YZ_DIAG_BD 282.8427124746
2006 #define YZ_SIDE_AD 200
2007 #define XZ_SKEW_FACTOR 0.0
2008 #define YZ_SKEW_FACTOR 0.0
2009 #endif
2011 // Enable this option for M852 to set skew at runtime
2012 //#define SKEW_CORRECTION_GCODE
2013 #endif
2015 //=============================================================================
2016 //============================= Additional Features ===========================
2017 //=============================================================================
2019 // @section extras
2022 * EEPROM
2024 * Persistent storage to preserve configurable settings across reboots.
2026 * M500 - Store settings to EEPROM.
2027 * M501 - Read settings from EEPROM. (i.e., Throw away unsaved changes)
2028 * M502 - Revert settings to "factory" defaults. (Follow with M500 to init the EEPROM.)
2030 //#define EEPROM_SETTINGS // Persistent storage with M500 and M501
2031 //#define DISABLE_M503 // Saves ~2700 bytes of flash. Disable for release!
2032 #define EEPROM_CHITCHAT // Give feedback on EEPROM commands. Disable to save PROGMEM.
2033 #define EEPROM_BOOT_SILENT // Keep M503 quiet and only give errors during first load
2034 #if ENABLED(EEPROM_SETTINGS)
2035 //#define EEPROM_AUTO_INIT // Init EEPROM automatically on any errors.
2036 //#define EEPROM_INIT_NOW // Init EEPROM on first boot after a new build.
2037 #endif
2040 // Host Keepalive
2042 // When enabled Marlin will send a busy status message to the host
2043 // every couple of seconds when it can't accept commands.
2045 #define HOST_KEEPALIVE_FEATURE // Disable this if your host doesn't like keepalive messages
2046 #define DEFAULT_KEEPALIVE_INTERVAL 2 // Number of seconds between "busy" messages. Set with M113.
2047 #define BUSY_WHILE_HEATING // Some hosts require "busy" messages even during heating
2050 // G20/G21 Inch mode support
2052 //#define INCH_MODE_SUPPORT
2055 // M149 Set temperature units support
2057 //#define TEMPERATURE_UNITS_SUPPORT
2059 // @section temperature
2062 // Preheat Constants - Up to 6 are supported without changes
2064 #define PREHEAT_1_LABEL "PLA"
2065 #define PREHEAT_1_TEMP_HOTEND 180
2066 #define PREHEAT_1_TEMP_BED 70
2067 #define PREHEAT_1_TEMP_CHAMBER 35
2068 #define PREHEAT_1_FAN_SPEED 0 // Value from 0 to 255
2070 #define PREHEAT_2_LABEL "ABS"
2071 #define PREHEAT_2_TEMP_HOTEND 240
2072 #define PREHEAT_2_TEMP_BED 110
2073 #define PREHEAT_2_TEMP_CHAMBER 35
2074 #define PREHEAT_2_FAN_SPEED 0 // Value from 0 to 255
2077 * Nozzle Park
2079 * Park the nozzle at the given XYZ position on idle or G27.
2081 * The "P" parameter controls the action applied to the Z axis:
2083 * P0 (Default) If Z is below park Z raise the nozzle.
2084 * P1 Raise the nozzle always to Z-park height.
2085 * P2 Raise the nozzle by Z-park amount, limited to Z_MAX_POS.
2087 //#define NOZZLE_PARK_FEATURE
2089 #if ENABLED(NOZZLE_PARK_FEATURE)
2090 // Specify a park position as { X, Y, Z_raise }
2091 #define NOZZLE_PARK_POINT { (X_MIN_POS + 10), (Y_MAX_POS - 10), 20 }
2092 #define NOZZLE_PARK_MOVE 0 // Park motion: 0 = XY Move, 1 = X Only, 2 = Y Only, 3 = X before Y, 4 = Y before X
2093 #define NOZZLE_PARK_Z_RAISE_MIN 2 // (mm) Always raise Z by at least this distance
2094 #define NOZZLE_PARK_XY_FEEDRATE 100 // (mm/s) X and Y axes feedrate (also used for delta Z axis)
2095 #define NOZZLE_PARK_Z_FEEDRATE 5 // (mm/s) Z axis feedrate (not used for delta printers)
2096 #endif
2099 * Clean Nozzle Feature -- EXPERIMENTAL
2101 * Adds the G12 command to perform a nozzle cleaning process.
2103 * Parameters:
2104 * P Pattern
2105 * S Strokes / Repetitions
2106 * T Triangles (P1 only)
2108 * Patterns:
2109 * P0 Straight line (default). This process requires a sponge type material
2110 * at a fixed bed location. "S" specifies strokes (i.e. back-forth motions)
2111 * between the start / end points.
2113 * P1 Zig-zag pattern between (X0, Y0) and (X1, Y1), "T" specifies the
2114 * number of zig-zag triangles to do. "S" defines the number of strokes.
2115 * Zig-zags are done in whichever is the narrower dimension.
2116 * For example, "G12 P1 S1 T3" will execute:
2118 * --
2119 * | (X0, Y1) | /\ /\ /\ | (X1, Y1)
2120 * | | / \ / \ / \ |
2121 * A | | / \ / \ / \ |
2122 * | | / \ / \ / \ |
2123 * | (X0, Y0) | / \/ \/ \ | (X1, Y0)
2124 * -- +--------------------------------+
2125 * |________|_________|_________|
2126 * T1 T2 T3
2128 * P2 Circular pattern with middle at NOZZLE_CLEAN_CIRCLE_MIDDLE.
2129 * "R" specifies the radius. "S" specifies the stroke count.
2130 * Before starting, the nozzle moves to NOZZLE_CLEAN_START_POINT.
2132 * Caveats: The ending Z should be the same as starting Z.
2133 * Attention: EXPERIMENTAL. G-code arguments may change.
2135 //#define NOZZLE_CLEAN_FEATURE
2137 #if ENABLED(NOZZLE_CLEAN_FEATURE)
2138 // Default number of pattern repetitions
2139 #define NOZZLE_CLEAN_STROKES 12
2141 // Default number of triangles
2142 #define NOZZLE_CLEAN_TRIANGLES 3
2144 // Specify positions for each tool as { { X, Y, Z }, { X, Y, Z } }
2145 // Dual hotend system may use { { -20, (Y_BED_SIZE / 2), (Z_MIN_POS + 1) }, { 420, (Y_BED_SIZE / 2), (Z_MIN_POS + 1) }}
2146 #define NOZZLE_CLEAN_START_POINT { { 30, 30, (Z_MIN_POS + 1) } }
2147 #define NOZZLE_CLEAN_END_POINT { { 100, 60, (Z_MIN_POS + 1) } }
2149 // Circular pattern radius
2150 #define NOZZLE_CLEAN_CIRCLE_RADIUS 6.5
2151 // Circular pattern circle fragments number
2152 #define NOZZLE_CLEAN_CIRCLE_FN 10
2153 // Middle point of circle
2154 #define NOZZLE_CLEAN_CIRCLE_MIDDLE NOZZLE_CLEAN_START_POINT
2156 // Move the nozzle to the initial position after cleaning
2157 #define NOZZLE_CLEAN_GOBACK
2159 // For a purge/clean station that's always at the gantry height (thus no Z move)
2160 //#define NOZZLE_CLEAN_NO_Z
2162 // For a purge/clean station mounted on the X axis
2163 //#define NOZZLE_CLEAN_NO_Y
2165 // Require a minimum hotend temperature for cleaning
2166 #define NOZZLE_CLEAN_MIN_TEMP 170
2167 //#define NOZZLE_CLEAN_HEATUP // Heat up the nozzle instead of skipping wipe
2169 // Explicit wipe G-code script applies to a G12 with no arguments.
2170 //#define WIPE_SEQUENCE_COMMANDS "G1 X-17 Y25 Z10 F4000\nG1 Z1\nM114\nG1 X-17 Y25\nG1 X-17 Y95\nG1 X-17 Y25\nG1 X-17 Y95\nG1 X-17 Y25\nG1 X-17 Y95\nG1 X-17 Y25\nG1 X-17 Y95\nG1 X-17 Y25\nG1 X-17 Y95\nG1 X-17 Y25\nG1 X-17 Y95\nG1 Z15\nM400\nG0 X-10.0 Y-9.0"
2172 #endif
2175 * Print Job Timer
2177 * Automatically start and stop the print job timer on M104/M109/M140/M190/M141/M191.
2178 * The print job timer will only be stopped if the bed/chamber target temp is
2179 * below BED_MINTEMP/CHAMBER_MINTEMP.
2181 * M104 (hotend, no wait) - high temp = none, low temp = stop timer
2182 * M109 (hotend, wait) - high temp = start timer, low temp = stop timer
2183 * M140 (bed, no wait) - high temp = none, low temp = stop timer
2184 * M190 (bed, wait) - high temp = start timer, low temp = none
2185 * M141 (chamber, no wait) - high temp = none, low temp = stop timer
2186 * M191 (chamber, wait) - high temp = start timer, low temp = none
2188 * For M104/M109, high temp is anything over EXTRUDE_MINTEMP / 2.
2189 * For M140/M190, high temp is anything over BED_MINTEMP.
2190 * For M141/M191, high temp is anything over CHAMBER_MINTEMP.
2192 * The timer can also be controlled with the following commands:
2194 * M75 - Start the print job timer
2195 * M76 - Pause the print job timer
2196 * M77 - Stop the print job timer
2198 #define PRINTJOB_TIMER_AUTOSTART
2201 * Print Counter
2203 * Track statistical data such as:
2205 * - Total print jobs
2206 * - Total successful print jobs
2207 * - Total failed print jobs
2208 * - Total time printing
2210 * View the current statistics with M78.
2212 //#define PRINTCOUNTER
2213 #if ENABLED(PRINTCOUNTER)
2214 #define PRINTCOUNTER_SAVE_INTERVAL 60 // (minutes) EEPROM save interval during print
2215 #endif
2218 * Password
2220 * Set a numerical password for the printer which can be requested:
2222 * - When the printer boots up
2223 * - Upon opening the 'Print from Media' Menu
2224 * - When SD printing is completed or aborted
2226 * The following G-codes can be used:
2228 * M510 - Lock Printer. Blocks all commands except M511.
2229 * M511 - Unlock Printer.
2230 * M512 - Set, Change and Remove Password.
2232 * If you forget the password and get locked out you'll need to re-flash
2233 * the firmware with the feature disabled, reset EEPROM, and (optionally)
2234 * re-flash the firmware again with this feature enabled.
2236 //#define PASSWORD_FEATURE
2237 #if ENABLED(PASSWORD_FEATURE)
2238 #define PASSWORD_LENGTH 4 // (#) Number of digits (1-9). 3 or 4 is recommended
2239 #define PASSWORD_ON_STARTUP
2240 #define PASSWORD_UNLOCK_GCODE // Unlock with the M511 P<password> command. Disable to prevent brute-force attack.
2241 #define PASSWORD_CHANGE_GCODE // Change the password with M512 P<old> S<new>.
2242 //#define PASSWORD_ON_SD_PRINT_MENU // This does not prevent gcodes from running
2243 //#define PASSWORD_AFTER_SD_PRINT_END
2244 //#define PASSWORD_AFTER_SD_PRINT_ABORT
2245 //#include "Configuration_Secure.h" // External file with PASSWORD_DEFAULT_VALUE
2246 #endif
2248 //=============================================================================
2249 //============================= LCD and SD support ============================
2250 //=============================================================================
2252 // @section lcd
2255 * LCD LANGUAGE
2257 * Select the language to display on the LCD. These languages are available:
2259 * en, an, bg, ca, cz, da, de, el, el_CY, es, eu, fi, fr, gl, hr, hu, it,
2260 * jp_kana, ko_KR, nl, pl, pt, pt_br, ro, ru, sk, sv, tr, uk, vi, zh_CN, zh_TW
2262 * :{ 'en':'English', 'an':'Aragonese', 'bg':'Bulgarian', 'ca':'Catalan', 'cz':'Czech', 'da':'Danish', 'de':'German', 'el':'Greek (Greece)', 'el_CY':'Greek (Cyprus)', 'es':'Spanish', 'eu':'Basque-Euskera', 'fi':'Finnish', 'fr':'French', 'gl':'Galician', 'hr':'Croatian', 'hu':'Hungarian', 'it':'Italian', 'jp_kana':'Japanese', 'ko_KR':'Korean (South Korea)', 'nl':'Dutch', 'pl':'Polish', 'pt':'Portuguese', 'pt_br':'Portuguese (Brazilian)', 'ro':'Romanian', 'ru':'Russian', 'sk':'Slovak', 'sv':'Swedish', 'tr':'Turkish', 'uk':'Ukrainian', 'vi':'Vietnamese', 'zh_CN':'Chinese (Simplified)', 'zh_TW':'Chinese (Traditional)' }
2264 #define LCD_LANGUAGE en
2267 * LCD Character Set
2269 * Note: This option is NOT applicable to Graphical Displays.
2271 * All character-based LCDs provide ASCII plus one of these
2272 * language extensions:
2274 * - JAPANESE ... the most common
2275 * - WESTERN ... with more accented characters
2276 * - CYRILLIC ... for the Russian language
2278 * To determine the language extension installed on your controller:
2280 * - Compile and upload with LCD_LANGUAGE set to 'test'
2281 * - Click the controller to view the LCD menu
2282 * - The LCD will display Japanese, Western, or Cyrillic text
2284 * See https://marlinfw.org/docs/development/lcd_language.html
2286 * :['JAPANESE', 'WESTERN', 'CYRILLIC']
2288 #define DISPLAY_CHARSET_HD44780 JAPANESE
2291 * Info Screen Style (0:Classic, 1:Průša)
2293 * :[0:'Classic', 1:'Průša']
2295 #define LCD_INFO_SCREEN_STYLE 0
2298 * SD CARD
2300 * SD Card support is disabled by default. If your controller has an SD slot,
2301 * you must uncomment the following option or it won't work.
2303 //#define SDSUPPORT
2306 * SD CARD: ENABLE CRC
2308 * Use CRC checks and retries on the SD communication.
2310 //#define SD_CHECK_AND_RETRY
2313 * LCD Menu Items
2315 * Disable all menus and only display the Status Screen, or
2316 * just remove some extraneous menu items to recover space.
2318 //#define NO_LCD_MENUS
2319 //#define SLIM_LCD_MENUS
2322 // ENCODER SETTINGS
2324 // This option overrides the default number of encoder pulses needed to
2325 // produce one step. Should be increased for high-resolution encoders.
2327 //#define ENCODER_PULSES_PER_STEP 4
2330 // Use this option to override the number of step signals required to
2331 // move between next/prev menu items.
2333 //#define ENCODER_STEPS_PER_MENU_ITEM 1
2336 * Encoder Direction Options
2338 * Test your encoder's behavior first with both options disabled.
2340 * Reversed Value Edit and Menu Nav? Enable REVERSE_ENCODER_DIRECTION.
2341 * Reversed Menu Navigation only? Enable REVERSE_MENU_DIRECTION.
2342 * Reversed Value Editing only? Enable BOTH options.
2346 // This option reverses the encoder direction everywhere.
2348 // Set this option if CLOCKWISE causes values to DECREASE
2350 //#define REVERSE_ENCODER_DIRECTION
2353 // This option reverses the encoder direction for navigating LCD menus.
2355 // If CLOCKWISE normally moves DOWN this makes it go UP.
2356 // If CLOCKWISE normally moves UP this makes it go DOWN.
2358 //#define REVERSE_MENU_DIRECTION
2361 // This option reverses the encoder direction for Select Screen.
2363 // If CLOCKWISE normally moves LEFT this makes it go RIGHT.
2364 // If CLOCKWISE normally moves RIGHT this makes it go LEFT.
2366 //#define REVERSE_SELECT_DIRECTION
2369 // Individual Axis Homing
2371 // Add individual axis homing items (Home X, Home Y, and Home Z) to the LCD menu.
2373 //#define INDIVIDUAL_AXIS_HOMING_MENU
2374 //#define INDIVIDUAL_AXIS_HOMING_SUBMENU
2377 // SPEAKER/BUZZER
2379 // If you have a speaker that can produce tones, enable it here.
2380 // By default Marlin assumes you have a buzzer with a fixed frequency.
2382 //#define SPEAKER
2385 // The duration and frequency for the UI feedback sound.
2386 // Set these to 0 to disable audio feedback in the LCD menus.
2388 // Note: Test audio output with the G-Code:
2389 // M300 S<frequency Hz> P<duration ms>
2391 //#define LCD_FEEDBACK_FREQUENCY_DURATION_MS 2
2392 //#define LCD_FEEDBACK_FREQUENCY_HZ 5000
2394 //=============================================================================
2395 //======================== LCD / Controller Selection =========================
2396 //======================== (Character-based LCDs) =========================
2397 //=============================================================================
2400 // RepRapDiscount Smart Controller.
2401 // https://reprap.org/wiki/RepRapDiscount_Smart_Controller
2403 // Note: Usually sold with a white PCB.
2405 //#define REPRAP_DISCOUNT_SMART_CONTROLLER
2408 // GT2560 (YHCB2004) LCD Display
2410 // Requires Testato, Koepel softwarewire library and
2411 // Andriy Golovnya's LiquidCrystal_AIP31068 library.
2413 //#define YHCB2004
2416 // Original RADDS LCD Display+Encoder+SDCardReader
2417 // http://doku.radds.org/dokumentation/lcd-display/
2419 //#define RADDS_DISPLAY
2422 // ULTIMAKER Controller.
2424 //#define ULTIMAKERCONTROLLER
2427 // ULTIPANEL as seen on Thingiverse.
2429 //#define ULTIPANEL
2432 // PanelOne from T3P3 (via RAMPS 1.4 AUX2/AUX3)
2433 // https://reprap.org/wiki/PanelOne
2435 //#define PANEL_ONE
2438 // GADGETS3D G3D LCD/SD Controller
2439 // https://reprap.org/wiki/RAMPS_1.3/1.4_GADGETS3D_Shield_with_Panel
2441 // Note: Usually sold with a blue PCB.
2443 //#define G3D_PANEL
2446 // RigidBot Panel V1.0
2447 // http://www.inventapart.com/
2449 //#define RIGIDBOT_PANEL
2452 // Makeboard 3D Printer Parts 3D Printer Mini Display 1602 Mini Controller
2453 // https://www.aliexpress.com/item/32765887917.html
2455 //#define MAKEBOARD_MINI_2_LINE_DISPLAY_1602
2458 // ANET and Tronxy 20x4 Controller
2460 //#define ZONESTAR_LCD // Requires ADC_KEYPAD_PIN to be assigned to an analog pin.
2461 // This LCD is known to be susceptible to electrical interference
2462 // which scrambles the display. Pressing any button clears it up.
2463 // This is a LCD2004 display with 5 analog buttons.
2466 // Generic 16x2, 16x4, 20x2, or 20x4 character-based LCD.
2468 //#define ULTRA_LCD
2470 //=============================================================================
2471 //======================== LCD / Controller Selection =========================
2472 //===================== (I2C and Shift-Register LCDs) =====================
2473 //=============================================================================
2476 // CONTROLLER TYPE: I2C
2478 // Note: These controllers require the installation of Arduino's LiquidCrystal_I2C
2479 // library. For more info: https://github.com/kiyoshigawa/LiquidCrystal_I2C
2483 // Elefu RA Board Control Panel
2484 // http://www.elefu.com/index.php?route=product/product&product_id=53
2486 //#define RA_CONTROL_PANEL
2489 // Sainsmart (YwRobot) LCD Displays
2491 // These require F.Malpartida's LiquidCrystal_I2C library
2492 // https://bitbucket.org/fmalpartida/new-liquidcrystal/wiki/Home
2494 //#define LCD_SAINSMART_I2C_1602
2495 //#define LCD_SAINSMART_I2C_2004
2498 // Generic LCM1602 LCD adapter
2500 //#define LCM1602
2503 // PANELOLU2 LCD with status LEDs,
2504 // separate encoder and click inputs.
2506 // Note: This controller requires Arduino's LiquidTWI2 library v1.2.3 or later.
2507 // For more info: https://github.com/lincomatic/LiquidTWI2
2509 // Note: The PANELOLU2 encoder click input can either be directly connected to
2510 // a pin (if BTN_ENC defined to != -1) or read through I2C (when BTN_ENC == -1).
2512 //#define LCD_I2C_PANELOLU2
2515 // Panucatt VIKI LCD with status LEDs,
2516 // integrated click & L/R/U/D buttons, separate encoder inputs.
2518 //#define LCD_I2C_VIKI
2521 // CONTROLLER TYPE: Shift register panels
2525 // 2-wire Non-latching LCD SR from https://goo.gl/aJJ4sH
2526 // LCD configuration: https://reprap.org/wiki/SAV_3D_LCD
2528 //#define SAV_3DLCD
2531 // 3-wire SR LCD with strobe using 74HC4094
2532 // https://github.com/mikeshub/SailfishLCD
2533 // Uses the code directly from Sailfish
2535 //#define FF_INTERFACEBOARD
2538 // TFT GLCD Panel with Marlin UI
2539 // Panel connected to main board by SPI or I2C interface.
2540 // See https://github.com/Serhiy-K/TFTGLCDAdapter
2542 //#define TFTGLCD_PANEL_SPI
2543 //#define TFTGLCD_PANEL_I2C
2545 //=============================================================================
2546 //======================= LCD / Controller Selection =======================
2547 //========================= (Graphical LCDs) ========================
2548 //=============================================================================
2551 // CONTROLLER TYPE: Graphical 128x64 (DOGM)
2553 // IMPORTANT: The U8glib library is required for Graphical Display!
2554 // https://github.com/olikraus/U8glib_Arduino
2556 // NOTE: If the LCD is unresponsive you may need to reverse the plugs.
2560 // RepRapDiscount FULL GRAPHIC Smart Controller
2561 // https://reprap.org/wiki/RepRapDiscount_Full_Graphic_Smart_Controller
2563 //#define REPRAP_DISCOUNT_FULL_GRAPHIC_SMART_CONTROLLER
2566 // K.3D Full Graphic Smart Controller
2568 //#define K3D_FULL_GRAPHIC_SMART_CONTROLLER
2571 // ReprapWorld Graphical LCD
2572 // https://reprapworld.com/?products_details&products_id/1218
2574 //#define REPRAPWORLD_GRAPHICAL_LCD
2577 // Activate one of these if you have a Panucatt Devices
2578 // Viki 2.0 or mini Viki with Graphic LCD
2579 // https://www.panucatt.com
2581 //#define VIKI2
2582 //#define miniVIKI
2585 // Alfawise Ex8 printer LCD marked as WYH L12864 COG
2587 //#define WYH_L12864
2590 // MakerLab Mini Panel with graphic
2591 // controller and SD support - https://reprap.org/wiki/Mini_panel
2593 //#define MINIPANEL
2596 // MaKr3d Makr-Panel with graphic controller and SD support.
2597 // https://reprap.org/wiki/MaKr3d_MaKrPanel
2599 //#define MAKRPANEL
2602 // Adafruit ST7565 Full Graphic Controller.
2603 // https://github.com/eboston/Adafruit-ST7565-Full-Graphic-Controller/
2605 //#define ELB_FULL_GRAPHIC_CONTROLLER
2608 // BQ LCD Smart Controller shipped by
2609 // default with the BQ Hephestos 2 and Witbox 2.
2611 //#define BQ_LCD_SMART_CONTROLLER
2614 // Cartesio UI
2615 // http://mauk.cc/webshop/cartesio-shop/electronics/user-interface
2617 //#define CARTESIO_UI
2620 // LCD for Melzi Card with Graphical LCD
2622 //#define LCD_FOR_MELZI
2625 // Original Ulticontroller from Ultimaker 2 printer with SSD1309 I2C display and encoder
2626 // https://github.com/Ultimaker/Ultimaker2/tree/master/1249_Ulticontroller_Board_(x1)
2628 //#define ULTI_CONTROLLER
2631 // MKS MINI12864 with graphic controller and SD support
2632 // https://reprap.org/wiki/MKS_MINI_12864
2634 //#define MKS_MINI_12864
2637 // MKS MINI12864 V3 is an alias for FYSETC_MINI_12864_2_1. Type A/B. NeoPixel RGB Backlight.
2639 //#define MKS_MINI_12864_V3
2642 // MKS LCD12864A/B with graphic controller and SD support. Follows MKS_MINI_12864 pinout.
2643 // https://www.aliexpress.com/item/33018110072.html
2645 //#define MKS_LCD12864A
2646 //#define MKS_LCD12864B
2649 // FYSETC variant of the MINI12864 graphic controller with SD support
2650 // https://wiki.fysetc.com/Mini12864_Panel/
2652 //#define FYSETC_MINI_12864_X_X // Type C/D/E/F. No tunable RGB Backlight by default
2653 //#define FYSETC_MINI_12864_1_2 // Type C/D/E/F. Simple RGB Backlight (always on)
2654 //#define FYSETC_MINI_12864_2_0 // Type A/B. Discreet RGB Backlight
2655 //#define FYSETC_MINI_12864_2_1 // Type A/B. NeoPixel RGB Backlight
2656 //#define FYSETC_GENERIC_12864_1_1 // Larger display with basic ON/OFF backlight.
2659 // BigTreeTech Mini 12864 V1.0 is an alias for FYSETC_MINI_12864_2_1. Type A/B. NeoPixel RGB Backlight.
2661 //#define BTT_MINI_12864_V1
2664 // Factory display for Creality CR-10
2665 // https://www.aliexpress.com/item/32833148327.html
2667 // This is RAMPS-compatible using a single 10-pin connector.
2668 // (For CR-10 owners who want to replace the Melzi Creality board but retain the display)
2670 //#define CR10_STOCKDISPLAY
2673 // Ender-2 OEM display, a variant of the MKS_MINI_12864
2675 //#define ENDER2_STOCKDISPLAY
2678 // ANET and Tronxy Graphical Controller
2680 // Anet 128x64 full graphics lcd with rotary encoder as used on Anet A6
2681 // A clone of the RepRapDiscount full graphics display but with
2682 // different pins/wiring (see pins_ANET_10.h). Enable one of these.
2684 //#define ANET_FULL_GRAPHICS_LCD
2685 //#define ANET_FULL_GRAPHICS_LCD_ALT_WIRING
2688 // AZSMZ 12864 LCD with SD
2689 // https://www.aliexpress.com/item/32837222770.html
2691 //#define AZSMZ_12864
2694 // Silvergate GLCD controller
2695 // https://github.com/android444/Silvergate
2697 //#define SILVER_GATE_GLCD_CONTROLLER
2699 //=============================================================================
2700 //============================== OLED Displays ==============================
2701 //=============================================================================
2704 // SSD1306 OLED full graphics generic display
2706 //#define U8GLIB_SSD1306
2709 // SAV OLEd LCD module support using either SSD1306 or SH1106 based LCD modules
2711 //#define SAV_3DGLCD
2712 #if ENABLED(SAV_3DGLCD)
2713 #define U8GLIB_SSD1306
2714 //#define U8GLIB_SH1106
2715 #endif
2718 // TinyBoy2 128x64 OLED / Encoder Panel
2720 //#define OLED_PANEL_TINYBOY2
2723 // MKS OLED 1.3" 128×64 Full Graphics Controller
2724 // https://reprap.org/wiki/MKS_12864OLED
2726 // Tiny, but very sharp OLED display
2728 //#define MKS_12864OLED // Uses the SH1106 controller (default)
2729 //#define MKS_12864OLED_SSD1306 // Uses the SSD1306 controller
2732 // Zonestar OLED 128×64 Full Graphics Controller
2734 //#define ZONESTAR_12864LCD // Graphical (DOGM) with ST7920 controller
2735 //#define ZONESTAR_12864OLED // 1.3" OLED with SH1106 controller (default)
2736 //#define ZONESTAR_12864OLED_SSD1306 // 0.96" OLED with SSD1306 controller
2739 // Einstart S OLED SSD1306
2741 //#define U8GLIB_SH1106_EINSTART
2744 // Overlord OLED display/controller with i2c buzzer and LEDs
2746 //#define OVERLORD_OLED
2749 // FYSETC OLED 2.42" 128×64 Full Graphics Controller with WS2812 RGB
2750 // Where to find : https://www.aliexpress.com/item/4000345255731.html
2751 //#define FYSETC_242_OLED_12864 // Uses the SSD1309 controller
2754 // K.3D SSD1309 OLED 2.42" 128×64 Full Graphics Controller
2756 //#define K3D_242_OLED_CONTROLLER // Software SPI
2758 //=============================================================================
2759 //========================== Extensible UI Displays ===========================
2760 //=============================================================================
2763 * DGUS Touch Display with DWIN OS. (Choose one.)
2764 * ORIGIN : https://www.aliexpress.com/item/32993409517.html
2765 * FYSETC : https://www.aliexpress.com/item/32961471929.html
2766 * MKS : https://www.aliexpress.com/item/1005002008179262.html
2768 * Flash display with DGUS Displays for Marlin:
2769 * - Format the SD card to FAT32 with an allocation size of 4kb.
2770 * - Download files as specified for your type of display.
2771 * - Plug the microSD card into the back of the display.
2772 * - Boot the display and wait for the update to complete.
2774 * ORIGIN (Marlin DWIN_SET)
2775 * - Download https://github.com/coldtobi/Marlin_DGUS_Resources
2776 * - Copy the downloaded DWIN_SET folder to the SD card.
2778 * FYSETC (Supplier default)
2779 * - Download https://github.com/FYSETC/FYSTLCD-2.0
2780 * - Copy the downloaded SCREEN folder to the SD card.
2782 * HIPRECY (Supplier default)
2783 * - Download https://github.com/HiPrecy/Touch-Lcd-LEO
2784 * - Copy the downloaded DWIN_SET folder to the SD card.
2786 * MKS (MKS-H43) (Supplier default)
2787 * - Download https://github.com/makerbase-mks/MKS-H43
2788 * - Copy the downloaded DWIN_SET folder to the SD card.
2790 * RELOADED (T5UID1)
2791 * - Download https://github.com/Desuuuu/DGUS-reloaded/releases
2792 * - Copy the downloaded DWIN_SET folder to the SD card.
2794 //#define DGUS_LCD_UI_ORIGIN
2795 //#define DGUS_LCD_UI_FYSETC
2796 //#define DGUS_LCD_UI_HIPRECY
2797 //#define DGUS_LCD_UI_MKS
2798 //#define DGUS_LCD_UI_RELOADED
2799 #if ENABLED(DGUS_LCD_UI_MKS)
2800 #define USE_MKS_GREEN_UI
2801 #endif
2804 // Touch-screen LCD for Malyan M200/M300 printers
2806 //#define MALYAN_LCD
2809 // Touch UI for FTDI EVE (FT800/FT810) displays
2810 // See Configuration_adv.h for all configuration options.
2812 //#define TOUCH_UI_FTDI_EVE
2815 // Touch-screen LCD for Anycubic printers
2817 //#define ANYCUBIC_LCD_I3MEGA
2818 //#define ANYCUBIC_LCD_CHIRON
2819 #if EITHER(ANYCUBIC_LCD_I3MEGA, ANYCUBIC_LCD_CHIRON)
2820 //#define ANYCUBIC_LCD_DEBUG
2821 #endif
2824 // 320x240 Nextion 2.8" serial TFT Resistive Touch Screen NX3224T028
2826 //#define NEXTION_TFT
2829 // Third-party or vendor-customized controller interfaces.
2830 // Sources should be installed in 'src/lcd/extui'.
2832 //#define EXTENSIBLE_UI
2834 #if ENABLED(EXTENSIBLE_UI)
2835 //#define EXTUI_LOCAL_BEEPER // Enables use of local Beeper pin with external display
2836 #endif
2838 //=============================================================================
2839 //=============================== Graphical TFTs ==============================
2840 //=============================================================================
2843 * Specific TFT Model Presets. Enable one of the following options
2844 * or enable TFT_GENERIC and set sub-options.
2848 // 480x320, 3.5", SPI Display with Rotary Encoder from MKS
2849 // Usually paired with MKS Robin Nano V2 & V3
2851 //#define MKS_TS35_V2_0
2854 // 320x240, 2.4", FSMC Display From MKS
2855 // Usually paired with MKS Robin Nano V1.2
2857 //#define MKS_ROBIN_TFT24
2860 // 320x240, 2.8", FSMC Display From MKS
2861 // Usually paired with MKS Robin Nano V1.2
2863 //#define MKS_ROBIN_TFT28
2866 // 320x240, 3.2", FSMC Display From MKS
2867 // Usually paired with MKS Robin Nano V1.2
2869 //#define MKS_ROBIN_TFT32
2872 // 480x320, 3.5", FSMC Display From MKS
2873 // Usually paired with MKS Robin Nano V1.2
2875 //#define MKS_ROBIN_TFT35
2878 // 480x272, 4.3", FSMC Display From MKS
2880 //#define MKS_ROBIN_TFT43
2883 // 320x240, 3.2", FSMC Display From MKS
2884 // Usually paired with MKS Robin
2886 //#define MKS_ROBIN_TFT_V1_1R
2889 // 480x320, 3.5", FSMC Stock Display from TronxXY
2891 //#define TFT_TRONXY_X5SA
2894 // 480x320, 3.5", FSMC Stock Display from AnyCubic
2896 //#define ANYCUBIC_TFT35
2899 // 320x240, 2.8", FSMC Stock Display from Longer/Alfawise
2901 //#define LONGER_LK_TFT28
2904 // 320x240, 2.8", FSMC Stock Display from ET4
2906 //#define ANET_ET4_TFT28
2909 // 480x320, 3.5", FSMC Stock Display from ET5
2911 //#define ANET_ET5_TFT35
2914 // 1024x600, 7", RGB Stock Display with Rotary Encoder from BIQU-BX
2916 //#define BIQU_BX_TFT70
2919 // 480x320, 3.5", SPI Stock Display with Rotary Encoder from BIQU B1 SE Series
2921 //#define BTT_TFT35_SPI_V1_0
2924 // Generic TFT with detailed options
2926 //#define TFT_GENERIC
2927 #if ENABLED(TFT_GENERIC)
2928 // :[ 'AUTO', 'ST7735', 'ST7789', 'ST7796', 'R61505', 'ILI9328', 'ILI9341', 'ILI9488' ]
2929 #define TFT_DRIVER AUTO
2931 // Interface. Enable one of the following options:
2932 //#define TFT_INTERFACE_FSMC
2933 //#define TFT_INTERFACE_SPI
2935 // TFT Resolution. Enable one of the following options:
2936 //#define TFT_RES_320x240
2937 //#define TFT_RES_480x272
2938 //#define TFT_RES_480x320
2939 //#define TFT_RES_1024x600
2940 #endif
2943 * TFT UI - User Interface Selection. Enable one of the following options:
2945 * TFT_CLASSIC_UI - Emulated DOGM - 128x64 Upscaled
2946 * TFT_COLOR_UI - Marlin Default Menus, Touch Friendly, using full TFT capabilities
2947 * TFT_LVGL_UI - A Modern UI using LVGL
2949 * For LVGL_UI also copy the 'assets' folder from the build directory to the
2950 * root of your SD card, together with the compiled firmware.
2952 //#define TFT_CLASSIC_UI
2953 //#define TFT_COLOR_UI
2954 //#define TFT_LVGL_UI
2956 #if ENABLED(TFT_LVGL_UI)
2957 //#define MKS_WIFI_MODULE // MKS WiFi module
2958 #endif
2961 * TFT Rotation. Set to one of the following values:
2963 * TFT_ROTATE_90, TFT_ROTATE_90_MIRROR_X, TFT_ROTATE_90_MIRROR_Y,
2964 * TFT_ROTATE_180, TFT_ROTATE_180_MIRROR_X, TFT_ROTATE_180_MIRROR_Y,
2965 * TFT_ROTATE_270, TFT_ROTATE_270_MIRROR_X, TFT_ROTATE_270_MIRROR_Y,
2966 * TFT_MIRROR_X, TFT_MIRROR_Y, TFT_NO_ROTATION
2968 //#define TFT_ROTATION TFT_NO_ROTATION
2970 //=============================================================================
2971 //============================ Other Controllers ============================
2972 //=============================================================================
2975 // Ender-3 v2 OEM display. A DWIN display with Rotary Encoder.
2977 //#define DWIN_CREALITY_LCD // Creality UI
2978 //#define DWIN_LCD_PROUI // Pro UI by MRiscoC
2979 //#define DWIN_CREALITY_LCD_JYERSUI // Jyers UI by Jacob Myers
2980 //#define DWIN_MARLINUI_PORTRAIT // MarlinUI (portrait orientation)
2981 //#define DWIN_MARLINUI_LANDSCAPE // MarlinUI (landscape orientation)
2984 // Touch Screen Settings
2986 //#define TOUCH_SCREEN
2987 #if ENABLED(TOUCH_SCREEN)
2988 #define BUTTON_DELAY_EDIT 50 // (ms) Button repeat delay for edit screens
2989 #define BUTTON_DELAY_MENU 250 // (ms) Button repeat delay for menus
2991 //#define TOUCH_IDLE_SLEEP 300 // (s) Turn off the TFT backlight if set (5mn)
2993 #define TOUCH_SCREEN_CALIBRATION
2995 //#define TOUCH_CALIBRATION_X 12316
2996 //#define TOUCH_CALIBRATION_Y -8981
2997 //#define TOUCH_OFFSET_X -43
2998 //#define TOUCH_OFFSET_Y 257
2999 //#define TOUCH_ORIENTATION TOUCH_LANDSCAPE
3001 #if BOTH(TOUCH_SCREEN_CALIBRATION, EEPROM_SETTINGS)
3002 #define TOUCH_CALIBRATION_AUTO_SAVE // Auto save successful calibration values to EEPROM
3003 #endif
3005 #if ENABLED(TFT_COLOR_UI)
3006 //#define SINGLE_TOUCH_NAVIGATION
3007 #endif
3008 #endif
3011 // RepRapWorld REPRAPWORLD_KEYPAD v1.1
3012 // https://reprapworld.com/products/electronics/ramps/keypad_v1_0_fully_assembled/
3014 //#define REPRAPWORLD_KEYPAD
3015 //#define REPRAPWORLD_KEYPAD_MOVE_STEP 10.0 // (mm) Distance to move per key-press
3018 // EasyThreeD ET-4000+ with button input and status LED
3020 //#define EASYTHREED_UI
3022 //=============================================================================
3023 //=============================== Extra Features ==============================
3024 //=============================================================================
3026 // @section extras
3028 // Set number of user-controlled fans. Disable to use all board-defined fans.
3029 // :[1,2,3,4,5,6,7,8]
3030 //#define NUM_M106_FANS 1
3032 // Use software PWM to drive the fan, as for the heaters. This uses a very low frequency
3033 // which is not as annoying as with the hardware PWM. On the other hand, if this frequency
3034 // is too low, you should also increment SOFT_PWM_SCALE.
3035 //#define FAN_SOFT_PWM
3037 // Incrementing this by 1 will double the software PWM frequency,
3038 // affecting heaters, and the fan if FAN_SOFT_PWM is enabled.
3039 // However, control resolution will be halved for each increment;
3040 // at zero value, there are 128 effective control positions.
3041 // :[0,1,2,3,4,5,6,7]
3042 #define SOFT_PWM_SCALE 0
3044 // If SOFT_PWM_SCALE is set to a value higher than 0, dithering can
3045 // be used to mitigate the associated resolution loss. If enabled,
3046 // some of the PWM cycles are stretched so on average the desired
3047 // duty cycle is attained.
3048 //#define SOFT_PWM_DITHER
3050 // Temperature status LEDs that display the hotend and bed temperature.
3051 // If all hotends, bed temperature, and target temperature are under 54C
3052 // then the BLUE led is on. Otherwise the RED led is on. (1C hysteresis)
3053 //#define TEMP_STAT_LEDS
3055 // Support for the BariCUDA Paste Extruder
3056 //#define BARICUDA
3058 // Support for BlinkM/CyzRgb
3059 //#define BLINKM
3061 // Support for PCA9632 PWM LED driver
3062 //#define PCA9632
3064 // Support for PCA9533 PWM LED driver
3065 //#define PCA9533
3068 * RGB LED / LED Strip Control
3070 * Enable support for an RGB LED connected to 5V digital pins, or
3071 * an RGB Strip connected to MOSFETs controlled by digital pins.
3073 * Adds the M150 command to set the LED (or LED strip) color.
3074 * If pins are PWM capable (e.g., 4, 5, 6, 11) then a range of
3075 * luminance values can be set from 0 to 255.
3076 * For NeoPixel LED an overall brightness parameter is also available.
3078 * *** CAUTION ***
3079 * LED Strips require a MOSFET Chip between PWM lines and LEDs,
3080 * as the Arduino cannot handle the current the LEDs will require.
3081 * Failure to follow this precaution can destroy your Arduino!
3082 * NOTE: A separate 5V power supply is required! The NeoPixel LED needs
3083 * more current than the Arduino 5V linear regulator can produce.
3084 * *** CAUTION ***
3086 * LED Type. Enable only one of the following two options.
3088 //#define RGB_LED
3089 //#define RGBW_LED
3091 #if EITHER(RGB_LED, RGBW_LED)
3092 //#define RGB_LED_R_PIN 34
3093 //#define RGB_LED_G_PIN 43
3094 //#define RGB_LED_B_PIN 35
3095 //#define RGB_LED_W_PIN -1
3096 #endif
3098 // Support for Adafruit NeoPixel LED driver
3099 //#define NEOPIXEL_LED
3100 #if ENABLED(NEOPIXEL_LED)
3101 #define NEOPIXEL_TYPE NEO_GRBW // NEO_GRBW, NEO_RGBW, NEO_GRB, NEO_RBG, etc.
3102 // See https://github.com/adafruit/Adafruit_NeoPixel/blob/master/Adafruit_NeoPixel.h
3103 //#define NEOPIXEL_PIN 4 // LED driving pin
3104 //#define NEOPIXEL2_TYPE NEOPIXEL_TYPE
3105 //#define NEOPIXEL2_PIN 5
3106 #define NEOPIXEL_PIXELS 30 // Number of LEDs in the strip. (Longest strip when NEOPIXEL2_SEPARATE is disabled.)
3107 #define NEOPIXEL_IS_SEQUENTIAL // Sequential display for temperature change - LED by LED. Disable to change all LEDs at once.
3108 #define NEOPIXEL_BRIGHTNESS 127 // Initial brightness (0-255)
3109 //#define NEOPIXEL_STARTUP_TEST // Cycle through colors at startup
3111 // Support for second Adafruit NeoPixel LED driver controlled with M150 S1 ...
3112 //#define NEOPIXEL2_SEPARATE
3113 #if ENABLED(NEOPIXEL2_SEPARATE)
3114 #define NEOPIXEL2_PIXELS 15 // Number of LEDs in the second strip
3115 #define NEOPIXEL2_BRIGHTNESS 127 // Initial brightness (0-255)
3116 #define NEOPIXEL2_STARTUP_TEST // Cycle through colors at startup
3117 #else
3118 //#define NEOPIXEL2_INSERIES // Default behavior is NeoPixel 2 in parallel
3119 #endif
3121 // Use some of the NeoPixel LEDs for static (background) lighting
3122 //#define NEOPIXEL_BKGD_INDEX_FIRST 0 // Index of the first background LED
3123 //#define NEOPIXEL_BKGD_INDEX_LAST 5 // Index of the last background LED
3124 //#define NEOPIXEL_BKGD_COLOR { 255, 255, 255, 0 } // R, G, B, W
3125 //#define NEOPIXEL_BKGD_ALWAYS_ON // Keep the backlight on when other NeoPixels are off
3126 #endif
3129 * Printer Event LEDs
3131 * During printing, the LEDs will reflect the printer status:
3133 * - Gradually change from blue to violet as the heated bed gets to target temp
3134 * - Gradually change from violet to red as the hotend gets to temperature
3135 * - Change to white to illuminate work surface
3136 * - Change to green once print has finished
3137 * - Turn off after the print has finished and the user has pushed a button
3139 #if ANY(BLINKM, RGB_LED, RGBW_LED, PCA9632, PCA9533, NEOPIXEL_LED)
3140 #define PRINTER_EVENT_LEDS
3141 #endif
3144 * Number of servos
3146 * For some servo-related options NUM_SERVOS will be set automatically.
3147 * Set this manually if there are extra servos needing manual control.
3148 * Set to 0 to turn off servo support.
3150 //#define NUM_SERVOS 3 // Note: Servo index starts with 0 for M280-M282 commands
3152 // (ms) Delay before the next move will start, to give the servo time to reach its target angle.
3153 // 300ms is a good value but you can try less delay.
3154 // If the servo can't reach the requested position, increase it.
3155 #define SERVO_DELAY { 300 }
3157 // Only power servos during movement, otherwise leave off to prevent jitter
3158 //#define DEACTIVATE_SERVOS_AFTER_MOVE
3160 // Edit servo angles with M281 and save to EEPROM with M500
3161 //#define EDITABLE_SERVO_ANGLES
3163 // Disable servo with M282 to reduce power consumption, noise, and heat when not in use
3164 //#define SERVO_DETACH_GCODE