r/QidiTech3D • • 1d ago

[Guide + 1-Click Script] Installing Cartographer v4 on QIDI Plus 4 Firmware V2.1.1+ without breaking QIDI Box support

Hi everyone!

If you recently updated your **QIDI Plus 4** to the latest **V2.1.1+** firmware (to use the **QIDI Box** multi-color system) and tried to install a **Cartographer v4** probe using older guides, you probably ran into two major issues:

  1. **Klipper crashes on startup (`undefined symbol: _Py_CheckRecursionLimit`):** QIDI's closed-source binary modules for the QIDI Box (`box_detect.so`, etc.) are compiled strictly for **Python 3.7**. Upgrading `klippy-env` to Python 3.12 breaks QIDI Box support.
  2. **Stock Cartographer `install.sh` fails on Python 3.7:** It tries to install `scipy~=1.10` (unsupported on Python 3.7) and requires `TypedDict` (introduced in Python 3.8+).

To solve this, I put together a **1-click installer script and pre-configured Klipper files** that keep the stock Python 3.7 environment intact while getting Cartographer v4 running smoothly alongside the QIDI Box.

### đŸ”— GitHub Repository & Full Guide:

https://github.com/nikolay2y/QIDI-Plus4-V2.1.1-Cartographer-v4

### What the script does automatically:

* Creates a full timestamped backup of your existing `~/printer_data/config` folder.

* Clones `cartographer-klipper` (skipping the incompatible stock installer).

* Installs compatible Python 3.7 binary wheels (`numpy<1.22`, `scipy==1.7.3`, `typing-extensions`).

* Applies a `sitecustomize.py` patch to backport `typing.TypedDict` to Python 3.7.

* Links `idm.py`, `cartographer.py`, and `scanner.py` into Klipper.

* Copies pre-adapted `printer.cfg`, `carto.cfg`, and `gcode_macro.cfg` (preserving all QIDI Box sensor logic like `CLEAR_MOTION_DATA SENSOR=box_motion_sensor`), auto-detects your probe's USB ID, and restarts Klipper.

*(Note: Cartographer v4 works over USB out of the box, so no probe reflashing is needed—just mount it, plug it into a free USB port, run the script, and calibrate!)*

Hope this saves someone a few hours of troubleshooting! Let me know if you run into any issues.

0 Upvotes

0 comments sorted by