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 149KB

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