Skip to content

Existing Config

In order for Klipper-toolchanger-easy to operate, some of your existing config will either be made redundant or need to be transferred in to a tool config file.

Toolhead Sections

Everything related to the toolhead will be moved in to a tool config file or made redundant.

For now, it's best to comment out these items so they can be easily referenced later if needed.

  • [mcu mcu_name]
  • [extruder]
  • [tmc2209 extruder]
  • [adxl345]
  • [fan]
  • [heater_fan]

There may be more sections such as RGB, thermistors, etc. They all should be commented out.

Toolhead Boards

If you were already running a toolhead board, it's likely these sections are all in a separate file. You can simply comment out the include for that file in your printer.cfg.

Homing Sections

Klipper-toolchanger-easy has its own homing routine and requires any existing overrides to be disabled.

  • [probe]
  • [homing_override]
  • [safe_z]

[probe]

Because each tool now has its own OptoTap sensor, [probe] will be redefined as [tool_probe] and become part of your new tool config.

Saved Values

If you have any if the following saved values at the bottom of printer.cfg that were saved via the SAVE_CONFIG macro, they will need to be removed.

  • [probe]
  • [extruder]

With Klipper-toolchanger-easy, SAVE_CONFIG shouldn't be used for saving values. Using SAVE_CONFIG can cause conflicts with the tool configs. The values should instead be entered in to the sections of their respective tool config.