Cartotouch¶
Build Plate Damage Alert
Your build plate must be spring steel with a magnetic sheet attached to your underlying printer bed. Do not try and use this probe with embedded magnets or some crappy magnetic flex plate that is not spring steel, your nozzle will dig a big hole in it.
This page covers installing SimpleAF using a Cartographer probe. New here? See Getting Started.
RPi / SBC users: install SimpleAF via SimpleAF for RPi. The rest of this page — probe firmware, mount options, and calibration — applies to your setup too.
Warning
Cartotouch is legacy and is kept here for reference only. New installs should use Cartographer instead.
Firmware requirements¶
Limits on X and Y microsteps¶
You cannot use more than microsteps: 32 for [stepper_x] and [stepper_y], the MCU cannot handle high microsteps, it puts too much pressure on the mainboard and it will cause stuttering and other reliability issues including random crashes.
Note
This limit generally does not apply to RPi Series Simple AF
K1 Series¶
This guide assumes you have a K1, K1C, K1SE or K1 Max and you are running stock creality firmware 1.3.3.5 or higher (The firmware 1.3.3.5 is much older than 1.3.3.46 for example), or alternately you can use my prerooted firmware.
Ender 5 Max¶
This guide assumes you are running stock Creality firmware 1.2.0.10 or higher on your Ender 5 Max.
The stock firmware comes pre-rooted, with the default root password being Creality@2024_Wh_464
Please note that you will need to change the screen orientation to horizontal, here is a model for that https://www.printables.com/model/1246910-ender-5-max-screen-bracket
Ender 3 V3 KE¶
This guide assumes you have a stock Ender 3 V3 KE with Nebula Pad with Root enabled, when you get to installation below, you should specify the --mount Default to install
Simple AF on the KE for Cartographer.
Please note that you will need to change the screen orientation to horizontal, here is a model for that https://www.printables.com/model/727362-ender-3-v3-ke-screen-holder-landscape-for-guppyscr, but please do not follow the installation instructions on that page, just print the model and remount your screen only! An alternative model which honestly seems a bit cleaner: https://www.printables.com/model/706657-creality-ender-3-v3-e3v3-se-ke-and-cr-10-se-portra
RPi or SBC¶
Cartographer Firmware¶
Warning
For K1 Series (which includes K1, K1C, K1SE, K1 Max, Ender 3 V3 KE and Ender 5 Max) Simple AF you must flash your V3 Probe with CARTOGRAPHER K1 5.0.0:
For a V4 Probe CARTOGRAPHER V4 6.0.0 Lite:
For K1 Series (which includes K1, K1C, K1SE, K1 Max, Ender 3 V3 KE and Ender 5 Max) Simple AF there is a guide for V3 Probes and V4 Probes.
For Simple AF for RPi, you can use the standard cartographer guide https://docs.cartographer3d.com/cartographer-probe/firmware/firmware-updating/via-katapult/usb-flash#usb-katapult-updating
If you are using a Pi3 or less (so CB1, CB2, OPi 3, etc) to run klipper, I strongly recommend using the K1/Lite variants of the cartographer firmware, you can do that in the firmware script by enabling Advanced Mode and Enabling Creality K Series Firmware.
Probe Installation¶
It is strongly recommended to connect your probe to the front USB port initially and use it for a while that way to make sure its stable, before directly wiring it to either the mainboard or making a cable for the lidar port (K1M users only). If possible avoid destroying the original cable when you are making your lidar or direct mainboard connection as you might need it in the future!
Danger
If you are not using a side mount you must verify config changes for cartotouch.cfg before homing your printer, using Screws Tilt Calculate or doing a bed mesh!
Ignoring these instructions can lead to significant damage to your build plate and/or probe.
Mount Options¶
Nozzle Offset¶
Warning
It is vital that you verify the coil to nozzle tip distance is within the valid range of 2.6 to 3mm, you can use this simple tool to verify the range: https://www.printables.com/model/1325363-cartographer-and-beacon-z-offset-goldilocks-tool
Just be sure to use digital calipers to verify the print printed with the correct size before relying on it, if you have trouble with your z not being always entirely accurate consider printing the model on its side.
Installation¶
Warning
The installation section does not apply to Simple AF for RPi, See Simple AF for RPi
The installation can only be performed on a printer which has been rooted and ssh granted
You need root access, if you are not already root, then follow the excellent Helper Script Enable Root Access instructions.
Tip
ZeroDotCmd (aka Zero on discord) has provided an excellent Cartographer installation video, you can find it https://www.youtube.com/watch?v=GuxMITM9o4I
Please note however that the macros referenced in the video guide have been removed and you should instead follow the Calibration section of this wiki, I do not have the time to maintain the old guided macros, but you can still use the QUICK_START macro to do the pid and input shaper tuning.
Downgrading from Cartographer?¶
Its really easy to update, you can simply do a probe switch like this:
Then do calibration as normal
Factory Reset¶
If you've installed Guilouz's Helper Script, or installed Fluidd or Mainsail through any other means (such as from Creality directly), you need to factory reset before continuing.
Clone the Repo¶
git config --global http.sslVerify false
git clone https://github.com/pellcorp/creality.git /usr/data/pellcorp
Note
If you had already cloned the pellcorp creality repository before being asked to factory reset, the git repo is still there and you can skip the cloning step!
Run the installer¶
Note
If you have pellcorp-overrides in github but not stored locally, you need to recreate the ~/pellcorp-overrides directory before running the installer.sh!
To run the script, you must use the following command:
Warning
Replace Mount with the specific mount option for the mount you have used, if you do not do this the printer will be incorrectly configured for your mount, and bed meshes, x and y limits and related config will be wrong. Please refer to Mount Options for supported mounts.
If you are using a non-supported mount you should specify a mount option as close to your mount as possible and properly adjust your configuration after installation before trying to perform a bed mesh or Screws Tilt Calculate!
Post Installation¶
MCU Firmware updates are pending¶
At the end of the installer process if you get this message:
It means that new MCU firmware updates need to be applied and this can only be done by power cycling the printer. After your printer is power cycled you can verify firmware was updated with the CHECK_FIRMWARE macro from Fluidd or Mainsail, if you see this message:
Your printer MCU firmware was updated successfully. If you still see the MCU Firmware updates are pending you need to power cycle your printer! message after a power cycle, check the /tmp/mcu_update.log, you may be asked to provide this file on Discord if you need additional assistance, sometimes an additional power cycle can solve the problem, there is a very short window of time (15 seconds) in which the MCU firmware can be updated, so there is a chance it will work after an additional power cycle.
Slicer Settings¶
Calibration¶
Danger
Before running your first bed mesh, please check Manual Bed Tramming.
Warning
The following calibration steps are required to setup a new printer:
Note
If you are running calibration for a printer that has previously been calibrated, the following SAVE_CONFIG sections must be removed from the bottom of the printer.cfg (if they exist) before redoing these calibrations:
[scanner model default][scanner][axis_twist_compensation][bed_mesh]
Enable Touch Mode¶
To be able to set up the printer for cartographer with touch mode for printing you need to make sure the mode is set to touch.
- Run
PROBE_SWITCH MODE=touch
Upon completionSAVE_CONFIG
Source: https://docs.cartographer3d.com/original-plugin/installation/calibration#initial-calibration
Manual Cartographer Calibrate¶
- Run the
STOP_CAMERAmacro to stop the camera - Home X Y (
G28 X Y) - Heat Nozzle to 150c (
M109 S150) so that any filament can be removed from nozzle - Run
CARTOGRAPHER_CALIBRATE METHOD=manualFollow the Paper Test Method
Upon completionSAVE_CONFIG
Note
Is normal to show the Z position at almost at the max height of the printer even if the nozzle is somewhere in the middle or even close to the bed, this is not a bug, its intentional. Until this calibration step is completed, the Z axes cannot be homed, so we make the printer pretend the bed is down the bottom of the printer so that you can freely move the bed up to meet the nozzle during the paper test without running into out of range issues. You however won't be able to move the bed further away from the nozzle more than a few mm.
Warning
Do not use a metal feeler gauge for this step, it could damage your cartographer!!!
Source: https://docs.cartographer3d.com/original-plugin/settings-and-commands#cartographer_calibrate
After the save config you have to do the cartographer threshold scan (see next)
Cartographer Threshold Scan¶
Danger
For this next step, it is really important to be near your printer for this step, because if there is any issue with the printer configuration or your carto probe, its possible the nozzle will dig itself into the bed, so be hovering over that e-stop button!
- Run the
STOP_CAMERAmacro to stop the camera - Home All (
G28) - Heat Nozzle to 150c (
M109 S150) so that any filament can be removed from nozzle - Run
CARTOGRAPHER_THRESHOLD_SCAN SPEED=2 MIN=1000 MAX=5000
Upon completionSAVE_CONFIG
After the save config you have to do the touch calibration.
Source: https://docs.cartographer3d.com/original-plugin/settings-and-commands#cartographer_threshold_scan
Cartographer Touch Calibration¶
Danger
For this next step, it is really important to be near your printer for this step, because if there is any issue with the printer configuration or your carto probe, its possible the nozzle will dig itself into the bed, so be hovering over that e-stop button!
- Run the
STOP_CAMERAmacro to stop the camera - Home All (
G28) - Heat Nozzle to 150c (
M109 S150) so that any filament can be removed from nozzle - Run
CARTOGRAPHER_CALIBRATE
Upon completionSAVE_CONFIG
Tip
If this fails after 3 tries, you should check to make sure there is not filament stuck to the bottom of your nozzle!
Source: https://docs.cartographer3d.com/original-plugin/installation/calibration#setting-up-touch
Pid Tuning and Input Shaping¶
At least PID tuning (bed and extruder) and input shaping is required for acceptable printing. If you try and print after running the installer.sh and a power cycle but before any calibration you will most likely have horrendous quality, the worst you have ever seen on the k1. After PID tuning and input shaping you should see the same kind of quality as you get with stock k1 + input shaper fix.
Note
You can use the QUICK_START Macro to complete Bed and Nozzle PID Tuning and Input Shaping Automatically.
Pid Tuning¶
Source: Calibrate Pid Settings
For example you might run these:
Note
The PID_CALIBRATE_BED and PID_CALIBRATE_HOTEND macros are located in the useful_macros.cfg file and they have defaults values for BED_TEMP and HOTEND_TEMP so you can just run them by clicking on them if you want that same temperature.
Input Shaping¶
There is no default configuration for input shaping so it is essentially disabled out of the box.
You can use the SHAPER_CALIBRATE macro to run input shaping, just be sure to SAVE CONFIG at the end, to choose the automatically selected shaper config, be aware though that the shaper chosen might be sub-optimal due to a slight difference in vibrations between two options. So you should probably review the output and potentially choose an alternative if it gives you higher recommended max acceleration for minimal increase in vibration.
Axis Twist Compensation¶
Next it is highly recommended to perform axis twist compensation calibration if you are using a rear mount before doing anything else, this will affect the quality of your bed mesh, so best to do it before.
- Home All (
G28) - Run
AXIS_TWIST_COMPENSATION_CALIBRATEThe calibration wizard will prompt you to measure the probe Z offset at a few points along the bed
Upon completionSAVE_CONFIG
Warning
Do not use a metal feeler gauge for this step, it could damage your cartographer!!!
Source: https://www.klipper3d.org/Axis_Twist_Compensation.html
First Print¶
You should optimise your scanner_touch_z_offset using baby stepping, as documented here: https://docs.cartographer3d.com/original-plugin/installation/first-print
In fluidd the save button after you finish or cancel your print can be a bit hard to find, look for
Other Calibrations¶
Info
The default value for pressure advance is set to 0.04
Refer to Orcaslicer Calibration for more calibrations
Refer to the Ellis Print Tuning Guide for more great tuning ideas.
Where can I get help?¶
For support, join the SimpleAF Discord.
Thanks¶
Thanks to Richard from https://cartographer3d.com and Zarboz from https://wattskraken.xyz/ for donating Cartographers to the Simple AF project to add support and continue to support the cartographer.