Difference between revisions of "Gcode"

From Hyrel3D
Jump to navigation Jump to search
 
(153 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:HowTo]]
{| align="right"
| __TOC__
|}


== What is GCode? ==


'''Everything your Hyrel 3D Printer does is done by executing GCode''', whether you are aware of it or not. While most of it is specified in your gcode file, some of it is sent to the printer before the file is executed; this includes setting flow rates, prime/unprime (advance/retract) settings, and default speeds.
__NOTOC__


Please note that there are many flavors of gcode, and while most have the same (or very similar) G0-G100 and M0-M100, codes above 100 are largely nonstandard.
{| border="1" class="wikitable" style="float:right"
! Main Sections
|-
| [[#What_is_GCode.3F | What is GCode?]]
|-
| [[#Understanding_the_T | Understanding the T]]
|-
| [[#Most_Commonly_Edited_Gcodes | Most Commonly Edited GCodes]]
|-
| [[#Controlling_Movement | Controlling Movement]]
|-
| [[#Controlling_Temperature | Controlling Temperature]]
|-
| [[#Controlling_Material_Flow | Controlling Material Flow]]
|-
| [[#Controlling_Position_and_Offsets | Controlling Position and Offsets]]
|-
| [[#Controlling_Lasers_and_UV_Pens | Controlling Lasers and UV Pens]]
|-
| [[#Controlling_Spindles_and_Lathes | Controlling Spindles and Lathes]]
|-
| [[#Reporting_and_Diagnostics | Reporting and Diagnostics]]
|-
| [[#Controlling_Aux_Devices | Controlling Aux Devices]]
|-
| [[#Other_Commands| Other Commands]]
|-
| [[#Gcode_Header| Gcode Headers]]
|-
| [[#Gcode_Footer| Gcode Footer]]
|-
|}


''It is important to remember that different variable letters can have different meanings, depending on the G- or M- code being used'' - '''''especially the T value.'''''
Note: Codes in Black are supported on version 4 and above (v4+), and most likely on version 3 as well.


At the bottom of the page is a '''[[#Chart_of_Codes|chart]]''' with all these codes ordered numerically.
<span style="color:darkorange;">Note: Codes in Orange are supported on version 5 and above (v5+) only.


Below, I will explain those gcodes about which we get the most questions.
Note that Repetrel versions prior to 4.2 can not properly process gcode with "tab" characters - tab was a reserved character.


== '''Understanding the T''' ==
== What is GCode? ==


The use of T commands and variables changes greatly (for the better) with the jump to version 5 from the previous versions.
'''Everything your Hyrel 3D Printer does is done by executing GCode''', whether you are aware of it or not.  


Please see '''[[T_v4]]''' for the old way (v4 and earlier), where the nomenclature for '''T Commands''' and the '''T Variables''' were not the same.
Every button you press on the screen sends a gcode to the printer.


Please see '''[[T_v5]]''' for the new way (v5 and later), where the nomenclature for '''T Commands''' and the '''T Variables''' are the same.
When you start a job (by pressing "Print"), the settings from your head are sent to the printer (including flow and prime/unprime values); then the gcode file is sent, line by line, to the printer.


We will use a '''T#''' in the descriptions below to avoid confusion; please find the correct designation for your version by following the links above.
All parameters are persistent, so once they are set, they will remain in place unless or until you (or the file) sends a new, updated value (including setting to 0).


'''[[#What_is_GCode.3F|Back to top]]'''
Please note that there are many flavors of gcode, and while most have the same (or very similar) G0-G100 and M0-M100, codes above 100 are largely nonstandard.


== '''Controlling Movement''' ==
''It is important to remember that different variable letters can have different meanings, depending on the G- or M- code being used'' - '''''especially the T value.'''''


=== G0 Rapid Move ===
The Table of Contents to the right lists the main categories of Gcodes.


G0 is a rapid positioning move. It is not a ''working'' move, meaning that your equipment will not be printing, milling, lasering, or doing any other active work during a G0 move. G0 is intended to move your tool to a new position, where the work will happen. Accordingly, G0 movement speeds are set in your configuration settings, rather than being specified in your gcode file.
Below is a table listing them in numerical order (click '''Expand''' to expand):


Special note: a G0 command will take an F variable as a nonpersistent, one-time velocity setting.
{| border="1" class="wikitable mw-collapsible mw-collapsed"
 
|+ Code_Chart
'''Usage'''
! Code
  G0 Xn Yn Zn An Bn Fn
! Supported
 
! Brief Description
'''Parameters'''
|-
 
! [[#G0_Rapid_Move|G0]]
  '''Xn''' is the new X position to move to
| Yes || Rapid Move
  '''Yn''' is the new Y position to move to
|-
  '''Zn''' is the new Z position to move to
! [[#G1_Working_Move|G1]]
  '''An''' is the new A position to move to
| Yes || Working Move
  '''Bn''' is the new B position to move to
|-
  '''Fn''' is the feed rate or travel speed to use. Only on '''G0''' is it not persistent
! [[#G2_Clockwise_Arc|G2]]
 
| Yes || Clockwise Arc
''Any values not stipulated remain unchanged.''
|-
 
! [[#G2.1_Spiral_CW_Arc1|G2.1]]
Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on '''G90''' absolute positioning or '''G91''' relative positioning. Absolute is the default and should be used in the majority of cases.
| Yes || Spiral CW Arc<sup>1</sup>
 
|-
Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.
! [[#G2.2_Spiral_CW_Arc2|G2.2]]
 
| Yes || Spiral CW Arc<sup>2</sup>
'''Example'''
|-
 
! [[#G2.3_3-Space_CW_Arc|G2.3]]
  G0 X50 Y75 Z10
| Yes || 3-Space CW Spiral Arc
 
|-
This command is decoded and executed by the printer as follows:
! [[#G3_Counterclockwise_Arc|G3]]
 
| Yes || Counterclockwise Arc
* '''G0''' (rapid (nonprinting) straight line move from the current location to)
|-
** '''X50''' (50mm in the X)
! [[#G3.1_Spiral_CCW_Arc1</sup>|G3.1]]
** '''Y75''' (75mm in the Y)
| Yes || Spiral CCW Arc<sup>1</sup>
** '''Z10''' (10mm in the Z)
|-
** (no change in A)
! [[#G3.2_Spiral_CCW_Arc2|G3.2]]
** (no change in B)
| Yes || Spiral CCW Arc<sup>2</sup>
** (no change in F, use settings-specified feed rate)
|-
<br>
! [[#G3.3_3-Space_CCW_Arc|G3.3]]
<hr>
| Yes || 3-Space CCW Spiral Arc
 
|-
=== G1 Working Move ===
! [[#G4_Timed_Pause|G4]]  
 
| Yes || Timed Pause
G1 is a working move, during which you may be printing, milling, lasering, or doing other active work - provided an E (extrude) value is given. In native mode (if you don't add '''M229 E1 Dn''', the value of Extrusion rate E will be ignored, but E will trigger a working or printing move. In E-value mode (by adding '''M229 E1 Dn''', the slicer-determined E value will be used to control material flow. G1 moves are made at the rate indicated by the F (feed rate) value; if no F value is specified, the last F value set will be used. See '''[[#M229_Use_E_Values|M229]]''' for more details.
|-
 
! [[#G10_UNUSED|G10]]
'''Usage'''
| ''No'' || ''Absolute E''
  G1 Xn Yn Zn An Bn Fn Sn
|-
 
! [[#G11_UNUSED|G11]]
'''Parameters'''
| ''No'' || ''Relative E''
 
|-
  '''Xn''' is the new X position to move to
! [[#G16_Arc_Plane:_Any|G16]]
  '''Yn''' is the new Y position to move to
| Yes || Arc in Any Plane
  '''Zn''' is the new Z position to move to
|-
  '''An''' is the new A position to move to
! [[#G17_Arc_Plane:_XY|G17]]
  '''Bn''' is the new B position to move to
| Yes || Arc in XY Plane
  '''Hn''' is the stored head offset to apply (see '''M660''' to store offsets)
|-
  '''Fn''' is the feed rate or travel speed to use. Only on '''G0''' is it not persistent
! [[#G18_Arc_Plane:_XZ|G18]]
  '''Sn''' is a one-time (non-persistent) material flow rate multiplier (rarely used) applied to this move only
| Yes || Arc in XZ Plane
 
|-
''Any values not stipulated remain unchanged.''
! [[#G19_Arc_Plane:_YZ|G19]]
 
| Yes || Arc in YZ Plane
Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on '''G90''' absolute positioning or '''G91''' relative positioning. Absolute is the default and should be used in the majority of cases; there will be problems with an entire model sliced in relative mode. Relative is intended for special operations like drilling holes.
|-
 
! [[#G20_Set_Units_to_Inches|G20]]
Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.
| Yes || Set Units to Inches
 
|-
'''Example'''
! [[#G21_Set_Units_to_Milimeters|G21]]
 
| Yes || Set Units to Milimeters
  G1 X50 Y75 E1 F1800 H2
|-
 
! [[#G28_Send_X,_Y_to_Physical_Home|G28]]
This command is decoded and executed by the printer as follows:
| Yes || Send X, Y to Physical Home
 
|-
* '''G1''' (working speed straight line move from the current location to)
! [[#G53_Clear_Offsets|G53]]
** '''X50''' (50mm in the X)
| Yes || Clear Offsets
** '''Y75''' (75mm in the Y)
|-
** (no change in A)
! [[#G54_-_G59_-_Set_Offsets|G54-59]]
** (no change in B)
| Yes || Set Offsets
** '''E1''' (while extruding)
|-
** '''F1800''' (moving at 1800mm/min)
! [[#G81_Peck_Drilling|G81]]
** '''H2''' (invoking offsets stored in register H2)
| Yes || Peck Drilling
** (no temporary scaling)
|-
 
! [[#G90_Absolute_Positioning|G90]]
<br>
| Yes || Absolute Positioning
<hr>
|-
 
! [[#G91_Relatative_Positioning|G91]]
=== G2 Clockwise Arc ===
| Yes || Relatative Positioning
 
|-
A G2 move specifies a clockwise arc (or complete circle) from the current position to position (X,Y,Z)<sub>curr</sub> by following an arc about the center point (X<sub>curr</sub>+I, Y<sub>curr</sub>+J).
! [[#G92_Reset_Coordinate_Offsets|G92]]
 
| Yes || Reset Coordinates
'''Usage'''
|-
 
! [[#G93_Clear_Coordinate_Offsets|G93]]
  G2 Xn Yn Zn In Jn Fn En Sn
| Yes || Reset Coordinates
 
|-
'''Parameters'''
! [[#M0_Stop_Until_Resume|M0]]
 
| Yes || Stop Until Resume
  '''Xn''' is the new X position to move to
|-
  '''Yn''' is the new Y position to move to
! [[#M3_Turn_On_Spindle_.28CW.29|M3]]
  '''Zn''' is the new Z position to end at (optional and usually not stipulated)
| Yes || Spindle On CW
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
|-
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
! [[#M4_Turn_On_Spindle_.28CCW.29R|M4]]
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
| Yes || Spindle On CCW
  '''En''' indicates a working or printing move
|-
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
! [[#M5_Turn_Off_Spindle|M5]]
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
| Yes || Spindle Off
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
|-
 
! [[#M6_Declare_Head_Offsets|M6]]
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.
| Yes || Declare Head Offsets
 
|-
'''Example'''
! [[#M7_Set_Power_On_Aux_1|M7]]
 
| Yes || Aux 1 On (Mist)
  G2 X50 Y75 I15 J20 E1 F1800
|-
 
! [[#M8_Set_Power_On_Aux_2|M8]]
This command is decoded and executed by the printer as follows:
| Yes || Aux 2 On (Flood)
 
|-
* '''G2''' (working speed clockwise arc/circle move from the current location to)
! [[#M9_Turn_Off_All_Aux|M9]]
** '''X50''' (50mm in the X)
| Yes || All Aux Off
** '''Y75''' (75mm in the Y)
|-
** (centered about a point located)
! [[#M17_Engage_Motors|M17]]
** '''I15''' (15mm further in the X)
| Yes || Engage Motors
** '''J20''' (20mm further in the Y)
|-
** '''E1''' (while extruding)
! [[#M18_Disengage_Motors|M18]]
** '''F1800''' (moving at 1800mm/min)
| Yes || Disengage Motors
 
|-
'''Example'''
! [[#M30_End_of_Program|M30]]
 
| Yes || End of Program
  G2 X50 Y75 I15 J20 E1 S6
|-
 
! [[#M82_Absolute_E-Values|M82]]
This command is decoded and executed by the printer as follows:
| Yes || Absolute E-Values
 
|-
* '''G2''' (working speed clockwise arc/circle move from the current location to)
! [[#M83_Relative_E-Values|M83]]
** '''X50''' (50mm in the X)  
| Yes || Relative E-Values
** '''Y75''' (75mm in the Y)  
|-
** (centered about a point located)
! [[#M84_Disable_Motors|M84]]
** '''I15''' (15mm further in the X)
| Yes || Disable Motors
** '''J20''' (20mm further in the Y)
|-
** '''E1''' (while extruding)
! [[#M104_Set_Temp_.28Head.29|M104]]
** (using previously established F rate)
| Yes || Set Temp (Head)
** '''S6''' (made up of six sides - resulting in a hexagon with one point at the origin, with all corners inscribed on the circle)
|-
 
! [[#M106_Set_Cooling_.2F_Etc.|M106]]
<br>
| Yes || Set Cooling / Etc.
<hr>
|-
 
! [[#M107_Stop_Cooling_.2F_Etc.|M107]]
=== G2.1 Spiral CW Arc<sup>1</sup> ===
| Yes || Stop Cooling / Etc.
 
|-
A G2.1 makes a spiral circular move (only supports full 360 arcs, or '''Ln''' * 360). Effective ending X/Y is always the same as the current XY and is not specified (though the actual final position is a function of the number of laps, the pitch, and the reverse code. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs).  An important feature is the "reverse code" to allow the creation of frog toes without having to jump over the frog toe once it's made.
! [[#M109_Wait_for_Temp_.28Head.29|M109]]
 
| Yes || Wait for Temp (Head)
'''Usage'''
|-
 
! [[#M116 Wait for Temps (v5+)|M116]]
  G2.1 Zn In Jn Pn Ln En Sn Rn Fn
| <span style="color:darkorange;">v5+ || <span style="color:darkorange;">Pause for All Temps
 
|-
'''Parameters'''
! [[#M140_Set_Temp_.28Bed.29|M140]]
 
| Yes || Set Temp (Bed)
  '''Zn''' is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
|-
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
! [[#M141_Set_Temp_.28Chamber.29|M141]]
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
| Yes || Set Temp (Chamber)
  '''Pn''' is the pitch (how close the laps are) in mm (required)
|-
  '''Ln''' is the number of laps to complete (must be a positive integer; you don't need to finish the spiral)
! [[#M190_Wait_for_Temp_.28Bed.29|M190]]
  '''En''' indicates a working or printing move
| Yes || Wait for Temp (Bed)
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
|-
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
! [[#M191_Wait_for_Temp_.28Chamber.29|M191]]
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
| Yes || Wait for Temp (Chamber)
  '''Rn''' is a flag; 0 to spiral in (default), 1 to spiral out
|-
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
! [[#M203_Set_G0_Speed|M203]]
 
| Yes || Set G0 Speed
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.
|-
 
! [[#M221_Set_Flow_Rate|M221]]
'''Example 1'''
| Yes || Set Flow Rate
 
|-
  G2.1 I15 J20 P1.2 E1
! [[#M229_Use_E_Values|M229]]
 
| Yes || Use E Values
This command is decoded and executed by the printer as follows:
|-
 
! [[#M253_Turn_On_Lathe_.28CW.29|M253]]
* '''G2.1''' (working speed clockwise spiral move from the current location)
| Yes || Turn On Lathe (CW)
** (no change in Z)
|-
** (centered about a point located)  
! [[#M254_Turn_On_Lathe_.28CCW.29|M254]]
** '''I15''' (15mm further in the X)  
| Yes || Turn On Lathe (CCW)
** '''J20''' (20mm further in the Y)
|-
** (complete all laps)
! [[#M255_Turn_Off_Lathe|M255]]
** '''P1.2''' (1.2 mm between centers of travel of adjacent laps)
| Yes || Turn Off Lathe
** '''E1''' (while extruding)
|-
** (use default S of 0.33333 mm segments)
! [[#M619_Map_Aux_Port|M619]]
** (use default R of 0, spiral in toward center from current location)
| Yes || Map Aux Port
** (moving at established G1 F speed)
|-
 
! [[#M620_Enable_Device|M620]]
'''Example 2'''
| Yes || Enable Device
 
|-
  G2.1 Z10 I15 J20 P0.5 L50 E1 S9 R1 F1200
! [[#M621_Set_Laser_Power|M621]]
 
| Yes || Set Laser Power
This command is decoded and executed by the printer as follows:
|-
 
! [[#M623_Duration_Emit|M623]]
* '''G2.1''' (working speed clockwise spiral move from the current location)
| Yes || Duration Emit
** '''Z10''' (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
|-
** (centered about a point located)
! [[#M660_Assign_Tool_Height_Offset|M660]]
** '''I15''' (15mm further in the X)
| Yes || Set Tool Offsets
** '''J20''' (20mm further in the Y)
|-
** '''L50''' (complete no more than 50 laps)
! [[#M670_Activate_Y-Arm_.28Gantry.29_Lights|M670]]
** '''P0.5''' (0.5 mm between centers of travel of adjacent laps)
| Yes || Enable Y-arm (Gantry) Lights
** '''E1''' (while extruding)
|-
** '''S9''' (each 360 degrees composted of a total of 9 segments)
! [[#M671_Activate_X-Arm_.28Danger.29_Lights|M671]]
** '''R1''' (spiral out from center to current location)
| Yes || Activate X-Arm (Danger) Lights
** '''F1200''' (at a speed of 1200 mm/min)
|-
 
! [[#M672_Set_Y-arm_Light|M672]]
'''Example 3'''
| Yes || Set Y-arm Light
 
|-
  G0 X0 Y25                  ; start location for outer spiral
! [[#M674_Use_Turbo_Mode|M674]]
  G0 Z1                      ; go to print layer height
| Yes || Rapid G1 Moves
  G2.1 I25 J0 P4 L3 E1        ; spiral in 3 laps, 4mm pitch
|-
  G1 X14 E1                  ; add connector for the arcs
! [[#M675_Activate_Response_LEDs|M675]]
  G2.1 I11 J0 P4 L3 E1 R2    ; spiral out 3 laps, 4mm pitch
| Yes || Activate Response LEDs
 
|-
This gcode generates the following:
! [[#M676_Activate_Recirc._Fan|M676]]
 
| Yes || Activate Recirc. Fan
[[File:Spiral.png|250px]]
|-
 
! [[#M677_Activate_Buzzer|M677]]
<br>
| Yes || Activate Buzzer
<hr>
|-
 
! [[#M678_Activate_Laser_X-hair|M678]]
=== G2.2 Spiral CW Arc<sup>2</sup> ===
| Yes || Activate Laser X-hair
 
|-
A G2.2 makes a spiral circular move (only supports full 360 arcs, or '''Ln''' * 360). Unlike G2.1, G2.2 specifies final X/Y (and Z) location. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs).  Unlike G2.1, G2.2 does not require a reverse code as the direction of spiral is determined by the positional relationship of the current position, final position, and center position.
! [[#M679_Activate_Vacuum|M679]]
 
| Yes || Activate Vacuum
'''Usage'''
|-
 
! [[#M684_Activate_Exhaust|M684]]
  G2.2 Xn Yn Zn In Jn Pn Ln En Sn Rn Fn
| Yes || Activate Exhaust
 
|-
'''Parameters'''
! [[#M685_Set_Power_on_Air|M685]]
 
| Yes || Activate Air
  '''Xn''' is the new X position to move to
|-
  '''Yn''' is the new Y position to move to
! [[#M689_Activate_Ext._Head|M689]]
  '''Zn''' is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
| Yes || Activate Ext. Head
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
|-
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
! [[#M701_Set_Head_Reporting|M701]]
  '''Pn''' is the pitch (how close the laps are) in mm (optional)
| Yes || Set Head Reporting
  '''Ln''' is the number of laps (or paths) to complete (you don't need to finish the spiral)
|-
    ''Note, if P and L values conflict, L will be modified to match what P will allow; at least one must be specified
! [[#M702_-_M704_Cloning_Heads|M702]]  
  '''En''' indicates a working or printing move
| Yes || Establish Clone Squad
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
|-
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
! [[#M702_-_M704_Cloning_Heads|M703]]
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
| Yes || Add to Clone Squad
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
|-
 
! [[#M702_-_M704_Cloning_Heads|M704]]
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.
| Yes || Remove from Clone Squad
|-
! [[#M718_Stop_Logging_to_File|M718]]
| Yes || Stop Logging to File
|-
! [[#M719_Start_Logging_to_File|M719]]
| Yes || Start Logging to File
|-
! [[#M721_Set_Unprime_Values|M721]]
| Yes || Set Unprime Values
|-
! [[#M722_Set_Prime_Values|M722]]
| Yes || Set Prime Values
|-
! [[#M723_Set_Manual_Flow|M723]]
| Yes || Set Manual Flow
|-
! [[#M728_Set_Motor_Current_Boost|M728]]
| Yes || Set Motor Current Boost
|-
! [[#M756_Set_Height_for_Flow|M756]]
| Yes || Set Height for Flow
|-
! [[#M772_Reset_All_Metrics|M772]]
| Yes || Reset All Metrics
|-
! [[#M773_Generate_Basic_Report|M773]]
| Yes || Generate Basic Report
|-
! [[#M783_Tie_Aux_to_Extrusion|M783]]
| Yes || Tie Aux to Extrusion
|-
! [[#M790_New_Layer_Actions|M790]]
| Yes || New Layer Actions
|-
! [[#M791_Snap_Image|M791]]
| Yes || Snap Image
|-
! [[#M792_Execute_Action|M792]]
| Yes || Execute Action
|-
|}


'''Example 1'''
=== '''Header Explained''' ===


  G2.2 I15 J20 P1 E1
Please visit [[GCode Header]] for a detailed description of our standard GCode headers.


This command is decoded and executed by the printer as follows:


* '''G2.2''' (working speed clockwise spiral move from the current location)
== '''Understanding the T''' ==
** (no change in Z)
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''P2''' (1mm between centers of travel of adjacent laps)
** (complete all laps)
** '''E1''' (while extruding)
** (use default S of 0.33333 mm segments)
** (moving at established G1 F speed)


'''Example 2'''
A '''T Command''' changes which head has the focus of the motion controller and is executing the gcode. Each of our printers have at least four tool positions.


  G2.2 Z10 I15 J20 P2 L50 E1 S9 F1200
The use of T commands and variables changes greatly (for the better) with the jump to version 5 from the previous versions.
 
Please see '''[[T_v4]]''' for the old way (v4 and earlier), where the nomenclature for '''T Commands''' and the '''T Variables''' were not the same.
 
<span style="color:darkorange;">Please see '''[[T_v5]]''' for the new way (v5 and later), where the nomenclature for '''T Commands''' and the '''T Variables''' are the same.


This command is decoded and executed by the printer as follows:
We will use a '''T#''' in the descriptions below to avoid confusion; please find the correct designation for your version by following the links above.


* '''G2.2''' (working speed clockwise spiral move from the current location)
== '''Most Commonly Edited Gcodes''' ==
** '''Z10''' (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''P2''' (2mm between centers of travel of adjacent laps)
** '''L50''' (complete no more than 50 laps)
** '''E1''' (while extruding)
** '''S9''' (each 360 degrees composted of a total of 9 segments)
** '''F1200''' (at a speed of 1200 mm/min)


'''Example 3'''
Below are the gcodes users should first become familiar with.


  G0 X0 Y25                  ; start location for outer spiral
=== Tool Changes ===
  G0 Z1                      ; go to print layer height
  G2.2 X12 I25 P4 E1          ; spiral in 3 laps, 4mm pitch
  G1 X14 E1                  ; add connector to next spiral
  G2.2 X2 I11 P4 E1          ; spiral out 3 laps, 4mm pitch


This gcode also generates the following:
'''T0''' tells the printer to perform extrusion (or emission) from the tool in the far left position<br>
'''T1''' tells the printer to perform extrusion (or emission) from the tool in the second-from-left position<br>
'''T2''' tells the printer to perform extrusion (or emission) from the tool in the third-from-left position<br>
'''T3''' tells the printer to perform extrusion (or emission) from the tool in the fourth-from-left position<br>
'''T4''' tells the printer to perform extrusion (or emission) from the tool in the fifth-from-left position (if available)


[[File:Spiral.png|250px]]
=== Movement ===


<br>
'''G0''' for "rapid", non-printing moves<br>
<hr>
'''G1''' for "working speed" moves, which may be printing (with E value) or non-printing (no E value)


=== G2.3 3-Space CW Arc ===
=== Temperature ===


A G2.3 move specifies a clockwise arc (or complete circle(s) from the current position to position (X,Y,Z)<sub>curr</sub> following a circular arc about the center point (X<sub>curr</sub>+I, Y<sub>curr</sub>+J, Z<sub>curr</sub>+K). Unlike G2, G2.1 and G2.2, G2.3 is not bound to the X/Y plane. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs). 
'''M104''' to set head temp<br>
'''Usage'''
'''M109''' to set and wait for head temp<br>
'''M140''' to set bed temp<br>
'''M190''' to set and wait for bed temp


  G2.3 Xn Yn Zn An Bn In Jn Kn Un Vn Wn Dn Pn En Sn Fn
=== Others ===


Note: If we are in G16 mode, Un, Vn, Wn define the vector normal to the work plane. If we are in G17 (X/Y plane) or G18 (X/Z plane) or G19 (Y/Z plane) mode, these are ignored.
Which commands to learn from here will depend on what the user intends to do with the equipment.


'''Parameters'''
== '''Controlling Movement''' ==


  '''Xn''' is the new X position to end at
{| border="1" class="wikitable" style="float:right"
  '''Yn''' is the new Y position to end at
! colspan="3" | Controlling Movement
  '''Zn''' is the new Z position to end at
|-
  '''An''' is the new A position to end at (4th axis)
! Code
  '''Bn''' is the new B position to end at (5th axis)
! Supported
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
! Brief Description
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
|-
  '''Kn''' is the '''''relative''''' distance from the current Z position to the center position about which to arc (default 0)
! [[#G0_Rapid_Move|G0]]
  '''Un''' is the X component of a vector normal to the working plane (default 0)
| Yes || Rapid Move
  '''Vn''' is the Y component of a vector normal to the working plane (default 0)
|-
  '''Wn''' is the Z component of a vector normal to the working plane (default 0)
! [[#G1_Working_Move|G1]]
  '''Dn''' is the overall displacement normal to the working plane for this element
| Yes || Working Move
  '''Pn''' is the pitch (how close the laps are normal to the working plane) in mm (default 0; one path, no incremental displacement)
|-
  '''En''' indicates a working or printing move
! [[#G2_Clockwise_Arc|G2]]
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
| Yes || Clockwise Arc
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
|-
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
! [[#G2.1_Spiral_CW_Arc1|G2.1]]
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
| Yes || Spiral CW Arc<sup>1</sup>
 
|-
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.
! [[#G2.2_Spiral_CW_Arc2|G2.2]]
 
| Yes || Spiral CW Arc<sup>2</sup>
<br>
|-
<hr>
! [[#G2.3_3-Space_CW_Arc|G2.3]]
| Yes || 3-Space CW Spiral Arc
|-
! [[#G3_Counterclockwise_Arc|G3]]
| Yes || Counterclockwise Arc
|-
! [[#G3.1_Spiral_CCW_Arc1</sup>|G3.1]]
| Yes || Spiral CCW Arc<sup>1</sup>
|-
! [[#G3.2_Spiral_CCW_Arc2|G3.2]]
| Yes || Spiral CCW Arc<sup>2</sup>
|-
! [[#G3.3_3-Space_CCW_Arc|G3.3]]
| Yes || 3-Space CCW Spiral Arc
|-
! [[#G4_Timed_Pause|G4]]
| Yes || Timed Pause
|-
! [[#G16_Arc_Plane:_Any|G16]]
| Yes || Arc in Any Plane
|-
! [[#G17_Arc_Plane:_XY|G17]]
| Yes || Arc in XY Plane
|-
! [[#G18_Arc_Plane:_XZ|G18]]
| Yes || Arc in XZ Plane
|-
! [[#G19_Arc_Plane:_YZ|G19]]
| Yes || Arc in YZ Plane
|-
! [[#M0_Stop_Until_Resume|M0]]
| Yes || Stop Until Resume
|-
! [[#M203_Set_G0_Speed|M203]]
| Yes || Set G0 Speed
|-
! [[#M674_Use_Turbo_Mode|M674]]
| Yes || Rapid G1 Moves
|-
|}


=== G3 Counterclockwise Arc ===
=== G0 Rapid Move ===


Please refer to G2, above, for details. All options are identical, with the exception of direction (counterclockwise).
G0 is a rapid positioning move. It is not a ''working'' move, meaning that your equipment will not be printing, milling, lasering, or doing any other active work during a G0 move. G0 is intended to move your tool to a new position, where the work will happen. Accordingly, G0 movement speeds are set in your configuration settings, rather than being specified in your gcode file.  


<br>
Special note: a G0 command will take an F variable as a nonpersistent, one-time velocity setting.
<hr>
 
'''Usage'''
  G0 Xn Yn Zn An Bn Fn


=== G3.1 Spiral CCW Arc<sup>1</sup> ===
'''Parameters'''


Please refer to G2.1, above, for details. All options are identical, with the exception of direction (counterclockwise).
  '''Xn''' is the new X position to move to
  '''Yn''' is the new Y position to move to
  '''Zn''' is the new Z position to move to
  '''An''' is the new A position to move to
  '''Bn''' is the new B position to move to
  '''Fn''' is the feed rate or travel speed to use. Only on '''G0''' is it not persistent


<br>
''Any values not stipulated remain unchanged.''
<hr>


=== G3.2 Spiral CCW Arc<sup>2</sup> ===
Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on '''G90''' absolute positioning or '''G91''' relative positioning. Absolute is the default and should be used in the majority of cases.


Please refer to G2.2, above, for details. All options are identical, with the exception of direction (counterclockwise).
Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.


<br>
'''Example'''
<hr>


=== G3.3 3-Space CCW Arc ===
  G0 X50 Y75 Z10


Please refer to G2.3, above, for details. All options are identical, with the exception of direction (counterclockwise).
This command is decoded and executed by the printer as follows:


* '''G0''' (rapid (nonprinting) straight line move from the current location to)
** '''X50''' (50mm in the X)
** '''Y75''' (75mm in the Y)
** '''Z10''' (10mm in the Z)
** (no change in A)
** (no change in B)
** (no change in F, use settings-specified feed rate)
<br>
<br>
<hr>
<hr>


=== G4 Timed Pause ===
=== G1 Working Move ===


G4 is a pause for a set number of seconds (S) or milliseconds (P).  
G1 is a working move, during which you may be printing, milling, lasering, or doing other active work - provided an E (extrude) value is given. In native mode (if you don't add '''M229 E1 Dn''', the value of Extrusion rate E will be ignored, but E will trigger a working or printing move. In E-value mode (by adding '''M229 E1 Dn''', the slicer-determined E value will be used to control material flow. G1 moves are made at the rate indicated by the F (feed rate) value; if no F value is specified, the last F value set will be used. See '''[[#M229_Use_E_Values|M229]]''' for more details.


'''Usage'''
'''Usage'''
  G1 Xn Yn Zn An Bn Fn Sn


  G4 Sn Pn
'''Parameters'''


'''Parameters'''
  '''Xn''' is the new X position to move to
  '''Yn''' is the new Y position to move to
  '''Zn''' is the new Z position to move to
  '''An''' is the new A position to move to
  '''Bn''' is the new B position to move to
  '''Hn''' is the stored head offset to apply (see '''M660''' to store offsets)
  '''Fn''' is the feed rate or travel speed to use. Only on '''G0''' is it not persistent
  '''Sn''' is a one-time (non-persistent) material flow rate multiplier (rarely used) applied to this move only


  '''Sn''' is the number of Seconds to pause
''Any values not stipulated remain unchanged.''
  '''Pn''' is the number of Milliseconds to pause


You may use '''S''' or '''P''', or if you use both, the total value will be the pause duration.
Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on '''G90''' absolute positioning or '''G91''' relative positioning. Absolute is the default and should be used in the majority of cases; there will be problems with an entire model sliced in relative mode. Relative is intended for special operations like drilling holes.


'''Example'''
Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.
 
  G4 S0.5
 
This command is decoded and executed by the printer as follows:
 
* '''G4''' (Timed pause)
** '''S0.5''' (0.5 seconds)


'''Example'''
'''Example'''


   G4 P500
   G1 X50 Y75 E1 F1800 H2


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G4''' (Timed pause)  
* '''G1''' (working speed straight line move from the current location to)  
** '''P500''' (500 milliseconds)
** '''X50''' (50mm in the X)
** '''Y75''' (75mm in the Y)
** (no change in A)
** (no change in B)
** '''E1''' (while extruding)
** '''F1800''' (moving at 1800mm/min)
** '''H2''' (invoking offsets stored in register H2)
** (no temporary scaling)


<br>
<br>
<hr>
<hr>


=== G16 Arc Plane: Any ===
=== G2 Clockwise Arc ===


G16 permits free-form designation of points in space, without limiting them to an axial plane.
A G2 move specifies a clockwise arc (or complete circle) from the current position to position (X,Y,Z)<sub>curr</sub> by following an arc about the center point (X<sub>curr</sub>+I, Y<sub>curr</sub>+J).  
 
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''


'''Usage'''
'''Usage'''


   G16
   G2 Xn Yn Zn In Jn Fn En Sn


'''Parameters'''
'''Parameters'''


   N/A
   '''Xn''' is the new X position to move to
  '''Yn''' is the new Y position to move to
  '''Zn''' is the new Z position to end at (optional and usually not stipulated)
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
  '''En''' indicates a working or printing move
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
 
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.


'''Example'''
'''Example'''


   G16
   G2 X50 Y75 I15 J20 E1 F1800


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G16''' (allow element in any orientation)  
* '''G2''' (working speed clockwise arc/circle move from the current location to)
** '''X50''' (50mm in the X)
** '''Y75''' (75mm in the Y)
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''E1''' (while extruding)
** '''F1800''' (moving at 1800mm/min)


<br>
'''Example'''
<hr>


=== G17 Arc Plane: XY ===
  G2 X50 Y75 I15 J20 E1 S6


G17 restricts this element to the X/Y plane.
This command is decoded and executed by the printer as follows:


''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''
* '''G2''' (working speed clockwise arc/circle move from the current location to)
** '''X50''' (50mm in the X)
** '''Y75''' (75mm in the Y)
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''E1''' (while extruding)
** (using previously established F rate)
** '''S6''' (made up of six sides - resulting in a hexagon with one point at the origin, with all corners inscribed on the circle)


'''Usage'''
<br>
<hr>


  G17
=== G2.1 Spiral CW Arc<sup>1</sup> ===


'''Parameters'''
A G2.1 makes a spiral circular move (only supports full 360 arcs, or '''Ln''' * 360). This arc is CW if spiraling in and CCW if spiraling out. Effective ending X/Y is always the same as the current XY and is not specified (though the actual final position is a function of the number of laps, the pitch, and the reverse code. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs).  An important feature is the "reverse code" to allow the creation of frog toes without having to jump over the frog toe once it's made.


  N/A
'''Usage'''


'''Example'''
  G2.1 Zn In Jn Pn Ln En Sn Rn Fn


  G17
'''Parameters'''


This command is decoded and executed by the printer as follows:
  '''Zn''' is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
    ''Note: '''In''' and '''Jn''' both default to 0, but at least one of them must be explicitly declared with a non-zero value.''
  '''Pn''' is the pitch (how close the laps are) in mm (required)
  '''Ln''' is the number of laps to complete (must be a positive integer; you don't need to finish the spiral)
  '''En''' indicates a working or printing move
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
  '''Rn''' is a flag; 0 to spiral in (default), 1 to spiral out (after inward jump), 2 spiral out from current position
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.


* '''G17''' (restrict element to X/Y plane)  
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.


<br>
'''Example 1'''
<hr>


=== G18 Arc Plane: XZ ===
  G2.1 I15 J20 P1.2 E1


G18 restricts this element to the X/Z plane.
This command is decoded and executed by the printer as follows:


''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''
* '''G2.1''' (working speed clockwise spiral move from the current location)
** (no change in Z)
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** (complete all laps)
** '''P1.2''' (1.2 mm between centers of travel of adjacent laps)
** '''E1''' (while extruding)
** (use default S of 0.33333 mm segments)
** (use default R of 0, spiral in toward center from current location)
** (moving at established G1 F speed)


'''Usage'''
'''Example 2'''


   G18
   G2.1 Z10 I15 J20 P0.5 L50 E1 S9 R1 F1200


'''Parameters'''
This command is decoded and executed by the printer as follows:


  N/A
* '''G2.1''' (working speed clockwise spiral move from the current location)
** '''Z10''' (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''L50''' (complete no more than 50 laps)
** '''P0.5''' (0.5 mm between centers of travel of adjacent laps)
** '''E1''' (while extruding)
** '''S9''' (each 360 degrees composted of a total of 9 segments)
** '''R1''' (spiral out from center to current location)
** '''F1200''' (at a speed of 1200 mm/min)


'''Example'''
'''Example 3'''


   G18
   G0 X0 Y25                  ; start location for outer spiral
  G0 Z1                      ; go to print layer height
  G2.1 I25 J0 P4 L3 E1        ; spiral in 3 laps, 4mm pitch
  G1 X14 E1                  ; add connector for the arcs
  G2.1 I11 J0 P4 L3 E1 R2    ; spiral out 3 laps, 4mm pitch


This command is decoded and executed by the printer as follows:
This gcode generates the following:


* '''G18''' (restrict element to X/Z plane)
[[File:Spiral.png|250px]]


<br>
<br>
<hr>
<hr>


=== G19 Arc Plane: YZ ===
=== G2.2 Spiral CW Arc<sup>2</sup> ===


G19 restricts this element to the Y/Z plane.
A G2.2 makes a spiral circular move (only supports full 360 arcs, or '''Ln''' * 360). This arc is CW if spiraling in and CCW if spiraling out. Unlike G2.1, G2.2 specifies final X/Y (and Z) location. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs).  Unlike G2.1, G2.2 does not require a reverse code as the direction of spiral is determined by the positional relationship of the current position, final position, and center position.
 
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''


'''Usage'''
'''Usage'''


   G19
   G2.2 Xn Yn Zn In Jn Pn Ln En Sn Rn Fn


'''Parameters'''
'''Parameters'''


   N/A
   '''Xn''' is the new X position to move to
  '''Yn''' is the new Y position to move to
  '''Zn''' is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
    ''Starting with Motion Controller firmware 4.203a:''
    ''If I and J are both zero (center = start), path will spiral outward CCW from current to final position.''
    ''If I and J match the end (center = end), path will spiral inward CW from current to final position."
  '''Pn''' is the pitch (how close the laps are) in mm (optional)
  '''Ln''' is the number of laps (or paths) to complete (you don't need to finish the spiral)
    ''Note, if P and L values conflict, L will be modified to match what P will allow; at least one must be specified
  '''En''' indicates a working or printing move
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.
 
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.


'''Example'''
'''Example 1'''


   G19
   G2.2 I15 J20 P1 E1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G19''' (restrict element to Y/Z plane)  
* '''G2.2''' (working speed clockwise spiral move from the current location)
 
** (no change in Z)
<br>
** (centered about a point located)
<hr>
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)  
** '''P2''' (1mm between centers of travel of adjacent laps)
** (complete all laps)
** '''E1''' (while extruding)
** (use default S of 0.33333 mm segments)
** (moving at established G1 F speed)


=== M0 Stop Until Resume ===
'''Example 2'''
 
  G2.2 Z10 I15 J20 P2 L50 E1 S9 F1200


M0 is a stop until resume command; text listed after a semicolon will be displayed, and clicking the '''Play''' button (which replaces the '''Pause''' button) will cause the job to resume. Note that all lines will be truncated at 100 characters.
This command is decoded and executed by the printer as follows:


* ''';''' All text following the ''';''' will be echoed to the print mask (Control Tab).
* '''G2.2''' (working speed clockwise spiral move from the current location)
** '''Z10''' (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
** (centered about a point located)
** '''I15''' (15mm further in the X)
** '''J20''' (20mm further in the Y)
** '''P2''' (2mm between centers of travel of adjacent laps)
** '''L50''' (complete no more than 50 laps)
** '''E1''' (while extruding)
** '''S9''' (each 360 degrees composted of a total of 9 segments)
** '''F1200''' (at a speed of 1200 mm/min)


Additionally, an M0 command can also take the following parameters, and so will pause and then:
'''Example 3'''


'''Usage'''
  G0 X0 Y25                  ; start location for outer spiral
  G0 Z1                      ; go to print layer height
  G2.2 X12 I25 P4 E1          ; spiral in 3 laps, 4mm pitch
  G1 X14 E1                  ; add connector to next spiral
  G2.2 X2 I11 P4 E1          ; spiral out 3 laps, 4mm pitch


  M0 [ SAY | PIC | VID | SEND | BEEP | SHELL ]
This gcode also generates the following:


'''Parameters'''
[[File:Spiral.png|250px]]


  '''SAY sample message''' - the computer will use built-in text-to-speech to echo the message over the speaker(s)
<br>
  '''PIC C:\sample.jpg''' - the computer will display the image at the specified location
<hr>
  '''VID C:\sample.mp4''' - the computer will play the video at the specified location
  '''SEND sample message''' - the computer will send the message to the Aux port if connected
  '''BEEP''' - the computer will sound a beep
  '''SHELL C:\program.exe''' - the computer will execute the file at the specified location


Note that multiple options can be combined.
=== G2.3 3-Space CW Arc ===


'''Example'''
A G2.3 move specifies a clockwise arc (or complete circle(s) from the current position to position (X,Y,Z)<sub>curr</sub> following a circular arc about the center point (X<sub>curr</sub>+I, Y<sub>curr</sub>+J, Z<sub>curr</sub>+K). Unlike G2, G2.1 and G2.2, G2.3 is not bound to the X/Y plane. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs). 
'''Usage'''


   M0
   G2.3 Xn Yn Zn An Bn In Jn Kn Un Vn Wn Dn Pn En Sn Fn


This command is decoded and executed by the printer as follows:
Note: If we are in G16 mode, Un, Vn, Wn define the vector normal to the work plane. If we are in G17 (X/Y plane) or G18 (X/Z plane) or G19 (Y/Z plane) mode, these are ignored.


* '''M0''' (Pause until Resume)
'''Parameters'''


'''Example'''
  '''Xn''' is the new X position to end at
  '''Yn''' is the new Y position to end at
  '''Zn''' is the new Z position to end at
  '''An''' is the new A position to end at (4th axis)
  '''Bn''' is the new B position to end at (5th axis)
  '''In''' is the '''''relative''''' distance from the current X position to the center position about which to arc (default 0)
  '''Jn''' is the '''''relative''''' distance from the current Y position to the center position about which to arc (default 0)
  '''Kn''' is the '''''relative''''' distance from the current Z position to the center position about which to arc (default 0)
    ''Note: '''In''', '''Jn''', and '''Kn''' all default to 0, but at least one of them must be explicitly declared with a non-zero value.''
  '''Un''' is the X component of a vector normal to the working plane (default 0)
  '''Vn''' is the Y component of a vector normal to the working plane (default 0)
  '''Wn''' is the Z component of a vector normal to the working plane (default 0)
  '''Dn''' is the overall displacement normal to the working plane for this element
  '''Pn''' is the pitch (how close the laps are normal to the working plane) in mm (default 0; one path, no incremental displacement)
  '''En''' indicates a working or printing move
  '''Sn''' dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
    ''S values less than 3.0 dictate the length in mm of each segment for this element''
    ''S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°''
  '''Fn''' is the Feed rate (travel speed) at which to execute this move.


  M0 ; SAY Hello Wilbur ; PIC C:\mr_ed.png
Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.


This command is decoded and executed by the printer as follows:
<br>
<hr>


* '''M0''' (Pause until Resume)
=== G3 Counterclockwise Arc ===
** '''SAY Hello Wilbur''' (Announce Text: Hello Wilbur)
 
** '''PIC C:\mr_ed.png''' (Display Image: C:\mr_ed.png)
Please refer to G2, above, for details. All options are identical, with the exception of direction (CCW).  


<br>
<br>
<hr>
<hr>


=== M203 Set G0 Speed ===
=== G3.1 Spiral CCW Arc<sup>1</sup> ===


M203 will redesignate the rate at which [[#G0 Rapid Move|G0]] movements are executed. If undeclared, the values stored in Repetrel for your equipment will be used. These can be changed under '''Settings > Printer''', on the '''Printer''' tab. The values set on your unit are set based on testing; exceed them at your own risk.
Please refer to G2.1, above, for details. All options are identical, with the exception of direction (CCW if spiraling in and CW if spiraling out).


'''Usage'''
<br>
<hr>


  M203 Xn Yn Zn An Bn
=== G3.2 Spiral CCW Arc<sup>2</sup> ===


'''Parameters'''
Please refer to G2.2, above, for details. All options are identical, with the exception of direction (CCW if spiraling in and CW if spiraling out).


  '''Xn''' is the new speed in the X axis for G0 moves
<br>
  '''Yn''' is the new speed in the Y axis for G0 moves
<hr>
  '''Zn''' is the new speed in the Z axis for G0 moves
  '''An''' is the new speed in the A axis for G0 moves
  '''Bn''' is the new speed in the B axis for G0 moves


'''Example'''
=== G3.3 3-Space CCW Arc ===
 
  M203 Y2000


This command is decoded and executed by the printer as follows:
Please refer to G2.3, above, for details. All options are identical, with the exception of direction (CCW).
 
* '''M203''' (Set G0 Speed)
** (X remains unchanged)
** '''Y2000''' (Y axis: 2000mm/min)
** (Z remains unchanged)
** (A remains unchanged)
** (B remains unchanged)


<br>
<br>
<hr>
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
=== G4 Timed Pause ===


== '''Controlling Temperature''' ==
G4 is a pause for a set number of seconds (S) or milliseconds (P).


What's Hotbed 2 and Chamber 2? Well, our Hydra models have room to have a second hotbed, which could be a smaller, higher temperature hotbed, or a sub-ambient chilled bed, or even a High Resolution hotbed. And we've talked about having a smaller chamber inside the primary chamber, to bring the air around the print (but not the head) to much higher temperatures; call for details.
'''Usage'''


<br>
  G4 Sn Pn
<hr>


=== M104 Set Temp (Head) ===
'''Parameters'''


M104 sets the extruder temperature but does not pause the printer.
  '''Sn''' is the number of Seconds to pause
  '''Pn''' is the number of Milliseconds to pause


''Note that the actual '''T#''' values can be found on '''[[T_v4]]''' or '''[[T_v5]]''', depending on which version you are running.''
You may use '''S''' or '''P''', or if you use both, the total value will be the pause duration.


'''Usage'''
'''Example'''


   M104 Sn T#
   G4 S0.5


'''Parameters'''
This command is decoded and executed by the printer as follows:


  '''Sn''' is the new set temperature in °C
* '''G4''' (Timed pause)
  '''T#''' is the tool assignment for this temperature command
** '''S0.5''' (0.5 seconds)


'''Example'''
'''Example'''


M104 T# S75
  G4 P500


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M104''' (Set Cooling/LEDs)  
* '''G4''' (Timed pause)  
** '''T#''' (target head)
** '''P500''' (500 milliseconds)
** '''S75''' (to 75°C)


<br>
<br>
<hr>
<hr>


=== M106 Set Cooling / Etc. ===
=== G16 Arc Plane: Any ===
 
G16 permits free-form designation of points in space, without limiting them to an axial plane.


M106 sets the cooling fan (or crosslinking LEDs) speed (or intensity). This also turns on the Quiet Storm fan.
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''


'''Usage'''
'''Usage'''


   M106 Cn
   G16


or
'''Parameters'''


   M106 T# Sn
   N/A


or
'''Example'''


   M106 T# Pn
   G16


'''Parameters'''
This command is decoded and executed by the printer as follows:


  '''T#''' is the target head
* '''G16''' (allow element in any orientation)  
  '''Sn''' is the percent of duty cycle for the cooling fan (or LEDs); default: 100
  '''Cn''' is the range (0-100 or 0-255) that we will use; if unspecified, the default is C100 (use C255 to be compatible with most slicers)
  '''Pn''' is the percent of duty cycle for the cooling fan (or LEDs) ''to come on only during extrusion moves''


'''Example'''
<br>
<hr>


  M106 C255
=== G17 Arc Plane: XY ===


This command is decoded and executed by the printer as follows:
G17 restricts this element to the X/Y plane.


* '''M106''' (Set Cooling/LEDs)
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''
** (on all tools)
** (no speed)
** '''C255''' (of range 0-255)


Note, with this command, all following M106 commands for the rest of this print job will be based on this range (unless specified with a new C value).
'''Usage'''


'''Example'''
  G17


  M106 T# S50
'''Parameters'''


This command is decoded and executed by the printer as follows:
  N/A
 
* '''M106''' (Set Cooling/LEDs)
** '''T#''' (target head)
** '''S50''' (target value of 50)
** (previously defined (or default 0-100) range)


'''Example'''
'''Example'''


M106 T# P100
  G17


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M106''' (Set Cooling/LEDs)  
* '''G17''' (restrict element to X/Y plane)  
** '''T#''' (target head)
 
** '''P100''' (during extrusion moves at 100% duty cycle
<br>
<hr>
 
=== G18 Arc Plane: XZ ===
 
G18 restricts this element to the X/Z plane.
 
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''


<span style="color: blue;">''But Davo, I want to cure a certain spot for 10 seconds with every layer change; how do I do this?''</span>
'''Usage'''


Easy. Edit your slicer recipe to add the following code after layer changes (edit as needed for duration, intensity, or position):
  G18


  ;---- BEGIN COD CODE
'''Parameters'''
  G91 ; relative moves
  G0 Z5 ; drop bed
  G90 ; absolute moves
  G0 X130 Y110 ; move into position
  M106 S100 T# ; turn on T# UV at 100%
  G1 X140 Y110 F100 ; move 10 mm in the X at 100 mm/min
  G1 X140 Y120 F100 ; move 10 mm in the Y at 100 mm/min
  G1 X130 Y120 F100 ; move -10 mm in the X at 100 mm/min
  G1 X130 Y110 F100 ; move -10 mm in the Y at 100 mm/min
  M106 S0 T# ; turn off T# UV (set it to 0%)
  ;--- END COD GCODE


These commands are decoded and executed by the printer as follows:
  N/A


* '''G91''' (Use relative moves)
'''Example'''
* '''G0''' (Non-working move)
 
** '''Z5''' (+5 mm in the Z)
  G18
* '''G90''' (Use absolute moves)
 
* '''G0''' (Non-working move)
This command is decoded and executed by the printer as follows:
** '''X130''' (To position X130)
 
** '''Y110''' (To position Y110)
* '''G18''' (restrict element to X/Z plane)  
* '''M106''' (Set Aux (UV))
** '''S100''' (100% duty)
** '''T#''' (On target head)
* '''G1''' (Working (printing) move)
** '''X140''' (To position X140)
** '''Y110''' (To position Y110
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X140''' (To position X140)
** '''Y120''' (To position Y120
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X130''' (To position X130)
** '''Y120''' (To position Y120
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X130''' (To position X130)
** '''Y110''' (To position Y110
** '''F100''' (At 100 mm/min)
* '''M106''' (Set Aux (UV))
** '''S0''' (0% duty)
** '''T#''' (On target head)


<br>
<br>
<hr>
<hr>


=== M107 Stop Cooling / Etc. ===
=== G19 Arc Plane: YZ ===
 
G19 restricts this element to the Y/Z plane.


M107 turns off the cooling fan (or crosslinking LEDs); this is essentially the same as an M106 S0 (setting it to 0 percent). This will also turn off the Quiet Storm fan.
''G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.''


'''Usage'''
'''Usage'''


   M107 T#
   G19


'''Parameters'''
'''Parameters'''


   '''T#''' (target head)
   N/A


'''Example'''
'''Example'''


M107 T# 
  G19


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M107''' (Set Cooling/LEDs to 0%)
* '''G19''' (restrict element to Y/Z plane)  
** '''T#''' (target head)


<br>
<br>
<hr>
<hr>


=== M109 Wait for Temp (Head) ===
=== M0 Stop Until Resume ===
 
M0 is a stop until resume command; text listed after a semicolon will be displayed, and clicking the '''Play''' button (which replaces the '''Pause''' button) will cause the job to resume. Note that all lines will be truncated at 100 characters.


M109 waits for the extruder to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) heads as options.
* ''';''' All text following the ''';''' will be echoed to the print mask (Control Tab).


''Note that the actual '''T#''' values can be found on '''[[T_v4]]''' or '''[[T_v5]]''', depending on which version you are running.''
Additionally, an M0 command can also take the following parameters, and so will pause and then:


'''Usage'''
'''Usage'''


   M109 T# Sn Hn Cn Ln Un Rn
   M0 [ SAY | PIC | VID | SEND | BEEP | SHELL ]
 
Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M109 command.
 
Note, this will FAIL (non-fatally) if you address a virtual group address;  be sure to use an actual physical address.


'''Parameters'''
'''Parameters'''


   '''T#''' is the target head
   '''SAY sample message''' - the computer will use built-in text-to-speech to echo the message over the speaker(s)
   '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
   '''PIC C:\sample.jpg''' - the computer will display the image at the specified location
   '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
   '''VID C:\sample.mp4''' - the computer will play the video at the specified location
   '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
   '''SEND sample message''' - the computer will send the message to the Aux port if connected
   '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
   '''BEEP''' - the computer will sound a beep
   '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
   '''SHELL C:\program.exe''' - the computer will execute the file at the specified location
  '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause


Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.
Note that multiple options can be combined.


'''Example 1'''
'''Example'''


   M109 T# S240
   M0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M109''' (wait for temp)  
* '''M0''' (Pause until Resume)
** '''T#''' (target head)
 
** '''S240''' (and set temp to 240°C)
'''Example'''


'''Example 2'''
  M0 ; SAY Hello Wilbur ; PIC C:\mr_ed.png


  M109 T# S240 R5
This command is decoded and executed by the printer as follows:


This command is decoded and executed by the printer as follows:
* '''M0''' (Pause until Resume)
** '''SAY Hello Wilbur''' (Announce Text: Hello Wilbur)
** '''PIC C:\mr_ed.png''' (Display Image: C:\mr_ed.png)


* '''M109''' (wait for temp)
<br>
** '''T#''' (target head)
<hr>
** '''S240''' (and set temp to 240°C)
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)


'''Example 3'''
=== M203 Set G0 Speed ===


  M109 T# S240 H230
M203 will redesignate the rate at which [[#G0 Rapid Move|G0]] movements are executed. If undeclared, the values stored in Repetrel for your equipment will be used. These can be changed under '''Settings > Printer''', on the '''Printer''' tab. The values set on your unit are set based on testing; exceed them at your own risk.


This command is decoded and executed by the printer as follows:
'''Usage'''


* '''M109''' (wait for temp)
  M203 Xn Yn Zn An Bn
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)


'''Example 4'''
'''Parameters'''


   M109 T# S240 L10 U5
   '''Xn''' is the new speed in the X axis for G0 moves
  '''Yn''' is the new speed in the Y axis for G0 moves
  '''Zn''' is the new speed in the Z axis for G0 moves
  '''An''' is the new speed in the A axis for G0 moves
  '''Bn''' is the new speed in the B axis for G0 moves


This command is decoded and executed by the printer as follows:
'''Example'''


* '''M109''' (wait for temp)
  M203 Y2000
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)


''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''
This command is decoded and executed by the printer as follows:


'''Example 5'''
* '''M203''' (Set G0 Speed)
** (X remains unchanged)
** '''Y2000''' (Y axis: 2000mm/min)
** (Z remains unchanged)
** (A remains unchanged)
** (B remains unchanged)


  M109 T# S0 R5
<br>
<hr>


This command is decoded and executed by the printer as follows:
=== M674 Use Turbo Mode ===


* '''M109''' (wait for temp)  
M674 will enable Turbo Mode, where certain non-printing (no E value) working (G1, G2, or G3) moves will be treated as G0 moves (executed at "rapid move speed" rather than "working move speed"). Killing a job will clear the M674 setting.
** '''T#''' (target head)
** '''S0''' (to 0°C)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)


'''Example 6'''
'''Usage'''


   M109 R10
   M674 Sn


* '''M109''' (wait for temp)
'''Parameters'''
** (no T# - use head with current focus)
** '''R10''' (to get +/-10°C of set temperature)


<br>
  '''Sn''' is the minimum distance threshold for Turbo Mode to activate, and is required; no S value returns an error.
<hr>


=== M116 UNUSED ===
'''Example 1'''
M116 is not recognized by Repetrel.


On some other printers, this will cause the printer to pause until all set temperatures are reached.
  M674 S2


<br>
This command is decoded and executed by the printer as follows:
<hr>


=== M140 Set Temp (Bed) ===
* '''M674''' (Set Turbo Mode)
** '''S2''' (for moves of 2 mm or greater)  


M140 sets the bed temperature (without waiting for the new temperature to be reached).
'''Example 2'''


'''Usage'''
   M674 S50
 
   M140 Sn T#
 
'''Parameters'''
 
  '''Sn''' is the new set temperature in °C
  '''T#''' is the target bed (default is the primary bed)
 
'''Example'''
 
M140 S75


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M140''' (set bed temperature)
* '''M674''' (Set Turbo Mode)  
** '''S75''' (to 75°C)
** '''S50''' (for moves of 50 mm or greater)
** (on primary bed)


<br>
<br>
<hr>
<hr>


=== M141 Set Temp (Chamber) ===
'''[[#What_is_GCode.3F|Back to top]]'''


M141 sets the chamber temperature (without waiting for the new temperature to be reached).
== '''Controlling Temperature''' ==


'''Usage'''
{| border="1" class="wikitable" style="float:right"
 
! colspan="3" | Controlling Temperature
  M141 Sn T#
|-
 
! Code
'''Parameters'''
! Supported
 
! Brief Description
  '''Sn''' is the new set temperature in °C
|-
  '''T#''' is the target chamber (default is the primary chamber)
! [[#M104_Set_Temp_.28Head.29|M104]]
 
| Yes || Set Temp (Head)
'''Example'''
|-
! [[#M106_Set_Cooling_.2F_Etc.|M106]]
| Yes || Set Cooling / Etc.
|-
! [[#M107_Stop_Cooling_.2F_Etc.|M107]]
| Yes || Stop Cooling / Etc.
|-
! [[#M109_Wait_for_Temp_.28Head.29|M109]]
| Yes || Wait for Temp (Head)
|-
! [[#M116 Wait for Temps (v5+)|M116]]
| <span style="color:darkorange;">v5+ || <span style="color:darkorange;">Pause for All Temps
|-
! [[#M140_Set_Temp_.28Bed.29|M140]]
| Yes || Set Temp (Bed)
|-
! [[#M141_Set_Temp_.28Chamber.29|M141]]
| Yes || Set Temp (Chamber)
|-
! [[#M190_Wait_for_Temp_.28Bed.29|M190]]
| Yes || Wait for Temp (Bed)
|-
! [[#M191_Wait_for_Temp_.28Chamber.29|M191]]
| Yes || Wait for Temp (Chamber)
|-
|}


M141 S75
What's Hotbed 2 and Chamber 2? Well, our Hydra models have room to have a second hotbed, which could be a smaller, higher temperature hotbed, or a sub-ambient chilled bed, or even a High Resolution hotbed. And we've talked about having a smaller chamber inside the primary chamber, to bring the air around the print (but not the head) to much higher temperatures; call for details.
 
This command is decoded and executed by the printer as follows:
 
* '''M141''' (set chamber temperature)
** '''S75''' (to 75°C)
** (on primary chamber)


<br>
<br>
<hr>
<hr>


=== M190 Wait for Temp (Bed) ===
=== M104 Set Temp (Head) ===
 
M104 sets the extruder temperature but does not pause the printer.


M190 waits for the bed to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) beds as options.
''Note that the actual '''T#''' values can be found on '''[[T_v4]]''' or '''[[T_v5]]''', depending on which version you are running.''


'''Usage'''
'''Usage'''


   M190 T# Sn Hn Cn Ln Un Rn
   M104 Sn T#


Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M190 command.
'''Parameters'''


Note, this will FAIL (non-fatally) if you address a virtual group address;  be sure to use an actual physical address.
  '''Sn''' is the new set temperature in °C
  '''T#''' is the tool assignment for this temperature command


'''Parameters'''
'''Example'''


  '''T#''' is the target bed (default is the primary (or only) bed)
M104 T# S75
  '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
  '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
  '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
  '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause


Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.
This command is decoded and executed by the printer as follows:


'''Example 1'''
* '''M104''' (Set Cooling/LEDs)
** '''T#''' (target head)
** '''S75''' (to 75°C)


  M190 T# S240
<br>
<hr>


This command is decoded and executed by the printer as follows:
=== M106 Set Cooling / Etc. ===


* '''M190''' (wait for temp)  
M106 sets the cooling fan (or crosslinking LEDs) speed (or intensity). This also turns on the Quiet Storm fan.
** '''T#''' (target bed)
** '''S240''' (and set temp to 240°C)


'''Example 2'''
'''Usage'''


   M190 T# S240 R5
   M106 Cn


This command is decoded and executed by the printer as follows:
or


* '''M190''' (wait for temp)
  M106 T# Sn
** '''T#''' (target bed)
** '''S240''' (and set temp to 240°C)
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)


'''Example 3'''
or


   M190 T# S240 H230
   M106 T# Pn


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M190''' (wait for temp)
  '''T#''' is the target head
** '''T#''' (target bed)
  '''Sn''' is the percent of duty cycle for the cooling fan (or LEDs); default: 100
** '''S240''' (and set temp to 240°C)
  '''Cn''' is the range (0-100 or 0-255) that we will use; if unspecified, the default is C100 (use C255 to be compatible with most slicers)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)
  '''Pn''' is the percent of duty cycle for the cooling fan (or LEDs) ''to come on only during extrusion moves''


'''Example 4'''
'''Example'''


   M190 T# S240 L10 U5
   M106 C255


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M190''' (wait for temp)  
* '''M106''' (Set Cooling/LEDs)  
** '''T#''' (target bed)
** (on all tools)
** '''S240''' (and set temp to 240°C)
** (no speed)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''C255''' (of range 0-255)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)


''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''
Note, with this command, all following M106 commands for the rest of this print job will be based on this range (unless specified with a new C value).


'''Example 5'''
'''Example'''


   M190 T# S0 R5
   M106 T# S50


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M190''' (wait for temp)  
* '''M106''' (Set Cooling/LEDs)  
** '''T#''' (target bed)
** '''T#''' (target head)
** '''S0''' (to 0°C)
** '''S50''' (target value of 50)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)
** (previously defined (or default 0-100) range)


'''Example 6'''
'''Example'''


  M190 R10
M106 T# P100


* '''M190''' (wait for temp)
This command is decoded and executed by the printer as follows:
** (no T# - use bed with current focus)
** '''R10''' (to get +/-10°C of set temperature)


<br>
* '''M106''' (Set Cooling/LEDs)
<hr>
** '''T#''' (target head)
** '''P100''' (during extrusion moves at 100% duty cycle


=== M191 Wait for Temp (Chamber) ===
<span style="color: blue;">''But Davo, I want to cure a certain spot for 10 seconds with every layer change; how do I do this?''</span>
M191 waits for the chamber to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) chambers as options.


'''Usage'''
Easy. Edit your slicer recipe to add the following code after layer changes (edit as needed for duration, intensity, or position):


   M191 T# Sn Hn Cn Ln Un Rn
   ;---- BEGIN COD CODE
  G91 ; relative moves
  G0 Z5 ; drop bed
  G90 ; absolute moves
  G0 X130 Y110 ; move into position
  M106 S100 T# ; turn on T# UV at 100%
  G1 X140 Y110 F100 ; move 10 mm in the X at 100 mm/min
  G1 X140 Y120 F100 ; move 10 mm in the Y at 100 mm/min
  G1 X130 Y120 F100 ; move -10 mm in the X at 100 mm/min
  G1 X130 Y110 F100 ; move -10 mm in the Y at 100 mm/min
  M106 S0 T# ; turn off T# UV (set it to 0%)
  ;--- END COD GCODE


Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M191 command.
These commands are decoded and executed by the printer as follows:


Note, this will FAIL (non-fatally) if you address a virtual group address;  be sure to use an actual physical address.
* '''G91''' (Use relative moves)
 
* '''G0''' (Non-working move)
'''Parameters'''
** '''Z5''' (+5 mm in the Z)
* '''G90''' (Use absolute moves)
* '''G0''' (Non-working move)
** '''X130''' (To position X130)
** '''Y110''' (To position Y110)
* '''M106''' (Set Aux (UV))
** '''S100''' (100% duty)
** '''T#''' (On target head)
* '''G1''' (Working (printing) move)
** '''X140''' (To position X140)
** '''Y110''' (To position Y110
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X140''' (To position X140)
** '''Y120''' (To position Y120
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X130''' (To position X130)
** '''Y120''' (To position Y120
** '''F100''' (At 100 mm/min)
* '''G1''' (Working (printing) move)
** '''X130''' (To position X130)
** '''Y110''' (To position Y110
** '''F100''' (At 100 mm/min)
* '''M106''' (Set Aux (UV))
** '''S0''' (0% duty)
** '''T#''' (On target head)


  '''T#''' is the target chamber (default is the primary (or only) chamber)
<br>
  '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
<hr>
  '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
  '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
  '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause


Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.
=== M107 Stop Cooling / Etc. ===


'''Example 1'''
M107 turns off the cooling fan (or crosslinking LEDs); this is essentially the same as an M106 S0 (setting it to 0 percent). This will also turn off the Quiet Storm fan.
 
'''Usage'''


   M191 T# S240
   M107 T#


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M191''' (wait for temp)
  '''T#''' (target head)
** '''T#''' (target chamber)
** '''S240''' (and set temp to 240°C)


'''Example 2'''
'''Example'''


  M191 T# S240 R5
M107 T#


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M191''' (wait for temp)  
* '''M107''' (Set Cooling/LEDs to 0%)  
** '''T#''' (target chamber)
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)


'''Example 3'''
<br>
<hr>


  M191 T# S240 H230
=== M109 Wait for Temp (Head) ===


This command is decoded and executed by the printer as follows:
M109 waits for the extruder to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) heads as options.


* '''M191''' (wait for temp)
''Note that the actual '''T#''' values can be found on '''[[T_v4]]''' or '''[[T_v5]]''', depending on which version you are running.''
** '''T#''' (target chamber)
** '''S240''' (and set temp to 240°C)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)


'''Example 4'''
'''Usage'''


   M191 T# S240 L10 U5
   M109 T# Sn Hn Cn Ln Un Rn <span style="color:darkorange;">W0


This command is decoded and executed by the printer as follows:
Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M109 command.


* '''M191''' (wait for temp)  
Note, this will FAIL (non-fatally) if you address a virtual group address;  be sure to use an actual physical address.
** '''T#''' (target chamber)
** '''S240''' (and set temp to 240°C)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)


''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''
'''Parameters'''


'''Example 5'''
  '''T#''' is the target head - (required)
  '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
  '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
  '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
  '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause
  <span style="color:darkorange;">'''W0''' if present, will set the temp and advance to the next line without pause, but upon executing M116, will pause until temp is reached


  M191 T# S0 R5
Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.


This command is decoded and executed by the printer as follows:
'''Example 1'''


* '''M191''' (wait for temp)
  M109 T# S240
** '''T#''' (target chamber)
** '''S0''' (to 0°C)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)


'''Example 6'''
This command is decoded and executed by the printer as follows:


  M191 R10
* '''M109''' (wait for temp)
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)


* '''M191''' (wait for temp)
'''Example 2'''
** (no T# - use chamber with current focus)
** '''R10''' (to get +/-10°C of set temperature)


<br>
  M109 T# S240 R5
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
This command is decoded and executed by the printer as follows:


== '''Controlling Material Flow''' ==
* '''M109''' (wait for temp)
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)


You can specify flow rate variables in your gcode; we do not do this by default, but take these values from the head itself. Any values you stipulate in your gcode will supersede the values stored on the head. With our recipes the slicing program generates gcode which dictates temperature and movement commands and indicates which moves should dispense material (a G1 move with an E value).
'''Example 3'''


However, we have two different ways to control flow.
  M109 T# S240 H230


* If you use '''M229 E1 D1''' we will use the E values generated by the slicer. This allows for varying extrusion widths and layer thicknesses (on the same layer - as with support material). This is how just about all slicers and printers work.
This command is decoded and executed by the printer as follows:


* If you do not use that command, we do not use that E value (except to distinguish printing from non-printing moves) we calculate for flow based purely on travel speed, declared layer thickness, and nozzle diameter. This is explained at http://hyrel3d.net/wiki/index.php/Flow_Rate
* '''M109''' (wait for temp)
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)


When a head is loaded, it sends this flow data (how to calculate flow, as well as how much to prime and unprime (advance and retract) material when transitioning between printing and non-printing moves - and even how many primes or unprimes to do in conjunction with a tool change.
'''Example 4'''


In this way, the very same gcode (with temperature changes) can be used with any material, provided you are using the same physical parameters that the model was sliced for.
  M109 T# S240 L10 U5


<br>
This command is decoded and executed by the printer as follows:
<hr>


=== G10 UNUSED<sup>1</sup> ===
* '''M109''' (wait for temp)
** '''T#''' (target head)
** '''S240''' (and set temp to 240°C)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)


G10 is not recognized by Repetrel.
''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''


On some other printers, this will set tool offsets; we do this via '''M6'''.
'''Example 5'''


On some other printers, this will do a retract; we do this via '''M721'''.
  M109 T# S0 R5


<br>
This command is decoded and executed by the printer as follows:
<hr>


=== G11 UNUSED ===
* '''M109''' (wait for temp)
** '''T#''' (target head)
** '''S0''' (to 0°C)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)
 
'''Example 6'''
 
  M109 R10
 
* '''M109''' (wait for temp)
** (no T# - use head with current focus)
** '''R10''' (to get +/-10°C of set temperature)
 
<span style="color:darkorange;">'''Example 7'''


G11 is not recognized by Repetrel.
  <span style="color:darkorange;">M109 T# S240 W0
 
<span style="color:darkorange;">This command is decoded and executed by the printer as follows:


On some other printers, this will do an advance or unretract; we do this via '''M722'''.
* <span style="color:darkorange;">'''M109''' (wait for temp)
** <span style="color:darkorange;">'''T#''' (target head)
** <span style="color:darkorange;">'''S240''' (and set temp to 240°C)
** <span style="color:darkorange;">'''W0''' (but do not pause until M116 is executed)


<br>
<br>
<hr>
<hr>


=== M82 Absolute E-Values ===
=== <span style="color:darkorange;">M116 Wait for Temps (v5+)</span> ===
<span style="color:darkorange;">M116 is supported with version 5.x and later (v5+) of Repetrel Software and Motion Controller Firmware.


M82 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the original (0) point.
<span style="color:darkorange;">'''Usage'''


Note, this only works on v4 and later, when E values are enabled via '''M229'''.
  <span style="color:darkorange;">M116


'''Usage'''
<span style="color:darkorange;">'''Parameters'''


   M82
   <span style="color:darkorange;">'none'


'''Parameters'''
<span style="color:darkorange;">'''Example'''
 
  N/A
 
'''Example'''


M82
  <span style="color:darkorange;">M116


This command is decoded and executed by the printer as follows:
<span style="color:darkorange;">This command is decoded and executed by the printer as follows:


* '''M82''' (use absolute E values)
* <span style="color:darkorange;">'''M116''' (wait for any set temps (M109, M190, M191) with '''W0''' values before proceding


<br>
<br>
<hr>
<hr>


=== M83 Relative E-Values ===
=== M140 Set Temp (Bed) ===


M83 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the relative (last used) point.
M140 sets the bed temperature (without waiting for the new temperature to be reached).
 
Note, this only works on v4 and later, when E values are enabled via '''M229'''.


'''Usage'''
'''Usage'''


   M83
   M140 Sn T#


'''Parameters'''
'''Parameters'''


   N/A
   '''Sn''' is the new set temperature in °C
  '''T#''' is the target bed (default is the primary bed)


'''Example'''
'''Example'''


  M83
M140 S75


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M83''' (use relative E values)
* '''M140''' (set bed temperature)
** '''S75''' (to 75°C)
** (on primary bed)


<br>
<br>
<hr>
<hr>


=== M221 Set Flow Rate ===
=== M141 Set Temp (Chamber) ===


M221 sends information to the printer about material flow.
M141 sets the chamber temperature (without waiting for the new temperature to be reached).
 
Note, our default mode is volumetric calculations; if you need to slice with linear calculations, multiply your Pn by approximately 2.4 (you can do the math).


'''Usage'''
'''Usage'''


   M221 Pn Sn Wn Zn T#
   M141 Sn T#


'''Parameters'''
'''Parameters'''


  '''Pn''' is the number of pulses on the motor to dispense 1 μl (for volumetric) or 1 mm (for linear) of material;
   '''Sn''' is the new set temperature in °C
   '''Sn''' is the direct flow multiplier (to allow for undersized or oversized stock;
   '''T#''' is the target chamber (default is the primary chamber)
   '''Wn''' is the width of the cross section of the volume to fill;
  '''Zn''' is the height (layer thickness) of the cross section of the volume to fill; and
  '''T#''' is the tool (head) to which these values will be applied.


'''Example'''
'''Example'''


  M221 S1.0 T# P77 W0.5 Z0.3
M141 S75


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M221''' (set flow rate)
* '''M141''' (set chamber temperature)
** '''S1.0''' (flow multiplier of 1.0)
** '''S75''' (to 75°C)
** '''T#''' (target head)
** (on primary chamber)
** '''P77''' (77 pulses per microliter) 
** '''W0.5''' (0.5mm nozzle) 
** '''Z0.3''' (0.3mm layer thickness - note that your gcode '''M756''' will overwrite this value)


<br>
<br>
<hr>
<hr>


=== M229 Use E Values ===
=== M190 Wait for Temp (Bed) ===


'''Starting with version 4''', Hyrel will begin to enable the use of E-values in your gcode. Variable extrusion width and support/infill thickness slicers, rejoice! Note, calculations are done for every single move individually.
M190 waits for the bed to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) beds as options.


'''Usage'''
'''Usage'''


   M229 En Dn Sn
   M190 T# Sn Hn Cn Ln Un Rn
 
Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M190 command.
 
Note, this will FAIL (non-fatally) if you address a virtual group address;  be sure to use an actual physical address.


'''Parameters'''
'''Parameters'''


   '''En''' can be 0 (native flow calculation) or 1 (use E values)
   '''T#''' (optional) is the target bed (default is the primary (or only) bed)
   '''Dn''' how directed to head; see below
   '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
    '''D0''' on head controller directly; constant flow, not adjusted for motion acceleration/deceleration
  '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
    '''D1''' on motion controller, sent to head via CANBUS and adjusted for motion acceleration/deceleration
  '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
    '''D2''' on motion controller, sent to head via C axis step pin and adjusted for motion acceleration/deceleration
  '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
    '''D3''' on motion controller, sent to head via CANBUS and C axis and adjusted for motion acceleration/deceleration
  '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
   '''Sn''' sets a threshold in seconds; isolated non-printing moves below this threshold will not trigger unprime/prime actions
   '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause


Note: E1 D0 is an illegal combination.
Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.


'''Example 1'''
'''Example 1'''


   M229 E1 D1
   M190 T# S240


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M229''' (E values)
* '''M190''' (wait for temp)  
** '''E1''' (enabled)
** '''T#''' (target bed)
** '''D1''' (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)
** '''S240''' (and set temp to 240°C)
 
''Above is the default way to enable E values.''


'''Example 2'''
'''Example 2'''


   M229 E0 D0
   M190 T# S240 R5


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M229''' (E values)
* '''M190''' (wait for temp)  
** '''E0''' (disabled)
** '''T#''' (target bed)
** '''D0''' (flow calculations on head controller)
** '''S240''' (and set temp to 240°C)
 
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)
''Above is the default way to ignore E values, and is how v3 and earlier releases work.''


'''Example 3'''
'''Example 3'''


   M229 E0 D1
   M190 T# S240 H230


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M229''' (E values)
* '''M190''' (wait for temp)  
** '''E0''' (disabled)
** '''T#''' (target bed)
** '''D1''' (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)
** '''S240''' (and set temp to 240°C)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)


'''Example 4'''
'''Example 4'''


   M229 E0 D0 S0.02
   M190 T# S240 L10 U5


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M229''' (E values)
* '''M190''' (wait for temp)  
** '''E0''' (disabled)
** '''T#''' (target bed)
** '''D0''' (flow calculations on head controller)
** '''S240''' (and set temp to 240°C)
** '''S0.02''' (isolated non-printing moves of under 0.02 seconds will not trigger unprime/prime actions)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)
 
''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''


<br>
'''Example 5'''
<hr>


=== M721 Set Unprime Values ===
  M190 T# S0 R5


M721 sends information to the printer about how much material to unprime when a transition from printing move to non-printing move is detected.
This command is decoded and executed by the printer as follows:


'''Usage'''
* '''M190''' (wait for temp)
** '''T#''' (target bed)
** '''S0''' (to 0°C)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)


  M721 Sn En Pn T# In
'''Example 6'''


'''Parameters'''
  M190 R10


  '''Sn''' is the speed at which unprime moves should be executed; this is normally 10,000
* '''M190''' (wait for temp)
  '''En''' is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
** (no T# - use bed with current focus)
  '''Pn''' is the number of milliseconds relative to the end of the move to begin the unprime (retract) action; a negative number initiates this before the end of the move
** '''R10''' (to get +/-10°C of set temperature)
  '''T#''' is the target head
  '''In''' is the flag for executing an Immediate action; so '''M721 I1''' would execute an unprime with the previously specified values at that point in the gcode.


'''Example 1'''
<br>
<hr>


M721 S10000 E100 P-15 T#
=== M191 Wait for Temp (Chamber) ===
M191 waits for the chamber to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) chambers as options.


This command is decoded and executed by the printer as follows:
'''Usage'''


* '''M721''' (unprime) 
  M191 T# Sn Hn Cn Ln Un Rn
** '''S10000''' (set rate to 10,000 pps) 
** '''E100''' (set pulses to 100) 
** '''P-15''' (set dwell to 15ms before end of print move )
** '''T#''' (on target head)
** (but no immediate execution; execute when needed)


'''Example 2'''
Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M191 command.


  M721 T# I1
Note, this will FAIL (non-fatally) if you address a virtual group address; be sure to use an actual physical address.


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M721''' (unprime)
  '''T#''' is the target chamber (default is the primary (or only) chamber)
** '''T#''' (on target head)
  '''Sn''' (optional) is the new set temperature in °C; if omitted, no new target temperature is set
** '''I1''' (now)
  '''Hn''' if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
  '''Cn''' if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
  '''Ln''' if present, is the lower-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Un''' if present, is the upper-end relative temperature ''difference from set temp'' after which we stop pausing
  '''Rn''' if present, is how close the relative temperature needs to be to the set temp to end the pause


<br>
Think of '''Sn''' as the target temperature, but once the target is between '''Cn (or Ln)''' and '''Hn (or Un)''', the pause is over (but the '''Sn''' is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.
<hr>


=== M722 Set Prime Values ===
'''Example 1'''


M722 sends information to the printer about how much material to prime (advance) when a transition from non-printing move to printing move is detected. This is done primarily to compensate for an earlier unprime (retract), to prep the head to be ready to dispense.
  M191 T# S240


'''Usage'''
This command is decoded and executed by the printer as follows:


  M722 Sn En Pn T# In
* '''M191''' (wait for temp)
** '''T#''' (target chamber)
** '''S240''' (and set temp to 240°C)


'''Parameters'''
'''Example 2'''


   '''Sn''' is the speed at which unprime moves should be executed; this is normally 10,000
   M191 T# S240 R5
  '''En''' is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
  '''Pn''' is the number of milliseconds to dwell relative to the start of the move to allow for the prime (advance) action
  '''T#''' is the target head
  '''In''' is the flag for executing an Immediate action; so '''M722 I1''' would execute a prime with the previously specified values at that point in the gcode.
 
'''Example'''
 
M722 S10000 E100 P-15 T#


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M721''' (prime)
* '''M191''' (wait for temp)  
** '''S10000''' (set rate to 10,000 pps)
** '''T#''' (target chamber)
** '''E100''' (set pulses to 100)
** '''S240''' (and set temp to 240°C)
** '''P-15''' (set dwell to 15ms before end of print move )
** '''R5''' (but end the wait once the target's temperature is within 5°C of the set point)
** '''T#''' (on target head)
** (but no immediate execution; execute when needed)


'''Example'''
'''Example 3'''


M722 T# I1
  M191 T# S240 H230


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M722''' (prime)
* '''M191''' (wait for temp)  
** '''T#''' (on target head)
** '''T#''' (target chamber)
** '''I1''' (now)
** '''S240''' (and set temp to 240°C)
** '''H230''' (but end the wait once the target's temperature reaches 230°C)


<br>
'''Example 4'''
<hr>


=== M723 Set Manual Flow ===
  M191 T# S240 L10 U5


M723 tells the designated extruder(s) to advance material for the specified number of pulses (on the motor) at the specified rate, regardless of any X/Y/Z movement. It is normally used only during manual operation, not during gcode execution. It can be used after moving to a location to dispense a set amount of material (like depositing material into reservoirs).
This command is decoded and executed by the printer as follows:


M723 is also used to activate and set speed on the stirring apparatus on the DMH dynamic mixing head.
* '''M191''' (wait for temp)
** '''T#''' (target chamber)
** '''S240''' (and set temp to 240°C)
** '''L10''' (but end the wait once the target's temperature reaches 10°C below the set point)
** '''U5''' (or end the wait once the target's temperature reaches 5°C above the set point)


''Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C''


'''Usage'''
'''Example 5'''


   M723 Sn En T#
   M191 T# S0 R5


'''Parameters'''
This command is decoded and executed by the printer as follows:


  '''Sn''' is the speed at which the motor should advance, in pulses per second (default: 500);
* '''M191''' (wait for temp)  
  '''En''' is the number of pulses on the feed (extrusion) motor to execute (default: 65535);
** '''T#''' (target chamber)
  '''T#''' is the target head
** '''S0''' (to 0°C)
** '''R5''' (but end the wait once the target's temperature is +/-5°C of the set temperature)


'''Example'''
'''Example 6'''


M723 S500 E65535 T#
  M191 R10


This command is decoded and executed by the printer as follows:
* '''M191''' (wait for temp)
 
** (no T# - use chamber with current focus)
* '''M723''' (start manual feed)
** '''R10''' (to get +/-10°C of set temperature)
** '''S500''' (at 500 pulses per second)
** '''E65535''' (for 65535 pulses (default)) 
** '''T#''' (target head)


<br>
<br>
<hr>
<hr>


=== M728 Set Motor Current Boost ===
'''[[#What_is_GCode.3F|Back to top]]'''


M728 will set the motor current boost; default is 0.
== '''Controlling Material Flow''' ==


'''Usage'''
{| border="1" class="wikitable" style="float:right"
 
! colspan="3" | Controlling Material Flow
  M728 Sn T#
|-
 
! Code
'''Parameters'''
! Supported
 
! Brief Description
  '''Sn''' is the new set temperature in °C
|-
  '''T#''' is the target head (or device)
! [[#G10_UNUSED|G10]]
 
| ''No'' || ''Absolute E''
'''Example'''
|-
 
! [[#G11_UNUSED|G11]]
  M728 T# S0
| ''No'' || ''Relative E''
 
|-
This command is decoded and executed by the printer as follows:
! [[#M82_Absolute_E-Values|M82]]
 
| Yes || Absolute E-Values
* '''M728''' (set motor current boost)
|-
** '''T#''' (target head)
! [[#M83_Relative_E-Values|M83]]
** '''S0''' (off)
| Yes || Relative E-Values
<br>
|-
<hr>
! [[#M221_Set_Flow_Rate|M221]]
| Yes || Set Flow Rate
|-
! [[#M229_Use_E_Values|M229]]
| Yes || Use E Values
|-
! [[#M721_Set_Unprime_Values|M721]]
| Yes || Set Unprime Values
|-
! [[#M722_Set_Prime_Values|M722]]
| Yes || Set Prime Values
|-
! [[#M723_Set_Manual_Flow|M723]]
| Yes || Set Manual Flow
|-
! [[#M728_Set_Motor_Current_Boost|M728]]
| Yes || Set Motor Current Boost
|-
! [[#M756_Set_Height_for_Flow|M756]]
| Yes || Set Height for Flow
|-
|}


=== M756 Set Height for Flow ===
You can specify flow rate variables in your gcode; we do not do this by default, but take these values from the head itself. Any values you stipulate in your gcode will supersede the values stored on the head. With our recipes the slicing program generates gcode which dictates temperature and movement commands and indicates which moves should dispense material (a G1 move with an E value).


M756 will overwrite the Z value from the M221 command, allowing you to calculate flow for thinner or thicker layers. We declare M756 at the beginning of every layer; normally, they are all the same (unless you sliced for varying layer thicknesses).  
However, we have two different ways to control flow.  


Note: this command is ignored if you are using '''M229 E1 D1''' to enable use of E values.
* If you use '''M229 E1 D1''' we will use the E values generated by the slicer ''for printing moves, but we will always use the prime/unprime settings on the head for advancing and retracting when transitioning between printing and non-printing moves.'' This allows for varying extrusion widths and layer thicknesses (on the same layer - as with support material). This is how just about all slicers and printers work.


'''Usage'''
* If you do not use that command, we do not use that E value (except to distinguish printing from non-printing moves) we calculate for flow based purely on travel speed, declared layer thickness, and nozzle diameter. This is explained at http://hyrel3d.net/wiki/index.php/Flow_Rate


  M756 Sn
When a head is loaded, it sends this flow data (how to calculate flow, as well as how much to prime and unprime (advance and retract) material when transitioning between printing and non-printing moves - and even how many primes or unprimes to do in conjunction with a tool change.


'''Parameters'''
In this way, the very same gcode (with temperature changes) can be used with any material, provided you are using the same physical parameters that the model was sliced for.


  '''Sn''' is the layer thickness in mm for flow calculations
<br>
<hr>


'''Example'''
=== G10 UNUSED<sup>1</sup> ===


  M756 S0.125
G10 is not recognized by Repetrel.  


This command is decoded and executed by the printer as follows:
On some other printers, this will set tool offsets; we do this via '''M6'''.


* '''M756''' (set layer height for flow calculations) 
On some other printers, this will do a retract; we do this via '''M721'''.
** '''S0.125''' (at 0.125mm)


<br>
<br>
<hr>
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
=== G11 UNUSED ===


== '''Controlling Position and Offsets''' ==
G11 is not recognized by Repetrel.


The following commands define if new positioning data is defined in inches (G20) or mm (G21); or from the origin (G90) or from the present location (G91). They also stipulate the offsets from one head to another (M6), and how to invoke that offset (T).
On some other printers, this will do an advance or unretract; we do this via '''M722'''.


=== G10 UNUSED<sup>2</sup> ===
<br>
<hr>


G10 is not recognized by Repetrel.
=== M82 Absolute E-Values ===


On some other printers, this will set tool offsets; we do this via '''M6'''.  
M82 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the original (0) point.


On some other printers, this will do a retract; we do this via '''M721'''.
Note, this only works on v4 and later, when E values are enabled via '''M229'''.
 
=== G20 Set Units to Inches ===
 
G20 declares that henceforth, measurements will be given in inches.
 
'''''Working with G20 is experimental and unsupported on Hyrel equipment. Use at your own risk.'''''


'''Usage'''
'''Usage'''


   G20
   M82


'''Parameters'''
'''Parameters'''
Line 1,490: Line 1,718:
'''Example'''
'''Example'''


  G20
  M82


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G20''' (set units to inches)
* '''M82''' (use absolute E values)


<br>
<br>
<hr>
<hr>


=== G21 Set Units to Millimeters ===
=== M83 Relative E-Values ===
 
M83 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the relative (last used) point.


G21 declares that henceforth, measurements will be given in mm.
Note, this only works on v4 and later, when E values are enabled via '''M229'''.


'''Usage'''
'''Usage'''


   G21
   M83


'''Parameters'''
'''Parameters'''
Line 1,513: Line 1,743:
'''Example'''
'''Example'''


G21
  M83


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G21''' (set units to milimeters)
* '''M83''' (use relative E values)


<br>
<br>
<hr>
<hr>


=== G28 Send X, Y to Physical Home ===
=== M221 Set Flow Rate ===


G28 sends the X and/or Y axes to the sensor-defined physical home position, regardless of logically set 0,0, then pop-off and re-acquire the sensor threshold at a slower rate. This pop-off and re-acquire was implemented during v3.
M221 sends information to the printer about material flow.


After homing, a '''G28''' also resets current offsets to 0 - including any may have been set with a '''G92''' or an H (as defined in an '''M660''' and invoked on a '''G1'''), performs a '''G53''', and applies a head offset of 0 mm (as in an '''M6 O0''').
Note, our default mode is volumetric calculations; if you need to slice with linear calculations, multiply your Pn by approximately 2.4 (you can do the math).
 
Any axis not homed will have its position remain unchanged. We do not support intermediate positioning during homing.


'''Usage'''
'''Usage'''


   G28 Xn Yn Zn An Bn I1
   M221 Pn Sn Wn Zn T#


'''Parameters'''
'''Parameters'''


   '''X0''' ensures that the X axis is homed
   '''Pn''' is the number of pulses on the motor to dispense 1 μl (for volumetric) or 1 mm (for linear) of material;
   '''Y0''' ensures that the Y axis is homed
   '''Sn''' is the direct flow multiplier (to allow for undersized or oversized stock;
   '''Z0''' ensures that the Z axis is homed
   '''Wn''' is the width of the cross section of the volume to fill;
   '''A0''' ensures that the A axis is homed
   '''Zn''' is the height (layer thickness) of the cross section of the volume to fill; and
   '''B0''' ensures that the B axis is homed
   '''T#''' is the tool (head) to which these values will be applied.


'''Example'''
'''Example'''


   G28 X0 Y0
   M221 S1.0 T# P77 W0.5 Z0.3


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G28''' (home axis)
* '''M221''' (set flow rate)
** '''X0''' (X axis to 0)
** '''S1.0''' (flow multiplier of 1.0)
** '''Y0''' (Y axis to 0)
** '''T#''' (target head)  
** (Z remains unchanged)
** '''P77''' (77 pulses per microliter)
** (A remains unchanged)
** '''W0.5''' (0.5mm nozzle)
** (B remains unchanged)
** '''Z0.3''' (0.3mm layer thickness - note that your gcode '''M756''' will overwrite this value)


<br>
<br>
<hr>
<hr>


=== G53 Clear Offsets ===
=== M229 Use E Values ===


G53 sets the fixture offsets to (0,0,0,0,0). This takes no arguments or variables. It does not clear stored offset values.
'''Starting with version 4''', Hyrel will begin to enable the use of E-values in your gcode. Variable extrusion width and support/infill thickness slicers, rejoice! Note, calculations are done for every single move individually.


'''Usage'''
'''Usage'''


   G53
   M229 En Dn Sn


'''Parameters'''
'''Parameters'''


   N/A
   '''En''' can be 0 (native flow calculation) or 1 (use E values)
  '''Dn''' how directed to head; see below
    '''D0''' on head controller directly; constant flow, not adjusted for motion acceleration/deceleration
    '''D1''' on motion controller, sent to head via CANBUS and adjusted for motion acceleration/deceleration
    '''D2''' on motion controller, sent to head via C axis step pin and adjusted for motion acceleration/deceleration
    '''D3''' on motion controller, sent to head via CANBUS and C axis and adjusted for motion acceleration/deceleration
  '''Sn''' sets a threshold in seconds; isolated non-printing moves below this threshold will not trigger unprime/prime actions
 
Note: E1 D0 is an illegal combination.


'''Example'''
'''Example 1'''


G53
  M229 E1 D1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G53''' (set fixture offsets to 0; no effect on H (head) offsets)
* '''M229''' (E values) 
** '''E1''' (enabled)
** '''D1''' (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)


<br>
''Above is the default way to enable E values.''
<hr>


=== G54 - G59 - Set Offsets ===
'''Example 2'''


G54, G55, G56, G57, G58, and G59 will each store and invoke fixture offsets in the X, Y, Z, A, and/or B axes for all subsequent moves. Any values not invoked will remain with their previous value (0 unless earlier specified otherwise). These offsets apply to all positioning until a new offset is applied, or a '''G53''' is used to clear all offsets.
  M229 E0 D0


Note that this differs from an '''M6''', where the offsets are only applied to a SINGLE tool position. These offsets are cumulative with '''M6''' values.
This command is decoded and executed by the printer as follows:


'''Usage'''
* '''M229''' (E values) 
** '''E0''' (disabled) 
** '''D0''' (flow calculations on head controller)


  G54 (... G59) Xn Yn Zn An Bn
''Above is the default way to ignore E values, and is how v3 and earlier releases work.''


'''Parameters'''
'''Example 3'''


   '''Xn''' is the offset in mm in the X axis
   M229 E0 D1
  '''Yn''' is the offset in mm in the Y axis
  '''Zn''' is the offset in mm in the Z axis
  '''An''' is the offset in mm in the A axis
  '''Bn''' is the offset in mm in the B axis
 
'''Example'''
 
G54 X30 Y-20


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G54''' (set units to milimeters)
* '''M229''' (E values)
** '''X30''' (add 30mm to all X positions)
** '''E0''' (disabled)
** '''Y-20''' (subtract 20mm from all Y positions)
** '''D1''' (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)
** (no change to prior stored offsets)


'''Example'''
'''Example 4'''


G55
  M229 E0 D0 S0.02


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G55''' (apply new fixture offsets)
* '''M229''' (E values)
** (no variable: use previous G55 values, or as stored under Settings > Printer > Fixture Offsets)
** '''E0''' (disabled) 
 
** '''D0''' (flow calculations on head controller)
** '''S0.02''' (isolated non-printing moves of under 0.02 seconds will not trigger unprime/prime actions)


<br>
<br>
<hr>
<hr>


=== G90 Absolute Positioning ===
=== M721 Set Unprime Values ===


G90 stipulates that henceforth, the positioning will be calculated from the origin (0,0 point).
M721 sends information to the printer about how much material to unprime when a transition from printing move to non-printing move is detected.


'''Usage'''
'''Usage'''


   G90
   M721 Sn En Pn T# In


'''Parameters'''
'''Parameters'''


   N/A
   '''Sn''' is the speed at which unprime moves should be executed; this is normally 10,000
  '''En''' is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
  '''Pn''' is the number of milliseconds relative to the end of the move to begin the unprime (retract) action; a negative number initiates this before the end of the move
  '''T#''' is the target head
  '''In''' is the flag for executing an Immediate action; so '''M721 I1''' would execute an unprime with the previously specified values at that point in the gcode.
 
'''Example 1'''
 
M721 S10000 E100 P-15 T#
 
This command is decoded and executed by the printer as follows:
 
* '''M721''' (unprime) 
** '''S10000''' (set rate to 10,000 pps) 
** '''E100''' (set pulses to 100) 
** '''P-15''' (set dwell to 15ms before end of print move )
** '''T#''' (on target head)
** (but no immediate execution; execute when needed)


'''Example'''
'''Example 2'''


  G90
  M721 T# I1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G90''' (use absolute positioning)
* '''M721''' (unprime) 
** '''T#''' (on target head)
** '''I1''' (now)


<br>
<br>
<hr>
<hr>


=== G91 Relatative Positioning ===
=== M722 Set Prime Values ===


G91 stipulates that henceforth, the positioning will be calculated relative to the starting position.
M722 sends information to the printer about how much material to prime (advance) when a transition from non-printing move to printing move is detected. This is done primarily to compensate for an earlier unprime (retract), to prep the head to be ready to dispense.


'''Usage'''
'''Usage'''


   G91
   M722 Sn En Pn T# In


'''Parameters'''
'''Parameters'''


   N/A
   '''Sn''' is the speed at which unprime moves should be executed; this is normally 10,000
 
  '''En''' is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
  '''Pn''' is the number of milliseconds to dwell relative to the start of the move to allow for the prime (advance) action
  '''T#''' is the target head
  '''In''' is the flag for executing an Immediate action; so '''M722 I1''' would execute a prime with the previously specified values at that point in the gcode.
 
'''Example'''
 
M722 S10000 E100 P-15 T#
 
This command is decoded and executed by the printer as follows:
 
* '''M721''' (prime) 
** '''S10000''' (set rate to 10,000 pps) 
** '''E100''' (set pulses to 100) 
** '''P-15''' (set dwell to 15ms before end of print move )
** '''T#''' (on target head)
** (but no immediate execution; execute when needed)
 
'''Example'''
'''Example'''


  G91
  M722 T# I1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G91''' (use relative positioning)
* '''M722''' (prime) 
** '''T#''' (on target head)
** '''I1''' (now)


<br>
<br>
<hr>
<hr>


=== G92 Reset Coordinate Offsets ===
=== M723 Set Manual Flow ===
 
M723 tells the designated extruder(s) to advance material for the specified number of pulses (on the motor) at the specified rate, regardless of any X/Y/Z movement. It is normally used only during manual operation, not during gcode execution. It can be used after moving to a location to dispense a set amount of material (like depositing material into reservoirs).
 
M723 is also used to activate and set speed on the stirring apparatus on the DMH dynamic mixing head.


G92 resets the current position to the specified coordinates for all axes enumerated.


'''Usage'''
'''Usage'''


   G92 Xn Yn Zn An Bn En
   M723 Sn En T#


'''Parameters'''
'''Parameters'''


   '''Xn''' is the new value for the current X position
   '''Sn''' is the speed at which the motor should advance, in pulses per second (default: 500);
   '''Yn''' is the new value for the current Y position
   '''En''' is the number of pulses on the feed (extrusion) motor to execute (default of 65535 is essentially "forever");
  '''Zn''' is the new value for the current Z position
   '''T#''' is the target head
  '''An''' is the new value for the current A position
 
  '''Bn''' is the new value for the current B position
'''Example'''
   '''En''' is the new value for the current E position
 
'''Example'''


  G92 X0 Y50
  M723 S500 E50000 T#


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G92''' (replace current values)
* '''M723''' (start manual feed)
** '''X0''' (present X position is 0)
** '''S500''' (at 500 pulses per second)
** '''Y50''' (present Y position is 50)
** '''E50000''' (for 50000 pulses)   
 
** '''T#''' (target head)
'''Example'''
 
  G92 E0
 
This command is decoded and executed by the printer as follows:
 
* '''G92''' (replace current values)
** '''E0''' (present E position is 0)


<br>
<br>
<hr>
<hr>


=== G93 Clear Coordinate Offsets ===
=== M728 Set Motor Current Boost ===


G93 clears ALL offsets implemented via '''G92''' command.
M728 will set the motor current boost; default is 0.


'''Usage'''
'''Usage'''


   G93
   M728 Sn T#


'''Parameters'''
'''Parameters'''


   N/A
   '''Sn''' is the new set temperature in °C
  '''T#''' is the target head (or device)


'''Example'''
'''Example'''


G93
  M728 T# S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G93''' (clear coordinate offset values, all axes)
* '''M728''' (set motor current boost)
 
** '''T#''' (target head)
** '''S0''' (off)
<br>
<br>
<hr>
<hr>


=== M6 Declare Head Offsets ===
=== M756 Set Height for Flow ===


M6 declares that a particular head holds a set of X, Y, and/or Z offsets, which will be invoked during a T (tool change) command. Repetrel reads this data from the heads, and sends it to the printer before the gcode file is loaded.
M756 will overwrite the Z value from the M221 command, allowing you to calculate flow for thinner or thicker layers. We declare M756 at the beginning of every layer; normally, they are all the same (unless you sliced for varying layer thicknesses).  
 
Note: this command is ignored if you are using '''M229 E1 D1''' to enable use of E values.


'''Usage'''
'''Usage'''


   M6 T# On Xn Yn Zn An Bn Dn In Kn
   M756 Sn


'''Parameters'''
'''Parameters'''


   '''T#''' is the Tool position for which these offsets are being set
   '''Sn''' is the layer thickness in mm for flow calculations
  '''On''' is the Offset position where these are being stored
  '''Xn''' is the offset in the X axis
  '''Yn''' is the offset in the Y axis
  '''Zn''' is the offset in the Z axis
  '''An''' is the offset in the A axis
  '''Bn''' is the offset in the B axis
  '''Dn''' is the current tool diameter (used with pocket commands)
  '''In''' non-persistent; can be default 0 (store values but do not move these distances) or 1 (store values and move these distances)
  '''Kn''' persistent setting; can be default 0 (use I value) or 1 (ignore I1 and always act with I0)


'''Example'''
'''Example'''


   M6 T# O1 X20 Y-30 Z40
   M756 S0.125
 
This happens (for every head loaded) when you click print, and the head values are sent to the Motion Controller.


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M6''' (Declare Head Offsets)
* '''M756''' (set layer height for flow calculations)   
** '''T#''' (target head)   
** '''S0.125''' (at 0.125mm)
** '''O1''' (offset stored in register "O1") 
** '''X20''' (X+20)
** '''Y-30''' (Y-30)
** '''Z40''' (Z+40)
** (no change to A)
** (no change to B)
** (no diameter change)
** (no move)


'''Example'''
<br>
<hr>


  M6 T# O1 X20 Y-30 Z40 I1
'''[[#What_is_GCode.3F|Back to top]]'''


This happens when you execute a tool change with '''T#''', and so it triggers the move ('''I1''') to properly position the next head.
== '''Controlling Position and Offsets''' ==


This command is decoded and executed by the printer as follows:
{| border="1" class="wikitable" style="float:right"
 
! colspan="3" | Controlling Position and Offsets
* '''M6''' (Declare Head Offsets)
|-
** '''T#''' (target head) 
! Code
** '''O1''' (offset stored in register "O1") 
! Supported
** '''X20''' (X+20)
! Brief Description
** '''Y-30''' (Y-30)
|-
** '''Z40''' (Z+40)
! [[#G10_UNUSED|G10]]
** (no change to A)
| ''No'' || ''Set Offsets''
** (no change to B)
|-
** (no diameter change)
! [[#G20_Set_Units_to_Inches|G20]]
** (store and move distances)
| Yes || Set Units to Inches
 
|-
'''Example'''
! [[#G21_Set_Units_to_Milimeters|G21]]
 
| Yes || Set Units to Milimeters
  M6 K1
|-
 
! [[#G28_Send_to_Physical_Home|G28]]
You might include this in your header to change behavior during tool changes.
| Yes || Send to Physical Home
 
|-
This command is decoded and executed by the printer as follows:
! [[#G53_Clear_Offsets|G53]]
| Yes || Clear Offsets
|-
! [[#G54_-_G59_-_Set_Offsets|G54-59]]
| Yes || Set Offsets
|-
! [[#G90_Absolute_Positioning|G90]]
| Yes || Absolute Positioning
|-
! [[#G91_Relatative_Positioning|G91]]
| Yes || Relatative Positioning
|-
! [[#G92_Reset_Coordinate_Offsets|G92]]
| Yes || Reset Coordinates
|-
! [[#G93_Clear_Coordinate_Offsets|G93]]
| Yes || Reset Coordinates
|-
! [[#M6_Declare_Head_Offsets|M6]]
| Yes || Declare Head Offsets
|-
! [[#M660_Assign_Tool_Height_Offset|M660]]
| Yes || Set Tool Offsets
|-
! [[#M702_-_M704_Cloning_Heads|M702-4]]
| Yes || Cloning Heads
|-
|}


* '''M6''' (Declare Head Offsets)  
The following commands define if new positioning data is defined in inches (G20) or mm (G21); or from the origin (G90) or from the present location (G91). They also stipulate the offsets from one head to another (M6), and how to invoke that offset (T).
** (all future T# or M6 commands)
** (no offset registers, so ignore all offsets)
** '''K1''' (always force I0 with M6 unless K0 present (or has been previously set)


Note that this differs from a G54-G59, where the offsets are applied to EVERY tool position.
=== G10 UNUSED<sup>2</sup> ===


<br>
G10 is not recognized by Repetrel.
<hr>


=== M660 Assign Tool Height Offset ===
On some other printers, this will set tool offsets; we do this via '''M6'''.


Used with the High Resolution Engine (and other units which home away from O, like a CNC), an M660 declares that a particular head, when called upon, should print at the gcode-based Z position MODIFIED by this offset, since on these units, the Z-Zero is often BELOW the print surface. By default, this is ONLY used on the EHR (Engine, High Resolution)
On some other printers, this will do a retract; we do this via '''M721'''.


NOTE: You MUST have a '''G28 Z0''' in your header to run this M660 on the EHR.
=== G20 Set Units to Inches ===
 
G20 declares that henceforth, measurements will be given in inches.
 
'''''Working with G20 is experimental and unsupported on Hyrel equipment. Use at your own risk.'''''


'''Usage'''
'''Usage'''


   M660 Hn Zn
   G20
  (followed by)
  G1 Xn Yn Zn Fn Hn (see '''[[#G1_Working_Move]]''' for other details


'''Parameters'''
'''Parameters'''


   '''H''' is the head offset registern for which these offsets are being set;
   N/A
  '''Z''' is the offset in the Z axis in mm.


'''Example 1'''
'''Example'''


  M660 H2 Z28.2      ; (specified before any moves)
G20
  (followed by)
  G1 X50 Y75 F4800 H2  ; (specified on the first G1 move)


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M660''' (apply offset)
* '''G20''' (set units to inches)
** '''H2''' (store in register 2)
** '''Z28.2''' (+28.2 to Z position)
* (there may be more commands before the G1 move invoking the H2)
* '''G1''' (working speed straight line move from the current location to)
** '''X50''' (50mm in the X)
** '''Y75''' (75mm in the Y)
** (no change in Z)
** '''E1''' (while extruding)
** '''F1800''' (moving at 1800mm/min)
** '''H2''' (invoke offsets stored in register H2)


To be clear, this requires editing two lines of code:
<br>
<hr>


In your gcode, you will enter the M660 just before the first layer code. Example: <code>M660 H2 Z28.2 ; set tool height for tool two (Z offset)</code>. On the first move of layer one (usually the Z move), you will add an <code>H</code> value so that this tool height is invoked.
=== G21 Set Units to Millimeters ===


'''Example 2'''
G21 declares that henceforth, measurements will be given in mm.


Before editing:
'''Usage'''


   G1 Z0.275 F360      ; move to next layer (0)
   G21
  (followed by)
  G1 X50 Y75 F4800


After editing:
'''Parameters'''


   G1 Z0.275 F360 '''H2'''  ; move to next layer (0) and invoke head Z offset for this tool</code>
   N/A
  (followed by)
  G1 X50 Y75 F4800 '''H2'''


<br>
'''Example'''
<hr>


=== M702 - M704 Cloning Heads ===
G21


Clone, slave, or parallel printing, is when multiple heads make the ''exact same print'' at the same time.
This command is decoded and executed by the printer as follows:


Usage of these commands with version 4 and earlier is explained on '''[[T_v4]]'''.
* '''G21''' (set units to milimeters)
 
Usage of these commands with version 5 and later is explained on '''[[T_v5]]'''.


<br>
<br>
<hr>
<hr>


=== T Tool Change===
=== G28 Send to Physical Home ===


T executes a tool change, invoking the parameters specified in the M6 sent from Repetrel to the printer at the job start. Do not confuse a T command with a T variable.
G28 sends the specified axes to the sensor-defined physical home position, regardless of logically set 0,0, then pop-off and re-acquire the sensor threshold at a slower rate. This pop-off and re-acquire was implemented during v3.


'''See the first entry on this page for details. '''
After homing, a '''G28''' also resets current offsets to 0 - including any may have been set with a '''G92''' or an H (as defined in an '''M660''' and invoked on a '''G1'''), performs a '''G53''', and applies a head offset of 0 mm (as in an '''M6 O0''').


'''[[#What_is_GCode.3F|Back to top]]'''
Any axis not homed will have its position remain unchanged. We do not support intermediate positioning during homing.


== '''Lasers and UV Pens''' ==
'''Usage'''


The CO<sub>2</sub> and Diode Lasers and the UV Pens require the following enabling codes:
  G28 Xn Yn Zn An Bn I1


=== M620 Enable Device ===
'''Parameters'''


M620 enables the device.
  '''X0''' ensures that the X axis is homed
  '''Y0''' ensures that the Y axis is homed
  '''Z0''' ensures that the Z axis is homed
  '''A0''' ensures that the A axis is homed
  '''B0''' ensures that the B axis is homed


'''Usage'''
'''Example'''


   M620 T# En An
   G28 X0 Y0
 
'''Parameters'''
 
  '''T#''' is the tool position
  '''En''' can be the default 0 (disable) or 1 (enable)
  '''An''' is the duration in seconds after shut-off that the cooling remains active; default is 30 (but this will not override temperature safety measures)
 
'''Example'''
 
  M620 T# E1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M620''' (enable device)  
* '''G28''' (home axis)
** '''T#''' (target head - MUST be specified, can NOT be inherited)
** '''X0''' (X axis to 0)
** '''E1''' (enable)
** '''Y0''' (Y axis to 0)
** (Z remains unchanged)
** (A remains unchanged)
** (B remains unchanged)


<br>
<br>
<hr>
<hr>


=== M621 Set Laser Power ===
=== G53 Clear Offsets ===


M621 sets the power for the LASER (not other heads).
G53 sets the fixture offsets to (0,0,0,0,0). This takes no arguments or variables. It does not clear stored offset values.


'''Usage'''
'''Usage'''


   M621 Dn Pn
   G53


'''Parameters'''
'''Parameters'''


   '''Pn''' is the power, in a value between 0 (min) and 100 (max).
   N/A
  '''Dn''' is the initial power (similar to a prime) to penetrate material (optional; uses Pn if unspecified)
 
Note: No tool is specified; this will happen on the laser already enabled with M620.


'''Example'''
'''Example'''


  M621 P40
G53


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M621''' (activate device)
* '''G53''' (set fixture offsets to 0; no effect on H (head) offsets)
** '''P40''' (at 40% during "printing" (E-value) moves)


<br>
<br>
<hr>
<hr>


=== M623 Duration Emit ===
=== G54 - G59 - Set Offsets ===


M623 sets the power for the laser or UV pen, and takes the following parameters:
G54, G55, G56, G57, G58, and G59 will each store and invoke fixture offsets in the X, Y, Z, A, and/or B axes for all subsequent moves. Any values not invoked will remain with their previous value (0 unless earlier specified otherwise). These offsets apply to all positioning until a new offset is applied, or a '''G53''' is used to clear all offsets.
 
This graphic shows how printers (OTHER THAN THE EHR) use the G54-G59 offsets:
 
[[File:G54.png|600px]]
 
Note that this differs from an '''M6''', where the offsets are only applied to a SINGLE tool position. These offsets are cumulative with '''M6''' values.


'''Usage'''
'''Usage'''


   M623 Dn Pn
   G54 (... G59) Xn Yn Zn An Bn


'''Parameters'''
'''Parameters'''


   '''Dn''' is the duration, in miliseconds (only used for static exposures, not during moves)
   '''Xn''' is the offset in mm in the X axis
   '''Pn''' is the power, in a value between 0 (min) and 100 (max).
  '''Yn''' is the offset in mm in the Y axis
   '''Zn''' is the offset in mm in the Z axis
  '''An''' is the offset in mm in the A axis
  '''Bn''' is the offset in mm in the B axis


Note: Dn max for UV pens is 60,000 (1 minute); Dn max for other devices 1,000 (1 second);
'''Example'''


Here are examples:
G54 X30 Y-20


  M623 P80 D500
This command is decoded and executed by the printer as follows:


This command is decoded and executed by the printer as follows:
* '''G54''' (set units to milimeters)
** '''X30''' (add 30mm to all X positions)
** '''Y-20''' (subtract 20mm from all Y positions)
** (no change to prior stored offsets)


* '''M623''' (activate tool)
'''Example'''
** '''P80''' (power 80%)
** '''D500''' (duration 500 miliseconds)


  M623 P80 D10000
G55


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M623''' (activate tool)
* '''G55''' (apply new fixture offsets)
** '''P80''' (power 80%)
** (no variable: use previous G55 values, or as stored under Settings > Printer > Fixture Offsets)
** '''D10000''' (duration 10 seconds)


=== Laser Examples ===


A sample of code for lasering will look like this:
<br>
<hr>


  G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
=== G90 Absolute Positioning ===
  M620 T# E1          ; enable target device
  M621 P100          ; set light emission in vector mode (slot 3) to full power (100%)
  T#                  ; toolchange to target head
  G1 X120 Y100 E1    ; emitting (printing) move 20mm from origin in X axis
  G1 X120 Y120 E1    ; emitting (printing) move 20mm from origin in Y axis
  G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
  G1 X140 Y130 E1    ; emitting move 20mm from origin in X axis
 
  ... (the rest of your lasering job)
 
  M620 T# E0          ; disable target device <= should be before M30 command


=== UV Pen Examples ===
G90 stipulates that henceforth, the positioning will be calculated from the origin (0,0 point).


A sample of code for UV Curing will look like this:
'''Usage'''


   G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
   G90
  M620 T# E1        ; enable target device
  M621 P100          ; set light emission in vector mode (slot 3) to full power (100%)
  T#                  ; toolchange to target head
  G1 X120 Y100 E1    ; emitting (printing) move 20mm from origin in X axis
  G1 X120 Y120 E1    ; emitting (printing) move 20mm from origin in Y axis
  G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
  G1 X140 Y130 E1    ; emitting move 20mm from origin in X axis
 
  ... (the rest of your curing job)
 
  M620 T# E0        ; disable target device <= should be before M30 command


For more complex examples, see the '''[[UV_and_Clench]]''' page.
'''Parameters'''


'''[[#What_is_GCode.3F|Back to top]]'''
  N/A


== '''Spindles and Lathes''' ==
'''Example'''


Machining and Spindle Tool commands. Note, we recommend using [http://mr-soft.net/ SimplyCAM].
G90


You can review the 5-axis gcode we used for [https://www.youtube.com/watch?v=B0lvN-aPYHI this video] from [http://hyrel3d.net/downloads/gcode/Ardes_tube_cap_milling.gcode here].
This command is decoded and executed by the printer as follows:


=== M3 Turn On Spindle (CW) ===
* '''G90''' (use absolute positioning)
 
<br>
<hr>
 
=== G91 Relatative Positioning ===


M3 tells the printer to activate (start) the spindle motor in the clockwise direction on the current head (if it has one), using the value set on the head for RPM. Note: S0 is the same as turning it off. Note: DO NOT CHANGE DIRECTION while the spindle is in motion.
G91 stipulates that henceforth, the positioning will be calculated relative to the starting position.


'''Usage'''
'''Usage'''


   M3 T# Sn Fn
   G91


'''Parameters'''
'''Parameters'''


   '''T#''' - target head
   N/A
  '''Sn''' - power (0-100%)
  '''Fn''' - optional; PWM in Hz (defaults on heads should be fine for most uses)


'''Example'''
'''Example'''


  M3 T# S75
G91


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M3''' (activate spindle clockwise)
* '''G91''' (use relative positioning)
** '''T#''' (target head)
** '''S75''' (at 75% power)
** (default PWM)


<br>
<br>
<hr>
<hr>


=== M4 Turn On Spindle (CCW) ===
=== G92 Reset Coordinate Offsets ===


Please refer to M3, above, for details. All options are identical, with the exception of direction (counterclockwise).
G92 resets the current position to the specified coordinates for all axes enumerated.  
 
<br>
<hr>
 
===  M5 Turn Off Spindle ===
 
M5 tells the printer to deactivate (stop) the spindle motor on the current head (if it has one). M5 has the same effect as M3 S0 or M4 S0.


'''Usage'''
'''Usage'''


   M5 T#
   G92 Xn Yn Zn An Bn En


'''Parameters'''
'''Parameters'''


   '''T#''' - target head
   '''Xn''' is the new value for the current X position
 
  '''Yn''' is the new value for the current Y position
  '''Zn''' is the new value for the current Z position
  '''An''' is the new value for the current A position
  '''Bn''' is the new value for the current B position
  '''En''' is the new value for the current E position
 
'''Example'''
 
G92 X0 Y50
 
This command is decoded and executed by the printer as follows:
 
* '''G92''' (replace current values)
** '''X0''' (present X position is 0)
** '''Y50''' (present Y position is 50)
 
'''Example'''
'''Example'''


  M5 T#
G92 E0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M3''' (deactivate spindle )
* '''G92''' (replace current values)
** '''T#''' (target head)
** '''E0''' (present E position is 0)


<br>
<br>
<hr>
<hr>


=== M253 Turn On Lathe (CW) ===
=== G93 Clear Coordinate Offsets ===


M253 tells the printer to activate (start) the lathe motor in the clockwise direction (if it has one), using the value set with M92 for RPM. Only available on Hydra 16A models.
G93 clears ALL offsets implemented via '''G92''' command.
 
Note: S0 is the same as turning it off.  


'''Usage'''
'''Usage'''


   M253 Sn
   G93


'''Parameters'''
'''Parameters'''


   '''Sn''' - speed in units per minute (default: RPM if set with M92 as steps per revolution)
   N/A


'''Example'''
'''Example'''


  M253 S75
G93


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M253''' (activate spindle clockwise)
* '''G93''' (clear coordinate offset values, all axes)
** '''S75''' (at 75 RPM)  


<br>
<br>
<hr>
<hr>


=== M254 Turn On Lathe (CCW) ===
=== M6 Declare Head Offsets ===


Please refer to M253, above, for details. All options are identical, with the exception of direction (counterclockwise).
M6 declares that a particular head holds a set of X, Y, and/or Z offsets, which will be invoked during a T (tool change) command. Repetrel reads this data from the heads, and sends it to the printer before the gcode file is loaded.
 
<br>
<hr>
 
===  M255 Turn Off Lathe ===
 
M255 tells the printer to deactivate (stop) the lathe motor (if it has one). M255 has the same effect as G253 S0 or G254 S0.


'''Usage'''
'''Usage'''


   M255
   M6 T# On Xn Yn Zn An Bn Dn In Kn


'''Parameters'''
'''Parameters'''


   N/A
   '''T#''' is the Tool position for which these offsets are being set
  '''On''' is the Offset position where these are being stored
  '''Xn''' is the offset in the X axis
  '''Yn''' is the offset in the Y axis
  '''Zn''' is the offset in the Z axis
  '''An''' is the offset in the A axis
  '''Bn''' is the offset in the B axis
  '''Dn''' is the current tool diameter (used with pocket commands)
  '''In''' non-persistent; can be default 0 (store values but do not move these distances) or 1 (store values and move these distances)
  '''Kn''' persistent setting; can be default 0 (use I value) or 1 (ignore I1 and always act with I0)


'''Example'''
'''Example'''


   M255
   M6 T# O1 X20 Y-30 Z40
 
This happens (for every head loaded) when you click print, and the head values are sent to the Motion Controller.


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M255''' (deactivate lathe)
* '''M6''' (Declare Head Offsets)
** '''T#''' (target head) 
** '''O1''' (offset stored in register "O1") 
** '''X20''' (X+20)
** '''Y-30''' (Y-30)
** '''Z40''' (Z+40)
** (no change to A)
** (no change to B)
** (no diameter change)
** (no move)


<br>
'''Example'''
<hr>


===  G81 Peck Drilling ===
  M6 T# O1 X20 Y-30 Z40 I1


G81 tells the printer to move to a start position in X/Y and then in Z, and to make (if needed) repeated descents and retracts. This is used to make holes, especially deep holes. Note that the spindle tool is turned on with an M3 or M4 before this command, and turned off with an M5 after all work is done.
This happens when you execute a tool change with '''T#''', and so it triggers the move ('''I1''') to properly position the next head.


'''Usage'''
This command is decoded and executed by the printer as follows:


  G81 T# Xn Yn In Pn Qn Zn Fn
* '''M6''' (Declare Head Offsets)
 
** '''T#''' (target head
'''Parameters'''
** '''O1''' (offset stored in register "O1") 
 
** '''X20''' (X+20)
  '''T#''' - target head
** '''Y-30''' (Y-30)
  '''Xn''' - X position
** '''Z40''' (Z+40)
  '''Yn''' - Y position
** (no change to A)
  '''In''' - initial Z position
** (no change to B)
  '''Pn''' - peck downward this many mm during each cycle
** (no diameter change)
  '''Qn''' - retract upward this many mm after each cycle (to clear debris)
** (store and move distances)
  '''Zn''' - maximum pecking depth
  '''Fn''' - Z working speed in mm/min


'''Example'''
'''Example'''


   G81 T# X100 Y75 I3 P3 Q-2 Z-7.5 F200
   M6 K1


''NOTE that an M660 offset must be set and applied BEFORE THIS COMMAND to allow for tool length.''
You might include this in your header to change behavior during tool changes.


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''G81''' (begin pecking cycle)  
* '''M6''' (Declare Head Offsets)  
** '''X100 Y75''' (move to X/Y starting position X100 Y75)  
** (all future T# or M6 commands)
** '''I3''' (move to Z starting position Z3, which will be our greatest retract height)  
** (no offset registers, so ignore all offsets)
** '''P3''' (peck downward an additional 3mm at a time)
** '''K1''' (always force I0 with M6 unless K0 present (or has been previously set)
** '''Q-2''' (retract upward 2mm after each peck (to clear debris))
 
** '''Z-7.5''' (peck to a maximum depth of 7.5mm)
Note that this differs from a G54-G59, where the offsets are applied to EVERY tool position.
** '''F200''' (working (drilling) travel speed of 200 mm/min)
** ''after this, the head will retract up to the I position (Z3 in this case) before moving on to the next line''


<br>
<br>
<hr>
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
=== M660 Assign Tool Height Offset ===


== '''Reporting and Diagnostics''' ==
Used with the High Resolution Engine (and other units which home away from O, like a CNC), an M660 declares that a particular head, when called upon, should print at the gcode-based Z position MODIFIED by this offset, since on these units, the Z-Zero is often BELOW the print surface. By default, this is ONLY used on the EHR (Engine, High Resolution)


The following commands help with reporting and diagnostics. Most users never need them, but here are the basics. More advanced/detailed reporting is available.
NOTE: You MUST have a '''G28 Z0''' in your header to run this M660 on the EHR.
 
=== M701 Set Head Reporting ===
 
M701 tells heads how often to send head-specific information to the Motion Controller and on to Repetrel (and pass along to a text file if enabled via M719).


'''Usage'''
'''Usage'''


   M701 T# Pn
   M660 Hn Zn
  (followed by)
  G1 Xn Yn Zn Fn Hn (see '''[[#G1_Working_Move]]''' for other details


'''Parameters'''
'''Parameters'''


   '''T#''' - target head
   '''H''' is the head offset registern for which these offsets are being set;
   '''Pn''' - period in seconds between entries (default 1)
   '''Z''' is the offset in the Z axis in mm.


'''Example'''
'''Example 1'''


   M701 P12
   M660 H2 Z28.2      ; (specified before any moves)
  (followed by)
  G1 X50 Y75 F4800 H2  ; (specified on the first G1 move)


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M701''' (head reporting)  
* '''M660''' (apply offset)  
** (currently active head)
** '''H2''' (store in register 2)
** '''P12''' (every 12 seconds)
** '''Z28.2''' (+28.2 to Z position)
 
* (there may be more commands before the G1 move invoking the H2)
<br>
* '''G1''' (working speed straight line move from the current location to)  
<hr>
** '''X50''' (50mm in the X)  
** '''Y75''' (75mm in the Y)
** (no change in Z)
** '''E1''' (while extruding)
** '''F1800''' (moving at 1800mm/min)
** '''H2''' (invoke offsets stored in register H2)
 
To be clear, this requires editing two lines of code:
 
In your gcode, you will enter the M660 just before the first layer code. Example: <code>M660 H2 Z28.2 ; set tool height for tool two (Z offset)</code>. On the first move of layer one (usually the Z move), you will add an <code>H</code> value so that this tool height is invoked.


=== M718 Stop Logging to File ===
'''Example 2'''


M718 tells Repetrel to stop any logging of data to text file that may have been enabled with M719.
Before editing:


'''Usage'''
  G1 Z0.275 F360      ; move to next layer (0)
  (followed by)
  G1 X50 Y75 F4800


  M718
After editing:


'''Parameters'''
  G1 Z0.275 F360 '''H2'''  ; move to next layer (0) and invoke head Z offset for this tool</code>
  (followed by)
  G1 X50 Y75 F4800 '''H2'''


  N/A
<br>
<hr>


'''Example'''
=== M702 - M704 Cloning Heads ===


  M718
Clone, slave, or parallel printing, is when multiple heads make the ''exact same print'' at the same time.


This command is decoded and executed by the printer as follows:
Usage of these commands with version 4 and earlier is explained on '''[[T_v4]]'''.


* '''M718''' (logging off)
<span style="color:darkorange;">Usage of these commands with version 5 and later is explained on '''[[T_v5]]'''.


<br>
<br>
<hr>
<hr>


=== M719 Start Logging to File ===
=== T Tool Change===


M719 tells the Motion Controller what system-wide information to report back to Repetrel, and also tells Repetrel to begin logging these details to a text file.
T executes a tool change, invoking the parameters specified in the M6 sent from Repetrel to the printer at the job start. Do not confuse a T command with a T variable.


'''Usage'''
'''See the first entry on this page for details. '''


  M719 Pn Sn
<br>
 
<hr>
  M719 Pn Xn Yn Zn An Bn Vn En Ln


'''Parameters'''
'''[[#What_is_GCode.3F|Back to top]]'''


  '''Pn''' - period in seconds between entries
== '''Controlling Lasers and UV Pens''' ==
  '''Sn''' - can be default 0 (see options below) or 1 (report ALL data)
  '''Xn''' - report X position with each entry
  '''Yn''' - report Y position with each entry
  '''Zn''' - report Z position with each entry
  '''An''' - report A position with each entry
  '''Bn''' - report B position with each entry
  '''Vn''' - report velocity with each entry
  '''En''' - report flow rate with each entry
  '''Ln''' - report gcode line number with each entry


Note: these values are persistent, and if previously enabled, will still be enabled unless disabled with a 0 parameter.
{| border="1" class="wikitable" style="float:right"
! colspan="3" | Controlling Lasers and UV Pens
|-
! Code
! Supported
! Brief Description
|--
! [[#M620_Enable_Device|M620]]
| Yes || Enable Device
|-
! [[#M621_Set_Laser_Power|M621]]
| Yes || Set Laser Power
|-
! [[#M623_Duration_Emit|M623]]
| Yes || Duration Emit
|-
| colspan="3" | [[#Laser_Examples|Laser Examples]]
|-
| colspan="3" | [[#UV_Pen_Examples|UV Pen Examples]]
|}


'''Example 1'''


  M719 P10 S1
The CO<sub>2</sub> and Diode Lasers and the UV Pens require the following enabling codes:


This command is decoded and executed by the printer as follows:
=== M620 Enable Device ===


* '''M719''' (logging on)
M620 enables the device.
** '''P10''' (every 10 seconds)
** '''S1''' (report everything)


'''Example 2'''
'''Usage'''


   M719 P.1 Xn Yn Zn Ln
   M620 T# En An


* '''M719''' (logging on)
'''Parameters'''
** '''P.1''' (every 0.1 seconds)
** '''X1''' (report X position)
** '''Y1''' (report Y position)
** '''Z1''' (report Z position)
** (don't report A position)
** (don't report B position)
** (don't report velocity)
** (don't report flow rate)
** '''L1''' (report line number)


<br>
  '''T#''' is the tool position
<hr>
  '''En''' can be the default 0 (disable) or 1 (enable)
  '''An''' is the duration in seconds after shut-off that the cooling remains active; default is 30 (but this will not override temperature safety measures)


=== M670 Enable Gantry / Y-arm Light ===
'''Example'''


M670 sets the intensity of the Y-arm LEDs.
  M620 T# E1


'''Usage'''
This command is decoded and executed by the printer as follows:


  M670 Sn Pn
* '''M620''' (enable device)
** '''T#''' (target head - MUST be specified, can NOT be inherited)
** '''E1''' (enable)


'''Parameters'''
<br>
<hr>


  '''Sn''' is the (percent of duty cycle, 0-100) for the LEDs
=== M621 Set Laser Power ===
  '''Pn''' is the period (on-off interval - default is 1 second)
 
M621 sets the power for the LASER (not other heads).


'''Example 1'''
'''Usage'''


   M670 S50 P1
   M621 Dn Pn


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M670''' (enable Y-arm light)
  '''Pn''' is the power, in a value between 0 (min) and 100 (max).
** '''S50''' (50% duty cycle)
  '''Dn''' is the initial power (similar to a prime) to penetrate material (optional; uses Pn if unspecified)
** '''P1''' (1 second cycle)


This would turn the Y-arm light on for 50% of 1 second, then off for 50% of 1 second - or on for 0.5 seconds, off for 0.5 seconds.
Note: No tool is specified; this will happen on the laser already enabled with M620.


'''Example 2'''
'''Example'''


   M670 S25 P4
   M621 P40


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M670''' (enable Y-arm light)
* '''M621''' (activate device)  
** '''S25''' (25% duty cycle)
** '''P40''' (at 40% during "printing" (E-value) moves)
** '''P4''' (4 second cycle)
 
This would turn the Y-arm light on for 25% of 4 second, then off for 75% of 4 seconds - or on for 1 second, off for 3 seconds.


<br>
<br>
<hr>
<hr>


=== M672 Set Gantry / Y-arm State ===


M672 can be used to have the Gantry / Y-arm light change states to reflect the state of a sensor. For example, you can have it come on when the X axis is homed, or when the Y axis has a fault.
=== M623 Duration Emit ===
 
M623 sets the power for the laser or UV pen, and takes the following parameters:


'''Usage'''
'''Usage'''


   M672 Sn
   M623 Dn Pn


'''Parameters'''
'''Parameters'''


   '''Sn''' can be (unlisted numbers are unused at present):
   '''Dn''' is the duration, in miliseconds (only used for static exposures, not during moves)
        '''0''' : Normal on/off
  '''Pn''' is the power, in a value between 0 (min) and 100 (max).
        '''10''' : X Home
 
        '''11''' : X Limit1
Note: Dn max for UV pens is 60,000 (1 minute); Dn max for other devices 1,000 (1 second);
        '''12''' : X Limit2
        '''13''' : X Fault
        '''20''' : Y Home
        '''21''' : Y Limit1
        '''22''' : Y Limit2
        '''23''' : Y Fault
        '''30''' : Z Home
        '''31''' : Z Limit1
        '''32''' : Z Limit2
        '''33''' : Z Fault
        '''40''' : A Home
        '''41''' : A Limit1
        '''42''' : A Limit2
        '''43''' : A Fault
        '''50''' : B Home
        '''11''' : B Limit1
        '''52''' : B Limit2
        '''53''' : B Fault
        '''60''' : C Home
        '''61''' : C Limit1
        '''62''' : C Limit2
        '''63''' : C Fault


'''Example'''
Here are examples:


   M672 S
   M623 P80 D500


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M672''' (map Y-arm light to state of sensor)
* '''M623''' (activate tool)
** '''P80''' (power 80%)
** '''D500''' (duration 500 miliseconds)


<br>
  M623 P80 D10000
<hr>


=== M772 Reset All Metrics ===
This command is decoded and executed by the printer as follows:


M772 will reset all internal gathering registers to '''0'''.
* '''M623''' (activate tool) 
** '''P80''' (power 80%)
** '''D10000''' (duration 10 seconds)


'''Usage'''
=== Laser Examples ===


  M772 Sn
A sample of code for lasering will look like this:


'''Parameters'''
  G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
  M620 T# E1          ; enable target device
  M621 P100          ; set light emission in vector mode (slot 3) to full power (100%)
  T#                  ; toolchange to target head
  G1 X120 Y100 E1    ; emitting (printing) move 20mm from origin in X axis
  G1 X120 Y120 E1    ; emitting (printing) move 20mm from origin in Y axis
  G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
  G1 X140 Y130 E1    ; emitting move 20mm from origin in X axis
 
  ... (the rest of your lasering job)
 
  M620 T# E0          ; disable target device <= should be before M30 command


  '''Sn''' 0 is default; S can be...
=== UV Pen Examples ===
      '''0''' reset all values only
      '''1''' also generates a basic printing report
      '''255''' also generates all possible reports (helpful for advanced debugging)


'''Example'''
A sample of code for UV Curing will look like this:


   M772 S1
   G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
 
  M620 T# E1        ; enable target device
This command is decoded and executed by the printer as follows:
  M621 P100          ; set light emission in vector mode (slot 3) to full power (100%)
 
  T#                  ; toolchange to target head
* '''M772''' (reset all metrics)
  G1 X120 Y100 E1    ; emitting (printing) move 20mm from origin in X axis
** '''S1''' (and generate basic printing report
  G1 X120 Y120 E1    ; emitting (printing) move 20mm from origin in Y axis
  G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
  G1 X140 Y130 E1    ; emitting move 20mm from origin in X axis
 
  ... (the rest of your curing job)
 
  M620 T# E0        ; disable target device <= should be before M30 command
 
For more complex examples, see the '''[[UV_and_Clench]]''' page.


<br>
<br>
<hr>
<hr>


=== M773 Generate Basic Report ===
'''[[#What_is_GCode.3F|Back to top]]'''


M773 generates a basic report of printing statistics (including average speed, number of primes, etc.)
== '''Controlling Spindles and Lathes''' ==


Note: this report will be more meaningful if you use '''M772''' to reset these counters at the start of a job.
{| border="1" class="wikitable" style="float:right"
 
! colspan="3" | Controlling Spindles and Lathes
'''Usage'''
|-
 
! Code
  M773
! Supported
 
! Brief Description
'''Parameters'''
|-
 
! [[#M3_Turn_On_Spindle_.28CW.29|M3]]
  N/A
| Yes || Spindle On CW
 
|-
'''Example'''
! [[#M4_Turn_On_Spindle_.28CCW.29R|M4]]
 
| Yes || Spindle On CCW
  M773
|-
! [[#M5_Turn_Off_Spindle|M5]]
| Yes || Spindle Off
|-
! [[#M253_Turn_On_Lathe_.28CW.29|M253]]
| Yes || Turn On Lathe (CW)
|-
! [[#M254_Turn_On_Lathe_.28CCW.29|M254]]
| Yes || Turn On Lathe (CCW)
|-
! [[#M255_Turn_Off_Lathe|M255]]
| Yes || Turn Off Lathe
|-
! [[#G81_Peck_Drilling|G81]]
| G81 || Peck Drilling
|-
|}
 
Machining and Spindle Tool commands. Note, we recommend using [http://mr-soft.net/ SimplyCAM].
 
You can review the 5-axis gcode we used for [https://www.youtube.com/watch?v=B0lvN-aPYHI this video] from [http://hyrel3d.net/downloads/gcode/Ardes_tube_cap_milling.gcode here].
 
=== M3 Turn On Spindle (CW) ===
 
M3 tells the printer to activate (start) the spindle motor in the clockwise direction on the current head (if it has one), using the value set on the head for RPM. Note: S0 is the same as turning it off. Note: DO NOT CHANGE DIRECTION while the spindle is in motion.


This command is decoded and executed by the printer as follows:
'''Usage'''


* '''M773''' (generate basic report)
  M3 T# Sn Fn


'''Sample Output'''
'''Parameters'''


   >IN:  50: ******************************************************************
   '''T#''' - target head
   >IN:  50: **  Begin M773 - print job metrics Report
   '''Sn''' - power (0-100%)
  >IN:  50: ******************************************************************
   '''Fn''' - optional; PWM in Hz (defaults on heads should be fine for most uses)
  >IN:  50:
  >IN:  50:                      Time (s)    Dist (m)
  >IN:  50:                      --------    --------
  >IN:  50: Totals:                    0.0      0.000
  >IN:  50:
  >IN:  50: Printing moves:            0.0      0.000
  >IN:  50: Non-printing moves        0.0      0.000
  >IN:  50:
  >IN:  50: Accelerating:              0.0      0.000
  >IN:  50: Cruising:                  0.0      0.000
  >IN:  50: Decelerating:              0.0      0.000
  >IN:  50:
  >IN:  50: can e steps issued:      0
  >IN:  50: approx filament (PI*d)   0.000 m
   >IN:  50: approx filament (PIr^2)   0.000 m
  >IN:  50: unprimes issued:          0
  >IN:  50: primes issued:            0
  >IN:  50: unprime-primes avoided:  0
  >IN:  50:
  >IN:  50: ******************************************************************
  >IN:  50: **  End M773 Report
  >IN:  50: ******************************************************************


<br>
'''Example'''
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
  M3 T# S75


== '''Controlling Aux Devices''' ==
This command is decoded and executed by the printer as follows:


Individual port control commands.
* '''M3''' (activate spindle clockwise)
** '''T#''' (target head)
** '''S75''' (at 75% power)
** (default PWM)


=== M7 Activate Aux 1 ===
<br>
<hr>


[[File:M7m8m9_ehr.jpg|thumb|12VDC Ports on EHR|right]]
=== M4 Turn On Spindle (CCW) ===


[[File:M7m8m9_30m_esr.jpg|thumb|12VDC Ports on 30M, ESR|right]]
Please refer to M3, above, for details. All options are identical, with the exception of direction (counterclockwise).


M7 sends 12VDC to the port associated with "Mist Coolant", which we sometimes call Aux1. With no parameters, it is read as M7 S100 (on continuously).  
<br>
<hr>
 
===  M5 Turn Off Spindle ===
 
M5 tells the printer to deactivate (stop) the spindle motor on the current head (if it has one). M5 has the same effect as M3 S0 or M4 S0.


'''Usage'''
'''Usage'''


   M7 Sn
   M5 T#


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100) for Aux 1 to come on (default is 100)
   '''T#''' - target head


'''Example 1'''
'''Example'''


   M7 S100
   M5 T#


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M7''' (Aux1 value)  
* '''M3''' (deactivate spindle )
** '''S21100''' (set to 100%)
** '''T#''' (target head)


'''Example 2'''
<br>
<hr>


  M7 S25
=== M253 Turn On Lathe (CW) ===


This command is decoded and executed by the printer as follows:
M253 tells the printer to activate (start) the lathe motor in the clockwise direction (if it has one), using the value set with M92 for RPM. Only available on Hydra 16A models.


* '''M7''' (Aux1 value)
Note: S0 is the same as turning it off.
** '''S25''' (set to 25%)


'''Example 3'''
'''Usage'''


   M7 S0
   M253 Sn


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M7''' (Aux1 value)
  '''Sn''' - speed in units per minute (default: RPM if set with M92 as steps per revolution)
** '''S0''' (set to 0%)


<br>
'''Example'''
<hr>


===  M8 Activate Aux 2 ===
  M253 S75


M7 sends 12VDC to the port associated with "Flood Coolant", which we sometimes call Aux2. With no parameters, it is read as M8 S100 (on continuously).
This command is decoded and executed by the printer as follows:


'''Usage'''
* '''M253''' (activate spindle clockwise)
** '''S75''' (at 75 RPM)


  M8 Sn
<br>
<hr>


'''Parameters'''
=== M254 Turn On Lathe (CCW) ===


  '''Sn''' is the percentage (0-100) for Aux 2 to come on (default is 100)
Please refer to M253, above, for details. All options are identical, with the exception of direction (counterclockwise).


'''Example 1'''
<br>
<hr>


  M8 S100
===  M255 Turn Off Lathe ===


This command is decoded and executed by the printer as follows:
M255 tells the printer to deactivate (stop) the lathe motor (if it has one). M255 has the same effect as G253 S0 or G254 S0.


* '''M8''' (Aux2 value)
'''Usage'''
** '''S100''' (set to 100%)


'''Example 2'''
  M255


  M8 S25
'''Parameters'''


This command is decoded and executed by the printer as follows:
  N/A


* '''M8''' (Aux2 value)
'''Example'''
** '''S25''' (set to 25%)


'''Example 3'''
   M255
 
   M8 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M8''' (Aux2 value)
* '''M255''' (deactivate lathe)
** '''S''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M9 Deactivate Aux1 & Aux2 ===
=== G81 Peck Drilling ===


M9 cuts power to both Aux1 and Aux2. It is equivalent to running M7 S0 and M8 S0.
G81 tells the printer to move to a start position in X/Y and then in Z, and to make (if needed) repeated descents and retracts. This is used to make holes, especially deep holes. Note that the spindle tool is turned on with an M3 or M4 before this command, and turned off with an M5 after all work is done.


'''Usage'''
'''Usage'''


   M9
   G81 T# Xn Yn In Pn Qn Zn Fn


'''Parameters'''
'''Parameters'''


   N/A
   '''T#''' - target head
  '''Xn''' - X position
  '''Yn''' - Y position
  '''In''' - initial Z position
  '''Pn''' - peck downward this many mm during each cycle
  '''Qn''' - retract upward this many mm after each cycle (to clear debris)
  '''Zn''' - maximum pecking depth
  '''Fn''' - Z working speed in mm/min


'''Example'''
'''Example'''


   M9
   G81 T# X100 Y75 I3 P3 Q-2 Z-7.5 F200
 
''NOTE that an M660 offset must be set and applied BEFORE THIS COMMAND to allow for tool length.''


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M9''' (set Aux 1 and Aux 2 to value 0 (off))  
* '''G81''' (begin pecking cycle)
** '''X100 Y75''' (move to X/Y starting position X100 Y75)
** '''I3''' (move to Z starting position Z3, which will be our greatest retract height)
** '''P3''' (peck downward an additional 3mm at a time)
** '''Q-2''' (retract upward 2mm after each peck (to clear debris))
** '''Z-7.5''' (peck to a maximum depth of 7.5mm)
** '''F200''' (working (drilling) travel speed of 200 mm/min)
** ''after this, the head will retract up to the I position (Z3 in this case) before moving on to the next line''


<br>
<br>
<hr>
<hr>


=== M620 Activate Emitter  ===
'''[[#What_is_GCode.3F|Back to top]]'''


See [[#M620_Enable_Device]] above.
== '''Reporting and Diagnostics''' ==


<br>
{| border="1" class="wikitable" style="float:right"
<hr>
! colspan="3" | Reporting and Diagnostics
 
|-
=== M670 Activate Gantry / Y-Arm ===
! Code
 
! Supported
M670 sends 12VDC to the port associated turning on the Gantry (16A) or Y-arm (30M, ESR) lights.
! Brief Description
|-
! [[#M701_Set_Head_Reporting|M701]]
| Yes || Set Head Reporting
|-
! [[#M718_Stop_Logging_to_File|M718]]
| Yes || Stop Logging to File
|-
! [[#M719_Start_Logging_to_File|M719]]
| Yes || Start Logging to File
|-
! [[#M670_Enable_Y-arm_Light|M670]]
| Yes || Enable Y-arm Light
|- || Activate Danger Light
|-
! [[#M672_Set_Y-arm_Light|M672]]
| Yes || Set Y-arm Light
|-
! [[#M772_Reset_All_Metrics|M772]]
| Yes || Reset All Metrics
|-
! [[#M773_Generate_Basic_Report|M773]]
| Yes || Generate Basic Report
|-
|}
 
The following commands help with reporting and diagnostics. Most users never need them, but here are the basics. More advanced/detailed reporting is available.
 
=== M701 Set Head Reporting ===
 
M701 tells heads how often to send head-specific information to the Motion Controller and on to Repetrel (and pass along to a text file if enabled via M719).


'''Usage'''
'''Usage'''


   M670 Sn
   M701 T# Pn


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   '''T#''' - target head
  '''Pn''' - period in seconds between entries (default 1)


'''Example 1'''
'''Example'''


   M670 S100
   M701 P12


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M670''' (Gantry / Y-arm value)  
* '''M701''' (head reporting)
** '''S100''' (set to 100%)
** (currently active head)
** '''P12''' (every 12 seconds)
 
<br>
<hr>
 
=== M718 Stop Logging to File ===
 
M718 tells Repetrel to stop any logging of data to text file that may have been enabled with M719.


'''Example 2'''
'''Usage'''


   M670 S25
   M718


This command is decoded and executed by the printer as follows:
'''Parameters'''


* '''M670''' (Gantry / Y-arm value)
  N/A
** '''S25''' (set to 25%)


'''Example 3'''
'''Example'''


   M670 S0
   M718


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M670''' (Gantry / Y-arm value)
* '''M718''' (logging off)  
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M671 Activate Danger Lights ===
=== M719 Start Logging to File ===


M671 sends 12VDC to the port associated turning on the X-arm / Danger lights (30M/ESR only).
M719 tells the Motion Controller what system-wide information to report back to Repetrel, and also tells Repetrel to begin logging these details to a text file.


'''Usage'''
'''Usage'''


   M671 Sn
   M719 Pn Sn  
 
  M719 Pn Xn Yn Zn An Bn Vn En Ln


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
  '''Pn''' - period in seconds between entries
 
   '''Sn''' - can be default 0 (see options below) or 1 (report ALL data)
'''Example 1'''
  '''Xn''' - report X position with each entry
  '''Yn''' - report Y position with each entry
  '''Zn''' - report Z position with each entry
  '''An''' - report A position with each entry
  '''Bn''' - report B position with each entry
  '''Vn''' - report velocity with each entry
  '''En''' - report flow rate with each entry
  '''Ln''' - report gcode line number with each entry
 
Note: these values are persistent, and if previously enabled, will still be enabled unless disabled with a 0 parameter.
 
'''Example 1'''


   M671 S100
   M719 P10 S1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M671''' (X-arm / Danger value)  
* '''M719''' (logging on)
** '''S100''' (set to 100%)
** '''P10''' (every 10 seconds)
** '''S1''' (report everything)


'''Example 2'''
'''Example 2'''


   M671 S25
   M719 P.1 Xn Yn Zn Ln


This command is decoded and executed by the printer as follows:
* '''M719''' (logging on)
** '''P.1''' (every 0.1 seconds)
** '''X1''' (report X position)
** '''Y1''' (report Y position)
** '''Z1''' (report Z position)
** (don't report A position)
** (don't report B position)
** (don't report velocity)
** (don't report flow rate)
** '''L1''' (report line number)


* '''M671''' (X-arm / Danger value)
<br>
** '''S25''' (set to 25%)
<hr>


'''Example 3'''
=== M670 Enable Gantry / Y-arm Light ===


  M671 S0
M670 sets the intensity of the Y-arm LEDs.


This command is decoded and executed by the printer as follows:
'''Usage'''


* '''M671''' (X-arm / Danger value)
   M670 Sn Pn
** '''S0''' (set to 0%)
 
<br>
<hr>
 
=== M675 Activate Response LEDs ===
 
M675 sends 12VDC to the port associated turning on the Response LEDs (30M/16A only).
 
'''Usage'''
 
   M675 Sn


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   '''Sn''' is the (percent of duty cycle, 0-100) for the LEDs
  '''Pn''' is the period (on-off interval - default is 1 second)


'''Example 1'''
'''Example 1'''


   M675 S100
   M670 S50 P1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M675''' (Response LEDs value)  
* '''M670''' (enable Y-arm light)
** '''S100''' (set to 100%)
** '''S50''' (50% duty cycle)
** '''P1''' (1 second cycle)
 
This would turn the Y-arm light on for 50% of 1 second, then off for 50% of 1 second - or on for 0.5 seconds, off for 0.5 seconds.


'''Example 2'''
'''Example 2'''


   M675 S25
   M670 S25 P4


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M675''' (Response LEDs value)  
* '''M670''' (enable Y-arm light)
** '''S25''' (set to 25%)
** '''S25''' (25% duty cycle)
** '''P4''' (4 second cycle)


'''Example 3'''
This would turn the Y-arm light on for 25% of 4 second, then off for 75% of 4 seconds - or on for 1 second, off for 3 seconds.


  M675 S0
<br>
<hr>


This command is decoded and executed by the printer as follows:
=== M672 Set Gantry / Y-arm State ===


* '''M675''' (Response LEDs value)
M672 can be used to have the Gantry / Y-arm light change states to reflect the state of a sensor. For example, you can have it come on when the X axis is homed, or when the Y axis has a fault.
** '''S0''' (set to 0%)
 
<br>
<hr>
 
=== M676 Activate Recirc. Fan ===
 
M676 sends 12VDC to the port associated turning on the Recirc. Fan (16A only).


'''Usage'''
'''Usage'''


   M676 Sn
   M672 Sn


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   '''Sn''' can be (unlisted numbers are unused at present):
 
        '''0'''  : Normal on/off
'''Example 1'''
        '''10''' : X Home
 
        '''11''' : X Limit1
  M676 S100
        '''12''' : X Limit2
 
        '''13''' : X Fault
This command is decoded and executed by the printer as follows:
        '''20''' : Y Home
 
        '''21''' : Y Limit1
* '''M676''' (Recirc. Fan value)
        '''22''' : Y Limit2
** '''S100''' (set to 100%)
        '''23''' : Y Fault
 
        '''30''' : Z Home
'''Example 2'''
        '''31''' : Z Limit1
        '''32''' : Z Limit2
        '''33''' : Z Fault
        '''40''' : A Home
        '''41''' : A Limit1
        '''42''' : A Limit2
        '''43''' : A Fault
        '''50''' : B Home
        '''11''' : B Limit1
        '''52''' : B Limit2
        '''53''' : B Fault
        '''60''' : C Home
        '''61''' : C Limit1
        '''62''' : C Limit2
        '''63''' : C Fault


  M676 S25
'''Example'''


This command is decoded and executed by the printer as follows:
   M672 S
 
* '''M676''' (Recirc. Fan value)
** '''S25''' (set to 25%)
 
'''Example 3'''
 
   M676 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M676''' (Recirc. Fan value)
* '''M672''' (map Y-arm light to state of sensor)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M677 Activate Buzzer ===
=== M772 Reset All Metrics ===


M677 sends 12VDC to the port associated turning on the Buzzer (older 30Ms only).
M772 will reset all internal gathering registers to '''0'''.


'''Usage'''
'''Usage'''


   M677 Sn
   M772 Sn


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   '''Sn''' 0 is default; S can be...
      '''0''' reset all values only
      '''1''' also generates a basic printing report
      '''255''' also generates all possible reports (helpful for advanced debugging)


'''Example 1'''
'''Example'''


   M677 S100
   M772 S1


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M677''' (Buzzer value)  
* '''M772''' (reset all metrics)
** '''S100''' (set to 100%)
** '''S1''' (and generate basic printing report
 
'''Example 2'''
 
  M677 S25
 
This command is decoded and executed by the printer as follows:
 
* '''M677''' (Buzzer value)
** '''S25''' (set to 25%)
 
'''Example 3'''
 
  M677 S0
 
This command is decoded and executed by the printer as follows:
 
* '''M677''' (Buzzer value)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M678 Activate Laser X-hair ===
=== M773 Generate Basic Report ===
 
M773 generates a basic report of printing statistics (including average speed, number of primes, etc.)


M678 sends 12VDC to the port associated turning on the Laser X-hair (16A with CO<sub>2</sub> lasers only).
Note: this report will be more meaningful if you use '''M772''' to reset these counters at the start of a job.


'''Usage'''
'''Usage'''


   M678 Sn
   M773


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   N/A


'''Example 1'''
'''Example'''


   M678 S100
   M773


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M678''' (Laser X-hair value)
* '''M773''' (generate basic report)
** '''S100''' (set to 100%)


'''Example 2'''
'''Sample Output'''


   M678 S25
   >IN:  50: ******************************************************************
  >IN:  50: **  Begin M773 - print job metrics Report
  >IN:  50: ******************************************************************
  >IN:  50:
  >IN:  50:                      Time (s)    Dist (m)
  >IN:  50:                      --------    --------
  >IN:  50: Totals:                    0.0      0.000
  >IN:  50:
  >IN:  50: Printing moves:            0.0      0.000
  >IN:  50: Non-printing moves        0.0      0.000
  >IN:  50:
  >IN:  50: Accelerating:              0.0      0.000
  >IN:  50: Cruising:                  0.0      0.000
  >IN:  50: Decelerating:              0.0      0.000
  >IN:  50:
  >IN:  50: can e steps issued:      0
  >IN:  50: approx filament (PI*d)    0.000 m
  >IN:  50: approx filament (PIr^2)  0.000 m
  >IN:  50: unprimes issued:          0
  >IN:  50: primes issued:            0
  >IN:  50: unprime-primes avoided:  0
  >IN:  50:
  >IN:  50: ******************************************************************
  >IN:  50: **  End M773 Report
  >IN:  50: ******************************************************************


This command is decoded and executed by the printer as follows:
<br>
<hr>


* '''M678''' (Laser X-hair value)
'''[[#What_is_GCode.3F|Back to top]]'''
** '''S25''' (set to 25%)


'''Example 3'''
== '''Controlling Aux Devices''' ==


  M678 S0
{| border="1" class="wikitable" style="float:right"
 
! colspan="3" | Controlling Aux Devices
This command is decoded and executed by the printer as follows:
|-
 
! Code
* '''M678''' (Laser X-hair value)  
! Supported
** '''S0''' (set to 0%)
! Brief Description
 
|-
<br>
! [[#M7_Set_Power_On_Aux_1|M7]]
<hr>
| Yes || Aux 1 On (Mist)
 
|-
<br>
! [[#M8_Set_Power_On_Aux_2|M8]]
<hr>
| Yes || Aux 2 On (Flood)
 
|-
=== M679 Activate Vacuum ===
! [[#M9_Turn_Off_All_Aux|M9]]
 
| Yes || All Aux Off
M679 sends 12VDC to the port associated turning on the Vacuum (30M/ESR only).
|-
 
! [[#M620_Enable_Device|M620]]
'''Usage'''
| Yes || Enable Device
 
|-
  M671 Sn
! [[#M670_Activate_Y-Arm_.28Gantry.29_Lights|M670]]
| Yes || Enable Y-arm (Gantry) Lights
|-
! [[#M671_Activate_X-Arm_.28Danger.29_Lights|M671]]
| Yes || Activate X-Arm (Danger) Lights
|-
! [[#M675_Activate_Response_LEDs|M675]]
| Yes || Activate Response LEDs
|-
! [[#M676_Activate_Recirc._Fan|M676]]
| Yes || Activate Recirc. Fan
|-
! [[#M677_Activate_Buzzer|M677]]
| Yes || Activate Buzzer
|-
! [[#M678_Activate_Laser_X-hair|M678]]
| Yes || Activate Laser X-hair
|-
! [[#M679_Activate_Vacuum|M679]]
| Yes || Activate Vacuum
|-
! [[#M684_Activate_Exhaust|M684]]
| Yes || Activate Exhaust
|-
! [[#M685_Set_Power_on_Air|M685]]
| Yes || Activate Air
|-
! [[#M689_Activate_Ext._Head|M689]]
| Yes || Activate Ext. Head
|-
! [[#M783_Tie_Aux_to_Extrusion|M783]]
| Yes || Tie Aux to Extrusion
|-
|}


'''Parameters'''


  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
Individual port control commands.


'''Example 1'''
=== M7 Activate Aux 1 ===


  M679 S100
[[File:M7m8m9_ehr.jpg|thumb|12VDC Ports on EHR|right]]


This command is decoded and executed by the printer as follows:
[[File:M7m8m9_30m_esr.jpg|thumb|12VDC Ports on 30M, ESR|right]]


* '''M679''' (Vacuum value)  
M7 sends 12VDC to the port associated with "Mist Coolant", which we sometimes call Aux1. With no parameters, it is read as M7 S100 (on continuously). See also [[#M783_Tie_Aux_to_Extrusion|'''M783''' Tie Aux to Extrusion]].
** '''S100''' (set to 100%)
 
'''Usage'''
 
  M7 Sn Tn
 
'''Parameters'''
 
  '''Sn''' is the percentage (0-100) for Aux 1 to come on (default is 100)
  '''Tn''' is the head to which Aux 1 will synchronize, coming on at 100% when that head is extruding; using a '''T''' value forces '''S100'''
 
'''Example 1'''
 
  M7 S100
 
This command is decoded and executed by the printer as follows:
 
* '''M7''' (Aux1 value)  
** '''S100''' (set to 100%)


'''Example 2'''
'''Example 2'''


   M679 S25
   M7 S25


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M679''' (Vacuum value)  
* '''M7''' (Aux1 value)  
** '''S25''' (set to 25%)
** '''S25''' (set to 25%)


'''Example 3'''
'''Example 3'''


   M679 S0
   M7 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M679''' (Vacuum value)  
* '''M7''' (Aux1 value)  
** '''S0''' (set to 0%)
** '''S0''' (set to 0%)
'''Example 4'''
  M7 T#
This command is decoded and executed by the printer as follows:
* '''M7''' (Aux1 value)
** '''T#''' (set to 100% when T# is extruding)


<br>
<br>
<hr>
<hr>


=== M684 Activate Exhaust ===
=== M8 Activate Aux 2 ===


M671 sends 12VDC to the port associated turning on the Exhaust (16A only).
M7 sends 12VDC to the port associated with "Flood Coolant", which we sometimes call Aux2. With no parameters, it is read as M8 S100 (on continuously).  See also [[#M783_Tie_Aux_to_Extrusion|'''M783''' Tie Aux to Extrusion]].


'''Usage'''
'''Usage'''


   M684 Sn
   M8 Sn Tn


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   '''Sn''' is the percentage (0-100) for Aux 2 to come on (default is 100)
  '''Tn''' is the head to which Aux 2 will synchronize, coming on at 100% when that head is extruding; using a '''T''' value forces '''S100'''


'''Example 1'''
'''Example 1'''


   M684 S100
   M8 S100


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M684''' (Exhaust value)  
* '''M8''' (Aux2 value)  
** '''S100''' (set to 100%)
** '''S100''' (set to 100%)


'''Example 2'''
'''Example 2'''


   M684 S25
   M8 S25


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M684''' (Exhaust value)  
* '''M8''' (Aux2 value)  
** '''S25''' (set to 25%)
** '''S25''' (set to 25%)


'''Example 3'''
'''Example 3'''


   M684 S0
   M8 S0
 
This command is decoded and executed by the printer as follows:
 
* '''M8''' (Aux2 value)
** '''S''' (set to 0%)
 
'''Example 4'''
 
  M8 T#


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M684''' (Exhaust value)  
* '''M8''' (Aux2 value)  
** '''S0''' (set to 0%)
** '''T#''' (set to 100% when T# is extruding)


<br>
<br>
<hr>
<hr>


=== M685 Set Power on Air  ===
=== M9 Deactivate Aux1 & Aux2 ===


M685 sends 12VDC to the port associated turning on the (positive pressure) Air (16A only).
M9 cuts power to both Aux1 and Aux2. It is equivalent to running M7 S0 and M8 S0.


'''Usage'''
'''Usage'''


   M685 Sn
   M9


'''Parameters'''
'''Parameters'''


   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
   N/A


'''Example 1'''
'''Example'''


   M685 S100
   M9


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M685''' (Air value)  
* '''M9''' (set Aux 1 and Aux 2 to value 0 (off))  
** '''S100''' (set to 100%)


'''Example 2'''
<br>
<hr>


  M685 S25
=== M620 Activate Emitter  ===


This command is decoded and executed by the printer as follows:
See [[#M620_Enable_Device]] above.
 
* '''M685''' Air value)
** '''S25''' (set to 25%)
 
'''Example 3'''
 
  M685 S0
 
This command is decoded and executed by the printer as follows:
 
* '''M685''' (Air value)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M689 Activate Ext. Head  ===
=== M670 Activate Y-Arm (Gantry) Lights ===


M689 sends 12VDC to the port associated turning on the Ext. Head.
M670 sends 12VDC to the port associated turning on the Gantry (16A) or Y-arm (30M, ESR) lights.


'''Usage'''
'''Usage'''


   M689 Sn
   M670 Sn


'''Parameters'''
'''Parameters'''
Line 2,969: Line 3,365:
'''Example 1'''
'''Example 1'''


   M689 S100
   M670 S100


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M689''' (Ext. Head value)  
* '''M670''' (Gantry / Y-arm value)  
** '''S100''' (set to 100%)
** '''S100''' (set to 100%)


'''Example 2'''
'''Example 2'''


   M689 S25
   M670 S25


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M689''' (Ext. Head value)  
* '''M670''' (Gantry / Y-arm value)  
** '''S25''' (set to 25%)
** '''S25''' (set to 25%)


'''Example 3'''
'''Example 3'''


   M689 S0
   M670 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M689''' (Ext. Head value)  
* '''M670''' (Gantry / Y-arm value)  
** '''S0''' (set to 0%)
** '''S0''' (set to 0%)


Line 2,997: Line 3,393:
<hr>
<hr>


== '''Other''' ==
=== M671 Activate X-Arm (Danger) Lights ===


Other commands.
M671 sends 12VDC to the port associated turning on the X-arm / Danger lights (30M/ESR only).


=== M17 Engage Motors ===
'''Usage'''


M17 will apply power to all motors (positioning and extruder motors), locking them at their current postion; this prevents the bed and yoke from being pushed manually in the X and Y.
  M671 Sn


Note that an '''M18''' or '''M84''' will disengage motors.
'''Parameters'''


'''Usage'''
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
 
'''Example 1'''
 
  M671 S100
 
This command is decoded and executed by the printer as follows:
 
* '''M671''' (X-arm / Danger value)
** '''S100''' (set to 100%)
 
'''Example 2'''


   M17
   M671 S25


'''Parameters'''
This command is decoded and executed by the printer as follows:


  N/A
* '''M671''' (X-arm / Danger value)
** '''S25''' (set to 25%)


'''Example'''
'''Example 3'''


   M17
   M671 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M17''' (engage motors)  
* '''M671''' (X-arm / Danger value)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M18 Disengage Motors ===
=== M675 Activate Response LEDs ===


M18 will cut power to all motors (positioning and extruder motors), unlocking them; this allows the motors to cool down (as they normally lock in place while still), as well as allowing one to manually push the bed and yoke in the X and Y. It also notifies the GUI that motors are disabled. All axes with homes must be rehomed after an M18.
M675 sends 12VDC to the port associated turning on the Response LEDs (30M/16A only).
 
Note this is identical to '''M84''' and the opposite of '''M17'''.


'''Usage'''
'''Usage'''


   M18
   M675 Sn


'''Parameters'''
'''Parameters'''


   N/A
   '''Sn''' is the percentage (0-100; no default - if no Sn, no change)


'''Example'''
'''Example 1'''


   M18
   M675 S100


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M18''' (disengage motors)  
* '''M675''' (Response LEDs value)
** '''S100''' (set to 100%)


<br>
'''Example 2'''
<hr>


=== M30 End of Program ===
  M675 S25


M30 tells the printer that this job is complete. No gocde after an M30 will be executed as part of the previous job.
This command is decoded and executed by the printer as follows:


Note M30 also dissolves any cloning setups, changes head index to 0, clears fixture offsets (G63), clears any M229 E-value settings, resets M106 persistent range, resets any printing errors, resets M660 head offsets to 0, resets heads to their stored values, and triggers any queued reports.
* '''M675''' (Response LEDs value)  
** '''S25''' (set to 25%)


'''Usage'''
'''Example 3'''


   M30
   M675 S0
 
'''Parameters'''
 
  N/A
 
'''Example'''
 
  M30


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M30''' (end or program)  
* '''M675''' (Response LEDs value)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M84 Disable Motors ===
=== M676 Activate Recirc. Fan ===


M84 invokes an M18. Please see M18 for usage.
M676 sends 12VDC to the port associated turning on the Recirc. Fan (16A only).


<br>
'''Usage'''
<hr>


  M676 Sn


'''Parameters'''


=== M783 Tie Aux to Extrusion ===
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)


M783 can tie some auxiliary port (like Aux 1) to be powered (at 100%) during a certain head's extrusion. Some users use this so that they can print with an Ultimus head on our equipment.
'''Example 1'''
 
  M676 S100
 
This command is decoded and executed by the printer as follows:


Note: M619 can be used to map which port M783 ties to.
* '''M676''' (Recirc. Fan value)
** '''S100''' (set to 100%)


'''Usage'''
'''Example 2'''


   M783 T#
   M676 S25


'''Parameters'''
This command is decoded and executed by the printer as follows:


  '''T#''' is the tool to which the designated aux port will be tied
* '''M676''' (Recirc. Fan value)
** '''S25''' (set to 25%)


'''Example'''
'''Example 3'''


   M783 T#
   M676 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M783''' (Tie current Aux port to status of head)
* '''M676''' (Recirc. Fan value)  
** '''T#''' (target head)
** '''S0''' (set to 0%)


<br>
<br>
<hr>
<hr>


=== M790 New Layer Actions ===
=== M677 Activate Buzzer ===


M790 will trigger any associated new layer actions, which can include capturing an image from the designated camera. It takes no parameters.
M677 sends 12VDC to the port associated turning on the Buzzer (older 30Ms only).


=== M791 Snap Image ===
'''Usage'''


M791 will cause the camera selected under the Interface > Camera1 tab, if set to live video, to capture an image and save it to <code>C:\Users\hyrel\Pictures\HyrelPrinterPictures\snap Shots\snap Shots</code>, named <code>pic#.png</code>
  M677 Sn


=== M792 Execute Action ===
'''Parameters'''


M792 causes Repetrel to perform an action, such as displaying an image or making a warning beep.
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)


'''Usage'''
'''Example 1'''


   M792 [ SAY | PIC | VID | SEND | BEEP | SHELL ]
   M677 S100


'''Parameters'''
This command is decoded and executed by the printer as follows:
 
* '''M677''' (Buzzer value)
** '''S100''' (set to 100%)
 
'''Example 2'''
 
  M677 S25


  '''SAY sample message''' - the computer will use built-in text-to-speech to echo the message over the speaker(s)
This command is decoded and executed by the printer as follows:
  '''PIC C:\sample.jpg''' - the computer will display the image at the specified location
  '''VID C:\sample.mp4''' - the computer will play the video at the specified location
  '''SEND sample message''' - the computer will send the message to the Aux port if connected
  '''BEEP''' - the computer will sound a beep
  '''SHELL C:\program.exe''' - the computer will execute the file at the specified location


Note that multiple options can be combined.
* '''M677''' (Buzzer value)
** '''S25''' (set to 25%)


'''Example'''
'''Example 3'''


   M792 ; SAY Hello Wilbur ; PIC C:\mr_ed.png
   M677 S0


This command is decoded and executed by the printer as follows:
This command is decoded and executed by the printer as follows:


* '''M792''' (execute action)  
* '''M677''' (Buzzer value)  
** '''SAY Hello Wilbur''' (Announce Text: Hello Wilbur)
** '''S0''' (set to 0%)
** '''PIC C:\mr_ed.png''' (Display Image: C:\mr_ed.png)


<br>
<br>
<hr>
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
=== M678 Activate Laser X-hair ===
 
M678 sends 12VDC to the port associated turning on the Laser X-hair (16A with CO<sub>2</sub> lasers only).
 
'''Usage'''


== Chart of Codes ==
  M678 Sn


{| border="1" class="wikitable"
'''Parameters'''
|+ G- and M- Code Reference Chart
 
! Code
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
! Supported
 
! Brief Description
'''Example 1'''
|-
 
! [[#G0_Rapid_Move|G0]]
  M678 S100
| Yes || Rapid Move
 
|-
This command is decoded and executed by the printer as follows:
! [[#G1_Working_Move|G1]]
 
| Yes || Working Move
* '''M678''' (Laser X-hair value)
|-
** '''S100''' (set to 100%)
! [[#G2_Clockwise_Arc|G2]]
 
| Yes || Clockwise Arc
'''Example 2'''
|-
 
! [[#G2.1_Spiral_CW_Arc1|G2.1]]
  M678 S25
| Yes || Spiral CW Arc<sup>1</sup>
 
|-
This command is decoded and executed by the printer as follows:
! [[#G2.2_Spiral_CW_Arc2|G2.2]]
 
| Yes || Spiral CW Arc<sup>2</sup>
* '''M678''' (Laser X-hair value)
|-
** '''S25''' (set to 25%)
! [[#G2.3_3-Space_CW_Arc|G2.3]]
 
| Yes || 3-Space CW Spiral Arc
'''Example 3'''
|-
 
! [[#G3_Counterclockwise_Arc|G3]]
  M678 S0
| Yes || Counterclockwise Arc
 
|-
This command is decoded and executed by the printer as follows:
! [[#G3.1_Spiral_CCW_Arc1</sup>|G3.1]]
 
| Yes || Spiral CCW Arc<sup>1</sup>
* '''M678''' (Laser X-hair value)
|-
** '''S0''' (set to 0%)
! [[#G3.2_Spiral_CCW_Arc2|G3.2]]
 
| Yes || Spiral CCW Arc<sup>2</sup>
<br>
|-
<hr>
! [[#G3.3_3-Space_CCW_Arc|G3.3]]
 
| Yes || 3-Space CCW Spiral Arc
<br>
|-
<hr>
! [[#G4_Timed_Pause|G4]]
 
| Yes || Timed Pause
=== M679 Activate Vacuum ===
|-
 
! [[#G10_UNUSED|G10]]
M679 sends 12VDC to the port associated turning on the Vacuum (30M/ESR only).
| ''No'' || ''Absolute E''
 
|-
'''Usage'''
! [[#G11_UNUSED|G11]]
 
| ''No'' || ''Relative E''
  M671 Sn
|-
 
! [[#G16_Arc_Plane:_Any|G16]]
'''Parameters'''
| Yes || Arc in Any Plane
 
|-
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
! [[#G17_Arc_Plane:_XY|G17]]
 
| Yes || Arc in XY Plane
'''Example 1'''
|-
 
! [[#G18_Arc_Plane:_XZ|G18]]
  M679 S100
| Yes || Arc in XZ Plane
 
|-
This command is decoded and executed by the printer as follows:
! [[#G19_Arc_Plane:_YZ|G19]]
 
| Yes || Arc in YZ Plane
* '''M679''' (Vacuum value)
|-
** '''S100''' (set to 100%)
! [[#G20_Set_Units_to_Inches|G20]]
 
| Yes || Set Units to Inches
'''Example 2'''
|-
 
! [[#G21_Set_Units_to_Milimeters|G21]]
  M679 S25
| Yes || Set Units to Milimeters
 
|-
This command is decoded and executed by the printer as follows:
! [[#G28_Send_X,_Y_to_Physical_Home|G28]]
 
| Yes || Send X, Y to Physical Home
* '''M679''' (Vacuum value)
|-
** '''S25''' (set to 25%)
! [[#G53_Clear_Offsets|G53]]
 
| Yes || Clear Offsets
'''Example 3'''
|-
 
! [[#G54_-_G59_-_Set_Offsets|G54-59]]
  M679 S0
| Yes || Set Offsets
 
|-
This command is decoded and executed by the printer as follows:
! [[#G81_Peck_Drilling|G81]]
 
| G81 || Peck Drilling
* '''M679''' (Vacuum value)
|-
** '''S0''' (set to 0%)
! [[#G90_Absolute_Positioning|G90]]
 
| Yes || Absolute Positioning
<br>
|-
<hr>
! [[#G91_Relatative_Positioning|G91]]
 
| Yes || Relatative Positioning
=== M684 Activate Exhaust ===
|-
 
! [[#G92_Reset_Coordinate_Offsets|G92]]
M671 sends 12VDC to the port associated turning on the Exhaust (16A only).
| Yes || Reset Coordinates
 
|-
'''Usage'''
! [[#G93_Clear_Coordinate_Offsets|G93]]
 
| Yes || Reset Coordinates
  M684 Sn
|-
 
! [[#M0_Stop_Until_Resume|M0]]
'''Parameters'''
| Yes || Stop Until Resume
 
|-
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
! [[#M3_Turn_On_Spindle_.28CW.29|M3]]
 
| Yes || Spindle On CW
'''Example 1'''
|-
 
! [[#M4_Turn_On_Spindle_.28CCW.29R|M4]]
  M684 S100
| Yes || Spindle On CCW
 
|-
This command is decoded and executed by the printer as follows:
! [[#M5_Turn_Off_Spindle|M5]]
 
| Yes || Spindle Off
* '''M684''' (Exhaust value)
|-
** '''S100''' (set to 100%)
! [[#M6_Declare_Head_Offsets|M6]]
 
| Yes || Declare Head Offsets
'''Example 2'''
|-
 
! [[#M7_Set_Power_On_Aux_1|M7]]
  M684 S25
| Yes || Aux 1 On (Mist)
 
|-
This command is decoded and executed by the printer as follows:
! [[#M8_Set_Power_On_Aux_2|M8]]
 
| Yes || Aux 2 On (Flood)
* '''M684''' (Exhaust value)
|-
** '''S25''' (set to 25%)
! [[#M9_Turn_Off_All_Aux|M9]]
 
| Yes || All Aux Off
'''Example 3'''
|-
 
! [[#M17_Engage_Motors|M17]]
  M684 S0
| Yes || Engage Motors
 
|-
This command is decoded and executed by the printer as follows:
! [[#M18_Disengage_Motors|M18]]
 
| Yes || Disengage Motors
* '''M684''' (Exhaust value)
|-
** '''S0''' (set to 0%)
! [[#M30_End_of_Program|M30]]
 
| Yes || End of Program
<br>
|-
<hr>
! [[#M82_Absolute_E-Values|M82]]
 
| Yes || Absolute E-Values
=== M685 Set Power on Air  ===
|-
 
! [[#M83_Relative_E-Values|M83]]
M685 sends 12VDC to the port associated turning on the (positive pressure) Air (16A only).
| Yes || Relative E-Values
 
|-
'''Usage'''
! [[#M84_Disable_Motors|M84]]
 
| Yes || Disable Motors
  M685 Sn
|-
 
! [[#M104_Set_Temp_.28Head.29|M104]]
'''Parameters'''
| Yes || Set Temp (Head)
 
|-
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
! [[#M106_Set_Cooling_.2F_Etc.|M106]]
 
| Yes || Set Cooling / Etc.
'''Example 1'''
|-
 
! [[#M107_Stop_Cooling_.2F_Etc.|M107]]
  M685 S100
| Yes || Stop Cooling / Etc.
 
|-
This command is decoded and executed by the printer as follows:
! [[#M109_Wait_for_Temp_.28Head.29|M109]]
 
| Yes || Wait for Temp (Head)
* '''M685''' (Air value)
|-
** '''S100''' (set to 100%)
! [[#M116_UNUSED|M116]]
 
| ''No'' || ''Pause for All Temps''
'''Example 2'''
|-
 
! [[#M140_Set_Temp_.28Bed.29|M140]]
  M685 S25
| Yes || Set Temp (Bed)
 
|-
This command is decoded and executed by the printer as follows:
! [[#M141_Set_Temp_.28Chamber.29|M141]]
 
| Yes || Set Temp (Chamber)
* '''M685''' Air value)
|-
** '''S25''' (set to 25%)
! [[#M190_Wait_for_Temp_.28Bed.29|M190]]
 
| Yes || Wait for Temp (Bed)
'''Example 3'''
|-
 
! [[#M191_Wait_for_Temp_.28Chamber.29|M191]]
  M685 S0
| Yes || Wait for Temp (Chamber)
 
|-
This command is decoded and executed by the printer as follows:
! [[#M203_Set_G0_Speed|M203]]
 
| Yes || Set G0 Speed
* '''M685''' (Air value)
|-
** '''S0''' (set to 0%)
! [[#M221_Set_Flow_Rate|M221]]
 
| Yes || Set Flow Rate
<br>
|-
<hr>
! [[#M229_Use_E_Values|M229]]
 
| Yes || Use E Values
=== M689 Activate Ext. Head  ===
|-
 
! [[#M253_Turn_On_Lathe_.28CW.29|M253]]
M689 sends 12VDC to the port associated turning on the Ext. Head.
| Yes || Turn On Lathe (CW)
 
|-
'''Usage'''
! [[#M254_Turn_On_Lathe_.28CCW.29|M254]]
 
| Yes || Turn On Lathe (CCW)
  M689 Sn
|-
 
! [[#M255_Turn_Off_Lathe|M255]]  
'''Parameters'''
| Yes || Turn Off Lathe
 
|-
  '''Sn''' is the percentage (0-100; no default - if no Sn, no change)
! [[#M619_Map_Aux_Port|M619]]  
 
| Yes || Map Aux Port
'''Example 1'''
|-
 
! [[#M620_Enable_Device|M620]]
  M689 S100
| Yes || Enable Device
 
|-
This command is decoded and executed by the printer as follows:
! [[#M621_Set_Laser_Power|M621]]
 
| Yes || Set Laser Power
* '''M689''' (Ext. Head value)
|-
** '''S100''' (set to 100%)
! [[#M623_Duration_Emit|M623]]
 
| Yes || Duration Emit
'''Example 2'''
|-
 
! [[#M660_Assign_Tool_Height_Offset|M660]]
  M689 S25
| Yes || Set Tool Offsets
 
|-
This command is decoded and executed by the printer as follows:
! [[#M670_Enable_Y-arm_Light|M670]]
 
| Yes || Enable Y-arm Light
* '''M689''' (Ext. Head value)
|-
** '''S25''' (set to 25%)
! [[#M671_Activate_Danger_Lights|M671]]
 
| Yes || Activate Danger Light
'''Example 3'''
|-
 
! [[#M672_Set_Y-arm_Light|M672]]  
  M689 S0
| Yes || Set Y-arm Light
 
|-
This command is decoded and executed by the printer as follows:
! [[#M675_Activate_Response_LEDs|M675]]
 
| Yes || Activate Response LEDs
* '''M689''' (Ext. Head value)
** '''S0''' (set to 0%)
 
<br>
<hr>
 
=== M783 Tie Aux to Extrusion ===
 
M783 can tie some auxiliary port (like Aux 1, normally controlled by M7, or Aux 2, normally controlled by M8, etc.) to be powered (at 100%) during a certain head's extrusion. Some users use this so that they can print with Ultimus or Viscotec heads on our equipment. See also [[#M7_Set_Power_On_Aux_1|M7]] and [[#M8_Set_Power_On_Aux_2|M8]].
 
Note: M619 can be used to map which port M783 ties to - contact us for more information.
 
'''Usage'''
 
  M783 T#  
 
'''Parameters'''
 
  '''T#''' is the tool to which the designated aux port will be tied
 
'''Example'''
 
  M783 T#
 
This command is decoded and executed by the printer as follows:
 
* '''M783''' (Tie current Aux port to status of head)
** '''T#''' (target head)
 
<br>
<hr>
 
 
'''[[#What_is_GCode.3F|Back to top]]'''
 
== '''Other Commands''' ==
 
{| border="1" class="wikitable" style="float:right"
! colspan="3" | Other Commands
|-
|-
! [[#M676_Activate_Recirc._Fan|M676]]
! Code
| Yes || Activate Recirc. Fan
! Supported
! Brief Description
|-
|-
! [[#M677_Activate_Buzzer|M677]]  
! [[#M17_Engage_Motors|M17]]  
| Yes || Activate Buzzer
| Yes || Engage Motors
|-
|-
! [[#M678_Activate_Laser_X-hair|M678]]  
! [[#M18_Disengage_Motors|M18]]  
| Yes || Activate Laser X-hair
| Yes || Disengage Motors
|-
|-
! [[#M679_Activate_Vacuum|M679]]  
! [[#M30_End_of_Program|M30]]  
| Yes || Activate Vacuum
| Yes || End of Program
|-
|-
! [[#M684_Activate_Exhaust|M684]]  
! [[#M84_Disable_Motors|M84]]  
| Yes || Activate Exhaust
| Yes || Disable Motors
|-
|-
! [[#M685_Set_Power_on_Air|M685]]  
! [[#M790_New_Layer_Actions|M790]]  
| Yes || Activate Air
| Yes || New Layer Actions
|-
|-
! [[#M689_Activate_Ext._Head|M689]]  
! [[#M791_Snap_Image|M791]]  
| Yes || Activate Ext. Head
| Yes || Snap Image
|-
|-
! [[#M701_Set_Head_Reporting|M701]]  
! [[#M792_Execute_Action|M792]]  
| Yes || Set Head Reporting
| Yes || Execute Action
|-
|-
! [[#M702_-_M704_Cloning_Heads|M702]]
|}
| Yes || Establish Clone Squad
 
|-
Other commands.
! [[#M702_-_M704_Cloning_Heads|M703]]
 
| Yes || Add to Clone Squad
=== M17 Engage Motors ===
|-
 
! [[#M702_-_M704_Cloning_Heads|M704]]
M17 will apply power to all motors (positioning and extruder motors), locking them at their current postion; this prevents the bed and yoke from being pushed manually in the X and Y.
| Yes || Remove from Clone Squad
 
|-
Note that an '''M18''' or '''M84''' will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.
! [[#M718_Stop_Logging_to_File|M718]]
 
| Yes || Stop Logging to File
'''Usage'''
|-
 
! [[#M719_Start_Logging_to_File|M719]]
  M17
| Yes || Start Logging to File
 
|-
'''Parameters'''
! [[#M721_Set_Unprime_Values|M721]]
 
| Yes || Set Unprime Values
  N/A
|-
 
! [[#M722_Set_Prime_Values|M722]]
'''Example'''
| Yes || Set Prime Values
 
|-
  M17
! [[#M723_Set_Manual_Flow|M723]]
 
| Yes || Set Manual Flow
This command is decoded and executed by the printer as follows:
|-
 
! [[#M728_Set_Motor_Current_Boost|M728]]
* '''M17''' (engage motors)
| Yes || Set Motor Current Boost
 
|-
<br>
! [[#M756_Set_Height_for_Flow|M756]]
<hr>
| Yes || Set Height for Flow
 
|-
=== M18 Disengage Motors ===
! [[#M772_Reset_All_Metrics|M772]]
 
| Yes || Reset All Metrics
M18 will cut power to all motors (positioning and extruder motors), unlocking them; this allows the motors to cool down (as they normally lock in place while still), as well as allowing one to manually push the bed and yoke in the X and Y. It also notifies the GUI that motors are disabled. All axes with homes must be rehomed after an M18.
|-
 
! [[#M773_Generate_Basic_Report|M773]]
Note this is identical to '''M84''' and the opposite of '''M17'''.
| Yes || Generate Basic Report
 
|-
Note that an '''M18''' or '''M84''' will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.
! [[#M783_Tie_Aux_to_Extrusion|M783]]
 
| Yes || Tie Aux to Extrusion
'''Usage'''
|-
 
! [[#M790_New_Layer_Actions|M790]]
  M18
| Yes || New Layer Actions
 
|-
'''Parameters'''
! [[#M791_Snap_Image|M791]]
 
| Yes || Snap Image
  N/A
|-
 
! [[#M792_Execute_Action|M792]]
'''Example'''
| Yes || Execute Action
 
|-
  M18
|}
 
This command is decoded and executed by the printer as follows:
 
* '''M18''' (disengage motors)
 
<br>
<hr>
 
=== M30 End of Program ===
 
M30 tells the printer that this job is complete. No gocde after an M30 will be executed as part of the previous job.
 
Note M30 also dissolves any cloning setups, changes head index to 0, clears fixture offsets (G53), clears any M229 E-value settings, resets M106 persistent range, resets any printing errors, resets M660 head offsets to 0, resets heads to their stored values, and triggers any queued reports.
 
'''Usage'''
 
  M30
 
'''Parameters'''
 
  N/A
 
'''Example'''
 
  M30
 
This command is decoded and executed by the printer as follows:
 
* '''M30''' (end or program)
 
<br>
<hr>
 
=== M84 Disable Motors ===
 
M84 invokes an M18. Please see M18 for usage.
 
Note that an '''M18''' or '''M84''' will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.
 
<br>
<hr>
 
=== M790 New Layer Actions ===
 
M790 will trigger any associated new layer actions, which can include capturing an image from the designated camera. It takes no parameters.
 
=== M791 Snap Image ===
 
M791 will cause the camera selected under the Interface > Camera1 tab, if set to live video, to capture an image and save it to <code>C:\Users\hyrel\Pictures\HyrelPrinterPictures\Camera1</code>, named <code>pic#.png</code>
 
=== M792 Execute Action ===
 
M792 causes Repetrel to perform an action, such as displaying an image or making a warning beep.
 
'''Usage'''
 
  M792 [ SAY | PIC | VID | SEND | BEEP | SHELL ]
 
'''Parameters'''
 
  '''SAY sample message''' - the computer will use built-in text-to-speech to echo the message over the speaker(s)
  '''PIC C:\sample.jpg''' - the computer will display the image at the specified location
  '''VID C:\sample.mp4''' - the computer will play the video at the specified location
  '''SEND sample message''' - the computer will send the message to the Aux port if connected
  '''BEEP''' - the computer will sound a beep
  '''SHELL C:\program.exe''' - the computer will execute the file at the specified location
 
Note that multiple options can be combined.
 
'''Example'''
 
  M792 ; SAY Hello Wilbur ; PIC C:\mr_ed.png
 
This command is decoded and executed by the printer as follows:
 
* '''M792''' (execute action)
** '''SAY Hello Wilbur''' (Announce Text: Hello Wilbur)
** '''PIC C:\mr_ed.png''' (Display Image: C:\mr_ed.png)
 
<br>
<hr>


'''[[#What_is_GCode.3F|Back to top]]'''
'''[[#What_is_GCode.3F|Back to top]]'''
== Gcode Header ==
Here are some sample headers for Gcode on our equipment:
=== 16A, T1, Heated ===
Below is our standard header for using a heated head in the second slot with a heated bed on a 16A:
  ; ///////////////  BEGIN HYREL HEADER for a 16A with a Heated Head in T1/T12 - 2021.02.24  \\\\\\\\\\\\\\\
 
  ; GENERAL :
 
  N14                ; set line numbers for error logging - Slic3r version
  M772 S1            ; reset metrics and arm automatic reporting
  M627 X0 Y0 Z0 J-500 K5                ; setup abort action
 
 
  M107              ; fans/UV          ; off
  M106 C255          ; fans/UV          ; set to 0-255 range
 
  G53                ; clear offsets
  G21                ; units            : mm
  G91                ; coordinatess      : relative
  G0 Z10           ; drop bed
  G90                ; coordinates      : absolute
 
  M229 E1 D1        ; enable E-values (volumetric)
 
  ; TEMP CONTROL :
 
  M190 S100          ; bed preheat  : set and wait
  M140 S[bed_temperature]          ; bed temp    : set, no wait
  M104 T12 S[temperature]      ; head temp    : set, no wait
 
  G28 X0 Y0          ; home, goto  : X and Y
 
  M190 S[bed_temperature]          ; bed temp    : set and wait
  M109 T12 S[temperature]      ; head temp    : set and wait
 
  T1                ; use SECOND tool position from the left   
 
  ; \\\\\\\\\\\\\\\  END HYREL HEADER for a 16A with a Heated Head in T1/T12 - 2021.02.24  ///////////////</code>
=== 30M and ESR, T1, Heated ===
Below is our standard header for using a heated head in the second slot with a heated bed on a 16A:
  ; ///////////////  BEGIN HYREL HEADER for a 30M/ESR with an Unheated Head in T0/T11 - 2021.02.24  \\\\\\\\\\\\\\\
 
  ; GENERAL :
 
  N14                ; set line numbers for error logging - Slic3r version
  M772 S1            ; reset metrics and arm automatic reporting
  M627 X0 Y0 Z0 J-500 K5                ; setup abort action
 
 
  M107              ; fans/UV          ; off
  M106 C255          ; fans/UV          ; set to 0-255 range
 
  G53                ; clear offsets
  G21                ; units            : mm
  G91                ; coordinatess      : relative
  G0 Z10           ; drop bed
  G90                ; coordinates      : absolute
 
  G28 Z0            ; home, goto        : Z (ignored if no Z home)
  G28 X0 Y0          ; home, goto        : X and Y
 
  M229 E1 D1        ; enable E-values (volumetric)
 
  ; TEMP CONTROL :
 
  ;M190 S[bed_temperature]          ; bed temp    : set and wait    <= COMMENTED OUT
  ;M109 T11 S[temperature]        ; head temp    : set and wait    <= COMMENTED OUT
 
  T0                ; use FIRST tool position from the left   
 
  ; \\\\\\\\\\\\\\\  END HYREL HEADER for a 30M/ESR with an Unheated Head in T0/T11 - 2021.02.24  ///////////////
== Gcode Footer ==
=== Standard, All Models ===
Below is our standard Gcode footer, which should be at the end of all your gcode files:
  ; ///////////////  BEGIN HYREL STANDARD FOOTER - 2021.02.12  \\\\\\\\\\\\\\\
 
  ; temp control:
 
 
  M107 T100      ; fans, diodes  : off
  M620 T100 E0    ; CO2 lasers    ; off
  M104 T100 S0    ; head temps    : off
  M140 T90 S0    ; bed temps    : off
  M5              ; spindles      : off
 
  ; housekeeping
 
  G91            ; coordinates  : relative
  G0 Z10          ; drop bed
  G90            ; coordinates  : absolute
  G0 Y0          ; home, goto    : Y axis
  G0 X0          ; home, goto    : X axis
  M84            ; motors        : disable
  G53            ; clear offsets
  M30            ; program      : end
 
  ; \\\\\\\\\\\\\\\  END HYREL STANDARD FOOTER - 2021.02.12  ///////////////

Latest revision as of 19:00, 27 August 2021



Main Sections
What is GCode?
Understanding the T
Most Commonly Edited GCodes
Controlling Movement
Controlling Temperature
Controlling Material Flow
Controlling Position and Offsets
Controlling Lasers and UV Pens
Controlling Spindles and Lathes
Reporting and Diagnostics
Controlling Aux Devices
Other Commands
Gcode Headers
Gcode Footer

Note: Codes in Black are supported on version 4 and above (v4+), and most likely on version 3 as well.

Note: Codes in Orange are supported on version 5 and above (v5+) only.

Note that Repetrel versions prior to 4.2 can not properly process gcode with "tab" characters - tab was a reserved character.

What is GCode?

Everything your Hyrel 3D Printer does is done by executing GCode, whether you are aware of it or not.

Every button you press on the screen sends a gcode to the printer.

When you start a job (by pressing "Print"), the settings from your head are sent to the printer (including flow and prime/unprime values); then the gcode file is sent, line by line, to the printer.

All parameters are persistent, so once they are set, they will remain in place unless or until you (or the file) sends a new, updated value (including setting to 0).

Please note that there are many flavors of gcode, and while most have the same (or very similar) G0-G100 and M0-M100, codes above 100 are largely nonstandard.

It is important to remember that different variable letters can have different meanings, depending on the G- or M- code being used - especially the T value.

The Table of Contents to the right lists the main categories of Gcodes.

Below is a table listing them in numerical order (click Expand to expand):

Code_Chart
Code Supported Brief Description
G0 Yes Rapid Move
G1 Yes Working Move
G2 Yes Clockwise Arc
G2.1 Yes Spiral CW Arc1
G2.2 Yes Spiral CW Arc2
G2.3 Yes 3-Space CW Spiral Arc
G3 Yes Counterclockwise Arc
[[#G3.1_Spiral_CCW_Arc1|G3.1]] Yes Spiral CCW Arc1
G3.2 Yes Spiral CCW Arc2
G3.3 Yes 3-Space CCW Spiral Arc
G4 Yes Timed Pause
G10 No Absolute E
G11 No Relative E
G16 Yes Arc in Any Plane
G17 Yes Arc in XY Plane
G18 Yes Arc in XZ Plane
G19 Yes Arc in YZ Plane
G20 Yes Set Units to Inches
G21 Yes Set Units to Milimeters
G28 Yes Send X, Y to Physical Home
G53 Yes Clear Offsets
G54-59 Yes Set Offsets
G81 Yes Peck Drilling
G90 Yes Absolute Positioning
G91 Yes Relatative Positioning
G92 Yes Reset Coordinates
G93 Yes Reset Coordinates
M0 Yes Stop Until Resume
M3 Yes Spindle On CW
M4 Yes Spindle On CCW
M5 Yes Spindle Off
M6 Yes Declare Head Offsets
M7 Yes Aux 1 On (Mist)
M8 Yes Aux 2 On (Flood)
M9 Yes All Aux Off
M17 Yes Engage Motors
M18 Yes Disengage Motors
M30 Yes End of Program
M82 Yes Absolute E-Values
M83 Yes Relative E-Values
M84 Yes Disable Motors
M104 Yes Set Temp (Head)
M106 Yes Set Cooling / Etc.
M107 Yes Stop Cooling / Etc.
M109 Yes Wait for Temp (Head)
M116 v5+ Pause for All Temps
M140 Yes Set Temp (Bed)
M141 Yes Set Temp (Chamber)
M190 Yes Wait for Temp (Bed)
M191 Yes Wait for Temp (Chamber)
M203 Yes Set G0 Speed
M221 Yes Set Flow Rate
M229 Yes Use E Values
M253 Yes Turn On Lathe (CW)
M254 Yes Turn On Lathe (CCW)
M255 Yes Turn Off Lathe
M619 Yes Map Aux Port
M620 Yes Enable Device
M621 Yes Set Laser Power
M623 Yes Duration Emit
M660 Yes Set Tool Offsets
M670 Yes Enable Y-arm (Gantry) Lights
M671 Yes Activate X-Arm (Danger) Lights
M672 Yes Set Y-arm Light
M674 Yes Rapid G1 Moves
M675 Yes Activate Response LEDs
M676 Yes Activate Recirc. Fan
M677 Yes Activate Buzzer
M678 Yes Activate Laser X-hair
M679 Yes Activate Vacuum
M684 Yes Activate Exhaust
M685 Yes Activate Air
M689 Yes Activate Ext. Head
M701 Yes Set Head Reporting
M702 Yes Establish Clone Squad
M703 Yes Add to Clone Squad
M704 Yes Remove from Clone Squad
M718 Yes Stop Logging to File
M719 Yes Start Logging to File
M721 Yes Set Unprime Values
M722 Yes Set Prime Values
M723 Yes Set Manual Flow
M728 Yes Set Motor Current Boost
M756 Yes Set Height for Flow
M772 Yes Reset All Metrics
M773 Yes Generate Basic Report
M783 Yes Tie Aux to Extrusion
M790 Yes New Layer Actions
M791 Yes Snap Image
M792 Yes Execute Action

Header Explained

Please visit GCode Header for a detailed description of our standard GCode headers.


Understanding the T

A T Command changes which head has the focus of the motion controller and is executing the gcode. Each of our printers have at least four tool positions.

The use of T commands and variables changes greatly (for the better) with the jump to version 5 from the previous versions.

Please see T_v4 for the old way (v4 and earlier), where the nomenclature for T Commands and the T Variables were not the same.

Please see T_v5 for the new way (v5 and later), where the nomenclature for T Commands and the T Variables are the same.

We will use a T# in the descriptions below to avoid confusion; please find the correct designation for your version by following the links above.

Most Commonly Edited Gcodes

Below are the gcodes users should first become familiar with.

Tool Changes

T0 tells the printer to perform extrusion (or emission) from the tool in the far left position
T1 tells the printer to perform extrusion (or emission) from the tool in the second-from-left position
T2 tells the printer to perform extrusion (or emission) from the tool in the third-from-left position
T3 tells the printer to perform extrusion (or emission) from the tool in the fourth-from-left position
T4 tells the printer to perform extrusion (or emission) from the tool in the fifth-from-left position (if available)

Movement

G0 for "rapid", non-printing moves
G1 for "working speed" moves, which may be printing (with E value) or non-printing (no E value)

Temperature

M104 to set head temp
M109 to set and wait for head temp
M140 to set bed temp
M190 to set and wait for bed temp

Others

Which commands to learn from here will depend on what the user intends to do with the equipment.

Controlling Movement

Controlling Movement
Code Supported Brief Description
G0 Yes Rapid Move
G1 Yes Working Move
G2 Yes Clockwise Arc
G2.1 Yes Spiral CW Arc1
G2.2 Yes Spiral CW Arc2
G2.3 Yes 3-Space CW Spiral Arc
G3 Yes Counterclockwise Arc
[[#G3.1_Spiral_CCW_Arc1|G3.1]] Yes Spiral CCW Arc1
G3.2 Yes Spiral CCW Arc2
G3.3 Yes 3-Space CCW Spiral Arc
G4 Yes Timed Pause
G16 Yes Arc in Any Plane
G17 Yes Arc in XY Plane
G18 Yes Arc in XZ Plane
G19 Yes Arc in YZ Plane
M0 Yes Stop Until Resume
M203 Yes Set G0 Speed
M674 Yes Rapid G1 Moves

G0 Rapid Move

G0 is a rapid positioning move. It is not a working move, meaning that your equipment will not be printing, milling, lasering, or doing any other active work during a G0 move. G0 is intended to move your tool to a new position, where the work will happen. Accordingly, G0 movement speeds are set in your configuration settings, rather than being specified in your gcode file.

Special note: a G0 command will take an F variable as a nonpersistent, one-time velocity setting.

Usage

 G0 Xn Yn Zn An Bn Fn

Parameters

 Xn is the new X position to move to
 Yn is the new Y position to move to
 Zn is the new Z position to move to 
 An is the new A position to move to
 Bn is the new B position to move to
 Fn is the feed rate or travel speed to use. Only on G0 is it not persistent

Any values not stipulated remain unchanged.

Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on G90 absolute positioning or G91 relative positioning. Absolute is the default and should be used in the majority of cases.

Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.

Example

 G0 X50 Y75 Z10

This command is decoded and executed by the printer as follows:

  • G0 (rapid (nonprinting) straight line move from the current location to)
    • X50 (50mm in the X)
    • Y75 (75mm in the Y)
    • Z10 (10mm in the Z)
    • (no change in A)
    • (no change in B)
    • (no change in F, use settings-specified feed rate)



G1 Working Move

G1 is a working move, during which you may be printing, milling, lasering, or doing other active work - provided an E (extrude) value is given. In native mode (if you don't add M229 E1 Dn, the value of Extrusion rate E will be ignored, but E will trigger a working or printing move. In E-value mode (by adding M229 E1 Dn, the slicer-determined E value will be used to control material flow. G1 moves are made at the rate indicated by the F (feed rate) value; if no F value is specified, the last F value set will be used. See M229 for more details.

Usage

 G1 Xn Yn Zn An Bn Fn Sn

Parameters

 Xn is the new X position to move to
 Yn is the new Y position to move to
 Zn is the new Z position to move to 
 An is the new A position to move to
 Bn is the new B position to move to
 Hn is the stored head offset to apply (see M660 to store offsets)
 Fn is the feed rate or travel speed to use. Only on G0 is it not persistent
 Sn is a one-time (non-persistent) material flow rate multiplier (rarely used) applied to this move only

Any values not stipulated remain unchanged.

Note: These positioning values can be absolute or relative to the last position; which depends on whether you are running on G90 absolute positioning or G91 relative positioning. Absolute is the default and should be used in the majority of cases; there will be problems with an entire model sliced in relative mode. Relative is intended for special operations like drilling holes.

Note: All Hyrel printers have built-in support for three axes. Hyrel model 16A and EHR printers may be expanded to five; an additional axis on each machine is reserved for E values.

Example

 G1 X50 Y75 E1 F1800 H2

This command is decoded and executed by the printer as follows:

  • G1 (working speed straight line move from the current location to)
    • X50 (50mm in the X)
    • Y75 (75mm in the Y)
    • (no change in A)
    • (no change in B)
    • E1 (while extruding)
    • F1800 (moving at 1800mm/min)
    • H2 (invoking offsets stored in register H2)
    • (no temporary scaling)



G2 Clockwise Arc

A G2 move specifies a clockwise arc (or complete circle) from the current position to position (X,Y,Z)curr by following an arc about the center point (Xcurr+I, Ycurr+J).

Usage

 G2 Xn Yn Zn In Jn Fn En Sn

Parameters

 Xn is the new X position to move to
 Yn is the new Y position to move to
 Zn is the new Z position to end at (optional and usually not stipulated)
 In is the relative distance from the current X position to the center position about which to arc (default 0)
 Jn is the relative distance from the current Y position to the center position about which to arc (default 0)
 Fn is the Feed rate (travel speed) at which to execute this move.
 En indicates a working or printing move
 Sn dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
   S values less than 3.0 dictate the length in mm of each segment for this element
   S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°

Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.

Example

 G2 X50 Y75 I15 J20 E1 F1800

This command is decoded and executed by the printer as follows:

  • G2 (working speed clockwise arc/circle move from the current location to)
    • X50 (50mm in the X)
    • Y75 (75mm in the Y)
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • E1 (while extruding)
    • F1800 (moving at 1800mm/min)

Example

 G2 X50 Y75 I15 J20 E1 S6

This command is decoded and executed by the printer as follows:

  • G2 (working speed clockwise arc/circle move from the current location to)
    • X50 (50mm in the X)
    • Y75 (75mm in the Y)
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • E1 (while extruding)
    • (using previously established F rate)
    • S6 (made up of six sides - resulting in a hexagon with one point at the origin, with all corners inscribed on the circle)



G2.1 Spiral CW Arc1

A G2.1 makes a spiral circular move (only supports full 360 arcs, or Ln * 360). This arc is CW if spiraling in and CCW if spiraling out. Effective ending X/Y is always the same as the current XY and is not specified (though the actual final position is a function of the number of laps, the pitch, and the reverse code. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs). An important feature is the "reverse code" to allow the creation of frog toes without having to jump over the frog toe once it's made.

Usage

 G2.1 Zn In Jn Pn Ln En Sn Rn Fn

Parameters

 Zn is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
 In is the relative distance from the current X position to the center position about which to arc (default 0)
 Jn is the relative distance from the current Y position to the center position about which to arc (default 0)
   Note: In and Jn both default to 0, but at least one of them must be explicitly declared with a non-zero value.
 Pn is the pitch (how close the laps are) in mm (required)
 Ln is the number of laps to complete (must be a positive integer; you don't need to finish the spiral)
 En indicates a working or printing move
 Sn dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
   S values less than 3.0 dictate the length in mm of each segment for this element
   S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°
 Rn is a flag; 0 to spiral in (default), 1 to spiral out (after inward jump), 2 spiral out from current position
 Fn is the Feed rate (travel speed) at which to execute this move.

Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.

Example 1

 G2.1 I15 J20 P1.2 E1

This command is decoded and executed by the printer as follows:

  • G2.1 (working speed clockwise spiral move from the current location)
    • (no change in Z)
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • (complete all laps)
    • P1.2 (1.2 mm between centers of travel of adjacent laps)
    • E1 (while extruding)
    • (use default S of 0.33333 mm segments)
    • (use default R of 0, spiral in toward center from current location)
    • (moving at established G1 F speed)

Example 2

 G2.1 Z10 I15 J20 P0.5 L50 E1 S9 R1 F1200

This command is decoded and executed by the printer as follows:

  • G2.1 (working speed clockwise spiral move from the current location)
    • Z10 (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • L50 (complete no more than 50 laps)
    • P0.5 (0.5 mm between centers of travel of adjacent laps)
    • E1 (while extruding)
    • S9 (each 360 degrees composted of a total of 9 segments)
    • R1 (spiral out from center to current location)
    • F1200 (at a speed of 1200 mm/min)

Example 3

 G0 X0 Y25                   ; start location for outer spiral
 G0 Z1                       ; go to print layer height
 G2.1 I25 J0 P4 L3 E1        ; spiral in 3 laps, 4mm pitch 
 G1 X14 E1                   ; add connector for the arcs
 G2.1 I11 J0 P4 L3 E1 R2     ; spiral out 3 laps, 4mm pitch

This gcode generates the following:

Spiral.png



G2.2 Spiral CW Arc2

A G2.2 makes a spiral circular move (only supports full 360 arcs, or Ln * 360). This arc is CW if spiraling in and CCW if spiraling out. Unlike G2.1, G2.2 specifies final X/Y (and Z) location. An end Z can be supplied to have a uniform displacement during the move. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs). Unlike G2.1, G2.2 does not require a reverse code as the direction of spiral is determined by the positional relationship of the current position, final position, and center position.

Usage

 G2.2 Xn Yn Zn In Jn Pn Ln En Sn Rn Fn

Parameters

 Xn is the new X position to move to
 Yn is the new Y position to move to
 Zn is the new Z position to end at (optional and usually not stipulated; will be relative or absolute, depending on current mode)
 In is the relative distance from the current X position to the center position about which to arc (default 0)
 Jn is the relative distance from the current Y position to the center position about which to arc (default 0)
   Starting with Motion Controller firmware 4.203a:
   If I and J are both zero (center = start), path will spiral outward CCW from current to final position.
   If I and J match the end (center = end), path will spiral inward CW from current to final position."
 Pn is the pitch (how close the laps are) in mm (optional)
 Ln is the number of laps (or paths) to complete (you don't need to finish the spiral)
   Note, if P and L values conflict, L will be modified to match what P will allow; at least one must be specified
 En indicates a working or printing move
 Sn dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
   S values less than 3.0 dictate the length in mm of each segment for this element
   S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°
 Fn is the Feed rate (travel speed) at which to execute this move.

Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.

Example 1

 G2.2 I15 J20 P1 E1

This command is decoded and executed by the printer as follows:

  • G2.2 (working speed clockwise spiral move from the current location)
    • (no change in Z)
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • P2 (1mm between centers of travel of adjacent laps)
    • (complete all laps)
    • E1 (while extruding)
    • (use default S of 0.33333 mm segments)
    • (moving at established G1 F speed)

Example 2

 G2.2 Z10 I15 J20 P2 L50 E1 S9 F1200

This command is decoded and executed by the printer as follows:

  • G2.2 (working speed clockwise spiral move from the current location)
    • Z10 (change Z position incrementally during move to end at Z10 (relative or absolute, depending on current mode))
    • (centered about a point located)
    • I15 (15mm further in the X)
    • J20 (20mm further in the Y)
    • P2 (2mm between centers of travel of adjacent laps)
    • L50 (complete no more than 50 laps)
    • E1 (while extruding)
    • S9 (each 360 degrees composted of a total of 9 segments)
    • F1200 (at a speed of 1200 mm/min)

Example 3

 G0 X0 Y25                   ; start location for outer spiral
 G0 Z1                       ; go to print layer height
 G2.2 X12 I25 P4 E1          ; spiral in 3 laps, 4mm pitch
 G1 X14 E1                   ; add connector to next spiral
 G2.2 X2 I11 P4 E1           ; spiral out 3 laps, 4mm pitch

This gcode also generates the following:

Spiral.png



G2.3 3-Space CW Arc

A G2.3 move specifies a clockwise arc (or complete circle(s) from the current position to position (X,Y,Z)curr following a circular arc about the center point (Xcurr+I, Ycurr+J, Zcurr+K). Unlike G2, G2.1 and G2.2, G2.3 is not bound to the X/Y plane. The number of full 360 arcs can be specified as well as the pitch (centerline between arcs). Usage

 G2.3 Xn Yn Zn An Bn In Jn Kn Un Vn Wn Dn Pn En Sn Fn

Note: If we are in G16 mode, Un, Vn, Wn define the vector normal to the work plane. If we are in G17 (X/Y plane) or G18 (X/Z plane) or G19 (Y/Z plane) mode, these are ignored.

Parameters

 Xn is the new X position to end at
 Yn is the new Y position to end at
 Zn is the new Z position to end at
 An is the new A position to end at (4th axis)
 Bn is the new B position to end at (5th axis)
 In is the relative distance from the current X position to the center position about which to arc (default 0)
 Jn is the relative distance from the current Y position to the center position about which to arc (default 0)
 Kn is the relative distance from the current Z position to the center position about which to arc (default 0)
   Note: In, Jn, and Kn all default to 0, but at least one of them must be explicitly declared with a non-zero value.
 Un is the X component of a vector normal to the working plane (default 0)
 Vn is the Y component of a vector normal to the working plane (default 0) 
 Wn is the Z component of a vector normal to the working plane (default 0)
 Dn is the overall displacement normal to the working plane for this element
 Pn is the pitch (how close the laps are normal to the working plane) in mm (default 0; one path, no incremental displacement)
 En indicates a working or printing move
 Sn dictates how many segments are used to create the arc (or circle); 0.33333 mm is the default value
   S values less than 3.0 dictate the length in mm of each segment for this element
   S values of 3.0 or more dictate how many total segments comprise this element - only allowed on complete circles of 360°
 Fn is the Feed rate (travel speed) at which to execute this move.

Any values not stipulated remain unchanged. We will print this element with our native Hyrel flow calculations (based on nozzle diameter, layer thickness, and feed rate) even if your gcode has enabled the use of E values with M229 E1 D1.



G3 Counterclockwise Arc

Please refer to G2, above, for details. All options are identical, with the exception of direction (CCW).



G3.1 Spiral CCW Arc1

Please refer to G2.1, above, for details. All options are identical, with the exception of direction (CCW if spiraling in and CW if spiraling out).



G3.2 Spiral CCW Arc2

Please refer to G2.2, above, for details. All options are identical, with the exception of direction (CCW if spiraling in and CW if spiraling out).



G3.3 3-Space CCW Arc

Please refer to G2.3, above, for details. All options are identical, with the exception of direction (CCW).



G4 Timed Pause

G4 is a pause for a set number of seconds (S) or milliseconds (P).

Usage

 G4 Sn Pn

Parameters

 Sn is the number of Seconds to pause
 Pn is the number of Milliseconds to pause

You may use S or P, or if you use both, the total value will be the pause duration.

Example

 G4 S0.5

This command is decoded and executed by the printer as follows:

  • G4 (Timed pause)
    • S0.5 (0.5 seconds)

Example

 G4 P500

This command is decoded and executed by the printer as follows:

  • G4 (Timed pause)
    • P500 (500 milliseconds)



G16 Arc Plane: Any

G16 permits free-form designation of points in space, without limiting them to an axial plane.

G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.

Usage

 G16

Parameters

 N/A

Example

 G16

This command is decoded and executed by the printer as follows:

  • G16 (allow element in any orientation)



G17 Arc Plane: XY

G17 restricts this element to the X/Y plane.

G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.

Usage

 G17

Parameters

 N/A

Example

 G17

This command is decoded and executed by the printer as follows:

  • G17 (restrict element to X/Y plane)



G18 Arc Plane: XZ

G18 restricts this element to the X/Z plane.

G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.

Usage

 G18

Parameters

 N/A

Example

 G18

This command is decoded and executed by the printer as follows:

  • G18 (restrict element to X/Z plane)



G19 Arc Plane: YZ

G19 restricts this element to the Y/Z plane.

G16 through G19 only apply to G2.x and G3.x commands, and define the plane on which the element will be created.

Usage

 G19

Parameters

 N/A

Example

 G19

This command is decoded and executed by the printer as follows:

  • G19 (restrict element to Y/Z plane)



M0 Stop Until Resume

M0 is a stop until resume command; text listed after a semicolon will be displayed, and clicking the Play button (which replaces the Pause button) will cause the job to resume. Note that all lines will be truncated at 100 characters.

  • ; All text following the ; will be echoed to the print mask (Control Tab).

Additionally, an M0 command can also take the following parameters, and so will pause and then:

Usage

 M0 [ SAY | PIC | VID | SEND | BEEP | SHELL ]

Parameters

 SAY sample message - the computer will use built-in text-to-speech to echo the message over the speaker(s)
 PIC C:\sample.jpg - the computer will display the image at the specified location
 VID C:\sample.mp4 - the computer will play the video at the specified location
 SEND sample message - the computer will send the message to the Aux port if connected
 BEEP - the computer will sound a beep
 SHELL C:\program.exe - the computer will execute the file at the specified location

Note that multiple options can be combined.

Example

 M0

This command is decoded and executed by the printer as follows:

  • M0 (Pause until Resume)

Example

 M0 ; SAY Hello Wilbur ; PIC C:\mr_ed.png

This command is decoded and executed by the printer as follows:

  • M0 (Pause until Resume)
    • SAY Hello Wilbur (Announce Text: Hello Wilbur)
    • PIC C:\mr_ed.png (Display Image: C:\mr_ed.png)



M203 Set G0 Speed

M203 will redesignate the rate at which G0 movements are executed. If undeclared, the values stored in Repetrel for your equipment will be used. These can be changed under Settings > Printer, on the Printer tab. The values set on your unit are set based on testing; exceed them at your own risk.

Usage

 M203 Xn Yn Zn An Bn

Parameters

 Xn is the new speed in the X axis for G0 moves
 Yn is the new speed in the Y axis for G0 moves
 Zn is the new speed in the Z axis for G0 moves
 An is the new speed in the A axis for G0 moves
 Bn is the new speed in the B axis for G0 moves

Example

 M203 Y2000

This command is decoded and executed by the printer as follows:

  • M203 (Set G0 Speed)
    • (X remains unchanged)
    • Y2000 (Y axis: 2000mm/min)
    • (Z remains unchanged)
    • (A remains unchanged)
    • (B remains unchanged)



M674 Use Turbo Mode

M674 will enable Turbo Mode, where certain non-printing (no E value) working (G1, G2, or G3) moves will be treated as G0 moves (executed at "rapid move speed" rather than "working move speed"). Killing a job will clear the M674 setting.

Usage

 M674 Sn

Parameters

 Sn is the minimum distance threshold for Turbo Mode to activate, and is required; no S value returns an error.

Example 1

 M674 S2

This command is decoded and executed by the printer as follows:

  • M674 (Set Turbo Mode)
    • S2 (for moves of 2 mm or greater)

Example 2

 M674 S50

This command is decoded and executed by the printer as follows:

  • M674 (Set Turbo Mode)
    • S50 (for moves of 50 mm or greater)



Back to top

Controlling Temperature

Controlling Temperature
Code Supported Brief Description
M104 Yes Set Temp (Head)
M106 Yes Set Cooling / Etc.
M107 Yes Stop Cooling / Etc.
M109 Yes Wait for Temp (Head)
M116 v5+ Pause for All Temps
M140 Yes Set Temp (Bed)
M141 Yes Set Temp (Chamber)
M190 Yes Wait for Temp (Bed)
M191 Yes Wait for Temp (Chamber)

What's Hotbed 2 and Chamber 2? Well, our Hydra models have room to have a second hotbed, which could be a smaller, higher temperature hotbed, or a sub-ambient chilled bed, or even a High Resolution hotbed. And we've talked about having a smaller chamber inside the primary chamber, to bring the air around the print (but not the head) to much higher temperatures; call for details.



M104 Set Temp (Head)

M104 sets the extruder temperature but does not pause the printer.

Note that the actual T# values can be found on T_v4 or T_v5, depending on which version you are running.

Usage

 M104 Sn T#

Parameters

 Sn is the new set temperature in °C
 T# is the tool assignment for this temperature command

Example

M104 T# S75 

This command is decoded and executed by the printer as follows:

  • M104 (Set Cooling/LEDs)
    • T# (target head)
    • S75 (to 75°C)



M106 Set Cooling / Etc.

M106 sets the cooling fan (or crosslinking LEDs) speed (or intensity). This also turns on the Quiet Storm fan.

Usage

 M106 Cn

or

 M106 T# Sn

or

 M106 T# Pn

Parameters

 T# is the target head
 Sn is the percent of duty cycle for the cooling fan (or LEDs); default: 100
 Cn is the range (0-100 or 0-255) that we will use; if unspecified, the default is C100 (use C255 to be compatible with most slicers)
 Pn is the percent of duty cycle for the cooling fan (or LEDs) to come on only during extrusion moves

Example

 M106 C255

This command is decoded and executed by the printer as follows:

  • M106 (Set Cooling/LEDs)
    • (on all tools)
    • (no speed)
    • C255 (of range 0-255)

Note, with this command, all following M106 commands for the rest of this print job will be based on this range (unless specified with a new C value).

Example

 M106 T# S50

This command is decoded and executed by the printer as follows:

  • M106 (Set Cooling/LEDs)
    • T# (target head)
    • S50 (target value of 50)
    • (previously defined (or default 0-100) range)

Example

M106 T# P100 

This command is decoded and executed by the printer as follows:

  • M106 (Set Cooling/LEDs)
    • T# (target head)
    • P100 (during extrusion moves at 100% duty cycle

But Davo, I want to cure a certain spot for 10 seconds with every layer change; how do I do this?

Easy. Edit your slicer recipe to add the following code after layer changes (edit as needed for duration, intensity, or position):

 ;---- BEGIN COD CODE
 G91 ; relative moves
 G0 Z5 ; drop bed
 G90 ; absolute moves
 G0 X130 Y110 ; move into position
 M106 S100 T# ; turn on T# UV at 100%
 G1 X140 Y110 F100 ; move 10 mm in the X at 100 mm/min
 G1 X140 Y120 F100 ; move 10 mm in the Y at 100 mm/min
 G1 X130 Y120 F100 ; move -10 mm in the X at 100 mm/min
 G1 X130 Y110 F100 ; move -10 mm in the Y at 100 mm/min
 M106 S0 T# ; turn off T# UV (set it to 0%)
 ;--- END COD GCODE

These commands are decoded and executed by the printer as follows:

  • G91 (Use relative moves)
  • G0 (Non-working move)
    • Z5 (+5 mm in the Z)
  • G90 (Use absolute moves)
  • G0 (Non-working move)
    • X130 (To position X130)
    • Y110 (To position Y110)
  • M106 (Set Aux (UV))
    • S100 (100% duty)
    • T# (On target head)
  • G1 (Working (printing) move)
    • X140 (To position X140)
    • Y110 (To position Y110
    • F100 (At 100 mm/min)
  • G1 (Working (printing) move)
    • X140 (To position X140)
    • Y120 (To position Y120
    • F100 (At 100 mm/min)
  • G1 (Working (printing) move)
    • X130 (To position X130)
    • Y120 (To position Y120
    • F100 (At 100 mm/min)
  • G1 (Working (printing) move)
    • X130 (To position X130)
    • Y110 (To position Y110
    • F100 (At 100 mm/min)
  • M106 (Set Aux (UV))
    • S0 (0% duty)
    • T# (On target head)



M107 Stop Cooling / Etc.

M107 turns off the cooling fan (or crosslinking LEDs); this is essentially the same as an M106 S0 (setting it to 0 percent). This will also turn off the Quiet Storm fan.

Usage

 M107 T#

Parameters

 T# (target head)

Example

M107 T#  

This command is decoded and executed by the printer as follows:

  • M107 (Set Cooling/LEDs to 0%)
    • T# (target head)



M109 Wait for Temp (Head)

M109 waits for the extruder to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) heads as options.

Note that the actual T# values can be found on T_v4 or T_v5, depending on which version you are running.

Usage

 M109 T# Sn Hn Cn Ln Un Rn W0

Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M109 command.

Note, this will FAIL (non-fatally) if you address a virtual group address; be sure to use an actual physical address.

Parameters

 T# is the target head - (required)
 Sn (optional) is the new set temperature in °C; if omitted, no new target temperature is set
 Hn if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
 Cn if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
 Ln if present, is the lower-end relative temperature difference from set temp after which we stop pausing
 Un if present, is the upper-end relative temperature difference from set temp after which we stop pausing
 Rn if present, is how close the relative temperature needs to be to the set temp to end the pause
 W0 if present, will set the temp and advance to the next line without pause, but upon executing M116, will pause until temp is reached

Think of Sn as the target temperature, but once the target is between Cn (or Ln) and Hn (or Un), the pause is over (but the Sn is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.

Example 1

 M109 T# S240

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S240 (and set temp to 240°C)

Example 2

 M109 T# S240 R5

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S240 (and set temp to 240°C)
    • R5 (but end the wait once the target's temperature is within 5°C of the set point)

Example 3

 M109 T# S240 H230

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S240 (and set temp to 240°C)
    • H230 (but end the wait once the target's temperature reaches 230°C)

Example 4

 M109 T# S240 L10 U5

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S240 (and set temp to 240°C)
    • L10 (but end the wait once the target's temperature reaches 10°C below the set point)
    • U5 (or end the wait once the target's temperature reaches 5°C above the set point)

Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C

Example 5

 M109 T# S0 R5

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S0 (to 0°C)
    • R5 (but end the wait once the target's temperature is +/-5°C of the set temperature)

Example 6

 M109 R10
  • M109 (wait for temp)
    • (no T# - use head with current focus)
    • R10 (to get +/-10°C of set temperature)

Example 7

 M109 T# S240 W0

This command is decoded and executed by the printer as follows:

  • M109 (wait for temp)
    • T# (target head)
    • S240 (and set temp to 240°C)
    • W0 (but do not pause until M116 is executed)



M116 Wait for Temps (v5+)

M116 is supported with version 5.x and later (v5+) of Repetrel Software and Motion Controller Firmware.

Usage

 M116 

Parameters

 'none'

Example

 M116

This command is decoded and executed by the printer as follows:

  • M116 (wait for any set temps (M109, M190, M191) with W0 values before proceding



M140 Set Temp (Bed)

M140 sets the bed temperature (without waiting for the new temperature to be reached).

Usage

 M140 Sn T#

Parameters

 Sn is the new set temperature in °C
 T# is the target bed (default is the primary bed)

Example

M140 S75

This command is decoded and executed by the printer as follows:

  • M140 (set bed temperature)
    • S75 (to 75°C)
    • (on primary bed)



M141 Set Temp (Chamber)

M141 sets the chamber temperature (without waiting for the new temperature to be reached).

Usage

 M141 Sn T#

Parameters

 Sn is the new set temperature in °C
 T# is the target chamber (default is the primary chamber)

Example

M141 S75

This command is decoded and executed by the printer as follows:

  • M141 (set chamber temperature)
    • S75 (to 75°C)
    • (on primary chamber)



M190 Wait for Temp (Bed)

M190 waits for the bed to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) beds as options.

Usage

 M190 T# Sn Hn Cn Ln Un Rn

Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M190 command.

Note, this will FAIL (non-fatally) if you address a virtual group address; be sure to use an actual physical address.

Parameters

 T# (optional) is the target bed (default is the primary (or only) bed)
 Sn (optional) is the new set temperature in °C; if omitted, no new target temperature is set
 Hn if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
 Cn if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
 Ln if present, is the lower-end relative temperature difference from set temp after which we stop pausing
 Un if present, is the upper-end relative temperature difference from set temp after which we stop pausing
 Rn if present, is how close the relative temperature needs to be to the set temp to end the pause

Think of Sn as the target temperature, but once the target is between Cn (or Ln) and Hn (or Un), the pause is over (but the Sn is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.

Example 1

 M190 T# S240

This command is decoded and executed by the printer as follows:

  • M190 (wait for temp)
    • T# (target bed)
    • S240 (and set temp to 240°C)

Example 2

 M190 T# S240 R5

This command is decoded and executed by the printer as follows:

  • M190 (wait for temp)
    • T# (target bed)
    • S240 (and set temp to 240°C)
    • R5 (but end the wait once the target's temperature is within 5°C of the set point)

Example 3

 M190 T# S240 H230

This command is decoded and executed by the printer as follows:

  • M190 (wait for temp)
    • T# (target bed)
    • S240 (and set temp to 240°C)
    • H230 (but end the wait once the target's temperature reaches 230°C)

Example 4

 M190 T# S240 L10 U5

This command is decoded and executed by the printer as follows:

  • M190 (wait for temp)
    • T# (target bed)
    • S240 (and set temp to 240°C)
    • L10 (but end the wait once the target's temperature reaches 10°C below the set point)
    • U5 (or end the wait once the target's temperature reaches 5°C above the set point)

Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C

Example 5

 M190 T# S0 R5

This command is decoded and executed by the printer as follows:

  • M190 (wait for temp)
    • T# (target bed)
    • S0 (to 0°C)
    • R5 (but end the wait once the target's temperature is +/-5°C of the set temperature)

Example 6

 M190 R10
  • M190 (wait for temp)
    • (no T# - use bed with current focus)
    • R10 (to get +/-10°C of set temperature)



M191 Wait for Temp (Chamber)

M191 waits for the chamber to reach temperature, with an option to also set the temperature. Remember, we have both heated and chilled (sub-ambient) chambers as options.

Usage

 M191 T# Sn Hn Cn Ln Un Rn

Please use EITHER (H and/or C) OR (L and/or U) OR (R) with your M191 command.

Note, this will FAIL (non-fatally) if you address a virtual group address; be sure to use an actual physical address.

Parameters

 T# is the target chamber (default is the primary (or only) chamber)
 Sn (optional) is the new set temperature in °C; if omitted, no new target temperature is set
 Hn if present, is the low-end (or "heat up to") absolute temperature after which we stop pausing
 Cn if present, is the high-end (or "cool down to") absolute temperature after which we stop pausing
 Ln if present, is the lower-end relative temperature difference from set temp after which we stop pausing
 Un if present, is the upper-end relative temperature difference from set temp after which we stop pausing
 Rn if present, is how close the relative temperature needs to be to the set temp to end the pause

Think of Sn as the target temperature, but once the target is between Cn (or Ln) and Hn (or Un), the pause is over (but the Sn is still the set temp to reach. You can use Hn or Ln, but not both. You can use Cn or Un, but not both.

Example 1

 M191 T# S240

This command is decoded and executed by the printer as follows:

  • M191 (wait for temp)
    • T# (target chamber)
    • S240 (and set temp to 240°C)

Example 2

 M191 T# S240 R5

This command is decoded and executed by the printer as follows:

  • M191 (wait for temp)
    • T# (target chamber)
    • S240 (and set temp to 240°C)
    • R5 (but end the wait once the target's temperature is within 5°C of the set point)

Example 3

 M191 T# S240 H230

This command is decoded and executed by the printer as follows:

  • M191 (wait for temp)
    • T# (target chamber)
    • S240 (and set temp to 240°C)
    • H230 (but end the wait once the target's temperature reaches 230°C)

Example 4

 M191 T# S240 L10 U5

This command is decoded and executed by the printer as follows:

  • M191 (wait for temp)
    • T# (target chamber)
    • S240 (and set temp to 240°C)
    • L10 (but end the wait once the target's temperature reaches 10°C below the set point)
    • U5 (or end the wait once the target's temperature reaches 5°C above the set point)

Note: this wait ends when the target's temperature is anywhere between 230°C and 245°C

Example 5

 M191 T# S0 R5

This command is decoded and executed by the printer as follows:

  • M191 (wait for temp)
    • T# (target chamber)
    • S0 (to 0°C)
    • R5 (but end the wait once the target's temperature is +/-5°C of the set temperature)

Example 6

 M191 R10
  • M191 (wait for temp)
    • (no T# - use chamber with current focus)
    • R10 (to get +/-10°C of set temperature)



Back to top

Controlling Material Flow

Controlling Material Flow
Code Supported Brief Description
G10 No Absolute E
G11 No Relative E
M82 Yes Absolute E-Values
M83 Yes Relative E-Values
M221 Yes Set Flow Rate
M229 Yes Use E Values
M721 Yes Set Unprime Values
M722 Yes Set Prime Values
M723 Yes Set Manual Flow
M728 Yes Set Motor Current Boost
M756 Yes Set Height for Flow

You can specify flow rate variables in your gcode; we do not do this by default, but take these values from the head itself. Any values you stipulate in your gcode will supersede the values stored on the head. With our recipes the slicing program generates gcode which dictates temperature and movement commands and indicates which moves should dispense material (a G1 move with an E value).

However, we have two different ways to control flow.

  • If you use M229 E1 D1 we will use the E values generated by the slicer for printing moves, but we will always use the prime/unprime settings on the head for advancing and retracting when transitioning between printing and non-printing moves. This allows for varying extrusion widths and layer thicknesses (on the same layer - as with support material). This is how just about all slicers and printers work.
  • If you do not use that command, we do not use that E value (except to distinguish printing from non-printing moves) we calculate for flow based purely on travel speed, declared layer thickness, and nozzle diameter. This is explained at http://hyrel3d.net/wiki/index.php/Flow_Rate

When a head is loaded, it sends this flow data (how to calculate flow, as well as how much to prime and unprime (advance and retract) material when transitioning between printing and non-printing moves - and even how many primes or unprimes to do in conjunction with a tool change.

In this way, the very same gcode (with temperature changes) can be used with any material, provided you are using the same physical parameters that the model was sliced for.



G10 UNUSED1

G10 is not recognized by Repetrel.

On some other printers, this will set tool offsets; we do this via M6.

On some other printers, this will do a retract; we do this via M721.



G11 UNUSED

G11 is not recognized by Repetrel.

On some other printers, this will do an advance or unretract; we do this via M722.



M82 Absolute E-Values

M82 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the original (0) point.

Note, this only works on v4 and later, when E values are enabled via M229.

Usage

 M82

Parameters

 N/A

Example

M82

This command is decoded and executed by the printer as follows:

  • M82 (use absolute E values)



M83 Relative E-Values

M83 stipulates that henceforth, the extrusion positioning (E values) will be calculated from the relative (last used) point.

Note, this only works on v4 and later, when E values are enabled via M229.

Usage

 M83

Parameters

 N/A

Example

 M83

This command is decoded and executed by the printer as follows:

  • M83 (use relative E values)



M221 Set Flow Rate

M221 sends information to the printer about material flow.

Note, our default mode is volumetric calculations; if you need to slice with linear calculations, multiply your Pn by approximately 2.4 (you can do the math).

Usage

 M221 Pn Sn Wn Zn T#

Parameters

 Pn is the number of pulses on the motor to dispense 1 μl (for volumetric) or 1 mm (for linear) of material;
 Sn is the direct flow multiplier (to allow for undersized or oversized stock;
 Wn is the width of the cross section of the volume to fill;
 Zn is the height (layer thickness) of the cross section of the volume to fill; and
 T# is the tool (head) to which these values will be applied.

Example

 M221 S1.0 T# P77 W0.5 Z0.3

This command is decoded and executed by the printer as follows:

  • M221 (set flow rate)
    • S1.0 (flow multiplier of 1.0)
    • T# (target head)
    • P77 (77 pulses per microliter)
    • W0.5 (0.5mm nozzle)
    • Z0.3 (0.3mm layer thickness - note that your gcode M756 will overwrite this value)



M229 Use E Values

Starting with version 4, Hyrel will begin to enable the use of E-values in your gcode. Variable extrusion width and support/infill thickness slicers, rejoice! Note, calculations are done for every single move individually.

Usage

 M229 En Dn Sn

Parameters

 En can be 0 (native flow calculation) or 1 (use E values)
 Dn how directed to head; see below
   D0 on head controller directly; constant flow, not adjusted for motion acceleration/deceleration
   D1 on motion controller, sent to head via CANBUS and adjusted for motion acceleration/deceleration
   D2 on motion controller, sent to head via C axis step pin and adjusted for motion acceleration/deceleration
   D3 on motion controller, sent to head via CANBUS and C axis and adjusted for motion acceleration/deceleration
 Sn sets a threshold in seconds; isolated non-printing moves below this threshold will not trigger unprime/prime actions

Note: E1 D0 is an illegal combination.

Example 1

 M229 E1 D1

This command is decoded and executed by the printer as follows:

  • M229 (E values)
    • E1 (enabled)
    • D1 (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)

Above is the default way to enable E values.

Example 2

 M229 E0 D0

This command is decoded and executed by the printer as follows:

  • M229 (E values)
    • E0 (disabled)
    • D0 (flow calculations on head controller)

Above is the default way to ignore E values, and is how v3 and earlier releases work.

Example 3

 M229 E0 D1

This command is decoded and executed by the printer as follows:

  • M229 (E values)
    • E0 (disabled)
    • D1 (flow calculations directed via CANBUS and adjusted to motion acceleration/deceleration)

Example 4

 M229 E0 D0 S0.02

This command is decoded and executed by the printer as follows:

  • M229 (E values)
    • E0 (disabled)
    • D0 (flow calculations on head controller)
    • S0.02 (isolated non-printing moves of under 0.02 seconds will not trigger unprime/prime actions)



M721 Set Unprime Values

M721 sends information to the printer about how much material to unprime when a transition from printing move to non-printing move is detected.

Usage

 M721 Sn En Pn T# In

Parameters

 Sn is the speed at which unprime moves should be executed; this is normally 10,000
 En is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
 Pn is the number of milliseconds relative to the end of the move to begin the unprime (retract) action; a negative number initiates this before the end of the move
 T# is the target head
 In is the flag for executing an Immediate action; so M721 I1 would execute an unprime with the previously specified values at that point in the gcode.

Example 1

M721 S10000 E100 P-15 T#

This command is decoded and executed by the printer as follows:

  • M721 (unprime)
    • S10000 (set rate to 10,000 pps)
    • E100 (set pulses to 100)
    • P-15 (set dwell to 15ms before end of print move )
    • T# (on target head)
    • (but no immediate execution; execute when needed)

Example 2

M721 T# I1

This command is decoded and executed by the printer as follows:

  • M721 (unprime)
    • T# (on target head)
    • I1 (now)



M722 Set Prime Values

M722 sends information to the printer about how much material to prime (advance) when a transition from non-printing move to printing move is detected. This is done primarily to compensate for an earlier unprime (retract), to prep the head to be ready to dispense.

Usage

 M722 Sn En Pn T# In

Parameters

 Sn is the speed at which unprime moves should be executed; this is normally 10,000
 En is the number of pulses on the feed (extrusion) motor to execute; this varies greatly among materials
 Pn is the number of milliseconds to dwell relative to the start of the move to allow for the prime (advance) action
 T# is the target head
 In is the flag for executing an Immediate action; so M722 I1 would execute a prime with the previously specified values at that point in the gcode.

Example

M722 S10000 E100 P-15 T#

This command is decoded and executed by the printer as follows:

  • M721 (prime)
    • S10000 (set rate to 10,000 pps)
    • E100 (set pulses to 100)
    • P-15 (set dwell to 15ms before end of print move )
    • T# (on target head)
    • (but no immediate execution; execute when needed)

Example

M722 T# I1

This command is decoded and executed by the printer as follows:

  • M722 (prime)
    • T# (on target head)
    • I1 (now)



M723 Set Manual Flow

M723 tells the designated extruder(s) to advance material for the specified number of pulses (on the motor) at the specified rate, regardless of any X/Y/Z movement. It is normally used only during manual operation, not during gcode execution. It can be used after moving to a location to dispense a set amount of material (like depositing material into reservoirs).

M723 is also used to activate and set speed on the stirring apparatus on the DMH dynamic mixing head.


Usage

 M723 Sn En T#

Parameters

 Sn is the speed at which the motor should advance, in pulses per second (default: 500);
 En is the number of pulses on the feed (extrusion) motor to execute (default of 65535 is essentially "forever");
 T# is the target head

Example

M723 S500 E50000 T#

This command is decoded and executed by the printer as follows:

  • M723 (start manual feed)
    • S500 (at 500 pulses per second)
    • E50000 (for 50000 pulses)
    • T# (target head)



M728 Set Motor Current Boost

M728 will set the motor current boost; default is 0.

Usage

 M728 Sn T#

Parameters

 Sn is the new set temperature in °C
 T# is the target head (or device)

Example

 M728 T# S0

This command is decoded and executed by the printer as follows:

  • M728 (set motor current boost)
    • T# (target head)
    • S0 (off)



M756 Set Height for Flow

M756 will overwrite the Z value from the M221 command, allowing you to calculate flow for thinner or thicker layers. We declare M756 at the beginning of every layer; normally, they are all the same (unless you sliced for varying layer thicknesses).

Note: this command is ignored if you are using M229 E1 D1 to enable use of E values.

Usage

 M756 Sn

Parameters

 Sn is the layer thickness in mm for flow calculations

Example

 M756 S0.125

This command is decoded and executed by the printer as follows:

  • M756 (set layer height for flow calculations)
    • S0.125 (at 0.125mm)



Back to top

Controlling Position and Offsets

Controlling Position and Offsets
Code Supported Brief Description
G10 No Set Offsets
G20 Yes Set Units to Inches
G21 Yes Set Units to Milimeters
G28 Yes Send to Physical Home
G53 Yes Clear Offsets
G54-59 Yes Set Offsets
G90 Yes Absolute Positioning
G91 Yes Relatative Positioning
G92 Yes Reset Coordinates
G93 Yes Reset Coordinates
M6 Yes Declare Head Offsets
M660 Yes Set Tool Offsets
M702-4 Yes Cloning Heads

The following commands define if new positioning data is defined in inches (G20) or mm (G21); or from the origin (G90) or from the present location (G91). They also stipulate the offsets from one head to another (M6), and how to invoke that offset (T).

G10 UNUSED2

G10 is not recognized by Repetrel.

On some other printers, this will set tool offsets; we do this via M6.

On some other printers, this will do a retract; we do this via M721.

G20 Set Units to Inches

G20 declares that henceforth, measurements will be given in inches.

Working with G20 is experimental and unsupported on Hyrel equipment. Use at your own risk.

Usage

 G20

Parameters

 N/A

Example

G20

This command is decoded and executed by the printer as follows:

  • G20 (set units to inches)



G21 Set Units to Millimeters

G21 declares that henceforth, measurements will be given in mm.

Usage

 G21

Parameters

 N/A

Example

G21

This command is decoded and executed by the printer as follows:

  • G21 (set units to milimeters)



G28 Send to Physical Home

G28 sends the specified axes to the sensor-defined physical home position, regardless of logically set 0,0, then pop-off and re-acquire the sensor threshold at a slower rate. This pop-off and re-acquire was implemented during v3.

After homing, a G28 also resets current offsets to 0 - including any may have been set with a G92 or an H (as defined in an M660 and invoked on a G1), performs a G53, and applies a head offset of 0 mm (as in an M6 O0).

Any axis not homed will have its position remain unchanged. We do not support intermediate positioning during homing.

Usage

 G28 Xn Yn Zn An Bn I1

Parameters

 X0 ensures that the X axis is homed
 Y0 ensures that the Y axis is homed
 Z0 ensures that the Z axis is homed
 A0 ensures that the A axis is homed
 B0 ensures that the B axis is homed

Example

 G28 X0 Y0

This command is decoded and executed by the printer as follows:

  • G28 (home axis)
    • X0 (X axis to 0)
    • Y0 (Y axis to 0)
    • (Z remains unchanged)
    • (A remains unchanged)
    • (B remains unchanged)



G53 Clear Offsets

G53 sets the fixture offsets to (0,0,0,0,0). This takes no arguments or variables. It does not clear stored offset values.

Usage

 G53

Parameters

 N/A

Example

G53

This command is decoded and executed by the printer as follows:

  • G53 (set fixture offsets to 0; no effect on H (head) offsets)



G54 - G59 - Set Offsets

G54, G55, G56, G57, G58, and G59 will each store and invoke fixture offsets in the X, Y, Z, A, and/or B axes for all subsequent moves. Any values not invoked will remain with their previous value (0 unless earlier specified otherwise). These offsets apply to all positioning until a new offset is applied, or a G53 is used to clear all offsets.

This graphic shows how printers (OTHER THAN THE EHR) use the G54-G59 offsets:

G54.png

Note that this differs from an M6, where the offsets are only applied to a SINGLE tool position. These offsets are cumulative with M6 values.

Usage

 G54 (... G59) Xn Yn Zn An Bn

Parameters

 Xn is the offset in mm in the X axis
 Yn is the offset in mm in the Y axis
 Zn is the offset in mm in the Z axis
 An is the offset in mm in the A axis
 Bn is the offset in mm in the B axis

Example

G54 X30 Y-20

This command is decoded and executed by the printer as follows:

  • G54 (set units to milimeters)
    • X30 (add 30mm to all X positions)
    • Y-20 (subtract 20mm from all Y positions)
    • (no change to prior stored offsets)

Example

G55

This command is decoded and executed by the printer as follows:

  • G55 (apply new fixture offsets)
    • (no variable: use previous G55 values, or as stored under Settings > Printer > Fixture Offsets)




G90 Absolute Positioning

G90 stipulates that henceforth, the positioning will be calculated from the origin (0,0 point).

Usage

 G90

Parameters

 N/A

Example

G90

This command is decoded and executed by the printer as follows:

  • G90 (use absolute positioning)



G91 Relatative Positioning

G91 stipulates that henceforth, the positioning will be calculated relative to the starting position.

Usage

 G91

Parameters

 N/A

Example

G91

This command is decoded and executed by the printer as follows:

  • G91 (use relative positioning)



G92 Reset Coordinate Offsets

G92 resets the current position to the specified coordinates for all axes enumerated.

Usage

 G92 Xn Yn Zn An Bn En

Parameters

 Xn is the new value for the current X position
 Yn is the new value for the current Y position
 Zn is the new value for the current Z position
 An is the new value for the current A position
 Bn is the new value for the current B position
 En is the new value for the current E position
 

Example

G92 X0 Y50

This command is decoded and executed by the printer as follows:

  • G92 (replace current values)
    • X0 (present X position is 0)
    • Y50 (present Y position is 50)

Example

G92 E0

This command is decoded and executed by the printer as follows:

  • G92 (replace current values)
    • E0 (present E position is 0)



G93 Clear Coordinate Offsets

G93 clears ALL offsets implemented via G92 command.

Usage

 G93

Parameters

 N/A

Example

G93

This command is decoded and executed by the printer as follows:

  • G93 (clear coordinate offset values, all axes)



M6 Declare Head Offsets

M6 declares that a particular head holds a set of X, Y, and/or Z offsets, which will be invoked during a T (tool change) command. Repetrel reads this data from the heads, and sends it to the printer before the gcode file is loaded.

Usage

 M6 T# On Xn Yn Zn An Bn Dn In Kn

Parameters

 T# is the Tool position for which these offsets are being set
 On is the Offset position where these are being stored
 Xn is the offset in the X axis
 Yn is the offset in the Y axis
 Zn is the offset in the Z axis
 An is the offset in the A axis
 Bn is the offset in the B axis
 Dn is the current tool diameter (used with pocket commands)
 In non-persistent; can be default 0 (store values but do not move these distances) or 1 (store values and move these distances)
 Kn persistent setting; can be default 0 (use I value) or 1 (ignore I1 and always act with I0)

Example

 M6 T# O1 X20 Y-30 Z40

This happens (for every head loaded) when you click print, and the head values are sent to the Motion Controller.

This command is decoded and executed by the printer as follows:

  • M6 (Declare Head Offsets)
    • T# (target head)
    • O1 (offset stored in register "O1")
    • X20 (X+20)
    • Y-30 (Y-30)
    • Z40 (Z+40)
    • (no change to A)
    • (no change to B)
    • (no diameter change)
    • (no move)

Example

 M6 T# O1 X20 Y-30 Z40 I1

This happens when you execute a tool change with T#, and so it triggers the move (I1) to properly position the next head.

This command is decoded and executed by the printer as follows:

  • M6 (Declare Head Offsets)
    • T# (target head)
    • O1 (offset stored in register "O1")
    • X20 (X+20)
    • Y-30 (Y-30)
    • Z40 (Z+40)
    • (no change to A)
    • (no change to B)
    • (no diameter change)
    • (store and move distances)

Example

 M6 K1

You might include this in your header to change behavior during tool changes.

This command is decoded and executed by the printer as follows:

  • M6 (Declare Head Offsets)
    • (all future T# or M6 commands)
    • (no offset registers, so ignore all offsets)
    • K1 (always force I0 with M6 unless K0 present (or has been previously set)

Note that this differs from a G54-G59, where the offsets are applied to EVERY tool position.



M660 Assign Tool Height Offset

Used with the High Resolution Engine (and other units which home away from O, like a CNC), an M660 declares that a particular head, when called upon, should print at the gcode-based Z position MODIFIED by this offset, since on these units, the Z-Zero is often BELOW the print surface. By default, this is ONLY used on the EHR (Engine, High Resolution)

NOTE: You MUST have a G28 Z0 in your header to run this M660 on the EHR.

Usage

 M660 Hn Zn
 (followed by)
 G1 Xn Yn Zn Fn Hn (see #G1_Working_Move for other details

Parameters

 H is the head offset registern for which these offsets are being set;
 Z is the offset in the Z axis in mm.

Example 1

 M660 H2 Z28.2       ; (specified before any moves)
 (followed by)
 G1 X50 Y75 F4800 H2   ; (specified on the first G1 move)

This command is decoded and executed by the printer as follows:

  • M660 (apply offset)
    • H2 (store in register 2)
    • Z28.2 (+28.2 to Z position)
  • (there may be more commands before the G1 move invoking the H2)
  • G1 (working speed straight line move from the current location to)
    • X50 (50mm in the X)
    • Y75 (75mm in the Y)
    • (no change in Z)
    • E1 (while extruding)
    • F1800 (moving at 1800mm/min)
    • H2 (invoke offsets stored in register H2)

To be clear, this requires editing two lines of code:

In your gcode, you will enter the M660 just before the first layer code. Example: M660 H2 Z28.2 ; set tool height for tool two (Z offset). On the first move of layer one (usually the Z move), you will add an H value so that this tool height is invoked.

Example 2

Before editing:

 G1 Z0.275 F360      ; move to next layer (0)
 (followed by)
 G1 X50 Y75 F4800

After editing:

 G1 Z0.275 F360 H2   ; move to next layer (0) and invoke head Z offset for this tool
 (followed by)
 G1 X50 Y75 F4800 H2



M702 - M704 Cloning Heads

Clone, slave, or parallel printing, is when multiple heads make the exact same print at the same time.

Usage of these commands with version 4 and earlier is explained on T_v4.

Usage of these commands with version 5 and later is explained on T_v5.



T Tool Change

T executes a tool change, invoking the parameters specified in the M6 sent from Repetrel to the printer at the job start. Do not confuse a T command with a T variable.

See the first entry on this page for details.



Back to top

Controlling Lasers and UV Pens

Controlling Lasers and UV Pens
Code Supported Brief Description
M620 Yes Enable Device
M621 Yes Set Laser Power
M623 Yes Duration Emit
Laser Examples
UV Pen Examples


The CO2 and Diode Lasers and the UV Pens require the following enabling codes:

M620 Enable Device

M620 enables the device.

Usage

 M620 T# En An

Parameters

 T# is the tool position
 En can be the default 0 (disable) or 1 (enable)
 An is the duration in seconds after shut-off that the cooling remains active; default is 30 (but this will not override temperature safety measures)

Example

 M620 T# E1

This command is decoded and executed by the printer as follows:

  • M620 (enable device)
    • T# (target head - MUST be specified, can NOT be inherited)
    • E1 (enable)



M621 Set Laser Power

M621 sets the power for the LASER (not other heads).

Usage

 M621 Dn Pn

Parameters

 Pn is the power, in a value between 0 (min) and 100 (max).
 Dn is the initial power (similar to a prime) to penetrate material (optional; uses Pn if unspecified)

Note: No tool is specified; this will happen on the laser already enabled with M620.

Example

 M621 P40

This command is decoded and executed by the printer as follows:

  • M621 (activate device)
    • P40 (at 40% during "printing" (E-value) moves)




M623 Duration Emit

M623 sets the power for the laser or UV pen, and takes the following parameters:

Usage

 M623 Dn Pn

Parameters

 Dn is the duration, in miliseconds (only used for static exposures, not during moves)
 Pn is the power, in a value between 0 (min) and 100 (max).

Note: Dn max for UV pens is 60,000 (1 minute); Dn max for other devices 1,000 (1 second);

Here are examples:

 M623 P80 D500

This command is decoded and executed by the printer as follows:

  • M623 (activate tool)
    • P80 (power 80%)
    • D500 (duration 500 miliseconds)
 M623 P80 D10000 

This command is decoded and executed by the printer as follows:

  • M623 (activate tool)
    • P80 (power 80%)
    • D10000 (duration 10 seconds)

Laser Examples

A sample of code for lasering will look like this:

 G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
 M620 T# E1          ; enable target device 
 M621 P100           ; set light emission in vector mode (slot 3) to full power (100%)
 T#                  ; toolchange to target head
 G1 X120 Y100 E1     ; emitting (printing) move 20mm from origin in X axis
 G1 X120 Y120 E1     ; emitting (printing) move 20mm from origin in Y axis
 G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
 G1 X140 Y130 E1     ; emitting move 20mm from origin in X axis
 
 ... (the rest of your lasering job)
 
 M620 T# E0          ; disable target device <= should be before M30 command

UV Pen Examples

A sample of code for UV Curing will look like this:

 G0 X100 Y100 F1000  ; move to start location at 1000 mm/min
 M620 T# E1         ; enable target device
 M621 P100           ; set light emission in vector mode (slot 3) to full power (100%)
 T#                  ; toolchange to target head
 G1 X120 Y100 E1     ; emitting (printing) move 20mm from origin in X axis
 G1 X120 Y120 E1     ; emitting (printing) move 20mm from origin in Y axis
 G1 X120 Y130        ; non-emitting move 10mm from origin in Y axis
 G1 X140 Y130 E1     ; emitting move 20mm from origin in X axis
 
 ... (the rest of your curing job)
 
 M620 T# E0         ; disable target device <= should be before M30 command

For more complex examples, see the UV_and_Clench page.



Back to top

Controlling Spindles and Lathes

Controlling Spindles and Lathes
Code Supported Brief Description
M3 Yes Spindle On CW
M4 Yes Spindle On CCW
M5 Yes Spindle Off
M253 Yes Turn On Lathe (CW)
M254 Yes Turn On Lathe (CCW)
M255 Yes Turn Off Lathe
G81 G81 Peck Drilling

Machining and Spindle Tool commands. Note, we recommend using SimplyCAM.

You can review the 5-axis gcode we used for this video from here.

M3 Turn On Spindle (CW)

M3 tells the printer to activate (start) the spindle motor in the clockwise direction on the current head (if it has one), using the value set on the head for RPM. Note: S0 is the same as turning it off. Note: DO NOT CHANGE DIRECTION while the spindle is in motion.

Usage

 M3 T# Sn Fn

Parameters

 T# - target head
 Sn - power (0-100%)
 Fn - optional; PWM in Hz (defaults on heads should be fine for most uses)

Example

 M3 T# S75

This command is decoded and executed by the printer as follows:

  • M3 (activate spindle clockwise)
    • T# (target head)
    • S75 (at 75% power)
    • (default PWM)



M4 Turn On Spindle (CCW)

Please refer to M3, above, for details. All options are identical, with the exception of direction (counterclockwise).



M5 Turn Off Spindle

M5 tells the printer to deactivate (stop) the spindle motor on the current head (if it has one). M5 has the same effect as M3 S0 or M4 S0.

Usage

 M5 T#

Parameters

 T# - target head

Example

 M5 T# 

This command is decoded and executed by the printer as follows:

  • M3 (deactivate spindle )
    • T# (target head)



M253 Turn On Lathe (CW)

M253 tells the printer to activate (start) the lathe motor in the clockwise direction (if it has one), using the value set with M92 for RPM. Only available on Hydra 16A models.

Note: S0 is the same as turning it off.

Usage

 M253 Sn

Parameters

 Sn - speed in units per minute (default: RPM if set with M92 as steps per revolution)

Example

 M253 S75

This command is decoded and executed by the printer as follows:

  • M253 (activate spindle clockwise)
    • S75 (at 75 RPM)



M254 Turn On Lathe (CCW)

Please refer to M253, above, for details. All options are identical, with the exception of direction (counterclockwise).



M255 Turn Off Lathe

M255 tells the printer to deactivate (stop) the lathe motor (if it has one). M255 has the same effect as G253 S0 or G254 S0.

Usage

 M255 

Parameters

 N/A

Example

 M255 

This command is decoded and executed by the printer as follows:

  • M255 (deactivate lathe)



G81 Peck Drilling

G81 tells the printer to move to a start position in X/Y and then in Z, and to make (if needed) repeated descents and retracts. This is used to make holes, especially deep holes. Note that the spindle tool is turned on with an M3 or M4 before this command, and turned off with an M5 after all work is done.

Usage

 G81 T# Xn Yn In Pn Qn Zn Fn

Parameters

 T# - target head
 Xn - X position
 Yn - Y position
 In - initial Z position
 Pn - peck downward this many mm during each cycle
 Qn - retract upward this many mm after each cycle (to clear debris)
 Zn - maximum pecking depth
 Fn - Z working speed in mm/min

Example

 G81 T# X100 Y75 I3 P3 Q-2 Z-7.5 F200

NOTE that an M660 offset must be set and applied BEFORE THIS COMMAND to allow for tool length.

This command is decoded and executed by the printer as follows:

  • G81 (begin pecking cycle)
    • X100 Y75 (move to X/Y starting position X100 Y75)
    • I3 (move to Z starting position Z3, which will be our greatest retract height)
    • P3 (peck downward an additional 3mm at a time)
    • Q-2 (retract upward 2mm after each peck (to clear debris))
    • Z-7.5 (peck to a maximum depth of 7.5mm)
    • F200 (working (drilling) travel speed of 200 mm/min)
    • after this, the head will retract up to the I position (Z3 in this case) before moving on to the next line



Back to top

Reporting and Diagnostics

Reporting and Diagnostics
Code Supported Brief Description
M701 Yes Set Head Reporting
M718 Yes Stop Logging to File
M719 Yes Start Logging to File
M670 Yes Enable Y-arm Light
M672 Yes Set Y-arm Light
M772 Yes Reset All Metrics
M773 Yes Generate Basic Report

The following commands help with reporting and diagnostics. Most users never need them, but here are the basics. More advanced/detailed reporting is available.

M701 Set Head Reporting

M701 tells heads how often to send head-specific information to the Motion Controller and on to Repetrel (and pass along to a text file if enabled via M719).

Usage

 M701 T# Pn

Parameters

 T# - target head
 Pn - period in seconds between entries (default 1)

Example

 M701 P12

This command is decoded and executed by the printer as follows:

  • M701 (head reporting)
    • (currently active head)
    • P12 (every 12 seconds)



M718 Stop Logging to File

M718 tells Repetrel to stop any logging of data to text file that may have been enabled with M719.

Usage

 M718

Parameters

 N/A

Example

 M718

This command is decoded and executed by the printer as follows:

  • M718 (logging off)



M719 Start Logging to File

M719 tells the Motion Controller what system-wide information to report back to Repetrel, and also tells Repetrel to begin logging these details to a text file.

Usage

 M719 Pn Sn 
 
 M719 Pn Xn Yn Zn An Bn Vn En Ln

Parameters

 Pn - period in seconds between entries
 Sn - can be default 0 (see options below) or 1 (report ALL data) 
 Xn - report X position with each entry
 Yn - report Y position with each entry
 Zn - report Z position with each entry
 An - report A position with each entry
 Bn - report B position with each entry
 Vn - report velocity with each entry
 En - report flow rate with each entry
 Ln - report gcode line number with each entry

Note: these values are persistent, and if previously enabled, will still be enabled unless disabled with a 0 parameter.

Example 1

 M719 P10 S1

This command is decoded and executed by the printer as follows:

  • M719 (logging on)
    • P10 (every 10 seconds)
    • S1 (report everything)

Example 2

 M719 P.1 Xn Yn Zn Ln
  • M719 (logging on)
    • P.1 (every 0.1 seconds)
    • X1 (report X position)
    • Y1 (report Y position)
    • Z1 (report Z position)
    • (don't report A position)
    • (don't report B position)
    • (don't report velocity)
    • (don't report flow rate)
    • L1 (report line number)



M670 Enable Gantry / Y-arm Light

M670 sets the intensity of the Y-arm LEDs.

Usage

 M670 Sn Pn

Parameters

 Sn is the (percent of duty cycle, 0-100) for the LEDs
 Pn is the period (on-off interval - default is 1 second)

Example 1

 M670 S50 P1

This command is decoded and executed by the printer as follows:

  • M670 (enable Y-arm light)
    • S50 (50% duty cycle)
    • P1 (1 second cycle)

This would turn the Y-arm light on for 50% of 1 second, then off for 50% of 1 second - or on for 0.5 seconds, off for 0.5 seconds.

Example 2

 M670 S25 P4

This command is decoded and executed by the printer as follows:

  • M670 (enable Y-arm light)
    • S25 (25% duty cycle)
    • P4 (4 second cycle)

This would turn the Y-arm light on for 25% of 4 second, then off for 75% of 4 seconds - or on for 1 second, off for 3 seconds.



M672 Set Gantry / Y-arm State

M672 can be used to have the Gantry / Y-arm light change states to reflect the state of a sensor. For example, you can have it come on when the X axis is homed, or when the Y axis has a fault.

Usage

 M672 Sn

Parameters

 Sn can be (unlisted numbers are unused at present):
       0  : Normal on/off
       10 : X Home
       11 : X Limit1
       12 : X Limit2
       13 : X Fault
       20 : Y Home
       21 : Y Limit1
       22 : Y Limit2
       23 : Y Fault
       30 : Z Home
       31 : Z Limit1
       32 : Z Limit2
       33 : Z Fault
       40 : A Home
       41 : A Limit1
       42 : A Limit2
       43 : A Fault
       50 : B Home
       11 : B Limit1
       52 : B Limit2
       53 : B Fault
       60 : C Home
       61 : C Limit1
       62 : C Limit2
       63 : C Fault

Example

 M672 S

This command is decoded and executed by the printer as follows:

  • M672 (map Y-arm light to state of sensor)



M772 Reset All Metrics

M772 will reset all internal gathering registers to 0.

Usage

 M772 Sn

Parameters

 Sn 0 is default; S can be...
     0 reset all values only
     1 also generates a basic printing report
     255 also generates all possible reports (helpful for advanced debugging)

Example

 M772 S1

This command is decoded and executed by the printer as follows:

  • M772 (reset all metrics)
    • S1 (and generate basic printing report



M773 Generate Basic Report

M773 generates a basic report of printing statistics (including average speed, number of primes, etc.)

Note: this report will be more meaningful if you use M772 to reset these counters at the start of a job.

Usage

 M773

Parameters

 N/A

Example

 M773

This command is decoded and executed by the printer as follows:

  • M773 (generate basic report)

Sample Output

 >IN:  50: ******************************************************************
 >IN:  50: **  Begin M773 - print job metrics Report
 >IN:  50: ******************************************************************
 >IN:  50: 
 >IN:  50:                       Time (s)    Dist (m)
 >IN:  50:                       --------    --------
 >IN:  50: Totals:                    0.0       0.000
 >IN:  50: 
 >IN:  50: Printing moves:            0.0       0.000
 >IN:  50: Non-printing moves         0.0       0.000
 >IN:  50: 
 >IN:  50: Accelerating:              0.0       0.000
 >IN:  50: Cruising:                  0.0       0.000
 >IN:  50: Decelerating:              0.0       0.000
 >IN:  50: 
 >IN:  50: can e steps issued:       0
 >IN:  50: approx filament (PI*d)    0.000 m
 >IN:  50: approx filament (PIr^2)   0.000 m
 >IN:  50: unprimes issued:          0
 >IN:  50: primes issued:            0
 >IN:  50: unprime-primes avoided:   0
 >IN:  50: 
 >IN:  50: ******************************************************************
 >IN:  50: **  End M773 Report
 >IN:  50: ******************************************************************



Back to top

Controlling Aux Devices

Controlling Aux Devices
Code Supported Brief Description
M7 Yes Aux 1 On (Mist)
M8 Yes Aux 2 On (Flood)
M9 Yes All Aux Off
M620 Yes Enable Device
M670 Yes Enable Y-arm (Gantry) Lights
M671 Yes Activate X-Arm (Danger) Lights
M675 Yes Activate Response LEDs
M676 Yes Activate Recirc. Fan
M677 Yes Activate Buzzer
M678 Yes Activate Laser X-hair
M679 Yes Activate Vacuum
M684 Yes Activate Exhaust
M685 Yes Activate Air
M689 Yes Activate Ext. Head
M783 Yes Tie Aux to Extrusion


Individual port control commands.

M7 Activate Aux 1

12VDC Ports on EHR
12VDC Ports on 30M, ESR

M7 sends 12VDC to the port associated with "Mist Coolant", which we sometimes call Aux1. With no parameters, it is read as M7 S100 (on continuously). See also M783 Tie Aux to Extrusion.

Usage

 M7 Sn Tn

Parameters

 Sn is the percentage (0-100) for Aux 1 to come on (default is 100)
 Tn is the head to which Aux 1 will synchronize, coming on at 100% when that head is extruding; using a T value forces S100

Example 1

 M7 S100

This command is decoded and executed by the printer as follows:

  • M7 (Aux1 value)
    • S100 (set to 100%)

Example 2

 M7 S25

This command is decoded and executed by the printer as follows:

  • M7 (Aux1 value)
    • S25 (set to 25%)

Example 3

 M7 S0

This command is decoded and executed by the printer as follows:

  • M7 (Aux1 value)
    • S0 (set to 0%)

Example 4

 M7 T#

This command is decoded and executed by the printer as follows:

  • M7 (Aux1 value)
    • T# (set to 100% when T# is extruding)



M8 Activate Aux 2

M7 sends 12VDC to the port associated with "Flood Coolant", which we sometimes call Aux2. With no parameters, it is read as M8 S100 (on continuously). See also M783 Tie Aux to Extrusion.

Usage

 M8 Sn Tn

Parameters

 Sn is the percentage (0-100) for Aux 2 to come on (default is 100)
 Tn is the head to which Aux 2 will synchronize, coming on at 100% when that head is extruding; using a T value forces S100

Example 1

 M8 S100

This command is decoded and executed by the printer as follows:

  • M8 (Aux2 value)
    • S100 (set to 100%)

Example 2

 M8 S25

This command is decoded and executed by the printer as follows:

  • M8 (Aux2 value)
    • S25 (set to 25%)

Example 3

 M8 S0

This command is decoded and executed by the printer as follows:

  • M8 (Aux2 value)
    • S (set to 0%)

Example 4

 M8 T#

This command is decoded and executed by the printer as follows:

  • M8 (Aux2 value)
    • T# (set to 100% when T# is extruding)



M9 Deactivate Aux1 & Aux2

M9 cuts power to both Aux1 and Aux2. It is equivalent to running M7 S0 and M8 S0.

Usage

 M9

Parameters

 N/A

Example

 M9

This command is decoded and executed by the printer as follows:

  • M9 (set Aux 1 and Aux 2 to value 0 (off))



M620 Activate Emitter

See #M620_Enable_Device above.



M670 Activate Y-Arm (Gantry) Lights

M670 sends 12VDC to the port associated turning on the Gantry (16A) or Y-arm (30M, ESR) lights.

Usage

 M670 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M670 S100

This command is decoded and executed by the printer as follows:

  • M670 (Gantry / Y-arm value)
    • S100 (set to 100%)

Example 2

 M670 S25

This command is decoded and executed by the printer as follows:

  • M670 (Gantry / Y-arm value)
    • S25 (set to 25%)

Example 3

 M670 S0

This command is decoded and executed by the printer as follows:

  • M670 (Gantry / Y-arm value)
    • S0 (set to 0%)



M671 Activate X-Arm (Danger) Lights

M671 sends 12VDC to the port associated turning on the X-arm / Danger lights (30M/ESR only).

Usage

 M671 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M671 S100

This command is decoded and executed by the printer as follows:

  • M671 (X-arm / Danger value)
    • S100 (set to 100%)

Example 2

 M671 S25

This command is decoded and executed by the printer as follows:

  • M671 (X-arm / Danger value)
    • S25 (set to 25%)

Example 3

 M671 S0

This command is decoded and executed by the printer as follows:

  • M671 (X-arm / Danger value)
    • S0 (set to 0%)



M675 Activate Response LEDs

M675 sends 12VDC to the port associated turning on the Response LEDs (30M/16A only).

Usage

 M675 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M675 S100

This command is decoded and executed by the printer as follows:

  • M675 (Response LEDs value)
    • S100 (set to 100%)

Example 2

 M675 S25

This command is decoded and executed by the printer as follows:

  • M675 (Response LEDs value)
    • S25 (set to 25%)

Example 3

 M675 S0

This command is decoded and executed by the printer as follows:

  • M675 (Response LEDs value)
    • S0 (set to 0%)



M676 Activate Recirc. Fan

M676 sends 12VDC to the port associated turning on the Recirc. Fan (16A only).

Usage

 M676 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M676 S100

This command is decoded and executed by the printer as follows:

  • M676 (Recirc. Fan value)
    • S100 (set to 100%)

Example 2

 M676 S25

This command is decoded and executed by the printer as follows:

  • M676 (Recirc. Fan value)
    • S25 (set to 25%)

Example 3

 M676 S0

This command is decoded and executed by the printer as follows:

  • M676 (Recirc. Fan value)
    • S0 (set to 0%)



M677 Activate Buzzer

M677 sends 12VDC to the port associated turning on the Buzzer (older 30Ms only).

Usage

 M677 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M677 S100

This command is decoded and executed by the printer as follows:

  • M677 (Buzzer value)
    • S100 (set to 100%)

Example 2

 M677 S25

This command is decoded and executed by the printer as follows:

  • M677 (Buzzer value)
    • S25 (set to 25%)

Example 3

 M677 S0

This command is decoded and executed by the printer as follows:

  • M677 (Buzzer value)
    • S0 (set to 0%)



M678 Activate Laser X-hair

M678 sends 12VDC to the port associated turning on the Laser X-hair (16A with CO2 lasers only).

Usage

 M678 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M678 S100

This command is decoded and executed by the printer as follows:

  • M678 (Laser X-hair value)
    • S100 (set to 100%)

Example 2

 M678 S25

This command is decoded and executed by the printer as follows:

  • M678 (Laser X-hair value)
    • S25 (set to 25%)

Example 3

 M678 S0

This command is decoded and executed by the printer as follows:

  • M678 (Laser X-hair value)
    • S0 (set to 0%)





M679 Activate Vacuum

M679 sends 12VDC to the port associated turning on the Vacuum (30M/ESR only).

Usage

 M671 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M679 S100

This command is decoded and executed by the printer as follows:

  • M679 (Vacuum value)
    • S100 (set to 100%)

Example 2

 M679 S25

This command is decoded and executed by the printer as follows:

  • M679 (Vacuum value)
    • S25 (set to 25%)

Example 3

 M679 S0

This command is decoded and executed by the printer as follows:

  • M679 (Vacuum value)
    • S0 (set to 0%)



M684 Activate Exhaust

M671 sends 12VDC to the port associated turning on the Exhaust (16A only).

Usage

 M684 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M684 S100

This command is decoded and executed by the printer as follows:

  • M684 (Exhaust value)
    • S100 (set to 100%)

Example 2

 M684 S25

This command is decoded and executed by the printer as follows:

  • M684 (Exhaust value)
    • S25 (set to 25%)

Example 3

 M684 S0

This command is decoded and executed by the printer as follows:

  • M684 (Exhaust value)
    • S0 (set to 0%)



M685 Set Power on Air

M685 sends 12VDC to the port associated turning on the (positive pressure) Air (16A only).

Usage

 M685 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M685 S100

This command is decoded and executed by the printer as follows:

  • M685 (Air value)
    • S100 (set to 100%)

Example 2

 M685 S25

This command is decoded and executed by the printer as follows:

  • M685 Air value)
    • S25 (set to 25%)

Example 3

 M685 S0

This command is decoded and executed by the printer as follows:

  • M685 (Air value)
    • S0 (set to 0%)



M689 Activate Ext. Head

M689 sends 12VDC to the port associated turning on the Ext. Head.

Usage

 M689 Sn

Parameters

 Sn is the percentage (0-100; no default - if no Sn, no change)

Example 1

 M689 S100

This command is decoded and executed by the printer as follows:

  • M689 (Ext. Head value)
    • S100 (set to 100%)

Example 2

 M689 S25

This command is decoded and executed by the printer as follows:

  • M689 (Ext. Head value)
    • S25 (set to 25%)

Example 3

 M689 S0

This command is decoded and executed by the printer as follows:

  • M689 (Ext. Head value)
    • S0 (set to 0%)



M783 Tie Aux to Extrusion

M783 can tie some auxiliary port (like Aux 1, normally controlled by M7, or Aux 2, normally controlled by M8, etc.) to be powered (at 100%) during a certain head's extrusion. Some users use this so that they can print with Ultimus or Viscotec heads on our equipment. See also M7 and M8.

Note: M619 can be used to map which port M783 ties to - contact us for more information.

Usage

 M783 T# 

Parameters

 T# is the tool to which the designated aux port will be tied

Example

 M783 T#

This command is decoded and executed by the printer as follows:

  • M783 (Tie current Aux port to status of head)
    • T# (target head)




Back to top

Other Commands

Other Commands
Code Supported Brief Description
M17 Yes Engage Motors
M18 Yes Disengage Motors
M30 Yes End of Program
M84 Yes Disable Motors
M790 Yes New Layer Actions
M791 Yes Snap Image
M792 Yes Execute Action

Other commands.

M17 Engage Motors

M17 will apply power to all motors (positioning and extruder motors), locking them at their current postion; this prevents the bed and yoke from being pushed manually in the X and Y.

Note that an M18 or M84 will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.

Usage

 M17

Parameters

 N/A

Example

 M17

This command is decoded and executed by the printer as follows:

  • M17 (engage motors)



M18 Disengage Motors

M18 will cut power to all motors (positioning and extruder motors), unlocking them; this allows the motors to cool down (as they normally lock in place while still), as well as allowing one to manually push the bed and yoke in the X and Y. It also notifies the GUI that motors are disabled. All axes with homes must be rehomed after an M18.

Note this is identical to M84 and the opposite of M17.

Note that an M18 or M84 will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.

Usage

 M18

Parameters

 N/A

Example

 M18

This command is decoded and executed by the printer as follows:

  • M18 (disengage motors)



M30 End of Program

M30 tells the printer that this job is complete. No gocde after an M30 will be executed as part of the previous job.

Note M30 also dissolves any cloning setups, changes head index to 0, clears fixture offsets (G53), clears any M229 E-value settings, resets M106 persistent range, resets any printing errors, resets M660 head offsets to 0, resets heads to their stored values, and triggers any queued reports.

Usage

 M30

Parameters

 N/A

Example

 M30

This command is decoded and executed by the printer as follows:

  • M30 (end or program)



M84 Disable Motors

M84 invokes an M18. Please see M18 for usage.

Note that an M18 or M84 will disengage motors on ESR and 30M models, but 16A and EHR models use different controllers, and these commands do not unlock the motors. On a 16A or a 30M, you may engage the emergency stop for the same effect.



M790 New Layer Actions

M790 will trigger any associated new layer actions, which can include capturing an image from the designated camera. It takes no parameters.

M791 Snap Image

M791 will cause the camera selected under the Interface > Camera1 tab, if set to live video, to capture an image and save it to C:\Users\hyrel\Pictures\HyrelPrinterPictures\Camera1, named pic#.png

M792 Execute Action

M792 causes Repetrel to perform an action, such as displaying an image or making a warning beep.

Usage

 M792 [ SAY | PIC | VID | SEND | BEEP | SHELL ]

Parameters

 SAY sample message - the computer will use built-in text-to-speech to echo the message over the speaker(s)
 PIC C:\sample.jpg - the computer will display the image at the specified location
 VID C:\sample.mp4 - the computer will play the video at the specified location
 SEND sample message - the computer will send the message to the Aux port if connected
 BEEP - the computer will sound a beep
 SHELL C:\program.exe - the computer will execute the file at the specified location

Note that multiple options can be combined.

Example

 M792 ; SAY Hello Wilbur ; PIC C:\mr_ed.png

This command is decoded and executed by the printer as follows:

  • M792 (execute action)
    • SAY Hello Wilbur (Announce Text: Hello Wilbur)
    • PIC C:\mr_ed.png (Display Image: C:\mr_ed.png)



Back to top

Gcode Header

Here are some sample headers for Gcode on our equipment:

16A, T1, Heated

Below is our standard header for using a heated head in the second slot with a heated bed on a 16A:

 ; ///////////////   BEGIN HYREL HEADER for a 16A with a Heated Head in T1/T12 - 2021.02.24   \\\\\\\\\\\\\\\
 
 ; GENERAL :
 
 N14                ; set line numbers for error logging - Slic3r version
 M772 S1            ; reset metrics and arm automatic reporting 
 M627 X0 Y0 Z0 J-500 K5                 ; setup abort action 
 
  
 M107               ; fans/UV           ; off
 M106 C255          ; fans/UV           ; set to 0-255 range
 
 G53                ; clear offsets
 G21                ; units             : mm
 G91                ; coordinatess      : relative
 G0 Z10 	           ; drop bed 
 G90                ; coordinates       : absolute
 
 M229 E1 D1         ; enable E-values (volumetric)
 
 ; TEMP CONTROL :
 
 M190 S100          ; bed preheat  : set and wait
 M140 S[bed_temperature]          ; bed temp     : set, no wait
 M104 T12 S[temperature]      ; head temp    : set, no wait
 
 G28 X0 Y0          ; home, goto   : X and Y
  
 M190 S[bed_temperature]          ; bed temp     : set and wait
 M109 T12 S[temperature]      ; head temp    : set and wait
 
 T1                 ; use SECOND tool position from the left    
 
 ; \\\\\\\\\\\\\\\   END HYREL HEADER for a 16A with a Heated Head in T1/T12 - 2021.02.24   ///////////////

30M and ESR, T1, Heated

Below is our standard header for using a heated head in the second slot with a heated bed on a 16A:

 ; ///////////////   BEGIN HYREL HEADER for a 30M/ESR with an Unheated Head in T0/T11 - 2021.02.24   \\\\\\\\\\\\\\\
 
 ; GENERAL :
 
 N14                ; set line numbers for error logging - Slic3r version
 M772 S1            ; reset metrics and arm automatic reporting 
 M627 X0 Y0 Z0 J-500 K5                 ; setup abort action 
 
 
 M107               ; fans/UV           ; off
 M106 C255          ; fans/UV           ; set to 0-255 range
 
 G53                ; clear offsets
 G21                ; units             : mm
 G91                ; coordinatess      : relative
 G0 Z10 	           ; drop bed 
 G90                ; coordinates       : absolute
 
 G28 Z0             ; home, goto        : Z (ignored if no Z home)
 G28 X0 Y0          ; home, goto        : X and Y
 
 M229 E1 D1         ; enable E-values (volumetric)
 
 ; TEMP CONTROL :
 
 ;M190 S[bed_temperature]          ; bed temp     : set and wait    <= COMMENTED OUT
 ;M109 T11 S[temperature]        ; head temp    : set and wait    <= COMMENTED OUT
 
 T0                 ; use FIRST tool position from the left    
 
 ; \\\\\\\\\\\\\\\   END HYREL HEADER for a 30M/ESR with an Unheated Head in T0/T11 - 2021.02.24   ///////////////

Gcode Footer

Standard, All Models

Below is our standard Gcode footer, which should be at the end of all your gcode files:

 ; ///////////////   BEGIN HYREL STANDARD FOOTER - 2021.02.12   \\\\\\\\\\\\\\\
 
 ; temp control:
 
 
 M107 T100       ; fans, diodes  : off
 M620 T100 E0    ; CO2 lasers    ; off
 M104 T100 S0    ; head temps    : off
 M140 T90 S0     ; bed temps     : off
 M5              ; spindles      : off
 
 ; housekeeping
 
 G91             ; coordinates   : relative
 G0 Z10          ; drop bed 
 G90             ; coordinates   : absolute
 G0 Y0           ; home, goto    : Y axis
 G0 X0           ; home, goto    : X axis
 M84             ; motors        : disable
 G53             ; clear offsets
 M30             ; program       : end
 			
 ; \\\\\\\\\\\\\\\   END HYREL STANDARD FOOTER - 2021.02.12   ///////////////