Smoothie is primarily a G-code interpreter. Here is a list of the G-codes that are currently supported:
[!NOTE] Make sure your Gcode is in uppercase, separation by space characters is optional, as shown everywhere on this wiki. For example:
G1 X10 F100Lowercase is reserved for commands.
| G-Code | Description | Example |
|---|---|---|
| G0 | Move to the given coordinates. To the contrary of G1, if there is a tool it will most of the time be off during this kind of move. This is a “go to” move rather than a “do while going to” move. The F parameter defines speed and is remembered by subsequent commands ( specified in millimetres/minute ) (command is modal) | G0 X10 Y5 F100 |
| G1 | Move to the given coordinates, see above for difference with G0. Takes the same F parameter as G0. (command is modal) | G1 X20 Y2.3 F200 |
| G2 | Clockwise circular motion: go to point with coordinates XYZ while rotating around point with relative coordinates IJ (command is not modal) | G2 X10 J5 |
| G3 | Counter-clockwise motion: see above (command is not modal) | G3 Y5 X10 I2 |
| G4 | Dwell S |
G4 P1000 |
| G10 | Do firmware extruder retract | G10 |
| G11 | Do firmware extruder un-retract | G11 |
| G10 L1 | Set extruder tool offset for specified extruder where Pn is the extruder number + 1 (T0 is P1, T1 is P2), This stays set until reset. Permanent change must be added to config, Only active when multiple extruders have been defined | G10 L1 P2 X10 |
| G10 L2, G10 L20 | Set workspace coordinates LinuxCNC G10 L2 and LinuxCNC G10 | G10 L2 P1 X0 |
| G17 | Select XYZ plane (command is modal) | G17 |
| G18 | Select XZY plane (command is modal) | G18 |
| G19 | Select YZX plane (command is modal) | G19 |
| G20 | Inch mode: passed coordinates will be considered as Inches, so internally translated to millimeters (command is modal) | G20 |
| G21 | Millimeter mode (default) : passed coordinates will be considered as millimeters (command is modal) | G21 |
| G28 | Home The given axis, or if no axis specified home all axis at the same time (edge) NOTE in CNC/grbl mode this is move to park position, use $H to home |
G28 |
| G28.1 | Set Predefined Position - This position will be returned to by G28.2 | G28.1 |
| G28.2 | Move to Predefined Position - This perform a rapid move to the Predefined position set by G28.1 (in grbl mode this will do a home) | G28.2 |
| G28.3 | Manual Homing - This allows you to set a home position manually without moving to limit switches | G28.3 |
| G28.4 | Manual Homing based on actuator position- This allows you to set a home position manually based on actuator position (used for rotary delta) | G28.4 |
| G28.5 | Clears the homed flag for the specified axis, or all if not specifed | G28.5 G28.5 Z0 |
| G28.6 | Shows the homing status of each axis | G28.6 |
| G29 | Probes the bed and outputs the bed heights depending on levelling strategy selected, see ZProbe | G29 |
| G30 | Simple Z probe at current XY, reports distance moved down until probe triggers. optional F parameter defines the speed of probing, zprobe.slow_feedrate is used when not supplied | G30 G30 F100 |
| G31 | Depends on levelling strategy selected, see ZProbe | G31 |
| G32 | Depends on levelling strategy selected, see ZProbe. For calibration on delta, uses Z probe to calibrate delta endstops and arm radius, use R parameter to select only arm radius calibration and E to select only endstop calibration. I to set target precision, J to set probe_radius, K to keep current endstop trim settings. In Zgrid module, it starts the grid probing | G32 G32 R G32 E G32 EK G32 I0.02 |
| G38.2 G38.3 G38.4 G38.5 | Standard probe commands implemented as documented here | 'G38.2 Z-10' |
| G43.2 | Baby steps | G43.2 Z0.05 |
| G53 | Must be on a line by itself OR the first G code on a line, the directly following G0/G1 will be executed in MCS coordinates | G53 G0 X0 Y0 |
| G54-G59.3 | use workspace coordinates LinuxCNC G54-G59.3 and LinuxCNC G54-G59.3 | G54 |
| G90 | Absolute mode (default) (command is modal) | G90 |
| G91 | Relative mode (command is modal) | G91 |
| G92 | Set global workspace coordinate system to specified coordinates LinuxCNC G92 | G92 X0 Y0 Z0 |
| G92.1 | Clear the G92 and G30 Znnn offsets | G92.1 |
| G92.4 | manually set homing (MCS) for XYZ | G92.4 X0 Y0 Z0 |
[!WARNING] G Code comments begin at a semicolon, and end at the end of the line: Example:
G0 X7 Y8 ;this is the comment
The Smoothieware configuration file permits the association of additional codes with some tool functions. For example, for a Switch module, you can specify an arbitrary command in the ‘input_on_command’ and ‘input_off_command’. This means that some additional codes may be available, depending on your specific configuration file.
For example, if you are using servos, then you will likely have configured the following commands:
| G-Code | Description | Example | |
|---|---|---|---|
| M280 | Move servo to S |
M280 S20 ; move servo to position 20 = 20% duty cycle | |
| M281 | Turn off servo | M281 ; Same as M280 S0 0% duty cycle, effectively off |
Additionally, in your configuration, you can assign sub-commands to deal with multiple tools of the same type, for example:
| G-Code | Description | |
|---|---|---|
| M280.1 | Move your first servo | |
| M280.2 | Move your second servo |
Tn will change the tool to n for all future commands, it may appear anywhere on the line or on a line by itself
T1 M200
M200 T1
NOTE This is not compatible with the G-code spec, but unfortunately most slicers create incorrect Gcode for tool change.
[!WARNING] Note in smoothie there must be a space in front of a line that is affected by a modal G code. Some G code processors like HeeksCNC don’t prefix the space neither do they prefix each line with the modal G code.