open4neptune-new/calibration
root 71dc43cda6 Fix: Add clear instructions for manual Z-offset calibration
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.
2026-03-13 11:42:27 +00:00
..
CALIBRATION_GUIDE.md Add complete Calibration Suite with automated macros 2026-03-12 10:52:06 +00:00
calibration_macros.cfg Fix: Add clear instructions for manual Z-offset calibration 2026-03-13 11:42:27 +00:00
README.md Add calibration include to user_settings.cfg 2026-03-12 13:48:06 +00:00
test_patterns.cfg Revert: Remove 'group' attribute from macros 2026-03-13 11:24:10 +00:00

🎯 Calibration Suite for Neptune 4 Plus with Cartographer

Installation

  1. Clone repo to config directory:

    cd ~/printer_data/config
    git clone https://git.sky-net.it/nocci/open4neptune-new.git
    
  2. Copy calibration folder:

    cp -r open4neptune-new/calibration/ ~/printer_data/config/
    
  3. The include is already in optimized_user_settings.cfg:

    [include calibration/*.cfg]
    
  4. Restart Klipper

Option B: Direct include in printer.cfg

  1. Copy calibration folder to ~/printer_data/config/calibration/

  2. Add to printer.cfg (at the end, after other includes):

    [include calibration/*.cfg]
    
  3. Restart Klipper

Test Installation

; In Mainsail/Fluidd Console:
CALIBRATION_MENU

Macros Overview

  • CALIBRATION_MENU - Main menu with all options
  • CALIBRATE_Z_OFFSET - Cartographer Z0 calibration
  • CALIBRATE_INPUT_SHAPER - ADXL resonance measurement
  • CALIBRATE_PRESSURE_ADVANCE - PA tuning
  • CALIBRATE_FLOW_RATE - Flow rate calibration
  • CALIBRATE_TEMPERATURE - Temperature tower
  • CALIBRATE_RETRACTION - Retraction tuning
  • CALIBRATE_BED_MESH - Bed mesh verification
  • CALIBRATION_FULL - Run all calibrations in sequence

Quick Start

; In Mainsail Console or Fluidd Console:
CALIBRATION_MENU

Notes

  • All macros use Cartographer for precise measurements
  • Results are automatically saved with SAVE_CONFIG
  • Each macro includes safety checks and clear instructions
  • Designed for both Original and Bambu Lab hotends