Current print workflow¶
The C5_PRINT_START macro prepares only the tools the job uses. This page
describes the current config; not every printer and filament combination has
been tested.
The slicer or print dispatcher supplies TOOL=0..3, HOTEND, and BED.
TOOLS=0,3, for example, identifies all tools used by a multi-tool job;
TOOL must be in that list. HOTEND0 through HOTEND3 can override the
shared hotend temperature for individual tools. The macro checks the physical
filament-presence input for each used tool. A missing tool's filament
cancels the job; unused tools are not required to be loaded.
When a file has no C5_PRINT_START line, the print dispatcher
(virtual_sdcard.py) builds one from the first 64 KB and the last 64 KB of
the file:
TOOLis the firstT0–T3. If the file has none, it's the first slot with filament used.HOTENDis the firstM109, else the firstM104. If neither exists, it's that tool'snozzle_temperature_initial_layerfrom Orca's config block. Orca leaves out the heating line in single-tool T0 jobs.BEDis the firstM140orM190.
If no hotend temperature can be found, the job stops before any motion, and the reason is printed to the console.
Preparation order¶
flowchart TD
A[Check filament in every used tool] -->|missing| X[Cancel the job]
A --> C[Start preheating tools<br/>to max 100 °C & bed to temp]
C --> B[Home, then wait for the bed]
B --> D{Flow calibration<br/>or purge on?}
D -->|yes| E[For each used tool:<br/>pick up, nozzle Z, heat,<br/>flow / purge, cool, dock]
D -->|no| W
E --> W[Wait for used tools<br/>to reach their preheat]
W --> F{Bed leveling on?}
F -->|yes| G[Adaptive mesh]
F -->|no| H[Load saved mesh]
G --> I[Pick up first tool, apply nozzle Z,<br/>park, other tools to idle temperature,<br/>wait for print temperature]
H --> I
I --> J{Purge on?}
J -->|yes| M[KAMP purge line<br/>in front of the objects]
J -->|no| O
M --> O[Slicer G-code starts]
- Start a non-blocking preheat of every used tool to at most 100 °C, so the tools warm while the printer homes and the bed heats.
- Home for printing. If a tool is attached, the Creator 5 homing helper handles its docking before Z homing. Then wait for the bed to reach its target.
- If flow calibration or purge is enabled, prepare each used tool in turn: select it, establish its nozzle Z reference, heat it to its material temperature, run the selected flow and/or purge operation, cool it for docking, and release it.
- Wait for every used tool to reach its preheat (re-applied, since docking after priming may have left it cooler). Then clear the old mesh. When bed leveling is enabled, create an adaptive mesh. Otherwise, load the saved default mesh if one exists.
- Probe the bed center as a check, then select the job's initial tool. Apply its automatic nozzle Z, verify that a safe nozzle Z is available, smart park, and wait for its print temperature. The print's other tools are set to their slicer idle temperature (Orca's Idle temperature), or 100 °C if it has none.
- If purge is enabled, draw KAMP's purge line (
LINE_PURGE) just in front of the printed objects. The slicer's print moves follow.
With purge_line_all_tools on, the print's other tools (TOOLS and the
slicer's used tools) each draw a purge line too, after the mesh and before the
initial tool is picked up. Each one is picked up, heated to its own first-layer
temperature, draws its line further out than the last (purge_tool_spacing in
KAMP_Settings.cfg, 8 mm by default), then cools and docks like after priming.
The initial tool's line is drawn last, nearest the objects. A tool's line is
left out, with a message, if there's no room for it in front of or left of the
objects, or the file has no object outlines (Orca's Label objects).
The center probe check does not itself replace the automatic nozzle Z measurement. A missing safe nozzle Z is a print-stopping condition, not a reason to continue at zero offset.
Flow calibration, purge, the purge line and bed leveling can be toggled in the
printer's Misc controls or overridden for a job with FLOW_CALIBRATION=0|1,
PURGE=0|1, PURGE_LINE=0|1 and BED_LEVELING=0|1 (see
How to toggle features). Turning off flow and purge removes those
preparation operations; it does not bypass the filament-presence or nozzle-Z
safety checks. See Printer features for how the flow
measurement works.
At a normal job end, C5_PRINT_STOP handles tool parking and heater shutdown.
The optional lower-bed-at-end setting is separate from print-start bed
leveling. The printer configuration also routes cancellation through the stop
sequence, but a shutdown can prevent ordinary G-code cleanup. Confirm the
machine state before resuming after an MCU fault.