save_print_checkpoint
Save a checkpoint during a 3D print with current Z height, layer, and temperatures to enable accurate resume from failures on variable-layer-height prints.
Instructions
Save a checkpoint during an active print for accurate resume.
The checkpoint is keyed by ``(printer_name, job_id)`` and read
automatically by :func:`detect_print_failure` so that the resulting
:class:`FailureReport` carries known-good Z / layer / temps. The
resume planner uses this for accurate ``resume_z_mm`` instead of
estimating from ``z_per_layer * resume_layer`` — meaningfully more
accurate when the print uses variable-layer-height slicing.
Args:
printer_name: Name of the printer running the job.
job_id: Unique job identifier.
z_height: Current Z height in mm.
layer_number: Current layer number (0-based).
hotend_temp: Hotend temperature at checkpoint time (Celsius).
bed_temp: Bed temperature at checkpoint time (Celsius).
filament_used_mm: Filament consumed so far in mm.
fan_speed_pct: Part-cooling fan speed (0-100).
flow_rate_pct: Flow-rate multiplier (default 100).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| bed_temp | No | ||
| z_height | No | ||
| hotend_temp | No | ||
| layer_number | No | ||
| printer_name | Yes | ||
| fan_speed_pct | No | ||
| flow_rate_pct | No | ||
| filament_used_mm | No |