Deprecated Options
Here you can find a list of known Klipper changes with a description of how to fix them.
Last updated
Was this helpful?
Here you can find a list of known Klipper changes with a description of how to fix them.
Last updated
Was this helpful?
relative_reference_index
The relative_reference_index
option has been deprecated and superceded by the zero_reference_position
option. Refer to the for details on how to update the configuration. With this deprecation the RELATIVE_REFERENCE_INDEX
is no longer available as a parameter for the BED_MESH_CALIBRATE
G-Code command.
default_parameter_
for G-Code macros.In the past, default parameters for G-Code macros were defined like so:
This would define a macro called PRINT_START
that can be called with an EXTRUDER
parameter like so: PRINT_START EXTRUDER=200
. If no value is passed for EXTRUDER
the default value of 230 is used. This style of default parameters has been deprecated. Instead, define your macro like so:
Take note of the following important aspects:
Parameters passed to G-Code macros are stored in the params
object. So if your macro is called with VALUE=50
, params.VALUE
will contain the value 50. After the deprecation, only the params
object will contain these values.
Make sure to name your “set variable” something else as the name of the variable in the params
object (see how I used EXTRUDER_TEMP
for the “set variable” and EXTRUDER
for the actual macro parameter above) to avoid confusion and possible parsing errors.
If you want to pass a default, add |default(<default value>)
to the end of the params
variable (see above, where my default value is 10).
To ensure that EXTRUDER_TEMP
will have an integer value, add |int
to the end of the command, to turn passed parameters (if they exist) and the default into an integer. Depending on what kind of parameter you’re passing, there are |int
|float
|bool
or |string
converters available. Make sure that you convert to int if you want to compare the values in your G-Code macro.
step_distance
step_distance
describes the distance covered by a certain axis with 1 stepper (micro-)step. The downside of this parameter (and one of the reasons for its removal, is that if one were to change the microstepping of a stepper, the step_distance changes as well. Klipper therefore removed the step_distance
parameter in favor of rotation_distance
and full_steps_per_rotation
. These two parameters are unaffected by microstepping, and can be easily determined by inspecting the used hardware.
Perform the following steps to convert your config:
comment out the old step_distance
parameter
add three new parameters:
full_steps_per_rotation
this is 400 for 0.9 degree stepper motors and 200 for 1.8 degree stepper motors.
rotation_distance
this can be determined either according to hardware, or by converting the old step_distance
using math.
gear_ratio
can additionally be used to describe an axis that uses a reduction gear (like the Voron-2 Z axis)
For every stepper, except your extruder, you should end up with even numbers (e.g. 40 instead of 39.9683).
pin_map
For Voron printers, this is only relevant if you’re running an Arduino based controller board and use pins named similar to ar19
etc. These pin declarations are no longer valid and need to be replaced with their hardware pin identifiers. To find the appropriate hardware pin identifier perform a google image search for your board plus pinout
. E.g.:
arduino mega 2560 pinout
which will yield images such as this one:
There, find the pin you’re trying to replace. The old pin maps use the digital number of the pin. For example, if your old pin was ar10
, looking at the image you will find that the D10
pin corresponds to PB4
. Replace all pins in your config accordingly, and finally remove the pin_map:
configuration parameter from your mcu
section.
max_accel_to_decel
The above description was provided by our community member and we have his permission to publish it here. Thanks a lot!
The easiest way to obtain the correct values for rotation_distance
and gear_ratio
is to check the official Voron printer Github repositories. All example configs have been updated to include the correct values for the new parameters. Keep in mind that you’ll still have to calibrate your extruder steps/mm if you choose to copy the values for the extruder. Instructions on how to convert and recalibrate the extruder values can be found .
The formulas to convert step_distance
to rotation distance
can be found
Guidance on how to inspect your hardware to determine your conversion distance can be found . Make sure to also consider any reduction gearing, if applicable, by checking as well.
The above description was provided by our community member and we have his permission to publish it here. Thanks a lot!
Alternatively, you can copy an appropriate [board_pins]
block from to your config. If you’re using multiple Arduinos, make sure to add the appropriate mcu
to each block like so:
The above description was provided by our community member and we have his permission to publish it here. Thanks a lot!
The max_accel_to_decel
option has been deprecated and superceded by the minimum_cruise_ratio
option. Refer to the for details on how to update the configuration. The max_accel_to_decel
can be deleted in most cases, as the default value of minimum_cruise_ratio
should fit for most of the printers.