SCREWS_TILT_CALCULATE on the Creality K2 — manual bed levelling, no extra hardware

If you've tried to use Klipper's stock SCREWS_TILT_CALCULATE on a Creality K2, you'll have hit this:

``` AttributeError: 'list' object has no attribute 'bed_z' ```

…the first time you run it. Drop the upstream Klipper file in place, run the command, and Klipper crashes on its own probe-helper API. We've shipped a small fork that fixes it — K2-Screws-Tilt — bringing the manual bed-level helper to the K2 family using your printer's existing strain-gauge probe. No extra hardware.

Why it doesn't work out of the box

Upstream Klipper's screws_tilt_adjust.py was rewritten a while back to use a newer probe-helper API. The finalize callback now receives (phoming, offsets, positions) with positions as objects exposing a .bed_z attribute.

Creality's Klipper fork on the K2 is older: it still uses the 2-arg callback (offsets, positions) with positions as plain [x, y, z] lists. Drop in upstream's file and you get the AttributeError above the first time the probe finishes a position.

What this fork changes

Two minimal patches against upstream:

• The finalize signature is swapped to the 2-arg form.
• pos.bed_z is swapped to pos[2].

That's it. The actual tilt math, screw-thread calculation, and CW/CCW direction output are upstream Klipper code, unchanged.

Install (one line)

On Windows, in PowerShell:

```powershell iwr -useb https://raw.githubusercontent.com/grant0013/K2-Screws-Tilt/main/bootstrap.ps1 | iex ```

The script checks for Python (installs it via winget if missing), downloads the repo, installs paramiko, asks for your printer's IP, and runs the installer — no manual SSH needed.

On macOS or Linux:

```sh git clone https://github.com/grant0013/K2-Screws-Tilt cd K2-Screws-Tilt pip install paramiko python install_k2.py --host 192.168.x.x ```

The installer uses the Creality stock root password (creality_2024) by default; override with --password MYPASS if you've changed it.

Using it

Two-step workflow from the Fluidd / Mainsail gcode console:

``` G28 SCREWS_TILT_CALCULATE ```

Klipper probes each of the four bed-screw positions and prints something like:

``` front left : x=30.0, y=30.0, z=0.015 front right: x=230.0, y=30.0, z=0.048, CW 00:04, Adjust back left : x=30.0, y=230.0, z=-0.012, CCW 00:02, Adjust back right : x=230.0, y=230.0, z=0.031, CW 00:03, Adjust ```

The CW 00:04 notation means "turn clockwise by 4 minutes of an hour" — i.e. 4/60 of a full turn. Adjust by hand, re-run SCREWS_TILT_CALCULATE, and repeat. Most K2 beds converge in 2-3 iterations from a fresh "loosen everything first" starting point.

For tighter tolerances, pass MAX_DEVIATION:

``` SCREWS_TILT_CALCULATE MAX_DEVIATION=0.05 ```

…and the helper warns when any screw is off by more than 0.05 mm. To force all adjustments in one direction (handy if you've over-tightened and want to back off everything together):

``` SCREWS_TILT_CALCULATE DIRECTION=CCW ```

Compatibility

| Printer | Board | Status | |---|---|---| | K2 Combo | CR0CN200400C10 (F021) | Confirmed working — firmware V1.1.4.1 | | K2 / K2 Pro | Same board | Should work — please report results | | K2 Plus | CR0CN240319C13 (F008) | Untested — you probably want [z_tilt] instead (dual Z) | | K1 / K1C / K1 Max | CR4CU220812S* | Untested |

The default [screws_tilt_adjust] section assumes a 4-screw layout at (30, 30), (230, 30), (30, 230), (230, 230) — correct for the K2's 260 mm bed. K2 Plus and other variants should edit those coordinates after install.

Check your screw thread direction

The installer adds screw_thread: CW-M4 by default — meaning M4 bed screws that tighten clockwise. This is right for stock Creality K2 beds, but worth confirming on your machine. Valid values: CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5, CW-M6, CCW-M6. If your screws tighten counter-clockwise (rare but possible), change it before running the helper or every direction you read will be backwards.

Reverting

Re-run the one-liner and pick option 2 from the menu, or:

```sh python install_k2.py --host 192.168.x.x --revert ```

The installer makes two backups on every install: one on the printer (/mnt/exUDISK/... or /mnt/UDISK/...) and one on your PC under %USERPROFILE%\K2-Screws-Tilt\backups\. Revert tries the printer-side first, falls back to the local backup if the on-printer one is missing — for example after a Creality firmware update wipes user files.

Companion: KAMP-K2

KAMP-K2 is the sister project — adaptive bed meshing and line purging for the same K2 family. After you've levelled the bed once with K2-Screws-Tilt, KAMP-K2 keeps the per-print mesh adaptive so you're not wasting 100+ seconds of probing for a 3 cm² part.

Both projects are GPL v3, free forever, and use the same install UX. Bug reports and confirmation reports welcome at the issues page.