TWIST_CALIBRATE: axis twist calibration from Mainsail

scripts/twist_check.py runs on the Pi and measures or verifies the nozzle vs
Beacon offset; windows explain each step, show progress and give a verdict,
with an HTML report in config/twist_data/. It refuses to start during a print,
stops on unexpected readings and never changes printer.cfg.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
mangavalkandClaude Opus 5.5 committed 2026-11-03 22:53:48 +01:00
1 parent 2c1fd27dc6
commit 92d86d6bfd
6 files changed
+852 -2

No files matched your search

+5 -1
View File
@@ -51,6 +51,9 @@ everything below, grouped by topic. Comment out what you do not use there.
| `motion_sensor.cfg` | PIR motion sensor: case light and nozzle LEDs on while someone is near (timeout from the last motion), `CASELIGHT MODE=AUTO\|ON\|OFF`; runs outside the G-code queue, so the lights also react during heat waits and AFC loads | `extras/motion_lights.py`, sensor on a pin, `[output_pin caselight]`, `leds/stealthburner_leds.cfg` |
| `touch_compare.cfg` | `[bdp_touch]`, `TOUCH_COMPARE [N=10] [X] [Y] [TEMP=150]`: nozzle to 150C, `HOME`, then N pairs of a Beacon contact probe and a bd_pressure touch at one spot; reports mean, spread and range of each and of the difference | `extras/bdp_touch.py` + bd_pressure load-check firmware, Beacon |
| **calibration/** | | |
| `twist_check.cfg` + `scripts/twist_check.py` | `TWIST_CALIBRATE`: axis twist calibration from Mainsail with windows that explain each step. Measure (25 min) says whether new `[axis_twist_compensation]` values are needed, Verify (17 min) checks them with bd_pressure. Progress on the status line, result in a window, HTML report with charts in `config/twist_data/`. Never changes `printer.cfg`. `TWIST_STOP` stops a run. | Beacon, `[axis_twist_compensation]`, `gcode_shell_command`, Mainsail prompts; Verify also `bdp_touch.py` |
### Klipper modules (`extras/`)
| File | For |
@@ -65,7 +68,8 @@ everything below, grouped by topic. Comment out what you do not use there.
Firmware update scripts for all MCUs (Klipper and Katapult). They contain
this printer's CAN UUIDs and serial IDs: see [scripts/README.md](scripts/README.md)
before using them on another printer.
before using them on another printer. `twist_check.py` is the axis twist
calibration behind `TWIST_CALIBRATE`.
### Tools (`tools/`)