autoz

Requirements: Physical Z-Endstop - it is our reference point and is always Z 0.0 for calculations. BLTouch as probe - the sensor to check the distance between endstop and bed to calc the offset QUAD_GANTRY_LEVEL or Z_TILT used (the plugin checks if qgl or z-tilt is applied to ensure gantry and bed are parallel for correct values) Ensure you set you x and y offset correct cause the plugin usses this offsets to move the bltouch over the endstop pin! How it works: The bltouch will probe two points - top of endstop and surface of your bed to messure the distance. Now we have one problem: the nozzle triggers the endstop the bltouch can only touch the top surface - to ensure a correct offset the plugin includes a move distance of 0.5mm (spec value from omron switches used in voron builts) which is the way the microsowitch in the endstop needs to trigger BUT: ususally a bit more than 0.5mm is needed to trigger correctly (~0.1x till ~0.2x in most cases depending on the used microswitch). This last bit can be set manually during a print probe by adjusting with babysteps until offset is correct and adding this to the config section of the plugin.

                                                | |
                                  Nozzle        | |  BLTouch
                                  |_   _|        -___________________
                                    \_/______________________________| Z-Offset BLTouch

Bed __________________________________________ _______________________________________ | | Endstop Pin ___________________________| Endstop-Bed Offset | | Configuration for klipper:

[auto_offset_z]

center_xy_position:175,175 # Center of bed for example

endstop_xy_position:233.5,358 # Physical endstop nozzle over pin

speed: 100 # X/Y travel speed between the two points

z_hop: 10 # Lift nozzle to this value after probing and for move

z_hop_speed: 20 # Hop speed of probe

ignore_alignment: False # Optional - by default False - this allows ignoring the presence of z-tilt or quad gantry leveling config section

ignore_internaloffset: False # Optional - by default False - this allows ignoring the fixed internal offset of 0.5mm if no microswitch is used while using other methods

offset_min: -1 # Optional - by default -1 is used - used as failsave to raise an error if offset is lower than this value

offset_max: 1 # Optional - by default 1 is used - used as failsave to raise an error if offset is higher than this value

endstop_min: 0 # Optional - by default disabled (0) - used as failsave to raise an error if endstop is lower than this value

endstop_max: 0 # Optional - by default disabled (0) - used as failsave to raise an error if endstop is higher than this value

offsetadjust: 0.0 # Manual offset correction option - start with zero and optimize during print with babysteps 1) If you need to lower the nozzle from -0.71 to -0.92 for example your value is -0.21. 2) If you need to move more away from bed add a positive value. 3) With version 0.0.5 of this plugin you can optinal use a parameter for example: AUTO_OFFSET_Z OFFSETADJUST=0.1 - this way the value from config section is ignored.

Installation: git clone https://github.com/hawkeyexp/auto_offset_z.git

cd ~/auto_offset_z

./install.sh

sample code: AUTO_OFFSET_Z This will use configured params from config section only - ensure your params are valid also in probe section

AUTO_OFFSET_Z OFFSEADJUST=0.1 This will ignore the offsetadjust value from config section and use the paramameter value given - this is helpfull for materials which needs a mire tight nozzle or a mor far nozzle to print correcntly - you can handle what is needed in your macros during print and for example detect material type by filenames of the printjob (cura) or additional gcode params for material in superslicer etc.

https://klipper.discourse.group/t/logic-check-probe-on-trigger-vs-un-trigger/15708

https://github.com/tronfu/Voron-Mods/blob/main/Tridex/Auto_3-Axes_Calibration/Klipper_firmware/printer.cfg

https://github.com/Klipper3d/klipper/blob/master/klippy/extras/homing.py

https://github.com/protoloft/klipper_z_calibration/blob/master/z_calibration.py