set_printer_light
Destructive
Control a Bambu Lab printer's chamber or work LED: turn it on, off, or flashing to improve camera visibility, signal print completion, or darken overnight prints.
Instructions
Control the printer's LED lights (Bambu Lab printers only).
Args:
node: Which light to control — ``"chamber_light"`` (main
illumination) or ``"work_light"`` (nozzle area).
Defaults to ``"chamber_light"``.
mode: Light mode — ``"on"``, ``"off"``, or ``"flashing"``.
Required: a call that arrives without it is refused rather
than turned on (the same rule as ``set_fan``'s ``percent``).
Use this to improve camera visibility, signal print completion
(flashing), or turn lights off for overnight prints.
Branch on ``outcome`` — one field, three values, the same shape
``start_print`` uses for ``print_start``:
- ``"confirmed"``: the printer, in a report AFTER the command, shows the
effect. For a Bambu, the light report lists that node in that mode.
- ``"accepted"``: the command was sent and not refused, and the printer
has not shown the effect yet. Normal on a quiet printer. Read
``printer_status()`` before building on it.
- ``"failed"``: the printer's interface refused the command.
``accepted`` (the boolean) keeps its old meaning: sent, not refused. It
is never proof the printer acted. ``success`` is ``False`` only for
``"failed"``.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mode": "<mode>"
},
"name": "set_printer_light"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Light mode — ``"on"``, ``"off"``, or ``"flashing"``. Required: a call that arrives without it is refused rather than turned on (the same rule as ``set_fan``'s ``percent``). | |
| node | No | Which light to control — ``"chamber_light"`` (main illumination) or ``"work_light"`` (nozzle area). Defaults to ``"chamber_light"``. Default: "chamber_light". |