# 🎯 Calibration Suite for Neptune 4 Plus with Cartographer

## Installation

### Option A: Via user_settings.cfg (Recommended)

1. **Clone repo to config directory:**
   ```bash
   cd ~/printer_data/config
   git clone https://git.sky-net.it/nocci/open4neptune-new.git
   ```

2. **Copy calibration folder:**
   ```bash
   cp -r open4neptune-new/calibration/ ~/printer_data/config/
   ```

3. **The include is already in optimized_user_settings.cfg:**
   ```ini
   [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):
   ```ini
   [include calibration/*.cfg]
   ```

3. **Restart Klipper**

### Test Installation

```gcode
; 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

```gcode
; 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
