Skip to content

Touch calibration

  1. Home your printer’s X and Y axes

    G28 X Y
  2. Prepare to run touch calibration

  3. Start calibration routine

    Start the calibration by running

    CARTOGRAPHER_TOUCH_CALIBRATE

    Observe your nozzle to make sure it touches on the bed.

    If it never touches the bed, refer to Nozzle never touches the bed

  4. Save the calibrated model

    Once done, you will be prompted to run SAVE_CONFIG. The Klipper firmware should restart and you will be able to use CARTOGRAPHER_TOUCH_*.

    SAVE_CONFIG

You should ensure that your Z motion is smooth and clean. Gunk and noise that is not evident while moving up and down may be detected by Cartographer and make it believe it touched the bed. After checking everything, run CARTOGRAPHER_TOUCH_CALIBRATE again.

If it is still a problem, you can pass in a START parameter. CARTOGRAPHER_TOUCH_CALIBRATE START=123 where 123 is above the threshold it previously stopped at.
If it stops without ever touching the bed and never finds a threshold you can increase the max threshold with the MAX parameter, CARTOGRAPHER_TOUCH_CALIBRATE MAX=5000.