QIDI Q2 v1.2.3

From here on, Q2 version numbers track Max4's in parallel — a given vX.Y.Z
on one side means "as of the same day's changes" on the other, not that
every Max4 change necessarily applies to the Q2 (it's a different machine,
ported deliberately, never mirrored blindly). This release jumps 1.1 → 1.2.3
to line up with Max4's own v1.2.3, skipping the intermediate numbers that
were Max4-only fixes for a bug this Q2 never shipped.

New: QIDI_CALIBRATE_BED — the same six-question Fluidd dialog
QIDI_CALIBRATE already had, now in front of the bed routine too. Same
buttons, same "nothing runs until START" guarantee, same 0.4mm nozzle
default. See CHANGELOG/2026-09-23-bed-wizard.md.

Fixed: QIDI_UPDATE now adds printer.cfg sections for brand-new
modules. Previously it copied a new module's files but never gave it a
config section, so the module's command never registered even though the
update reported success. This Q2 goes straight to the fixed version — the
broken intermediate state this bug came from on the Max4 side was never
released here. See CHANGELOG/2026-09-23-update-sections.md.

If you've used QIDI_UPDATE on this Q2 before today, updating to this
release needs one extra round trip the first time:

1. Run QIDI_UPDATE — installs this release using whatever qidi_update.py
   is already on your printer.
2. Power cycle the printer — the actual switch, off and on. Not
   FIRMWARE_RESTART, not Fluidd's "Restart Klipper" button — neither
   actually respawns the klippy process, so neither picks up the fixed
   qidi_update.py that step 1 just installed.
3. Run QIDI_UPDATE again — now the fixed script runs and back-fills
   QIDI_CALIBRATE_BED's section.

Full detail in the README's new "Updating" section.

README additions, closing out GitHub issue #1:

• A firmware-requirement warning: this project targets 01.01.02.04 and
  newer only. Older firmware (reported: 1.1.1) exposes the load cell's
  read call differently, which surfaces as
  flow_ramp: read_origin_data is not callable — the calibration refusing
  to guess at an unfamiliar driver, not a crash.
• A "Troubleshooting" section, including a typed-parameter workaround for
  Fluidd's buttons-only dialogs (there's no text-input verb available to a
  Klipper macro): QIDI_CALIBRATE TEMP=275 NOZZLE=0.4 LAYER=0.20 WIDTH=0.42 BLOCKS=12 POINTS=5 jumps straight to the review screen with nothing left
  to click but START.

QIDI Max4 v1.2.3

Fixes a real regression from v1.2.2: _ensure_sections() added a printer.cfg section for EVERY qidi_*.py file in a release, including qidi_installer.py (the Windows PC-side installer, not a Klipper extra). It has no load_config, so Klipper halted with "Section 'qidi_installer' is not a valid config section."

Now only files that actually define load_config get a section - checked by inspecting the real imported module, not by name-matching. See QIDI/Max4/CHANGELOG/2026-09-23-update-halted-printer.md.

If your printer is already halted on this error, QIDI_UPDATE can't run (Klipper won't start at all) - remove the [qidi_installer] section from printer.cfg by hand first, then update as normal.

Remember: since v1.2.2, QIDI_UPDATE's own code changes need Klipper to actually restart to take effect - and the reliable way to do that is a power cycle (the actual switch, off and on). FIRMWARE_RESTART and Fluidd's "Restart Klipper" button both just reinitialize objects inside the same already-running Python process - on at least one printer, three separate uses of that button never actually respawned the process. Power cycle, then run QIDI_UPDATE again, then restart Klipper once more afterwards. See the root README's Updating and Troubleshooting sections.

QIDI Max4 v1.2.2

Fixes QIDI_UPDATE: it copied a release's files but never added a brand-new module's section to printer.cfg, so Klipper never loaded it - QIDI_CALIBRATE_BED (v1.2.1) installed but did not run. _ensure_sections() now adds any missing section automatically, backing up printer.cfg first. See QIDI/Max4/CHANGELOG/2026-09-23-update-missing-sections.md.

Needs QIDI_UPDATE run TWICE to take effect, since the first run still executes the old buggy code to install this very fix:

1. Run QIDI_UPDATE, install v1.2.2, FIRMWARE_RESTART.
2. Run QIDI_UPDATE again, install v1.2.2 (or later) a second time - this run uses the fixed code and adds the missing [qidi_cal_wizard_bed] section. FIRMWARE_RESTART again.
3. QIDI_CALIBRATE_BED should now exist.

