Configuration_adv.h 70 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713
  1. /**
  2. * Marlin 3D Printer Firmware
  3. * Copyright (C) 2016 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
  4. *
  5. * Based on Sprinter and grbl.
  6. * Copyright (C) 2011 Camiel Gubbels / Erik van der Zalm
  7. *
  8. * This program is free software: you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation, either version 3 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  20. *
  21. */
  22. /**
  23. * Configuration_adv.h
  24. *
  25. * Advanced settings.
  26. * Only change these if you know exactly what you're doing.
  27. * Some of these settings can damage your printer if improperly set!
  28. *
  29. * Basic settings can be found in Configuration.h
  30. *
  31. */
  32. #ifndef CONFIGURATION_ADV_H
  33. #define CONFIGURATION_ADV_H
  34. #define CONFIGURATION_ADV_H_VERSION 010109
  35. // @section temperature
  36. //===========================================================================
  37. //=============================Thermal Settings ============================
  38. //===========================================================================
  39. //
  40. // Hephestos 2 24V heated bed upgrade kit.
  41. // https://store.bq.com/en/heated-bed-kit-hephestos2
  42. //
  43. //#define HEPHESTOS2_HEATED_BED_KIT
  44. #if ENABLED(HEPHESTOS2_HEATED_BED_KIT)
  45. #undef TEMP_SENSOR_BED
  46. #define TEMP_SENSOR_BED 70
  47. #define HEATER_BED_INVERTING true
  48. #endif
  49. #if DISABLED(PIDTEMPBED)
  50. #define BED_CHECK_INTERVAL 5000 // ms between checks in bang-bang control
  51. #if ENABLED(BED_LIMIT_SWITCHING)
  52. #define BED_HYSTERESIS 2 // Only disable heating if T>target+BED_HYSTERESIS and enable heating if T>target-BED_HYSTERESIS
  53. #endif
  54. #endif
  55. /**
  56. * Thermal Protection provides additional protection to your printer from damage
  57. * and fire. Marlin always includes safe min and max temperature ranges which
  58. * protect against a broken or disconnected thermistor wire.
  59. *
  60. * The issue: If a thermistor falls out, it will report the much lower
  61. * temperature of the air in the room, and the the firmware will keep
  62. * the heater on.
  63. *
  64. * The solution: Once the temperature reaches the target, start observing.
  65. * If the temperature stays too far below the target (hysteresis) for too
  66. * long (period), the firmware will halt the machine as a safety precaution.
  67. *
  68. * If you get false positives for "Thermal Runaway", increase
  69. * THERMAL_PROTECTION_HYSTERESIS and/or THERMAL_PROTECTION_PERIOD
  70. */
  71. #if ENABLED(THERMAL_PROTECTION_HOTENDS)
  72. #define THERMAL_PROTECTION_PERIOD 40 // Seconds
  73. #define THERMAL_PROTECTION_HYSTERESIS 4 // Degrees Celsius
  74. /**
  75. * Whenever an M104, M109, or M303 increases the target temperature, the
  76. * firmware will wait for the WATCH_TEMP_PERIOD to expire. If the temperature
  77. * hasn't increased by WATCH_TEMP_INCREASE degrees, the machine is halted and
  78. * requires a hard reset. This test restarts with any M104/M109/M303, but only
  79. * if the current temperature is far enough below the target for a reliable
  80. * test.
  81. *
  82. * If you get false positives for "Heating failed", increase WATCH_TEMP_PERIOD
  83. * and/or decrease WATCH_TEMP_INCREASE. WATCH_TEMP_INCREASE should not be set
  84. * below 2.
  85. */
  86. #define WATCH_TEMP_PERIOD 20 // Seconds
  87. #define WATCH_TEMP_INCREASE 2 // Degrees Celsius
  88. #endif
  89. /**
  90. * Thermal Protection parameters for the bed are just as above for hotends.
  91. */
  92. #if ENABLED(THERMAL_PROTECTION_BED)
  93. #define THERMAL_PROTECTION_BED_PERIOD 20 // Seconds
  94. #define THERMAL_PROTECTION_BED_HYSTERESIS 2 // Degrees Celsius
  95. /**
  96. * As described above, except for the bed (M140/M190/M303).
  97. */
  98. #define WATCH_BED_TEMP_PERIOD 60 // Seconds
  99. #define WATCH_BED_TEMP_INCREASE 2 // Degrees Celsius
  100. #endif
  101. #if ENABLED(PIDTEMP)
  102. // this adds an experimental additional term to the heating power, proportional to the extrusion speed.
  103. // if Kc is chosen well, the additional required power due to increased melting should be compensated.
  104. //#define PID_EXTRUSION_SCALING
  105. #if ENABLED(PID_EXTRUSION_SCALING)
  106. #define DEFAULT_Kc (100) //heating power=Kc*(e_speed)
  107. #define LPQ_MAX_LEN 50
  108. #endif
  109. #endif
  110. /**
  111. * Automatic Temperature:
  112. * The hotend target temperature is calculated by all the buffered lines of gcode.
  113. * The maximum buffered steps/sec of the extruder motor is called "se".
  114. * Start autotemp mode with M109 S<mintemp> B<maxtemp> F<factor>
  115. * The target temperature is set to mintemp+factor*se[steps/sec] and is limited by
  116. * mintemp and maxtemp. Turn this off by executing M109 without F*
  117. * Also, if the temperature is set to a value below mintemp, it will not be changed by autotemp.
  118. * On an Ultimaker, some initial testing worked with M109 S215 B260 F1 in the start.gcode
  119. */
  120. #define AUTOTEMP
  121. #if ENABLED(AUTOTEMP)
  122. #define AUTOTEMP_OLDWEIGHT 0.98
  123. #endif
  124. // Show extra position information in M114
  125. //#define M114_DETAIL
  126. // Show Temperature ADC value
  127. // Enable for M105 to include ADC values read from temperature sensors.
  128. //#define SHOW_TEMP_ADC_VALUES
  129. /**
  130. * High Temperature Thermistor Support
  131. *
  132. * Thermistors able to support high temperature tend to have a hard time getting
  133. * good readings at room and lower temperatures. This means HEATER_X_RAW_LO_TEMP
  134. * will probably be caught when the heating element first turns on during the
  135. * preheating process, which will trigger a min_temp_error as a safety measure
  136. * and force stop everything.
  137. * To circumvent this limitation, we allow for a preheat time (during which,
  138. * min_temp_error won't be triggered) and add a min_temp buffer to handle
  139. * aberrant readings.
  140. *
  141. * If you want to enable this feature for your hotend thermistor(s)
  142. * uncomment and set values > 0 in the constants below
  143. */
  144. // The number of consecutive low temperature errors that can occur
  145. // before a min_temp_error is triggered. (Shouldn't be more than 10.)
  146. //#define MAX_CONSECUTIVE_LOW_TEMPERATURE_ERROR_ALLOWED 0
  147. // The number of milliseconds a hotend will preheat before starting to check
  148. // the temperature. This value should NOT be set to the time it takes the
  149. // hot end to reach the target temperature, but the time it takes to reach
  150. // the minimum temperature your thermistor can read. The lower the better/safer.
  151. // This shouldn't need to be more than 30 seconds (30000)
  152. //#define MILLISECONDS_PREHEAT_TIME 0
  153. // @section extruder
  154. // Extruder runout prevention.
  155. // If the machine is idle and the temperature over MINTEMP
  156. // then extrude some filament every couple of SECONDS.
  157. //#define EXTRUDER_RUNOUT_PREVENT
  158. #if ENABLED(EXTRUDER_RUNOUT_PREVENT)
  159. #define EXTRUDER_RUNOUT_MINTEMP 190
  160. #define EXTRUDER_RUNOUT_SECONDS 30
  161. #define EXTRUDER_RUNOUT_SPEED 1500 // mm/m
  162. #define EXTRUDER_RUNOUT_EXTRUDE 5 // mm
  163. #endif
  164. // @section temperature
  165. // Calibration for AD595 / AD8495 sensor to adjust temperature measurements.
  166. // The final temperature is calculated as (measuredTemp * GAIN) + OFFSET.
  167. #define TEMP_SENSOR_AD595_OFFSET 0.0
  168. #define TEMP_SENSOR_AD595_GAIN 1.0
  169. #define TEMP_SENSOR_AD8495_OFFSET 0.0
  170. #define TEMP_SENSOR_AD8495_GAIN 1.0
  171. /**
  172. * Controller Fan
  173. * To cool down the stepper drivers and MOSFETs.
  174. *
  175. * The fan will turn on automatically whenever any stepper is enabled
  176. * and turn off after a set period after all steppers are turned off.
  177. */
  178. //#define USE_CONTROLLER_FAN
  179. #if ENABLED(USE_CONTROLLER_FAN)
  180. //#define CONTROLLER_FAN_PIN -1 // Set a custom pin for the controller fan
  181. #define CONTROLLERFAN_SECS 60 // Duration in seconds for the fan to run after all motors are disabled
  182. #define CONTROLLERFAN_SPEED 255 // 255 == full speed
  183. #endif
  184. // When first starting the main fan, run it at full speed for the
  185. // given number of milliseconds. This gets the fan spinning reliably
  186. // before setting a PWM value. (Does not work with software PWM for fan on Sanguinololu)
  187. //#define FAN_KICKSTART_TIME 100
  188. /**
  189. * PWM Fan Scaling
  190. *
  191. * Define the min/max speeds for PWM fans (as set with M106).
  192. *
  193. * With these options the M106 0-255 value range is scaled to a subset
  194. * to ensure that the fan has enough power to spin, or to run lower
  195. * current fans with higher current. (e.g., 5V/12V fans with 12V/24V)
  196. * Value 0 always turns off the fan.
  197. *
  198. * Define one or both of these to override the default 0-255 range.
  199. */
  200. //#define FAN_MIN_PWM 50
  201. //#define FAN_MAX_PWM 128
  202. // @section extruder
  203. /**
  204. * Extruder cooling fans
  205. *
  206. * Extruder auto fans automatically turn on when their extruders'
  207. * temperatures go above EXTRUDER_AUTO_FAN_TEMPERATURE.
  208. *
  209. * Your board's pins file specifies the recommended pins. Override those here
  210. * or set to -1 to disable completely.
  211. *
  212. * Multiple extruders can be assigned to the same pin in which case
  213. * the fan will turn on when any selected extruder is above the threshold.
  214. */
  215. #define E0_AUTO_FAN_PIN -1
  216. #define E1_AUTO_FAN_PIN -1
  217. #define E2_AUTO_FAN_PIN -1
  218. #define E3_AUTO_FAN_PIN -1
  219. #define E4_AUTO_FAN_PIN -1
  220. #define CHAMBER_AUTO_FAN_PIN -1
  221. #define EXTRUDER_AUTO_FAN_TEMPERATURE 50
  222. #define EXTRUDER_AUTO_FAN_SPEED 255 // == full speed
  223. /**
  224. * Part-Cooling Fan Multiplexer
  225. *
  226. * This feature allows you to digitally multiplex the fan output.
  227. * The multiplexer is automatically switched at tool-change.
  228. * Set FANMUX[012]_PINs below for up to 2, 4, or 8 multiplexed fans.
  229. */
  230. #define FANMUX0_PIN -1
  231. #define FANMUX1_PIN -1
  232. #define FANMUX2_PIN -1
  233. /**
  234. * M355 Case Light on-off / brightness
  235. */
  236. //#define CASE_LIGHT_ENABLE
  237. #if ENABLED(CASE_LIGHT_ENABLE)
  238. //#define CASE_LIGHT_PIN 4 // Override the default pin if needed
  239. #define INVERT_CASE_LIGHT false // Set true if Case Light is ON when pin is LOW
  240. #define CASE_LIGHT_DEFAULT_ON true // Set default power-up state on
  241. #define CASE_LIGHT_DEFAULT_BRIGHTNESS 105 // Set default power-up brightness (0-255, requires PWM pin)
  242. //#define MENU_ITEM_CASE_LIGHT // Add a Case Light option to the LCD main menu
  243. //#define CASE_LIGHT_USE_NEOPIXEL // Use Neopixel LED as case light, requires NEOPIXEL_LED.
  244. #if ENABLED(CASE_LIGHT_USE_NEOPIXEL)
  245. #define CASE_LIGHT_NEOPIXEL_COLOR { 255, 255, 255, 255 } // { Red, Green, Blue, White }
  246. #endif
  247. #endif
  248. //===========================================================================
  249. //============================ Mechanical Settings ==========================
  250. //===========================================================================
  251. // @section homing
  252. // If you want endstops to stay on (by default) even when not homing
  253. // enable this option. Override at any time with M120, M121.
  254. //#define ENDSTOPS_ALWAYS_ON_DEFAULT
  255. // @section extras
  256. //#define Z_LATE_ENABLE // Enable Z the last moment. Needed if your Z driver overheats.
  257. /**
  258. * Dual Steppers / Dual Endstops
  259. *
  260. * This section will allow you to use extra E drivers to drive a second motor for X, Y, or Z axes.
  261. *
  262. * For example, set X_DUAL_STEPPER_DRIVERS setting to use a second motor. If the motors need to
  263. * spin in opposite directions set INVERT_X2_VS_X_DIR. If the second motor needs its own endstop
  264. * set X_DUAL_ENDSTOPS. This can adjust for "racking." Use X2_USE_ENDSTOP to set the endstop plug
  265. * that should be used for the second endstop. Extra endstops will appear in the output of 'M119'.
  266. *
  267. * Use X_DUAL_ENDSTOP_ADJUSTMENT to adjust for mechanical imperfection. After homing both motors
  268. * this offset is applied to the X2 motor. To find the offset home the X axis, and measure the error
  269. * in X2. Dual endstop offsets can be set at runtime with 'M666 X<offset> Y<offset> Z<offset>'.
  270. */
  271. //#define X_DUAL_STEPPER_DRIVERS
  272. #if ENABLED(X_DUAL_STEPPER_DRIVERS)
  273. #define INVERT_X2_VS_X_DIR true // Set 'true' if X motors should rotate in opposite directions
  274. //#define X_DUAL_ENDSTOPS
  275. #if ENABLED(X_DUAL_ENDSTOPS)
  276. #define X2_USE_ENDSTOP _XMAX_
  277. #define X_DUAL_ENDSTOPS_ADJUSTMENT 0
  278. #endif
  279. #endif
  280. //#define Y_DUAL_STEPPER_DRIVERS
  281. #if ENABLED(Y_DUAL_STEPPER_DRIVERS)
  282. #define INVERT_Y2_VS_Y_DIR true // Set 'true' if Y motors should rotate in opposite directions
  283. //#define Y_DUAL_ENDSTOPS
  284. #if ENABLED(Y_DUAL_ENDSTOPS)
  285. #define Y2_USE_ENDSTOP _YMAX_
  286. #define Y_DUAL_ENDSTOPS_ADJUSTMENT 0
  287. #endif
  288. #endif
  289. //#define Z_DUAL_STEPPER_DRIVERS
  290. #if ENABLED(Z_DUAL_STEPPER_DRIVERS)
  291. //#define Z_DUAL_ENDSTOPS
  292. #if ENABLED(Z_DUAL_ENDSTOPS)
  293. #define Z2_USE_ENDSTOP _XMAX_
  294. #define Z_DUAL_ENDSTOPS_ADJUSTMENT 0
  295. #endif
  296. #endif
  297. /**
  298. * Dual X Carriage
  299. *
  300. * This setup has two X carriages that can move independently, each with its own hotend.
  301. * The carriages can be used to print an object with two colors or materials, or in
  302. * "duplication mode" it can print two identical or X-mirrored objects simultaneously.
  303. * The inactive carriage is parked automatically to prevent oozing.
  304. * X1 is the left carriage, X2 the right. They park and home at opposite ends of the X axis.
  305. * By default the X2 stepper is assigned to the first unused E plug on the board.
  306. */
  307. //#define DUAL_X_CARRIAGE
  308. #if ENABLED(DUAL_X_CARRIAGE)
  309. #define X1_MIN_POS X_MIN_POS // set minimum to ensure first x-carriage doesn't hit the parked second X-carriage
  310. #define X1_MAX_POS X_BED_SIZE // set maximum to ensure first x-carriage doesn't hit the parked second X-carriage
  311. #define X2_MIN_POS 80 // set minimum to ensure second x-carriage doesn't hit the parked first X-carriage
  312. #define X2_MAX_POS 353 // set maximum to the distance between toolheads when both heads are homed
  313. #define X2_HOME_DIR 1 // the second X-carriage always homes to the maximum endstop position
  314. #define X2_HOME_POS X2_MAX_POS // default home position is the maximum carriage position
  315. // However: In this mode the HOTEND_OFFSET_X value for the second extruder provides a software
  316. // override for X2_HOME_POS. This also allow recalibration of the distance between the two endstops
  317. // without modifying the firmware (through the "M218 T1 X???" command).
  318. // Remember: you should set the second extruder x-offset to 0 in your slicer.
  319. // There are a few selectable movement modes for dual x-carriages using M605 S<mode>
  320. // Mode 0 (DXC_FULL_CONTROL_MODE): Full control. The slicer has full control over both x-carriages and can achieve optimal travel results
  321. // as long as it supports dual x-carriages. (M605 S0)
  322. // Mode 1 (DXC_AUTO_PARK_MODE) : Auto-park mode. The firmware will automatically park and unpark the x-carriages on tool changes so
  323. // that additional slicer support is not required. (M605 S1)
  324. // Mode 2 (DXC_DUPLICATION_MODE) : Duplication mode. The firmware will transparently make the second x-carriage and extruder copy all
  325. // actions of the first x-carriage. This allows the printer to print 2 arbitrary items at
  326. // once. (2nd extruder x offset and temp offset are set using: M605 S2 [Xnnn] [Rmmm])
  327. // This is the default power-up mode which can be later using M605.
  328. #define DEFAULT_DUAL_X_CARRIAGE_MODE DXC_FULL_CONTROL_MODE
  329. // Default settings in "Auto-park Mode"
  330. #define TOOLCHANGE_PARK_ZLIFT 0.2 // the distance to raise Z axis when parking an extruder
  331. #define TOOLCHANGE_UNPARK_ZLIFT 1 // the distance to raise Z axis when unparking an extruder
  332. // Default x offset in duplication mode (typically set to half print bed width)
  333. #define DEFAULT_DUPLICATION_X_OFFSET 100
  334. #endif // DUAL_X_CARRIAGE
  335. // Activate a solenoid on the active extruder with M380. Disable all with M381.
  336. // Define SOL0_PIN, SOL1_PIN, etc., for each extruder that has a solenoid.
  337. //#define EXT_SOLENOID
  338. // @section homing
  339. // Homing hits each endstop, retracts by these distances, then does a slower bump.
  340. #define X_HOME_BUMP_MM 5
  341. #define Y_HOME_BUMP_MM 5
  342. #define Z_HOME_BUMP_MM 2
  343. #define HOMING_BUMP_DIVISOR { 2, 2, 4 } // Re-Bump Speed Divisor (Divides the Homing Feedrate)
  344. //#define QUICK_HOME // If homing includes X and Y, do a diagonal move initially
  345. // When G28 is called, this option will make Y home before X
  346. //#define HOME_Y_BEFORE_X
  347. // Enable this if X or Y can't home without homing the other axis first.
  348. //#define CODEPENDENT_XY_HOMING
  349. #if ENABLED(BLTOUCH)
  350. /**
  351. * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
  352. * Do not activate settings that the probe might not understand. Clones might misunderstand
  353. * advanced commands.
  354. *
  355. * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
  356. * check the wiring of the BROWN, RED and ORANGE wires.
  357. *
  358. * Note: If the trigger signal of your probe is not being recognized, it has been very often
  359. * because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
  360. * like they would be with a real switch. So please check the wiring first.
  361. *
  362. * Settings for all BLTouch and clone probes:
  363. */
  364. // Safety: The probe needs time to recognize the command.
  365. // Minimum command delay (ms). Enable and increase if needed.
  366. //#define BLTOUCH_DELAY 500
  367. /**
  368. * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
  369. */
  370. // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
  371. // in special cases, like noisy or filtered input configurations.
  372. //#define BLTOUCH_FORCE_SW_MODE
  373. /**
  374. * Settings for BLTouch Smart 3.0 and 3.1
  375. * Summary:
  376. * - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
  377. * - High-Speed mode
  378. * - Disable LCD voltage options
  379. */
  380. /**
  381. * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
  382. * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
  383. * If disabled, OD mode is the hard-coded default on 3.0
  384. * On startup, Marlin will compare its eeprom to this vale. If the selected mode
  385. * differs, a mode set eeprom write will be completed at initialization.
  386. * Use the option below to force an eeprom write to a V3.1 probe regardless.
  387. */
  388. //#define BLTOUCH_SET_5V_MODE
  389. /**
  390. * Safety: Activate if connecting a probe with an unknown voltage mode.
  391. * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
  392. * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
  393. * To preserve the life of the probe, use this once then turn it off and re-flash.
  394. */
  395. //#define BLTOUCH_FORCE_MODE_SET
  396. // Safety: Enable voltage mode settings in the LCD menu.
  397. //#define BLTOUCH_LCD_VOLTAGE_MENU
  398. #endif // BLTOUCH
  399. // @section machine
  400. #define AXIS_RELATIVE_MODES {false, false, false, false}
  401. // Allow duplication mode with a basic dual-nozzle extruder
  402. //#define DUAL_NOZZLE_DUPLICATION_MODE
  403. // By default pololu step drivers require an active high signal. However, some high power drivers require an active low signal as step.
  404. #define INVERT_X_STEP_PIN false
  405. #define INVERT_Y_STEP_PIN false
  406. #define INVERT_Z_STEP_PIN false
  407. #define INVERT_E_STEP_PIN false
  408. // Default stepper release if idle. Set to 0 to deactivate.
  409. // Steppers will shut down DEFAULT_STEPPER_DEACTIVE_TIME seconds after the last move when DISABLE_INACTIVE_? is true.
  410. // Time can be set by M18 and M84.
  411. #define DEFAULT_STEPPER_DEACTIVE_TIME 120
  412. #define DISABLE_INACTIVE_X true
  413. #define DISABLE_INACTIVE_Y true
  414. #define DISABLE_INACTIVE_Z true // set to false if the nozzle will fall down on your printed part when print has finished.
  415. #define DISABLE_INACTIVE_E true
  416. #define DEFAULT_MINIMUMFEEDRATE 0.0 // minimum feedrate
  417. #define DEFAULT_MINTRAVELFEEDRATE 0.0
  418. //#define HOME_AFTER_DEACTIVATE // Require rehoming after steppers are deactivated
  419. // @section lcd
  420. #if ENABLED(ULTIPANEL)
  421. #define MANUAL_FEEDRATE {50*60, 50*60, 4*60, 60} // Feedrates for manual moves along X, Y, Z, E from panel
  422. #define ULTIPANEL_FEEDMULTIPLY // Comment to disable setting feedrate multiplier via encoder
  423. #endif
  424. // @section extras
  425. // minimum time in microseconds that a movement needs to take if the buffer is emptied.
  426. #define DEFAULT_MINSEGMENTTIME 20000
  427. // If defined the movements slow down when the look ahead buffer is only half full
  428. #define SLOWDOWN
  429. // Frequency limit
  430. // See nophead's blog for more info
  431. // Not working O
  432. //#define XY_FREQUENCY_LIMIT 15
  433. // Minimum planner junction speed. Sets the default minimum speed the planner plans for at the end
  434. // of the buffer and all stops. This should not be much greater than zero and should only be changed
  435. // if unwanted behavior is observed on a user's machine when running at very slow speeds.
  436. #define MINIMUM_PLANNER_SPEED 0.05 // (mm/sec)
  437. //
  438. // Use Junction Deviation instead of traditional Jerk Limiting
  439. //
  440. //#define JUNCTION_DEVIATION
  441. #if ENABLED(JUNCTION_DEVIATION)
  442. #define JUNCTION_DEVIATION_MM 0.02 // (mm) Distance from real junction edge
  443. #endif
  444. /**
  445. * Adaptive Step Smoothing increases the resolution of multi-axis moves, particularly at step frequencies
  446. * below 1kHz (for AVR) or 10kHz (for ARM), where aliasing between axes in multi-axis moves causes audible
  447. * vibration and surface artifacts. The algorithm adapts to provide the best possible step smoothing at the
  448. * lowest stepping frequencies.
  449. */
  450. //#define ADAPTIVE_STEP_SMOOTHING
  451. // Microstep setting (Only functional when stepper driver microstep pins are connected to MCU.
  452. #define MICROSTEP_MODES { 16, 16, 16, 16, 16 } // [1,2,4,8,16]
  453. /**
  454. * @section stepper motor current
  455. *
  456. * Some boards have a means of setting the stepper motor current via firmware.
  457. *
  458. * The power on motor currents are set by:
  459. * PWM_MOTOR_CURRENT - used by MINIRAMBO & ULTIMAIN_2
  460. * known compatible chips: A4982
  461. * DIGIPOT_MOTOR_CURRENT - used by BQ_ZUM_MEGA_3D, RAMBO & SCOOVO_X9H
  462. * known compatible chips: AD5206
  463. * DAC_MOTOR_CURRENT_DEFAULT - used by PRINTRBOARD_REVF & RIGIDBOARD_V2
  464. * known compatible chips: MCP4728
  465. * DIGIPOT_I2C_MOTOR_CURRENTS - used by 5DPRINT, AZTEEG_X3_PRO, MIGHTYBOARD_REVE
  466. * known compatible chips: MCP4451, MCP4018
  467. *
  468. * Motor currents can also be set by M907 - M910 and by the LCD.
  469. * M907 - applies to all.
  470. * M908 - BQ_ZUM_MEGA_3D, RAMBO, PRINTRBOARD_REVF, RIGIDBOARD_V2 & SCOOVO_X9H
  471. * M909, M910 & LCD - only PRINTRBOARD_REVF & RIGIDBOARD_V2
  472. */
  473. //#define PWM_MOTOR_CURRENT { 1300, 1300, 1250 } // Values in milliamps
  474. //#define DIGIPOT_MOTOR_CURRENT { 135,135,135,135,135 } // Values 0-255 (RAMBO 135 = ~0.75A, 185 = ~1A)
  475. //#define DAC_MOTOR_CURRENT_DEFAULT { 70, 80, 90, 80 } // Default drive percent - X, Y, Z, E axis
  476. // Use an I2C based DIGIPOT (e.g., Azteeg X3 Pro)
  477. //#define DIGIPOT_I2C
  478. #if ENABLED(DIGIPOT_I2C) && !defined(DIGIPOT_I2C_ADDRESS_A)
  479. /**
  480. * Common slave addresses:
  481. *
  482. * A (A shifted) B (B shifted) IC
  483. * Smoothie 0x2C (0x58) 0x2D (0x5A) MCP4451
  484. * AZTEEG_X3_PRO 0x2C (0x58) 0x2E (0x5C) MCP4451
  485. * MIGHTYBOARD_REVE 0x2F (0x5E) MCP4018
  486. */
  487. #define DIGIPOT_I2C_ADDRESS_A 0x2C // unshifted slave address for first DIGIPOT
  488. #define DIGIPOT_I2C_ADDRESS_B 0x2D // unshifted slave address for second DIGIPOT
  489. #endif
  490. //#define DIGIPOT_MCP4018 // Requires library from https://github.com/stawel/SlowSoftI2CMaster
  491. #define DIGIPOT_I2C_NUM_CHANNELS 8 // 5DPRINT: 4 AZTEEG_X3_PRO: 8
  492. // Actual motor currents in Amps. The number of entries must match DIGIPOT_I2C_NUM_CHANNELS.
  493. // These correspond to the physical drivers, so be mindful if the order is changed.
  494. #define DIGIPOT_I2C_MOTOR_CURRENTS { 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 } // AZTEEG_X3_PRO
  495. //===========================================================================
  496. //=============================Additional Features===========================
  497. //===========================================================================
  498. #define ENCODER_RATE_MULTIPLIER // If defined, certain menu edit operations automatically multiply the steps when the encoder is moved quickly
  499. #define ENCODER_10X_STEPS_PER_SEC 75 // If the encoder steps per sec exceeds this value, multiply steps moved x10 to quickly advance the value
  500. #define ENCODER_100X_STEPS_PER_SEC 160 // If the encoder steps per sec exceeds this value, multiply steps moved x100 to really quickly advance the value
  501. //#define CHDK 4 //Pin for triggering CHDK to take a picture see how to use it here http://captain-slow.dk/2014/03/09/3d-printing-timelapses/
  502. #define CHDK_DELAY 50 //How long in ms the pin should stay HIGH before going LOW again
  503. // @section lcd
  504. // Include a page of printer information in the LCD Main Menu
  505. #define LCD_INFO_MENU
  506. // Scroll a longer status message into view
  507. #define STATUS_MESSAGE_SCROLLING
  508. // On the Info Screen, display XY with one decimal place when possible
  509. //#define LCD_DECIMAL_SMALL_XY
  510. // The timeout (in ms) to return to the status screen from sub-menus
  511. //#define LCD_TIMEOUT_TO_STATUS 15000
  512. // Add an 'M73' G-code to set the current percentage
  513. //#define LCD_SET_PROGRESS_MANUALLY
  514. #if ENABLED(SDSUPPORT) || ENABLED(LCD_SET_PROGRESS_MANUALLY)
  515. //#define LCD_PROGRESS_BAR // Show a progress bar on HD44780 LCDs for SD printing
  516. #if ENABLED(LCD_PROGRESS_BAR)
  517. #define PROGRESS_BAR_BAR_TIME 2000 // (ms) Amount of time to show the bar
  518. #define PROGRESS_BAR_MSG_TIME 3000 // (ms) Amount of time to show the status message
  519. #define PROGRESS_MSG_EXPIRE 0 // (ms) Amount of time to retain the status message (0=forever)
  520. //#define PROGRESS_MSG_ONCE // Show the message for MSG_TIME then clear it
  521. //#define LCD_PROGRESS_BAR_TEST // Add a menu item to test the progress bar
  522. #endif
  523. #endif // SDSUPPORT || LCD_SET_PROGRESS_MANUALLY
  524. /**
  525. * LED Control Menu
  526. * Enable this feature to add LED Control to the LCD menu
  527. */
  528. //#define LED_CONTROL_MENU
  529. #if ENABLED(LED_CONTROL_MENU)
  530. #define LED_COLOR_PRESETS // Enable the Preset Color menu option
  531. #if ENABLED(LED_COLOR_PRESETS)
  532. #define LED_USER_PRESET_RED 255 // User defined RED value
  533. #define LED_USER_PRESET_GREEN 128 // User defined GREEN value
  534. #define LED_USER_PRESET_BLUE 0 // User defined BLUE value
  535. #define LED_USER_PRESET_WHITE 255 // User defined WHITE value
  536. #define LED_USER_PRESET_BRIGHTNESS 255 // User defined intensity
  537. //#define LED_USER_PRESET_STARTUP // Have the printer display the user preset color on startup
  538. #endif
  539. #endif // LED_CONTROL_MENU
  540. #if ENABLED(SDSUPPORT)
  541. // Some RAMPS and other boards don't detect when an SD card is inserted. You can work
  542. // around this by connecting a push button or single throw switch to the pin defined
  543. // as SD_DETECT_PIN in your board's pins definitions.
  544. // This setting should be disabled unless you are using a push button, pulling the pin to ground.
  545. // Note: This is always disabled for ULTIPANEL (except ELB_FULL_GRAPHIC_CONTROLLER).
  546. #define SD_DETECT_INVERTED
  547. #define SD_FINISHED_STEPPERRELEASE true // Disable steppers when SD Print is finished
  548. #define SD_FINISHED_RELEASECOMMAND "M84 X Y Z E" // You might want to keep the z enabled so your bed stays in place.
  549. // Reverse SD sort to show "more recent" files first, according to the card's FAT.
  550. // Since the FAT gets out of order with usage, SDCARD_SORT_ALPHA is recommended.
  551. #define SDCARD_RATHERRECENTFIRST
  552. // Add an option in the menu to run all auto#.g files
  553. //#define MENU_ADDAUTOSTART
  554. /**
  555. * Continue after Power-Loss (Creality3D)
  556. *
  557. * Store the current state to the SD Card at the start of each layer
  558. * during SD printing. If the recovery file is found at boot time, present
  559. * an option on the LCD screen to continue the print from the last-known
  560. * point in the file.
  561. */
  562. //#define POWER_LOSS_RECOVERY
  563. #if ENABLED(POWER_LOSS_RECOVERY)
  564. //#define POWER_LOSS_PIN 44 // Pin to detect power loss
  565. //#define POWER_LOSS_STATE HIGH // State of pin indicating power loss
  566. #endif
  567. /**
  568. * Sort SD file listings in alphabetical order.
  569. *
  570. * With this option enabled, items on SD cards will be sorted
  571. * by name for easier navigation.
  572. *
  573. * By default...
  574. *
  575. * - Use the slowest -but safest- method for sorting.
  576. * - Folders are sorted to the top.
  577. * - The sort key is statically allocated.
  578. * - No added G-code (M34) support.
  579. * - 40 item sorting limit. (Items after the first 40 are unsorted.)
  580. *
  581. * SD sorting uses static allocation (as set by SDSORT_LIMIT), allowing the
  582. * compiler to calculate the worst-case usage and throw an error if the SRAM
  583. * limit is exceeded.
  584. *
  585. * - SDSORT_USES_RAM provides faster sorting via a static directory buffer.
  586. * - SDSORT_USES_STACK does the same, but uses a local stack-based buffer.
  587. * - SDSORT_CACHE_NAMES will retain the sorted file listing in RAM. (Expensive!)
  588. * - SDSORT_DYNAMIC_RAM only uses RAM when the SD menu is visible. (Use with caution!)
  589. */
  590. //#define SDCARD_SORT_ALPHA
  591. // SD Card Sorting options
  592. #if ENABLED(SDCARD_SORT_ALPHA)
  593. #define SDSORT_LIMIT 40 // Maximum number of sorted items (10-256). Costs 27 bytes each.
  594. #define FOLDER_SORTING -1 // -1=above 0=none 1=below
  595. #define SDSORT_GCODE false // Allow turning sorting on/off with LCD and M34 g-code.
  596. #define SDSORT_USES_RAM false // Pre-allocate a static array for faster pre-sorting.
  597. #define SDSORT_USES_STACK false // Prefer the stack for pre-sorting to give back some SRAM. (Negated by next 2 options.)
  598. #define SDSORT_CACHE_NAMES false // Keep sorted items in RAM longer for speedy performance. Most expensive option.
  599. #define SDSORT_DYNAMIC_RAM false // Use dynamic allocation (within SD menus). Least expensive option. Set SDSORT_LIMIT before use!
  600. #define SDSORT_CACHE_VFATS 2 // Maximum number of 13-byte VFAT entries to use for sorting.
  601. // Note: Only affects SCROLL_LONG_FILENAMES with SDSORT_CACHE_NAMES but not SDSORT_DYNAMIC_RAM.
  602. #endif
  603. // This allows hosts to request long names for files and folders with M33
  604. #define LONG_FILENAME_HOST_SUPPORT
  605. // Enable this option to scroll long filenames in the SD card menu
  606. #define SCROLL_LONG_FILENAMES
  607. /**
  608. * This option allows you to abort SD printing when any endstop is triggered.
  609. * This feature must be enabled with "M540 S1" or from the LCD menu.
  610. * To have any effect, endstops must be enabled during SD printing.
  611. */
  612. //#define ABORT_ON_ENDSTOP_HIT_FEATURE_ENABLED
  613. /**
  614. * This option makes it easier to print the same SD Card file again.
  615. * On print completion the LCD Menu will open with the file selected.
  616. * You can just click to start the print, or navigate elsewhere.
  617. */
  618. //#define SD_REPRINT_LAST_SELECTED_FILE
  619. /**
  620. * Auto-report SdCard status with M27 S<seconds>
  621. */
  622. //#define AUTO_REPORT_SD_STATUS
  623. #endif // SDSUPPORT
  624. /**
  625. * Additional options for Graphical Displays
  626. *
  627. * Use the optimizations here to improve printing performance,
  628. * which can be adversely affected by graphical display drawing,
  629. * especially when doing several short moves, and when printing
  630. * on DELTA and SCARA machines.
  631. *
  632. * Some of these options may result in the display lagging behind
  633. * controller events, as there is a trade-off between reliable
  634. * printing performance versus fast display updates.
  635. */
  636. #if ENABLED(DOGLCD)
  637. // Show SD percentage next to the progress bar
  638. //#define DOGM_SD_PERCENT
  639. // Enable to save many cycles by drawing a hollow frame on the Info Screen
  640. #define XYZ_HOLLOW_FRAME
  641. // Enable to save many cycles by drawing a hollow frame on Menu Screens
  642. #define MENU_HOLLOW_FRAME
  643. // A bigger font is available for edit items. Costs 3120 bytes of PROGMEM.
  644. // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
  645. //#define USE_BIG_EDIT_FONT
  646. // A smaller font may be used on the Info Screen. Costs 2300 bytes of PROGMEM.
  647. // Western only. Not available for Cyrillic, Kana, Turkish, Greek, or Chinese.
  648. //#define USE_SMALL_INFOFONT
  649. // Enable this option and reduce the value to optimize screen updates.
  650. // The normal delay is 10µs. Use the lowest value that still gives a reliable display.
  651. //#define DOGM_SPI_DELAY_US 5
  652. // Swap the CW/CCW indicators in the graphics overlay
  653. //#define OVERLAY_GFX_REVERSE
  654. #if ENABLED(U8GLIB_ST7920)
  655. /**
  656. * ST7920-based LCDs can emulate a 16 x 4 character display using
  657. * the ST7920 character-generator for very fast screen updates.
  658. * Enable LIGHTWEIGHT_UI to use this special display mode.
  659. *
  660. * Since LIGHTWEIGHT_UI has limited space, the position and status
  661. * message occupy the same line. Set STATUS_EXPIRE_SECONDS to the
  662. * length of time to display the status message before clearing.
  663. *
  664. * Set STATUS_EXPIRE_SECONDS to zero to never clear the status.
  665. * This will prevent position updates from being displayed.
  666. */
  667. //#define LIGHTWEIGHT_UI
  668. #if ENABLED(LIGHTWEIGHT_UI)
  669. #define STATUS_EXPIRE_SECONDS 20
  670. #endif
  671. #endif
  672. #endif // DOGLCD
  673. // @section safety
  674. // The hardware watchdog should reset the microcontroller disabling all outputs,
  675. // in case the firmware gets stuck and doesn't do temperature regulation.
  676. #define USE_WATCHDOG
  677. #if ENABLED(USE_WATCHDOG)
  678. // If you have a watchdog reboot in an ArduinoMega2560 then the device will hang forever, as a watchdog reset will leave the watchdog on.
  679. // The "WATCHDOG_RESET_MANUAL" goes around this by not using the hardware reset.
  680. // However, THIS FEATURE IS UNSAFE!, as it will only work if interrupts are disabled. And the code could hang in an interrupt routine with interrupts disabled.
  681. //#define WATCHDOG_RESET_MANUAL
  682. #endif
  683. // @section lcd
  684. /**
  685. * Babystepping enables movement of the axes by tiny increments without changing
  686. * the current position values. This feature is used primarily to adjust the Z
  687. * axis in the first layer of a print in real-time.
  688. *
  689. * Warning: Does not respect endstops!
  690. */
  691. #define BABYSTEPPING
  692. #if ENABLED(BABYSTEPPING)
  693. //#define BABYSTEP_XY // Also enable X/Y Babystepping. Not supported on DELTA!
  694. #define BABYSTEP_INVERT_Z false // Change if Z babysteps should go the other way
  695. #define BABYSTEP_MULTIPLICATOR 1 // Babysteps are very small. Increase for faster motion.
  696. //#define BABYSTEP_ZPROBE_OFFSET // Enable to combine M851 and Babystepping
  697. //#define DOUBLECLICK_FOR_Z_BABYSTEPPING // Double-click on the Status Screen for Z Babystepping.
  698. #define DOUBLECLICK_MAX_INTERVAL 1250 // Maximum interval between clicks, in milliseconds.
  699. // Note: Extra time may be added to mitigate controller latency.
  700. //#define BABYSTEP_ZPROBE_GFX_OVERLAY // Enable graphical overlay on Z-offset editor
  701. #endif
  702. // @section extruder
  703. /**
  704. * Linear Pressure Control v1.5
  705. *
  706. * Assumption: advance [steps] = k * (delta velocity [steps/s])
  707. * K=0 means advance disabled.
  708. *
  709. * NOTE: K values for LIN_ADVANCE 1.5 differ from earlier versions!
  710. *
  711. * Set K around 0.22 for 3mm PLA Direct Drive with ~6.5cm between the drive gear and heatbreak.
  712. * Larger K values will be needed for flexible filament and greater distances.
  713. * If this algorithm produces a higher speed offset than the extruder can handle (compared to E jerk)
  714. * print acceleration will be reduced during the affected moves to keep within the limit.
  715. *
  716. * See http://marlinfw.org/docs/features/lin_advance.html for full instructions.
  717. * Mention @Sebastianv650 on GitHub to alert the author of any issues.
  718. */
  719. #define LIN_ADVANCE
  720. #if ENABLED(LIN_ADVANCE)
  721. #define LIN_ADVANCE_K 0.22 // Unit: mm compression per 1mm/s extruder speed
  722. //#define LA_DEBUG // If enabled, this will generate debug information output over USB.
  723. #endif
  724. // @section leveling
  725. #if ENABLED(MESH_BED_LEVELING) || ENABLED(AUTO_BED_LEVELING_UBL)
  726. // Override the mesh area if the automatic (max) area is too large
  727. //#define MESH_MIN_X MESH_INSET
  728. //#define MESH_MIN_Y MESH_INSET
  729. //#define MESH_MAX_X X_BED_SIZE - (MESH_INSET)
  730. //#define MESH_MAX_Y Y_BED_SIZE - (MESH_INSET)
  731. #endif
  732. // @section extras
  733. //
  734. // G2/G3 Arc Support
  735. //
  736. #define ARC_SUPPORT // Disable this feature to save ~3226 bytes
  737. #if ENABLED(ARC_SUPPORT)
  738. #define MM_PER_ARC_SEGMENT 1 // Length of each arc segment
  739. #define N_ARC_CORRECTION 25 // Number of intertpolated segments between corrections
  740. //#define ARC_P_CIRCLES // Enable the 'P' parameter to specify complete circles
  741. //#define CNC_WORKSPACE_PLANES // Allow G2/G3 to operate in XY, ZX, or YZ planes
  742. #endif
  743. // Support for G5 with XYZE destination and IJPQ offsets. Requires ~2666 bytes.
  744. //#define BEZIER_CURVE_SUPPORT
  745. // G38.2 and G38.3 Probe Target
  746. // Set MULTIPLE_PROBING if you want G38 to double touch
  747. //#define G38_PROBE_TARGET
  748. #if ENABLED(G38_PROBE_TARGET)
  749. #define G38_MINIMUM_MOVE 0.0275 // minimum distance in mm that will produce a move (determined using the print statement in check_move)
  750. #endif
  751. // Moves (or segments) with fewer steps than this will be joined with the next move
  752. #define MIN_STEPS_PER_SEGMENT 6
  753. /**
  754. * Minimum delay after setting the stepper DIR (in ns)
  755. * 0 : No delay (Expect at least 10µS since one Stepper ISR must transpire)
  756. * 20 : Minimum for TMC2xxx drivers
  757. * 200 : Minimum for A4988 drivers
  758. * 500 : Minimum for LV8729 drivers (guess, no info in datasheet)
  759. * 650 : Minimum for DRV8825 drivers
  760. * 1500 : Minimum for TB6600 drivers (guess, no info in datasheet)
  761. * 15000 : Minimum for TB6560 drivers (guess, no info in datasheet)
  762. *
  763. * Override the default value based on the driver type set in Configuration.h.
  764. */
  765. //#define MINIMUM_STEPPER_DIR_DELAY 650
  766. /**
  767. * Minimum stepper driver pulse width (in µs)
  768. * 0 : Smallest possible width the MCU can produce, compatible with TMC2xxx drivers
  769. * 1 : Minimum for A4988 stepper drivers
  770. * 1 : Minimum for LV8729 stepper drivers
  771. * 2 : Minimum for DRV8825 stepper drivers
  772. * 3 : Minimum for TB6600 stepper drivers
  773. * 30 : Minimum for TB6560 stepper drivers
  774. *
  775. * Override the default value based on the driver type set in Configuration.h.
  776. */
  777. //#define MINIMUM_STEPPER_PULSE 2
  778. /**
  779. * Maximum stepping rate (in Hz) the stepper driver allows
  780. * If undefined, defaults to 1MHz / (2 * MINIMUM_STEPPER_PULSE)
  781. * 500000 : Maximum for A4988 stepper driver
  782. * 400000 : Maximum for TMC2xxx stepper drivers
  783. * 250000 : Maximum for DRV8825 stepper driver
  784. * 150000 : Maximum for TB6600 stepper driver
  785. * 130000 : Maximum for LV8729 stepper driver
  786. * 15000 : Maximum for TB6560 stepper driver
  787. *
  788. * Override the default value based on the driver type set in Configuration.h.
  789. */
  790. //#define MAXIMUM_STEPPER_RATE 250000
  791. // @section temperature
  792. // Control heater 0 and heater 1 in parallel.
  793. //#define HEATERS_PARALLEL
  794. //===========================================================================
  795. //================================= Buffers =================================
  796. //===========================================================================
  797. // @section hidden
  798. // The number of linear motions that can be in the plan at any give time.
  799. // THE BLOCK_BUFFER_SIZE NEEDS TO BE A POWER OF 2 (e.g. 8, 16, 32) because shifts and ors are used to do the ring-buffering.
  800. #if ENABLED(SDSUPPORT)
  801. #define BLOCK_BUFFER_SIZE 16 // SD,LCD,Buttons take more memory, block buffer needs to be smaller
  802. #else
  803. #define BLOCK_BUFFER_SIZE 16 // maximize block buffer
  804. #endif
  805. // @section serial
  806. // The ASCII buffer for serial input
  807. #define MAX_CMD_SIZE 96
  808. #define BUFSIZE 4
  809. // Transmission to Host Buffer Size
  810. // To save 386 bytes of PROGMEM (and TX_BUFFER_SIZE+3 bytes of RAM) set to 0.
  811. // To buffer a simple "ok" you need 4 bytes.
  812. // For ADVANCED_OK (M105) you need 32 bytes.
  813. // For debug-echo: 128 bytes for the optimal speed.
  814. // Other output doesn't need to be that speedy.
  815. // :[0, 2, 4, 8, 16, 32, 64, 128, 256]
  816. #define TX_BUFFER_SIZE 0
  817. // Host Receive Buffer Size
  818. // Without XON/XOFF flow control (see SERIAL_XON_XOFF below) 32 bytes should be enough.
  819. // To use flow control, set this buffer size to at least 1024 bytes.
  820. // :[0, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048]
  821. //#define RX_BUFFER_SIZE 1024
  822. #if RX_BUFFER_SIZE >= 1024
  823. // Enable to have the controller send XON/XOFF control characters to
  824. // the host to signal the RX buffer is becoming full.
  825. //#define SERIAL_XON_XOFF
  826. #endif
  827. #if ENABLED(SDSUPPORT)
  828. // Enable this option to collect and display the maximum
  829. // RX queue usage after transferring a file to SD.
  830. //#define SERIAL_STATS_MAX_RX_QUEUED
  831. // Enable this option to collect and display the number
  832. // of dropped bytes after a file transfer to SD.
  833. //#define SERIAL_STATS_DROPPED_RX
  834. #endif
  835. // Enable an emergency-command parser to intercept certain commands as they
  836. // enter the serial receive buffer, so they cannot be blocked.
  837. // Currently handles M108, M112, M410
  838. // Does not work on boards using AT90USB (USBCON) processors!
  839. //#define EMERGENCY_PARSER
  840. // Bad Serial-connections can miss a received command by sending an 'ok'
  841. // Therefore some clients abort after 30 seconds in a timeout.
  842. // Some other clients start sending commands while receiving a 'wait'.
  843. // This "wait" is only sent when the buffer is empty. 1 second is a good value here.
  844. //#define NO_TIMEOUTS 1000 // Milliseconds
  845. // Some clients will have this feature soon. This could make the NO_TIMEOUTS unnecessary.
  846. //#define ADVANCED_OK
  847. // @section extras
  848. /**
  849. * Firmware-based and LCD-controlled retract
  850. *
  851. * Add G10 / G11 commands for automatic firmware-based retract / recover.
  852. * Use M207 and M208 to define parameters for retract / recover.
  853. *
  854. * Use M209 to enable or disable auto-retract.
  855. * With auto-retract enabled, all G1 E moves within the set range
  856. * will be converted to firmware-based retract/recover moves.
  857. *
  858. * Be sure to turn off auto-retract during filament change.
  859. *
  860. * Note that M207 / M208 / M209 settings are saved to EEPROM.
  861. *
  862. */
  863. //#define FWRETRACT // ONLY PARTIALLY TESTED
  864. #if ENABLED(FWRETRACT)
  865. #define MIN_AUTORETRACT 0.1 // When auto-retract is on, convert E moves of this length and over
  866. #define MAX_AUTORETRACT 10.0 // Upper limit for auto-retract conversion
  867. #define RETRACT_LENGTH 3 // Default retract length (positive mm)
  868. #define RETRACT_LENGTH_SWAP 13 // Default swap retract length (positive mm), for extruder change
  869. #define RETRACT_FEEDRATE 45 // Default feedrate for retracting (mm/s)
  870. #define RETRACT_ZLIFT 0 // Default retract Z-lift
  871. #define RETRACT_RECOVER_LENGTH 0 // Default additional recover length (mm, added to retract length when recovering)
  872. #define RETRACT_RECOVER_LENGTH_SWAP 0 // Default additional swap recover length (mm, added to retract length when recovering from extruder change)
  873. #define RETRACT_RECOVER_FEEDRATE 8 // Default feedrate for recovering from retraction (mm/s)
  874. #define RETRACT_RECOVER_FEEDRATE_SWAP 8 // Default feedrate for recovering from swap retraction (mm/s)
  875. #endif
  876. /**
  877. * Extra Fan Speed
  878. * Adds a secondary fan speed for each print-cooling fan.
  879. * 'M106 P<fan> T3-255' : Set a secondary speed for <fan>
  880. * 'M106 P<fan> T2' : Use the set secondary speed
  881. * 'M106 P<fan> T1' : Restore the previous fan speed
  882. */
  883. //#define EXTRA_FAN_SPEED
  884. /**
  885. * Advanced Pause
  886. * Experimental feature for filament change support and for parking the nozzle when paused.
  887. * Adds the GCode M600 for initiating filament change.
  888. * If PARK_HEAD_ON_PAUSE enabled, adds the GCode M125 to pause printing and park the nozzle.
  889. *
  890. * Requires an LCD display.
  891. * Requires NOZZLE_PARK_FEATURE.
  892. * This feature is required for the default FILAMENT_RUNOUT_SCRIPT.
  893. */
  894. #define ADVANCED_PAUSE_FEATURE
  895. #if ENABLED(ADVANCED_PAUSE_FEATURE)
  896. #define PAUSE_PARK_RETRACT_FEEDRATE 60 // (mm/s) Initial retract feedrate.
  897. #define PAUSE_PARK_RETRACT_LENGTH 2 // (mm) Initial retract.
  898. // This short retract is done immediately, before parking the nozzle.
  899. #define FILAMENT_CHANGE_UNLOAD_FEEDRATE 10 // (mm/s) Unload filament feedrate. This can be pretty fast.
  900. #define FILAMENT_CHANGE_UNLOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
  901. #define FILAMENT_CHANGE_UNLOAD_LENGTH 100 // (mm) The length of filament for a complete unload.
  902. // For Bowden, the full length of the tube and nozzle.
  903. // For direct drive, the full length of the nozzle.
  904. // Set to 0 for manual unloading.
  905. #define FILAMENT_CHANGE_SLOW_LOAD_FEEDRATE 6 // (mm/s) Slow move when starting load.
  906. #define FILAMENT_CHANGE_SLOW_LOAD_LENGTH 0 // (mm) Slow length, to allow time to insert material.
  907. // 0 to disable start loading and skip to fast load only
  908. #define FILAMENT_CHANGE_FAST_LOAD_FEEDRATE 6 // (mm/s) Load filament feedrate. This can be pretty fast.
  909. #define FILAMENT_CHANGE_FAST_LOAD_ACCEL 25 // (mm/s^2) Lower acceleration may allow a faster feedrate.
  910. #define FILAMENT_CHANGE_FAST_LOAD_LENGTH 0 // (mm) Load length of filament, from extruder gear to nozzle.
  911. // For Bowden, the full length of the tube and nozzle.
  912. // For direct drive, the full length of the nozzle.
  913. //#define ADVANCED_PAUSE_CONTINUOUS_PURGE // Purge continuously up to the purge length until interrupted.
  914. #define ADVANCED_PAUSE_PURGE_FEEDRATE 3 // (mm/s) Extrude feedrate (after loading). Should be slower than load feedrate.
  915. #define ADVANCED_PAUSE_PURGE_LENGTH 50 // (mm) Length to extrude after loading.
  916. // Set to 0 for manual extrusion.
  917. // Filament can be extruded repeatedly from the Filament Change menu
  918. // until extrusion is consistent, and to purge old filament.
  919. // Filament Unload does a Retract, Delay, and Purge first:
  920. #define FILAMENT_UNLOAD_RETRACT_LENGTH 13 // (mm) Unload initial retract length.
  921. #define FILAMENT_UNLOAD_DELAY 5000 // (ms) Delay for the filament to cool after retract.
  922. #define FILAMENT_UNLOAD_PURGE_LENGTH 8 // (mm) An unretract is done, then this length is purged.
  923. #define PAUSE_PARK_NOZZLE_TIMEOUT 45 // (seconds) Time limit before the nozzle is turned off for safety.
  924. #define FILAMENT_CHANGE_ALERT_BEEPS 10 // Number of alert beeps to play when a response is needed.
  925. #define PAUSE_PARK_NO_STEPPER_TIMEOUT // Enable for XYZ steppers to stay powered on during filament change.
  926. #define PARK_HEAD_ON_PAUSE // Park the nozzle during pause and filament change.
  927. //#define HOME_BEFORE_FILAMENT_CHANGE // Ensure homing has been completed prior to parking for filament change
  928. //#define FILAMENT_LOAD_UNLOAD_GCODES // Add M701/M702 Load/Unload G-codes, plus Load/Unload in the LCD Prepare menu.
  929. //#define FILAMENT_UNLOAD_ALL_EXTRUDERS // Allow M702 to unload all extruders above a minimum target temp (as set by M302)
  930. #endif
  931. // @section tmc
  932. /**
  933. * TMC26X Stepper Driver options
  934. *
  935. * The TMC26XStepper library is required for this stepper driver.
  936. * https://github.com/trinamic/TMC26XStepper
  937. */
  938. #if HAS_DRIVER(TMC26X)
  939. #define X_MAX_CURRENT 1000 // in mA
  940. #define X_SENSE_RESISTOR 91 // in mOhms
  941. #define X_MICROSTEPS 16 // number of microsteps
  942. #define X2_MAX_CURRENT 1000
  943. #define X2_SENSE_RESISTOR 91
  944. #define X2_MICROSTEPS 16
  945. #define Y_MAX_CURRENT 1000
  946. #define Y_SENSE_RESISTOR 91
  947. #define Y_MICROSTEPS 16
  948. #define Y2_MAX_CURRENT 1000
  949. #define Y2_SENSE_RESISTOR 91
  950. #define Y2_MICROSTEPS 16
  951. #define Z_MAX_CURRENT 1000
  952. #define Z_SENSE_RESISTOR 91
  953. #define Z_MICROSTEPS 16
  954. #define Z2_MAX_CURRENT 1000
  955. #define Z2_SENSE_RESISTOR 91
  956. #define Z2_MICROSTEPS 16
  957. #define E0_MAX_CURRENT 1000
  958. #define E0_SENSE_RESISTOR 91
  959. #define E0_MICROSTEPS 16
  960. #define E1_MAX_CURRENT 1000
  961. #define E1_SENSE_RESISTOR 91
  962. #define E1_MICROSTEPS 16
  963. #define E2_MAX_CURRENT 1000
  964. #define E2_SENSE_RESISTOR 91
  965. #define E2_MICROSTEPS 16
  966. #define E3_MAX_CURRENT 1000
  967. #define E3_SENSE_RESISTOR 91
  968. #define E3_MICROSTEPS 16
  969. #define E4_MAX_CURRENT 1000
  970. #define E4_SENSE_RESISTOR 91
  971. #define E4_MICROSTEPS 16
  972. #endif
  973. // @section tmc_smart
  974. /**
  975. * To use TMC2130 stepper drivers in SPI mode connect your SPI pins to
  976. * the hardware SPI interface on your board and define the required CS pins
  977. * in your `pins_MYBOARD.h` file. (e.g., RAMPS 1.4 uses AUX3 pins `X_CS_PIN 53`, `Y_CS_PIN 49`, etc.).
  978. * You may also use software SPI if you wish to use general purpose IO pins.
  979. *
  980. * You'll also need the TMC2130Stepper Arduino library
  981. * (https://github.com/teemuatlut/TMC2130Stepper).
  982. *
  983. * To use TMC2208 stepper UART-configurable stepper drivers
  984. * connect #_SERIAL_TX_PIN to the driver side PDN_UART pin with a 1K resistor.
  985. * To use the reading capabilities, also connect #_SERIAL_RX_PIN
  986. * to PDN_UART without a resistor.
  987. * The drivers can also be used with hardware serial.
  988. *
  989. * You'll also need the TMC2208Stepper Arduino library
  990. * (https://github.com/teemuatlut/TMC2208Stepper).
  991. */
  992. #if HAS_TRINAMIC
  993. #define R_SENSE 0.11 // R_sense resistor for SilentStepStick2130
  994. #define HOLD_MULTIPLIER 0.5 // Scales down the holding current from run current
  995. #define INTERPOLATE true // Interpolate X/Y/Z_MICROSTEPS to 256
  996. #define X_CURRENT 800 // rms current in mA. Multiply by 1.41 for peak current.
  997. #define X_MICROSTEPS 16 // 0..256
  998. #define Y_CURRENT 800
  999. #define Y_MICROSTEPS 16
  1000. #define Z_CURRENT 800
  1001. #define Z_MICROSTEPS 16
  1002. #define X2_CURRENT 800
  1003. #define X2_MICROSTEPS 16
  1004. #define Y2_CURRENT 800
  1005. #define Y2_MICROSTEPS 16
  1006. #define Z2_CURRENT 800
  1007. #define Z2_MICROSTEPS 16
  1008. #define E0_CURRENT 800
  1009. #define E0_MICROSTEPS 16
  1010. #define E1_CURRENT 800
  1011. #define E1_MICROSTEPS 16
  1012. #define E2_CURRENT 800
  1013. #define E2_MICROSTEPS 16
  1014. #define E3_CURRENT 800
  1015. #define E3_MICROSTEPS 16
  1016. #define E4_CURRENT 800
  1017. #define E4_MICROSTEPS 16
  1018. /**
  1019. * Use software SPI for TMC2130.
  1020. * The default SW SPI pins are defined the respective pins files,
  1021. * but you can override or define them here.
  1022. */
  1023. //#define TMC_USE_SW_SPI
  1024. //#define TMC_SW_MOSI -1
  1025. //#define TMC_SW_MISO -1
  1026. //#define TMC_SW_SCK -1
  1027. /**
  1028. * Use Trinamic's ultra quiet stepping mode.
  1029. * When disabled, Marlin will use spreadCycle stepping mode.
  1030. */
  1031. #define STEALTHCHOP
  1032. /**
  1033. * Monitor Trinamic TMC2130 and TMC2208 drivers for error conditions,
  1034. * like overtemperature and short to ground. TMC2208 requires hardware serial.
  1035. * In the case of overtemperature Marlin can decrease the driver current until error condition clears.
  1036. * Other detected conditions can be used to stop the current print.
  1037. * Relevant g-codes:
  1038. * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given.
  1039. * M911 - Report stepper driver overtemperature pre-warn condition.
  1040. * M912 - Clear stepper driver overtemperature pre-warn condition flag.
  1041. * M122 S0/1 - Report driver parameters (Requires TMC_DEBUG)
  1042. */
  1043. //#define MONITOR_DRIVER_STATUS
  1044. #if ENABLED(MONITOR_DRIVER_STATUS)
  1045. #define CURRENT_STEP_DOWN 50 // [mA]
  1046. #define REPORT_CURRENT_CHANGE
  1047. #define STOP_ON_ERROR
  1048. #endif
  1049. /**
  1050. * The driver will switch to spreadCycle when stepper speed is over HYBRID_THRESHOLD.
  1051. * This mode allows for faster movements at the expense of higher noise levels.
  1052. * STEALTHCHOP needs to be enabled.
  1053. * M913 X/Y/Z/E to live tune the setting
  1054. */
  1055. //#define HYBRID_THRESHOLD
  1056. #define X_HYBRID_THRESHOLD 100 // [mm/s]
  1057. #define X2_HYBRID_THRESHOLD 100
  1058. #define Y_HYBRID_THRESHOLD 100
  1059. #define Y2_HYBRID_THRESHOLD 100
  1060. #define Z_HYBRID_THRESHOLD 3
  1061. #define Z2_HYBRID_THRESHOLD 3
  1062. #define E0_HYBRID_THRESHOLD 30
  1063. #define E1_HYBRID_THRESHOLD 30
  1064. #define E2_HYBRID_THRESHOLD 30
  1065. #define E3_HYBRID_THRESHOLD 30
  1066. #define E4_HYBRID_THRESHOLD 30
  1067. /**
  1068. * Use stallGuard2 to sense an obstacle and trigger an endstop.
  1069. * You need to place a wire from the driver's DIAG1 pin to the X/Y endstop pin.
  1070. * X, Y, and Z homing will always be done in spreadCycle mode.
  1071. *
  1072. * X/Y/Z_HOMING_SENSITIVITY is used for tuning the trigger sensitivity.
  1073. * Higher values make the system LESS sensitive.
  1074. * Lower value make the system MORE sensitive.
  1075. * Too low values can lead to false positives, while too high values will collide the axis without triggering.
  1076. * It is advised to set X/Y/Z_HOME_BUMP_MM to 0.
  1077. * M914 X/Y/Z to live tune the setting
  1078. */
  1079. //#define SENSORLESS_HOMING // TMC2130 only
  1080. #if ENABLED(SENSORLESS_HOMING)
  1081. #define X_HOMING_SENSITIVITY 8
  1082. #define Y_HOMING_SENSITIVITY 8
  1083. #define Z_HOMING_SENSITIVITY 8
  1084. #endif
  1085. /**
  1086. * Enable M122 debugging command for TMC stepper drivers.
  1087. * M122 S0/1 will enable continous reporting.
  1088. */
  1089. //#define TMC_DEBUG
  1090. /**
  1091. * M915 Z Axis Calibration
  1092. *
  1093. * - Adjust Z stepper current,
  1094. * - Drive the Z axis to its physical maximum, and
  1095. * - Home Z to account for the lost steps.
  1096. *
  1097. * Use M915 Snn to specify the current.
  1098. * Use M925 Znn to add extra Z height to Z_MAX_POS.
  1099. */
  1100. //#define TMC_Z_CALIBRATION
  1101. #if ENABLED(TMC_Z_CALIBRATION)
  1102. #define CALIBRATION_CURRENT 250
  1103. #define CALIBRATION_EXTRA_HEIGHT 10
  1104. #endif
  1105. /**
  1106. * You can set your own advanced settings by filling in predefined functions.
  1107. * A list of available functions can be found on the library github page
  1108. * https://github.com/teemuatlut/TMC2130Stepper
  1109. * https://github.com/teemuatlut/TMC2208Stepper
  1110. *
  1111. * Example:
  1112. * #define TMC_ADV() { \
  1113. * stepperX.diag0_temp_prewarn(1); \
  1114. * stepperY.interpolate(0); \
  1115. * }
  1116. */
  1117. #define TMC_ADV() { }
  1118. #endif // TMC2130 || TMC2208
  1119. // @section L6470
  1120. /**
  1121. * L6470 Stepper Driver options
  1122. *
  1123. * The Arduino-L6470 library is required for this stepper driver.
  1124. * https://github.com/ameyer/Arduino-L6470
  1125. */
  1126. #if HAS_DRIVER(L6470)
  1127. #define X_MICROSTEPS 16 // number of microsteps
  1128. #define X_OVERCURRENT 2000 // maxc current in mA. If the current goes over this value, the driver will switch off
  1129. #define X_STALLCURRENT 1500 // current in mA where the driver will detect a stall
  1130. #define X2_MICROSTEPS 16
  1131. #define X2_OVERCURRENT 2000
  1132. #define X2_STALLCURRENT 1500
  1133. #define Y_MICROSTEPS 16
  1134. #define Y_OVERCURRENT 2000
  1135. #define Y_STALLCURRENT 1500
  1136. #define Y2_MICROSTEPS 16
  1137. #define Y2_OVERCURRENT 2000
  1138. #define Y2_STALLCURRENT 1500
  1139. #define Z_MICROSTEPS 16
  1140. #define Z_OVERCURRENT 2000
  1141. #define Z_STALLCURRENT 1500
  1142. #define Z2_MICROSTEPS 16
  1143. #define Z2_OVERCURRENT 2000
  1144. #define Z2_STALLCURRENT 1500
  1145. #define E0_MICROSTEPS 16
  1146. #define E0_OVERCURRENT 2000
  1147. #define E0_STALLCURRENT 1500
  1148. #define E1_MICROSTEPS 16
  1149. #define E1_OVERCURRENT 2000
  1150. #define E1_STALLCURRENT 1500
  1151. #define E2_MICROSTEPS 16
  1152. #define E2_OVERCURRENT 2000
  1153. #define E2_STALLCURRENT 1500
  1154. #define E3_MICROSTEPS 16
  1155. #define E3_OVERCURRENT 2000
  1156. #define E3_STALLCURRENT 1500
  1157. #define E4_MICROSTEPS 16
  1158. #define E4_OVERCURRENT 2000
  1159. #define E4_STALLCURRENT 1500
  1160. #endif
  1161. /**
  1162. * TWI/I2C BUS
  1163. *
  1164. * This feature is an EXPERIMENTAL feature so it shall not be used on production
  1165. * machines. Enabling this will allow you to send and receive I2C data from slave
  1166. * devices on the bus.
  1167. *
  1168. * ; Example #1
  1169. * ; This macro send the string "Marlin" to the slave device with address 0x63 (99)
  1170. * ; It uses multiple M260 commands with one B<base 10> arg
  1171. * M260 A99 ; Target slave address
  1172. * M260 B77 ; M
  1173. * M260 B97 ; a
  1174. * M260 B114 ; r
  1175. * M260 B108 ; l
  1176. * M260 B105 ; i
  1177. * M260 B110 ; n
  1178. * M260 S1 ; Send the current buffer
  1179. *
  1180. * ; Example #2
  1181. * ; Request 6 bytes from slave device with address 0x63 (99)
  1182. * M261 A99 B5
  1183. *
  1184. * ; Example #3
  1185. * ; Example serial output of a M261 request
  1186. * echo:i2c-reply: from:99 bytes:5 data:hello
  1187. */
  1188. // @section i2cbus
  1189. //#define EXPERIMENTAL_I2CBUS
  1190. #define I2C_SLAVE_ADDRESS 0 // Set a value from 8 to 127 to act as a slave
  1191. // @section extras
  1192. /**
  1193. * Spindle & Laser control
  1194. *
  1195. * Add the M3, M4, and M5 commands to turn the spindle/laser on and off, and
  1196. * to set spindle speed, spindle direction, and laser power.
  1197. *
  1198. * SuperPid is a router/spindle speed controller used in the CNC milling community.
  1199. * Marlin can be used to turn the spindle on and off. It can also be used to set
  1200. * the spindle speed from 5,000 to 30,000 RPM.
  1201. *
  1202. * You'll need to select a pin for the ON/OFF function and optionally choose a 0-5V
  1203. * hardware PWM pin for the speed control and a pin for the rotation direction.
  1204. *
  1205. * See http://marlinfw.org/docs/configuration/laser_spindle.html for more config details.
  1206. */
  1207. //#define SPINDLE_LASER_ENABLE
  1208. #if ENABLED(SPINDLE_LASER_ENABLE)
  1209. #define SPINDLE_LASER_ENABLE_INVERT false // set to "true" if the on/off function is reversed
  1210. #define SPINDLE_LASER_PWM true // set to true if your controller supports setting the speed/power
  1211. #define SPINDLE_LASER_PWM_INVERT true // set to "true" if the speed/power goes up when you want it to go slower
  1212. #define SPINDLE_LASER_POWERUP_DELAY 5000 // delay in milliseconds to allow the spindle/laser to come up to speed/power
  1213. #define SPINDLE_LASER_POWERDOWN_DELAY 5000 // delay in milliseconds to allow the spindle to stop
  1214. #define SPINDLE_DIR_CHANGE true // set to true if your spindle controller supports changing spindle direction
  1215. #define SPINDLE_INVERT_DIR false
  1216. #define SPINDLE_STOP_ON_DIR_CHANGE true // set to true if Marlin should stop the spindle before changing rotation direction
  1217. /**
  1218. * The M3 & M4 commands use the following equation to convert PWM duty cycle to speed/power
  1219. *
  1220. * SPEED/POWER = PWM duty cycle * SPEED_POWER_SLOPE + SPEED_POWER_INTERCEPT
  1221. * where PWM duty cycle varies from 0 to 255
  1222. *
  1223. * set the following for your controller (ALL MUST BE SET)
  1224. */
  1225. #define SPEED_POWER_SLOPE 118.4
  1226. #define SPEED_POWER_INTERCEPT 0
  1227. #define SPEED_POWER_MIN 5000
  1228. #define SPEED_POWER_MAX 30000 // SuperPID router controller 0 - 30,000 RPM
  1229. //#define SPEED_POWER_SLOPE 0.3922
  1230. //#define SPEED_POWER_INTERCEPT 0
  1231. //#define SPEED_POWER_MIN 10
  1232. //#define SPEED_POWER_MAX 100 // 0-100%
  1233. #endif
  1234. /**
  1235. * Filament Width Sensor
  1236. *
  1237. * Measures the filament width in real-time and adjusts
  1238. * flow rate to compensate for any irregularities.
  1239. *
  1240. * Also allows the measured filament diameter to set the
  1241. * extrusion rate, so the slicer only has to specify the
  1242. * volume.
  1243. *
  1244. * Only a single extruder is supported at this time.
  1245. *
  1246. * 34 RAMPS_14 : Analog input 5 on the AUX2 connector
  1247. * 81 PRINTRBOARD : Analog input 2 on the Exp1 connector (version B,C,D,E)
  1248. * 301 RAMBO : Analog input 3
  1249. *
  1250. * Note: May require analog pins to be defined for other boards.
  1251. */
  1252. //#define FILAMENT_WIDTH_SENSOR
  1253. #if ENABLED(FILAMENT_WIDTH_SENSOR)
  1254. #define FILAMENT_SENSOR_EXTRUDER_NUM 0 // Index of the extruder that has the filament sensor. :[0,1,2,3,4]
  1255. #define MEASUREMENT_DELAY_CM 14 // (cm) The distance from the filament sensor to the melting chamber
  1256. #define FILWIDTH_ERROR_MARGIN 1.0 // (mm) If a measurement differs too much from nominal width ignore it
  1257. #define MAX_MEASUREMENT_DELAY 20 // (bytes) Buffer size for stored measurements (1 byte per cm). Must be larger than MEASUREMENT_DELAY_CM.
  1258. #define DEFAULT_MEASURED_FILAMENT_DIA DEFAULT_NOMINAL_FILAMENT_DIA // Set measured to nominal initially
  1259. // Display filament width on the LCD status line. Status messages will expire after 5 seconds.
  1260. //#define FILAMENT_LCD_DISPLAY
  1261. #endif
  1262. /**
  1263. * CNC Coordinate Systems
  1264. *
  1265. * Enables G53 and G54-G59.3 commands to select coordinate systems
  1266. * and G92.1 to reset the workspace to native machine space.
  1267. */
  1268. //#define CNC_COORDINATE_SYSTEMS
  1269. /**
  1270. * M43 - display pin status, watch pins for changes, watch endstops & toggle LED, Z servo probe test, toggle pins
  1271. */
  1272. //#define PINS_DEBUGGING
  1273. /**
  1274. * Auto-report temperatures with M155 S<seconds>
  1275. */
  1276. #define AUTO_REPORT_TEMPERATURES
  1277. /**
  1278. * Include capabilities in M115 output
  1279. */
  1280. #define EXTENDED_CAPABILITIES_REPORT
  1281. /**
  1282. * Disable all Volumetric extrusion options
  1283. */
  1284. //#define NO_VOLUMETRICS
  1285. #if DISABLED(NO_VOLUMETRICS)
  1286. /**
  1287. * Volumetric extrusion default state
  1288. * Activate to make volumetric extrusion the default method,
  1289. * with DEFAULT_NOMINAL_FILAMENT_DIA as the default diameter.
  1290. *
  1291. * M200 D0 to disable, M200 Dn to set a new diameter.
  1292. */
  1293. //#define VOLUMETRIC_DEFAULT_ON
  1294. #endif
  1295. /**
  1296. * Enable this option for a leaner build of Marlin that removes all
  1297. * workspace offsets, simplifying coordinate transformations, leveling, etc.
  1298. *
  1299. * - M206 and M428 are disabled.
  1300. * - G92 will revert to its behavior from Marlin 1.0.
  1301. */
  1302. //#define NO_WORKSPACE_OFFSETS
  1303. /**
  1304. * Set the number of proportional font spaces required to fill up a typical character space.
  1305. * This can help to better align the output of commands like `G29 O` Mesh Output.
  1306. *
  1307. * For clients that use a fixed-width font (like OctoPrint), leave this set to 1.0.
  1308. * Otherwise, adjust according to your client and font.
  1309. */
  1310. #define PROPORTIONAL_FONT_RATIO 1.0
  1311. /**
  1312. * Spend 28 bytes of SRAM to optimize the GCode parser
  1313. */
  1314. #define FASTER_GCODE_PARSER
  1315. /**
  1316. * User-defined menu items that execute custom GCode
  1317. */
  1318. //#define CUSTOM_USER_MENUS
  1319. #if ENABLED(CUSTOM_USER_MENUS)
  1320. #define USER_SCRIPT_DONE "M117 User Script Done"
  1321. #define USER_SCRIPT_AUDIBLE_FEEDBACK
  1322. //#define USER_SCRIPT_RETURN // Return to status screen after a script
  1323. #define USER_DESC_1 "Home & UBL Info"
  1324. #define USER_GCODE_1 "G28\nG29 W"
  1325. #define USER_DESC_2 "Preheat for PLA"
  1326. #define USER_GCODE_2 "M140 S" STRINGIFY(PREHEAT_1_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_1_TEMP_HOTEND)
  1327. #define USER_DESC_3 "Preheat for ABS"
  1328. #define USER_GCODE_3 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nM104 S" STRINGIFY(PREHEAT_2_TEMP_HOTEND)
  1329. #define USER_DESC_4 "Heat Bed/Home/Level"
  1330. #define USER_GCODE_4 "M140 S" STRINGIFY(PREHEAT_2_TEMP_BED) "\nG28\nG29"
  1331. #define USER_DESC_5 "Home & Info"
  1332. #define USER_GCODE_5 "G28\nM503"
  1333. #endif
  1334. /**
  1335. * Specify an action command to send to the host when the printer is killed.
  1336. * Will be sent in the form '//action:ACTION_ON_KILL', e.g. '//action:poweroff'.
  1337. * The host must be configured to handle the action command.
  1338. */
  1339. //#define ACTION_ON_KILL "poweroff"
  1340. /**
  1341. * Specify an action command to send to the host on pause and resume.
  1342. * Will be sent in the form '//action:ACTION_ON_PAUSE', e.g. '//action:pause'.
  1343. * The host must be configured to handle the action command.
  1344. */
  1345. //#define ACTION_ON_PAUSE "pause"
  1346. //#define ACTION_ON_RESUME "resume"
  1347. //===========================================================================
  1348. //====================== I2C Position Encoder Settings ======================
  1349. //===========================================================================
  1350. /**
  1351. * I2C position encoders for closed loop control.
  1352. * Developed by Chris Barr at Aus3D.
  1353. *
  1354. * Wiki: http://wiki.aus3d.com.au/Magnetic_Encoder
  1355. * Github: https://github.com/Aus3D/MagneticEncoder
  1356. *
  1357. * Supplier: http://aus3d.com.au/magnetic-encoder-module
  1358. * Alternative Supplier: http://reliabuild3d.com/
  1359. *
  1360. * Reilabuild encoders have been modified to improve reliability.
  1361. */
  1362. //#define I2C_POSITION_ENCODERS
  1363. #if ENABLED(I2C_POSITION_ENCODERS)
  1364. #define I2CPE_ENCODER_CNT 1 // The number of encoders installed; max of 5
  1365. // encoders supported currently.
  1366. #define I2CPE_ENC_1_ADDR I2CPE_PRESET_ADDR_X // I2C address of the encoder. 30-200.
  1367. #define I2CPE_ENC_1_AXIS X_AXIS // Axis the encoder module is installed on. <X|Y|Z|E>_AXIS.
  1368. #define I2CPE_ENC_1_TYPE I2CPE_ENC_TYPE_LINEAR // Type of encoder: I2CPE_ENC_TYPE_LINEAR -or-
  1369. // I2CPE_ENC_TYPE_ROTARY.
  1370. #define I2CPE_ENC_1_TICKS_UNIT 2048 // 1024 for magnetic strips with 2mm poles; 2048 for
  1371. // 1mm poles. For linear encoders this is ticks / mm,
  1372. // for rotary encoders this is ticks / revolution.
  1373. //#define I2CPE_ENC_1_TICKS_REV (16 * 200) // Only needed for rotary encoders; number of stepper
  1374. // steps per full revolution (motor steps/rev * microstepping)
  1375. //#define I2CPE_ENC_1_INVERT // Invert the direction of axis travel.
  1376. #define I2CPE_ENC_1_EC_METHOD I2CPE_ECM_MICROSTEP // Type of error error correction.
  1377. #define I2CPE_ENC_1_EC_THRESH 0.10 // Threshold size for error (in mm) above which the
  1378. // printer will attempt to correct the error; errors
  1379. // smaller than this are ignored to minimize effects of
  1380. // measurement noise / latency (filter).
  1381. #define I2CPE_ENC_2_ADDR I2CPE_PRESET_ADDR_Y // Same as above, but for encoder 2.
  1382. #define I2CPE_ENC_2_AXIS Y_AXIS
  1383. #define I2CPE_ENC_2_TYPE I2CPE_ENC_TYPE_LINEAR
  1384. #define I2CPE_ENC_2_TICKS_UNIT 2048
  1385. //#define I2CPE_ENC_2_TICKS_REV (16 * 200)
  1386. //#define I2CPE_ENC_2_INVERT
  1387. #define I2CPE_ENC_2_EC_METHOD I2CPE_ECM_MICROSTEP
  1388. #define I2CPE_ENC_2_EC_THRESH 0.10
  1389. #define I2CPE_ENC_3_ADDR I2CPE_PRESET_ADDR_Z // Encoder 3. Add additional configuration options
  1390. #define I2CPE_ENC_3_AXIS Z_AXIS // as above, or use defaults below.
  1391. #define I2CPE_ENC_4_ADDR I2CPE_PRESET_ADDR_E // Encoder 4.
  1392. #define I2CPE_ENC_4_AXIS E_AXIS
  1393. #define I2CPE_ENC_5_ADDR 34 // Encoder 5.
  1394. #define I2CPE_ENC_5_AXIS E_AXIS
  1395. // Default settings for encoders which are enabled, but without settings configured above.
  1396. #define I2CPE_DEF_TYPE I2CPE_ENC_TYPE_LINEAR
  1397. #define I2CPE_DEF_ENC_TICKS_UNIT 2048
  1398. #define I2CPE_DEF_TICKS_REV (16 * 200)
  1399. #define I2CPE_DEF_EC_METHOD I2CPE_ECM_NONE
  1400. #define I2CPE_DEF_EC_THRESH 0.1
  1401. //#define I2CPE_ERR_THRESH_ABORT 100.0 // Threshold size for error (in mm) error on any given
  1402. // axis after which the printer will abort. Comment out to
  1403. // disable abort behaviour.
  1404. #define I2CPE_TIME_TRUSTED 10000 // After an encoder fault, there must be no further fault
  1405. // for this amount of time (in ms) before the encoder
  1406. // is trusted again.
  1407. /**
  1408. * Position is checked every time a new command is executed from the buffer but during long moves,
  1409. * this setting determines the minimum update time between checks. A value of 100 works well with
  1410. * error rolling average when attempting to correct only for skips and not for vibration.
  1411. */
  1412. #define I2CPE_MIN_UPD_TIME_MS 4 // (ms) Minimum time between encoder checks.
  1413. // Use a rolling average to identify persistant errors that indicate skips, as opposed to vibration and noise.
  1414. #define I2CPE_ERR_ROLLING_AVERAGE
  1415. #endif // I2C_POSITION_ENCODERS
  1416. /**
  1417. * MAX7219 Debug Matrix
  1418. *
  1419. * Add support for a low-cost 8x8 LED Matrix based on the Max7219 chip as a realtime status display.
  1420. * Requires 3 signal wires. Some useful debug options are included to demonstrate its usage.
  1421. */
  1422. //#define MAX7219_DEBUG
  1423. #if ENABLED(MAX7219_DEBUG)
  1424. #define MAX7219_CLK_PIN 64
  1425. #define MAX7219_DIN_PIN 57
  1426. #define MAX7219_LOAD_PIN 44
  1427. //#define MAX7219_GCODE // Add the M7219 G-code to control the LED matrix
  1428. #define MAX7219_INIT_TEST 2 // Do a test pattern at initialization (Set to 2 for spiral)
  1429. #define MAX7219_NUMBER_UNITS 1 // Number of Max7219 units in chain.
  1430. #define MAX7219_ROTATE 0 // Rotate the display clockwise (in multiples of +/- 90°)
  1431. // connector at: right=0 bottom=-90 top=90 left=180
  1432. /**
  1433. * Sample debug features
  1434. * If you add more debug displays, be careful to avoid conflicts!
  1435. */
  1436. #define MAX7219_DEBUG_PRINTER_ALIVE // Blink corner LED of 8x8 matrix to show that the firmware is functioning
  1437. #define MAX7219_DEBUG_PLANNER_HEAD 3 // Show the planner queue head position on this and the next LED matrix row
  1438. #define MAX7219_DEBUG_PLANNER_TAIL 5 // Show the planner queue tail position on this and the next LED matrix row
  1439. #define MAX7219_DEBUG_PLANNER_QUEUE 0 // Show the current planner queue depth on this and the next LED matrix row
  1440. // If you experience stuttering, reboots, etc. this option can reveal how
  1441. // tweaks made to the configuration are affecting the printer in real-time.
  1442. #endif
  1443. /**
  1444. * NanoDLP Sync support
  1445. *
  1446. * Add support for Synchronized Z moves when using with NanoDLP. G0/G1 axis moves will output "Z_move_comp"
  1447. * string to enable synchronization with DLP projector exposure. This change will allow to use
  1448. * [[WaitForDoneMessage]] instead of populating your gcode with M400 commands
  1449. */
  1450. //#define NANODLP_Z_SYNC
  1451. #if ENABLED(NANODLP_Z_SYNC)
  1452. //#define NANODLP_ALL_AXIS // Enables "Z_move_comp" output on any axis move.
  1453. // Default behaviour is limited to Z axis only.
  1454. #endif
  1455. // Enable Marlin dev mode which adds some special commands
  1456. //#define MARLIN_DEV_MODE
  1457. #endif // CONFIGURATION_ADV_H