3diy
/
klipper
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Reorganize layout of G-Codes.md 

Break listing up by module name.  Provide links to "extended"
commands. Sort reference by module name.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
This commit is contained in:
Kevin O'Connor 2022-01-29 12:54:07 -05:00
parent 9c4172784a
commit c80552f9e7
7 changed files with 1108 additions and 859 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

83
docs/Config_Reference.md
View File

@ -788,8 +788,7 @@ recommended to define a safe_z_home section in printer.cfg to home
toward the center of the print area. toward the center of the print area.
See the [bed mesh guide](Bed_Mesh.md) and See the [bed mesh guide](Bed_Mesh.md) and
[command reference](G-Codes.md#mesh-bed-leveling) for additional [command reference](G-Codes.md#bed_mesh) for additional information.
information.
Visual Examples: Visual Examples:
``` ```
@ -903,7 +902,7 @@ Bed tilt compensation. One may define a bed_tilt config section to
enable move transformations that account for a tilted bed. Note that enable move transformations that account for a tilted bed. Note that
bed_mesh and bed_tilt are incompatible; both cannot be defined. bed_mesh and bed_tilt are incompatible; both cannot be defined.
See the [command reference](G-Codes.md#bed-tilt) for additional See the [command reference](G-Codes.md#bed_tilt) for additional
information. information.
``` ```
@ -941,8 +940,7 @@ config section to enable a BED_SCREWS_ADJUST g-code command.
See the See the
[leveling guide](Manual_Level.md#adjusting-bed-leveling-screws) and [leveling guide](Manual_Level.md#adjusting-bed-leveling-screws) and
[command reference](G-Codes.md#bed-screws-helper) for additional [command reference](G-Codes.md#bed_screws) for additional information.
information.
``` ```
[bed_screws] [bed_screws]
@ -987,8 +985,8 @@ g-code command.
See the See the
[leveling guide](Manual_Level.md#adjusting-bed-leveling-screws-using-the-bed-probe) [leveling guide](Manual_Level.md#adjusting-bed-leveling-screws-using-the-bed-probe)
and [command reference](G-Codes.md#bed-screws-tilt-adjust-helper) for and [command reference](G-Codes.md#screws_tilt_adjust) for additional
additional information. information.
``` ```
[screws_tilt_adjust] [screws_tilt_adjust]
@ -1027,7 +1025,7 @@ additional information.
Multiple Z stepper tilt adjustment. This feature enables independent Multiple Z stepper tilt adjustment. This feature enables independent
adjustment of multiple z steppers (see the "stepper_z1" section) to adjustment of multiple z steppers (see the "stepper_z1" section) to
adjust for tilt. If this section is present then a Z_TILT_ADJUST adjust for tilt. If this section is present then a Z_TILT_ADJUST
extended [G-Code command](G-Codes.md#z-tilt) becomes available. extended [G-Code command](G-Codes.md#z_tilt) becomes available.
``` ```
[z_tilt] [z_tilt]
@ -1120,7 +1118,7 @@ printer skew across 3 planes, xy, xz, yz. This is done by printing a
calibration model along a plane and measuring three lengths. Due to calibration model along a plane and measuring three lengths. Due to
the nature of skew correction these lengths are set via gcode. See the nature of skew correction these lengths are set via gcode. See
[Skew Correction](Skew_Correction.md) and [Skew Correction](Skew_Correction.md) and
[Command Reference](G-Codes.md#skew-correction) for details. [Command Reference](G-Codes.md#skew_correction) for details.
``` ```
[skew_correction] [skew_correction]
@ -1199,8 +1197,8 @@ endstop switches. Add a bare "[endstop_phase]" declaration to enable
the ENDSTOP_PHASE_CALIBRATE command. the ENDSTOP_PHASE_CALIBRATE command.
See the [endstop phases guide](Endstop_Phase.md) and See the [endstop phases guide](Endstop_Phase.md) and
[command reference](G-Codes.md#endstop-adjustments-by-stepper-phase) [command reference](G-Codes.md#endstop_phase) for additional
for additional information. information.
``` ```
[endstop_phase stepper_z] [endstop_phase stepper_z]
@ -1265,7 +1263,7 @@ G-Code macros (one may define any number of sections with a
Execute a gcode on a set delay. See the Execute a gcode on a set delay. See the
[command template guide](Command_Templates.md#delayed-gcodes) and [command template guide](Command_Templates.md#delayed-gcodes) and
[command reference](G-Codes.md#delayed-gcode) for more information. [command reference](G-Codes.md#delayed_gcode) for more information.
``` ```
[delayed_gcode my_delayed_gcode] [delayed_gcode my_delayed_gcode]
@ -1287,7 +1285,7 @@ gcode:
Support saving variables to disk so that they are retained across Support saving variables to disk so that they are retained across
restarts. See restarts. See
[command templates](Command_Templates.md#save-variables-to-disk) and [command templates](Command_Templates.md#save-variables-to-disk) and
[G-Code reference](G-Codes.md#save-variables) for further information. [G-Code reference](G-Codes.md#save_variables) for further information.
``` ```
[save_variables] [save_variables]
@ -1338,7 +1336,7 @@ a belt printer, can find use in looping sections of the sdcard file.
(For example, to print the same part over and over, or repeat the (For example, to print the same part over and over, or repeat the
a section of a part for a chain or other repeated pattern). a section of a part for a chain or other repeated pattern).
See the [command reference](G-Codes.md#sdcard-loop) for supported See the [command reference](G-Codes.md#sdcard_loop) for supported
commands. See the [sample-macros.cfg](../config/sample-macros.cfg) commands. See the [sample-macros.cfg](../config/sample-macros.cfg)
file for a Marlin compatible M808 G-Code macro. file for a Marlin compatible M808 G-Code macro.
@ -1350,7 +1348,7 @@ file for a Marlin compatible M808 G-Code macro.
Support manually moving stepper motors for diagnostic purposes. Note, Support manually moving stepper motors for diagnostic purposes. Note,
using this feature may place the printer in an invalid state - see the using this feature may place the printer in an invalid state - see the
[command reference](G-Codes.md#force-movement) for important details. [command reference](G-Codes.md#force_move) for important details.
``` ```
[force_move] [force_move]
@ -1362,7 +1360,7 @@ using this feature may place the printer in an invalid state - see the
### [pause_resume] ### [pause_resume]
Pause/Resume functionality with support of position capture and Pause/Resume functionality with support of position capture and
restore. See the [command reference](G-Codes.md#pause-resume) for more restore. See the [command reference](G-Codes.md#pause_resume) for more
information. information.
``` ```
@ -1377,7 +1375,7 @@ information.
Firmware filament retraction. This enables G10 (retract) and G11 Firmware filament retraction. This enables G10 (retract) and G11
(unretract) GCODE commands issued by many slicers. The parameters (unretract) GCODE commands issued by many slicers. The parameters
below provide startup defaults, although the values can be adjusted below provide startup defaults, although the values can be adjusted
via the SET_RETRACTION [command](G-Codes.md#firmware-retraction)), via the SET_RETRACTION [command](G-Codes.md#firmware_retraction)),
allowing per-filament settings and runtime tuning. allowing per-filament settings and runtime tuning.
``` ```
@ -1412,7 +1410,7 @@ Support for gcode arc (G2/G3) commands.
### [respond] ### [respond]
Enable the "M118" and "RESPOND" extended Enable the "M118" and "RESPOND" extended
[commands](G-Codes.md#send-message-respond-to-host). [commands](G-Codes.md#respond).
``` ```
[respond] [respond]
@ -1432,7 +1430,7 @@ Enable the "M118" and "RESPOND" extended
### [input_shaper] ### [input_shaper]
Enables [resonance compensation](Resonance_Compensation.md). Also see Enables [resonance compensation](Resonance_Compensation.md). Also see
the [command reference](G-Codes.md#resonance-compensation). the [command reference](G-Codes.md#input_shaper).
``` ```
[input_shaper] [input_shaper]
@ -1471,10 +1469,9 @@ the [command reference](G-Codes.md#resonance-compensation).
Support for ADXL345 accelerometers. This support allows one to query Support for ADXL345 accelerometers. This support allows one to query
accelerometer measurements from the sensor. This enables an accelerometer measurements from the sensor. This enables an
ACCELEROMETER_MEASURE command (see ACCELEROMETER_MEASURE command (see [G-Codes](G-Codes.md#adxl345) for
[G-Codes](G-Codes.md#adxl345-accelerometer-commands) for more more information). The default chip name is "default", but one may
information). The default chip name is "default", but one may specify specify an explicit name (eg, [adxl345 my_chip_name]).
an explicit name (eg, [adxl345 my_chip_name]).
``` ```
[adxl345] [adxl345]
@ -1510,7 +1507,7 @@ Support for resonance testing and automatic input shaper calibration.
In order to use most of the functionality of this module, additional In order to use most of the functionality of this module, additional
software dependencies must be installed; refer to software dependencies must be installed; refer to
[Measuring Resonances](Measuring_Resonances.md) and the [Measuring Resonances](Measuring_Resonances.md) and the
[command reference](G-Codes.md#resonance-testing-commands) for more [command reference](G-Codes.md#resonance_tester) for more
information. See the [Max smoothing](Measuring_Resonances.md#max-smoothing) information. See the [Max smoothing](Measuring_Resonances.md#max-smoothing)
section of the measuring resonances guide for more information on section of the measuring resonances guide for more information on
`max_smoothing` parameter and its use. `max_smoothing` parameter and its use.
@ -1829,8 +1826,7 @@ Support for additional steppers synchronized to the movement of an
extruder (one may define any number of sections with an extruder (one may define any number of sections with an
"extruder_stepper" prefix). "extruder_stepper" prefix).
See the [command reference](G-Codes.md#extruder-stepper-commands) for See the [command reference](G-Codes.md#extruder) for more information.
more information.
``` ```
[extruder_stepper my_extra_stepper] [extruder_stepper my_extra_stepper]
@ -1853,9 +1849,9 @@ Manual steppers (one may define any number of sections with a
"manual_stepper" prefix). These are steppers that are controlled by "manual_stepper" prefix). These are steppers that are controlled by
the MANUAL_STEPPER g-code command. For example: "MANUAL_STEPPER the MANUAL_STEPPER g-code command. For example: "MANUAL_STEPPER
STEPPER=my_stepper MOVE=10 SPEED=5". See STEPPER=my_stepper MOVE=10 SPEED=5". See
[G-Codes](G-Codes.md#manual-stepper-commands) file for a description [G-Codes](G-Codes.md#manual_stepper) file for a description of the
of the MANUAL_STEPPER command. The steppers are not connected to the MANUAL_STEPPER command. The steppers are not connected to the normal
normal printer kinematics. printer kinematics.
``` ```
[manual_stepper my_stepper] [manual_stepper my_stepper]
@ -2010,8 +2006,8 @@ section.
Generic heaters (one may define any number of sections with a Generic heaters (one may define any number of sections with a
"heater_generic" prefix). These heaters behave similarly to standard "heater_generic" prefix). These heaters behave similarly to standard
heaters (extruders, heated beds). Use the SET_HEATER_TEMPERATURE heaters (extruders, heated beds). Use the SET_HEATER_TEMPERATURE
command (see [G-Codes](G-Codes.md) for details) to set the target command (see [G-Codes](G-Codes.md#heaters) for details) to set the
temperature. target temperature.
``` ```
[heater_generic my_generic_heater] [heater_generic my_generic_heater]
@ -2445,8 +2441,8 @@ fan that will be enabled whenever its associated sensor is above a set
temperature. By default, a temperature_fan has a shutdown_speed equal temperature. By default, a temperature_fan has a shutdown_speed equal
to max_power. to max_power.
See the [command reference](G-Codes.md#temperature-fan-commands) for See the [command reference](G-Codes.md#temperature_fan) for additional
additional information. information.
``` ```
[temperature_fan my_temp_fan] [temperature_fan my_temp_fan]
@ -2492,8 +2488,7 @@ additional information.
Manually controlled fan (one may define any number of sections with a Manually controlled fan (one may define any number of sections with a
"fan_generic" prefix). The speed of a manually controlled fan is set "fan_generic" prefix). The speed of a manually controlled fan is set
with the SET_FAN_SPEED with the SET_FAN_SPEED [gcode command](G-Codes.md#fan_generic).
[gcode command](G-Codes.md#manually-controlled-fans-commands).
``` ```
[fan_generic extruder_partfan] [fan_generic extruder_partfan]
@ -2516,7 +2511,7 @@ with the SET_FAN_SPEED
Servos (one may define any number of sections with a "servo" Servos (one may define any number of sections with a "servo"
prefix). The servos may be controlled using the SET_SERVO prefix). The servos may be controlled using the SET_SERVO
[g-code command](G-Codes.md#servo-commands). For example: SET_SERVO [g-code command](G-Codes.md#servo). For example: SET_SERVO
SERVO=my_servo ANGLE=180 SERVO=my_servo ANGLE=180
``` ```
@ -2548,7 +2543,7 @@ pin:
Neopixel (aka WS2812) LED support (one may define any number of Neopixel (aka WS2812) LED support (one may define any number of
sections with a "neopixel" prefix). One may set the LED color via sections with a "neopixel" prefix). One may set the LED color via
"SET_LED LED=my_neopixel RED=0.1 GREEN=0.1 BLUE=0.1" type extended "SET_LED LED=my_neopixel RED=0.1 GREEN=0.1 BLUE=0.1" type extended
[g-code commands](G-Codes.md#neopixel-and-dotstar-commands). [g-code commands](G-Codes.md#neopixel).
``` ```
[neopixel my_neopixel] [neopixel my_neopixel]
@ -2576,7 +2571,7 @@ pin:
Dotstar (aka APA102) LED support (one may define any number of Dotstar (aka APA102) LED support (one may define any number of
sections with a "dotstar" prefix). One may set the LED color via sections with a "dotstar" prefix). One may set the LED color via
"SET_LED LED=my_dotstar RED=0.1 GREEN=0.1 BLUE=0.1" type extended "SET_LED LED=my_dotstar RED=0.1 GREEN=0.1 BLUE=0.1" type extended
[g-code commands](G-Codes.md#neopixel-and-dotstar-commands). [g-code commands](G-Codes.md#neopixel).
``` ```
[dotstar my_dotstar] [dotstar my_dotstar]
@ -2651,7 +2646,7 @@ Run-time configurable output pins (one may define any number of
sections with an "output_pin" prefix). Pins configured here will be sections with an "output_pin" prefix). Pins configured here will be
setup as output pins and one may modify them at run-time using setup as output pins and one may modify them at run-time using
"SET_PIN PIN=my_pin VALUE=.1" type extended "SET_PIN PIN=my_pin VALUE=.1" type extended
[g-code commands](G-Codes.md#custom-pin-commands). [g-code commands](G-Codes.md#output_pin).
``` ```
[output_pin my_pin] [output_pin my_pin]
@ -2738,7 +2733,7 @@ pins:
Configuration of Trinamic stepper motor drivers in UART/SPI mode. Configuration of Trinamic stepper motor drivers in UART/SPI mode.
Additional information is in the [TMC Drivers guide](TMC_Drivers.md) Additional information is in the [TMC Drivers guide](TMC_Drivers.md)
and in the [command reference](G-Codes.md#tmc-stepper-drivers). and in the [command reference](G-Codes.md#tmcxxxx).
### [tmc2130] ### [tmc2130]
@ -3663,8 +3658,8 @@ information on menu attributes available during template rendering.
Filament Switch Sensor. Support for filament insert and runout Filament Switch Sensor. Support for filament insert and runout
detection using a switch sensor, such as an endstop switch. detection using a switch sensor, such as an endstop switch.
See the [command reference](G-Codes.md#filament-sensor) for more See the [command reference](G-Codes.md#filament_switch_sensor) for
information. more information.
``` ```
[filament_switch_sensor my_sensor] [filament_switch_sensor my_sensor]
@ -3703,8 +3698,8 @@ Filament Motion Sensor. Support for filament insert and runout
detection using an encoder that toggles the output pin during filament detection using an encoder that toggles the output pin during filament
movement through the sensor. movement through the sensor.
See the [command reference](G-Codes.md#filament-sensor) for more See the [command reference](G-Codes.md#filament_switch_sensor) for
information. more information.
``` ```
[filament_motion_sensor my_sensor] [filament_motion_sensor my_sensor]

1847
docs/G-Codes.md
View File

File diff suppressed because it is too large Load Diff

2
docs/Hall_Filament_Width_Sensor.md
View File

@ -11,7 +11,7 @@ an assembly video is also available on [Youtube](https://www.youtube.com/watch?v
To use Hall filament width sensor, read To use Hall filament width sensor, read
[Config Reference](Config_Reference.md#hall_filament_width_sensor) and [Config Reference](Config_Reference.md#hall_filament_width_sensor) and
[G-Code documentation](G-Codes.md#Hall_Filament_Width_Sensor_Commands). [G-Code documentation](G-Codes.md#hall_filament_width_sensor).
## How does it work? ## How does it work?

9
docs/Measuring_Resonances.md
View File

@ -473,10 +473,11 @@ ignoring any errors for `SET_INPUT_SHAPER` command. For `TEST_RESONANCES`
command, specify the desired test axis. The raw data will be written into command, specify the desired test axis. The raw data will be written into
`/tmp` directory on the RPi. `/tmp` directory on the RPi.
The raw data can also be obtained by running the command `ACCELEROMETER_MEASURE` The raw data can also be obtained by running the command
command twice during some normal printer activity - first to start the `ACCELEROMETER_MEASURE` command twice during some normal printer
measurements, and then to stop them and write the output file. Refer to activity - first to start the measurements, and then to stop them and
[G-Codes](G-Codes.md#adxl345-accelerometer-commands) for more details. write the output file. Refer to [G-Codes](G-Codes.md#adxl345) for more
details.
The data can be processed later by the following scripts: The data can be processed later by the following scripts:
`scripts/graph_accelerometer.py` and `scripts/calibrate_shaper.py`. Both `scripts/graph_accelerometer.py` and `scripts/calibrate_shaper.py`. Both

12
docs/Probe_Calibrate.md
View File

@ -129,12 +129,12 @@ typical bed leveling procedures. It may be possible to tune the probe
speed and/or probe start height to improve the repeatability of the speed and/or probe start height to improve the repeatability of the
probe. The `PROBE_ACCURACY` command allows one to run tests with probe. The `PROBE_ACCURACY` command allows one to run tests with
different parameters to see their impact - see the different parameters to see their impact - see the
[G-Codes document](G-Codes.md) for further details. If the probe [G-Codes document](G-Codes.md#probe_accuracy) for further details. If
generally obtains repeatable results but has an occasional outlier, the probe generally obtains repeatable results but has an occasional
then it may be possible to account for that by using multiple samples outlier, then it may be possible to account for that by using multiple
on each probe - read the description of the probe `samples` config samples on each probe - read the description of the probe `samples`
parameters in the [config reference](Config_Reference.md#probe) for config parameters in the [config reference](Config_Reference.md#probe)
more details. for more details.
If new probe speed, samples count, or other settings are needed, then If new probe speed, samples count, or other settings are needed, then
update the printer.cfg file and issue a `RESTART` command. If so, it update the printer.cfg file and issue a `RESTART` command. If so, it

12
docs/TMC_Drivers.md
View File

@ -45,7 +45,7 @@ leave a stepper idle sufficiently long.
If one wishes to reduce current to motors during print start routines, If one wishes to reduce current to motors during print start routines,
then consider issuing then consider issuing
[SET_TMC_CURRENT](G-Codes.md#tmc-stepper-drivers) commands in a [SET_TMC_CURRENT](G-Codes.md#set_tmc_current) commands in a
[START_PRINT macro](Slicers.md#klipper-gcode_macro) to adjust the [START_PRINT macro](Slicers.md#klipper-gcode_macro) to adjust the
current before and after normal printing moves. current before and after normal printing moves.
@ -410,10 +410,10 @@ restrictions:
## Querying and diagnosing driver settings ## Querying and diagnosing driver settings
The `[DUMP_TMC command](G-Codes.md#tmc-stepper-drivers) is a useful The `[DUMP_TMC command](G-Codes.md#dump_tmc) is a useful tool when
tool when configuring and diagnosing the drivers. It will report all configuring and diagnosing the drivers. It will report all fields
fields configured by Klipper as well as all fields that can be queried configured by Klipper as well as all fields that can be queried from
from the driver. the driver.
All of the reported fields are defined in the Trinamic datasheet for All of the reported fields are defined in the Trinamic datasheet for
each driver. These datasheets can be found on the each driver. These datasheets can be found on the
@ -429,7 +429,7 @@ Klipper supports configuring many low-level driver fields using
has the full list of fields available for each type of driver. has the full list of fields available for each type of driver.
In addition, almost all fields can be modified at run-time using the In addition, almost all fields can be modified at run-time using the
[SET_TMC_FIELD command](G-Codes.md#tmc-stepper-drivers). [SET_TMC_FIELD command](G-Codes.md#set_tmc_field).
Each of these fields is defined in the Trinamic datasheet for each Each of these fields is defined in the Trinamic datasheet for each
driver. These datasheets can be found on the driver. These datasheets can be found on the

2
docs/TSL1401CL_Filament_Width_Sensor.md
View File

@ -7,7 +7,7 @@ designs at [Thingiverse](https://www.thingiverse.com/search?q=filament%20width%2
To use a sensor array as a filament width sensor, read To use a sensor array as a filament width sensor, read
[Config Reference](Config_Reference.md#tsl1401cl_filament_width_sensor) and [Config Reference](Config_Reference.md#tsl1401cl_filament_width_sensor) and
[G-Code documentation](G-Codes.md#Filament_Width_Sensor_Commands). [G-Code documentation](G-Codes.md#hall_filament_width_sensor).
## How does it work? ## How does it work?