# Configuration Reference

## Cartographer

```ini
[cartographer]
#   The name of the Cartographer MCU, as defined by your [mcu cartographer] section.
mcu:
#   The distance (in mm) between the probe and the nozzle along the x-axis.
x_offset:
#   The distance (in mm) between the probe and the nozzle along the y-axis.
y_offset:
#   The speed (in mm/s) of all travel moves.
#   Constraints: minimum: 1
#travel_speed: 50
#   The speed (in mm/s) of all Z lift moves.
#   Constraints: minimum: 1
#lift_speed: 5
#   Set to yes to enable debug output.
#verbose: False
#   A prefix to register a second set of Cartographer macros using, alongside 'CARTOGRAPHER_'. E.g. 'CARTO' would result in 'CARTO_TOUCH_HOME'.
#macro_prefix: None
```

## Scan

```ini
[cartographer scan]
#   Speed (in mm/s) of the Z axis when probing.
#   Constraints: minimum: 0.1
#probe_speed: 5
#   Number of runs when doing a scan mesh. Consecutive runs will trace back the way it came from.
#mesh_runs: 1
#   The height (in mm) of the head when doing a mesh run.
#   Constraints: minimum: 1
#mesh_height: 3
#   Axis of which to do the most moves along.
#   Allowed values: x, y
#mesh_direction: 'x'
#   The path to use when calibrating a scan mesh.
#   Allowed values: snake, alternating_snake, spiral, random
#mesh_path: 'snake'
```

## Touch

```ini
[cartographer touch]
#   The number of samples to use when doing a touch.
#   Constraints: minimum: 3
#samples: 3
#   The maximum number of samples to do before giving up.
#max_samples: 10
#   The number of noisy samples tolerated within the sliding window. The window size is calculated as samples + max_noisy_samples. A smaller value prevents cherry-picking good samples from a noisy sequence.
#   Constraints: minimum: 0
#max_noisy_samples: 2
#   The maximum allowed nozzle temperature to use when touching the plate. This is set to 150C to avoid damaging your plate. Change this AT YOUR OWN RISK.
#UNSAFE_max_touch_temperature: 150
#   Radius around the Z home position to do touch.
#   Constraints: minimum: 0.0
#EXPERIMENTAL_home_random_radius: 0.0
#   Retract distance (in mm) between touch samples.
#   Constraints: minimum: 1.0
#retract_distance: 2.0
#   Acceptable range (in mm) between touch samples.
#   Constraints: minimum: 0.001, maximum: 0.015
#sample_range: 0.01
```

## Bed Mesh

```ini
[bed_mesh]
#   Minimum coordinates of the mesh area.
mesh_min:
#   Maximum coordinates of the mesh area.
mesh_max:
#   Number of probe points in X and Y.
probe_count:
#   Position used as zero reference for the mesh.
zero_reference_position:
#   Regions to exclude from mesh probing.
faulty_regions:
#   Travel speed during mesh probing.
#   Constraints: minimum: 1
#speed: 50
#   Z height for horizontal moves during mesh.
#   Constraints: minimum: 1
#horizontal_move_z: 5
#   Margin for adaptive mesh boundaries.
#   Constraints: minimum: 0
#adaptive_margin: 5
```

## Coil

```ini
[cartographer coil]
#   The name of the coil temperature sensor.
#name: 'cartographer_coil'
#   The minimum temperature of the coil, below this will trigger a warning.
#   Constraints: minimum: -273.15
#min_temp: 0
#   The maximum temperature of the coil, above this will trigger a warning.
#max_temp: 105
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cartographer3d.com/cartographer-probe/reference/configuration-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.