The Cartographer plugin registers as 'cartographer', not 'probe'.
Using 'probe:' causes: 'Unknown pin chip name probe'
Correct syntax:
endstop_pin: cartographer:z_virtual_endstop
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.
