My Marlin configs for Fabrikator Mini and CTC i3 Pro B
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Configuration_adv.h 89KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285
  1. /**
  2. * Marlin 3D Printer Firmware
  3. * Copyright (C) 2019 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
  4. *
  5. * Based on Sprinter and grbl.
  6. * Copyright (C) 2011 Camiel Gubbels / Erik van der Zalm
  7. *
  8. * This program is free software: you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation, either version 3 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  20. *
  21. */
  22. #pragma once
  23. /**
  24. * Configuration_adv.h
  25. *
  26. * Advanced settings.
  27. * Only change these if you know exactly what you're doing.
  28. * Some of these settings can damage your printer if improperly set!
  29. *
  30. * Basic settings can be found in Configuration.h
  31. *
  32. */
  33. #define CONFIGURATION_ADV_H_VERSION 020000
  34. // @section temperature
  35. //===========================================================================
  36. //=============================Thermal Settings ============================
  37. //===========================================================================
  38. //
  39. // Hephestos 2 24V heated bed upgrade kit.
  40. // https://store.bq.com/en/heated-bed-kit-hephestos2
  41. //
  42. //#define HEPHESTOS2_HEATED_BED_KIT
  43. #if ENABLED(HEPHESTOS2_HEATED_BED_KIT)
  44. #undef TEMP_SENSOR_BED
  45. #define TEMP_SENSOR_BED 70
  46. #define HEATER_BED_INVERTING true
  47. #endif
  48. #if DISABLED(PIDTEMPBED)
  49. #define BED_CHECK_INTERVAL 5000 // ms between checks in bang-bang control
  50. #if ENABLED(BED_LIMIT_SWITCHING)
  51. #define BED_HYSTERESIS 2 // Only disable heating if T>target+BED_HYSTERESIS and enable heating if T>target-BED_HYSTERESIS
  52. #endif
  53. #endif
  54. /**
  55. * Thermal Protection provides additional protection to your printer from damage
  56. * and fire. Marlin always includes safe min and max temperature ranges which
  57. * protect against a broken or disconnected thermistor wire.
  58. *
  59. * The issue: If a thermistor falls out, it will report the much lower
  60. * temperature of the air in the room, and the the firmware will keep
  61. * the heater on.
  62. *
  63. * The solution: Once the temperature reaches the target, start observing.
  64. * If the temperature stays too far below the target (hysteresis) for too
  65. * long (period), the firmware will halt the machine as a safety precaution.
  66. *
  67. * If you get false positives for "Thermal Runaway", increase
  68. * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
  69. */
  70. #if ENABLED(THERMAL_PROTECTION_HOTENDS)
  71. #define THERMAL_PROTECTION_PERIOD 60 // Seconds
  72. #define THERMAL_PROTECTION_HYSTERESIS 10 // Degrees Celsius
  73. //#define ADAPTIVE_FAN_SLOWING // Slow part cooling fan if temperature drops
  74. #if ENABLED(ADAPTIVE_FAN_SLOWING) && ENABLED(PIDTEMP)
  75. //#define NO_FAN_SLOWING_IN_PID_TUNING // Don't slow fan speed during M303
  76. #endif
  77. /**
  78. * Whenever an M104, M109, or M303 increases the target temperature, the
  79. * firmware will wait for the WATCH_TEMP_PERIOD to expire. If the temperature
  80. * hasn't increased by WATCH_TEMP_INCREASE degrees, the machine is halted and
  81. * requires a hard reset. This test restarts with any M104/M109/M303, but only
  82. * if the current temperature is far enough below the target for a reliable
  83. * test.
  84. *
  85. * If you get false positives for "Heating failed", increase WATCH_TEMP_PERIOD
  86. * and/or decrease WATCH_TEMP_INCREASE. WATCH_TEMP_INCREASE should not be set
  87. * below 2.
  88. */
  89. #define WATCH_TEMP_PERIOD 60 // Seconds
  90. #define WATCH_TEMP_INCREASE 2 // Degrees Celsius
  91. #endif
  92. /**
  93. * Thermal Protection parameters for the bed are just as above for hotends.
  94. */
  95. #if ENABLED(THERMAL_PROTECTION_BED)
  96. #define THERMAL_PROTECTION_BED_PERIOD 60 // Seconds
  97. #define THERMAL_PROTECTION_BED_HYSTERESIS 5 // Degrees Celsius
  98. /**
  99. * As described above, except for the bed (M140/M190/M303).
  100. */
  101. #define WATCH_BED_TEMP_PERIOD 60 // Seconds
  102. #define WATCH_BED_TEMP_INCREASE 2 // Degrees Celsius
  103. #endif
  104. /**
  105. * Thermal Protection parameters for the heated chamber.
  106. */
  107. #if ENABLED(THERMAL_PROTECTION_CHAMBER)
  108. #define THERMAL_PROTECTION_CHAMBER_PERIOD 20 // Seconds
  109. #define THERMAL_PROTECTION_CHAMBER_HYSTERESIS 2 // Degrees Celsius
  110. /**
  111. * Heated chamber watch settings (M141/M191).
  112. */
  113. #define WATCH_CHAMBER_TEMP_PERIOD 60 // Seconds
  114. #define WATCH_CHAMBER_TEMP_INCREASE 2 // Degrees Celsius
  115. #endif
  116. #if ENABLED(PIDTEMP)
  117. // this adds an experimental additional term to the heating power, proportional to the extrusion speed.
  118. // if Kc is chosen well, the additional required power due to increased melting should be compensated.
  119. #define PID_EXTRUSION_SCALING
  120. #if ENABLED(PID_EXTRUSION_SCALING)
  121. #define DEFAULT_Kc (100) //heating power=Kc*(e_speed)
  122. #define LPQ_MAX_LEN 50
  123. #endif
  124. #endif
  125. /**
  126. * Automatic Temperature:
  127. * The hotend target temperature is calculated by all the buffered lines of gcode.
  128. * The maximum buffered steps/sec of the extruder motor is called "se".
  129. * Start autotemp mode with M109 S<mintemp> B<maxtemp> F<factor>
  130. * The target temperature is set to mintemp+factor*se[steps/sec] and is limited by
  131. * mintemp and maxtemp. Turn this off by executing M109 without F*
  132. * Also, if the temperature is set to a value below mintemp, it will not be changed by autotemp.
  133. * On an Ultimaker, some initial testing worked with M109 S215 B260 F1 in the start.gcode
  134. */
  135. #define AUTOTEMP
  136. #if ENABLED(AUTOTEMP)
  137. #define AUTOTEMP_OLDWEIGHT 0.98
  138. #endif
  139. // Show extra position information in M114
  140. #define M114_DETAIL
  141. // Show Temperature ADC value
  142. // Enable for M105 to include ADC values read from temperature sensors.
  143. //#define SHOW_TEMP_ADC_VALUES
  144. /**
  145. * High Temperature Thermistor Support
  146. *
  147. * Thermistors able to support high temperature tend to have a hard time getting
  148. * good readings at room and lower temperatures. This means HEATER_X_RAW_LO_TEMP
  149. * will probably be caught when the heating element first turns on during the
  150. * preheating process, which will trigger a min_temp_error as a safety measure
  151. * and force stop everything.
  152. * To circumvent this limitation, we allow for a preheat time (during which,
  153. * min_temp_error won't be triggered) and add a min_temp buffer to handle
  154. * aberrant readings.
  155. *
  156. * If you want to enable this feature for your hotend thermistor(s)
  157. * uncomment and set values > 0 in the constants below
  158. */
  159. // The number of consecutive low temperature errors that can occur
  160. // before a min_temp_error is triggered. (Shouldn't be more than 10.)
  161. //#define MAX_CONSECUTIVE_LOW_TEMPERATURE_ERROR_ALLOWED 0
  162. // The number of milliseconds a hotend will preheat before starting to check
  163. // the temperature. This value should NOT be set to the time it takes the
  164. // hot end to reach the target temperature, but the time it takes to reach
  165. // the minimum temperature your thermistor can read. The lower the better/safer.
  166. // This shouldn't need to be more than 30 seconds (30000)
  167. //#define MILLISECONDS_PREHEAT_TIME 0
  168. // @section extruder
  169. // Extruder runout prevention.
  170. // If the machine is idle and the temperature over MINTEMP
  171. // then extrude some filament every couple of SECONDS.
  172. //#define EXTRUDER_RUNOUT_PREVENT
  173. #if ENABLED(EXTRUDER_RUNOUT_PREVENT)
  174. #define EXTRUDER_RUNOUT_MINTEMP 190
  175. #define EXTRUDER_RUNOUT_SECONDS 30
  176. #define EXTRUDER_RUNOUT_SPEED 1500 // (mm/m)
  177. #define EXTRUDER_RUNOUT_EXTRUDE 5 // (mm)
  178. #endif
  179. // @section temperature
  180. // Calibration for AD595 / AD8495 sensor to adjust temperature measurements.
  181. // The final temperature is calculated as (measuredTemp * GAIN) + OFFSET.
  182. #define TEMP_SENSOR_AD595_OFFSET 0.0
  183. #define TEMP_SENSOR_AD595_GAIN 1.0
  184. #define TEMP_SENSOR_AD8495_OFFSET 0.0
  185. #define TEMP_SENSOR_AD8495_GAIN 1.0
  186. /**
  187. * Controller Fan
  188. * To cool down the stepper drivers and MOSFETs.
  189. *
  190. * The fan will turn on automatically whenever any stepper is enabled
  191. * and turn off after a set period after all steppers are turned off.
  192. */
  193. //#define USE_CONTROLLER_FAN
  194. #if ENABLED(USE_CONTROLLER_FAN)
  195. //#define CONTROLLER_FAN_PIN -1 // Set a custom pin for the controller fan
  196. #define CONTROLLERFAN_SECS 60 // Duration in seconds for the fan to run after all motors are disabled
  197. #define CONTROLLERFAN_SPEED 255 // 255 == full speed
  198. #endif
  199. // When first starting the main fan, run it at full speed for the
  200. // given number of milliseconds. This gets the fan spinning reliably
  201. // before setting a PWM value. (Does not work with software PWM for fan on Sanguinololu)
  202. #define FAN_KICKSTART_TIME 100
  203. /**
  204. * PWM Fan Scaling
  205. *
  206. * Define the min/max speeds for PWM fans (as set with M106).
  207. *
  208. * With these options the M106 0-255 value range is scaled to a subset
  209. * to ensure that the fan has enough power to spin, or to run lower
  210. * current fans with higher current. (e.g., 5V/12V fans with 12V/24V)
  211. * Value 0 always turns off the fan.
  212. *
  213. * Define one or both of these to override the default 0-255 range.
  214. */
  215. #define FAN_MIN_PWM 64
  216. //#define FAN_MAX_PWM 128
  217. // @section extruder
  218. /**
  219. * Extruder cooling fans
  220. *
  221. * Extruder auto fans automatically turn on when their extruders'
  222. * temperatures go above EXTRUDER_AUTO_FAN_TEMPERATURE.
  223. *
  224. * Your board's pins file specifies the recommended pins. Override those here
  225. * or set to -1 to disable completely.
  226. *
  227. * Multiple extruders can be assigned to the same pin in which case
  228. * the fan will turn on when any selected extruder is above the threshold.
  229. */
  230. #define E0_AUTO_FAN_PIN -1
  231. #define E1_AUTO_FAN_PIN -1
  232. #define E2_AUTO_FAN_PIN -1
  233. #define E3_AUTO_FAN_PIN -1
  234. #define E4_AUTO_FAN_PIN -1
  235. #define E5_AUTO_FAN_PIN -1
  236. #define CHAMBER_AUTO_FAN_PIN -1
  237. #define EXTRUDER_AUTO_FAN_TEMPERATURE 50
  238. #define EXTRUDER_AUTO_FAN_SPEED 255 // 255 == full speed
  239. /**
  240. * Part-Cooling Fan Multiplexer
  241. *
  242. * This feature allows you to digitally multiplex the fan output.
  243. * The multiplexer is automatically switched at tool-change.
  244. * Set FANMUX[012]_PINs below for up to 2, 4, or 8 multiplexed fans.
  245. */
  246. #define FANMUX0_PIN -1
  247. #define FANMUX1_PIN -1
  248. #define FANMUX2_PIN -1
  249. /**
  250. * M355 Case Light on-off / brightness
  251. */
  252. #define CASE_LIGHT_ENABLE
  253. #if ENABLED(CASE_LIGHT_ENABLE)
  254. //#define CASE_LIGHT_PIN 8 // Now set in appropriate pins file
  255. #define INVERT_CASE_LIGHT false // Set true if Case Light is ON when pin is LOW
  256. #define CASE_LIGHT_DEFAULT_ON true // Set default power-up state on
  257. #ifdef ROXYs_TRex
  258. #define CASE_LIGHT_DEFAULT_BRIGHTNESS 25 // Set default power-up brightness (0-255, requires PWM pin)
  259. #else
  260. #define CASE_LIGHT_DEFAULT_BRIGHTNESS 255 // Set default power-up brightness (0-255, requires PWM pin)
  261. #endif
  262. #define MENU_ITEM_CASE_LIGHT // Add a Case Light option to the LCD main menu
  263. //#define CASE_LIGHT_USE_NEOPIXEL // Use Neopixel LED as case light, requires NEOPIXEL_LED.
  264. #if ENABLED(CASE_LIGHT_USE_NEOPIXEL)
  265. #define CASE_LIGHT_NEOPIXEL_COLOR { 255, 255, 255, 255 } // { Red, Green, Blue, White }
  266. #endif
  267. #endif
  268. //===========================================================================
  269. //============================ Mechanical Settings ==========================
  270. //===========================================================================
  271. // @section homing
  272. // If you want endstops to stay on (by default) even when not homing
  273. // enable this option. Override at any time with M120, M121.
  274. //#define ENDSTOPS_ALWAYS_ON_DEFAULT
  275. // @section extras
  276. //#define Z_LATE_ENABLE // Enable Z the last moment. Needed if your Z driver overheats.
  277. // Employ an external closed loop controller. Override pins here if needed.
  278. //#define EXTERNAL_CLOSED_LOOP_CONTROLLER
  279. #if ENABLED(EXTERNAL_CLOSED_LOOP_CONTROLLER)
  280. //#define CLOSED_LOOP_ENABLE_PIN -1
  281. //#define CLOSED_LOOP_MOVE_COMPLETE_PIN -1
  282. #endif
  283. /**
  284. * Dual Steppers / Dual Endstops
  285. *
  286. * This section will allow you to use extra E drivers to drive a second motor for X, Y, or Z axes.
  287. *
  288. * For example, set X_DUAL_STEPPER_DRIVERS setting to use a second motor. If the motors need to
  289. * spin in opposite directions set INVERT_X2_VS_X_DIR. If the second motor needs its own endstop
  290. * set X_DUAL_ENDSTOPS. This can adjust for "racking." Use X2_USE_ENDSTOP to set the endstop plug
  291. * that should be used for the second endstop. Extra endstops will appear in the output of 'M119'.
  292. *
  293. * Use X_DUAL_ENDSTOP_ADJUSTMENT to adjust for mechanical imperfection. After homing both motors
  294. * this offset is applied to the X2 motor. To find the offset home the X axis, and measure the error
  295. * in X2. Dual endstop offsets can be set at runtime with 'M666 X<offset> Y<offset> Z<offset>'.
  296. */
  297. //#define X_DUAL_STEPPER_DRIVERS
  298. #if ENABLED(X_DUAL_STEPPER_DRIVERS)
  299. #define INVERT_X2_VS_X_DIR true // Set 'true' if X motors should rotate in opposite directions
  300. //#define X_DUAL_ENDSTOPS
  301. #if ENABLED(X_DUAL_ENDSTOPS)
  302. #define X2_USE_ENDSTOP _XMAX_
  303. #define X_DUAL_ENDSTOPS_ADJUSTMENT 0
  304. #endif
  305. #endif
  306. //#define Y_DUAL_STEPPER_DRIVERS
  307. #if ENABLED(Y_DUAL_STEPPER_DRIVERS)
  308. #define INVERT_Y2_VS_Y_DIR true // Set 'true' if Y motors should rotate in opposite directions
  309. //#define Y_DUAL_ENDSTOPS
  310. #if ENABLED(Y_DUAL_ENDSTOPS)
  311. #define Y2_USE_ENDSTOP _YMAX_
  312. #define Y_DUAL_ENDSTOPS_ADJUSTMENT 0
  313. #endif
  314. #endif
  315. //#define Z_DUAL_STEPPER_DRIVERS
  316. #if ENABLED(Z_DUAL_STEPPER_DRIVERS)
  317. //#define Z_DUAL_ENDSTOPS
  318. #if ENABLED(Z_DUAL_ENDSTOPS)
  319. #define Z2_USE_ENDSTOP _XMAX_
  320. #define Z_DUAL_ENDSTOPS_ADJUSTMENT 0
  321. #endif
  322. #endif
  323. //#define Z_TRIPLE_STEPPER_DRIVERS
  324. #if ENABLED(Z_TRIPLE_STEPPER_DRIVERS)
  325. //#define Z_TRIPLE_ENDSTOPS
  326. #if ENABLED(Z_TRIPLE_ENDSTOPS)
  327. #define Z2_USE_ENDSTOP _XMAX_
  328. #define Z3_USE_ENDSTOP _YMAX_
  329. #define Z_TRIPLE_ENDSTOPS_ADJUSTMENT2 0
  330. #define Z_TRIPLE_ENDSTOPS_ADJUSTMENT3 0
  331. #endif
  332. #endif
  333. /**
  334. * Dual X Carriage
  335. *
  336. * This setup has two X carriages that can move independently, each with its own hotend.
  337. * The carriages can be used to print an object with two colors or materials, or in
  338. * "duplication mode" it can print two identical or X-mirrored objects simultaneously.
  339. * The inactive carriage is parked automatically to prevent oozing.
  340. * X1 is the left carriage, X2 the right. They park and home at opposite ends of the X axis.
  341. * By default the X2 stepper is assigned to the first unused E plug on the board.
  342. */
  343. #define DUAL_X_CARRIAGE
  344. #if ENABLED(DUAL_X_CARRIAGE)
  345. #define X1_MIN_POS X_MIN_POS // set minimum to ensure first x-carriage doesn't hit the parked second X-carriage
  346. #define X1_MAX_POS X_BED_SIZE // set maximum to ensure first x-carriage doesn't hit the parked second X-carriage
  347. #define X2_MIN_POS 0 // set minimum to ensure second x-carriage doesn't hit the parked first X-carriage
  348. #define X2_MAX_POS (442-4.0) // set maximum to the distance between toolheads when both heads are homed
  349. #define X2_HOME_DIR 1 // the second X-carriage always homes to the maximum endstop position
  350. #define X2_HOME_POS X2_MAX_POS // default home position is the maximum carriage position
  351. // However: In this mode the HOTEND_OFFSET_X value for the second extruder provides a software
  352. // override for X2_HOME_POS. This also allow recalibration of the distance between the two endstops
  353. // without modifying the firmware (through the "M218 T1 X???" command).
  354. // Remember: you should set the second extruder x-offset to 0 in your slicer.
  355. // There are a few selectable movement modes for dual x-carriages using M605 S<mode>
  356. // Mode 0 (DXC_FULL_CONTROL_MODE): Full control. The slicer has full control over both x-carriages and can achieve optimal travel results
  357. // as long as it supports dual x-carriages. (M605 S0)
  358. // Mode 1 (DXC_AUTO_PARK_MODE) : Auto-park mode. The firmware will automatically park and unpark the x-carriages on tool changes so
  359. // that additional slicer support is not required. (M605 S1)
  360. // Mode 2 (DXC_DUPLICATION_MODE) : Duplication mode. The firmware will transparently make the second x-carriage and extruder copy all
  361. // actions of the first x-carriage. This allows the printer to print 2 arbitrary items at
  362. // once. (2nd extruder x offset and temp offset are set using: M605 S2 [Xnnn] [Rmmm])
  363. // Mode 3 (DXC_SCALED_DUPLICATION_MODE) : Not working yet, but support routines in place
  364. // This is the default power-up mode which can be later using M605.
  365. #define DEFAULT_DUAL_X_CARRIAGE_MODE DXC_AUTO_PARK_MODE
  366. // Default x offset in duplication mode (typically set to half print bed width)
  367. #define DEFAULT_DUPLICATION_X_OFFSET 200
  368. #endif // DUAL_X_CARRIAGE
  369. // Activate a solenoid on the active extruder with M380. Disable all with M381.
  370. // Define SOL0_PIN, SOL1_PIN, etc., for each extruder that has a solenoid.
  371. //#define EXT_SOLENOID
  372. // @section homing
  373. // Homing hits each endstop, retracts by these distances, then does a slower bump.
  374. #define X_HOME_BUMP_MM 5
  375. #define Y_HOME_BUMP_MM 5
  376. #define Z_HOME_BUMP_MM 2
  377. #define HOMING_BUMP_DIVISOR { 2, 2, 4 } // Re-Bump Speed Divisor (Divides the Homing Feedrate)
  378. #define QUICK_HOME // If homing includes X and Y, do a diagonal move initially
  379. // When G28 is called, this option will make Y home before X
  380. //#define HOME_Y_BEFORE_X
  381. // Enable this if X or Y can't home without homing the other axis first.
  382. //#define CODEPENDENT_XY_HOMING
  383. /**
  384. * Z Steppers Auto-Alignment
  385. * Add the G34 command to align multiple Z steppers using a bed probe.
  386. */
  387. //#define Z_STEPPER_AUTO_ALIGN
  388. #if ENABLED(Z_STEPPER_AUTO_ALIGN)
  389. // Define probe X and Y positions for Z1, Z2 [, Z3]
  390. #define Z_STEPPER_ALIGN_X { 10, 150, 290 }
  391. #define Z_STEPPER_ALIGN_Y { 290, 10, 290 }
  392. // Set number of iterations to align
  393. #define Z_STEPPER_ALIGN_ITERATIONS 3
  394. // Enable to restore leveling setup after operation
  395. #define RESTORE_LEVELING_AFTER_G34
  396. // Use the amplification factor to de-/increase correction step.
  397. // In case the stepper (spindle) position is further out than the test point
  398. // Use a value > 1. NOTE: This may cause instability
  399. #define Z_STEPPER_ALIGN_AMP 1.0
  400. // Stop criterion. If the accuracy is better than this stop iterating early
  401. #define Z_STEPPER_ALIGN_ACC 0.02
  402. #endif
  403. // @section machine
  404. #define AXIS_RELATIVE_MODES {false, false, false, false}
  405. // Allow duplication mode with a basic dual-nozzle extruder
  406. //#define DUAL_NOZZLE_DUPLICATION_MODE
  407. // By default pololu step drivers require an active high signal. However, some high power drivers require an active low signal as step.
  408. #define INVERT_X_STEP_PIN false
  409. #define INVERT_Y_STEP_PIN false
  410. #define INVERT_Z_STEP_PIN false
  411. #define INVERT_E_STEP_PIN false
  412. // Default stepper release if idle. Set to 0 to deactivate.
  413. // Steppers will shut down DEFAULT_STEPPER_DEACTIVE_TIME seconds after the last move when DISABLE_INACTIVE_? is true.
  414. // Time can be set by M18 and M84.
  415. #define DEFAULT_STEPPER_DEACTIVE_TIME 600
  416. #define DISABLE_INACTIVE_X true
  417. #define DISABLE_INACTIVE_Y true
  418. #define DISABLE_INACTIVE_Z true // set to false if the nozzle will fall down on your printed part when print has finished.
  419. #define DISABLE_INACTIVE_E true
  420. #define DEFAULT_MINIMUMFEEDRATE 0.0 // minimum feedrate
  421. #define DEFAULT_MINTRAVELFEEDRATE 0.0
  422. //#define HOME_AFTER_DEACTIVATE // Require rehoming after steppers are deactivated
  423. // @section lcd
  424. #if ENABLED(ULTIPANEL)
  425. #define MANUAL_FEEDRATE {50*60, 50*60, 4*60, 60} // Feedrates for manual moves along X, Y, Z, E from panel
  426. #define MANUAL_E_MOVES_RELATIVE // Show LCD extruder moves as relative rather than absolute positions
  427. #define ULTIPANEL_FEEDMULTIPLY // Comment to disable setting feedrate multiplier via encoder
  428. #endif
  429. // @section extras
  430. // minimum time in microseconds that a movement needs to take if the buffer is emptied.
  431. #define DEFAULT_MINSEGMENTTIME 20000
  432. // If defined the movements slow down when the look ahead buffer is only half full
  433. #define SLOWDOWN
  434. // Frequency limit
  435. // See nophead's blog for more info
  436. // Not working O
  437. //#define XY_FREQUENCY_LIMIT 15
  438. // Minimum planner junction speed. Sets the default minimum speed the planner plans for at the end
  439. // of the buffer and all stops. This should not be much greater than zero and should only be changed
  440. // if unwanted behavior is observed on a user's machine when running at very slow speeds.
  441. #define MINIMUM_PLANNER_SPEED 0.05 // (mm/s)
  442. //
  443. // Backlash Compensation
  444. // Adds extra movement to axes on direction-changes to account for backlash.
  445. //
  446. //#define BACKLASH_COMPENSATION
  447. #if ENABLED(BACKLASH_COMPENSATION)
  448. // Define values for backlash distance and correction.
  449. // If BACKLASH_GCODE is enabled these values are the defaults.
  450. #define BACKLASH_DISTANCE_MM { 0, 0, 0 } // (mm)
  451. #define BACKLASH_CORRECTION 0.0 // 0.0 = no correction; 1.0 = full correction
  452. // Set BACKLASH_SMOOTHING_MM to spread backlash correction over multiple segments
  453. // to reduce print artifacts. (Enabling this is costly in memory and computation!)
  454. //#define BACKLASH_SMOOTHING_MM 3 // (mm)
  455. // Add runtime configuration and tuning of backlash values (M425)
  456. //#define BACKLASH_GCODE
  457. #if ENABLED(BACKLASH_GCODE)
  458. // Measure the Z backlash when probing (G29) and set with "M425 Z"
  459. #define MEASURE_BACKLASH_WHEN_PROBING
  460. #if ENABLED(MEASURE_BACKLASH_WHEN_PROBING)
  461. // When measuring, the probe will move up to BACKLASH_MEASUREMENT_LIMIT
  462. // mm away from point of contact in BACKLASH_MEASUREMENT_RESOLUTION
  463. // increments while checking for the contact to be broken.
  464. #define BACKLASH_MEASUREMENT_LIMIT 0.5 // (mm)
  465. #define BACKLASH_MEASUREMENT_RESOLUTION 0.005 // (mm)
  466. #define BACKLASH_MEASUREMENT_FEEDRATE Z_PROBE_SPEED_SLOW // (mm/m)
  467. #endif
  468. #endif
  469. #endif
  470. /**
  471. * Automatic backlash, position and hotend offset calibration
  472. *
  473. * Enable G425 to run automatic calibration using an electrically-
  474. * conductive cube, bolt, or washer mounted on the bed.
  475. *
  476. * G425 uses the probe to touch the top and sides of the calibration object
  477. * on the bed and measures and/or correct positional offsets, axis backlash
  478. * and hotend offsets.
  479. *
  480. * Note: HOTEND_OFFSET and CALIBRATION_OBJECT_CENTER must be set to within
  481. * ±5mm of true values for G425 to succeed.
  482. */
  483. //#define CALIBRATION_GCODE
  484. #if ENABLED(CALIBRATION_GCODE)
  485. #define CALIBRATION_MEASUREMENT_RESOLUTION 0.01 // mm
  486. #define CALIBRATION_FEEDRATE_SLOW 60 // mm/m
  487. #define CALIBRATION_FEEDRATE_FAST 1200 // mm/m
  488. #define CALIBRATION_FEEDRATE_TRAVEL 3000 // mm/m
  489. // The following parameters refer to the conical section of the nozzle tip.
  490. #define CALIBRATION_NOZZLE_TIP_HEIGHT 1.0 // mm
  491. #define CALIBRATION_NOZZLE_OUTER_DIAMETER 2.0 // mm
  492. // Uncomment to enable reporting (required for "G425 V", but consumes PROGMEM).
  493. //#define CALIBRATION_REPORTING
  494. // The true location and dimension the cube/bolt/washer on the bed.
  495. #define CALIBRATION_OBJECT_CENTER { 264.0, -22.0, -2.0} // mm
  496. #define CALIBRATION_OBJECT_DIMENSIONS { 10.0, 10.0, 10.0} // mm
  497. // Comment out any sides which are unreachable by the probe. For best
  498. // auto-calibration results, all sides must be reachable.
  499. #define CALIBRATION_MEASURE_RIGHT
  500. #define CALIBRATION_MEASURE_FRONT
  501. #define CALIBRATION_MEASURE_LEFT
  502. #define CALIBRATION_MEASURE_BACK
  503. // Probing at the exact top center only works if the center is flat. If
  504. // probing on a screwhead or hollow washer, probe near the edges.
  505. //#define CALIBRATION_MEASURE_AT_TOP_EDGES
  506. // Define pin which is read during calibration
  507. #ifndef CALIBRATION_PIN
  508. #define CALIBRATION_PIN -1 // Override in pins.h or set to -1 to use your Z endstop
  509. #define CALIBRATION_PIN_INVERTING false // set to true to invert the pin
  510. //#define CALIBRATION_PIN_PULLDOWN
  511. #define CALIBRATION_PIN_PULLUP
  512. #endif
  513. #endif
  514. /**
  515. * Adaptive Step Smoothing increases the resolution of multi-axis moves, particularly at step frequencies
  516. * below 1kHz (for AVR) or 10kHz (for ARM), where aliasing between axes in multi-axis moves causes audible
  517. * vibration and surface artifacts. The algorithm adapts to provide the best possible step smoothing at the
  518. * lowest stepping frequencies.
  519. */
  520. //#define ADAPTIVE_STEP_SMOOTHING
  521. /**
  522. * Custom Microstepping
  523. * Override as-needed for your setup. Up to 3 MS pins are supported.
  524. */
  525. //#define MICROSTEP1 LOW,LOW,LOW
  526. //#define MICROSTEP2 HIGH,LOW,LOW
  527. //#define MICROSTEP4 LOW,HIGH,LOW
  528. //#define MICROSTEP8 HIGH,HIGH,LOW
  529. //#define MICROSTEP16 LOW,LOW,HIGH
  530. //#define MICROSTEP32 HIGH,LOW,HIGH
  531. // Microstep setting (Only functional when stepper driver microstep pins are connected to MCU.
  532. #define MICROSTEP_MODES { 16, 16, 16, 16, 16, 16 } // [1,2,4,8,16]
  533. /**
  534. * @section stepper motor current
  535. *
  536. * Some boards have a means of setting the stepper motor current via firmware.
  537. *
  538. * The power on motor currents are set by:
  539. * PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
  540. * known compatible chips: A4982
  541. * DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
  542. * known compatible chips: AD5206
  543. * DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
  544. * known compatible chips: MCP4728
  545. * DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, AZTEEG_X5_MINI_WIFI, MIGHTYBOARD_REVE
  546. * known compatible chips: MCP4451, MCP4018
  547. *
  548. * Motor currents can also be set by M907 - M910 and by the LCD.
  549. * M907 - applies to all.
  550. * M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
  551. * M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
  552. */
  553. //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 } // Values in milliamps
  554. //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 } // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
  555. //#define DAC_MOTOR_CURRENT_DEFAULT { 70, 80, 90, 80 } // Default drive percent - X, Y, Z, E axis
  556. // Use an I2C based DIGIPOT (e.g., Azteeg X3 Pro)
  557. //#define DIGIPOT_I2C
  558. #if ENABLED(DIGIPOT_I2C) && !defined(DIGIPOT_I2C_ADDRESS_A)
  559. /**
  560. * Common slave addresses:
  561. *
  562. * A (A shifted) B (B shifted) IC
  563. * Smoothie 0x2C (0x58) 0x2D (0x5A) MCP4451
  564. * AZTEEG_X3_PRO 0x2C (0x58) 0x2E (0x5C) MCP4451
  565. * AZTEEG_X5_MINI_WIFI 0x58 0x5C MCP4451
  566. * MIGHTYBOARD_REVE 0x2F (0x5E) MCP4018
  567. */
  568. #define DIGIPOT_I2C_ADDRESS_A 0x2C // unshifted slave address for first DIGIPOT
  569. #define DIGIPOT_I2C_ADDRESS_B 0x2D // unshifted slave address for second DIGIPOT
  570. #endif
  571. //#define DIGIPOT_MCP4018 // Requires library from https://github.com/stawel/SlowSoftI2CMaster
  572. #define DIGIPOT_I2C_NUM_CHANNELS 8 // 5DPRINT: 4 AZTEEG_X3_PRO: 8 MKS SBASE: 5
  573. // Actual motor currents in Amps. The number of entries must match DIGIPOT_I2C_NUM_CHANNELS.
  574. // These correspond to the physical drivers, so be mindful if the order is changed.
  575. #define DIGIPOT_I2C_MOTOR_CURRENTS { 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 } // AZTEEG_X3_PRO
  576. //===========================================================================
  577. //=============================Additional Features===========================
  578. //===========================================================================
  579. // @section lcd
  580. // Change values more rapidly when the encoder is rotated faster
  581. #define ENCODER_RATE_MULTIPLIER
  582. #if ENABLED(ENCODER_RATE_MULTIPLIER)
  583. #define ENCODER_10X_STEPS_PER_SEC 30 // (steps/s) Encoder rate for 10x speed
  584. #define ENCODER_100X_STEPS_PER_SEC 80 // (steps/s) Encoder rate for 100x speed
  585. #endif
  586. // Play a beep when the feedrate is changed from the Status Screen
  587. //#define BEEP_ON_FEEDRATE_CHANGE
  588. #if ENABLED(BEEP_ON_FEEDRATE_CHANGE)
  589. #define FEEDRATE_CHANGE_BEEP_DURATION 10
  590. #define FEEDRATE_CHANGE_BEEP_FREQUENCY 440
  591. #endif
  592. // Include a page of printer information in the LCD Main Menu
  593. #define LCD_INFO_MENU
  594. // Scroll a longer status message into view
  595. #define STATUS_MESSAGE_SCROLLING
  596. // On the Info Screen, display XY with one decimal place when possible
  597. #define LCD_DECIMAL_SMALL_XY
  598. // The timeout (in ms) to return to the status screen from sub-menus
  599. #define LCD_TIMEOUT_TO_STATUS 15000
  600. // Add an 'M73' G-code to set the current percentage
  601. #define LCD_SET_PROGRESS_MANUALLY
  602. #if HAS_CHARACTER_LCD && HAS_PRINT_PROGRESS
  603. //#define LCD_PROGRESS_BAR // Show a progress bar on HD44780 LCDs for SD printing
  604. #if ENABLED(LCD_PROGRESS_BAR)
  605. #define PROGRESS_BAR_BAR_TIME 2000 // (ms) Amount of time to show the bar
  606. #define PROGRESS_BAR_MSG_TIME 3000 // (ms) Amount of time to show the status message
  607. #define PROGRESS_MSG_EXPIRE 0 // (ms) Amount of time to retain the status message (0=forever)
  608. //#define PROGRESS_MSG_ONCE // Show the message for MSG_TIME then clear it
  609. //#define LCD_PROGRESS_BAR_TEST // Add a menu item to test the progress bar
  610. #endif
  611. #endif
  612. /**
  613. * LED Control Menu
  614. * Enable this feature to add LED Control to the LCD menu
  615. */
  616. //#define LED_CONTROL_MENU
  617. #if ENABLED(LED_CONTROL_MENU)
  618. #define LED_COLOR_PRESETS // Enable the Preset Color menu option
  619. #if ENABLED(LED_COLOR_PRESETS)
  620. #define LED_USER_PRESET_RED 255 // User defined RED value
  621. #define LED_USER_PRESET_GREEN 128 // User defined GREEN value
  622. #define LED_USER_PRESET_BLUE 0 // User defined BLUE value
  623. #define LED_USER_PRESET_WHITE 255 // User defined WHITE value
  624. #define LED_USER_PRESET_BRIGHTNESS 255 // User defined intensity
  625. //#define LED_USER_PRESET_STARTUP // Have the printer display the user preset color on startup
  626. #endif
  627. #endif // LED_CONTROL_MENU
  628. #if ENABLED(SDSUPPORT)
  629. // Some RAMPS and other boards don't detect when an SD card is inserted. You can work
  630. // around this by connecting a push button or single throw switch to the pin defined
  631. // as SD_DETECT_PIN in your board's pins definitions.
  632. // This setting should be disabled unless you are using a push button, pulling the pin to ground.
  633. // Note: This is always disabled for ULTIPANEL (except ELB_FULL_GRAPHIC_CONTROLLER).
  634. #define SD_DETECT_INVERTED
  635. #define SD_FINISHED_STEPPERRELEASE true // Disable steppers when SD Print is finished
  636. #define SD_FINISHED_RELEASECOMMAND "M84 X Y Z E" // You might want to keep the Z enabled so your bed stays in place.
  637. // Reverse SD sort to show "more recent" files first, according to the card's FAT.
  638. // Since the FAT gets out of order with usage, SDCARD_SORT_ALPHA is recommended.
  639. #define SDCARD_RATHERRECENTFIRST
  640. // Add an option in the menu to run all auto#.g files
  641. //#define MENU_ADDAUTOSTART
  642. /**
  643. * Continue after Power-Loss (Creality3D)
  644. *
  645. * Store the current state to the SD Card at the start of each layer
  646. * during SD printing. If the recovery file is found at boot time, present
  647. * an option on the LCD screen to continue the print from the last-known
  648. * point in the file.
  649. */
  650. //#define POWER_LOSS_RECOVERY
  651. #if ENABLED(POWER_LOSS_RECOVERY)
  652. //#define POWER_LOSS_PIN 44 // Pin to detect power loss
  653. //#define POWER_LOSS_STATE HIGH // State of pin indicating power loss
  654. #endif
  655. /**
  656. * Sort SD file listings in alphabetical order.
  657. *
  658. * With this option enabled, items on SD cards will be sorted
  659. * by name for easier navigation.
  660. *
  661. * By default...
  662. *
  663. * - Use the slowest -but safest- method for sorting.
  664. * - Folders are sorted to the top.
  665. * - The sort key is statically allocated.
  666. * - No added G-code (M34) support.
  667. * - 40 item sorting limit. (Items after the first 40 are unsorted.)
  668. *
  669. * SD sorting uses static allocation (as set by SDSORT_LIMIT), allowing the
  670. * compiler to calculate the worst-case usage and throw an error if the SRAM
  671. * limit is exceeded.
  672. *
  673. * - SDSORT_USES_RAM provides faster sorting via a static directory buffer.
  674. * - SDSORT_USES_STACK does the same, but uses a local stack-based buffer.
  675. * - SDSORT_CACHE_NAMES will retain the sorted file listing in RAM. (Expensive!)
  676. * - SDSORT_DYNAMIC_RAM only uses RAM when the SD menu is visible. (Use with caution!)
  677. */
  678. //#define SDCARD_SORT_ALPHA
  679. // SD Card Sorting options
  680. #if ENABLED(SDCARD_SORT_ALPHA)
  681. #define SDSORT_LIMIT 20 // Maximum number of sorted items (10-256). Costs 27 bytes each.
  682. #define FOLDER_SORTING -1 // -1=above 0=none 1=below
  683. #define SDSORT_GCODE true // Allow turning sorting on/off with LCD and M34 g-code.
  684. #define SDSORT_USES_RAM false // Pre-allocate a static array for faster pre-sorting.
  685. #define SDSORT_USES_STACK false // Prefer the stack for pre-sorting to give back some SRAM. (Negated by next 2 options.)
  686. #define SDSORT_CACHE_NAMES false // Keep sorted items in RAM longer for speedy performance. Most expensive option.
  687. #define SDSORT_DYNAMIC_RAM false // Use dynamic allocation (within SD menus). Least expensive option. Set SDSORT_LIMIT before use!
  688. #define SDSORT_CACHE_VFATS 2 // Maximum number of 13-byte VFAT entries to use for sorting.
  689. // Note: Only affects SCROLL_LONG_FILENAMES with SDSORT_CACHE_NAMES but not SDSORT_DYNAMIC_RAM.
  690. #endif
  691. // This allows hosts to request long names for files and folders with M33
  692. #define LONG_FILENAME_HOST_SUPPORT
  693. // Enable this option to scroll long filenames in the SD card menu
  694. #define SCROLL_LONG_FILENAMES
  695. /**
  696. * This option allows you to abort SD printing when any endstop is triggered.
  697. * This feature must be enabled with "M540 S1" or from the LCD menu.
  698. * To have any effect, endstops must be enabled during SD printing.
  699. */
  700. //#define ABORT_ON_ENDSTOP_HIT_FEATURE_ENABLED
  701. /**
  702. * This option makes it easier to print the same SD Card file again.
  703. * On print completion the LCD Menu will open with the file selected.
  704. * You can just click to start the print, or navigate elsewhere.
  705. */
  706. //#define SD_REPRINT_LAST_SELECTED_FILE
  707. /**
  708. * Auto-report SdCard status with M27 S<seconds>
  709. */
  710. #define AUTO_REPORT_SD_STATUS
  711. /**
  712. * Support for USB thumb drives using an Arduino USB Host Shield or
  713. * equivalent MAX3421E breakout board. The USB thumb drive will appear
  714. * to Marlin as an SD card.
  715. *
  716. * The MAX3421E must be assigned the same pins as the SD card reader, with
  717. * the following pin mapping:
  718. *
  719. * SCLK, MOSI, MISO --> SCLK, MOSI, MISO
  720. * INT --> SD_DETECT_PIN
  721. * SS --> SDSS
  722. */
  723. //#define USB_FLASH_DRIVE_SUPPORT
  724. #if ENABLED(USB_FLASH_DRIVE_SUPPORT)
  725. #define USB_CS_PIN SDSS
  726. #define USB_INTR_PIN SD_DETECT_PIN
  727. #endif
  728. /**
  729. * When using a bootloader that supports SD-Firmware-Flashing,
  730. * add a menu item to activate SD-FW-Update on the next reboot.
  731. *
  732. * Requires ATMEGA2560 (Arduino Mega)
  733. *
  734. * Tested with this bootloader:
  735. * https://github.com/FleetProbe/MicroBridge-Arduino-ATMega2560
  736. */
  737. //#define SD_FIRMWARE_UPDATE
  738. #if ENABLED(SD_FIRMWARE_UPDATE)
  739. #define SD_FIRMWARE_UPDATE_EEPROM_ADDR 0x1FF
  740. #define SD_FIRMWARE_UPDATE_ACTIVE_VALUE 0xF0
  741. #define SD_FIRMWARE_UPDATE_INACTIVE_VALUE 0xFF
  742. #endif
  743. // Add an optimized binary file transfer mode, initiated with 'M28 B1'
  744. //#define BINARY_FILE_TRANSFER
  745. #endif // SDSUPPORT
  746. /**
  747. * Additional options for Graphical Displays
  748. *
  749. * Use the optimizations here to improve printing performance,
  750. * which can be adversely affected by graphical display drawing,
  751. * especially when doing several short moves, and when printing
  752. * on DELTA and SCARA machines.
  753. *
  754. * Some of these options may result in the display lagging behind
  755. * controller events, as there is a trade-off between reliable
  756. * printing performance versus fast display updates.
  757. */
  758. #if HAS_GRAPHICAL_LCD
  759. // Show SD percentage next to the progress bar
  760. //#define DOGM_SD_PERCENT
  761. // Enable to save many cycles by drawing a hollow frame on the Info Screen
  762. #define XYZ_HOLLOW_FRAME
  763. // Enable to save many cycles by drawing a hollow frame on Menu Screens
  764. #define MENU_HOLLOW_FRAME
  765. // A bigger font is available for edit items. Costs 3120 bytes of PROGMEM.
  766. // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
  767. #define USE_BIG_EDIT_FONT
  768. // A smaller font may be used on the Info Screen. Costs 2300 bytes of PROGMEM.
  769. // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
  770. //#define USE_SMALL_INFOFONT
  771. // Enable this option and reduce the value to optimize screen updates.
  772. // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
  773. //#define DOGM_SPI_DELAY_US 5
  774. // Swap the CW/CCW indicators in the graphics overlay
  775. //#define OVERLAY_GFX_REVERSE
  776. /**
  777. * ST7920-based LCDs can emulate a 16 x 4 character display using
  778. * the ST7920 character-generator for very fast screen updates.
  779. * Enable LIGHTWEIGHT_UI to use this special display mode.
  780. *
  781. * Since LIGHTWEIGHT_UI has limited space, the position and status
  782. * message occupy the same line. Set STATUS_EXPIRE_SECONDS to the
  783. * length of time to display the status message before clearing.
  784. *
  785. * Set STATUS_EXPIRE_SECONDS to zero to never clear the status.
  786. * This will prevent position updates from being displayed.
  787. */
  788. #if ENABLED(U8GLIB_ST7920)
  789. //#define LIGHTWEIGHT_UI
  790. #if ENABLED(LIGHTWEIGHT_UI)
  791. #define STATUS_EXPIRE_SECONDS 20
  792. #endif
  793. #endif
  794. /**
  795. * Status (Info) Screen customizations
  796. * These options may affect code size and screen render time.
  797. * Custom status screens can forcibly override these settings.
  798. */
  799. //#define STATUS_COMBINE_HEATERS // Use combined heater images instead of separate ones
  800. //#define STATUS_HOTEND_NUMBERLESS // Use plain hotend icons instead of numbered ones (with 2+ hotends)
  801. #define STATUS_HOTEND_INVERTED // Show solid nozzle bitmaps when heating (Requires STATUS_HOTEND_ANIM)
  802. #define STATUS_HOTEND_ANIM // Use a second bitmap to indicate hotend heating
  803. #define STATUS_BED_ANIM // Use a second bitmap to indicate bed heating
  804. //#define STATUS_ALT_BED_BITMAP // Use the alternative bed bitmap
  805. //#define STATUS_ALT_FAN_BITMAP // Use the alternative fan bitmap
  806. //#define STATUS_FAN_FRAMES 3 // :[0,1,2,3,4] Number of fan animation frames
  807. //#define STATUS_HEAT_PERCENT // Show heating in a progress bar
  808. #endif // HAS_GRAPHICAL_LCD
  809. // @section safety
  810. // The hardware watchdog should reset the microcontroller disabling all outputs,
  811. // in case the firmware gets stuck and doesn't do temperature regulation.
  812. #define USE_WATCHDOG
  813. #if ENABLED(USE_WATCHDOG)
  814. // If you have a watchdog reboot in an ArduinoMega2560 then the device will hang forever, as a watchdog reset will leave the watchdog on.
  815. // The "WATCHDOG_RESET_MANUAL" goes around this by not using the hardware reset.
  816. // However, THIS FEATURE IS UNSAFE!, as it will only work if interrupts are disabled. And the code could hang in an interrupt routine with interrupts disabled.
  817. //#define WATCHDOG_RESET_MANUAL
  818. #endif
  819. // @section lcd
  820. /**
  821. * Babystepping enables movement of the axes by tiny increments without changing
  822. * the current position values. This feature is used primarily to adjust the Z
  823. * axis in the first layer of a print in real-time.
  824. *
  825. * Warning: Does not respect endstops!
  826. */
  827. #define BABYSTEPPING
  828. #if ENABLED(BABYSTEPPING)
  829. //#define BABYSTEP_WITHOUT_HOMING
  830. //#define BABYSTEP_XY // Also enable X/Y Babystepping. Not supported on DELTA!
  831. #define BABYSTEP_INVERT_Z false // Change if Z babysteps should go the other way
  832. #define BABYSTEP_MULTIPLICATOR 40 // Babysteps are very small. Increase for faster motion.
  833. #define DOUBLECLICK_FOR_Z_BABYSTEPPING // Double-click on the Status Screen for Z Babystepping.
  834. #if ENABLED(DOUBLECLICK_FOR_Z_BABYSTEPPING)
  835. #define DOUBLECLICK_MAX_INTERVAL 1250 // Maximum interval between clicks, in milliseconds.
  836. // Note: Extra time may be added to mitigate controller latency.
  837. //#define BABYSTEP_ALWAYS_AVAILABLE // Allow babystepping at all times (not just during movement).
  838. //#define MOVE_Z_WHEN_IDLE // Jump to the move Z menu on doubleclick when printer is idle.
  839. #if ENABLED(MOVE_Z_WHEN_IDLE)
  840. #define MOVE_Z_IDLE_MULTIPLICATOR 1 // Multiply 1mm by this factor for the move step size.
  841. #endif
  842. #endif
  843. //#define BABYSTEP_ZPROBE_OFFSET // Combine M851 Z and Babystepping
  844. #if ENABLED(BABYSTEP_ZPROBE_OFFSET)
  845. //#define BABYSTEP_HOTEND_Z_OFFSET // For multiple hotends, babystep relative Z offsets
  846. //#define BABYSTEP_ZPROBE_GFX_OVERLAY // Enable graphical overlay on Z-offset editor
  847. #endif
  848. #endif
  849. // @section extruder
  850. /**
  851. * Linear Pressure Control v1.5
  852. *
  853. * Assumption: advance [steps] = k * (delta velocity [steps/s])
  854. * K=0 means advance disabled.
  855. *
  856. * NOTE: K values for LIN_ADVANCE 1.5 differ from earlier versions!
  857. *
  858. * Set K around 0.22 for 3mm PLA Direct Drive with ~6.5cm between the drive gear and heatbreak.
  859. * Larger K values will be needed for flexible filament and greater distances.
  860. * If this algorithm produces a higher speed offset than the extruder can handle (compared to E jerk)
  861. * print acceleration will be reduced during the affected moves to keep within the limit.
  862. *
  863. * See http://marlinfw.org/docs/features/lin_advance.html for full instructions.
  864. * Mention @Sebastianv650 on GitHub to alert the author of any issues.
  865. */
  866. //#define LIN_ADVANCE
  867. #if ENABLED(LIN_ADVANCE)
  868. #define LIN_ADVANCE_K 0.22 // Unit: mm compression per 1mm/s extruder speed
  869. //#define LA_DEBUG // If enabled, this will generate debug information output over USB.
  870. #endif
  871. // @section leveling
  872. #if ENABLED(MESH_BED_LEVELING) || ENABLED(AUTO_BED_LEVELING_UBL)
  873. // Override the mesh area if the automatic (max) area is too large
  874. //#define MESH_MIN_X 4
  875. //#define MESH_MIN_Y MESH_INSET
  876. //#define MESH_MAX_X X_BED_SIZE - (MESH_INSET)
  877. //#define MESH_MAX_Y Y_BED_SIZE - (MESH_INSET)
  878. #endif
  879. /**
  880. * Repeatedly attempt G29 leveling until it succeeds.
  881. * Stop after G29_MAX_RETRIES attempts.
  882. */
  883. //#define G29_RETRY_AND_RECOVER
  884. #if ENABLED(G29_RETRY_AND_RECOVER)
  885. #define G29_MAX_RETRIES 3
  886. #define G29_HALT_ON_FAILURE
  887. /**
  888. * Specify the GCODE commands that will be executed when leveling succeeds,
  889. * between attempts, and after the maximum number of retries have been tried.
  890. */
  891. #define G29_SUCCESS_COMMANDS "M117 Bed leveling done."
  892. #define G29_RECOVER_COMMANDS "M117 Probe failed. Rewiping.\nG28\nG12 P0 S12 T0"
  893. #define G29_FAILURE_COMMANDS "M117 Bed leveling failed.\nG0 Z10\nM300 P25 S880\nM300 P50 S0\nM300 P25 S880\nM300 P50 S0\nM300 P25 S880\nM300 P50 S0\nG4 S1"
  894. #endif
  895. // @section extras
  896. //
  897. // G2/G3 Arc Support
  898. //
  899. #define ARC_SUPPORT // Disable this feature to save ~3226 bytes
  900. #if ENABLED(ARC_SUPPORT)
  901. #define MM_PER_ARC_SEGMENT 1 // Length of each arc segment
  902. #define N_ARC_CORRECTION 25 // Number of intertpolated segments between corrections
  903. //#define ARC_P_CIRCLES // Enable the 'P' parameter to specify complete circles
  904. //#define CNC_WORKSPACE_PLANES // Allow G2/G3 to operate in XY, ZX, or YZ planes
  905. #endif
  906. // Support for G5 with XYZE destination and IJPQ offsets. Requires ~2666 bytes.
  907. //#define BEZIER_CURVE_SUPPORT
  908. // G38.2 and G38.3 Probe Target
  909. // Set MULTIPLE_PROBING if you want G38 to double touch
  910. //#define G38_PROBE_TARGET
  911. #if ENABLED(G38_PROBE_TARGET)
  912. #define G38_MINIMUM_MOVE 0.0275 // minimum distance in mm that will produce a move (determined using the print statement in check_move)
  913. #endif
  914. // Moves (or segments) with fewer steps than this will be joined with the next move
  915. #define MIN_STEPS_PER_SEGMENT 6
  916. /**
  917. * Minimum delay after setting the stepper DIR (in ns)
  918. * 0 : No delay (Expect at least 10µS since one Stepper ISR must transpire)
  919. * 20 : Minimum for TMC2xxx drivers
  920. * 200 : Minimum for A4988 drivers
  921. * 400 : Minimum for A5984 drivers
  922. * 500 : Minimum for LV8729 drivers (guess, no info in datasheet)
  923. * 650 : Minimum for DRV8825 drivers
  924. * 1500 : Minimum for TB6600 drivers (guess, no info in datasheet)
  925. * 15000 : Minimum for TB6560 drivers (guess, no info in datasheet)
  926. *
  927. * Override the default value based on the driver type set in Configuration.h.
  928. */
  929. //#define MINIMUM_STEPPER_DIR_DELAY 650
  930. /**
  931. * Minimum stepper driver pulse width (in µs)
  932. * 0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
  933. * 1 : Minimum for A4988, A5984, and LV8729 stepper drivers
  934. * 2 : Minimum for DRV8825 stepper drivers
  935. * 3 : Minimum for TB6600 stepper drivers
  936. * 30 : Minimum for TB6560 stepper drivers
  937. *
  938. * Override the default value based on the driver type set in Configuration.h.
  939. */
  940. //#define MINIMUM_STEPPER_PULSE 2
  941. /**
  942. * Maximum stepping rate (in Hz) the stepper driver allows
  943. * If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
  944. * 500000 : Maximum for A4988 stepper driver
  945. * 400000 : Maximum for TMC2xxx stepper drivers
  946. * 250000 : Maximum for DRV8825 stepper driver
  947. * 150000 : Maximum for TB6600 stepper driver
  948. * 130000 : Maximum for LV8729 stepper driver
  949. * 15000 : Maximum for TB6560 stepper driver
  950. *
  951. * Override the default value based on the driver type set in Configuration.h.
  952. */
  953. //#define MAXIMUM_STEPPER_RATE 250000
  954. // @section temperature
  955. // Control heater 0 and heater 1 in parallel.
  956. //#define HEATERS_PARALLEL
  957. //===========================================================================
  958. //================================= Buffers =================================
  959. //===========================================================================
  960. // @section hidden
  961. // The number of linear motions that can be in the plan at any give time.
  962. // THE BLOCK_BUFFER_SIZE NEEDS TO BE A POWER OF 2 (e.g. 8, 16, 32) because shifts and ors are used to do the ring-buffering.
  963. #if ENABLED(SDSUPPORT)
  964. #define BLOCK_BUFFER_SIZE 16 // SD,LCD,Buttons take more memory, block buffer needs to be smaller
  965. #else
  966. #define BLOCK_BUFFER_SIZE 16 // maximize block buffer
  967. #endif
  968. // @section serial
  969. // The ASCII buffer for serial input
  970. #define MAX_CMD_SIZE 96
  971. #define BUFSIZE 4
  972. // Transmission to Host Buffer Size
  973. // To save 386 bytes of PROGMEM (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
  974. // To buffer a simple "ok" you need 4 bytes.
  975. // For ADVANCED_OK (M105) you need 32 bytes.
  976. // For debug-echo: 128 bytes for the optimal speed.
  977. // Other output doesn't need to be that speedy.
  978. // :[0, 2, 4, 8, 16, 32, 64, 128, 256]
  979. #define TX_BUFFER_SIZE 0
  980. // Host Receive Buffer Size
  981. // Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
  982. // To use flow control, set this buffer size to at least 1024 bytes.
  983. // :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
  984. //#define RX_BUFFER_SIZE 1024
  985. #if RX_BUFFER_SIZE >= 1024
  986. // Enable to have the controller send XON/XOFF control characters to
  987. // the host to signal the RX buffer is becoming full.
  988. //#define SERIAL_XON_XOFF
  989. #endif
  990. #if ENABLED(SDSUPPORT)
  991. // Enable this option to collect and display the maximum
  992. // RX queue usage after transferring a file to SD.
  993. //#define SERIAL_STATS_MAX_RX_QUEUED
  994. // Enable this option to collect and display the number
  995. // of dropped bytes after a file transfer to SD.
  996. //#define SERIAL_STATS_DROPPED_RX
  997. #endif
  998. // Enable an emergency-command parser to intercept certain commands as they
  999. // enter the serial receive buffer, so they cannot be blocked.
  1000. // Currently handles M108, M112, M410
  1001. // Does not work on boards using AT90USB (USBCON) processors!
  1002. //#define EMERGENCY_PARSER
  1003. // Bad Serial-connections can miss a received command by sending an 'ok'
  1004. // Therefore some clients abort after 30 seconds in a timeout.
  1005. // Some other clients start sending commands while receiving a 'wait'.
  1006. // This "wait" is only sent when the buffer is empty. 1 second is a good value here.
  1007. //#define NO_TIMEOUTS 1000 // Milliseconds
  1008. // Some clients will have this feature soon. This could make the NO_TIMEOUTS unnecessary.
  1009. //#define ADVANCED_OK
  1010. // Printrun may have trouble receiving long strings all at once.
  1011. // This option inserts short delays between lines of serial output.
  1012. #define SERIAL_OVERRUN_PROTECTION
  1013. // @section extras
  1014. /**
  1015. * Extra Fan Speed
  1016. * Adds a secondary fan speed for each print-cooling fan.
  1017. * 'M106 P<fan> T3-255' : Set a secondary speed for <fan>
  1018. * 'M106 P<fan> T2' : Use the set secondary speed
  1019. * 'M106 P<fan> T1' : Restore the previous fan speed
  1020. */
  1021. #define EXTRA_FAN_SPEED
  1022. /**
  1023. * Firmware-based and LCD-controlled retract
  1024. *
  1025. * Add G10 / G11 commands for automatic firmware-based retract / recover.
  1026. * Use M207 and M208 to define parameters for retract / recover.
  1027. *
  1028. * Use M209 to enable or disable auto-retract.
  1029. * With auto-retract enabled, all G1 E moves within the set range
  1030. * will be converted to firmware-based retract/recover moves.
  1031. *
  1032. * Be sure to turn off auto-retract during filament change.
  1033. *
  1034. * Note that M207 / M208 / M209 settings are saved to EEPROM.
  1035. *
  1036. */
  1037. //#define FWRETRACT
  1038. #if ENABLED(FWRETRACT)
  1039. #define FWRETRACT_AUTORETRACT // costs ~500 bytes of PROGMEM
  1040. #if ENABLED(FWRETRACT_AUTORETRACT)
  1041. #define MIN_AUTORETRACT 0.1 // When auto-retract is on, convert E moves of this length and over
  1042. #define MAX_AUTORETRACT 10.0 // Upper limit for auto-retract conversion
  1043. #endif
  1044. #define RETRACT_LENGTH 3 // Default retract length (positive mm)
  1045. #define RETRACT_LENGTH_SWAP 13 // Default swap retract length (positive mm), for extruder change
  1046. #define RETRACT_FEEDRATE 45 // Default feedrate for retracting (mm/s)
  1047. #define RETRACT_ZRAISE 0 // Default retract Z-raise (mm)
  1048. #define RETRACT_RECOVER_LENGTH 0 // Default additional recover length (mm, added to retract length when recovering)
  1049. #define RETRACT_RECOVER_LENGTH_SWAP 0 // Default additional swap recover length (mm, added to retract length when recovering from extruder change)
  1050. #define RETRACT_RECOVER_FEEDRATE 8 // Default feedrate for recovering from retraction (mm/s)
  1051. #define RETRACT_RECOVER_FEEDRATE_SWAP 8 // Default feedrate for recovering from swap retraction (mm/s)
  1052. #if ENABLED(MIXING_EXTRUDER)
  1053. //#define RETRACT_SYNC_MIXING // Retract and restore all mixing steppers simultaneously
  1054. #endif
  1055. #endif
  1056. /**
  1057. * Universal tool change settings.
  1058. * Applies to all types of extruders except where explicitly noted.
  1059. */
  1060. #if EXTRUDERS > 1
  1061. // Z raise distance for tool-change, as needed for some extruders
  1062. #define TOOLCHANGE_ZRAISE 2 // (mm)
  1063. // Retract and prime filament on tool-change
  1064. //#define TOOLCHANGE_FILAMENT_SWAP
  1065. #if ENABLED(TOOLCHANGE_FILAMENT_SWAP)
  1066. #define TOOLCHANGE_FIL_SWAP_LENGTH 12 // (mm)
  1067. #define TOOLCHANGE_FIL_EXTRA_PRIME 2 // (mm)
  1068. #define TOOLCHANGE_FIL_SWAP_RETRACT_SPEED 3600 // (mm/m)
  1069. #define TOOLCHANGE_FIL_SWAP_PRIME_SPEED 3600 // (mm/m)
  1070. #endif
  1071. /**
  1072. * Position to park head during tool change.
  1073. * Doesn't apply to SWITCHING_TOOLHEAD, DUAL_X_CARRIAGE, or PARKING_EXTRUDER
  1074. */
  1075. //#define TOOLCHANGE_PARK
  1076. #if ENABLED(TOOLCHANGE_PARK)
  1077. #define TOOLCHANGE_PARK_XY { X_MIN_POS + 10, Y_MIN_POS + 10 }
  1078. #define TOOLCHANGE_PARK_XY_FEEDRATE 6000 // (mm/m)
  1079. #endif
  1080. #endif
  1081. /**
  1082. * Advanced Pause
  1083. * Experimental feature for filament change support and for parking the nozzle when paused.
  1084. * Adds the GCode M600 for initiating filament change.
  1085. * If PARK_HEAD_ON_PAUSE enabled, adds the GCode M125 to pause printing and park the nozzle.
  1086. *
  1087. * Requires an LCD display.
  1088. * Requires NOZZLE_PARK_FEATURE.
  1089. * This feature is required for the default FILAMENT_RUNOUT_SCRIPT.
  1090. */
  1091. #define ADVANCED_PAUSE_FEATURE
  1092. #if ENABLED(ADVANCED_PAUSE_FEATURE)
  1093. #define PAUSE_PARK_RETRACT_FEEDRATE 7 // (mm/s) Initial retract feedrate.
  1094. #define PAUSE_PARK_RETRACT_LENGTH 1 // (mm) Initial retract.
  1095. // This short retract is done immediately, before parking the nozzle.
  1096. #define FILAMENT_CHANGE_UNLOAD_FEEDRATE 15 // (mm/s) Unload filament feedrate. This can be pretty fast.
  1097. #define FILAMENT_CHANGE_UNLOAD_ACCEL 15 // (mm/s^2) Lower acceleration may allow a faster feedrate.
  1098. #define FILAMENT_CHANGE_UNLOAD_LENGTH 85 // (mm) The length of filament for a complete unload.
  1099. // For Bowden, the full length of the tube and nozzle.
  1100. // For direct drive, the full length of the nozzle.
  1101. // Set to 0 for manual unloading.
  1102. #define FILAMENT_CHANGE_SLOW_LOAD_FEEDRATE 3 // (mm/s) Slow move when starting load.
  1103. #define FILAMENT_CHANGE_SLOW_LOAD_LENGTH 1 // (mm) Slow length, to allow time to insert material.
  1104. // 0 to disable start loading and skip to fast load only
  1105. #define FILAMENT_CHANGE_FAST_LOAD_FEEDRATE 4 // (mm/s) Load filament feedrate. This can be pretty fast.
  1106. #define FILAMENT_CHANGE_FAST_LOAD_ACCEL 15 // (mm/s^2) Lower acceleration may allow a faster feedrate.
  1107. #define FILAMENT_CHANGE_FAST_LOAD_LENGTH 60 // (mm) Load length of filament, from extruder gear to nozzle.
  1108. // For Bowden, the full length of the tube and nozzle.
  1109. // For direct drive, the full length of the nozzle.
  1110. //#define ADVANCED_PAUSE_CONTINUOUS_PURGE // Purge continuously up to the purge length until interrupted.
  1111. #define ADVANCED_PAUSE_PURGE_FEEDRATE 2 // (mm/s) Extrude feedrate (after loading). Should be slower than load feedrate.
  1112. #define ADVANCED_PAUSE_PURGE_LENGTH 20 // (mm) Length to extrude after loading.
  1113. // Set to 0 for manual extrusion.
  1114. // Filament can be extruded repeatedly from the Filament Change menu
  1115. // until extrusion is consistent, and to purge old filament.
  1116. #define ADVANCED_PAUSE_RESUME_PRIME 0 // (mm) Extra distance to prime nozzle after returning from park.
  1117. // Filament Unload does a Retract, Delay, and Purge first:
  1118. #define FILAMENT_UNLOAD_RETRACT_LENGTH 0 // (mm) Unload initial retract length.
  1119. #define FILAMENT_UNLOAD_DELAY 500 // (ms) Delay for the filament to cool after retract.
  1120. #define FILAMENT_UNLOAD_PURGE_LENGTH 0 // (mm) An unretract is done, then this length is purged.
  1121. #define PAUSE_PARK_NOZZLE_TIMEOUT (3*60) // (seconds) Time limit before the nozzle is turned off for safety.
  1122. #define FILAMENT_CHANGE_ALERT_BEEPS 3 // Number of alert beeps to play when a response is needed.
  1123. #define PAUSE_PARK_NO_STEPPER_TIMEOUT // Enable for XYZ steppers to stay powered on during filament change.
  1124. #define PARK_HEAD_ON_PAUSE // Park the nozzle during pause and filament change.
  1125. #define HOME_BEFORE_FILAMENT_CHANGE // Ensure homing has been completed prior to parking for filament change
  1126. #define FILAMENT_LOAD_UNLOAD_GCODES // Add M701/M702 Load/Unload G-codes, plus Load/Unload in the LCD Prepare menu.
  1127. #define FILAMENT_UNLOAD_ALL_EXTRUDERS // Allow M702 to unload all extruders above a minimum target temp (as set by M302)
  1128. #endif
  1129. // @section tmc
  1130. /**
  1131. * TMC26X Stepper Driver options
  1132. *
  1133. * The TMC26XStepper library is required for this stepper driver.
  1134. * https://github.com/trinamic/TMC26XStepper
  1135. */
  1136. #if HAS_DRIVER(TMC26X)
  1137. #if AXIS_DRIVER_TYPE_X(TMC26X)
  1138. #define X_MAX_CURRENT 1000 // (mA)
  1139. #define X_SENSE_RESISTOR 91 // (mOhms)
  1140. #define X_MICROSTEPS 16 // Number of microsteps
  1141. #endif
  1142. #if AXIS_DRIVER_TYPE_X2(TMC26X)
  1143. #define X2_MAX_CURRENT 1000
  1144. #define X2_SENSE_RESISTOR 91
  1145. #define X2_MICROSTEPS 16
  1146. #endif
  1147. #if AXIS_DRIVER_TYPE_Y(TMC26X)
  1148. #define Y_MAX_CURRENT 1000
  1149. #define Y_SENSE_RESISTOR 91
  1150. #define Y_MICROSTEPS 16
  1151. #endif
  1152. #if AXIS_DRIVER_TYPE_Y2(TMC26X)
  1153. #define Y2_MAX_CURRENT 1000
  1154. #define Y2_SENSE_RESISTOR 91
  1155. #define Y2_MICROSTEPS 16
  1156. #endif
  1157. #if AXIS_DRIVER_TYPE_Z(TMC26X)
  1158. #define Z_MAX_CURRENT 1000
  1159. #define Z_SENSE_RESISTOR 91
  1160. #define Z_MICROSTEPS 16
  1161. #endif
  1162. #if AXIS_DRIVER_TYPE_Z2(TMC26X)
  1163. #define Z2_MAX_CURRENT 1000
  1164. #define Z2_SENSE_RESISTOR 91
  1165. #define Z2_MICROSTEPS 16
  1166. #endif
  1167. #if AXIS_DRIVER_TYPE_Z3(TMC26X)
  1168. #define Z3_MAX_CURRENT 1000
  1169. #define Z3_SENSE_RESISTOR 91
  1170. #define Z3_MICROSTEPS 16
  1171. #endif
  1172. #if AXIS_DRIVER_TYPE_E0(TMC26X)
  1173. #define E0_MAX_CURRENT 1000
  1174. #define E0_SENSE_RESISTOR 91
  1175. #define E0_MICROSTEPS 16
  1176. #endif
  1177. #if AXIS_DRIVER_TYPE_E1(TMC26X)
  1178. #define E1_MAX_CURRENT 1000
  1179. #define E1_SENSE_RESISTOR 91
  1180. #define E1_MICROSTEPS 16
  1181. #endif
  1182. #if AXIS_DRIVER_TYPE_E2(TMC26X)
  1183. #define E2_MAX_CURRENT 1000
  1184. #define E2_SENSE_RESISTOR 91
  1185. #define E2_MICROSTEPS 16
  1186. #endif
  1187. #if AXIS_DRIVER_TYPE_E3(TMC26X)
  1188. #define E3_MAX_CURRENT 1000
  1189. #define E3_SENSE_RESISTOR 91
  1190. #define E3_MICROSTEPS 16
  1191. #endif
  1192. #if AXIS_DRIVER_TYPE_E4(TMC26X)
  1193. #define E4_MAX_CURRENT 1000
  1194. #define E4_SENSE_RESISTOR 91
  1195. #define E4_MICROSTEPS 16
  1196. #endif
  1197. #if AXIS_DRIVER_TYPE_E5(TMC26X)
  1198. #define E5_MAX_CURRENT 1000
  1199. #define E5_SENSE_RESISTOR 91
  1200. #define E5_MICROSTEPS 16
  1201. #endif
  1202. #endif // TMC26X
  1203. // @section tmc_smart
  1204. /**
  1205. * To use TMC2130, TMC2160, TMC2660, TMC5130, TMC5160 stepper drivers in SPI mode
  1206. * connect your SPI pins to the hardware SPI interface on your board and define
  1207. * the required CS pins in your `pins_MYBOARD.h` file. (e.g., RAMPS 1.4 uses AUX3
  1208. * pins `X_CS_PIN 53`, `Y_CS_PIN 49`, etc.).
  1209. * You may also use software SPI if you wish to use general purpose IO pins.
  1210. *
  1211. * To use TMC2208 stepper UART-configurable stepper drivers connect #_SERIAL_TX_PIN
  1212. * to the driver side PDN_UART pin with a 1K resistor.
  1213. * To use the reading capabilities, also connect #_SERIAL_RX_PIN to PDN_UART without
  1214. * a resistor.
  1215. * The drivers can also be used with hardware serial.
  1216. *
  1217. * TMCStepper library is required to use TMC stepper drivers.
  1218. * https://github.com/teemuatlut/TMCStepper
  1219. */
  1220. #if HAS_TRINAMIC
  1221. #define HOLD_MULTIPLIER 0.5 // Scales down the holding current from run current
  1222. #define INTERPOLATE true // Interpolate X/Y/Z_MICROSTEPS to 256
  1223. #if AXIS_IS_TMC(X)
  1224. #define X_CURRENT 800 // (mA) RMS current. Multiply by 1.414 for peak current.
  1225. #define X_MICROSTEPS 16 // 0..256
  1226. #define X_RSENSE 0.11
  1227. #endif
  1228. #if AXIS_IS_TMC(X2)
  1229. #define X2_CURRENT 800
  1230. #define X2_MICROSTEPS 16
  1231. #define X2_RSENSE 0.11
  1232. #endif
  1233. #if AXIS_IS_TMC(Y)
  1234. #define Y_CURRENT 800
  1235. #define Y_MICROSTEPS 16
  1236. #define Y_RSENSE 0.11
  1237. #endif
  1238. #if AXIS_IS_TMC(Y2)
  1239. #define Y2_CURRENT 800
  1240. #define Y2_MICROSTEPS 16
  1241. #define Y2_RSENSE 0.11
  1242. #endif
  1243. #if AXIS_IS_TMC(Z)
  1244. #define Z_CURRENT 800
  1245. #define Z_MICROSTEPS 16
  1246. #define Z_RSENSE 0.11
  1247. #endif
  1248. #if AXIS_IS_TMC(Z2)
  1249. #define Z2_CURRENT 800
  1250. #define Z2_MICROSTEPS 16
  1251. #define Z2_RSENSE 0.11
  1252. #endif
  1253. #if AXIS_IS_TMC(Z3)
  1254. #define Z3_CURRENT 800
  1255. #define Z3_MICROSTEPS 16
  1256. #define Z3_RSENSE 0.11
  1257. #endif
  1258. #if AXIS_IS_TMC(E0)
  1259. #define E0_CURRENT 800
  1260. #define E0_MICROSTEPS 16
  1261. #define E0_RSENSE 0.11
  1262. #endif
  1263. #if AXIS_IS_TMC(E1)
  1264. #define E1_CURRENT 800
  1265. #define E1_MICROSTEPS 16
  1266. #define E1_RSENSE 0.11
  1267. #endif
  1268. #if AXIS_IS_TMC(E2)
  1269. #define E2_CURRENT 800
  1270. #define E2_MICROSTEPS 16
  1271. #define E2_RSENSE 0.11
  1272. #endif
  1273. #if AXIS_IS_TMC(E3)
  1274. #define E3_CURRENT 800
  1275. #define E3_MICROSTEPS 16
  1276. #define E3_RSENSE 0.11
  1277. #endif
  1278. #if AXIS_IS_TMC(E4)
  1279. #define E4_CURRENT 800
  1280. #define E4_MICROSTEPS 16
  1281. #define E4_RSENSE 0.11
  1282. #endif
  1283. #if AXIS_IS_TMC(E5)
  1284. #define E5_CURRENT 800
  1285. #define E5_MICROSTEPS 16
  1286. #define E5_RSENSE 0.11
  1287. #endif
  1288. /**
  1289. * Override default SPI pins for TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160 drivers here.
  1290. * The default pins can be found in your board's pins file.
  1291. */
  1292. //#define X_CS_PIN -1
  1293. //#define Y_CS_PIN -1
  1294. //#define Z_CS_PIN -1
  1295. //#define X2_CS_PIN -1
  1296. //#define Y2_CS_PIN -1
  1297. //#define Z2_CS_PIN -1
  1298. //#define Z3_CS_PIN -1
  1299. //#define E0_CS_PIN -1
  1300. //#define E1_CS_PIN -1
  1301. //#define E2_CS_PIN -1
  1302. //#define E3_CS_PIN -1
  1303. //#define E4_CS_PIN -1
  1304. //#define E5_CS_PIN -1
  1305. /**
  1306. * Use software SPI for TMC2130.
  1307. * Software option for SPI driven drivers (TMC2130, TMC2160, TMC2660, TMC5130 and TMC5160).
  1308. * The default SW SPI pins are defined the respective pins files,
  1309. * but you can override or define them here.
  1310. */
  1311. //#define TMC_USE_SW_SPI
  1312. //#define TMC_SW_MOSI -1
  1313. //#define TMC_SW_MISO -1
  1314. //#define TMC_SW_SCK -1
  1315. /**
  1316. * Software enable
  1317. *
  1318. * Use for drivers that do not use a dedicated enable pin, but rather handle the same
  1319. * function through a communication line such as SPI or UART.
  1320. */
  1321. //#define SOFTWARE_DRIVER_ENABLE
  1322. /**
  1323. * TMC2130, TMC2160, TMC2208, TMC5130 and TMC5160 only
  1324. * Use Trinamic's ultra quiet stepping mode.
  1325. * When disabled, Marlin will use spreadCycle stepping mode.
  1326. */
  1327. #define STEALTHCHOP_XY
  1328. #define STEALTHCHOP_Z
  1329. #define STEALTHCHOP_E
  1330. /**
  1331. * Optimize spreadCycle chopper parameters by using predefined parameter sets
  1332. * or with the help of an example included in the library.
  1333. * Provided parameter sets are
  1334. * CHOPPER_DEFAULT_12V
  1335. * CHOPPER_DEFAULT_19V
  1336. * CHOPPER_DEFAULT_24V
  1337. * CHOPPER_DEFAULT_36V
  1338. * CHOPPER_PRUSAMK3_24V // Imported parameters from the official Prusa firmware for MK3 (24V)
  1339. * CHOPPER_MARLIN_119 // Old defaults from Marlin v1.1.9
  1340. *
  1341. * Define you own with
  1342. * { <off_time[1..15]>, <hysteresis_end[-3..12]>, hysteresis_start[1..8] }
  1343. */
  1344. #define CHOPPER_TIMING CHOPPER_DEFAULT_12V
  1345. /**
  1346. * Monitor Trinamic drivers for error conditions,
  1347. * like overtemperature and short to ground. TMC2208 requires hardware serial.
  1348. * In the case of overtemperature Marlin can decrease the driver current until error condition clears.
  1349. * Other detected conditions can be used to stop the current print.
  1350. * Relevant g-codes:
  1351. * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given.
  1352. * M911 - Report stepper driver overtemperature pre-warn condition.
  1353. * M912 - Clear stepper driver overtemperature pre-warn condition flag.
  1354. * M122 - Report driver parameters (Requires TMC_DEBUG)
  1355. */
  1356. //#define MONITOR_DRIVER_STATUS
  1357. #if ENABLED(MONITOR_DRIVER_STATUS)
  1358. #define CURRENT_STEP_DOWN 50 // [mA]
  1359. #define REPORT_CURRENT_CHANGE
  1360. #define STOP_ON_ERROR
  1361. #endif
  1362. /**
  1363. * TMC2130, TMC2160, TMC2208, TMC5130 and TMC5160 only
  1364. * The driver will switch to spreadCycle when stepper speed is over HYBRID_THRESHOLD.
  1365. * This mode allows for faster movements at the expense of higher noise levels.
  1366. * STEALTHCHOP_(XY|Z|E) must be enabled to use HYBRID_THRESHOLD.
  1367. * M913 X/Y/Z/E to live tune the setting
  1368. */
  1369. //#define HYBRID_THRESHOLD
  1370. #define X_HYBRID_THRESHOLD 100 // [mm/s]
  1371. #define X2_HYBRID_THRESHOLD 100
  1372. #define Y_HYBRID_THRESHOLD 100
  1373. #define Y2_HYBRID_THRESHOLD 100
  1374. #define Z_HYBRID_THRESHOLD 3
  1375. #define Z2_HYBRID_THRESHOLD 3
  1376. #define Z3_HYBRID_THRESHOLD 3
  1377. #define E0_HYBRID_THRESHOLD 30
  1378. #define E1_HYBRID_THRESHOLD 30
  1379. #define E2_HYBRID_THRESHOLD 30
  1380. #define E3_HYBRID_THRESHOLD 30
  1381. #define E4_HYBRID_THRESHOLD 30
  1382. #define E5_HYBRID_THRESHOLD 30
  1383. /**
  1384. * TMC2130, TMC2160, TMC2660, TMC5130, and TMC5160 only
  1385. * Use StallGuard2 to sense an obstacle and trigger an endstop.
  1386. * Connect the stepper driver's DIAG1 pin to the X/Y endstop pin.
  1387. * X, Y, and Z homing will always be done in spreadCycle mode.
  1388. *
  1389. * X/Y/Z_STALL_SENSITIVITY is used for tuning the trigger sensitivity.
  1390. * Higher values make the system LESS sensitive.
  1391. * Lower value make the system MORE sensitive.
  1392. * Too low values can lead to false positives, while too high values will collide the axis without triggering.
  1393. * It is advised to set X/Y/Z_HOME_BUMP_MM to 0.
  1394. * M914 X/Y/Z to live tune the setting
  1395. */
  1396. //#define SENSORLESS_HOMING // TMC2130 only
  1397. /**
  1398. * Use StallGuard2 to probe the bed with the nozzle.
  1399. *
  1400. * CAUTION: This could cause damage to machines that use a lead screw or threaded rod
  1401. * to move the Z axis. Take extreme care when attempting to enable this feature.
  1402. */
  1403. //#define SENSORLESS_PROBING // TMC2130 only
  1404. #if ENABLED(SENSORLESS_HOMING) || ENABLED(SENSORLESS_PROBING)
  1405. #define X_STALL_SENSITIVITY 8
  1406. #define Y_STALL_SENSITIVITY 8
  1407. //#define Z_STALL_SENSITIVITY 8
  1408. #endif
  1409. /**
  1410. * Enable M122 debugging command for TMC stepper drivers.
  1411. * M122 S0/1 will enable continous reporting.
  1412. */
  1413. //#define TMC_DEBUG
  1414. /**
  1415. * You can set your own advanced settings by filling in predefined functions.
  1416. * A list of available functions can be found on the library github page
  1417. * https://github.com/teemuatlut/TMC2130Stepper
  1418. * https://github.com/teemuatlut/TMC2208Stepper
  1419. *
  1420. * Example:
  1421. * #define TMC_ADV() { \
  1422. * stepperX.diag0_temp_prewarn(1); \
  1423. * stepperY.interpolate(0); \
  1424. * }
  1425. */
  1426. #define TMC_ADV() { }
  1427. #endif // HAS_TRINAMIC
  1428. // @section L6470
  1429. /**
  1430. * L6470 Stepper Driver options
  1431. *
  1432. * Arduino-L6470 library (0.7.0 or higher) is required for this stepper driver.
  1433. * https://github.com/ameyer/Arduino-L6470
  1434. *
  1435. * Requires the following to be defined in your pins_YOUR_BOARD file
  1436. * L6470_CHAIN_SCK_PIN
  1437. * L6470_CHAIN_MISO_PIN
  1438. * L6470_CHAIN_MOSI_PIN
  1439. * L6470_CHAIN_SS_PIN
  1440. * L6470_RESET_CHAIN_PIN (optional)
  1441. */
  1442. #if HAS_DRIVER(L6470)
  1443. //#define L6470_CHITCHAT // Display additional status info
  1444. #if AXIS_DRIVER_TYPE_X(L6470)
  1445. #define X_MICROSTEPS 128 // Number of microsteps (VALID: 1, 2, 4, 8, 16, 32, 128)
  1446. #define X_OVERCURRENT 2000 // (mA) Current where the driver detects an over current (VALID: 375 x (1 - 16) - 6A max - rounds down)
  1447. #define X_STALLCURRENT 1500 // (mA) Current where the driver detects a stall (VALID: 31.25 * (1-128) - 4A max - rounds down)
  1448. #define X_MAX_VOLTAGE 127 // 0-255, Maximum effective voltage seen by stepper
  1449. #define X_CHAIN_POS 0 // Position in SPI chain, 0=Not in chain, 1=Nearest MOSI
  1450. #endif
  1451. #if AXIS_DRIVER_TYPE_X2(L6470)
  1452. #define X2_MICROSTEPS 128
  1453. #define X2_OVERCURRENT 2000
  1454. #define X2_STALLCURRENT 1500
  1455. #define X2_MAX_VOLTAGE 127
  1456. #define X2_CHAIN_POS 0
  1457. #endif
  1458. #if AXIS_DRIVER_TYPE_Y(L6470)
  1459. #define Y_MICROSTEPS 128
  1460. #define Y_OVERCURRENT 2000
  1461. #define Y_STALLCURRENT 1500
  1462. #define Y_MAX_VOLTAGE 127
  1463. #define Y_CHAIN_POS 0
  1464. #endif
  1465. #if AXIS_DRIVER_TYPE_Y2(L6470)
  1466. #define Y2_MICROSTEPS 128
  1467. #define Y2_OVERCURRENT 2000
  1468. #define Y2_STALLCURRENT 1500
  1469. #define Y2_MAX_VOLTAGE 127
  1470. #define Y2_CHAIN_POS 0
  1471. #endif
  1472. #if AXIS_DRIVER_TYPE_Z(L6470)
  1473. #define Z_MICROSTEPS 128
  1474. #define Z_OVERCURRENT 2000
  1475. #define Z_STALLCURRENT 1500
  1476. #define Z_MAX_VOLTAGE 127
  1477. #define Z_CHAIN_POS 0
  1478. #endif
  1479. #if AXIS_DRIVER_TYPE_Z2(L6470)
  1480. #define Z2_MICROSTEPS 128
  1481. #define Z2_OVERCURRENT 2000
  1482. #define Z2_STALLCURRENT 1500
  1483. #define Z2_MAX_VOLTAGE 127
  1484. #define Z2_CHAIN_POS 0
  1485. #endif
  1486. #if AXIS_DRIVER_TYPE_Z3(L6470)
  1487. #define Z3_MICROSTEPS 128
  1488. #define Z3_OVERCURRENT 2000
  1489. #define Z3_STALLCURRENT 1500
  1490. #define Z3_MAX_VOLTAGE 127
  1491. #define Z3_CHAIN_POS 0
  1492. #endif
  1493. #if AXIS_DRIVER_TYPE_E0(L6470)
  1494. #define E0_MICROSTEPS 128
  1495. #define E0_OVERCURRENT 2000
  1496. #define E0_STALLCURRENT 1500
  1497. #define E0_MAX_VOLTAGE 127
  1498. #define E0_CHAIN_POS 0
  1499. #endif
  1500. #if AXIS_DRIVER_TYPE_E1(L6470)
  1501. #define E1_MICROSTEPS 128
  1502. #define E1_OVERCURRENT 2000
  1503. #define E1_STALLCURRENT 1500
  1504. #define E1_MAX_VOLTAGE 127
  1505. #define E1_CHAIN_POS 0
  1506. #endif
  1507. #if AXIS_DRIVER_TYPE_E2(L6470)
  1508. #define E2_MICROSTEPS 128
  1509. #define E2_OVERCURRENT 2000
  1510. #define E2_STALLCURRENT 1500
  1511. #define E2_MAX_VOLTAGE 127
  1512. #define E2_CHAIN_POS 0
  1513. #endif
  1514. #if AXIS_DRIVER_TYPE_E3(L6470)
  1515. #define E3_MICROSTEPS 128
  1516. #define E3_OVERCURRENT 2000
  1517. #define E3_STALLCURRENT 1500
  1518. #define E3_MAX_VOLTAGE 127
  1519. #define E3_CHAIN_POS 0
  1520. #endif
  1521. #if AXIS_DRIVER_TYPE_E4(L6470)
  1522. #define E4_MICROSTEPS 128
  1523. #define E4_OVERCURRENT 2000
  1524. #define E4_STALLCURRENT 1500
  1525. #define E4_MAX_VOLTAGE 127
  1526. #define E4_CHAIN_POS 0
  1527. #endif
  1528. #if AXIS_DRIVER_TYPE_E5(L6470)
  1529. #define E5_MICROSTEPS 128
  1530. #define E5_OVERCURRENT 2000
  1531. #define E5_STALLCURRENT 1500
  1532. #define E5_MAX_VOLTAGE 127
  1533. #define E5_CHAIN_POS 0
  1534. #endif
  1535. /**
  1536. * Monitor L6470 drivers for error conditions like over temperature and over current.
  1537. * In the case of over temperature Marlin can decrease the drive until the error condition clears.
  1538. * Other detected conditions can be used to stop the current print.
  1539. * Relevant g-codes:
  1540. * M906 - I1/2/3/4/5 Set or get motor drive level using axis codes X, Y, Z, E. Report values if no axis codes given.
  1541. * I not present or I0 or I1 - X, Y, Z or E0
  1542. * I2 - X2, Y2, Z2 or E1
  1543. * I3 - Z3 or E3
  1544. * I4 - E4
  1545. * I5 - E5
  1546. * M916 - Increase drive level until get thermal warning
  1547. * M917 - Find minimum current thresholds
  1548. * M918 - Increase speed until max or error
  1549. * M122 S0/1 - Report driver parameters
  1550. */
  1551. //#define MONITOR_L6470_DRIVER_STATUS
  1552. #if ENABLED(MONITOR_L6470_DRIVER_STATUS)
  1553. #define KVAL_HOLD_STEP_DOWN 1
  1554. //#define L6470_STOP_ON_ERROR
  1555. #endif
  1556. #endif // L6470
  1557. /**
  1558. * TWI/I2C BUS
  1559. *
  1560. * This feature is an EXPERIMENTAL feature so it shall not be used on production
  1561. * machines. Enabling this will allow you to send and receive I2C data from slave
  1562. * devices on the bus.
  1563. *
  1564. * ; Example #1
  1565. * ; This macro send the string "Marlin" to the slave device with address 0x63 (99)
  1566. * ; It uses multiple M260 commands with one B<base 10> arg
  1567. * M260 A99 ; Target slave address
  1568. * M260 B77 ; M
  1569. * M260 B97 ; a
  1570. * M260 B114 ; r
  1571. * M260 B108 ; l
  1572. * M260 B105 ; i
  1573. * M260 B110 ; n
  1574. * M260 S1 ; Send the current buffer
  1575. *
  1576. * ; Example #2
  1577. * ; Request 6 bytes from slave device with address 0x63 (99)
  1578. * M261 A99 B5
  1579. *
  1580. * ; Example #3
  1581. * ; Example serial output of a M261 request
  1582. * echo:i2c-reply: from:99 bytes:5 data:hello
  1583. */
  1584. // @section i2cbus
  1585. //#define EXPERIMENTAL_I2CBUS
  1586. #define I2C_SLAVE_ADDRESS 0 // Set a value from 8 to 127 to act as a slave
  1587. // @section extras
  1588. /**
  1589. * Photo G-code
  1590. * Add the M240 G-code to take a photo.
  1591. * The photo can be triggered by a digital pin or a physical movement.
  1592. */
  1593. //#define PHOTO_GCODE
  1594. #if ENABLED(PHOTO_GCODE)
  1595. // A position to move to (and raise Z) before taking the photo
  1596. //#define PHOTO_POSITION { X_MAX_POS - 5, Y_MAX_POS, 0 } // { xpos, ypos, zraise } (M240 X Y Z)
  1597. //#define PHOTO_DELAY_MS 100 // (ms) Duration to pause before moving back (M240 P)
  1598. //#define PHOTO_RETRACT_MM 6.5 // (mm) E retract/recover for the photo move (M240 R S)
  1599. // Canon RC-1 or homebrew digital camera trigger
  1600. // Data from: http://www.doc-diy.net/photo/rc-1_hacked/
  1601. //#define PHOTOGRAPH_PIN 23
  1602. // Canon Hack Development Kit
  1603. // http://captain-slow.dk/2014/03/09/3d-printing-timelapses/
  1604. //#define CHDK_PIN 4
  1605. // Optional second move with delay to trigger the camera shutter
  1606. //#define PHOTO_SWITCH_POSITION { X_MAX_POS, Y_MAX_POS } // { xpos, ypos } (M240 I J)
  1607. // Duration to hold the switch or keep CHDK_PIN high
  1608. //#define PHOTO_SWITCH_MS 50 // (ms) (M240 D)
  1609. #endif
  1610. /**
  1611. * Spindle & Laser control
  1612. *
  1613. * Add the M3, M4, and M5 commands to turn the spindle/laser on and off, and
  1614. * to set spindle speed, spindle direction, and laser power.
  1615. *
  1616. * SuperPid is a router/spindle speed controller used in the CNC milling community.
  1617. * Marlin can be used to turn the spindle on and off. It can also be used to set
  1618. * the spindle speed from 5,000 to 30,000 RPM.
  1619. *
  1620. * You'll need to select a pin for the ON/OFF function and optionally choose a 0-5V
  1621. * hardware PWM pin for the speed control and a pin for the rotation direction.
  1622. *
  1623. * See http://marlinfw.org/docs/configuration/laser_spindle.html for more config details.
  1624. */
  1625. //#define SPINDLE_LASER_ENABLE
  1626. #if ENABLED(SPINDLE_LASER_ENABLE)
  1627. #define SPINDLE_LASER_ENABLE_INVERT false // set to "true" if the on/off function is reversed
  1628. #define SPINDLE_LASER_PWM true // set to true if your controller supports setting the speed/power
  1629. #define SPINDLE_LASER_PWM_INVERT true // set to "true" if the speed/power goes up when you want it to go slower
  1630. #define SPINDLE_LASER_POWERUP_DELAY 5000 // delay in milliseconds to allow the spindle/laser to come up to speed/power
  1631. #define SPINDLE_LASER_POWERDOWN_DELAY 5000 // delay in milliseconds to allow the spindle to stop
  1632. #define SPINDLE_DIR_CHANGE true // set to true if your spindle controller supports changing spindle direction
  1633. #define SPINDLE_INVERT_DIR false
  1634. #define SPINDLE_STOP_ON_DIR_CHANGE true // set to true if Marlin should stop the spindle before changing rotation direction
  1635. /**
  1636. * The M3 & M4 commands use the following equation to convert PWM duty cycle to speed/power
  1637. *
  1638. * SPEED/POWER = PWM duty cycle * SPEED_POWER_SLOPE + SPEED_POWER_INTERCEPT
  1639. * where PWM duty cycle varies from 0 to 255
  1640. *
  1641. * set the following for your controller (ALL MUST BE SET)
  1642. */
  1643. #define SPEED_POWER_SLOPE 118.4
  1644. #define SPEED_POWER_INTERCEPT 0
  1645. #define SPEED_POWER_MIN 5000
  1646. #define SPEED_POWER_MAX 30000 // SuperPID router controller 0 - 30,000 RPM
  1647. //#define SPEED_POWER_SLOPE 0.3922
  1648. //#define SPEED_POWER_INTERCEPT 0
  1649. //#define SPEED_POWER_MIN 10
  1650. //#define SPEED_POWER_MAX 100 // 0-100%
  1651. #endif
  1652. /**
  1653. * Filament Width Sensor
  1654. *
  1655. * Measures the filament width in real-time and adjusts
  1656. * flow rate to compensate for any irregularities.
  1657. *
  1658. * Also allows the measured filament diameter to set the
  1659. * extrusion rate, so the slicer only has to specify the
  1660. * volume.
  1661. *
  1662. * Only a single extruder is supported at this time.
  1663. *
  1664. * 34 RAMPS_14 : Analog input 5 on the AUX2 connector
  1665. * 81 PRINTRBOARD : Analog input 2 on the Exp1 connector (version B,C,D,E)
  1666. * 301 RAMBO : Analog input 3
  1667. *
  1668. * Note: May require analog pins to be defined for other boards.
  1669. */
  1670. //#define FILAMENT_WIDTH_SENSOR
  1671. #if ENABLED(FILAMENT_WIDTH_SENSOR)
  1672. #define FILAMENT_SENSOR_EXTRUDER_NUM 0 // Index of the extruder that has the filament sensor. :[0,1,2,3,4]
  1673. #define MEASUREMENT_DELAY_CM 14 // (cm) The distance from the filament sensor to the melting chamber
  1674. #define FILWIDTH_ERROR_MARGIN 1.0 // (mm) If a measurement differs too much from nominal width ignore it
  1675. #define MAX_MEASUREMENT_DELAY 20 // (bytes) Buffer size for stored measurements (1 byte per cm). Must be larger than MEASUREMENT_DELAY_CM.
  1676. #define DEFAULT_MEASURED_FILAMENT_DIA DEFAULT_NOMINAL_FILAMENT_DIA // Set measured to nominal initially
  1677. // Display filament width on the LCD status line. Status messages will expire after 5 seconds.
  1678. //#define FILAMENT_LCD_DISPLAY
  1679. #endif
  1680. /**
  1681. * CNC Coordinate Systems
  1682. *
  1683. * Enables G53 and G54-G59.3 commands to select coordinate systems
  1684. * and G92.1 to reset the workspace to native machine space.
  1685. */
  1686. //#define CNC_COORDINATE_SYSTEMS
  1687. /**
  1688. * Auto-report temperatures with M155 S<seconds>
  1689. */
  1690. #define AUTO_REPORT_TEMPERATURES
  1691. /**
  1692. * Include capabilities in M115 output
  1693. */
  1694. #define EXTENDED_CAPABILITIES_REPORT
  1695. /**
  1696. * Disable all Volumetric extrusion options
  1697. */
  1698. //#define NO_VOLUMETRICS
  1699. #if DISABLED(NO_VOLUMETRICS)
  1700. /**
  1701. * Volumetric extrusion default state
  1702. * Activate to make volumetric extrusion the default method,
  1703. * with DEFAULT_NOMINAL_FILAMENT_DIA as the default diameter.
  1704. *
  1705. * M200 D0 to disable, M200 Dn to set a new diameter.
  1706. */
  1707. //#define VOLUMETRIC_DEFAULT_ON
  1708. #endif
  1709. /**
  1710. * Enable this option for a leaner build of Marlin that removes all
  1711. * workspace offsets, simplifying coordinate transformations, leveling, etc.
  1712. *
  1713. * - M206 and M428 are disabled.
  1714. * - G92 will revert to its behavior from Marlin 1.0.
  1715. */
  1716. //#define NO_WORKSPACE_OFFSETS
  1717. /**
  1718. * Set the number of proportional font spaces required to fill up a typical character space.
  1719. * This can help to better align the output of commands like `G29 O` Mesh Output.
  1720. *
  1721. * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
  1722. * Otherwise, adjust according to your client and font.
  1723. */
  1724. #define PROPORTIONAL_FONT_RATIO 1.5
  1725. /**
  1726. * Spend 28 bytes of SRAM to optimize the GCode parser
  1727. */
  1728. #define FASTER_GCODE_PARSER
  1729. /**
  1730. * CNC G-code options
  1731. * Support CNC-style G-code dialects used by laser cutters, drawing machine cams, etc.
  1732. * Note that G0 feedrates should be used with care for 3D printing (if used at all).
  1733. * High feedrates may cause ringing and harm print quality.
  1734. */
  1735. //#define PAREN_COMMENTS // Support for parentheses-delimited comments
  1736. //#define GCODE_MOTION_MODES // Remember the motion mode (G0 G1 G2 G3 G5 G38.X) and apply for X Y Z E F, etc.
  1737. // Enable and set a (default) feedrate for all G0 moves
  1738. //#define G0_FEEDRATE 3000 // (mm/m)
  1739. #ifdef G0_FEEDRATE
  1740. //#define VARIABLE_G0_FEEDRATE // The G0 feedrate is set by F in G0 motion mode
  1741. #endif
  1742. /**
  1743. * G-code Macros
  1744. *
  1745. * Add G-codes M810-M819 to define and run G-code macros.
  1746. * Macros are not saved to EEPROM.
  1747. */
  1748. //#define GCODE_MACROS
  1749. #if ENABLED(GCODE_MACROS)
  1750. #define GCODE_MACROS_SLOTS 5 // Up to 10 may be used
  1751. #define GCODE_MACROS_SLOT_SIZE 50 // Maximum length of a single macro
  1752. #endif
  1753. /**
  1754. * User-defined menu items that execute custom GCode
  1755. */
  1756. //#define CUSTOM_USER_MENUS
  1757. #if ENABLED(CUSTOM_USER_MENUS)
  1758. //#define USER_SCRIPT_AUDIBLE_FEEDBACK
  1759. #define USER_SCRIPT_RETURN // Return to status screen after a script
  1760. #define USER_DESC_1 "User cmd 1"
  1761. #define USER_GCODE_1 "G28 X \n"
  1762. #define USER_DESC_2 "User cmd 2"
  1763. #define USER_GCODE_2 "G28 \nG1 X100 \n"
  1764. #define USER_DESC_3 "User cmd 3"
  1765. #define USER_GCODE_3 "M48 \n"
  1766. #define USER_DESC_4 "User cmd 4"
  1767. #define USER_GCODE_4 "M114 \n"
  1768. #endif
  1769. /**
  1770. * Host Action Commands
  1771. *
  1772. * Define host streamer action commands in compliance with the standard.
  1773. *
  1774. * See https://reprap.org/wiki/G-code#Action_commands
  1775. * Common commands ........ poweroff, pause, paused, resume, resumed, cancel
  1776. * G29_RETRY_AND_RECOVER .. probe_rewipe, probe_failed
  1777. *
  1778. * Some features add reason codes to extend these commands.
  1779. *
  1780. * Host Prompt Support enables Marlin to use the host for user prompts so
  1781. * filament runout and other processes can be managed from the host side.
  1782. */
  1783. //#define HOST_ACTION_COMMANDS
  1784. #if ENABLED(HOST_ACTION_COMMANDS)
  1785. //#define HOST_PROMPT_SUPPORT
  1786. #endif
  1787. //===========================================================================
  1788. //====================== I2C Position Encoder Settings ======================
  1789. //===========================================================================
  1790. /**
  1791. * I2C position encoders for closed loop control.
  1792. * Developed by Chris Barr at Aus3D.
  1793. *
  1794. * Wiki: http://wiki.aus3d.com.au/Magnetic_Encoder
  1795. * Github: https://github.com/Aus3D/MagneticEncoder
  1796. *
  1797. * Supplier: http://aus3d.com.au/magnetic-encoder-module
  1798. * Alternative Supplier: http://reliabuild3d.com/
  1799. *
  1800. * Reliabuild encoders have been modified to improve reliability.
  1801. */
  1802. //#define I2C_POSITION_ENCODERS
  1803. #if ENABLED(I2C_POSITION_ENCODERS)
  1804. #define I2CPE_ENCODER_CNT 1 // The number of encoders installed; max of 5
  1805. // encoders supported currently.
  1806. #define I2CPE_ENC_1_ADDR I2CPE_PRESET_ADDR_X // I2C address of the encoder. 30-200.
  1807. #define I2CPE_ENC_1_AXIS X_AXIS // Axis the encoder module is installed on. <X|Y|Z|E>_AXIS.
  1808. #define I2CPE_ENC_1_TYPE I2CPE_ENC_TYPE_LINEAR // Type of encoder: I2CPE_ENC_TYPE_LINEAR -or-
  1809. // I2CPE_ENC_TYPE_ROTARY.
  1810. #define I2CPE_ENC_1_TICKS_UNIT 2048 // 1024 for magnetic strips with 2mm poles; 2048 for
  1811. // 1mm poles. For linear encoders this is ticks / mm,
  1812. // for rotary encoders this is ticks / revolution.
  1813. //#define I2CPE_ENC_1_TICKS_REV (16 * 200) // Only needed for rotary encoders; number of stepper
  1814. // steps per full revolution (motor steps/rev * microstepping)
  1815. //#define I2CPE_ENC_1_INVERT // Invert the direction of axis travel.
  1816. #define I2CPE_ENC_1_EC_METHOD I2CPE_ECM_MICROSTEP // Type of error error correction.
  1817. #define I2CPE_ENC_1_EC_THRESH 0.10 // Threshold size for error (in mm) above which the
  1818. // printer will attempt to correct the error; errors
  1819. // smaller than this are ignored to minimize effects of
  1820. // measurement noise / latency (filter).
  1821. #define I2CPE_ENC_2_ADDR I2CPE_PRESET_ADDR_Y // Same as above, but for encoder 2.
  1822. #define I2CPE_ENC_2_AXIS Y_AXIS
  1823. #define I2CPE_ENC_2_TYPE I2CPE_ENC_TYPE_LINEAR
  1824. #define I2CPE_ENC_2_TICKS_UNIT 2048
  1825. //#define I2CPE_ENC_2_TICKS_REV (16 * 200)
  1826. //#define I2CPE_ENC_2_INVERT
  1827. #define I2CPE_ENC_2_EC_METHOD I2CPE_ECM_MICROSTEP
  1828. #define I2CPE_ENC_2_EC_THRESH 0.10
  1829. #define I2CPE_ENC_3_ADDR I2CPE_PRESET_ADDR_Z // Encoder 3. Add additional configuration options
  1830. #define I2CPE_ENC_3_AXIS Z_AXIS // as above, or use defaults below.
  1831. #define I2CPE_ENC_4_ADDR I2CPE_PRESET_ADDR_E // Encoder 4.
  1832. #define I2CPE_ENC_4_AXIS E_AXIS
  1833. #define I2CPE_ENC_5_ADDR 34 // Encoder 5.
  1834. #define I2CPE_ENC_5_AXIS E_AXIS
  1835. // Default settings for encoders which are enabled, but without settings configured above.
  1836. #define I2CPE_DEF_TYPE I2CPE_ENC_TYPE_LINEAR
  1837. #define I2CPE_DEF_ENC_TICKS_UNIT 2048
  1838. #define I2CPE_DEF_TICKS_REV (16 * 200)
  1839. #define I2CPE_DEF_EC_METHOD I2CPE_ECM_NONE
  1840. #define I2CPE_DEF_EC_THRESH 0.1
  1841. //#define I2CPE_ERR_THRESH_ABORT 100.0 // Threshold size for error (in mm) error on any given
  1842. // axis after which the printer will abort. Comment out to
  1843. // disable abort behaviour.
  1844. #define I2CPE_TIME_TRUSTED 10000 // After an encoder fault, there must be no further fault
  1845. // for this amount of time (in ms) before the encoder
  1846. // is trusted again.
  1847. /**
  1848. * Position is checked every time a new command is executed from the buffer but during long moves,
  1849. * this setting determines the minimum update time between checks. A value of 100 works well with
  1850. * error rolling average when attempting to correct only for skips and not for vibration.
  1851. */
  1852. #define I2CPE_MIN_UPD_TIME_MS 4 // (ms) Minimum time between encoder checks.
  1853. // Use a rolling average to identify persistant errors that indicate skips, as opposed to vibration and noise.
  1854. #define I2CPE_ERR_ROLLING_AVERAGE
  1855. #endif // I2C_POSITION_ENCODERS
  1856. /**
  1857. * MAX7219 Debug Matrix
  1858. *
  1859. * Add support for a low-cost 8x8 LED Matrix based on the Max7219 chip as a realtime status display.
  1860. * Requires 3 signal wires. Some useful debug options are included to demonstrate its usage.
  1861. */
  1862. #ifdef ROXYs_TRex
  1863. #define MAX7219_DEBUG
  1864. #endif
  1865. #if ENABLED(MAX7219_DEBUG)
  1866. /*
  1867. #define MAX7219_CLK_PIN 50 // Configuration of the 3 pins to control the display
  1868. #define MAX7219_DIN_PIN 51 // on RUMBA (or Formbot) using the ICSP port is used
  1869. #define MAX7219_LOAD_PIN 52 // This will affect your use of the SD Memory card
  1870. */
  1871. #define MAX7219_CLK_PIN 41 // Configuration of the 3 pins to control the display
  1872. #define MAX7219_DIN_PIN 13 // 41 is LCD_Kill_Button, 13 is Arduino_LED, 37 is LCD_Beeper
  1873. #define MAX7219_LOAD_PIN 37
  1874. #define MAX7219_GCODE // Add the M7219 G-code to control the LED matrix
  1875. #define MAX7219_INIT_TEST 2 // Do a test pattern at initialization (Set to 2 for spiral)
  1876. #define MAX7219_NUMBER_UNITS 2 // Number of Max7219 units in chain.
  1877. #define MAX7219_ROTATE 0 // Rotate the display clockwise (in multiples of +/- 90°)
  1878. // connector at: right=0 bottom=-90 top=90 left=180
  1879. //#define MAX7219_REVERSE_ORDER // The individual LED matrix units may be in reversed order
  1880. /**
  1881. * Sample debug features
  1882. * If you add more debug displays, be careful to avoid conflicts!
  1883. */
  1884. #define MAX7219_DEBUG_PRINTER_ALIVE // Blink corner LED of 8x8 matrix to show that the firmware is functioning
  1885. #define MAX7219_DEBUG_PLANNER_HEAD 5 // Show the planner queue head position on this and the next LED matrix row
  1886. #define MAX7219_DEBUG_PLANNER_TAIL 6 // Show the planner queue tail position on this and the next LED matrix row
  1887. #define MAX7219_DEBUG_PLANNER_QUEUE 7 // Show the current planner queue depth on this and the next LED matrix row
  1888. // If you experience stuttering, reboots, etc. this option can reveal how
  1889. // tweaks made to the configuration are affecting the printer in real-time.
  1890. #endif
  1891. /**
  1892. * NanoDLP Sync support
  1893. *
  1894. * Add support for Synchronized Z moves when using with NanoDLP. G0/G1 axis moves will output "Z_move_comp"
  1895. * string to enable synchronization with DLP projector exposure. This change will allow to use
  1896. * [[WaitForDoneMessage]] instead of populating your gcode with M400 commands
  1897. */
  1898. //#define NANODLP_Z_SYNC
  1899. #if ENABLED(NANODLP_Z_SYNC)
  1900. //#define NANODLP_ALL_AXIS // Enables "Z_move_comp" output on any axis move.
  1901. // Default behaviour is limited to Z axis only.
  1902. #endif
  1903. /**
  1904. * WiFi Support (Espressif ESP32 WiFi)
  1905. */
  1906. //#define WIFISUPPORT
  1907. #if ENABLED(WIFISUPPORT)
  1908. #define WIFI_SSID "Wifi SSID"
  1909. #define WIFI_PWD "Wifi Password"
  1910. #endif
  1911. /**
  1912. * Prusa Multi-Material Unit v2
  1913. * Enable in Configuration.h
  1914. */
  1915. #if ENABLED(PRUSA_MMU2)
  1916. // Serial port used for communication with MMU2.
  1917. // For AVR enable the UART port used for the MMU. (e.g., internalSerial)
  1918. // For 32-bit boards check your HAL for available serial ports. (e.g., Serial2)
  1919. #define INTERNAL_SERIAL_PORT 2
  1920. #define MMU2_SERIAL internalSerial
  1921. // Use hardware reset for MMU if a pin is defined for it
  1922. //#define MMU2_RST_PIN 23
  1923. // Enable if the MMU2 has 12V stepper motors (MMU2 Firmware 1.0.2 and up)
  1924. //#define MMU2_MODE_12V
  1925. // G-code to execute when MMU2 F.I.N.D.A. probe detects filament runout
  1926. #define MMU2_FILAMENT_RUNOUT_SCRIPT "M600"
  1927. // Add an LCD menu for MMU2
  1928. //#define MMU2_MENUS
  1929. #if ENABLED(MMU2_MENUS)
  1930. // Settings for filament load / unload from the LCD menu.
  1931. // This is for Prusa MK3-style extruders. Customize for your hardware.
  1932. #define MMU2_FILAMENTCHANGE_EJECT_FEED 80.0
  1933. #define MMU2_LOAD_TO_NOZZLE_SEQUENCE \
  1934. { 7.2, 562 }, \
  1935. { 14.4, 871 }, \
  1936. { 36.0, 1393 }, \
  1937. { 14.4, 871 }, \
  1938. { 50.0, 198 }
  1939. #define MMU2_RAMMING_SEQUENCE \
  1940. { 1.0, 1000 }, \
  1941. { 1.0, 1500 }, \
  1942. { 2.0, 2000 }, \
  1943. { 1.5, 3000 }, \
  1944. { 2.5, 4000 }, \
  1945. { -15.0, 5000 }, \
  1946. { -14.0, 1200 }, \
  1947. { -6.0, 600 }, \
  1948. { 10.0, 700 }, \
  1949. { -10.0, 400 }, \
  1950. { -50.0, 2000 }
  1951. #endif
  1952. //#define MMU2_DEBUG // Write debug info to serial output
  1953. #endif // PRUSA_MMU2
  1954. /**
  1955. * Advanced Print Counter settings
  1956. */
  1957. #if ENABLED(PRINTCOUNTER)
  1958. #define SERVICE_WARNING_BUZZES 3
  1959. // Activate up to 3 service interval watchdogs
  1960. //#define SERVICE_NAME_1 "Service S"
  1961. //#define SERVICE_INTERVAL_1 100 // print hours
  1962. //#define SERVICE_NAME_2 "Service L"
  1963. //#define SERVICE_INTERVAL_2 200 // print hours
  1964. //#define SERVICE_NAME_3 "Service 3"
  1965. //#define SERVICE_INTERVAL_3 1 // print hours
  1966. #endif
  1967. // @section develop
  1968. /**
  1969. * M43 - display pin status, watch pins for changes, watch endstops & toggle LED, Z servo probe test, toggle pins
  1970. */
  1971. #define PINS_DEBUGGING
  1972. // Enable Marlin dev mode which adds some special commands
  1973. //#define MARLIN_DEV_MODE