f22f7574b3
* bed_level: major rework deprecate screw positions, we will be auto-detecting from now on support rotating the layout (previously only rotated the button actions) invert support, inverting axis in KS will invert the layout * move: mark bed_level to reinit after invert * bed_level: rotate with a shift function * bed_level: rotation show popup if misconfigured * bed_level: message for screw configurations not supportted in a more informative way * docs: update bed_level docs
55 lines
2.5 KiB
Markdown
55 lines
2.5 KiB
Markdown
# Bed level
|
|
|
|
|
|
|
|
For this panel to appear in the menu `[bed_screws]` or `[screws_tilt_adjust]` need to be defined in Klipper config (printer.cfg)
|
|
|
|
!!! Important
|
|
* `[bed_screws]` uses nozzle positions (nozzle above the screw) [Read Klipper doc entry](https://www.klipper3d.org/Config_Reference.html#bed_screws)
|
|
* `[screws_tilt_adjust]` uses probe positions (probe above the screw) [Read Klipper doc entry](https://www.klipper3d.org/Config_Reference.html#screws_tilt_adjust)
|
|
|
|
|
|
The corner buttons in KlipperScreen place the nozzle above the screw to do the ["paper test"](https://www.klipper3d.org/Bed_Level.html?h=paper#the-paper-test).
|
|
|
|
When `[screws_tilt_adjust]` is defined a couple of things happen:
|
|
|
|
* A button named "Screws adjust" appears, it runs `SCREWS_TILT_CALCULATE` when is pressed,
|
|
and reports the amount to be adjusted into the labels of the corner buttons.
|
|
* `[bed_screws]` is now ignored by KlipperScreen. (explained below)
|
|
* The corner buttons are now `[screws_tilt_adjust]` coordinates with the probe offset applied. (explained below)
|
|
|
|
### Why `[bed_screws]` are ignored/not used?
|
|
|
|
`[screws_tilt_adjust]` positions with offset will be used over `[bed_screws]`, because if the probe offset is changed or
|
|
the difference between `[bed_screws]` and `[screws_tilt_adjust]` wasn't calculated correctly,
|
|
the "Screws adjust" button stops working correctly.
|
|
|
|
### Why the probe offset is applied to `[screws_tilt_adjust]`?
|
|
|
|
Because the corner buttons in KlipperScreen should place the nozzle above the screw to do the ["paper test"](https://www.klipper3d.org/Bed_Level.html?h=paper#the-paper-test).
|
|
It doesn't affect the function of `SCREWS_TILT_CALCULATE`, which will go to the defined positions.
|
|
|
|
## Is `BED_SCREWS_ADJUST` supported?
|
|
|
|
No, but you can achieve the same thing by using the corner buttons and going in a circle pattern adjusting until desired.
|
|
`BED_SCREWS_ADJUST` is just a helper that moves to the screws in sequence
|
|
|
|
## Limitations
|
|
|
|
The panel doesn't support more than 9 screws or grids bigger than 3x3.
|
|
|
|
## Rotation
|
|
|
|
The layout can be rotated if the screen is not directly in front of the machine.
|
|
in the printer configuration you would add screw_rotation: 90
|
|
Valid values are 0 90 180 270
|
|
|
|
## Inversion
|
|
|
|
The layout will be inverted if an axis is inverted in the move panel
|
|
|
|
## Is there an alternative?
|
|
|
|
If you have a reliable probe, define `[bed_mesh]` in Klipper config, remove the springs
|
|
and use some thread-locker or locking nuts to fix the bed to the gantry, let the probe do a mesh save it and forget about this.
|