QIDI Max4 v1.2.1

Added QIDI_CALIBRATE_BED - the six-question Fluidd dialog wizard for the bed calibration routine, matching QIDI_CALIBRATE. Runs QIDI_AUTO_CALIBRATE_BED with the answers instead of the chute command. See QIDI/Max4/CHANGELOG/2026-09-23-bed-wizard.md for detail.

QIDI Q2 v1.1

New: QIDI_AUTO_CALIBRATE_BED - the same calibration, run over bed centre with the bed lowered clear of the nozzle, for filament that will not clear the purge chute reliably. Ported from QIDI/Max4's same-day addition, using this Q2's own measured values (201 counts/gf, park_x 85, wipe offsets 10/30) rather than the X-Max 4's.

• QIDI_AUTO_CALIBRATE_BED - the whole chain
• QIDI_BED_PREPARE - home, capture the bed-centre position, move to the chute, lower the bed (standalone, motion only)
• QIDI_FLOW_BED_SEARCH, QIDI_FLOW_BED_WIPE, QIDI_PA_BED_MEASURE

Bed drop: 200 mm at 1200 mm/min against a real 265 mm max travel (this Q2's own printer.cfg). Nothing about the existing chute routine (QIDI_AUTO_CALIBRATE, QIDI_CALIBRATE) was changed - the bed routine lives in separate files. Full detail, including one deliberate deviation from a literal port, in CHANGELOG/2026-09-22-bed-routine.md.

Also: the installer .exe is no longer committed to the repo - back to being a Release asset only.

Not yet run on a real Q2 - QIDI_BED_PREPARE (motion only, no heat) should be the first thing proven, watched.

Install: download QIDI-Q2-Calibration-Installer.exe below, or run install.sh. Already on this machine? Run QIDI_UPDATE from the printer's console.

QIDI Max4 v1.2

New: QIDI_AUTO_CALIBRATE_BED - the same calibration, run over bed centre with the bed lowered clear of the nozzle, for filament that will not clear the purge chute reliably.

• QIDI_AUTO_CALIBRATE_BED - the whole chain
• QIDI_BED_PREPARE - home, capture the bed-centre position, move to the chute, lower the bed (standalone, motion only)
• QIDI_FLOW_BED_SEARCH, QIDI_FLOW_BED_WIPE, QIDI_PA_BED_MEASURE

Nothing about the existing chute routine (QIDI_AUTO_CALIBRATE, QIDI_CALIBRATE) was changed - the bed routine lives in separate files. Full detail in CHANGELOG/2026-09-22-bed-routine.md.

Also: the installer .exe is no longer committed to the repo - back to being a Release asset only.

Install: download QIDI-Max4-Calibration-Installer.exe below, or run install.sh. Already on this machine? Run QIDI_UPDATE from the printer's console.

QIDI Q2 v1.0

First tagged release for the Q2, under the per-model repo layout (QIDI/Q2/).

• counts_per_gf measured on a real Q2: 201 (was previously unmeasured, with
  the X-Max 4's 182.96 quoted as a placeholder default).
• qidi_calibration_q2.cfg added, carrying the real park position, wipe
  offsets and 0.4mm nozzle geometry for this machine.
• Same cooldown-ordering and abort-scaling fixes as QIDI Max4 v1.1: the
  calibration chain no longer cools the nozzle between the flow search and
  the PA measurement, and the PA-stage force abort now scales with your
  configured counts_per_gf.
• QIDI-Q2-Calibration-Installer.exe: Windows installer, no Python/SSH/
  terminal needed. Same file is also tracked directly in QIDI/Q2/ in the
  repo.

Not yet verified end-to-end on a real Q2 printer - the numbers above come
from real Q2 load-cell measurements and QIDI's own firmware, but the full
chain (flow search through to a pasted Orca table) has only run on an
X-Max 4 so far. First run should be watched.

QIDI Max4 v1.1

First tagged release under the new per-model repo layout (QIDI/Max4/).

• Fixed: the calibration chain no longer cools the nozzle between the flow search and the PA measurement (was causing false force aborts on the PA stage).
• Fixed: the PA-stage force abort now scales with your configured counts_per_gf, instead of a hardcoded value.
• Wipe: both stages now do 6 long strokes then 4 shorter ones, matching each other and clearing the chute more reliably.
• New: QIDI_UPDATE - install future updates from the printer's own console, no terminal needed. See QIDI/Max4/README.md.

Install: download QIDI-Calibration-Installer.exe below, or run install.sh.