purge_filament
Destructive
Heat the nozzle and extrude a short test length to verify filament flow and clear clogs, reporting whether extrusion was actually confirmed or refused by the printer.
Instructions
Heat the nozzle and extrude a short length — the clog test.
Reports what the printer could honestly say, not that a command was
sent: ``extrusion_verified`` is ``False`` with ``error_hint`` when the
firmware refused the move (cold-extrusion guard, Klipper
``can_extrude=false``) or raised an extrusion fault during or right
after the purge (Bambu HMS codes, decoded to plain language);
``None`` when the move was accepted and the machine reports no flow
signal — every backend without a flow sensor — in which case look at
the nozzle for a clean stream. It is never ``True`` on a purge alone.
Refused while printing (paused is fine), below 170 °C, above the
printer's safety ceiling, outside the loaded spool's own temperature
window, and beyond 150 mm.
The answer always says where the purge went. Where the declared
model's own purge position is served one plan at a time through Kiln's hosted service for a printer paired to your Kiln sign-in, free, and kept on your machine so it works offline — the head is parked over the purge chute before the
heater is touched, the machine's own tail snap and shake follow the
extrude, and ``purge_station.status`` is ``"parked"``. Otherwise it is
``"in_place"`` with the reason (a paused print, or no served position
for the model) and the head's coordinates where the printer reports
any; no coordinate is ever inferred, and no model borrows a sibling's.
A pad wipe is a separate door: ``wipe_nozzle``.
Args:
length_mm: Extrusion length, 1–150 mm (default 30).
material: e.g. ``"PLA"`` — picks a temperature when none is given.
temperature: Hotend target in °C. Omit to use the middle of the
spool's (AMS) or material's window.
slot: AMS tray whose temperature window applies (Bambu). Omit to
use the tray currently feeding the nozzle.
wait_seconds: How long after the purge to watch for a fault code
on Bambu (default 10). Bounded the same way as
``load_filament``'s.
keep_hot: Leave the heater ON afterwards, for a caller about to do
something else hot. Off by default: every op ends with the
heater off and says so; where the machine's own cool-down is
served, the part fan goes on and Kiln turns it off on its own
once the nozzle reads the hand-off temperature -- the answer
does not wait for that, and ``printer_status`` shows it.
printer_name: Which printer. Omit for the default one.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "purge_filament"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | No | AMS tray whose temperature window applies (Bambu). Omit to use the tray currently feeding the nozzle. | |
| keep_hot | No | Leave the heater ON afterwards, for a caller about to do something else hot. Off by default: every op ends with the heater off and says so; where the machine's own cool-down is served, the part fan goes on and Kiln turns it off on its own once the nozzle reads the hand-off temperature -- the answer does not wait for that, and ``printer_status`` shows it. Default: false. | |
| material | No | e.g. ``"PLA"`` — picks a temperature when none is given. | |
| length_mm | No | Extrusion length, 1–150 mm (default 30). Default: 30.0. | |
| temperature | No | Hotend target in °C. Omit to use the middle of the spool's (AMS) or material's window. | |
| printer_name | No | Which printer. Omit for the default one. | |
| wait_seconds | No | How long after the purge to watch for a fault code on Bambu (default 10). Bounded the same way as ``load_filament``'s. |