github-personal/klipper_auto_speed
1
0
Fork 0
mirror of https://github.com/outbackdingo/klipper_auto_speed.git synced 2026-01-27 10:19:30 +00:00
Code Issues Packages Projects Releases Wiki Activity
23 Commits 1 Branch 0 Tags
fb36f62d60acbc2346e00f84edf3447746ba9b22
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Chad Condon fb36f62d60 Make graph destination directory configurable 
I use the input shaper graphing features from Klippain.[^1]
I would like all my graphs to live in the same place.

[^1]: https://github.com/Frix-x/klippain/blob/main/docs/input_shaper.md
2023-11-06 19:27:14 -08:00
.github/ISSUE_TEMPLATE
Update issue templates
2023-11-02 18:10:13 -10:00
auto_speed.py
Make graph destination directory configurable
2023-11-06 19:27:14 -08:00
install.sh
Fix script permissions
2023-10-19 22:44:14 -07:00
LICENSE
Initial working commit
2023-10-11 17:24:58 -10:00
README.md
Make graph destination directory configurable
2023-11-06 19:27:14 -08:00

README.md

Klipper Auto Speed

Klipper module for automatically calculating your printer's maximum acceleration/velocity

With one copy/paste and one line in your configuration, automatically optimize your printer's motion

This module automatically performs movements on the x, y, x diagonal, y diagonal , and z axes, and measures your steppers missed steps at various accelerations/velocities. With the default configuration, this may take awhile (~10 minutes). Most of the testing time is waiting for your printer to home. On my printer with default settings (except MAX_MISSED), it takes ~3.5 minutes for acceleration, and ~5 minutes for velocity.

Sensorless homing: If you're using sensorless homing MAX_MISSED=1.0 is probably too low. The endstop variance check will tell you how many steps you lose when homing. For instance, on my printer I lose around 0-4.2 steps each home. I run AUTO_SPEED MAX_MISSED=10.0 to account for that variance, and occasional wildly different results.

This module is under development, and has only been validated on CoreXY printers: You may run into issues or bugs, feel free to use the discord channel, or post an issue here.

Your printer shouldn't have any crashes due to the movement patterns used, and re-homing before/after each test, so it's safe to walk away and let it do it's thing.

Table of Contents

Overview

  • License: MIT

Example Usage

  • Default usage (find max accel/velocity)
    • AUTO_SPEED
  • Find maximum acceleration on y axis
    • AUTO_SPEED_ACCEL AXIS="y"
  • Find maximum acceleration on y, then x axis
    • AUTO_SPEED_VELOCITY AXIS="y,x"
  • Validate your printer's current accel/velocity
    • AUTO_SPEED_VALIDATE
  • Graph your printer's max accel
    • AUTO_SPEED_GRAPH
  • Graph your printer's max accel between v100 and v1000, over 9 steps
    • AUTO_SPEED_GRAPH VELOCITY_MIN=100 VELOCITY_MAX=1000 VELOCITY_DIV=9

Roadmap

  • Make _ACCEL/_VELOCITY smarter, based on printer size
  • Add support for running through moonraker
  • Save validated/measured results to printer config
  • Add testing Z axis
  • Reduce code duplication
  • Check kinematics to find best movement patterns
  • Update calculated accel/velocity depending on test to be more accurate
  • Update axis movement logic

How does it work?

  1. Home your printer
  2. If your print is enclosed, heat soak it. You want to run this module at the typical state your printer is in when you're printing.
  3. Run AUTO_SPEED
    1. Check endstop variance
      • Validate the endstops are accurate enough for MAX_MISSED
    2. Find the maximum acceleration
      • Perform a binary search between ACCEL_MIN and ACCEL_MAX
      • velocity = sqrt(travel/accel)*accel / 2.5
      1. Home, and save stepper start steps
      2. Perform the movement check on the specified axis
      3. Home, and save stepper stop steps
    3. Find maximum velocity
      • Perform a binary search between VELOCITY_MIN and VELOCITY_MAX
      • accel = \frac{velocity^2}{travel} * 2.5
      1. Home, and save stepper start steps
      2. Perform the movement check on the specified axis
      3. Home, and save stepper stop steps
    4. Show results
      • Print results on each axis, for both accel and velocity, and also print the recommended (derated) values

