From 71dc43cda6da9e0bd920a6bc27be6b23b46d593c Mon Sep 17 00:00:00 2001
From: root <root@openclaw.fritz.box>
Date: Fri, 13 Mar 2026 11:42:27 +0000
Subject: [PATCH] Fix: Add clear instructions for manual Z-offset calibration
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CARTOGRAPHER_SCAN_CALIBRATE requires manual interaction when no
calibration exists. The macro was continuing without waiting for
user input, resulting in incorrect Z values (395mm!).

Updated macros:
- CALIBRATE_PROBE: Added detailed instructions for TESTZ/ACCEPT/ABORT
- CALIBRATE_Z_OFFSET: Added step-by-step console instructions

Users now see clear guidance:
- TESTZ Z=0.01 → Move nozzle DOWN (closer to bed)
- TESTZ Z=-0.01 → Move nozzle UP (away from bed)
- ACCEPT → Finish calibration
- ABORT → Cancel

Note: QUICK_TOUCH uses CARTOGRAPHER_TOUCH which works automatically.
---
 calibration/calibration_macros.cfg | 15 ++++++++++++++-
 user_settings_clean.cfg            | 20 ++++++++++++++++++++
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/calibration/calibration_macros.cfg b/calibration/calibration_macros.cfg
index e7a383f..84873a0 100644
--- a/calibration/calibration_macros.cfg
+++ b/calibration/calibration_macros.cfg
@@ -48,7 +48,20 @@ gcode:
     G28
     
     RESPOND MSG="Step 3: Cartographer Z0 calibration..."
-    RESPOND MSG="Follow prompts in console"
+    RESPOND MSG=""
+    RESPOND MSG="⚠️ MANUAL INTERACTION REQUIRED!"
+    RESPOND MSG=""
+    RESPOND MSG="Cartographer will prompt for manual Z adjustment."
+    RESPOND MSG="In console, use these commands:"
+    RESPOND MSG="  TESTZ Z=0.01   - Move nozzle DOWN (closer to bed)"
+    RESPOND MSG="  TESTZ Z=-0.01  - Move nozzle UP (away from bed)"
+    RESPOND MSG="  TESTZ Z=0.005  - Fine adjustment"
+    RESPOND MSG=""
+    RESPOND MSG="When nozzle barely touches paper:"
+    RESPOND MSG="  ACCEPT - Finish calibration"
+    RESPOND MSG="  ABORT  - Cancel"
+    RESPOND MSG=""
+    RESPOND MSG="Starting probe now - watch the console!"
     
     # Start Cartographer calibration (Survey Touch)
     CARTOGRAPHER_SCAN_CALIBRATE
diff --git a/user_settings_clean.cfg b/user_settings_clean.cfg
index 4ecc04d..87a319c 100644
--- a/user_settings_clean.cfg
+++ b/user_settings_clean.cfg
@@ -176,7 +176,27 @@ gcode:
         G28
     {% endif %}
     G1 X{printer.toolhead.axis_maximum.x / 2} Y{printer.toolhead.axis_maximum.y / 2} Z10 F6000
+    
+    RESPOND MSG="=============================================="
+    RESPOND MSG="CARTOGRAPHER Z-OFFSET CALIBRATION"
+    RESPOND MSG="=============================================="
+    RESPOND MSG=""
+    RESPOND MSG="Cartographer will now perform a touch probe."
+    RESPOND MSG=""
+    RESPOND MSG="If prompted for manual adjustment:"
+    RESPOND MSG="  1. Use TESTZ Z=0.01 (or Z=-0.01) to adjust"
+    RESPOND MSG="  2. Lower nozzle until it barely touches paper"
+    RESPOND MSG="  3. Type ACCEPT to finish"
+    RESPOND MSG="  4. Or ABORT to cancel"
+    RESPOND MSG=""
+    RESPOND MSG="Starting probe now..."
+    RESPOND MSG="=============================================="
+    
     CARTOGRAPHER_SCAN_CALIBRATE
+    
+    RESPOND MSG=""
+    RESPOND MSG="Calibration complete!"
+    RESPOND MSG="Run SAVE_CONFIG to persist settings"
 
 [gcode_macro BABYZ_PLUS]
 gcode: