WIP NOT FOR GENERAL USE

klipper-toolchanger

Based on Viesturz's work on klipper-toolchanger

Tool changing extension for Klipper.

Klipper Compat Version

• Klipper > Jun 14, 2024 (1591a51)
• Danger Klipper > Feb 15, 2024 (0cd16e9) No longer compat till they update probe.py

Installation

NOTE: python 3.9+ is required for this mod, make sure your klipper install is using python 3.9+, otherwise you need to reinstall klipper with python 3.9+ before you continue

To install this plugin, run the installation script using the following command over SSH. This script will download this GitHub repository to your RaspberryPi home directory, and symlink the files in the Klipper extra folder.

wget -O - https://raw.githubusercontent.com/Stealthchanger/klipper-toolchanger/main/scripts/install.sh | bash

Add to printer.cfg in this order

• toolchanger-tool_detection.cfg
• toolchanger.cfg
• toolchanger-macros.cfg
• toolchanger-homing.cfg

tool configs one per tool, 2 examples to follow, they do not need to be names AVR

• tool-AVR0.cfg
• tool-AVR1.cfg

usermacros and extra-macro-examples are a good start for user macros and can be modified. Make sure to keep the _TOOL and _TOOLCHANGER macros in the right macros as they add special features.

• toolchanger-usermacros.cfg
• toolchanger-extra-macro-examples.cfg

Optional leds is based on the offical StealthBurner leds and converted to multi tool aware

• toolchanger-leds.cfg
• tool-AVR0-leds.cfg
• tool-AVR1-leds.cfg

Optional for calibration ball probe or modified sexcbolt

• calibrate-offsets.cfg
• calibrate-offsets-macros.cfg

PRINT_START slicer info

Make sure that safe_z_home is not defined as homing needs to be overridden in toolchanger-homing.cfg

If you choose to not use toolchanger-extra-macro-examples.cfg please make sure to use the _TOOLCHANGER_PRINT_START_START and _TOOLCHANGER_PRINT_START_END in your PRINT_START macro, also _TOOLCHANGER_PRINT_END_START and _TOOLCHANGER_PRINT_END_END in your PRINT_END macro. These are important to initialize the toolchanger as well as special protection calls.

Components

• Toolchanger - tool management support.
• Tool probe - per tool Z probe.
• Rounded path - rounds the travel path corners for fast non-print moves.
• Tools calibrate - support for contact based XYZ offset calibration probes.