¶ Firmware Error: Z Position Endstop Out of RangeError
¶ Error message:
!! position_endstop in section 'stepper_z' must be between position_min and position_max
¶ What This Error Means
This error occurs when your probe's Z-offset exceeds the maximum negative travel limit configured for the Z stepper motor.
The Ion firmware enforces strict boundaries on how close the print bed can move toward the print head. This safety feature protects your printer's components from potential damage.
¶ Why This Happens
The HTX firmware includes built-in protection limits that:
- Prevent the bed from colliding with the print head
- Safeguard against hardware damage if the Z-probe fails
- Protect components during unexpected software errors involving Z-axis coordinates
When your Z-offset configuration attempts to move beyond these safety limits, the firmware stops operation and displays this error to prevent mechanical damage.
This most commonly occurs after running the Z-offset wizard. Some causes of this:
- The head sustained damage from an impact
- The probe may need to be shimmed down further
Latest versions of the firmware should prevent being able to exceed the Z stepper limit in the wizard, but can carry over to a new firmware even after an update if previously present.
¶ Resolution Steps
-
Navigate to ION Firmware Config in the printer UI;
-
Locate and uncomment the default z_offset value:
-
Z_offset should now be uncommented (remove the leading # character)
-
Scroll all the way down to the bottom of the config and look for any additional z_offset values and DELETE THEM. If you don't see any that's ok.
If you see the value above - DELETE BOTH LINES from the config as shown above. so the printer clears the error.
-
Now run the Z-offset Calibration Wizard
-
If you encounter the same error after running the Z-offset calibration wizard, contact support as the probe may need to be shimmed, and they can provide instructions.