The Neptune 4 Plus has a built-in ADXL345 accelerometer on the
mainboard. This is more reliable than the Cartographer integrated
ADXL which has version-specific pin requirements (V3: PA3, V4: PA0).
Configuration:
- cs_pin: PG11 (Neptune 4 Plus mainboard ADXL)
- spi_bus: spi2
The Cartographer ADXL config is kept as a commented alternative
for users who prefer to use it.
This fixes: 'Invalid adxl345 id (got 0 vs e5)' errors by using
the known-working mainboard accelerometer.
According to official Cartographer documentation:
- Cartographer V3: cs_pin: cartographer:PA3
- Cartographer V4: cs_pin: cartographer:PA0
Using the wrong pin causes: 'Invalid adxl345 id (got 0 vs e5)'
Added clear documentation in both user_settings_clean.cfg and
optimized_user_settings.cfg to help users select the correct pin.
Reference: https://docs.cartographer3d.com/cartographer-probe/installation-and-setup/software-configuration/klipper-setup
The 'accel_chip' option is not valid in [cartographer] section.
ADXL345 must be configured as a separate [adxl345] device that
communicates via the Cartographer MCU.
Correct configuration:
- [adxl345] with cs_pin: cartographer:PA3 and spi_bus: spi1
- [resonance_tester] with accel_chip: adxl345
- [cartographer] does NOT include accel_chip
This fixes: 'Option accel_chip is not valid in section cartographer'
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.
The ADXL345 accelerometer is built into the Cartographer probe.
It must be configured within the [cartographer] section, not as
a separate [adxl345] device.
Changes:
- Added 'accel_chip: adxl345' to [cartographer] section
- Removed separate [adxl345] section (no longer needed)
- Changed [resonance_tester] to use 'accel_chip: cartographer'
- Added default probe_points for resonance testing
This fixes: 'Invalid adxl345 id (got 0 vs e5)' error
Reference: https://docs.cartographer3d.com/
The 'group' attribute is not supported in all Klipper versions.
This caused: 'Option group is not valid in section gcode_macro'
Macros will appear under 'Uncategorized' in Mainsail/Fluidd
until Klipper adds official support for macro grouping.
Changed from: [include calibration/*.cfg]
Changed to: [include open4neptune-new/calibration/*.cfg]
This ensures the calibration macros are loaded from the repo
(direct include) instead of a potentially outdated local copy.
Fixes issue where Klipper couldn't find the calibration macros
after users switched to direct include method.
Removed unsupported options that cause warnings:
- allow_offline_updates (not a valid option)
- update_sensors (not a valid option)
- persisted_version (not a valid option)
- needs_refresh (not a valid option)
These options are either outdated or from a different update manager
implementation. Moonraker manages version tracking internally.
- README: Add Option A (direct include) as recommended method
- README: Add Option B (copy) with warning about manual updates
- install.sh: Detect direct include vs copied files
- README: Add troubleshooting for 'Error loading template' after update
The root cause: Moonraker updates the repo, but copied files in
~/printer_data/config/calibration/ don't get updated automatically.
Solution: Use direct include [include open4neptune-new/calibration/*.cfg]
so files are always loaded from the repo.
Combined best features from printer.cfg PRINT_END and custom version:
From printer.cfg:
- END_TUNE beeper jingle
- Park position X0 Y315 (better visibility)
From custom version:
- Detailed console/LCD messages
- M84 to disable steppers
- Higher Z-park (10mm)
- Both Frame_Light and Part_Light OFF
- Filament sensors disabled
Usage: Call PRINT_END_NOCCI in slicer end gcode
- Added [include calibration/*.cfg] to optimized_user_settings.cfg
- Updated CHANGES.md with complete deployment steps
- Updated calibration/README.md with installation options
Now the calibration macros are automatically available when using
the optimized user_settings.cfg - no manual include needed!
- SET_GCODE_OFFSET Z=0 for consistent Z-Offset reset
- CG28 instead of G28 (Open4Neptune smart home)
- CARTOGRAPHER_TOUCH_HOME for precise Z0 measurement
- Tighter temperature tolerance (±2°C vs ±4-10°C)
- Full documentation in CHANGES.md
