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.

gcode.h 35KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916
  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. * gcode.h - Temporary container for all gcode handlers
  25. */
  26. /**
  27. * -----------------
  28. * G-Codes in Marlin
  29. * -----------------
  30. *
  31. * Helpful G-code references:
  32. * - https://marlinfw.org/meta/gcode
  33. * - https://reprap.org/wiki/G-code
  34. * - https://linuxcnc.org/docs/html/gcode.html
  35. *
  36. * Help to document Marlin's G-codes online:
  37. * - https://github.com/MarlinFirmware/MarlinDocumentation
  38. *
  39. * -----------------
  40. *
  41. * "G" Codes
  42. *
  43. * G0 -> G1
  44. * G1 - Coordinated Movement X Y Z E
  45. * G2 - CW ARC
  46. * G3 - CCW ARC
  47. * G4 - Dwell S<seconds> or P<milliseconds>
  48. * G5 - Cubic B-spline with XYZE destination and IJPQ offsets
  49. * G10 - Retract filament according to settings of M207 (Requires FWRETRACT)
  50. * G11 - Retract recover filament according to settings of M208 (Requires FWRETRACT)
  51. * G12 - Clean tool (Requires NOZZLE_CLEAN_FEATURE)
  52. * G17 - Select Plane XY (Requires CNC_WORKSPACE_PLANES)
  53. * G18 - Select Plane ZX (Requires CNC_WORKSPACE_PLANES)
  54. * G19 - Select Plane YZ (Requires CNC_WORKSPACE_PLANES)
  55. * G20 - Set input units to inches (Requires INCH_MODE_SUPPORT)
  56. * G21 - Set input units to millimeters (Requires INCH_MODE_SUPPORT)
  57. * G26 - Mesh Validation Pattern (Requires G26_MESH_VALIDATION)
  58. * G27 - Park Nozzle (Requires NOZZLE_PARK_FEATURE)
  59. * G28 - Home one or more axes
  60. * G29 - Start or continue the bed leveling probe procedure (Requires bed leveling)
  61. * G30 - Single Z probe, probes bed at X Y location (defaults to current XY location)
  62. * G31 - Dock sled (Z_PROBE_SLED only)
  63. * G32 - Undock sled (Z_PROBE_SLED only)
  64. * G33 - Delta Auto-Calibration (Requires DELTA_AUTO_CALIBRATION)
  65. * G34 - Z Stepper automatic alignment using probe: I<iterations> T<accuracy> A<amplification> (Requires Z_STEPPER_AUTO_ALIGN)
  66. * G35 - Read bed corners to help adjust bed screws: T<screw_thread> (Requires ASSISTED_TRAMMING)
  67. * G38 - Probe in any direction using the Z_MIN_PROBE (Requires G38_PROBE_TARGET)
  68. * G42 - Coordinated move to a mesh point (Requires MESH_BED_LEVELING, AUTO_BED_LEVELING_BLINEAR, or AUTO_BED_LEVELING_UBL)
  69. * G60 - Save current position. (Requires SAVED_POSITIONS)
  70. * G61 - Apply/restore saved coordinates. (Requires SAVED_POSITIONS)
  71. * G76 - Calibrate first layer temperature offsets. (Requires PROBE_TEMP_COMPENSATION)
  72. * G80 - Cancel current motion mode (Requires GCODE_MOTION_MODES)
  73. * G90 - Use Absolute Coordinates
  74. * G91 - Use Relative Coordinates
  75. * G92 - Set current position to coordinates given
  76. *
  77. * "M" Codes
  78. *
  79. * M0 - Unconditional stop - Wait for user to press a button on the LCD (Only if ULTRA_LCD is enabled)
  80. * M1 -> M0
  81. * M3 - Turn ON Laser | Spindle (clockwise), set Power | Speed. (Requires SPINDLE_FEATURE or LASER_FEATURE)
  82. * M4 - Turn ON Laser | Spindle (counter-clockwise), set Power | Speed. (Requires SPINDLE_FEATURE or LASER_FEATURE)
  83. * M5 - Turn OFF Laser | Spindle. (Requires SPINDLE_FEATURE or LASER_FEATURE)
  84. * M7 - Turn mist coolant ON. (Requires COOLANT_CONTROL)
  85. * M8 - Turn flood coolant ON. (Requires COOLANT_CONTROL)
  86. * M9 - Turn coolant OFF. (Requires COOLANT_CONTROL)
  87. * M12 - Set up closed loop control system. (Requires EXTERNAL_CLOSED_LOOP_CONTROLLER)
  88. * M16 - Expected printer check. (Requires EXPECTED_PRINTER_CHECK)
  89. * M17 - Enable/Power all stepper motors
  90. * M18 - Disable all stepper motors; same as M84
  91. * M20 - List SD card. (Requires SDSUPPORT)
  92. * M21 - Init SD card. (Requires SDSUPPORT)
  93. * M22 - Release SD card. (Requires SDSUPPORT)
  94. * M23 - Select SD file: "M23 /path/file.gco". (Requires SDSUPPORT)
  95. * M24 - Start/resume SD print. (Requires SDSUPPORT)
  96. * M25 - Pause SD print. (Requires SDSUPPORT)
  97. * M26 - Set SD position in bytes: "M26 S12345". (Requires SDSUPPORT)
  98. * M27 - Report SD print status. (Requires SDSUPPORT)
  99. * OR, with 'S<seconds>' set the SD status auto-report interval. (Requires AUTO_REPORT_SD_STATUS)
  100. * OR, with 'C' get the current filename.
  101. * M28 - Start SD write: "M28 /path/file.gco". (Requires SDSUPPORT)
  102. * M29 - Stop SD write. (Requires SDSUPPORT)
  103. * M30 - Delete file from SD: "M30 /path/file.gco"
  104. * M31 - Report time since last M109 or SD card start to serial.
  105. * M32 - Select file and start SD print: "M32 [S<bytepos>] !/path/file.gco#". (Requires SDSUPPORT)
  106. * Use P to run other files as sub-programs: "M32 P !filename#"
  107. * The '#' is necessary when calling from within sd files, as it stops buffer prereading
  108. * M33 - Get the longname version of a path. (Requires LONG_FILENAME_HOST_SUPPORT)
  109. * M34 - Set SD Card sorting options. (Requires SDCARD_SORT_ALPHA)
  110. * M42 - Change pin status via gcode: M42 P<pin> S<value>. LED pin assumed if P is omitted. (Requires DIRECT_PIN_CONTROL)
  111. * M43 - Display pin status, watch pins for changes, watch endstops & toggle LED, Z servo probe test, toggle pins
  112. * M48 - Measure Z Probe repeatability: M48 P<points> X<pos> Y<pos> V<level> E<engage> L<legs> S<chizoid>. (Requires Z_MIN_PROBE_REPEATABILITY_TEST)
  113. * M73 - Set the progress percentage. (Requires LCD_SET_PROGRESS_MANUALLY)
  114. * M75 - Start the print job timer.
  115. * M76 - Pause the print job timer.
  116. * M77 - Stop the print job timer.
  117. * M78 - Show statistical information about the print jobs. (Requires PRINTCOUNTER)
  118. * M80 - Turn on Power Supply. (Requires PSU_CONTROL)
  119. * M81 - Turn off Power Supply. (Requires PSU_CONTROL)
  120. * M82 - Set E codes absolute (default).
  121. * M83 - Set E codes relative while in Absolute (G90) mode.
  122. * M84 - Disable steppers until next move, or use S<seconds> to specify an idle
  123. * duration after which steppers should turn off. S0 disables the timeout.
  124. * M85 - Set inactivity shutdown timer with parameter S<seconds>. To disable set zero (default)
  125. * M92 - Set planner.settings.axis_steps_per_mm for one or more axes.
  126. * M100 - Watch Free Memory (for debugging) (Requires M100_FREE_MEMORY_WATCHER)
  127. * M104 - Set extruder target temp.
  128. * M105 - Report current temperatures.
  129. * M106 - Set print fan speed.
  130. * M107 - Print fan off.
  131. * M108 - Break out of heating loops (M109, M190, M303). With no controller, breaks out of M0/M1. (Requires EMERGENCY_PARSER)
  132. * M109 - S<temp> Wait for extruder current temp to reach target temp. ** Wait only when heating! **
  133. * R<temp> Wait for extruder current temp to reach target temp. ** Wait for heating or cooling. **
  134. * If AUTOTEMP is enabled, S<mintemp> B<maxtemp> F<factor>. Exit autotemp by any M109 without F
  135. * M110 - Set the current line number. (Used by host printing)
  136. * M111 - Set debug flags: "M111 S<flagbits>". See flag bits defined in enum.h.
  137. * M112 - Full Shutdown.
  138. * M113 - Get or set the timeout interval for Host Keepalive "busy" messages. (Requires HOST_KEEPALIVE_FEATURE)
  139. * M114 - Report current position.
  140. * M115 - Report capabilities. (Extended capabilities requires EXTENDED_CAPABILITIES_REPORT)
  141. * M117 - Display a message on the controller screen. (Requires an LCD)
  142. * M118 - Display a message in the host console.
  143. * M119 - Report endstops status.
  144. * M120 - Enable endstops detection.
  145. * M121 - Disable endstops detection.
  146. * M122 - Debug stepper (Requires at least one _DRIVER_TYPE defined as TMC2130/2160/5130/5160/2208/2209/2660 or L6470)
  147. * M125 - Save current position and move to filament change position. (Requires PARK_HEAD_ON_PAUSE)
  148. * M126 - Solenoid Air Valve Open. (Requires BARICUDA)
  149. * M127 - Solenoid Air Valve Closed. (Requires BARICUDA)
  150. * M128 - EtoP Open. (Requires BARICUDA)
  151. * M129 - EtoP Closed. (Requires BARICUDA)
  152. * M140 - Set bed target temp. S<temp>
  153. * M141 - Set heated chamber target temp. S<temp> (Requires a chamber heater)
  154. * M143 - Set cooler target temp. S<temp> (Requires a laser cooling device)
  155. * M145 - Set heatup values for materials on the LCD. H<hotend> B<bed> F<fan speed> for S<material> (0=PLA, 1=ABS)
  156. * M149 - Set temperature units. (Requires TEMPERATURE_UNITS_SUPPORT)
  157. * M150 - Set Status LED Color as R<red> U<green> B<blue> W<white> P<bright>. Values 0-255. (Requires BLINKM, RGB_LED, RGBW_LED, NEOPIXEL_LED, PCA9533, or PCA9632).
  158. * M155 - Auto-report temperatures with interval of S<seconds>. (Requires AUTO_REPORT_TEMPERATURES)
  159. * M163 - Set a single proportion for a mixing extruder. (Requires MIXING_EXTRUDER)
  160. * M164 - Commit the mix and save to a virtual tool (current, or as specified by 'S'). (Requires MIXING_EXTRUDER)
  161. * M165 - Set the mix for the mixing extruder (and current virtual tool) with parameters ABCDHI. (Requires MIXING_EXTRUDER and DIRECT_MIXING_IN_G1)
  162. * M166 - Set the Gradient Mix for the mixing extruder. (Requires GRADIENT_MIX)
  163. * M190 - S<temp> Wait for bed current temp to reach target temp. ** Wait only when heating! **
  164. * R<temp> Wait for bed current temp to reach target temp. ** Wait for heating or cooling. **
  165. * M193 - R<temp> Wait for cooler temp to reach target temp. ** Wait for cooling. **
  166. * M200 - Set filament diameter, D<diameter>, setting E axis units to cubic. (Use S0 to revert to linear units.)
  167. * M201 - Set max acceleration in units/s^2 for print moves: "M201 X<accel> Y<accel> Z<accel> E<accel>"
  168. * M202 - Set max acceleration in units/s^2 for travel moves: "M202 X<accel> Y<accel> Z<accel> E<accel>" ** UNUSED IN MARLIN! **
  169. * M203 - Set maximum feedrate: "M203 X<fr> Y<fr> Z<fr> E<fr>" in units/sec.
  170. * M204 - Set default acceleration in units/sec^2: P<printing> R<extruder_only> T<travel>
  171. * M205 - Set advanced settings. Current units apply:
  172. S<print> T<travel> minimum speeds
  173. B<minimum segment time>
  174. X<max X jerk>, Y<max Y jerk>, Z<max Z jerk>, E<max E jerk>
  175. * M206 - Set additional homing offset. (Disabled by NO_WORKSPACE_OFFSETS or DELTA)
  176. * M207 - Set Retract Length: S<length>, Feedrate: F<units/min>, and Z lift: Z<distance>. (Requires FWRETRACT)
  177. * M208 - Set Recover (unretract) Additional (!) Length: S<length> and Feedrate: F<units/min>. (Requires FWRETRACT)
  178. * M209 - Turn Automatic Retract Detection on/off: S<0|1> (For slicers that don't support G10/11). (Requires FWRETRACT_AUTORETRACT)
  179. Every normal extrude-only move will be classified as retract depending on the direction.
  180. * M211 - Enable, Disable, and/or Report software endstops: S<0|1> (Requires MIN_SOFTWARE_ENDSTOPS or MAX_SOFTWARE_ENDSTOPS)
  181. * M217 - Set filament swap parameters: "M217 S<length> P<feedrate> R<feedrate>". (Requires SINGLENOZZLE)
  182. * M218 - Set/get a tool offset: "M218 T<index> X<offset> Y<offset>". (Requires 2 or more extruders)
  183. * M220 - Set Feedrate Percentage: "M220 S<percent>" (i.e., "FR" on the LCD)
  184. * Use "M220 B" to back up the Feedrate Percentage and "M220 R" to restore it. (Requires an MMU_MODEL version 2 or 2S)
  185. * M221 - Set Flow Percentage: "M221 S<percent>"
  186. * M226 - Wait until a pin is in a given state: "M226 P<pin> S<state>" (Requires DIRECT_PIN_CONTROL)
  187. * M240 - Trigger a camera to take a photograph. (Requires PHOTO_GCODE)
  188. * M250 - Set LCD contrast: "M250 C<contrast>" (0-63). (Requires LCD support)
  189. * M260 - i2c Send Data (Requires EXPERIMENTAL_I2CBUS)
  190. * M261 - i2c Request Data (Requires EXPERIMENTAL_I2CBUS)
  191. * M280 - Set servo position absolute: "M280 P<index> S<angle|µs>". (Requires servos)
  192. * M281 - Set servo min|max position: "M281 P<index> L<min> U<max>". (Requires EDITABLE_SERVO_ANGLES)
  193. * M290 - Babystepping (Requires BABYSTEPPING)
  194. * M300 - Play beep sound S<frequency Hz> P<duration ms>
  195. * M301 - Set PID parameters P I and D. (Requires PIDTEMP)
  196. * M302 - Allow cold extrudes, or set the minimum extrude S<temperature>. (Requires PREVENT_COLD_EXTRUSION)
  197. * M303 - PID relay autotune S<temperature> sets the target temperature. Default 150C. (Requires PIDTEMP)
  198. * M304 - Set bed PID parameters P I and D. (Requires PIDTEMPBED)
  199. * M305 - Set user thermistor parameters R T and P. (Requires TEMP_SENSOR_x 1000)
  200. * M309 - Set chamber PID parameters P I and D. (Requires PIDTEMPCHAMBER)
  201. * M350 - Set microstepping mode. (Requires digital microstepping pins.)
  202. * M351 - Toggle MS1 MS2 pins directly. (Requires digital microstepping pins.)
  203. * M355 - Set Case Light on/off and set brightness. (Requires CASE_LIGHT_PIN)
  204. * M380 - Activate solenoid on active extruder. (Requires EXT_SOLENOID)
  205. * M381 - Disable all solenoids. (Requires EXT_SOLENOID)
  206. * M400 - Finish all moves.
  207. * M401 - Deploy and activate Z probe. (Requires a probe)
  208. * M402 - Deactivate and stow Z probe. (Requires a probe)
  209. * M403 - Set filament type for PRUSA MMU2
  210. * M404 - Display or set the Nominal Filament Width: "W<diameter>". (Requires FILAMENT_WIDTH_SENSOR)
  211. * M405 - Enable Filament Sensor flow control. "M405 D<delay_cm>". (Requires FILAMENT_WIDTH_SENSOR)
  212. * M406 - Disable Filament Sensor flow control. (Requires FILAMENT_WIDTH_SENSOR)
  213. * M407 - Display measured filament diameter in millimeters. (Requires FILAMENT_WIDTH_SENSOR)
  214. * M410 - Quickstop. Abort all planned moves.
  215. * M412 - Enable / Disable Filament Runout Detection. (Requires FILAMENT_RUNOUT_SENSOR)
  216. * M413 - Enable / Disable Power-Loss Recovery. (Requires POWER_LOSS_RECOVERY)
  217. * M414 - Set language by index. (Requires LCD_LANGUAGE_2...)
  218. * M420 - Enable/Disable Leveling (with current values) S1=enable S0=disable (Requires MESH_BED_LEVELING or ABL)
  219. * M421 - Set a single Z coordinate in the Mesh Leveling grid. X<units> Y<units> Z<units> (Requires MESH_BED_LEVELING, AUTO_BED_LEVELING_BILINEAR, or AUTO_BED_LEVELING_UBL)
  220. * M422 - Set Z Stepper automatic alignment position using probe. X<units> Y<units> A<axis> (Requires Z_STEPPER_AUTO_ALIGN)
  221. * M425 - Enable/Disable and tune backlash correction. (Requires BACKLASH_COMPENSATION and BACKLASH_GCODE)
  222. * M428 - Set the home_offset based on the current_position. Nearest edge applies. (Disabled by NO_WORKSPACE_OFFSETS or DELTA)
  223. * M430 - Read the system current, voltage, and power (Requires POWER_MONITOR_CURRENT, POWER_MONITOR_VOLTAGE, or POWER_MONITOR_FIXED_VOLTAGE)
  224. * M486 - Identify and cancel objects. (Requires CANCEL_OBJECTS)
  225. * M500 - Store parameters in EEPROM. (Requires EEPROM_SETTINGS)
  226. * M501 - Restore parameters from EEPROM. (Requires EEPROM_SETTINGS)
  227. * M502 - Revert to the default "factory settings". ** Does not write them to EEPROM! **
  228. * M503 - Print the current settings (in memory): "M503 S<verbose>". S0 specifies compact output.
  229. * M504 - Validate EEPROM contents. (Requires EEPROM_SETTINGS)
  230. * M510 - Lock Printer
  231. * M511 - Unlock Printer
  232. * M512 - Set/Change/Remove Password
  233. * M524 - Abort the current SD print job started with M24. (Requires SDSUPPORT)
  234. * M540 - Enable/disable SD card abort on endstop hit: "M540 S<state>". (Requires SD_ABORT_ON_ENDSTOP_HIT)
  235. * M552 - Get or set IP address. Enable/disable network interface. (Requires enabled Ethernet port)
  236. * M553 - Get or set IP netmask. (Requires enabled Ethernet port)
  237. * M554 - Get or set IP gateway. (Requires enabled Ethernet port)
  238. * M569 - Enable stealthChop on an axis. (Requires at least one _DRIVER_TYPE to be TMC2130/2160/2208/2209/5130/5160)
  239. * M600 - Pause for filament change: "M600 X<pos> Y<pos> Z<raise> E<first_retract> L<later_retract>". (Requires ADVANCED_PAUSE_FEATURE)
  240. * M603 - Configure filament change: "M603 T<tool> U<unload_length> L<load_length>". (Requires ADVANCED_PAUSE_FEATURE)
  241. * M605 - Set Dual X-Carriage movement mode: "M605 S<mode> [X<x_offset>] [R<temp_offset>]". (Requires DUAL_X_CARRIAGE)
  242. * M665 - Set delta configurations: "M665 H<delta height> L<diagonal rod> R<delta radius> S<segments/s> B<calibration radius> X<Alpha angle trim> Y<Beta angle trim> Z<Gamma angle trim> (Requires DELTA)
  243. * M666 - Set/get offsets for delta (Requires DELTA) or dual endstops. (Requires [XYZ]_DUAL_ENDSTOPS)
  244. * M672 - Set/Reset Duet Smart Effector's sensitivity. (Requires DUET_SMART_EFFECTOR and SMART_EFFECTOR_MOD_PIN)
  245. * M701 - Load filament (Requires FILAMENT_LOAD_UNLOAD_GCODES)
  246. * M702 - Unload filament (Requires FILAMENT_LOAD_UNLOAD_GCODES)
  247. * M808 - Set or Goto a Repeat Marker (Requires GCODE_REPEAT_MARKERS)
  248. * M810-M819 - Define/execute a G-code macro (Requires GCODE_MACROS)
  249. * M851 - Set Z probe's XYZ offsets in current units. (Negative values: X=left, Y=front, Z=below)
  250. * M852 - Set skew factors: "M852 [I<xy>] [J<xz>] [K<yz>]". (Requires SKEW_CORRECTION_GCODE, and SKEW_CORRECTION_FOR_Z for IJ)
  251. * M860 - Report the position of position encoder modules.
  252. * M861 - Report the status of position encoder modules.
  253. * M862 - Perform an axis continuity test for position encoder modules.
  254. * M863 - Perform steps-per-mm calibration for position encoder modules.
  255. * M864 - Change position encoder module I2C address.
  256. * M865 - Check position encoder module firmware version.
  257. * M866 - Report or reset position encoder module error count.
  258. * M867 - Enable/disable or toggle error correction for position encoder modules.
  259. * M868 - Report or set position encoder module error correction threshold.
  260. * M869 - Report position encoder module error.
  261. * M871 - Print/reset/clear first layer temperature offset values. (Requires PROBE_TEMP_COMPENSATION)
  262. * M192 - Wait for probe temp (Requires PROBE_TEMP_COMPENSATION)
  263. * M876 - Handle Prompt Response. (Requires HOST_PROMPT_SUPPORT and not EMERGENCY_PARSER)
  264. * M900 - Get or Set Linear Advance K-factor. (Requires LIN_ADVANCE)
  265. * M906 - Set or get motor current in milliamps using axis codes X, Y, Z, E. Report values if no axis codes given. (Requires at least one _DRIVER_TYPE defined as TMC2130/2160/5130/5160/2208/2209/2660 or L6470)
  266. * M907 - Set digital trimpot motor current using axis codes. (Requires a board with digital trimpots)
  267. * M908 - Control digital trimpot directly. (Requires HAS_MOTOR_CURRENT_DAC or DIGIPOTSS_PIN)
  268. * M909 - Print digipot/DAC current value. (Requires HAS_MOTOR_CURRENT_DAC)
  269. * M910 - Commit digipot/DAC value to external EEPROM via I2C. (Requires HAS_MOTOR_CURRENT_DAC)
  270. * M911 - Report stepper driver overtemperature pre-warn condition. (Requires at least one _DRIVER_TYPE defined as TMC2130/2160/5130/5160/2208/2209/2660)
  271. * M912 - Clear stepper driver overtemperature pre-warn condition flag. (Requires at least one _DRIVER_TYPE defined as TMC2130/2160/5130/5160/2208/2209/2660)
  272. * M913 - Set HYBRID_THRESHOLD speed. (Requires HYBRID_THRESHOLD)
  273. * M914 - Set StallGuard sensitivity. (Requires SENSORLESS_HOMING or SENSORLESS_PROBING)
  274. * M916 - L6470 tuning: Increase KVAL_HOLD until thermal warning. (Requires at least one _DRIVER_TYPE L6470)
  275. * M917 - L6470 tuning: Find minimum current thresholds. (Requires at least one _DRIVER_TYPE L6470)
  276. * M918 - L6470 tuning: Increase speed until max or error. (Requires at least one _DRIVER_TYPE L6470)
  277. * M951 - Set Magnetic Parking Extruder parameters. (Requires MAGNETIC_PARKING_EXTRUDER)
  278. * M7219 - Control Max7219 Matrix LEDs. (Requires MAX7219_GCODE)
  279. *
  280. * M360 - SCARA calibration: Move to cal-position ThetaA (0 deg calibration)
  281. * M361 - SCARA calibration: Move to cal-position ThetaB (90 deg calibration - steps per degree)
  282. * M362 - SCARA calibration: Move to cal-position PsiA (0 deg calibration)
  283. * M363 - SCARA calibration: Move to cal-position PsiB (90 deg calibration - steps per degree)
  284. * M364 - SCARA calibration: Move to cal-position PSIC (90 deg to Theta calibration position)
  285. *
  286. * ************ Custom codes - This can change to suit future G-code regulations
  287. * G425 - Calibrate using a conductive object. (Requires CALIBRATION_GCODE)
  288. * M928 - Start SD logging: "M928 filename.gco". Stop with M29. (Requires SDSUPPORT)
  289. * M993 - Backup SPI Flash to SD
  290. * M994 - Load a Backup from SD to SPI Flash
  291. * M995 - Touch screen calibration for TFT display
  292. * M997 - Perform in-application firmware update
  293. * M999 - Restart after being stopped by error
  294. * D... - Custom Development G-code. Add hooks to 'gcode_D.cpp' for developers to test features. (Requires MARLIN_DEV_MODE)
  295. *
  296. * "T" Codes
  297. *
  298. * T0-T3 - Select an extruder (tool) by index: "T<n> F<units/min>"
  299. */
  300. #include "../inc/MarlinConfig.h"
  301. #include "parser.h"
  302. #if ENABLED(I2C_POSITION_ENCODERS)
  303. #include "../feature/encoder_i2c.h"
  304. #endif
  305. #if IS_SCARA || defined(G0_FEEDRATE)
  306. #define HAS_FAST_MOVES 1
  307. #endif
  308. enum AxisRelative : uint8_t { REL_X, REL_Y, REL_Z, REL_E, E_MODE_ABS, E_MODE_REL };
  309. extern const char G28_STR[];
  310. class GcodeSuite {
  311. public:
  312. static uint8_t axis_relative;
  313. static inline bool axis_is_relative(const AxisEnum a) {
  314. if (a == E_AXIS) {
  315. if (TEST(axis_relative, E_MODE_REL)) return true;
  316. if (TEST(axis_relative, E_MODE_ABS)) return false;
  317. }
  318. return TEST(axis_relative, a);
  319. }
  320. static inline void set_relative_mode(const bool rel) {
  321. axis_relative = rel ? _BV(REL_X) | _BV(REL_Y) | _BV(REL_Z) | _BV(REL_E) : 0;
  322. }
  323. static inline void set_e_relative() {
  324. CBI(axis_relative, E_MODE_ABS);
  325. SBI(axis_relative, E_MODE_REL);
  326. }
  327. static inline void set_e_absolute() {
  328. CBI(axis_relative, E_MODE_REL);
  329. SBI(axis_relative, E_MODE_ABS);
  330. }
  331. #if ENABLED(CNC_WORKSPACE_PLANES)
  332. /**
  333. * Workspace planes only apply to G2/G3 moves
  334. * (and "canned cycles" - not a current feature)
  335. */
  336. enum WorkspacePlane : char { PLANE_XY, PLANE_ZX, PLANE_YZ };
  337. static WorkspacePlane workspace_plane;
  338. #endif
  339. #define MAX_COORDINATE_SYSTEMS 9
  340. #if ENABLED(CNC_COORDINATE_SYSTEMS)
  341. static int8_t active_coordinate_system;
  342. static xyz_pos_t coordinate_system[MAX_COORDINATE_SYSTEMS];
  343. static bool select_coordinate_system(const int8_t _new);
  344. #endif
  345. static millis_t previous_move_ms, max_inactive_time, stepper_inactive_time;
  346. FORCE_INLINE static void reset_stepper_timeout(const millis_t ms=millis()) { previous_move_ms = ms; }
  347. FORCE_INLINE static bool stepper_max_timed_out(const millis_t ms=millis()) {
  348. return max_inactive_time && ELAPSED(ms, previous_move_ms + max_inactive_time);
  349. }
  350. FORCE_INLINE static bool stepper_inactive_timeout(const millis_t ms=millis()) {
  351. return ELAPSED(ms, previous_move_ms + stepper_inactive_time);
  352. }
  353. static int8_t get_target_extruder_from_command();
  354. static int8_t get_target_e_stepper_from_command();
  355. static void get_destination_from_command();
  356. static void process_parsed_command(const bool no_ok=false);
  357. static void process_next_command();
  358. // Execute G-code in-place, preserving current G-code parameters
  359. static void process_subcommands_now_P(PGM_P pgcode);
  360. static void process_subcommands_now(char * gcode);
  361. static inline void home_all_axes(const bool keep_leveling=false) {
  362. process_subcommands_now_P(keep_leveling ? G28_STR : TERN(G28_L0_ENSURES_LEVELING_OFF, PSTR("G28L0"), G28_STR));
  363. }
  364. #if EITHER(HAS_AUTO_REPORTING, HOST_KEEPALIVE_FEATURE)
  365. static bool autoreport_paused;
  366. static inline bool set_autoreport_paused(const bool p) {
  367. const bool was = autoreport_paused;
  368. autoreport_paused = p;
  369. return was;
  370. }
  371. #else
  372. static constexpr bool autoreport_paused = false;
  373. static inline bool set_autoreport_paused(const bool) { return false; }
  374. #endif
  375. #if ENABLED(HOST_KEEPALIVE_FEATURE)
  376. /**
  377. * States for managing Marlin and host communication
  378. * Marlin sends messages if blocked or busy
  379. */
  380. enum MarlinBusyState : char {
  381. NOT_BUSY, // Not in a handler
  382. IN_HANDLER, // Processing a GCode
  383. IN_PROCESS, // Known to be blocking command input (as in G29)
  384. PAUSED_FOR_USER, // Blocking pending any input
  385. PAUSED_FOR_INPUT // Blocking pending text input (concept)
  386. };
  387. static MarlinBusyState busy_state;
  388. static uint8_t host_keepalive_interval;
  389. static void host_keepalive();
  390. #define KEEPALIVE_STATE(N) REMEMBER(_KA_, gcode.busy_state, gcode.N)
  391. #else
  392. #define KEEPALIVE_STATE(N) NOOP
  393. #endif
  394. static void dwell(millis_t time);
  395. private:
  396. TERN_(MARLIN_DEV_MODE, static void D(const int16_t dcode));
  397. static void G0_G1(TERN_(HAS_FAST_MOVES, const bool fast_move=false));
  398. TERN_(ARC_SUPPORT, static void G2_G3(const bool clockwise));
  399. static void G4();
  400. TERN_(BEZIER_CURVE_SUPPORT, static void G5());
  401. TERN_(DIRECT_STEPPING, static void G6());
  402. #if ENABLED(FWRETRACT)
  403. static void G10();
  404. static void G11();
  405. #endif
  406. TERN_(NOZZLE_CLEAN_FEATURE, static void G12());
  407. #if ENABLED(CNC_WORKSPACE_PLANES)
  408. static void G17();
  409. static void G18();
  410. static void G19();
  411. #endif
  412. #if ENABLED(INCH_MODE_SUPPORT)
  413. static void G20();
  414. static void G21();
  415. #endif
  416. TERN_(G26_MESH_VALIDATION, static void G26());
  417. TERN_(NOZZLE_PARK_FEATURE, static void G27());
  418. static void G28();
  419. #if HAS_LEVELING
  420. #if ENABLED(G29_RETRY_AND_RECOVER)
  421. static void event_probe_failure();
  422. static void event_probe_recover();
  423. static void G29_with_retry();
  424. #define G29_TYPE bool
  425. #else
  426. #define G29_TYPE void
  427. #endif
  428. static G29_TYPE G29();
  429. #endif
  430. #if HAS_BED_PROBE
  431. static void G30();
  432. #if ENABLED(Z_PROBE_SLED)
  433. static void G31();
  434. static void G32();
  435. #endif
  436. #endif
  437. TERN_(DELTA_AUTO_CALIBRATION, static void G33());
  438. #if ANY(Z_MULTI_ENDSTOPS, Z_STEPPER_AUTO_ALIGN, MECHANICAL_GANTRY_CALIBRATION)
  439. static void G34();
  440. #endif
  441. TERN_(Z_STEPPER_AUTO_ALIGN, static void M422());
  442. TERN_(ASSISTED_TRAMMING, static void G35());
  443. TERN_(G38_PROBE_TARGET, static void G38(const int8_t subcode));
  444. TERN_(HAS_MESH, static void G42());
  445. #if ENABLED(CNC_COORDINATE_SYSTEMS)
  446. static void G53();
  447. static void G54();
  448. static void G55();
  449. static void G56();
  450. static void G57();
  451. static void G58();
  452. static void G59();
  453. #endif
  454. TERN_(PROBE_TEMP_COMPENSATION, static void G76());
  455. #if SAVED_POSITIONS
  456. static void G60();
  457. static void G61();
  458. #endif
  459. TERN_(GCODE_MOTION_MODES, static void G80());
  460. static void G92();
  461. TERN_(CALIBRATION_GCODE, static void G425());
  462. TERN_(HAS_RESUME_CONTINUE, static void M0_M1());
  463. #if HAS_CUTTER
  464. static void M3_M4(const bool is_M4);
  465. static void M5();
  466. #endif
  467. #if ENABLED(COOLANT_CONTROL)
  468. TERN_(COOLANT_MIST, static void M7());
  469. TERN_(COOLANT_FLOOD, static void M8());
  470. static void M9();
  471. #endif
  472. TERN_(EXTERNAL_CLOSED_LOOP_CONTROLLER, static void M12());
  473. TERN_(EXPECTED_PRINTER_CHECK, static void M16());
  474. static void M17();
  475. static void M18_M84();
  476. #if ENABLED(SDSUPPORT)
  477. static void M20();
  478. static void M21();
  479. static void M22();
  480. static void M23();
  481. static void M24();
  482. static void M25();
  483. static void M26();
  484. static void M27();
  485. static void M28();
  486. static void M29();
  487. static void M30();
  488. #endif
  489. static void M31();
  490. #if ENABLED(SDSUPPORT)
  491. TERN_(HAS_MEDIA_SUBCALLS, static void M32());
  492. TERN_(LONG_FILENAME_HOST_SUPPORT, static void M33());
  493. #if BOTH(SDCARD_SORT_ALPHA, SDSORT_GCODE)
  494. static void M34();
  495. #endif
  496. #endif
  497. TERN_(DIRECT_PIN_CONTROL, static void M42());
  498. TERN_(PINS_DEBUGGING, static void M43());
  499. TERN_(Z_MIN_PROBE_REPEATABILITY_TEST, static void M48());
  500. TERN_(LCD_SET_PROGRESS_MANUALLY, static void M73());
  501. static void M75();
  502. static void M76();
  503. static void M77();
  504. TERN_(PRINTCOUNTER, static void M78());
  505. TERN_(PSU_CONTROL, static void M80());
  506. static void M81();
  507. static void M82();
  508. static void M83();
  509. static void M85();
  510. static void M92();
  511. TERN_(M100_FREE_MEMORY_WATCHER, static void M100());
  512. #if EXTRUDERS
  513. static void M104();
  514. static void M109();
  515. #endif
  516. static void M105();
  517. #if HAS_FAN
  518. static void M106();
  519. static void M107();
  520. #endif
  521. #if DISABLED(EMERGENCY_PARSER)
  522. static void M108();
  523. static void M112();
  524. static void M410();
  525. TERN_(HOST_PROMPT_SUPPORT, static void M876());
  526. #endif
  527. static void M110();
  528. static void M111();
  529. TERN_(HOST_KEEPALIVE_FEATURE, static void M113());
  530. static void M114();
  531. static void M115();
  532. static void M117();
  533. static void M118();
  534. static void M119();
  535. static void M120();
  536. static void M121();
  537. TERN_(PARK_HEAD_ON_PAUSE, static void M125());
  538. #if ENABLED(BARICUDA)
  539. #if HAS_HEATER_1
  540. static void M126();
  541. static void M127();
  542. #endif
  543. #if HAS_HEATER_2
  544. static void M128();
  545. static void M129();
  546. #endif
  547. #endif
  548. #if HAS_HEATED_BED
  549. static void M140();
  550. static void M190();
  551. #endif
  552. #if HAS_HEATED_CHAMBER
  553. static void M141();
  554. static void M191();
  555. #endif
  556. #if HAS_COOLER
  557. static void M143();
  558. static void M193();
  559. #endif
  560. #if PREHEAT_COUNT
  561. static void M145();
  562. #endif
  563. TERN_(TEMPERATURE_UNITS_SUPPORT, static void M149());
  564. TERN_(HAS_COLOR_LEDS, static void M150());
  565. #if BOTH(AUTO_REPORT_TEMPERATURES, HAS_TEMP_SENSOR)
  566. static void M155();
  567. #endif
  568. #if ENABLED(MIXING_EXTRUDER)
  569. static void M163();
  570. static void M164();
  571. TERN_(DIRECT_MIXING_IN_G1, static void M165());
  572. TERN_(GRADIENT_MIX, static void M166());
  573. #endif
  574. static void M200();
  575. static void M201();
  576. #if 0
  577. static void M202(); // Not used for Sprinter/grbl gen6
  578. #endif
  579. static void M203();
  580. static void M204();
  581. static void M205();
  582. TERN_(HAS_M206_COMMAND, static void M206());
  583. #if ENABLED(FWRETRACT)
  584. static void M207();
  585. static void M208();
  586. TERN_(FWRETRACT_AUTORETRACT, static void M209());
  587. #endif
  588. static void M211();
  589. TERN_(HAS_MULTI_EXTRUDER, static void M217());
  590. TERN_(HAS_HOTEND_OFFSET, static void M218());
  591. static void M220();
  592. #if EXTRUDERS
  593. static void M221();
  594. #endif
  595. TERN_(DIRECT_PIN_CONTROL, static void M226());
  596. TERN_(PHOTO_GCODE, static void M240());
  597. TERN_(HAS_LCD_CONTRAST, static void M250());
  598. #if ENABLED(EXPERIMENTAL_I2CBUS)
  599. static void M260();
  600. static void M261();
  601. #endif
  602. #if HAS_SERVOS
  603. static void M280();
  604. TERN_(EDITABLE_SERVO_ANGLES, static void M281());
  605. #endif
  606. TERN_(BABYSTEPPING, static void M290());
  607. TERN_(HAS_BUZZER, static void M300());
  608. TERN_(PIDTEMP, static void M301());
  609. TERN_(PREVENT_COLD_EXTRUSION, static void M302());
  610. TERN_(HAS_PID_HEATING, static void M303());
  611. TERN_(PIDTEMPBED, static void M304());
  612. TERN_(HAS_USER_THERMISTORS, static void M305());
  613. TERN_(PIDTEMPCHAMBER, static void M309());
  614. #if HAS_MICROSTEPS
  615. static void M350();
  616. static void M351();
  617. #endif
  618. TERN_(CASE_LIGHT_ENABLE, static void M355());
  619. TERN_(REPETIER_GCODE_M360, static void M360());
  620. #if ENABLED(MORGAN_SCARA)
  621. static bool M360();
  622. static bool M361();
  623. static bool M362();
  624. static bool M363();
  625. static bool M364();
  626. #endif
  627. #if EITHER(EXT_SOLENOID, MANUAL_SOLENOID_CONTROL)
  628. static void M380();
  629. static void M381();
  630. #endif
  631. static void M400();
  632. #if HAS_BED_PROBE
  633. static void M401();
  634. static void M402();
  635. #endif
  636. TERN_(HAS_PRUSA_MMU2, static void M403());
  637. #if ENABLED(FILAMENT_WIDTH_SENSOR)
  638. static void M404();
  639. static void M405();
  640. static void M406();
  641. static void M407();
  642. #endif
  643. TERN_(HAS_FILAMENT_SENSOR, static void M412());
  644. TERN_(HAS_MULTI_LANGUAGE, static void M414());
  645. #if HAS_LEVELING
  646. static void M420();
  647. static void M421();
  648. #endif
  649. TERN_(BACKLASH_GCODE, static void M425());
  650. TERN_(HAS_M206_COMMAND, static void M428());
  651. TERN_(HAS_POWER_MONITOR, static void M430());
  652. TERN_(CANCEL_OBJECTS, static void M486());
  653. static void M500();
  654. static void M501();
  655. static void M502();
  656. #if DISABLED(DISABLE_M503)
  657. static void M503();
  658. #endif
  659. TERN_(EEPROM_SETTINGS, static void M504());
  660. #if ENABLED(PASSWORD_FEATURE)
  661. static void M510();
  662. TERN_(PASSWORD_UNLOCK_GCODE, static void M511());
  663. TERN_(PASSWORD_CHANGE_GCODE, static void M512());
  664. #endif
  665. TERN_(SDSUPPORT, static void M524());
  666. TERN_(SD_ABORT_ON_ENDSTOP_HIT, static void M540());
  667. #if HAS_ETHERNET
  668. static void M552();
  669. static void M553();
  670. static void M554();
  671. #endif
  672. TERN_(BAUD_RATE_GCODE, static void M575());
  673. #if ENABLED(ADVANCED_PAUSE_FEATURE)
  674. static void M600();
  675. static void M603();
  676. #endif
  677. TERN_(HAS_DUPLICATION_MODE, static void M605());
  678. TERN_(IS_KINEMATIC, static void M665());
  679. #if ENABLED(DELTA) || HAS_EXTRA_ENDSTOPS
  680. static void M666();
  681. #endif
  682. #if ENABLED(DUET_SMART_EFFECTOR) && PIN_EXISTS(SMART_EFFECTOR_MOD)
  683. static void M672();
  684. #endif
  685. #if ENABLED(FILAMENT_LOAD_UNLOAD_GCODES)
  686. static void M701();
  687. static void M702();
  688. #endif
  689. TERN_(GCODE_REPEAT_MARKERS, static void M808());
  690. TERN_(GCODE_MACROS, static void M810_819());
  691. TERN_(HAS_BED_PROBE, static void M851());
  692. TERN_(SKEW_CORRECTION_GCODE, static void M852());
  693. #if ENABLED(I2C_POSITION_ENCODERS)
  694. FORCE_INLINE static void M860() { I2CPEM.M860(); }
  695. FORCE_INLINE static void M861() { I2CPEM.M861(); }
  696. FORCE_INLINE static void M862() { I2CPEM.M862(); }
  697. FORCE_INLINE static void M863() { I2CPEM.M863(); }
  698. FORCE_INLINE static void M864() { I2CPEM.M864(); }
  699. FORCE_INLINE static void M865() { I2CPEM.M865(); }
  700. FORCE_INLINE static void M866() { I2CPEM.M866(); }
  701. FORCE_INLINE static void M867() { I2CPEM.M867(); }
  702. FORCE_INLINE static void M868() { I2CPEM.M868(); }
  703. FORCE_INLINE static void M869() { I2CPEM.M869(); }
  704. #endif
  705. #if ENABLED(PROBE_TEMP_COMPENSATION)
  706. static void M192();
  707. static void M871();
  708. #endif
  709. TERN_(LIN_ADVANCE, static void M900());
  710. #if HAS_TRINAMIC_CONFIG
  711. static void M122();
  712. static void M906();
  713. TERN_(HAS_STEALTHCHOP, static void M569());
  714. #if ENABLED(MONITOR_DRIVER_STATUS)
  715. static void M911();
  716. static void M912();
  717. #endif
  718. TERN_(HYBRID_THRESHOLD, static void M913());
  719. TERN_(USE_SENSORLESS, static void M914());
  720. #endif
  721. #if HAS_L64XX
  722. static void M122();
  723. static void M906();
  724. static void M916();
  725. static void M917();
  726. static void M918();
  727. #endif
  728. #if ANY(HAS_MOTOR_CURRENT_SPI, HAS_MOTOR_CURRENT_PWM, HAS_MOTOR_CURRENT_I2C, HAS_MOTOR_CURRENT_DAC)
  729. static void M907();
  730. #if EITHER(HAS_MOTOR_CURRENT_SPI, HAS_MOTOR_CURRENT_DAC)
  731. static void M908();
  732. #if ENABLED(HAS_MOTOR_CURRENT_DAC)
  733. static void M909();
  734. static void M910();
  735. #endif
  736. #endif
  737. #endif
  738. TERN_(SDSUPPORT, static void M928());
  739. TERN_(MAGNETIC_PARKING_EXTRUDER, static void M951());
  740. TERN_(TOUCH_SCREEN_CALIBRATION, static void M995());
  741. #if BOTH(HAS_SPI_FLASH, SDSUPPORT)
  742. static void M993();
  743. static void M994();
  744. #endif
  745. TERN_(PLATFORM_M997_SUPPORT, static void M997());
  746. static void M999();
  747. #if ENABLED(POWER_LOSS_RECOVERY)
  748. static void M413();
  749. static void M1000();
  750. #endif
  751. TERN_(SDSUPPORT, static void M1001());
  752. TERN_(MAX7219_GCODE, static void M7219());
  753. TERN_(CONTROLLER_FAN_EDITABLE, static void M710());
  754. static void T(const int8_t tool_index);
  755. };
  756. extern GcodeSuite gcode;