Skip to content

Validation

Klipper Error

If you are experiencing Klipper errors after setting up your toolchanger-config and T0 config, please consult Software Troubleshooting.

Pre Launch

Before configuring and calibrating the other tools, it is advised to get the printer printing with tool 0 before continuing configuration of everything else. Before homing and starting a print, there are some checks we should do to make sure everything behaves as intended.

Hardware Checks

Make sure your toolhead passes all of the following checks before continuing.

  1. When you place the tool on the shuttle the OptoTap sensor triggers its LED.
  2. The part cooling fans turn on with M106 S127 and off with M107.
  3. The hotend heats up and the hotend fan turn on with M104 S200.
  4. Once at temperature, the extruder motor moves with G1 E100 F100.
  5. Finally, turn the hotend off with M104 S0

If any of these steps fails, the issue could be either hardware or software related. Consult the Hardware Troubleshooting and Software Troubleshooting.

Tool detection and homing

  1. Check that the tool detection is working by running INITIALIZE_TOOLCHANGER with, and without the tool on the shuttle. You should get confirmation that the tool either was or wasn't detected.
  2. With the tool on the shuttle, home the Y axis by running G28 Y.
  3. Run G28 X.
  4. Run G28 Z.

Success

At this point the printer should be homed and everything is running as intended.

If you have any issues initializing or homing, please consult Software Troubleshooting.

Backplate Break In

Because the StealthChanger’s action relies on precisely fitted pins and bushings, it’s a good idea to operate the mechanism repeatedly to allow the components to seat properly. This break-in process should be performed for every tool.

TAP Only

This method only works for TAP probing.

  1. Heatsoak your printer.
  2. Run G28
  3. Run QUAD_GANTRY_LEVEL
  4. Run G28 Z
  5. Run PROBE_ACCURACY SAMPLES=100

Failure

If you experience failure during this step or you feel the accuracy is not as good as it should be, consult the Hardware Troubleshooting section.

Probe offset

Before being able to print, it is nesacerry to calibrate your probe offsets. This procedure differs depending on whether you are using the OptoTap Sensor or an Eddy current sensor for probing.

[tool_probe] example.
    [tool_probe T0]
    pin: NHK0:gpio10
    tool: 0 # change to the index of the tool. 0, 1, 2, etc.
    z_offset = -1.05 # Needs to be calibrated. More positive = More Squish
  1. Ensure that your [tool_probe] section's z_offset variable is set to 0.
  2. Home the printer with G28.
  3. Run QUAD_GANTRY_LEVEL.
  4. Run G28 Z.
  5. Run PROBE_CALIBRATE.
  6. Change the z_offset variable in the tool's [tool_probe] section.

SAVE_CONFIG

Because klipper-toolchanger-easy reroutes probe to each tool object, when you run SAVE_CONFIG it saves the values to [probe]. Having a [probe] section in your config while also having [tool_probe] will cause issues with Klipper. SAVE_CONFIG should be avoided.

If you do save the values, you will need to move the offset from the bottom of printer.cfg to your tools [tool_probe] section.

Set the probe offsets as per your sensor's documentation.

First Print

If you copied your [extruder] values from a previous config, you are ready for your first print. If your setting up the printer for the first time, you may need to PID tune your hotend and tune your extruder first.

Extruder Tuning

For PID tuning we recommend Voron's PID Tuning Guide.

For extruder calibration we recommend Ellis' Extruder Calibration Guide.

Run a print as you would for any standard printer first print. As long as the tool is on the shuttle, the printer will behave as any other TAP based printer.

Is that it?

Getting a single tool printing is much the same as any other printer. We shouldnt bother ourselves with any tool offsets or park positions just yet.