Updating Firmware

To update your probes firmware, the simplest method is to use Katapult, though you can also use DFU via USB.

Prerequisites

You must have both the Cartographer Firmware repository, and Katapult on your Pi, if you do not have these please connect via SSH and run the following command.

cd ~
if [ -d ~/cartographer_firmware/ ]; then
    echo "Cartographer Firmware Exists - Updating Repository"
    cd ~/cartographer_firmware/
    git pull
else
    git clone https://github.com/Cartographer3D/cartographer_firmware.git
fi
cd ~
if [ -d ~/katapult/ ]; then
    echo "Katapult Exists - Updating Repository"
    cd ~/katapult/
    git pull
else
    git clone https://github.com/Arksine/katapult.git
fi

Updating via USB

Updating Cartographer via Katapult

You should know which version of the Cartographer Probe you have in order to be able to do this, please refer to the diagrams below to identify your version.

Cartographer V3 - Standard, Low Profile, RIght Angle

Cartographer V4 - Standard / Low Profile*

*Cartographer V4 has a different connector on it, but the PCB is the same design.

Step 1 - Enter Bootloader Mode

The following steps can be done on both Cartographer V3 and Cartographer V4

Automatic Method

We need to get our probe into the Katapult bootloader mode, to do so you can simply run this script

CARTO=$(ls /dev/serial/by-id/ 2>/dev/null | grep -i cartographer | head -n 1)

if [ -z "$CARTO" ]; then
    echo -e "\e[31mERROR: No Cartographer probe found in /dev/serial/by-id/. Is it plugged in via USB?\e[0m "
fi

cd ~/klipper/scripts || exit 1
~/klippy-env/bin/python -c "import flash_usb as u; u.enter_bootloader('/dev/serial/by-id/$CARTO')"

Manual Method

Once your probe is in Bootloader mode, move onto the next step.

Step 2 - Flash Firmware

Cartographer V3

Now your Cartographer is in Katapult Mode, you now need to navigate to the correct firmware to flash it.

Automatic Full V3 USB Firmware

KATAPULT=$(ls /dev/serial/by-id/ 2>/dev/null | grep -i katapult | head -n 1)
cd ~/cartographer_firmware/firmware/v2-v3/survey/5.0.0/
~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f Survey_Cartographer_USB_8kib_offset.bin -d /dev/serial/by-id/$KATAPULT

Your probe should now have the latest Cartographer Firmware installed on it. This page will be updated to include the command for the latest version available for this probe

Manual - Full V3 USB Firmware

Navigate to the folder where your firmware is located, for the example I will be using, I will be updating a v2 probe.

Now, run the following command, replacing <firmware> with the firmware you are flashing, and <serial> with the serial ID and path.

~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f <firmware> -d <serial>

Again, an example of a full command

~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f Cartographer_USB_8kib_offset.bin -d /dev/serial/by-id/usb-katapult_stm32f042x6_060012001643565537353020-if00

If successful, you should have the following output.

If successful, you should have the following output.

Cartographer V4

Updating Cartographer via DFU

Prior to flashing, you will need to following tools

• 2 x Ferrous Tweezers (or any conductive tool to bridge the two pads)

• 1 x USB Cable terminated to work w/ Catographer

Entering DFU Mode

Cartographer V3

To enter DFU Mode, it can be a bit fiddly, but once you get the knack of it, it's fairly simple.

Plug your USB cable into the device you will be flashing from and your Cartographer probe, this can be either a seprate Windows PC, Mac, or a Linux machine, or the device you run your 3D Printer off.

Using your ferrous tweezers, or similar use one to bridge pads 1 (boot0), once you have a solid contact on those tap pad 2 (reset) with your other ferrous tool.

If you have done this correctly, your device should have entered DFU Mode.

Cartographer V4

If you have done this correctly, your device should have entered DFU Mode.

To check,

• Linux - follow the following steps

  • SSH in, or load a termanal shell.

  • type lsusb in your bash shell, it should list a device in DFU Mode

  • One of the options should be Bus 001 Device 004: ID 0483:df11 STMicroelectronics STM Device in DFU Mode - This (as long as you don't have any other devices in DFU Mode) should be your Cartographer Probe in DFU Mode.

• Windows - follow the following steps

  • Start Menu

  • Search and open "Device Manager"

  • Scroll down to Universal Serial Bus Devices

  • You should see STM32 BOOTLOADER as an option

  • 

Flashing via STM32CubeProgrammer (Windows & MacOS)

Download and Install STM32CubeProgrammer from here, I warn you it requires you to sign up for an account.

Version 2.14.0 is recommended due to a known bug in 2.16.0 which causes issues when flashing via STMCubeProgammer - this can be selected from the version 'drop down' on the site.

Open the application, and on the RIGHT side, select the following options and press Connect.

STM32CubeProgrammer Settings

Once you have connected, Click Open File - you will need to select both the Katapult Bootloader for your board, and your Cartographer Firmware that you have downloaded.

Firmwares Loaded

For your Cartographer Firmware, you need to set the address to 0x08002000 This provides the 8KiB offset for the firmware. Katapult firmware can be flashed at the default 0x08000000.

How to change the address in STM32CubeProgrammer

On each of the firmware's press "Download", starting with Katapult, then with Cartographer. Now press Disconnect in the TOP RIGHT corner.

If your BLUE LED is Flashing, you have not fully flashed your Firmware, and you should start again, If you now Power Cycle your probe, or simply hit the RESET (2) pads from earlier, your probe should react when it has anything solid metal put under it.

Flashing via DFU Util (Linux Terminal).

SSH into your linux host MCU, ensuring that your Cartographer is plugged in and in DFU Mode.

Cartographer V3

Navigate into the correct folder, so if you want to update your v2 or v3 run the following command.

cd ~/cartographer_firmware/firmware/v2-v3/survey/5.0.0

Once in the folder, simply check that your probe is still in DFU Mode by running lsusb, and if you still get a result stating it is in DFU Mode, run the following command.

sudo dfu-util -R -a 0 -s 0x08002000:leave -D firmware.bin

NOTE - REPLACE the address (0x08000000) with what ever is listed in the table here for the specific firmware you are using, and rename firmware.bin to what ever the firmware file you are using is called.

Example to install the latest stable V3 Firmware:

sudo dfu-util -R -a 0 -s 0x08002000:leave -D Survey_Cartographer_USB_8kib_offset.bin

Once compelte, it should exit out of DFU mode, and you should be able to find your probe on USB.

Cartographer V4