Skip to content
Cartographer 3D
Archived page. This content is kept for reference only and is no longer maintained. For current instructions see Installation and Setup.

Klipper Configuration

Config File (Firmwares 4.0.1 or earlier)

Section titled “Config File (Firmwares 4.0.1 or earlier)”
/dev/serial/by-id/usb-cartographer_cartographer_...
[cartographer]
serial:
#   Path to the serial port for the Cartographer device. Typically has the form
#
#   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

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

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

[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

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