wipe_nozzle
Destructive
Clean the nozzle tip on the printer's own wipe pad by heating to the material's temperature window, retracting, and running the model's wipe pass; reports final head position.
Instructions
Clean the nozzle tip on the printer's own wipe pad.
Heats to the loaded material's window (or the temperature given), parks
over the purge chute while heating, snaps the tail with the vendor's
own retract, then runs the wipe-pad pass the machine's start sequence
runs and reports where the head ended up. Only where the declared
model's pad pass 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
(``printer_model`` in config.yaml names the model). Any other model is
refused with the reason rather than moved to a guessed coordinate: use
the printer's own screen, or start a print — its start sequence wipes
on the pad. No model ever borrows a sibling's position.
Same gate as ``purge_filament``: refused while printing, below 170 °C,
above the safety ceiling, outside the loaded spool's own window. Also
refused while paused — the head is parked over the part and Kiln does
not travel mid-print. The pad is touched the machine's own way, on the
way down in temperature. ``extrusion_verified`` stays ``None``: Bambu
acknowledges no G-code, so "no fault raised" is the strongest thing the
printer can say — look at the tip.
Args:
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 wipe to watch for a fault code
(default 45 for a whole wipe, 10 per step in step mode).
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.
plate_clear: A PERSON's statement that the plate is empty, given on
THIS call. Read on every call by a wipe whose plan presses the
plate (its Z datum is taken on the plate, or the head has to
cross the plate to reach the pad), whatever the plate record
says -- the record cannot see a print started from the printer's
own screen; without it the tool refuses with
``PLATE_CLEAR_REQUIRED`` and, where the printer has a camera,
``snapshot_path`` -- look, then call again with it set. Never
set it on a person's behalf.
step: Send only this step of the wipe's plan (1-based); the answer
describes the next one, and the finish (heater off, the
cool-down) runs after the last step. Step mode is how a wipe
no one has yet run on a real machine is benched -- one motion,
one report, one go -- and the only way such a wipe runs.
plan_only: Describe the steps; send nothing.
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": "wipe_nozzle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | No | AMS tray whose temperature window applies (Bambu). Omit to use the tray currently feeding the nozzle. | |
| step | No | Send only this step of the wipe's plan (1-based); the answer describes the next one, and the finish (heater off, the cool-down) runs after the last step. Step mode is how a wipe no one has yet run on a real machine is benched -- one motion, one report, one go -- and the only way such a wipe runs. | |
| 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. | |
| plan_only | No | Describe the steps; send nothing. Default: false. | |
| plate_clear | No | A PERSON's statement that the plate is empty, given on THIS call. Read on every call by a wipe whose plan presses the plate (its Z datum is taken on the plate, or the head has to cross the plate to reach the pad), whatever the plate record says -- the record cannot see a print started from the printer's own screen; without it the tool refuses with ``PLATE_CLEAR_REQUIRED`` and, where the printer has a camera, ``snapshot_path`` -- look, then call again with it set. Never set it on a person's behalf. Default: false. | |
| 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 wipe to watch for a fault code (default 45 for a whole wipe, 10 per step in step mode). |