Steps per mm calculator
Pick belt or leadscrew, enter the motor, the microstepping and the pulley or lead, and get the steps per mm.
About Steps per mm Calculator
The firmware needs to know how many motor steps move an axis by one millimetre. For a belt axis the motor turns a pulley, so the distance per turn is the belt pitch times the number of teeth. A 2 mm GT2 belt on a 20 tooth pulley moves 40 mm per turn. A 200 step motor at 16 times microstepping makes 3200 microsteps per turn, so the answer is 80 steps per mm. A leadscrew works the same way, using its lead in place of the belt travel.
- Setting up a new printer build or a firmware config.
- Checking what a pulley swap will do.
- Converting between Marlin steps and Klipper rotation_distance.
- Knowing the smallest move the axis can make.
How to use Steps per mm Calculator
Step 1
Choose belt or leadscrew.
Step 2
Pick the motor step count and the microstepping your driver uses.
Step 3
Enter the belt pitch and teeth, or the lead, and read the result.
Good to know
- Lead is not the same as thread pitch. It is the pitch times the number of starts. A common T8 screw with four starts and 2 mm pitch has a lead of 8 mm.
- Check the microstepping set on the driver, not the one in your head. Drivers in UART mode may interpolate to 256 internally but still use your set number for steps.
- A non-whole result is fine. The firmware rounds each move to the nearest microstep.
Common questions
What is the formula for a belt axis?
Steps per mm = motor full steps x microstepping / (belt pitch x pulley teeth).
What do I enter in Klipper?
Klipper uses rotation_distance, the distance per motor turn. It is shown in the second row, and the motor steps and microsteps go in their own config lines.
Does belt length matter?
No. Only the pulley and belt pitch matter. Stretch or slipping shows up as errors, not as a different setting.