Cartographer 3D
  • Welcome
  • 🗺️Cartographer Probe
    • Scan vs Touch Modes
    • 🏗️Installation and Setup
      • Before You Begin
      • Hardware Setup
        • CAN Termination
        • Stealthburner CW2 Mount
        • Wiring Diagrams
      • Software Configuration
        • Klipper Setup
        • Klipper Configuation
        • Calibration
        • Print Start Macro
        • First Print
        • Migrating from Cartographer to Scanner
      • Creality K1 & K1 Max Specific
      • Qidi Specific Installation Instructions
    • 📐Fine Tuning
      • Cartographer Models
      • Temperature Differential Calibration
      • Useful Macros
      • Extras
    • ♻️Firmware
      • Broken Katapult Bootloader
      • CANBUS Bitrate Switching
      • Firmware Switching
        • CANBUS to USB
        • USB to CANBUS
      • Firmware Updating
        • via Katapult
          • USB Flash
          • CANBUS Flash
        • via DFU
      • Manual Methods
        • ⬆️Firmware
        • Update or Re-Flash via ST-Link
        • Switching between CAN and USB Operation (v3 only)
        • Cartographer with Input Shaper
          • Update via Katapult (recommended)
          • Update via DFU Mode
        • Archive
          • Katapult
          • Re-Flashing Firmware
          • Cartographer (rp2040)
            • DFU / U2F Bootloader Mode
          • Which Firmware?
            • Cartographer v1 (RP2040 based probe)
            • Cartographer v2 or v3 w/ Input Shaper (USB/CAN)
              • Old Firmware
          • Update via STLink
    • ⚙️Settings & Commands
    • 😭Troubleshooting
    • 🆘Need Assistance?
    • 🔗Useful Links
    • ⁉️FAQ
    • 🔧Assembly
      • Standard
      • Low Profile
      • Right Angle
    • Archive
      • v1 (RP2040 Based Probes)
        • Klipper Configuration
        • Calibration
      • Classic Installation
        • Klipper Setup
        • Klipper Configuration
        • Calibration
      • Scan Based Calibration
  • 🚠Cartographer CNC Mount
    • 🚧Installation
  • 🌪️Linear Motor
    • 🗓️Coming Soon
Powered by GitBook
On this page
  1. Cartographer Probe
  2. Archive
  3. Classic Installation

Klipper Configuration

Klipper Configuration for Classic Mode

PreviousKlipper SetupNextCalibration

Last updated 5 months ago

Config File (Firmwares 4.0.1 or earlier)

if you are using an existing printer config, make sure you remove any previous reference to [cartographer] or [probe] in the saved section at the bottom. Use CTL + F (Mac OS use Command (⌘) + F) to search to find either [cartographer] or [probe] and delete these sections.

[cartographer]
serial:
#   Path to the serial port for the Cartographer device. Typically has the form
#   /dev/serial/by-id/usb-cartographer_cartographer_...
#   
#   If you are using the CAN Bus version, replace serial: with canbus_uuid: and add the UUID.
#   Example: canbus_uuid: 1283as878a9sd
#
speed: 40.
#   Z probing dive speed.
lift_speed: 5.0
#   Z probing lift speed.
backlash_comp: 0.5
#   Backlash compensation distance for removing Z backlash before measuring
#   the sensor response.
# 
#   Offsets are measured from the centre of your coil, to the tip of your nozzle 
#   on a level axis. It is vital that this is accurate. 
#
x_offset: 0.0
#   X offset of cartographer from the nozzle.
y_offset: 21.1
#   Y offset of cartographer from the nozzle.
mesh_runs: 2
#   Number of passes to make during mesh scan.

[bed_mesh]
zero_reference_position: 125, 125    
#    set this to the middle of your bed
speed: 200
#    movement speed of toolhead during bed mesh
horizontal_move_z: 5
#    height of scanner during bed mesh scan
mesh_min: 35, 6
#    start point of bed mesh [X, Y]
mesh_max: 240, 198
#    end point of bed mesh [X, Y]
probe_count: 30, 30
algorithm: bicubic

NOTE - The [cartographer] section needs to be above any other reference to either cartographer or probe within your Klipper config, for this reason I advise adding it near the top of your config file.

If you want to use the probe for Input Shaper, please add the following to your config.

[adxl345]
cs_pin: cartographer:PA3
spi_bus: spi1

[resonance_tester]
accel_chip: adxl345
probe_points:
    125, 125, 20
[lis2dw]
cs_pin: cartographer:PA3
spi_bus: spi1

[resonance_tester]
accel_chip: lis2dw
probe_points:
    125, 125, 20

You then need to remove, or comment out your [probe] section.

Now add a safe_z_home section with the following inforamation.

[safe_z_home]
home_xy_position: [your x-axis center coordinate], [your y-axis center coordinate]
# Example home_xy_position: 175,175 - This would be for a 350 * 350mm bed. 
z_hop: 10

You will also need to update your Z configuration settings, this will involve removing or commenting out your position_endstop: configuration. Homing_retract_dist must also be set to 0

Don't get confused, "endstop_pin" should contain probe and NOT cartographer.

[stepper_z]
endstop_pin: probe:z_virtual_endstop # uses cartographer as virtual endstop
homing_retract_dist: 0 # cartographer needs this to be set to 0

If you are running Klipper Screen, add this Macro to your G-Code, this stops klipper screen doing a random bedmesh when you press Z Calibrate on it.

[gcode_macro PROBE_CALIBRATE]
gcode:
    CARTOGRAPHER_CALIBRATE

You will now need to ensure that you update your Z-Tilt or QGL settings to ensure that Cartographer is over the bed when performing these actions. We will be checking these during the calibration phase.

It is vital you complete the Calibration steps, without doing so the probe will not work properly and is likely to show TRIGGERED.

Finally, you need to ensure you have a suitable bed_mesh section. Information can be found

🗺️
If you want to use Survey Touch, our contact probing solution go here
here