set_printer_model
Identify a saved printer's model by name or slicer file so Kiln applies its bed, temperature limits, and slicing profile; use it when the model is not configured and checks are skipped.
Instructions
Tell Kiln which printer model a saved printer is -- by name, or from a slicer file.
Kiln checks every print against the bed it will land on and the
temperatures the machine can take, and slices with the model's own
profile. All three are read from the printer's model. With no model
set, those checks are SKIPPED. Use this as soon as ``kiln_health`` or a
log says the model is not configured.
Two ways to say it -- give exactly one:
* ``printer_model``: any name the catalogue recognises (``"Bambu Lab
A1"``, ``"bambu_a1"``, ``"MK4"``, ``"K1 Max"``).
* ``slicer_file``: a project the user saved from Bambu Studio,
OrcaSlicer or PrusaSlicer (File > Save Project), or a printer
settings file exported from one. It already names the printer it
was set up for. Ask a new user for one instead of asking them to
look up a model key.
A printer that is NOT in Kiln's catalogue is recorded as the person
names it, with its make (``printer_make="Prusa"``,
``printer_model="Core One L"`` is saved as ``prusa_core_one_l``) and
held to Kiln's generic limits; never substitute a near catalogue model
the person did not name. A slicer file sets such a printer up more
fully: it states the bed, so Kiln also lays slices out on it and
measures designs against it. Either way Kiln has no tuned profile for
it and will not move its head. A model outside the catalogue with no
make (none given, and none implied by the connection) is refused
(``UNKNOWN_MODEL``, with the closest matches); ask who makes it.
Such a printer's bed is recorded here too, and its first print waits
for it (``PRINTER_BED_UNKNOWN``): look up the bed size its maker
publishes (spec page or manual), show the person the size and the page,
and when they say it is right pass ``bed_mm``, ``bed_source`` and
``bed_confirmed=True``. Never guess the size and never ask the person
to know it. A catalogue printer's bed is the catalogue's
(``BED_IS_THE_CATALOGUES``).
Args:
printer_model: The model, in any spelling the catalogue knows.
slicer_file: Path to a saved slicer project or exported settings.
printer_name: The saved printer to set. Omit for the active one.
printer_make: Who makes the printer ("Prusa", "Anycubic"). Needed
only for a model outside the catalogue.
replace: Allow changing a printer that already has a different
model, or taking a newer file's bed for a printer set up from
an earlier file, or a new ``bed_mm`` over a recorded one. Off
by default: the model decides the limits Kiln checks against,
so a wrong one is worse than none.
bed_mm: The bed size ``[x, y, z]`` in mm its maker publishes, for a
printer outside the catalogue. With ``printer_model`` only.
bed_source: Where that size came from: the maker's page (a URL)
or manual. Required with ``bed_mm``.
bed_confirmed: True only once the person has seen the size and its
source and said it is right. Never set it on their behalf.
Returns ``applied`` (whether anything changed), the ``printer``, its
``printer_model`` and ``in_catalogue``, and a ``message`` to relay.
When the connected printer reports itself as a different model, it also
returns ``printer_reports`` and the message says so: ask the person
which is right before changing anything.
From a slicer file it also returns ``file`` -- the printer, bed, nozzle
size and material the file states -- and ``notes`` where the file's bed
or nozzle differs from what Kiln holds. The notes change nothing:
relay them, and if the file's nozzle is the one fitted, record it.
Nothing is written for a model that does not suit the printer's
connection, or over another model unless ``replace`` is set. Limits an
owner typed for a printer are never written over.
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": "set_printer_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bed_mm | No | The bed size ``[x, y, z]`` in mm its maker publishes, for a printer outside the catalogue. With ``printer_model`` only. | |
| replace | No | Allow changing a printer that already has a different model, or taking a newer file's bed for a printer set up from an earlier file, or a new ``bed_mm`` over a recorded one. Off by default: the model decides the limits Kiln checks against, so a wrong one is worse than none. Default: false. | |
| bed_source | No | Where that size came from: the maker's page (a URL) or manual. Required with ``bed_mm``. | |
| slicer_file | No | Path to a saved slicer project or exported settings. | |
| printer_make | No | Who makes the printer ("Prusa", "Anycubic"). Needed only for a model outside the catalogue. | |
| printer_name | No | The saved printer to set. Omit for the active one. | |
| bed_confirmed | No | True only once the person has seen the size and its source and said it is right. Never set it on their behalf. Default: false. | |
| printer_model | No | The model, in any spelling the catalogue knows. |