klipper/docs/Axis_Twist_Compensation.md

2.2 KiB

Axis Twist Compensation

This document describes the [axis_twist_compensation] module.

Some printers may have a small twist in their X rail which can skew the results of a probe attached to the X carriage. This is common in printers with designs like the Prusa MK3, Sovol SV06 etc and is further described under probe location bias. It may result in probe operations such as Bed Mesh, Screws Tilt Adjust, Z Tilt Adjust etc returning inaccurate representations of the bed.

This module uses manual measurements by the user to correct the probe's results. Note that if your axis is significantly twisted it is strongly recommended to first use mechanical means to fix it prior to applying software corrections.

Warning: This module is not compatible with dockable probes yet and will try to probe the bed without attaching the probe if you use it.

Overview of compensation usage

Tip: Make sure the probe X and Y offsets are correctly set as they greatly influence calibration.

  1. After setting up the [axis_twist_compensation] module, perform AXIS_TWIST_COMPENSATION_CALIBRATE
  • The calibration wizard will prompt you to measure the probe Z offset at a few points along the bed
  • The calibration defaults to 3 points but you can use the option SAMPLE_COUNT= to use a different number.
  1. Adjust your Z offset
  2. Perform automatic/probe-based bed tramming operations, such as Screws Tilt Adjust, Z Tilt Adjust etc
  3. Home all axis, then perform a Bed Mesh if required
  4. Perform a test print, followed by any fine-tuning as desired

Tip: Bed temperature and nozzle temperature and size do not seem to have an influence to the calibration process.

[axis_twist_compensation] setup and commands

Configuration options for [axis_twist_compensation] can be found in the Configuration Reference.

Commands for [axis_twist_compensation] can be found in the G-Codes Reference