Using Klipper Auto Speed

Moonraker Update Manager

[update_manager klipper_auto_speed]
type: git_repo
path: ~/klipper_auto_speed
origin: https://github.com/anonoei/klipper_auto_speed.git
primary_branch: main
install_script: install.sh
managed_services: klipper

Installation

To install this module you need to clone the repository and run the install.sh script. Depending on when you installed klipper, you may also need to update your klippy-env python version.

Automatic installation

cd ~
git clone https://github.com/Anonoei/klipper_auto_speed.git
cd klipper_auto_speed
./install.sh

Manual installation

  1. Clone the repository
    1. cd ~
    2. git clone https://github.com/Anonoei/klipper_auto_speed.git
    3. cd klipper_auto_speed
  2. Link auto_speed to klipper
    1. ln -sf ~/klipper_auto_speed/auto_speed.py ~/klipper/klippy/extras/auto_speed.py
  3. Install matplotlib
    1. ~/klippy-env/bin/python -m pip install matplotlib
  4. Restart klipper
    1. sudo systemctl restart klipper

Update klippy-env

  1. sudo apt install python3
  2. sudo apt install python3-numpy
  3. sudo systemctl stop klipper
  4. python3 -m venv --update ~/klippy-env
  5. ~/klippy-env/bin/pip install -r "~/klipper/scripts/klippy-requirements.txt"

Configuration

Place this in your printer.cfg

[auto_speed]

The values listed below are the defaults Auto Speed uses. You can include them if you wish to change their values or run into issues.

[auto_speed]
axis: diag_x, diag_y  ; One or multiple of `x`, `y`, `diag_x`, `diag_y`, `z`

margin: 20            ; How far away from your axes to perform movements

settling_home: True   ; Perform settling home before starting Auto Speed
max_missed: 1.0       ; Maximum full steps that can be missed
endstop_samples: 3    ; How many endstop samples to take for endstop variance

accel_min: 1000.0     ; Minimum acceleration test may try
accel_max: 50000.0    ; Maximum acceleration test may try
accel_accu: 0.05      ; Keep binary searching until the result is within this percentage

velocity_min: 50.0    ; Minimum velocity test may try
velocity_max: 5000.0  ; Maximum velocity test may try
velocity_accu: 0.05   ; Keep binary searching until the result is within this percentage

derate: 0.8           ; Derate discovered results by this amount

validate_margin: Unset      ; Margin for VALIDATE, Defaults to margin
validate_inner_margin: 20.0 ; Margin for VALIDATE inner pattern
validate_iterations: 50     ; Perform VALIDATE pattern this many times

results_dir: ~/printer_data/config ; Destination directory for graphs

Macro

Auto Speed is split into 5 separate macros. The default AUTO_SPEED automatically calls the other three (AUTO_SPEED_ACCEL, AUTO_SPEED_VELOCITY, AUTO_SPEED_VALIDATE). You can use any argument from those macros when you call AUTO_SPEED.

You can also use AUTO_SPEED_GRAPH to find your printers velocity-to-accel relationship.

AUTO_SPEED

AUTO_SPEED finds maximum acceleration, velocity, and validates results at the end.

Argument Default Description
AXIS Unset Perform test on these axes, defaults to diag_x, diag_y
Z 50 Z position to run Auto Speed
MARGIN 20 How far away from your axis maximums to perform the test movement
SETTLING_HOME 1 Perform settling home before starting Auto Speed
MAX_MISSED 1.0 Maximum full steps that can be missed
ENDSTOP_SAMPLES 3 How many endstop samples to take for endstop variance
TEST_ATTEMPTS 2 Re-test this many times if test fails
ACCEL_MIN 1000.0 Minimum acceleration test may try
ACCEL_MAX 50000.0 Maximum acceleration test may try
ACCEL_ACCU 0.05 Keep binary searching until the result is within this percentage
VELOCITY_MIN 50.0 Minimum velocity test may try
VELOCITY_MAX 5000.0 Maximum velocity test may try
VELOCITY_ACCU 0.05 Keep binary searching until the result is within this percentage
LEVEL 1 Level the printer if it's not leveled
VARIANCE 1 Check endstop variance

AUTO_SPEED_ACCEL

AUTO_SPEED_ACCEL find maximum acceleration

