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

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