Skip to main content

Heater Tolerance Configuration

Feature Description​

verify_heater is used to adjust Klipper's safety detection thresholds for heaters. It is not a configuration for increasing heating power, but rather for handling false positives caused by slow heating, high thermal inertia, or significant temperature fluctuations.

Safety Reminder
  • Do not blindly relax detection thresholds to bypass actual faults.
  • If the heater fails to reach temperature, prioritize checking the heating element, heated bed, MOS tube, power supply, power rating, thermistor wiring, and thermistor model.
  • After modification, observe a full heating cycle in person to confirm normal temperature changes.

Extruder Reference Configuration​

printer.cfg
[verify_heater extruder]
max_error: 120
check_gain_time: 120
hysteresis: 50
heating_gain: 2

Heated Bed Reference Configuration​

printer.cfg
[verify_heater heater_bed]
max_error: 120
check_gain_time: 120
hysteresis: 50
heating_gain: 2

Parameter Description​

ParameterDescription
max_errorMaximum cumulative temperature error; exceeding this will trigger a heating anomaly error in Klipper
check_gain_timeTime window for checking heating gain; can be increased for slow-heating beds
hysteresisTemperature hysteresis range; can be widened if temperature fluctuations are significant
heating_gainMinimum temperature increase expected within the check time window

Suitable Adjustment Scenarios​

  • Large heated beds heat up slowly; hardware is confirmed normal but intermittent Heater heater_bed not heating at expected rate occurs
  • High-temperature hotend fluctuates near target temperature; PID is calibrated but occasional false positives still occur
  • Chamber temperature changes slow down the heating curve of the bed or hotend
  • Thermistor temperature reads negative numbers, hundreds of degrees, or shows obvious jumps
  • Heater temperature does not change at all after being turned on
  • MOS tube, wiring terminals, or power supply show signs of heat, discoloration, or odor
  • Configured sensor_type does not match the actual thermistor model

Debugging Suggestions​

  1. First, perform PID calibration and save the configuration.
  2. Observe a full heating cycle starting from a cold state.
  3. Only add [verify_heater] for the heater that triggers false positives; avoid modifying multiple heaters at once.
  4. Modify only one parameter at a time and record performance before and after the change.

Common PID calibration commands:

PID_CALIBRATE HEATER=extruder TARGET=245
PID_CALIBRATE HEATER=heater_bed TARGET=100
SAVE_CONFIG
Loading...