Argument Default Description
AXIS Unset Perform test on these axes, defaults to diag_x, diag_y
MARGIN 20.0 Used when DIST is 0.0, how far away from axis to perform movements
DERATE 0.8 How much to derate maximum values for the recommended max
MAX_MISSED 1.0 Maximum fulls steps that can be missed
ACCEL_MIN 1000.0 Minimum acceleration test may try
ACCEL_MAX 50000.0 Maximum acceleration test may try
ACCEL_ACCU 0.05 Keep binary searching until the result is within this percentage

AUTO_SPEED_VELOCITY

AUTO_SPEED_VELOCITY finds maximum velocity

Argument Default Description
AXIS Unset Perform test on these axes, defaults to diag_x, diag_y
MARGIN 20.0 Used when DIST is 0.0, how far away from axis to perform movements
DERATE 0.8 How much to derate maximum values for the recommended max
MAX_MISSED 1.0 Maximum fulls steps that can be missed
VELOCITY_MIN 100.0 Minimum velocity test may try
VELOCITY_MAX 5000.0 Maximum velocity test may try
VELOCITY_ACCU 0.05 Keep binary searching until the result is within this percentage

AUTO_SPEED_VALIDATE

AUTO_SPEED_VALIDATE validates a specified acceleration/velocity, using Ellis' TEST_SPEED Pattern

Argument Default Description
MAX_MISSED 1.0 Maximum fulls steps that can be missed
VALIDATE_MARGIN 20.0 Margin axes max/min pattern can move to
VALIDATE_INNER_MARGIN 20.0 Margin from axes center pattern can move to
VALIDATE_ITERATIONS 50 Repeat the pattern this many times
ACCEL Unset Defaults to current max accel
VELOCITY Unset Defaults to current max velocity

AUTO_SPEED_GRAPH

AUTO_SPEED_GRAPH graphs your printer's velocity-to-accel relationship on specified axes You must specify VELOCITY_MIN and VELOCITY_MAX.

Argument Default Description
AXIS Unset Perform test on these axes, defaults to diag_x, diag_y
MARGIN 20.0 Used when DIST is 0.0, how far away from axis to perform movements
DERATE 0.8 How much to derate maximum values for the recommended max
MAX_MISSED 1.0 Maximum fulls steps that can be missed
VELOCITY_MIN Unset Minimum velocity test may try
VELOCITY_MAX Unset Maximum velocity test may try
VELOCITY_DIV 5 How many velocities to test
VELOCITY_ACCU 0.05 Keep binary searching until the result within this percent
ACCEL_MIN_SLOPE 100 Calculated min slope value \frac{10000}{velocity \div slope}
ACCEL_MAX_SLOPE 1800 Calculated max slope value \frac{10000}{velocity \div slope}

Console Output

Console output is slightly different depending on whether testing acceleration/velocity, and which axis is being tested.

  • axis is one of x, y, diag_x, diag_y, z
  • The three times after times are first home time, movement time, end home time

For acceleration tests:

AUTO SPEED accel on diag_x try 1 (19.66s)
Moved 1.43mm at a17333/v241 after 8.92/0.30/9.93s
Missed X 0.31, Y 2.00

Velocity tests are the same as acceleration except a few details

AUTO SPEED velocity on diag_y try 1 (23.91s)
Moved 13.44mm at a91456/v1700 after 8.92/0.31/13.87s
Missed X 0.06, Y 132.00

Acceleration results

AUTO SPEED found maximum acceleration after 218.00s
| DIAG X max: 48979
| DIAG Y max: 48979

Recommended values:
| DIAG X max: 39183
| DIAG Y max: 39183
Recommended acceleration: 39183

Velocity results

AUTO SPEED found maximum velocity after 307.60s
| DIAG X max: 577
| DIAG Y max: 552

Recommended values
| DIAG X max: 462
| DIAG Y max: 442
Recommended velocity: 442

Recommended results

AUTO SPEED found recommended acceleration and velocity after 525.61s
| DIAG X max: a39183 v462
| DIAG Y max: a39183 v442
Recommended accel: 39183
Recommended velocity: 442
Reference in New Issue View Git Blame Copy Permalink
Description
No description provided
Readme MIT 103 KiB
Languages
Python 97.3%
Shell 2.7%